@axiomify/serverless

Platform-independent serverless adapter for Axiomify using standard Fetch API Request and Response objects (WinterCG compliant).

Runs on Cloudflare Workers, Vercel Edge, AWS Lambda (with HTTP/Fetch integration), Bun, Deno, and any other WinterCG environment.

Install

npm install @axiomify/serverless @axiomify/core zod

Quick Example (Cloudflare Workers / WinterCG)

import { Axiomify } from '@axiomify/core';
import { ServerlessAdapter } from '@axiomify/serverless';
import { z } from 'zod';

const app = new Axiomify();

app.route({
  method: 'GET',
  path: '/hello/:name',
  schema: {
    params: z.object({ name: z.string() }),
    response: z.object({ message: z.string() }),
  },
  handler: async (req, res) => {
    res.send({ message: `Hello, ${req.params.name}!` });
  },
});

const adapter = new ServerlessAdapter(app);

// Export standard fetch handler
export default {
  async fetch(request: Request): Promise<Response> {
    return adapter.handle(request);
  },
};

Options — new ServerlessAdapter(app, options?)

| Option | Default | Description | | ------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | maxBodySize | 1048576 (1 MiB) | Maximum request body size in bytes. Requests exceeding this are rejected with 413 Payload Too Large before parsing (checked against Content-Length, then re-checked against the actual bytes read). | | trustProxy | false | When true, derive the client IP from the X-Forwarded-For header. Only enable behind a trusted proxy — the header is client-spoofable. When false, req.ip is left empty. |

const adapter = new ServerlessAdapter(app, {
  maxBodySize: 5 * 1024 * 1024, // 5 MiB
  trustProxy: true,
});

The request id is taken from the X-Request-Id header when present, otherwise generated with crypto.randomUUID().

AWS Lambda / Vercel Integration

To run on platforms expecting standard Lambda handlers, you can wrap the fetch adapter using community adapter libraries (e.g. @parse/lambda, @edge-runtime/primitives, or basic mapping).

Browser Compatibility Warning

This package (and @axiomify/core) depends on Node-compatible background APIs (like node:async_hooks and node:path). It is not designed to run inside client-side browsers.

License

MIT