Core

Configuration

Configure single and multi-service gateways, headers, adapters, timeouts, retries, normalization, and hooks.

Single service

import { defineConfig } from "@pajarrahmansyah/passit";

export default defineConfig({
  baseUrl: "https://api.backend.com",
  headers: {
    "x-api-key": process.env.API_KEY,
  },
  timeout: 5000,
});

Multiple services

import { defineConfig } from "@pajarrahmansyah/passit";

export default defineConfig({
  auth: {
    baseUrl: "https://auth.backend.com",
    headers: { "x-api-key": process.env.AUTH_KEY },
  },
  storage: {
    baseUrl: "https://storage.backend.com",
    headers: { "x-api-key": process.env.STORAGE_KEY },
  },
});

Use the service key in route handlers:

return passIt({ service: "auth", path: "/login", req });

Adapters

PassIt defaults to fetch.

http: "fetch"

Use Axios when installed:

http: "axios"

Loading options

PassIt needs your passit.config.ts file to be imported once by the server before route handlers call passIt.

Recommended: Next.js 15+

Create instrumentation.ts at your project root, next to passit.config.ts.

export async function register() {
  await import("./passit.config");
}

Use this for new App Router projects. It keeps the config server-only and avoids importing setup code inside pages, layouts, or every route.

Next.js 14

Enable the instrumentation hook first.

// next.config.ts
const nextConfig = {
  experimental: {
    instrumentationHook: true,
  },
};

export default nextConfig;

Then add the same instrumentation.ts file.

export async function register() {
  await import("./passit.config");
}

Simple fallback: layout import

If you do not want to use instrumentation, import the config once in your root layout.

// app/layout.tsx
import "@/passit.config";

This works, but instrumentation is cleaner because config loading is not tied to UI layout files.

Plugin option

You can also wrap your Next.js config with PassIt. This enables the instrumentation hook automatically for Next.js 14. Pair it with a one-line instrumentation.ts.

// next.config.ts
import { withPassIt } from "@pajarrahmansyah/passit/next";

export default withPassIt({
  // Next.js config
});

// instrumentation.ts
export { register } from "@pajarrahmansyah/passit/next";

Pick only one loading method. For most Next.js 15 projects, use instrumentation.ts.

Route-safe config import

For the strongest typing and most predictable route loading, import your config object in the route and use the bound passIt function returned by defineConfig.

// app/api/login/route.ts
import passit from "@/passit.config";
import type { NextRequest } from "next/server";

export async function POST(req: NextRequest) {
  return passit.passIt({ service: "auth", path: "/login", req });
}

`createPassIt`

Use createPassIt(config) when you want a typed passIt function bound to a config without registering it globally.

import { createPassIt } from "@pajarrahmansyah/passit";

const api = createPassIt({
  baseUrl: "https://api.backend.com",
});

export const passIt = api.passIt;