@beignet/web 0.0.3

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# @beignet/web
+
+## 0.0.3
+
+### Patch Changes
+
+- 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
+
+## 0.0.2
+
+### Patch Changes
+
+- Add the Web Fetch adapter package.

package/README.md

@@ -0,0 +1,99 @@
+# @beignet/web
+
+Web Fetch adapter for Beignet's framework runtime.
+
+Use this package when your runtime accepts a standard `Request` and returns a
+standard `Response`, such as Cloudflare Workers, Bun, Deno, Node fetch servers,
+or tests that should avoid a framework-specific adapter.
+
+## Installation
+
+```bash
+npm install @beignet/web
+```
+
+## Quick start
+
+```typescript
+import { createFetchServer } from "@beignet/web";
+import { routes } from "./server/routes";
+
+export const server = await createFetchServer({
+  ports,
+  routes,
+  createContext: ({ ports, req }) => ({
+    requestId: req.headers.get("x-request-id") ?? crypto.randomUUID(),
+    ports,
+  }),
+  mapUnhandledError: () => ({
+    status: 500,
+    body: {
+      code: "INTERNAL_SERVER_ERROR",
+      message: "Internal server error",
+    },
+  }),
+});
+
+export default {
+  fetch: server.fetch,
+};
+```
+
+## Bun
+
+```typescript
+import { server } from "./server";
+
+Bun.serve({
+  fetch: server.fetch,
+});
+```
+
+## Lower-level helpers
+
+```typescript
+import {
+  createFetchHandler,
+  toRequestLike,
+  toWebResponse,
+} from "@beignet/web";
+```
+
+- `createFetchHandler(server)` adapts a Beignet server instance or API handler
+  to `(req: Request) => Promise<Response>`.
+- `toRequestLike(req)` converts a standard `Request` to Beignet's
+  framework-neutral request shape.
+- `toWebResponse(response)` converts a Beignet response to a standard
+  `Response`.
+
+Native `Response` instances returned by handlers are passed through unchanged.
+Plain Beignet responses are serialized as JSON unless the body is `undefined`
+or `null`.
+
+## Testing
+
+Use `@beignet/web/testing` to exercise routes through the same Web Fetch
+adapter without opening a network port.
+
+```typescript
+import { createTestApp } from "@beignet/web/testing";
+import { getTodo } from "./features/todos/contracts";
+import { routes } from "./server/routes";
+
+const app = await createTestApp({
+  ports,
+  routes,
+  createContext: ({ ports }) => ({
+    requestId: "test-request",
+    ports,
+  }),
+});
+
+const todo = await app.request(getTodo, {
+  path: { id: "todo_1" },
+});
+```
+
+`app.request(contract, args)` uses the same typed call arguments as
+`@beignet/core/client`, while `app.safeRequest(contract, args)` returns a typed
+success/error result instead of throwing.

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+import type { AnyPorts } from "@beignet/core/ports";
+import type { ProvidedPortsOfList, ServiceProvider } from "@beignet/core/providers";
+import type { ContractLike, CreateServerOptions, Handler, HttpRequestLike, HttpResponse, ResolveContract, RouteDef, ServerInstance } from "@beignet/core/server";
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+/**
+ * Server types re-exported for Web Fetch apps.
+ */
+export type { CreateServerOptions, HttpRequestLike, HttpResponse, RouteDef, RouteGroup, RouteHook, ServerInstance, } from "@beignet/core/server";
+/**
+ * Server helpers re-exported for Web Fetch apps.
+ */
+export { contractsFromRoutes, createServer, defineRoute, defineRouteGroup, defineRouteHook, defineRoutes, } from "@beignet/core/server";
+type AnyProvider = ServiceProvider<unknown, StandardSchemaV1<any, any>, AnyPorts>;
+/**
+ * Beignet server adapted to the Web Fetch API.
+ */
+export interface FetchServer<Ctx, Ports extends AnyPorts = AnyPorts> {
+    /**
+     * Catch-all Web Fetch handler.
+     */
+    fetch: (req: Request) => Promise<Response>;
+    /**
+     * Alias for `fetch` for API route adapters that expect an `api` property.
+     */
+    api: (req: Request) => Promise<Response>;
+    /**
+     * Register and build a single Web Fetch route handler imperatively.
+     */
+    route: <CLike extends ContractLike>(contractLike: CLike) => {
+        handle: (fn: Handler<Ctx, ResolveContract<CLike>>) => (req: Request) => Promise<Response>;
+    };
+    /**
+     * Registered contract inputs.
+     */
+    contracts: readonly ContractLike[];
+    /**
+     * Stop installed providers.
+     */
+    stop: () => Promise<void>;
+    /**
+     * Final app ports after provider setup.
+     */
+    ports: Ports;
+}
+/**
+ * Convert a native `Request` into Beignet's framework-neutral request shape.
+ */
+export declare function toRequestLike(req: Request): HttpRequestLike;
+/**
+ * Convert a Beignet response into a native `Response`.
+ */
+export declare function toWebResponse(resLike: HttpResponse): Response;
+/**
+ * Create a Web Fetch handler from a Beignet server or API handler.
+ */
+export declare function createFetchHandler(serverOrHandler: Pick<ServerInstance<unknown>, "api"> | ((req: HttpRequestLike) => Promise<HttpResponse>)): (req: Request) => Promise<Response>;
+/**
+ * Create a Beignet server adapted to the Web Fetch API.
+ *
+ * Use this for runtimes that accept standard `Request` objects and return
+ * standard `Response` objects. Next.js apps should usually use
+ * `@beignet/next`, which builds on the same Web adapter and adds Next-specific
+ * helpers.
+ */
+export declare function createFetchServer<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<FetchServer<Ctx, Ports & ProvidedPortsOfList<Providers>>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,KAAK,WAAW,GAAG,eAAe,CAChC,OAAO,EAEP,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC1B,QAAQ,CACT,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,GAAG,EAAE,KAAK,SAAS,QAAQ,GAAG,QAAQ;IACjE;;OAEG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C;;OAEG;IACH,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC;;OAEG;IACH,KAAK,EAAE,CAAC,KAAK,SAAS,YAAY,EAChC,YAAY,EAAE,KAAK,KAChB;QACH,MAAM,EAAE,CACN,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,KACrC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC1C,CAAC;IACF;;OAEG;IACH,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAa3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAc7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EACX,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,GACpC,CAAC,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,GACpD,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAOrC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EACH,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACjC,MAAM,SAAS,SAAS,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,QAAQ,CAAC,GAAG,CAAC,EAAE,EAClE,SAAS,SAAS,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE,EAEjE,OAAO,EAAE,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,GAC1D,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAcnE"}

