@fuseplane/runtime

The core runtime library for Fuseplane, providing the necessary handlers and adapters to integrate Fuseplane into your serverless or edge functions.

Installation

npm install @fuseplane/runtime

Usage

The runtime provides a core handler for standard Web API Request/Response objects (Edge runtime) and adapters for specific platforms like Node.js (Vercel Serverless).

Core Handler (Edge Runtime)

Use createFuseplaneHandler for environments that support the standard Fetch API (e.g., Vercel Edge, Cloudflare Workers).

import { createFuseplaneHandler } from "@fuseplane/runtime";

const handler = createFuseplaneHandler({
  gatewayUrl: process.env.FUSEPLANE_URL || "https://api.fuseplane.com",
});

export default async function (request: Request) {
  return handler(request);
}

Vercel Serverless (Node.js)

For Vercel Serverless Functions running on Node.js, use the fuseplaneVercel adapter.

import { fuseplaneVercel } from "@fuseplane/runtime";

const handler = fuseplaneVercel({
  gatewayUrl: process.env.FUSEPLANE_URL || "https://api.fuseplane.com",
});

export default handler;

Configuration

Both handlers usually don't need manual configuration if you use the CLI, which generates the correct files for you.

However, if using manually, they require:

• gatewayUrl: The URL of your dedicated FusePlane Gateway (e.g., https://a1b2c3d4.fuseplane.com).

Environment Variables

The runtime relies on these environment variables:

FUSEPLANE_SECRET_KEY=fp_sk_...
FUSEPLANE_URL=https://<id>.fuseplane.com

• FUSEPLANE_SECRET_KEY: Used to authenticate requests to the Fuseplane Gateway.
• FUSEPLANE_URL: Your dedicated Gateway URL.

detailed Reference

• createFuseplaneHandler(config): Returns an async function (request: Request) => Promise<Response>.
• fuseplaneVercel(config): Returns an async function (req: IncomingMessage, res: ServerResponse) => Promise<void>.