@beignet/next 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @beignet/next
 
+## 0.0.3
+
+### Patch Changes
+
+- 254ef6d: Add scoped route hooks for route and route-group policy, update auth hooks to expose public/optional/required route-hook factories, and teach CLI route inspection about curried route groups.
+- 4cb1784: Add first-class upload router primitives, a typed browser upload client, a
+  React upload adapter, Next.js upload route helper, S3-compatible direct upload
+  signing, devtools upload watcher support, an upload generator, and a
+  first-class `beignet make feature` command with optional policy, event, job,
+  and upload artifacts for the standard vertical slice. Add first-class job retry
+  helpers, outbox retry policy integration, and job retry/dead-letter devtools
+  events. Add a Next.js outbox drain route helper and doctor warnings for
+  serverless background-work footguns.
+- 8bd9085: Add `@beignet/web` as a framework-neutral Web Fetch adapter, include a `@beignet/web/testing` route test harness, and have `@beignet/next` reuse the Web adapter for standard Request/Response handling.
+- Updated dependencies [3160184]
+- Updated dependencies [254ef6d]
+- Updated dependencies [4cb1784]
+- Updated dependencies [8bd9085]
+  - @beignet/core@0.0.3
+  - @beignet/web@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+- 90b29ad: Add pagination primitives and generate list responses with `items` and `page`.
+- Updated dependencies [90b29ad]
+- Updated dependencies [07fa19c]
+- Updated dependencies [08bae67]
+- Updated dependencies [730a818]
+- Updated dependencies [a79f60c]
+  - @beignet/core@0.0.2
+
 ## 0.0.1
 
 - Initial Beignet release under the `@beignet` npm scope.

package/README.md

@@ -1,6 +1,10 @@
 # @beignet/next
 
-Next.js adapter for the framework-agnostic `@beignet/core/server` runtime. It translates Next's `Request`/`Response` to/from the runtime's `HttpRequestLike`/`HttpResponseLike` shapes and provides small helpers for App Router handlers, OpenAPI routes, Swagger UI, and client base URLs.
+Next.js adapter for the framework-agnostic `@beignet/core/server` runtime. It
+builds on `@beignet/web` for standard `Request`/`Response` handling and adds
+Next-specific helpers for App Router handlers, Server Component context,
+OpenAPI routes, Swagger UI, uploads, outbox drains, storage routes, and client
+base URLs.
 
 ## Installation
 