package/dist/index.js

@@ -0,0 +1,69 @@
+import { createServer } from "@beignet/core/server";
+/**
+ * Server helpers re-exported for Web Fetch apps.
+ */
+export { contractsFromRoutes, createServer, defineRoute, defineRouteGroup, defineRouteHook, defineRoutes, } from "@beignet/core/server";
+/**
+ * Convert a native `Request` into Beignet's framework-neutral request shape.
+ */
+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()),
+    };
+}
+/**
+ * Convert a Beignet response into a native `Response`.
+ */
+export function toWebResponse(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 });
+}
+/**
+ * Create a Web Fetch handler from a Beignet server or API handler.
+ */
+export function createFetchHandler(serverOrHandler) {
+    const handler = typeof serverOrHandler === "function"
+        ? serverOrHandler
+        : serverOrHandler.api;
+    return async (req) => toWebResponse(await handler(toRequestLike(req)));
+}
+/**
+ * Create a Beignet server adapted to the Web Fetch API.
+ *
+ * Use this for runtimes that accept standard `Request` objects and return
+ * standard `Response` objects. Next.js apps should usually use
+ * `@beignet/next`, which builds on the same Web adapter and adds Next-specific
+ * helpers.
+ */
+export async function createFetchServer(options) {
+    const runtime = await createServer(options);
+    const fetch = createFetchHandler(runtime);
+    return {
+        fetch,
+        api: fetch,
+        route: (contract) => ({
+            handle: (fn) => createFetchHandler(runtime.route(contract).handle(fn)),
+        }),
+        contracts: runtime.contracts,
+        stop: () => runtime.stop(),
+        ports: runtime.ports,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAgBpD;;GAEG;AACH,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,sBAAsB,CAAC;AA6C9B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACjC,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;QACtB,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE;QACpC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;QACtB,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE;QAC9B,KAAK,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAqB;IACjD,IAAI,OAAO,YAAY,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,uFAAuF;IACvF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAW,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,eAEqD;IAErD,MAAM,OAAO,GACX,OAAO,eAAe,KAAK,UAAU;QACnC,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC;IAE1B,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAMrC,OAA2D;IAE3D,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE1C,OAAO;QACL,KAAK;QACL,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACpB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACvE,CAAC;QACF,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;AACJ,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,82 @@
+import { type CallArgs, type ClientConfig, type EndpointResult, type InferEndpointContractError, type InferSuccessResponse } from "@beignet/core/client";
+import type { AnyPorts } from "@beignet/core/ports";
+import type { ProvidedPortsOfList, ServiceProvider } from "@beignet/core/providers";
+import type { ContractLike, CreateServerOptions, ResolveContract, RouteDef } from "@beignet/core/server";
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import { type FetchServer } from "./index";
+type AnyProvider = ServiceProvider<unknown, StandardSchemaV1<any, any>, AnyPorts>;
+/**
+ * Client options accepted by `createTestApp(...)`.
+ */
+export type TestAppClientOptions<TProvidedHeaders extends string = never> = Omit<ClientConfig<TProvidedHeaders>, "baseUrl" | "fetch"> & {
+    /**
+     * Base URL used when the typed client builds requests.
+     *
+     * @default "http://beignet.test"
+     */
+    baseUrl?: string;
+};
+/**
+ * Options for creating a Web Fetch test app.
+ */
+export type CreateTestAppOptions<Ctx, Ports extends AnyPorts, Routes extends readonly RouteDef<Ctx>[], Providers extends readonly AnyProvider[], TProvidedHeaders extends string = never> = CreateServerOptions<Ctx, Ports, Routes, Providers> & {
+    /**
+     * Typed client behavior for `request(...)` and `safeRequest(...)`.
+     */
+    client?: TestAppClientOptions<TProvidedHeaders>;
+};
+/**
+ * Beignet app harness for route/runtime tests.
+ */
+export type TestApp<Ctx, Ports extends AnyPorts, TProvidedHeaders extends string = never> = {
+    /**
+     * Underlying Web Fetch server.
+     */
+    server: FetchServer<Ctx, Ports>;
+    /**
+     * Fetch implementation bound to the in-memory Beignet server.
+     */
+    fetch: typeof fetch;
+    /**
+     * Final app ports after provider setup.
+     */
+    ports: Ports;
+    /**
+     * Contracts registered through the server route list.
+     */
+    contracts: FetchServer<Ctx, Ports>["contracts"];
+    /**
+     * Call a contract through the test app and return the parsed success body.
+     */
+    request: <CLike extends ContractLike>(contract: CLike, ...args: CallArgs<ResolveContract<CLike>, TProvidedHeaders>) => Promise<InferSuccessResponse<ResolveContract<CLike>>>;
+    /**
+     * Call a contract through the test app and return a typed success/error
+     * result instead of throwing.
+     */
+    safeRequest: <CLike extends ContractLike>(contract: CLike, ...args: CallArgs<ResolveContract<CLike>, TProvidedHeaders>) => Promise<EndpointResult<ResolveContract<CLike>, InferEndpointContractError<ResolveContract<CLike>>>>;
+    /**
+     * Stop installed providers.
+     */
+    stop: () => Promise<void>;
+};
+/**
+ * Create a `fetch` implementation that dispatches requests to a Beignet Web
+ * server without opening a network port.
+ *
+ * @param server - Web Fetch server under test.
+ * @returns Fetch-compatible function backed by `server.fetch`.
+ */
+export declare function createTestFetch<Ctx, Ports extends AnyPorts>(server: Pick<FetchServer<Ctx, Ports>, "fetch">): typeof fetch;
+/**
+ * Create a Beignet route/runtime test harness.
+ *
+ * The harness uses `@beignet/web` under the hood, so tests exercise the same
+ * request parsing, route hooks, response validation, and error ownership as a
+ * Web Fetch runtime without requiring Next.js or a network listener.
+ *
+ * @param options - Server options plus optional typed-client settings.
+ * @returns Test app with typed `request(...)` helpers and a bound `fetch`.
+ */
+export declare function createTestApp<Ctx, Ports extends AnyPorts = AnyPorts, Routes extends readonly RouteDef<Ctx>[] = readonly RouteDef<Ctx>[], Providers extends readonly AnyProvider[] = readonly AnyProvider[], const TProvidedHeaders extends string = never>(options: CreateTestAppOptions<Ctx, Ports, Routes, Providers, TProvidedHeaders>): Promise<TestApp<Ctx, Ports & ProvidedPortsOfList<Providers>, TProvidedHeaders>>;
+export {};
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

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

package/dist/testing.js

@@ -0,0 +1,45 @@
+import { createClient, } from "@beignet/core/client";
+import { createFetchServer } from "./index";
+/**
+ * Create a `fetch` implementation that dispatches requests to a Beignet Web
+ * server without opening a network port.
+ *
+ * @param server - Web Fetch server under test.
+ * @returns Fetch-compatible function backed by `server.fetch`.
+ */
+export function createTestFetch(server) {
+    return ((input, init) => {
+        const req = new Request(input, init);
+        return server.fetch(req);
+    });
+}
+/**
+ * Create a Beignet route/runtime test harness.
+ *
+ * The harness uses `@beignet/web` under the hood, so tests exercise the same
+ * request parsing, route hooks, response validation, and error ownership as a
+ * Web Fetch runtime without requiring Next.js or a network listener.
+ *
+ * @param options - Server options plus optional typed-client settings.
+ * @returns Test app with typed `request(...)` helpers and a bound `fetch`.
+ */
+export async function createTestApp(options) {
+    const { client: clientOptions, ...serverOptions } = options;
+    const server = await createFetchServer(serverOptions);
+    const fetch = createTestFetch(server);
+    const client = createClient({
+        ...clientOptions,
+        baseUrl: clientOptions?.baseUrl ?? "http://beignet.test",
+        fetch,
+    });
+    return {
+        server,
+        fetch,
+        ports: server.ports,
+        contracts: server.contracts,
+        request: (contract, ...args) => client.endpoint(contract).call(...args),
+        safeRequest: (contract, ...args) => client.endpoint(contract).safeCall(...args),
+        stop: () => server.stop(),
+    };
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,GAIb,MAAM,sBAAsB,CAAC;AAa9B,OAAO,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAC;AAwF9D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA8C;IAE9C,OAAO,CAAC,CAAC,KAAwB,EAAE,IAAkB,EAAE,EAAE;QACvD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAErC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAiB,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAOjC,OAMC;IAID,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,CAAmB;QAC5C,GAAG,aAAa;QAChB,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,qBAAqB;QACxD,KAAK;KACN,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvE,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,CACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAC7C,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;KAC1B,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@beignet/web",
+  "version": "0.0.3",
+  "type": "module",
+  "description": "Web Fetch adapter for Beignet",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.test-d.ts",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist coverage .turbo",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage",
+    "lint": "biome check ."
+  },
+  "keywords": [
+    "contract",
+    "api",
+    "typescript",
+    "fetch",
+    "web-standard"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taylorbryant/beignet.git",
+    "directory": "packages/web"
+  },
+  "author": "Taylor Bryant",
+  "homepage": "https://github.com/taylorbryant/beignet#readme",
+  "bugs": "https://github.com/taylorbryant/beignet/issues",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@beignet/core": "*",
+    "@standard-schema/spec": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.13",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "zod": "^4.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,169 @@
+import type { AnyPorts } from "@beignet/core/ports";
+import type {
+  ProvidedPortsOfList,
+  ServiceProvider,
+} from "@beignet/core/providers";
+import type {
+  ContractLike,
+  CreateServerOptions,
+  Handler,
+  HttpRequestLike,
+  HttpResponse,
+  ResolveContract,
+  RouteDef,
+  ServerInstance,
+} from "@beignet/core/server";
+import { createServer } from "@beignet/core/server";
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+
+/**
+ * Server types re-exported for Web Fetch apps.
+ */
+export type {
+  CreateServerOptions,
+  HttpRequestLike,
+  HttpResponse,
+  RouteDef,
+  RouteGroup,
+  RouteHook,
+  ServerInstance,
+} from "@beignet/core/server";
+
+/**
+ * Server helpers re-exported for Web Fetch apps.
+ */
+export {
+  contractsFromRoutes,
+  createServer,
+  defineRoute,
+  defineRouteGroup,
+  defineRouteHook,
+  defineRoutes,
+} from "@beignet/core/server";
+
+type AnyProvider = ServiceProvider<
+  unknown,
+  // biome-ignore lint/suspicious/noExplicitAny: provider config types are erased at this level
+  StandardSchemaV1<any, any>,
+  AnyPorts
+>;
+
+/**
+ * Beignet server adapted to the Web Fetch API.
+ */
+export interface FetchServer<Ctx, Ports extends AnyPorts = AnyPorts> {
+  /**
+   * Catch-all Web Fetch handler.
+   */
+  fetch: (req: Request) => Promise<Response>;
+  /**
+   * Alias for `fetch` for API route adapters that expect an `api` property.
+   */
+  api: (req: Request) => Promise<Response>;
+  /**
+   * Register and build a single Web Fetch route handler imperatively.
+   */
+  route: <CLike extends ContractLike>(
+    contractLike: CLike,
+  ) => {
+    handle: (
+      fn: Handler<Ctx, ResolveContract<CLike>>,
+    ) => (req: Request) => Promise<Response>;
+  };
+  /**
+   * Registered contract inputs.
+   */
+  contracts: readonly ContractLike[];
+  /**
+   * Stop installed providers.
+   */
+  stop: () => Promise<void>;
+  /**
+   * Final app ports after provider setup.
+   */
+  ports: Ports;
+}
+
+/**
+ * Convert a native `Request` into Beignet's framework-neutral request shape.
+ */
+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()),
+  };
+}
+
+/**
+ * Convert a Beignet response into a native `Response`.
+ */
+export function toWebResponse(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 });
+}
+
+/**
+ * Create a Web Fetch handler from a Beignet server or API handler.
+ */
+export function createFetchHandler(
+  serverOrHandler:
+    | Pick<ServerInstance<unknown>, "api">
+    | ((req: HttpRequestLike) => Promise<HttpResponse>),
+): (req: Request) => Promise<Response> {
+  const handler =
+    typeof serverOrHandler === "function"
+      ? serverOrHandler
+      : serverOrHandler.api;
+
+  return async (req) => toWebResponse(await handler(toRequestLike(req)));
+}
+
+/**
+ * Create a Beignet server adapted to the Web Fetch API.
+ *
+ * Use this for runtimes that accept standard `Request` objects and return
+ * standard `Response` objects. Next.js apps should usually use
+ * `@beignet/next`, which builds on the same Web adapter and adds Next-specific
+ * helpers.
+ */
+export async function createFetchServer<
+  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<FetchServer<Ctx, Ports & ProvidedPortsOfList<Providers>>> {
+  const runtime = await createServer(options);
+  const fetch = createFetchHandler(runtime);
+
+  return {
+    fetch,
+    api: fetch,
+    route: (contract) => ({
+      handle: (fn) => createFetchHandler(runtime.route(contract).handle(fn)),
+    }),
+    contracts: runtime.contracts,
+    stop: () => runtime.stop(),
+    ports: runtime.ports,
+  };
+}

