@fougere/adapter-rest 0.16.7-alpha.0 → 0.17.0-alpha.0

package/dist/routes/GenerateRoutesOptions.d.ts

@@ -1,16 +1,15 @@
 import type { HttpMethod } from '@fougere/http';
-import type { EntityEntry } from './EntityEntry.js';
 export interface GenerateRoutesOptions {
     /** Base path prefix (e.g. '/api'). Default: ''. */
     prefix?: string;
-    /** Override route config per entity. */
+    /** Override route config per address, then per operation. */
     overrides?: Record<string, Record<string, {
         method?: HttpMethod;
         path?: string;
         status?: number;
     }>>;
-    /** Filter entities. */
-    filter?: (entity: EntityEntry, frondName: string) => boolean;
+    /** Keep only the addresses this answers true for. */
+    filter?: (address: string, frondName: string) => boolean;
     /** Surface name for filtering (e.g. 'rest', 'graphql'). Uses frond.config.ts surfaces if set. */
     surface?: string;
 }

package/dist/routes/GenerateRoutesOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GenerateRoutesOptions.d.ts","sourceRoot":"","sources":["../../src/routes/GenerateRoutesOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpG,uBAAuB;IACvB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7D,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"GenerateRoutesOptions.d.ts","sourceRoot":"","sources":["../../src/routes/GenerateRoutesOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpG,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/routes/RouteDefinition.d.ts

@@ -1,14 +1,14 @@
-import type { Fields, SchemaView } from '@fougere/schema';
+import type { Fields } from '@fougere/schema';
 import type { HttpMethod } from '@fougere/http';
 import type { HandlerEntry as CoreHandlerEntry } from '@fougere/core';
-import type { EntityEntry } from './EntityEntry.js';
 import type { OperationMeta } from './OperationMeta.js';
 import type { GenerateRoutesOptions } from './GenerateRoutesOptions.js';
 export interface RouteDefinition {
     method: HttpMethod;
     path: string;
     operationName: string;
-    entityName: string;
+    /** Where the operation answers — `checkout` in `checkout.pay`. */
+    address: string;
     /** Handler facade method to call (receives InvocationContext). */
     handler: (invocation: unknown) => Promise<unknown>;
     /** Input schema (for validation / JSON schema generation). */
@@ -20,22 +20,14 @@ export interface RouteDefinition {
     /** The operation in words — the method's own doc sentence, carried by the contract. */
     description?: string;
 }
-/** Only what this projection reads of a scanned handler — five fields of nine. */
-type HandlerEntry = Pick<CoreHandlerEntry, 'address' | 'surface'> & {
-    /** `Crud(Post, PostPublic)` — the handler-wide output view, scoping every op. */
-    outputOverride?: SchemaView;
-    /** The scanned constructor, which carries the same statement made on the class. */
-    ctor?: (new (...args: never[]) => unknown) & {
-        __output?: SchemaView;
-    };
-};
+/** Only what this projection reads of a scanned handler. */
+type HandlerEntry = Pick<CoreHandlerEntry, 'address' | 'surface' | 'exposed'>;
 interface PresenterEntry {
     entityName: string;
     fields: string[];
 }
 interface FrondLike {
     name: string;
-    entities: EntityEntry[];
     handlers: HandlerEntry[];
     presenters: PresenterEntry[];
     surfaces?: Record<string, string[]>;
@@ -50,12 +42,12 @@ interface FrondLike {
 }
 interface AppLike {
     fronds: FrondLike[];
-    /** The façade an entity exposes to one audience — `undefined` when none. */
-    facadeFor(entity: string, surface?: string): Record<string, Function> | undefined;
+    /** The façade an address serves to one audience — `undefined` when none. */
+    facadeFor(address: string, surface?: string): Record<string, Function> | undefined;
     /** Canonical operation table produced by core. */
-    operationsFor(entity: string, surface?: string): Map<string, OperationMeta> | undefined;
+    operationsFor(address: string, surface?: string): Map<string, OperationMeta> | undefined;
 }
-/** Generate REST route definitions from a fougere App. */
+/** Generate REST route definitions from a fougere App — one route per operation, per address served. */
 export declare function generateRoutes(app: AppLike, options?: GenerateRoutesOptions): RouteDefinition[];
 export {};
 //# sourceMappingURL=RouteDefinition.d.ts.map

package/dist/routes/RouteDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouteDefinition.d.ts","sourceRoot":"","sources":["../../src/routes/RouteDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,OAAO,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;CAItB;AAED,kFAAkF;AAClF,KAAK,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG;IAClE,iFAAiF;IACjF,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,mFAAmF;IACnF,IAAI,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,UAAU,CAAA;KAAE,CAAC;CACxE,CAAC;AASF,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACtG;AAED,UAAU,OAAO;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;IAClF,kDAAkD;IAClD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC;CACzF;AA8DD,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,eAAe,EAAE,CAGnG"}
+{"version":3,"file":"RouteDefinition.d.ts","sourceRoot":"","sources":["../../src/routes/RouteDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;CAItB;AAED,4DAA4D;AAC5D,KAAK,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAS9E,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACtG;AAED,UAAU,OAAO;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;IACnF,kDAAkD;IAClD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC;CAC1F;AA8DD,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,eAAe,EAAE,CAInG"}

package/dist/routes/RouteDefinition.js

@@ -24,9 +24,9 @@ function deriveMethod(opName, resolvedKind) {
         return 'DELETE';
     return 'POST';
 }
-/** Derive route path from entity name + operation name. */
-function derivePath(entityName, opName) {
-    const base = `/${pluralize(entityName)}`;
+/** Derive route path from the address + operation name. */
+function derivePath(address, opName) {
+    const base = `/${pluralize(address)}`;
     // Standard CRUD
     if (opName === 'list')
         return base;
@@ -49,52 +49,49 @@ function derivePath(entityName, opName) {
 // route's MODE (operationName 'update' → patch), never forged per-field flags.
 // Membership is the axes-derived `Visibility.input` projection from @fougere/schema.
 // ─── Public API ─────────────────────────────────
-/** Generate REST route definitions from a fougere App. */
+/** Generate REST route definitions from a fougere App — one route per operation, per address served. */
 export function generateRoutes(app, options = {}) {
-    return app.fronds.flatMap((frond) => frond.entities.flatMap((entity) => routesOf(app, frond, entity, options)));
+    return app.fronds.flatMap((frond) => [...new Set(frond.handlers.map((handler) => handler.address))]
+        .flatMap((address) => routesOf(app, frond, address, options)));
 }
-/** What one entity answers on REST — nothing, when this surface does not serve it. */
-function routesOf(app, frond, entity, options) {
+/** What one address answers on REST — nothing, when this surface does not serve it. */
+function routesOf(app, frond, address, options) {
     const surface = options.surface;
     // Membership is core's answer, not ours — one rule, read here (see App.facadeFor).
-    const facade = app.facadeFor(entity.name, surface);
+    const facade = app.facadeFor(address, surface);
     if (!facade)
         return [];
-    if (options.filter && !options.filter(entity, frond.name))
+    if (options.filter && !options.filter(address, frond.name))
         return [];
-    if (!surface && entity.exposed === false)
+    const handler = (surface
+        ? frond.handlers.find((one) => one.address === address && one.surface === surface)
+        : undefined) ?? frond.handlers.find((one) => !one.surface && one.address === address);
+    if (!surface && handler?.exposed === false)
         return [];
-    const effectiveOperations = app.operationsFor(entity.name, surface);
+    const effectiveOperations = app.operationsFor(address, surface);
     if (!effectiveOperations) {
-        throw new Error(`REST cannot project '${entity.name}' without its EffectiveOperation table.`);
+        throw new Error(`REST cannot project '${address}' without its EffectiveOperation table.`);
     }
-    const handler = (surface
-        ? frond.handlers.find((one) => one.address === entity.name && one.surface === surface)
-        : undefined) ?? frond.handlers.find((one) => !one.surface && one.address === entity.name);
-    // The handler's output schema if declared, otherwise the entity. A frond whose class never
-    // crossed the wire arrives as one too: boot rebuilds the card before here.
-    const outputSchema = handler?.outputOverride ?? handler?.ctor?.__output ?? entity.entityClass;
     // The resolved table defines the public operation set. This also works for remote proxy
     // facades, which intentionally cannot enumerate their keys before discovery.
     return [...effectiveOperations.keys()].map((opName) => routeFor({
-        entity,
+        address,
         frond,
         facade,
-        fields: outputSchema.getFields(),
         opName,
         meta: effectiveOperations.get(opName),
         options,
     }));
 }
-function routeFor({ entity, frond, facade, fields, opName, meta, options }) {
+function routeFor({ address, frond, facade, opName, meta, options }) {
     if (!meta) {
-        throw new Error(`REST facade '${entity.name}' exposes '${opName}' but its EffectiveOperation table does not.`);
+        throw new Error(`REST facade '${address}' exposes '${opName}' but its EffectiveOperation table does not.`);
     }
     // What the FROND said, then what this call said, then the convention. The frond comes first
     // because it names the operation; a host that overrides is deciding for someone else's,
     // which is what `overrides:` is for and why it wins.
     const stated = frond.operationsOverrides?.[opName]?.rest;
-    const override = { ...stated, ...(options.overrides?.[entity.name] ?? {})[opName] };
+    const override = { ...stated, ...(options.overrides?.[address] ?? {})[opName] };
     // Handler and method overrides are already executed by the facade, from the same
     // EffectiveOperation local and RPC use. The adapter never resolves DI itself.
     const op = facade[opName];
@@ -103,22 +100,20 @@ function routeFor({ entity, frond, facade, fields, opName, meta, options }) {
     }
     return {
         method: override.method ?? deriveMethod(opName, meta.kind),
-        path: (options.prefix ?? '') + (override.path ?? derivePath(entity.name, opName)),
+        path: (options.prefix ?? '') + (override.path ?? derivePath(address, opName)),
         operationName: opName,
-        entityName: entity.name,
+        address,
         handler: (invocation) => op(invocation),
-        ...inputAndOutput(meta, fields, opName),
+        ...inputAndOutput(meta),
         successStatus: override.status,
         ...(meta.description && { description: meta.description }),
     };
 }
 /** Both pass through the client-surface projections — write-only out, read-only in. */
-function inputAndOutput(meta, fields, opName) {
-    const inputFields = meta.input?.getFields()
-        ?? (opName === 'create' || opName === 'update' ? Visibility.of(fields).input : undefined);
+function inputAndOutput(meta) {
     return {
-        inputFields,
-        outputFields: meta.output ? Visibility.of(meta.output.getFields()).output : Visibility.of(fields).output,
+        inputFields: meta.input ? Visibility.of(meta.input.getFields()).input : undefined,
+        outputFields: meta.output ? Visibility.of(meta.output.getFields()).output : undefined,
     };
 }
 //# sourceMappingURL=RouteDefinition.js.map

package/dist/routes/RouteDefinition.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/adapter-rest",
-  "version": "0.16.7-alpha.0",
+  "version": "0.17.0-alpha.0",
   "description": "Entity → REST routes.",
   "keywords": [
     "fougere",
@@ -29,9 +29,9 @@
     "src"
   ],
   "dependencies": {
-    "@fougere/core": "0.16.7-alpha.0",
-    "@fougere/schema": "0.16.7-alpha.0",
-    "@fougere/http": "0.16.7-alpha.0"
+    "@fougere/core": "0.17.0-alpha.0",
+    "@fougere/schema": "0.17.0-alpha.0",
+    "@fougere/http": "0.17.0-alpha.0"
   },
   "publishConfig": {
     "access": "public"

package/src/routes/GenerateRoutesOptions.ts

@@ -1,13 +1,12 @@
 import type { HttpMethod } from '@fougere/http';
-import type { EntityEntry } from './EntityEntry.js';
 
 export interface GenerateRoutesOptions {
   /** Base path prefix (e.g. '/api'). Default: ''. */
   prefix?: string;
-  /** Override route config per entity. */
+  /** Override route config per address, then per operation. */
   overrides?: Record<string, Record<string, { method?: HttpMethod; path?: string; status?: number }>>;
-  /** Filter entities. */
-  filter?: (entity: EntityEntry, frondName: string) => boolean;
+  /** Keep only the addresses this answers true for. */
+  filter?: (address: string, frondName: string) => boolean;
   /** Surface name for filtering (e.g. 'rest', 'graphql'). Uses frond.config.ts surfaces if set. */
   surface?: string;
 }

package/src/routes/RouteDefinition.ts

@@ -1,8 +1,7 @@
-import type { Fields, SchemaView } from '@fougere/schema';
+import type { Fields } from '@fougere/schema';
 import { Visibility } from '@fougere/schema';
 import type { HttpMethod } from '@fougere/http';
 import type { HandlerEntry as CoreHandlerEntry } from '@fougere/core';
-import type { EntityEntry } from './EntityEntry.js';
 import type { OperationMeta } from './OperationMeta.js';
 import type { GenerateRoutesOptions } from './GenerateRoutesOptions.js';
 
@@ -10,7 +9,8 @@ export interface RouteDefinition {
   method: HttpMethod;
   path: string;
   operationName: string;
-  entityName: string;
+  /** Where the operation answers — `checkout` in `checkout.pay`. */
+  address: string;
   /** Handler facade method to call (receives InvocationContext). */
   handler: (invocation: unknown) => Promise<unknown>;
   /** Input schema (for validation / JSON schema generation). */
@@ -26,13 +26,8 @@ export interface RouteDefinition {
   // (`PresenterExecutor`), so the rows arrive computed and a second pass was duplicated work.
 }
 
-/** Only what this projection reads of a scanned handler — five fields of nine. */
-type HandlerEntry = Pick<CoreHandlerEntry, 'address' | 'surface'> & {
-  /** `Crud(Post, PostPublic)` — the handler-wide output view, scoping every op. */
-  outputOverride?: SchemaView;
-  /** The scanned constructor, which carries the same statement made on the class. */
-  ctor?: (new (...args: never[]) => unknown) & { __output?: SchemaView };
-};
+/** Only what this projection reads of a scanned handler. */
+type HandlerEntry = Pick<CoreHandlerEntry, 'address' | 'surface' | 'exposed'>;
 // No `operations` here, and its absence is the point. It was declared, never read — this
 // file takes its table from `app.operationsFor()` — and it carried `OperationMeta`, whose
 // `kind` is REQUIRED because that is true of an EffectiveOperation. A scanned handler's
@@ -48,7 +43,6 @@ interface PresenterEntry {
 
 interface FrondLike {
   name: string;
-  entities: EntityEntry[];
   handlers: HandlerEntry[];
   presenters: PresenterEntry[];
   surfaces?: Record<string, string[]>;
@@ -58,10 +52,10 @@ interface FrondLike {
 
 interface AppLike {
   fronds: FrondLike[];
-  /** The façade an entity exposes to one audience — `undefined` when none. */
-  facadeFor(entity: string, surface?: string): Record<string, Function> | undefined;
+  /** The façade an address serves to one audience — `undefined` when none. */
+  facadeFor(address: string, surface?: string): Record<string, Function> | undefined;
   /** Canonical operation table produced by core. */
-  operationsFor(entity: string, surface?: string): Map<string, OperationMeta> | undefined;
+  operationsFor(address: string, surface?: string): Map<string, OperationMeta> | undefined;
 }
 
 type HandlerFacade = Record<string, Function>;
@@ -97,9 +91,9 @@ function deriveMethod(
   return 'POST';
 }
 
-/** Derive route path from entity name + operation name. */
-function derivePath(entityName: string, opName: string): string {
-  const base = `/${pluralize(entityName)}`;
+/** Derive route path from the address + operation name. */
+function derivePath(address: string, opName: string): string {
+  const base = `/${pluralize(address)}`;
 
   // Standard CRUD
   if (opName === 'list') return base;
@@ -124,66 +118,62 @@ function derivePath(entityName: string, opName: string): string {
 
 // ─── Public API ─────────────────────────────────
 
-/** Generate REST route definitions from a fougere App. */
+/** Generate REST route definitions from a fougere App — one route per operation, per address served. */
 export function generateRoutes(app: AppLike, options: GenerateRoutesOptions = {}): RouteDefinition[] {
   return app.fronds.flatMap((frond) =>
-    frond.entities.flatMap((entity) => routesOf(app, frond, entity, options)));
+    [...new Set(frond.handlers.map((handler) => handler.address))]
+      .flatMap((address) => routesOf(app, frond, address, options)));
 }
 
-/** What one entity answers on REST — nothing, when this surface does not serve it. */
+/** What one address answers on REST — nothing, when this surface does not serve it. */
 function routesOf(
   app: AppLike,
   frond: FrondLike,
-  entity: EntityEntry,
+  address: string,
   options: GenerateRoutesOptions,
 ): RouteDefinition[] {
   const surface = options.surface;
   // Membership is core's answer, not ours — one rule, read here (see App.facadeFor).
-  const facade = app.facadeFor(entity.name, surface) as HandlerFacade | undefined;
+  const facade = app.facadeFor(address, surface) as HandlerFacade | undefined;
   if (!facade) return [];
-  if (options.filter && !options.filter(entity, frond.name)) return [];
-  if (!surface && entity.exposed === false) return [];
+  if (options.filter && !options.filter(address, frond.name)) return [];
+
+  const handler = (surface
+    ? frond.handlers.find((one) => one.address === address && one.surface === surface)
+    : undefined) ?? frond.handlers.find((one) => !one.surface && one.address === address);
+  if (!surface && handler?.exposed === false) return [];
 
-  const effectiveOperations = app.operationsFor(entity.name, surface);
+  const effectiveOperations = app.operationsFor(address, surface);
   if (!effectiveOperations) {
-    throw new Error(`REST cannot project '${entity.name}' without its EffectiveOperation table.`);
+    throw new Error(`REST cannot project '${address}' without its EffectiveOperation table.`);
   }
 
-  const handler = (surface
-    ? frond.handlers.find((one) => one.address === entity.name && one.surface === surface)
-    : undefined) ?? frond.handlers.find((one) => !one.surface && one.address === entity.name);
-  // The handler's output schema if declared, otherwise the entity. A frond whose class never
-  // crossed the wire arrives as one too: boot rebuilds the card before here.
-  const outputSchema: SchemaView = handler?.outputOverride ?? handler?.ctor?.__output ?? entity.entityClass;
-
   // The resolved table defines the public operation set. This also works for remote proxy
   // facades, which intentionally cannot enumerate their keys before discovery.
   return [...effectiveOperations.keys()].map((opName) => routeFor({
-    entity,
+    address,
     frond,
     facade,
-    fields: outputSchema.getFields(),
     opName,
     meta: effectiveOperations.get(opName),
     options,
   }));
 }
 
-/** One operation of one entity, and everything that decides how it is addressed. */
+/** One operation at one address, and everything that decides how it is addressed. */
 interface Projecting {
-  entity: EntityEntry;
+  address: string;
   frond: FrondLike;
   facade: HandlerFacade;
-  fields: Fields;
   opName: string;
   meta: OperationMeta | undefined;
   options: GenerateRoutesOptions;
 }
 
-function routeFor({ entity, frond, facade, fields, opName, meta, options }: Projecting): RouteDefinition {
+function routeFor({ address, frond, facade, opName, meta, options }: Projecting): RouteDefinition {
   if (!meta) {
     throw new Error(
-      `REST facade '${entity.name}' exposes '${opName}' but its EffectiveOperation table does not.`,
+      `REST facade '${address}' exposes '${opName}' but its EffectiveOperation table does not.`,
     );
   }
 
@@ -192,7 +182,7 @@ function routeFor({ entity, frond, facade, fields, opName, meta, options }: Proj
   // which is what `overrides:` is for and why it wins.
   const stated = frond.operationsOverrides?.[opName]?.rest as
     { method?: HttpMethod; path?: string; status?: number } | undefined;
-  const override = { ...stated, ...(options.overrides?.[entity.name] ?? {})[opName] } as
+  const override = { ...stated, ...(options.overrides?.[address] ?? {})[opName] } as
     { method?: HttpMethod; path?: string; status?: number };
 
   // Handler and method overrides are already executed by the facade, from the same
@@ -204,27 +194,20 @@ function routeFor({ entity, frond, facade, fields, opName, meta, options }: Proj
 
   return {
     method: override.method ?? deriveMethod(opName, meta.kind),
-    path: (options.prefix ?? '') + (override.path ?? derivePath(entity.name, opName)),
+    path: (options.prefix ?? '') + (override.path ?? derivePath(address, opName)),
     operationName: opName,
-    entityName: entity.name,
+    address,
     handler: (invocation) => op(invocation),
-    ...inputAndOutput(meta, fields, opName),
+    ...inputAndOutput(meta),
     successStatus: override.status,
     ...(meta.description && { description: meta.description }),
   };
 }
 
 /** Both pass through the client-surface projections — write-only out, read-only in. */
-function inputAndOutput(
-  meta: OperationMeta,
-  fields: Fields,
-  opName: string,
-): { inputFields: Fields | undefined; outputFields: Fields | undefined } {
-  const inputFields = meta.input?.getFields()
-    ?? (opName === 'create' || opName === 'update' ? Visibility.of(fields).input : undefined);
-
+function inputAndOutput(meta: OperationMeta): { inputFields: Fields | undefined; outputFields: Fields | undefined } {
   return {
-    inputFields,
-    outputFields: meta.output ? Visibility.of(meta.output.getFields()).output : Visibility.of(fields).output,
+    inputFields: meta.input ? Visibility.of(meta.input.getFields()).input : undefined,
+    outputFields: meta.output ? Visibility.of(meta.output.getFields()).output : undefined,
   };
 }

package/dist/routes/EntityEntry.d.ts

@@ -1,8 +0,0 @@
-import type { SchemaView } from '@fougere/schema';
-export interface EntityEntry {
-    name: string;
-    /** A live class in-process, a card from a frond whose class never crossed. */
-    entityClass: SchemaView;
-    exposed?: boolean;
-}
-//# sourceMappingURL=EntityEntry.d.ts.map

package/dist/routes/EntityEntry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EntityEntry.d.ts","sourceRoot":"","sources":["../../src/routes/EntityEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/routes/EntityEntry.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=EntityEntry.js.map

package/dist/routes/EntityEntry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EntityEntry.js","sourceRoot":"","sources":["../../src/routes/EntityEntry.ts"],"names":[],"mappings":""}

package/src/routes/EntityEntry.ts

@@ -1,8 +0,0 @@
-import type { SchemaView } from '@fougere/schema';
-
-export interface EntityEntry {
-  name: string;
-  /** A live class in-process, a card from a frond whose class never crossed. */
-  entityClass: SchemaView;
-  exposed?: boolean;
-}