@@ -429,6 +433,67 @@ export const { GET, HEAD } = createStorageRoute(server.ports.storage, {
 Served responses preserve object `Content-Type`, `Cache-Control`,
 `Content-Length`, and `Last-Modified` headers when available.
 
+## Upload routes
+
+Use `createUploadRoute` to expose a Beignet upload router from a focused App
+Router route:
+
+```typescript
+// app/api/uploads/[uploadName]/[action]/route.ts
+import { createUploadRouter } from "@beignet/core/uploads";
+import { createUploadRoute } from "@beignet/next";
+import { postUploads } from "@/features/posts/uploads";
+import { server } from "@/server";
+
+const uploadRouter = createUploadRouter({
+  uploads: postUploads,
+  ctx: () => server.createContextFromNext(),
+  storage: server.ports.storage,
+  instrumentation: server.ports.devtools,
+});
+
+export const { POST } = createUploadRoute(uploadRouter);
+```
+
+The `action` segment must be `prepare`, `upload`, or `complete`.
+
+## Outbox drain routes
+
+Use `createOutboxDrainRoute` to expose durable outbox delivery from a cron or
+scheduled serverless route. The helper requires a bearer secret, drains one
+bounded batch with `@beignet/core/outbox`, records a devtools event when
+available, and returns a JSON summary.
+
+```typescript
+// app/api/cron/outbox/drain/route.ts
+import { createOutboxDrainRoute } from "@beignet/next";
+import { env } from "@/lib/env";
+import { server } from "@/server";
+import { outboxRegistry } from "@/server/outbox";
+
+export const runtime = "nodejs";
+
+export const { GET, POST } = createOutboxDrainRoute({
+  server,
+  registry: outboxRegistry,
+  secret: env.CRON_SECRET,
+  batchSize: 100,
+});
+```
+
+Export both `GET` and `POST` when you want the route to work with schedulers
+that call either method. Export only the method your scheduler uses when you
+want a narrower route surface.
+
+Call the route from your scheduler with:
+
+```http
+Authorization: Bearer <CRON_SECRET>
+```
+
+Do not start long-running outbox polling loops from provider lifecycle hooks in
+serverless apps.
+
 ## Client creation
 
 Use `createNextClient` when a client may run in both browser and server environments. Browser calls default to same-origin relative URLs. Server calls use `NEXT_PUBLIC_API_URL`, then `VERCEL_URL`, then `http://localhost:${PORT || 3000}`.
@@ -555,11 +620,17 @@ Creates a Next.js route handler that serves Swagger UI for an OpenAPI endpoint.
 
 ### `toRequestLike(req: Request): HttpRequestLike`
 
-Converts a Next.js `Request` to the framework-agnostic `HttpRequestLike` shape.
+Re-export from `@beignet/web`. Converts a standard `Request` to the
+framework-agnostic `HttpRequestLike` shape.
+
+### `toWebResponse(res: HttpResponseLike): Response`
+
+Re-export from `@beignet/web`. Converts an `HttpResponseLike` to a standard
+`Response`.
 
 ### `toNextResponse(res: HttpResponseLike): Response`
 
-Converts an `HttpResponseLike` to a Next.js `Response`.
+Next-named alias for `toWebResponse(...)`.
 
 These are used internally by the adapter but can be used directly if needed.
 
@@ -698,7 +769,7 @@ export default async function TodosPage() {
     <div>
       <h1>Todos</h1>
       <ul>
-        {result.todos.map(todo => (
+        {result.items.map(todo => (
           <li key={todo.id}>{todo.title}</li>
         ))}
       </ul>

package/dist/index.d.ts

@@ -1,10 +1,26 @@
 import type { ClientConfig } from "@beignet/core/client";
+import { type DrainOutboxOptions, type OutboxRegistry } from "@beignet/core/outbox";
 import type { AnyPorts, StoragePort } from "@beignet/core/ports";
 import type { ProvidedPortsOfList, ServiceProvider } from "@beignet/core/providers";
-import type { ContractLike, CreateServerOptions, Handler, HttpRequestLike, HttpResponse, ResolveContract, RouteDef, StandardSchemaV1 } from "@beignet/core/server";
-export type { CreateServerOptions, RouteGroup, ServerInstance, } from "@beignet/core/server";
-export { contractsFromRoutes, createServer, defineRouteGroup, defineRoutes, } from "@beignet/core/server";
+import type { ContractLike, CreateServerOptions, Handler, ResolveContract, RouteDef, StandardSchemaV1 } from "@beignet/core/server";
+import type { UploadRouter } from "@beignet/core/uploads";
+import { toWebResponse } from "@beignet/web";
+/**
+ * Server types re-exported for Next.js apps.
+ */
+export type { CreateServerOptions, RouteDef, RouteGroup, RouteHook, ServerInstance, } from "@beignet/core/server";
+/**
+ * Server helpers re-exported for Next.js apps.
+ */
+export { contractsFromRoutes, createServer, defineRoute, defineRouteGroup, defineRouteHook, defineRoutes, } from "@beignet/core/server";
+/**
+ * Web Fetch adapter helpers re-exported for Next.js route helpers.
+ */
+export { createFetchHandler, toRequestLike, toWebResponse } from "@beignet/web";
 type AnyProvider = ServiceProvider<unknown, StandardSchemaV1<any, any>, AnyPorts>;
+/**
+ * Beignet client config with Next.js base URL defaults.
+ */
 export type NextClientConfig<TProvidedHeaders extends string = never> = Omit<ClientConfig<TProvidedHeaders>, "baseUrl"> & {
     /**
      * Explicit base URL for both browser and server calls.
@@ -18,24 +34,66 @@ export type NextClientConfig<TProvidedHeaders extends string = never> = Omit<Cli
      */
     serverBaseUrl?: string | (() => string | undefined);
 };
+/**
+ * OpenAPI server object accepted by `createOpenAPIHandler(...)`.
+ */
 export type OpenAPIServer = {
+    /**
+     * Server URL.
+     */
     url: string;
+    /**
+     * Server description.
+     */
     description?: string;
+    /**
+     * Server URL variables.
+     */
     variables?: Record<string, {
         default: string;
         enum?: string[];
         description?: string;
     }>;
 };
+/**
+ * Options for the Next.js OpenAPI route handler.
+ */
 export type CreateOpenAPIHandlerOptions = {
+    /**
+     * API title.
+     */
     title: string;
+    /**
+     * API version.
+     */
     version: string;
+    /**
+     * API description.
+     */
     description?: string;
+    /**
+     * Static servers or a request-aware server factory.
+     */
     servers?: OpenAPIServer[] | ((req: Request) => OpenAPIServer[]);
+    /**
+     * JSON media type used for generated content.
+     */
     jsonMediaType?: string;
+    /**
+     * OpenAPI security schemes.
+     */
     securitySchemes?: Record<string, unknown>;
+    /**
+     * Global security requirements.
+     */
     security?: Array<Record<string, string[]>>;
+    /**
+     * Custom schema introspector for non-Zod schema libraries.
+     */
     schemaIntrospector?: unknown;
+    /**
+     * Additional response headers.
+     */
     headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
     /**
      * Add the current request origin as the OpenAPI server when `servers` is omitted.
@@ -44,11 +102,26 @@ export type CreateOpenAPIHandlerOptions = {
      */
     inferServersFromRequest?: boolean;
 };
+/**
+ * Options for the Next.js Swagger UI route handler.
+ */
 export type CreateSwaggerUIHandlerOptions = {
+    /**
+     * HTML page title.
+     */
     title?: string;
+    /**
+     * URL of the OpenAPI JSON route.
+     */
     specUrl?: string | ((req: Request) => string);
+    /**
+     * Additional response headers.
+     */
     headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
 };
+/**
+ * Options for serving public storage objects through a Next.js route.
+ */
 export type CreateStorageRouteOptions = {
     /**
      * Public path prefix that maps to storage keys.
@@ -61,18 +134,122 @@ export type CreateStorageRouteOptions = {
      */
     headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
 };
+/**
+ * Options for creating a Next.js upload route.
+ */
+export type CreateUploadRouteOptions = {
+    /**
+     * Static upload name. Omit when using a dynamic `[uploadName]` segment.
+     */
+    uploadName?: string;
+    /**
+     * Static upload action. Omit when using a dynamic `[action]` segment.
+     */
+    action?: "prepare" | "complete" | "upload";
+};
+type OutboxDrainLogger = {
+    error(message: string, metadata?: Record<string, unknown>): void;
+};
+type OutboxDrainDevtools = {
+    record(event: {
+        type: "custom";
+        watcher: string;
+        name: string;
+        label: string;
+        summary: string;
+        requestId?: string;
+        traceId?: string;
+        details: unknown;
+    }): unknown;
+};
+type OutboxDrainPorts = {
+    outbox: DrainOutboxOptions["outbox"];
+    eventBus?: DrainOutboxOptions["eventBus"];
+    jobs?: DrainOutboxOptions["jobs"];
+    logger?: OutboxDrainLogger;
+    devtools?: OutboxDrainDevtools;
+};
+type OutboxDrainContext = {
+    requestId?: string;
+    traceId?: string;
+    ports: OutboxDrainPorts;
+};
+/**
+ * Options for creating a serverless-safe outbox drain route.
+ */
+export type CreateOutboxDrainRouteOptions<Ctx extends OutboxDrainContext> = {
+    /**
+     * Beignet Next server that owns app context and ports.
+     */
+    server: Pick<NextServer<Ctx, Ctx["ports"]>, "createContextFromNext">;
+    /**
+     * Registry of events and jobs that may be delivered from the outbox.
+     */
+    registry: OutboxRegistry;
+    /**
+     * Shared secret expected in the `Authorization: Bearer <secret>` header.
+     *
+     * Missing secrets fail closed with a 500 response so deployments do not
+     * accidentally expose an unauthenticated drain route.
+     */
+    secret?: string;
+    /**
+     * Maximum messages to claim in one drain pass.
+     */
+    batchSize?: number;
+    /**
+     * Claim lease duration in milliseconds.
+     */
+    leaseMs?: number;
+    /**
+     * Retry delay override passed through to `drainOutbox(...)`.
+     */
+    retryDelayMs?: DrainOutboxOptions["retryDelayMs"];
+    /**
+     * Additional response headers.
+     */
+    headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
+};
+type UploadRouteContext = {
+    params?: Promise<Record<string, string | string[] | undefined>> | Record<string, string | string[] | undefined>;
+};
+/**
+ * Beignet server adapted for Next.js route handlers and server components.
+ */
 export interface NextServer<Ctx, Ports extends AnyPorts = AnyPorts> {
+    /**
+     * Catch-all Next.js route handler.
+     */
     api: (req: Request) => Promise<Response>;
+    /**
+     * Register and build a single Next.js route handler imperatively.
+     */
     route: <CLike extends ContractLike>(contractLike: CLike) => {
         handle: (fn: Handler<Ctx, ResolveContract<CLike>>) => (req: Request) => Promise<Response>;
     };
+    /**
+     * Create app context from `next/headers` for Server Components.
+     */
     createContextFromNext: () => Promise<Ctx>;
+    /**
+     * Registered contract inputs.
+     */
     contracts: readonly ContractLike[];
+    /**
+     * Stop installed providers.
+     */
     stop: () => Promise<void>;
+    /**
+     * Final app ports after provider setup.
+     */
     ports: Ports;
 }
-export declare function toRequestLike(req: Request): HttpRequestLike;
-export declare function toNextResponse(resLike: HttpResponse): Response;
+/**
+ * Convert a Beignet response into a native `Response`.
+ *
+ * This is the Next-named alias for `toWebResponse(...)` from `@beignet/web`.
+ */
+export declare const toNextResponse: typeof toWebResponse;
 /**
  * Resolve the right Beignet client base URL for Next.js.
  *
@@ -105,5 +282,33 @@ export declare function createStorageRoute(storage: StoragePort, options?: Creat
     GET: (req: Request) => Promise<Response>;
     HEAD: (req: Request) => Promise<Response>;
 };
+/**
+ * Create a Next.js POST handler for Beignet upload routes.
+ *
+ * Use this in a dynamic route such as
+ * `app/api/uploads/[uploadName]/[action]/route.ts`, where `action` is
+ * `prepare`, `complete`, or `upload`.
+ */
+export declare function createUploadRoute(router: UploadRouter, options?: CreateUploadRouteOptions): {
+    POST: (req: Request, ctx?: UploadRouteContext) => Promise<Response>;
+};
+/**
+ * Create Next.js route handlers that drain one durable outbox batch.
+ *
+ * This helper is intended for serverless cron routes. It performs bounded work
+ * and exits; do not start long-running outbox polling loops from provider
+ * lifecycle hooks in serverless apps.
+ */
+export declare function createOutboxDrainRoute<Ctx extends OutboxDrainContext>(options: CreateOutboxDrainRouteOptions<Ctx>): {
+    GET: (req: Request) => Promise<Response>;
+    POST: (req: Request) => Promise<Response>;
+};
+/**
+ * Create a Beignet server adapted for Next.js.
+ *
+ * The returned `api` handler is intended for a catch-all route. Focused routes
+ * such as OpenAPI, Swagger UI, devtools, and public storage can use their own
+ * route helpers.
+ */
 export declare function createNextServer<Ctx, Ports extends AnyPorts = AnyPorts, Routes extends readonly RouteDef<Ctx>[] = readonly RouteDef<Ctx>[], Providers extends readonly AnyProvider[] = readonly AnyProvider[]>(options: CreateServerOptions<Ctx, Ports, Routes, Providers>): Promise<NextServer<Ctx, Ports & ProvidedPortsOfList<Providers>>>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,32 +1,21 @@
 import { createClient } from "@beignet/core/client";
+import { drainOutbox, } from "@beignet/core/outbox";
 import { createServer } from "@beignet/core/server";
-export { contractsFromRoutes, createServer, defineRouteGroup, defineRoutes, } from "@beignet/core/server";
-export function toRequestLike(req) {
-    return {
-        method: req.method,
-        url: req.url,
-        headers: new Headers(req.headers),
-        raw: req,
-        json: () => req.json(),
-        text: () => req.text(),
-        arrayBuffer: () => req.arrayBuffer(),
-        blob: () => req.blob(),
-        formData: () => req.formData(),
-        clone: () => toRequestLike(req.clone()),
-    };
-}
-export function toNextResponse(resLike) {
-    if (resLike instanceof Response) {
-        return resLike;
-    }
-    const headers = new Headers(resLike.headers);
-    const body = resLike.body;
-    if (body === undefined || body === null) {
-        return new Response(null, { status: resLike.status, headers });
-    }
-    // biome-ignore lint/suspicious/noExplicitAny: Body can be any JSON-serializable value
-    return Response.json(body, { status: resLike.status, headers });
-}
+import { createFetchHandler, toWebResponse } from "@beignet/web";
+/**
+ * Server helpers re-exported for Next.js apps.
+ */
+export { contractsFromRoutes, createServer, defineRoute, defineRouteGroup, defineRouteHook, defineRoutes, } from "@beignet/core/server";
+/**
+ * Web Fetch adapter helpers re-exported for Next.js route helpers.
+ */
+export { createFetchHandler, toRequestLike, toWebResponse } from "@beignet/web";
+/**
+ * Convert a Beignet response into a native `Response`.
+ *
+ * This is the Next-named alias for `toWebResponse(...)` from `@beignet/web`.
+ */
+export const toNextResponse = toWebResponse;
 function resolveConfigValue(value) {
     return typeof value === "function" ? value() : value;
 }
@@ -118,6 +107,9 @@ function keyFromStorageRequest(req, basePath) {
 function storageNotFoundResponse() {
     return new Response(null, { status: 404 });
 }
+function firstParam(value) {
+    return Array.isArray(value) ? value[0] : value;
+}
 async function storageResponse(storage, req, basePath, options, includeBody) {
     const key = keyFromStorageRequest(req, basePath);
     if (!key)
@@ -256,18 +248,141 @@ export function createStorageRoute(storage, options = {}) {
         HEAD: (req) => storageResponse(storage, req, basePath, options, false),
     };
 }
+/**
+ * Create a Next.js POST handler for Beignet upload routes.
+ *
+ * Use this in a dynamic route such as
+ * `app/api/uploads/[uploadName]/[action]/route.ts`, where `action` is
+ * `prepare`, `complete`, or `upload`.
+ */
+export function createUploadRoute(router, options = {}) {
+    return {
+        POST: async (req, ctx) => {
+            const params = await ctx?.params;
+            const uploadName = options.uploadName ?? firstParam(params?.uploadName ?? params?.upload);
+            const action = options.action ?? firstParam(params?.action);
+            if (!uploadName) {
+                return Response.json({
+                    error: {
+                        code: "UPLOAD_NOT_FOUND",
+                        message: "Upload route is missing an upload name.",
+                    },
+                }, { status: 404 });
+            }
+            if (action !== "prepare" &&
+                action !== "complete" &&
+                action !== "upload") {
+                return Response.json({
+                    error: {
+                        code: "INVALID_UPLOAD_ACTION",
+                        message: 'Upload route action must be "prepare", "complete", or "upload".',
+                    },
+                }, { status: 400 });
+            }
+            return router.handleRequest(req, {
+                uploadName,
+                action,
+            });
+        },
+    };
+}
+function outboxDrainJson(body, status, headers) {
+    return Response.json(body, {
+        status,
+        headers,
+    });
+}
+/**
+ * Create Next.js route handlers that drain one durable outbox batch.
+ *
+ * This helper is intended for serverless cron routes. It performs bounded work
+ * and exits; do not start long-running outbox polling loops from provider
+ * lifecycle hooks in serverless apps.
+ */
+export function createOutboxDrainRoute(options) {
+    const drainPendingOutbox = async (req) => {
+        const headers = resolveHeaders(options.headers, req);
+        const secret = options.secret;
+        if (!secret) {
+            return outboxDrainJson({
+                ok: false,
+                error: "CRON_SECRET is not configured.",
+            }, 500, headers);
+        }
+        if (req.headers.get("authorization") !== `Bearer ${secret}`) {
+            return outboxDrainJson({ ok: false, error: "Unauthorized" }, 401, headers);
+        }
+        let ctx;
+        try {
+            ctx = await options.server.createContextFromNext();
+            const drainCtx = ctx;
+            const result = await drainOutbox({
+                outbox: drainCtx.ports.outbox,
+                registry: options.registry,
+                eventBus: drainCtx.ports.eventBus,
+                jobs: drainCtx.ports.jobs,
+                batchSize: options.batchSize,
+                leaseMs: options.leaseMs,
+                retryDelayMs: options.retryDelayMs,
+                instrumentation: drainCtx.ports.devtools,
+                onError(error, message) {
+                    drainCtx.ports.logger?.error("Outbox delivery failed", {
+                        error,
+                        outboxMessageId: message.id,
+                        kind: message.kind,
+                        name: message.name,
+                        attempts: message.attempts,
+                    });
+                },
+            });
+            try {
+                await drainCtx.ports.devtools?.record({
+                    type: "custom",
+                    watcher: "outbox",
+                    name: "outbox.drain",
+                    label: "Outbox drain",
+                    summary: `${result.delivered} delivered, ${result.retried} retried, ${result.deadLettered} dead-lettered`,
+                    requestId: drainCtx.requestId,
+                    traceId: drainCtx.traceId,
+                    details: result,
+                });
+            }
+            catch (error) {
+                drainCtx.ports.logger?.error("Outbox drain devtools recording failed", {
+                    error,
+                });
+            }
+            return outboxDrainJson({
+                ok: true,
+                result,
+            }, 200, headers);
+        }
+        catch (error) {
+            ctx?.ports.logger?.error("Outbox drain failed", { error });
+            return outboxDrainJson({
+                ok: false,
+                error: "Outbox drain failed.",
+            }, 500, headers);
+        }
+    };
+    return {
+        GET: drainPendingOutbox,
+        POST: drainPendingOutbox,
+    };
+}
+/**
+ * Create a Beignet server adapted for Next.js.
+ *
+ * The returned `api` handler is intended for a catch-all route. Focused routes
+ * such as OpenAPI, Swagger UI, devtools, and public storage can use their own
+ * route helpers.
+ */
 export async function createNextServer(options) {
     const runtime = await createServer(options);
-    const wrap = (handler) => {
-        return async (req) => {
-            const res = await handler(toRequestLike(req));
-            return toNextResponse(res);
-        };
-    };
     return {
-        api: wrap(runtime.api),
+        api: createFetchHandler(runtime),
         route: (contract) => ({
-            handle: (fn) => wrap(runtime.route(contract).handle(fn)),
+            handle: (fn) => createFetchHandler(runtime.route(contract).handle(fn)),
         }),
         createContextFromNext: async () => {
             const { cookies, headers } = await import("next/headers");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/next",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "description": "Next.js server-side handlers for Beignet",
   "main": "./dist/index.js",
@@ -57,6 +57,7 @@
   },
   "dependencies": {
     "@beignet/core": "*",
+    "@beignet/web": "*",
     "@standard-schema/spec": "^1.0.0"
   },
   "devDependencies": {

package/src/index.ts

@@ -1,5 +1,10 @@
 import type { ClientConfig } from "@beignet/core/client";
 import { createClient } from "@beignet/core/client";
+import {
+  type DrainOutboxOptions,
+  drainOutbox,
+  type OutboxRegistry,
+} from "@beignet/core/outbox";
 import type { AnyPorts, StoragePort } from "@beignet/core/ports";
 import type {
   ProvidedPortsOfList,
@@ -10,25 +15,41 @@ import type {
   CreateServerOptions,
   Handler,
   HttpRequestLike,
-  HttpResponse,
   ResolveContract,
   RouteDef,
   StandardSchemaV1,
 } from "@beignet/core/server";
 import { createServer } from "@beignet/core/server";
+import type { UploadRouter } from "@beignet/core/uploads";
+import { createFetchHandler, toWebResponse } from "@beignet/web";
 
+/**
+ * Server types re-exported for Next.js apps.
+ */
 export type {
   CreateServerOptions,
+  RouteDef,
   RouteGroup,
+  RouteHook,
   ServerInstance,
 } from "@beignet/core/server";
+/**
+ * Server helpers re-exported for Next.js apps.
+ */
 export {
   contractsFromRoutes,
   createServer,
+  defineRoute,
   defineRouteGroup,
+  defineRouteHook,
   defineRoutes,
 } from "@beignet/core/server";
 
+/**
+ * Web Fetch adapter helpers re-exported for Next.js route helpers.
+ */
+export { createFetchHandler, toRequestLike, toWebResponse } from "@beignet/web";
+
 type AnyProvider = ServiceProvider<
   unknown,
   // biome-ignore lint/suspicious/noExplicitAny: provider config types are erased at this level
@@ -36,6 +57,9 @@ type AnyProvider = ServiceProvider<
   AnyPorts
 >;
 
+/**
+ * Beignet client config with Next.js base URL defaults.
+ */
 export type NextClientConfig<TProvidedHeaders extends string = never> = Omit<
   ClientConfig<TProvidedHeaders>,
   "baseUrl"
@@ -53,9 +77,21 @@ export type NextClientConfig<TProvidedHeaders extends string = never> = Omit<
   serverBaseUrl?: string | (() => string | undefined);
 };
 
+/**
+ * OpenAPI server object accepted by `createOpenAPIHandler(...)`.
+ */
 export type OpenAPIServer = {
+  /**
+   * Server URL.
+   */
   url: string;
+  /**
+   * Server description.
+   */
   description?: string;
+  /**
+   * Server URL variables.
+   */
   variables?: Record<
     string,
     {
@@ -66,15 +102,45 @@ export type OpenAPIServer = {
   >;
 };
 
+/**
+ * Options for the Next.js OpenAPI route handler.
+ */
 export type CreateOpenAPIHandlerOptions = {
+  /**
+   * API title.
+   */
   title: string;
+  /**
+   * API version.
+   */
   version: string;
+  /**
+   * API description.
+   */
   description?: string;
+  /**
+   * Static servers or a request-aware server factory.
+   */
   servers?: OpenAPIServer[] | ((req: Request) => OpenAPIServer[]);
+  /**
+   * JSON media type used for generated content.
+   */
   jsonMediaType?: string;
+  /**
+   * OpenAPI security schemes.
+   */
   securitySchemes?: Record<string, unknown>;
+  /**
+   * Global security requirements.
+   */
   security?: Array<Record<string, string[]>>;
+  /**
+   * Custom schema introspector for non-Zod schema libraries.
+   */
   schemaIntrospector?: unknown;
+  /**
+   * Additional response headers.
+   */
   headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
   /**
    * Add the current request origin as the OpenAPI server when `servers` is omitted.
@@ -84,12 +150,27 @@ export type CreateOpenAPIHandlerOptions = {
   inferServersFromRequest?: boolean;
 };
 
+/**
+ * Options for the Next.js Swagger UI route handler.
+ */
 export type CreateSwaggerUIHandlerOptions = {
+  /**
+   * HTML page title.
+   */
   title?: string;
+  /**
+   * URL of the OpenAPI JSON route.
+   */
   specUrl?: string | ((req: Request) => string);
+  /**
+   * Additional response headers.
+   */
   headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
 };
 
+/**
+ * Options for serving public storage objects through a Next.js route.
+ */
 export type CreateStorageRouteOptions = {
   /**
    * Public path prefix that maps to storage keys.
@@ -103,8 +184,105 @@ export type CreateStorageRouteOptions = {
   headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
 };
 
+/**
+ * Options for creating a Next.js upload route.
+ */
+export type CreateUploadRouteOptions = {
+  /**
+   * Static upload name. Omit when using a dynamic `[uploadName]` segment.
+   */
+  uploadName?: string;
+  /**
+   * Static upload action. Omit when using a dynamic `[action]` segment.
+   */
+  action?: "prepare" | "complete" | "upload";
+};
+
+type OutboxDrainLogger = {
+  error(message: string, metadata?: Record<string, unknown>): void;
+};
+
+type OutboxDrainDevtools = {
+  record(event: {
+    type: "custom";
+    watcher: string;
+    name: string;
+    label: string;
+    summary: string;
+    requestId?: string;
+    traceId?: string;
+    details: unknown;
+  }): unknown;
+};
+
+type OutboxDrainPorts = {
+  outbox: DrainOutboxOptions["outbox"];
+  eventBus?: DrainOutboxOptions["eventBus"];
+  jobs?: DrainOutboxOptions["jobs"];
+  logger?: OutboxDrainLogger;
+  devtools?: OutboxDrainDevtools;
+};
+
+type OutboxDrainContext = {
+  requestId?: string;
+  traceId?: string;
+  ports: OutboxDrainPorts;
+};
+
+/**
+ * Options for creating a serverless-safe outbox drain route.
+ */
+export type CreateOutboxDrainRouteOptions<Ctx extends OutboxDrainContext> = {
+  /**
+   * Beignet Next server that owns app context and ports.
+   */
+  server: Pick<NextServer<Ctx, Ctx["ports"]>, "createContextFromNext">;
+  /**
+   * Registry of events and jobs that may be delivered from the outbox.
+   */
+  registry: OutboxRegistry;
+  /**
+   * Shared secret expected in the `Authorization: Bearer <secret>` header.
+   *
+   * Missing secrets fail closed with a 500 response so deployments do not
+   * accidentally expose an unauthenticated drain route.
+   */
+  secret?: string;
+  /**
+   * Maximum messages to claim in one drain pass.
+   */
+  batchSize?: number;
+  /**
+   * Claim lease duration in milliseconds.
+   */
+  leaseMs?: number;
+  /**
+   * Retry delay override passed through to `drainOutbox(...)`.
+   */
+  retryDelayMs?: DrainOutboxOptions["retryDelayMs"];
+  /**
+   * Additional response headers.
+   */
+  headers?: HeadersInit | ((req: Request) => HeadersInit | undefined);
+};
+
+type UploadRouteContext = {
+  params?:
+    | Promise<Record<string, string | string[] | undefined>>
+    | Record<string, string | string[] | undefined>;
+};
+
+/**
+ * Beignet server adapted for Next.js route handlers and server components.
+ */
 export interface NextServer<Ctx, Ports extends AnyPorts = AnyPorts> {
+  /**
+   * Catch-all Next.js route handler.
+   */
   api: (req: Request) => Promise<Response>;
+  /**
+   * Register and build a single Next.js route handler imperatively.
+   */
   route: <CLike extends ContractLike>(
     contractLike: CLike,
   ) => {
@@ -112,42 +290,30 @@ export interface NextServer<Ctx, Ports extends AnyPorts = AnyPorts> {
       fn: Handler<Ctx, ResolveContract<CLike>>,
     ) => (req: Request) => Promise<Response>;
   };
+  /**
+   * Create app context from `next/headers` for Server Components.
+   */
   createContextFromNext: () => Promise<Ctx>;
+  /**
+   * Registered contract inputs.
+   */
   contracts: readonly ContractLike[];
+  /**
+   * Stop installed providers.
+   */
   stop: () => Promise<void>;
+  /**
+   * Final app ports after provider setup.
+   */
   ports: Ports;
 }
 
-export function toRequestLike(req: Request): HttpRequestLike {
-  return {
-    method: req.method,
-    url: req.url,
-    headers: new Headers(req.headers),
-    raw: req,
-    json: () => req.json(),
-    text: () => req.text(),
-    arrayBuffer: () => req.arrayBuffer(),
-    blob: () => req.blob(),
-    formData: () => req.formData(),
-    clone: () => toRequestLike(req.clone()),
-  };
-}
-
-export function toNextResponse(resLike: HttpResponse): Response {
-  if (resLike instanceof Response) {
-    return resLike;
-  }
-
-  const headers = new Headers(resLike.headers);
-  const body = resLike.body;
-
-  if (body === undefined || body === null) {
-    return new Response(null, { status: resLike.status, headers });
-  }
-
-  // biome-ignore lint/suspicious/noExplicitAny: Body can be any JSON-serializable value
-  return Response.json(body as any, { status: resLike.status, headers });
-}
+/**
+ * Convert a Beignet response into a native `Response`.
+ *
+ * This is the Next-named alias for `toWebResponse(...)` from `@beignet/web`.
+ */
+export const toNextResponse = toWebResponse;
 
 function resolveConfigValue(
   value: string | (() => string | undefined) | undefined,
@@ -280,6 +446,10 @@ function storageNotFoundResponse(): Response {
   return new Response(null, { status: 404 });
 }
 
+function firstParam(value: string | string[] | undefined): string | undefined {
+  return Array.isArray(value) ? value[0] : value;
+}
+
 async function storageResponse(
   storage: StoragePort,
   req: Request,
@@ -456,6 +626,187 @@ export function createStorageRoute(
   };
 }
 
+/**
+ * Create a Next.js POST handler for Beignet upload routes.
+ *
+ * Use this in a dynamic route such as
+ * `app/api/uploads/[uploadName]/[action]/route.ts`, where `action` is
+ * `prepare`, `complete`, or `upload`.
+ */
+export function createUploadRoute(
+  router: UploadRouter,
+  options: CreateUploadRouteOptions = {},
+): {
+  POST: (req: Request, ctx?: UploadRouteContext) => Promise<Response>;
+} {
+  return {
+    POST: async (req, ctx) => {
+      const params = await ctx?.params;
+      const uploadName =
+        options.uploadName ?? firstParam(params?.uploadName ?? params?.upload);
+      const action = options.action ?? firstParam(params?.action);
+
+      if (!uploadName) {
+        return Response.json(
+          {
+            error: {
+              code: "UPLOAD_NOT_FOUND",
+              message: "Upload route is missing an upload name.",
+            },
+          },
+          { status: 404 },
+        );
+      }
+
+      if (
+        action !== "prepare" &&
+        action !== "complete" &&
+        action !== "upload"
+      ) {
+        return Response.json(
+          {
+            error: {
+              code: "INVALID_UPLOAD_ACTION",
+              message:
+                'Upload route action must be "prepare", "complete", or "upload".',
+            },
+          },
+          { status: 400 },
+        );
+      }
+
+      return router.handleRequest(req, {
+        uploadName,
+        action,
+      });
+    },
+  };
+}
+
+function outboxDrainJson(
+  body: unknown,
+  status: number,
+  headers: HeadersInit | undefined,
+): Response {
+  return Response.json(body, {
+    status,
+    headers,
+  });
+}
+
+/**
+ * Create Next.js route handlers that drain one durable outbox batch.
+ *
+ * This helper is intended for serverless cron routes. It performs bounded work
+ * and exits; do not start long-running outbox polling loops from provider
+ * lifecycle hooks in serverless apps.
+ */
+export function createOutboxDrainRoute<Ctx extends OutboxDrainContext>(
+  options: CreateOutboxDrainRouteOptions<Ctx>,
+): {
+  GET: (req: Request) => Promise<Response>;
+  POST: (req: Request) => Promise<Response>;
+} {
+  const drainPendingOutbox = async (req: Request): Promise<Response> => {
+    const headers = resolveHeaders(options.headers, req);
+    const secret = options.secret;
+
+    if (!secret) {
+      return outboxDrainJson(
+        {
+          ok: false,
+          error: "CRON_SECRET is not configured.",
+        },
+        500,
+        headers,
+      );
+    }
+
+    if (req.headers.get("authorization") !== `Bearer ${secret}`) {
+      return outboxDrainJson(
+        { ok: false, error: "Unauthorized" },
+        401,
+        headers,
+      );
+    }
+
+    let ctx: Ctx | undefined;
+
+    try {
+      ctx = await options.server.createContextFromNext();
+      const drainCtx = ctx;
+      const result = await drainOutbox({
+        outbox: drainCtx.ports.outbox,
+        registry: options.registry,
+        eventBus: drainCtx.ports.eventBus,
+        jobs: drainCtx.ports.jobs,
+        batchSize: options.batchSize,
+        leaseMs: options.leaseMs,
+        retryDelayMs: options.retryDelayMs,
+        instrumentation: drainCtx.ports.devtools,
+        onError(error, message) {
+          drainCtx.ports.logger?.error("Outbox delivery failed", {
+            error,
+            outboxMessageId: message.id,
+            kind: message.kind,
+            name: message.name,
+            attempts: message.attempts,
+          });
+        },
+      });
+
+      try {
+        await drainCtx.ports.devtools?.record({
+          type: "custom",
+          watcher: "outbox",
+          name: "outbox.drain",
+          label: "Outbox drain",
+          summary: `${result.delivered} delivered, ${result.retried} retried, ${result.deadLettered} dead-lettered`,
+          requestId: drainCtx.requestId,
+          traceId: drainCtx.traceId,
+          details: result,
+        });
+      } catch (error) {
+        drainCtx.ports.logger?.error("Outbox drain devtools recording failed", {
+          error,
+        });
+      }
+
+      return outboxDrainJson(
+        {
+          ok: true,
+          result,
+        },
+        200,
+        headers,
+      );
+    } catch (error) {
+      ctx?.ports.logger?.error("Outbox drain failed", { error });
+
+      return outboxDrainJson(
+        {
+          ok: false,
+          error: "Outbox drain failed.",
+        },
+        500,
+        headers,
+      );
+    }
+  };
+
+  return {
+    GET: drainPendingOutbox,
+    POST: drainPendingOutbox,
+  };
+}
+
+/**
+ * Create a Beignet server adapted for Next.js.
+ *
+ * The returned `api` handler is intended for a catch-all route. Focused routes
+ * such as OpenAPI, Swagger UI, devtools, and public storage can use their own
+ * route helpers.
+ */
 export async function createNextServer<
   Ctx,
   Ports extends AnyPorts = AnyPorts,
@@ -466,17 +817,10 @@ export async function createNextServer<
 ): Promise<NextServer<Ctx, Ports & ProvidedPortsOfList<Providers>>> {
   const runtime = await createServer(options);
 
-  const wrap = (handler: (req: HttpRequestLike) => Promise<HttpResponse>) => {
-    return async (req: Request) => {
-      const res = await handler(toRequestLike(req));
-      return toNextResponse(res);
-    };
-  };
-
   return {
-    api: wrap(runtime.api),
+    api: createFetchHandler(runtime),
     route: (contract) => ({
-      handle: (fn) => wrap(runtime.route(contract).handle(fn)),
+      handle: (fn) => createFetchHandler(runtime.route(contract).handle(fn)),
     }),
     createContextFromNext: async () => {
       const { cookies, headers } = await import("next/headers");