@fougere/adapter-rest 0.2.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# @fougere/adapter-rest
+> Entity → REST routes
+The REST projection of a frond's operations, with egress applied at the edge.
+
+## Installation
+```bash
+pnpm add @fougere/adapter-rest
+```
+
+---
+
+Part of [Fougere](https://github.com/chok/fougere) — one schema, a gradient from
+monolith to distributed, the same user code.
+Reference documentation: [the site](https://chok.github.io/fougere/) (en/fr).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { generateRoutes, type RouteDefinition, type HttpMethod, type GenerateRoutesOptions } from './routes.js';
+export { registerRoutes } from './register.js';
+//# 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,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { generateRoutes } from './routes.js';
+export { registerRoutes } from './register.js';
+// No schema endpoint here. Discovery is `rpc.discover` on the envelope — one
+// surface, which answers with what the host SERVES. A second GET published
+// every scanned entity instead, façade or not: the auth tables of a host that
+// mounted it were readable by anyone.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqE,MAAM,aAAa,CAAC;AAChH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,sCAAsC"}

package/dist/register.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Framework-agnostic route registration — translates RouteDefinition[] into HttpRouter calls.
+ */
+import type { HttpRouter } from '@fougere/http';
+import type { RouteDefinition } from './routes.js';
+/**
+ * Register all route definitions on an HttpRouter.
+ *
+ * ```ts
+ * const routes = generateRoutes(app, { prefix: '/api' });
+ * registerRoutes(router, routes);
+ * ```
+ */
+export declare function registerRoutes(router: HttpRouter, routes: RouteDefinition[]): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EAAE,GACxB,IAAI,CA2CN"}

package/dist/register.js

@@ -0,0 +1,50 @@
+import { toHttpError } from '@fougere/core';
+/**
+ * Register all route definitions on an HttpRouter.
+ *
+ * ```ts
+ * const routes = generateRoutes(app, { prefix: '/api' });
+ * registerRoutes(router, routes);
+ * ```
+ */
+export function registerRoutes(router, routes) {
+    for (const route of routes) {
+        router.on(route.method, route.path, async (ctx) => {
+            const body = (await ctx.body());
+            // Build unified InvocationContext for the binding algorithm
+            const invocation = {
+                params: ctx.params,
+                query: ctx.query,
+                body,
+                state: ctx.state,
+            };
+            try {
+                const result = await route.handler(invocation);
+                if ((result === undefined || result === null) && route.operationName === 'findById') {
+                    return { status: 404, data: { error: 'Not found' } };
+                }
+                if (result === true && route.operationName === 'delete') {
+                    return { status: 204, data: null };
+                }
+                if (result === false && route.operationName === 'delete') {
+                    return { status: 404, data: { error: 'Not found' } };
+                }
+                // The computed fields are already here: the façade applies the presenter on every
+                // door (`presentEgress`), so a route that re-applied it did the work twice — and
+                // once a computed field started receiving the PAGE rather than one row, the second
+                // pass handed it a single object and threw `posts.map is not a function`.
+                return {
+                    status: route.successStatus ?? (route.operationName === 'create' ? 201 : 200),
+                    // The façade is the single egress boundary for every door. Re-encoding here
+                    // makes custom encoders run twice and makes REST disagree with the envelope.
+                    data: result,
+                };
+            }
+            catch (err) {
+                const { status, body } = toHttpError(err);
+                return { status, data: body };
+            }
+        });
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAkB,EAClB,MAAyB;IAEzB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAChD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwC,CAAC;YAEvE,4DAA4D;YAC5D,MAAM,UAAU,GAAG;gBACjB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,IAAI;gBACJ,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAE/C,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;oBACpF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;gBACvD,CAAC;gBACD,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;oBACxD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBACrC,CAAC;gBACD,IAAI,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;oBACzD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;gBACvD,CAAC;gBAED,kFAAkF;gBAClF,iFAAiF;gBACjF,mFAAmF;gBACnF,0EAA0E;gBAE1E,OAAO;oBACL,MAAM,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC7E,4EAA4E;oBAC5E,6EAA6E;oBAC7E,IAAI,EAAE,MAAM;iBACb,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC1C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @fougere/adapter-rest — generates REST route definitions from fougere handlers.
+ *
+ * Framework-agnostic: produces RouteDefinition[], consumed by an adapter (Fastify, Express, etc).
+ */
+import type { Fields, SchemaSource } from '@fougere/schema';
+import type { HandlerEntry as CoreHandlerEntry } from '@fougere/core';
+export type { HttpMethod } from '@fougere/http';
+import type { HttpMethod } from '@fougere/http';
+export interface RouteDefinition {
+    method: HttpMethod;
+    path: string;
+    operationName: string;
+    entityName: string;
+    /** Handler facade method to call (receives InvocationContext). */
+    handler: (invocation: unknown) => Promise<unknown>;
+    /** Input schema (for validation / JSON schema generation). */
+    inputFields?: Fields;
+    /** Output schema (for JSON schema generation). */
+    outputFields?: Fields;
+    /** Explicit success status. Defaults to 201 only for the canonical `create` op. */
+    successStatus?: number;
+    /**
+     * The operation in words — the method's own doc sentence, carried by the contract.
+     *
+     * A route is what an OpenAPI `summary` is generated FROM, and the sentence reached
+     * this file already (`handler.operations` is core's `Map<string, OperationContract>`);
+     * only this type had no name for it, so every generated route was undocumented while
+     * the sentence sat one property away. Carried, not rendered: emitting OpenAPI is a
+     * reader's job, and this is what it reads.
+     */
+    description?: string;
+}
+interface OperationMeta {
+    input?: SchemaSource;
+    output?: SchemaSource;
+    /** The operation in words — see `RouteDefinition.description`. */
+    description?: string;
+}
+interface EntityEntry {
+    name: string;
+    /** A live class in-process, a card from a frond whose class never crossed. */
+    entityClass: SchemaSource;
+    exposed?: boolean;
+}
+/**
+ * Only what this projection reads of a scanned handler — five fields of nine.
+ *
+ * The narrowness is deliberate: a consumer that declares what it consumes accepts a
+ * minimal literal in a test and does not break when a field it ignores moves. What was
+ * NOT deliberate is that the two names it does read were spelled again here, so renaming
+ * `entityName` to `address` in core left this file compiling against a field the runtime
+ * object no longer carried — a silent break, caught only because the same commit touched
+ * the reads. `Pick` keeps the narrow view and makes core the one place the names live.
+ *
+ * `schema-graphql` holds a copy of this shape and cannot do the same: it depends on
+ * `@fougere/schema` and `@fougere/http`, never on core, which is what lets a projection
+ * package stay structurally typed. There the duplication is the doctrine, not an oversight.
+ */
+type HandlerEntry = Pick<CoreHandlerEntry, 'address' | 'surface'> & {
+    operations: Map<string, OperationMeta>;
+    /** `Crud(Post, PostPublic)` — the handler-wide output view, scoping every op. */
+    outputOverride?: SchemaSource;
+    /** The scanned constructor, which carries the same statement made on the class. */
+    ctor?: {
+        __output?: SchemaSource;
+    };
+};
+interface PresenterEntry {
+    entityName: string;
+    fields: string[];
+}
+interface FrondLike {
+    name: string;
+    entities: EntityEntry[];
+    handlers: HandlerEntry[];
+    presenters: PresenterEntry[];
+    surfaces?: Record<string, string[]>;
+    operationsOverrides?: Record<string, {
+        kind?: 'query' | 'command';
+        handlerName?: string;
+        method?: string;
+        policy?: string;
+    }>;
+}
+interface AppLike {
+    fronds: FrondLike[];
+    resolve<T>(name: string): T;
+    /** The façade an entity exposes to one audience — `undefined` when none. */
+    facadeFor(entity: string, surface?: string): Record<string, Function> | undefined;
+}
+export interface GenerateRoutesOptions {
+    /** Base path prefix (e.g. '/api'). Default: ''. */
+    prefix?: string;
+    /** Override route config per entity. */
+    overrides?: Record<string, Record<string, {
+        method?: HttpMethod;
+        path?: string;
+        status?: number;
+    }>>;
+    /** Filter entities. */
+    filter?: (entity: EntityEntry, frondName: string) => boolean;
+    /** Surface name for filtering (e.g. 'rest', 'graphql'). Uses frond.config.ts surfaces if set. */
+    surface?: string;
+}
+/**
+ * Generate REST route definitions from a fougere App.
+ *
+ * Conventions:
+ * - Entity name → pluralized base path (/posts, /authors)
+ * - list → GET /posts
+ * - findById → GET /posts/:id
+ * - create → POST /posts
+ * - update → PUT /posts/:id
+ * - delete → DELETE /posts/:id
+ * - Custom: searchByTitle → GET /posts/search-by-title
+ * - Custom with ById: archiveById → POST /posts/:id/archive
+ * - Override any route via options.overrides
+ */
+export declare function generateRoutes(app: AppLike, options?: GenerateRoutesOptions): RouteDefinition[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

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

package/dist/routes.js

@@ -0,0 +1,135 @@
+import { fieldsOf, inputFields as clientInputFields, outputFields as clientOutputFields } from '@fougere/schema';
+import { resolveIsReadOp } from '@fougere/core';
+// ─── Naming conventions ─────────────────────────
+function hasById(name) {
+    return name.includes('ById') || name === 'findById' || name === 'update' || name === 'delete';
+}
+function pluralize(name) {
+    return name.endsWith('y')
+        ? name.slice(0, -1) + 'ies'
+        : name + 's';
+}
+/** Derive HTTP method from operation name, honoring frond.config.ts overrides. */
+function deriveMethod(opName, overrides) {
+    if (resolveIsReadOp(opName, overrides))
+        return 'GET';
+    if (opName.startsWith('create'))
+        return 'POST';
+    if (opName.startsWith('update') || opName.startsWith('edit'))
+        return 'PUT';
+    if (opName.startsWith('delete') || opName.startsWith('remove'))
+        return 'DELETE';
+    return 'POST';
+}
+/** Derive route path from entity name + operation name. */
+function derivePath(entityName, opName) {
+    const base = `/${pluralize(entityName)}`;
+    // Standard CRUD
+    if (opName === 'list')
+        return base;
+    if (opName === 'findById')
+        return `${base}/:id`;
+    if (opName === 'create')
+        return base;
+    if (opName === 'update')
+        return `${base}/:id`;
+    if (opName === 'delete')
+        return `${base}/:id`;
+    // Remaining operations (convention-based)
+    const withId = hasById(opName);
+    const cleanName = opName.replace('ById', '');
+    const segment = cleanName.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase());
+    return withId ? `${base}/:id/${segment}` : `${base}/${segment}`;
+}
+/**
+ * Generate REST route definitions from a fougere App.
+ *
+ * Conventions:
+ * - Entity name → pluralized base path (/posts, /authors)
+ * - list → GET /posts
+ * - findById → GET /posts/:id
+ * - create → POST /posts
+ * - update → PUT /posts/:id
+ * - delete → DELETE /posts/:id
+ * - Custom: searchByTitle → GET /posts/search-by-title
+ * - Custom with ById: archiveById → POST /posts/:id/archive
+ * - Override any route via options.overrides
+ */
+export function generateRoutes(app, options) {
+    const prefix = options?.prefix ?? '';
+    const overrides = options?.overrides ?? {};
+    const routes = [];
+    for (const frond of app.fronds) {
+        const handlerMap = new Map(frond.handlers.filter((h) => !h.surface).map((h) => [h.address, h]));
+        const surfaceName = options?.surface;
+        for (const entity of frond.entities) {
+            // Membership is core's answer, not ours — one rule, read here (see App.facadeFor).
+            const facade = app.facadeFor(entity.name, surfaceName);
+            if (!facade)
+                continue;
+            if (options?.filter && !options.filter(entity, frond.name))
+                continue;
+            if (!surfaceName && entity.exposed === false)
+                continue;
+            const handler = (surfaceName
+                ? frond.handlers.find((h) => h.address === entity.name && h.surface === surfaceName)
+                : undefined) ?? handlerMap.get(entity.name);
+            // Use facade keys (includes inherited ops like CRUD), fallback to handler.operations
+            const opNames = Object.keys(facade);
+            const entityOverrides = overrides[entity.name] ?? {};
+            // Use handler's output schema if declared, otherwise entity. A live class or a
+            // card — `fieldsOf` takes both, so a frond whose class never crossed the wire
+            // projects the same routes as a local one.
+            const outputSchema = handler?.outputOverride
+                ?? handler?.ctor?.__output
+                ?? entity.entityClass;
+            const fields = fieldsOf(outputSchema);
+            for (const opName of opNames) {
+                const meta = handler?.operations.get(opName);
+                const override = entityOverrides[opName];
+                const method = override?.method ?? deriveMethod(opName, frond.operationsOverrides);
+                const path = prefix + (override?.path ?? derivePath(entity.name, opName));
+                // Input/output fields: use meta if available, fallback to entity fields for CRUD.
+                // Both pass through the client-surface projections (write-only out, read-only in).
+                let inputFields;
+                let outputFields = clientOutputFields(fields);
+                if (meta?.input) {
+                    inputFields = fieldsOf(meta.input);
+                }
+                else if (opName === 'create' || opName === 'update') {
+                    inputFields = clientInputFields(fields);
+                }
+                if (meta?.output)
+                    outputFields = clientOutputFields(fieldsOf(meta.output));
+                // Per-op handler override: redirect to a different class+method resolved from DI.
+                const opOverride = frond.operationsOverrides?.[opName];
+                let op = facade[opName];
+                if (opOverride?.handlerName) {
+                    try {
+                        const altFacade = app.resolve(opOverride.handlerName);
+                        const altMethod = opOverride.method ?? opName;
+                        if (typeof altFacade[altMethod] === 'function') {
+                            op = altFacade[altMethod].bind(altFacade);
+                        }
+                    }
+                    catch { /* alternate handler not in DI — fall back to default */ }
+                }
+                if (!op)
+                    continue;
+                routes.push({
+                    method,
+                    path,
+                    operationName: opName,
+                    entityName: entity.name,
+                    handler: (invocation) => op(invocation),
+                    inputFields,
+                    outputFields,
+                    successStatus: override?.status,
+                    ...(meta?.description && { description: meta.description }),
+                });
+            }
+        }
+    }
+    return routes;
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@fougere/adapter-rest",
+  "version": "0.2.0-alpha.2",
+  "description": "Entity → REST routes.",
+  "keywords": [
+    "fougere",
+    "typescript",
+    "rest",
+    "http",
+    "api"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/adapter/rest"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fougere/core": "0.2.0-alpha.2",
+    "@fougere/schema": "0.2.0-alpha.2",
+    "@fougere/http": "0.2.0-alpha.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  }
+}