Web-standard (Fetch)

Every Corsair adapter wraps one primitive: managementHandler(corsair) returns a handler with the signature (request: Request) => Promise<Response>. Any framework whose routes speak the Fetch API calls it directly — no adapter needed.

Configure Corsair

corsair.ts

import { createCorsair } from 'corsair';
import { github } from '@corsair-dev/github';

export const corsair = createCorsair({
    plugins: [github({ authType: 'managed' })],
    database: db,
    kek: process.env.CORSAIR_KEK!,
    hub: {
        projectApiKey: process.env.CORSAIR_DEV_API_KEY!,
        signingSecret: process.env.CORSAIR_DEV_SIGNING_SECRET!,
    },
});

Mount the handler

SvelteKit
Remix
Astro
Nuxt
Workers / Bun / Deno

src/routes/api/corsair/[...path]/+server.ts

import { managementHandler } from 'corsair';
import { corsair } from '$lib/server/corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export const GET = ({ request }) => handler(request);
export const POST = ({ request }) => handler(request);

app/routes/api.corsair.$.ts

import { managementHandler } from 'corsair';
import { corsair } from '~/server/corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export const loader = ({ request }) => handler(request);
export const action = ({ request }) => handler(request);

src/pages/api/corsair/[...path].ts

import { managementHandler } from 'corsair';
import { corsair } from '../../../server/corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export const GET = ({ request }) => handler(request);
export const POST = ({ request }) => handler(request);
export const prerender = false;

server/routes/api/corsair/[...path].ts

import { fromWebHandler } from 'h3';
import { managementHandler } from 'corsair';
import { corsair } from '~/server/corsair';

// h3's fromWebHandler adapts the (Request) => Response handler to Nitro.
export default fromWebHandler(
    managementHandler(corsair, { basePath: '/api/corsair' }),
);

import { managementHandler } from 'corsair';
import { corsair } from './corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export default { fetch: (request: Request) => handler(request) };

Run and go green

On the first request to /api/corsair, your app self-registers its delivery URL with Hub. See Delivery URLs.

Backend not in JavaScript? Corsair’s SDK is TypeScript-only. Integrate over the Hub REST API instead.

​Configure Corsair

​Mount the handler

​Run and go green

Configure Corsair

Mount the handler

Run and go green