package/src/testing.ts

@@ -0,0 +1,172 @@
+import {
+  type CallArgs,
+  type ClientConfig,
+  createClient,
+  type EndpointResult,
+  type InferEndpointContractError,
+  type InferSuccessResponse,
+} from "@beignet/core/client";
+import type { AnyPorts } from "@beignet/core/ports";
+import type {
+  ProvidedPortsOfList,
+  ServiceProvider,
+} from "@beignet/core/providers";
+import type {
+  ContractLike,
+  CreateServerOptions,
+  ResolveContract,
+  RouteDef,
+} from "@beignet/core/server";
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import { createFetchServer, type FetchServer } from "./index";
+
+type AnyProvider = ServiceProvider<
+  unknown,
+  // biome-ignore lint/suspicious/noExplicitAny: provider config types are erased at this level.
+  StandardSchemaV1<any, any>,
+  AnyPorts
+>;
+
+/**
+ * Client options accepted by `createTestApp(...)`.
+ */
+export type TestAppClientOptions<TProvidedHeaders extends string = never> =
+  Omit<ClientConfig<TProvidedHeaders>, "baseUrl" | "fetch"> & {
+    /**
+     * Base URL used when the typed client builds requests.
+     *
+     * @default "http://beignet.test"
+     */
+    baseUrl?: string;
+  };
+
+/**
+ * Options for creating a Web Fetch test app.
+ */
+export type CreateTestAppOptions<
+  Ctx,
+  Ports extends AnyPorts,
+  Routes extends readonly RouteDef<Ctx>[],
+  Providers extends readonly AnyProvider[],
+  TProvidedHeaders extends string = never,
+> = CreateServerOptions<Ctx, Ports, Routes, Providers> & {
+  /**
+   * Typed client behavior for `request(...)` and `safeRequest(...)`.
+   */
+  client?: TestAppClientOptions<TProvidedHeaders>;
+};
+
+/**
+ * Beignet app harness for route/runtime tests.
+ */
+export type TestApp<
+  Ctx,
+  Ports extends AnyPorts,
+  TProvidedHeaders extends string = never,
+> = {
+  /**
+   * Underlying Web Fetch server.
+   */
+  server: FetchServer<Ctx, Ports>;
+  /**
+   * Fetch implementation bound to the in-memory Beignet server.
+   */
+  fetch: typeof fetch;
+  /**
+   * Final app ports after provider setup.
+   */
+  ports: Ports;
+  /**
+   * Contracts registered through the server route list.
+   */
+  contracts: FetchServer<Ctx, Ports>["contracts"];
+  /**
+   * Call a contract through the test app and return the parsed success body.
+   */
+  request: <CLike extends ContractLike>(
+    contract: CLike,
+    ...args: CallArgs<ResolveContract<CLike>, TProvidedHeaders>
+  ) => Promise<InferSuccessResponse<ResolveContract<CLike>>>;
+  /**
+   * Call a contract through the test app and return a typed success/error
+   * result instead of throwing.
+   */
+  safeRequest: <CLike extends ContractLike>(
+    contract: CLike,
+    ...args: CallArgs<ResolveContract<CLike>, TProvidedHeaders>
+  ) => Promise<
+    EndpointResult<
+      ResolveContract<CLike>,
+      InferEndpointContractError<ResolveContract<CLike>>
+    >
+  >;
+  /**
+   * Stop installed providers.
+   */
+  stop: () => Promise<void>;
+};
+
+/**
+ * Create a `fetch` implementation that dispatches requests to a Beignet Web
+ * server without opening a network port.
+ *
+ * @param server - Web Fetch server under test.
+ * @returns Fetch-compatible function backed by `server.fetch`.
+ */
+export function createTestFetch<Ctx, Ports extends AnyPorts>(
+  server: Pick<FetchServer<Ctx, Ports>, "fetch">,
+): typeof fetch {
+  return ((input: RequestInfo | URL, init?: RequestInit) => {
+    const req = new Request(input, init);
+
+    return server.fetch(req);
+  }) as typeof fetch;
+}
+
+/**
+ * Create a Beignet route/runtime test harness.
+ *
+ * The harness uses `@beignet/web` under the hood, so tests exercise the same
+ * request parsing, route hooks, response validation, and error ownership as a
+ * Web Fetch runtime without requiring Next.js or a network listener.
+ *
+ * @param options - Server options plus optional typed-client settings.
+ * @returns Test app with typed `request(...)` helpers and a bound `fetch`.
+ */
+export async function createTestApp<
+  Ctx,
+  Ports extends AnyPorts = AnyPorts,
+  Routes extends readonly RouteDef<Ctx>[] = readonly RouteDef<Ctx>[],
+  Providers extends readonly AnyProvider[] = readonly AnyProvider[],
+  const TProvidedHeaders extends string = never,
+>(
+  options: CreateTestAppOptions<
+    Ctx,
+    Ports,
+    Routes,
+    Providers,
+    TProvidedHeaders
+  >,
+): Promise<
+  TestApp<Ctx, Ports & ProvidedPortsOfList<Providers>, TProvidedHeaders>
+> {
+  const { client: clientOptions, ...serverOptions } = options;
+  const server = await createFetchServer(serverOptions);
+  const fetch = createTestFetch(server);
+  const client = createClient<TProvidedHeaders>({
+    ...clientOptions,
+    baseUrl: clientOptions?.baseUrl ?? "http://beignet.test",
+    fetch,
+  });
+
+  return {
+    server,
+    fetch,
+    ports: server.ports,
+    contracts: server.contracts,
+    request: (contract, ...args) => client.endpoint(contract).call(...args),
+    safeRequest: (contract, ...args) =>
+      client.endpoint(contract).safeCall(...args),
+    stop: () => server.stop(),
+  };
+}