@fougere/core 0.5.0-alpha.1 → 0.7.0-alpha.0

package/dist/wire/RouteAddress.d.ts

@@ -0,0 +1,24 @@
+/** Which kind of destination served a call — it travels in a `CallRecord`. */
+export type RouteKind = 'local' | 'remote' | 'system';
+export interface RouteAddressInput {
+    entity: string;
+    operation: string;
+    surface?: string;
+}
+/** Canonical identity of one callable operation. */
+export declare class RouteAddress {
+    readonly entity: string;
+    readonly operation: string;
+    readonly surface?: string;
+    /** Names one callable operation, and freezes it so a registry key cannot drift. */
+    constructor(input: RouteAddressInput);
+    /** Serializes the three segments so a route can be looked up in a `Map`. */
+    key(): string;
+    /** Compares two addresses by their key, so `surface` counts as much as the operation. */
+    equals(other: RouteAddress): boolean;
+    /** Writes the address the way a log and an error message name it. */
+    toString(): string;
+    /** Sends the address over the wire without `surface: undefined` riding along. */
+    toJSON(): RouteAddressInput;
+}
+//# sourceMappingURL=RouteAddress.d.ts.map

package/dist/wire/RouteAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteAddress.d.ts","sourceRoot":"","sources":["../../src/wire/RouteAddress.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD,oDAAoD;AACpD,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,mFAAmF;gBACvE,KAAK,EAAE,iBAAiB;IAOpC,4EAA4E;IAC5E,GAAG,IAAI,MAAM;IAIb,yFAAyF;IACzF,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAIpC,qEAAqE;IACrE,QAAQ,IAAI,MAAM;IAKlB,iFAAiF;IACjF,MAAM,IAAI,iBAAiB;CAO5B"}

package/dist/{contract → wire}/RouteAddress.js

@@ -1,8 +1,10 @@
+/** Refuses an empty segment, so no address can be built that nothing can serve. */
 function required(value, name) {
     if (value.trim().length === 0)
         throw new TypeError(`Route ${name} cannot be empty`);
     return value;
 }
+/** Applies the same refusal to a segment that may be absent, but not blank. */
 function optional(value, name) {
     return value === undefined ? undefined : required(value, name);
 }
@@ -11,22 +13,27 @@ export class RouteAddress {
     entity;
     operation;
     surface;
+    /** Names one callable operation, and freezes it so a registry key cannot drift. */
     constructor(input) {
         this.entity = required(input.entity, 'entity');
         this.operation = required(input.operation, 'operation');
         this.surface = optional(input.surface, 'surface');
         Object.freeze(this);
     }
+    /** Serializes the three segments so a route can be looked up in a `Map`. */
     key() {
         return JSON.stringify([this.surface ?? null, this.entity, this.operation]);
     }
+    /** Compares two addresses by their key, so `surface` counts as much as the operation. */
     equals(other) {
         return this.key() === other.key();
     }
+    /** Writes the address the way a log and an error message name it. */
     toString() {
         const audience = this.surface ? `${this.surface}/` : '';
         return `${audience}${this.entity}.${this.operation}`;
     }
+    /** Sends the address over the wire without `surface: undefined` riding along. */
     toJSON() {
         return {
             entity: this.entity,

package/dist/wire/RouteAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteAddress.js","sourceRoot":"","sources":["../../src/wire/RouteAddress.ts"],"names":[],"mappings":"AASA,mFAAmF;AACnF,SAAS,QAAQ,CAAC,KAAa,EAAE,IAAY;IAC3C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IACpF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,SAAS,QAAQ,CAAC,KAAyB,EAAE,IAAY;IACvD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,oDAAoD;AACpD,MAAM,OAAO,YAAY;IACd,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,OAAO,CAAU;IAE1B,mFAAmF;IACnF,YAAY,KAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,4EAA4E;IAC5E,GAAG;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,yFAAyF;IACzF,MAAM,CAAC,KAAmB;QACxB,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,KAAK,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,qEAAqE;IACrE,QAAQ;QACN,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IACvD,CAAC;IAED,iFAAiF;IACjF,MAAM;QACJ,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;IACJ,CAAC;CACF"}

package/dist/wire/binding.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Where each parameter of an operation gets its value — decided once at boot from the parsed
+ * signature, replayed per call by `resolveArgs`.
+ */
+import type { Param } from './signature.js';
+type ParamSource = {
+    kind: 'collector';
+    typeName: string;
+}
+/** `Fact<PostPublished>` — something that happened, not something a caller typed. */
+ | {
+    kind: 'fact';
+    factName: string;
+} | {
+    kind: 'param';
+    name: string;
+    coerce?: 'number' | 'boolean';
+} | {
+    kind: 'input';
+} | {
+    kind: 'context';
+}
+/** The whole query bag, for an op whose argument IS the options (list). */
+ | {
+    kind: 'query';
+};
+interface ParamBinding {
+    name: string;
+    source: ParamSource;
+    optional: boolean;
+}
+export type BindingPlan = ParamBinding[];
+/** Build a BindingPlan from parsed method params. */
+export declare function computeBindingPlan(params: Param[], collectorTypeNames: Set<string>): BindingPlan;
+export {};
+//# sourceMappingURL=binding.d.ts.map

package/dist/wire/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/wire/binding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAK5C,KAAK,WAAW,GACZ;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACzC,qFAAqF;GACnF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;AACrB,2EAA2E;GACzE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC;AAczC,qDAAqD;AACrD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,EAAE,EACf,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,WAAW,CA0Db"}

package/dist/{boot → wire}/binding.js

@@ -9,21 +9,16 @@ function coercionFor(typeName) {
     return undefined;
 }
 // ── Compute ───────────────────────────────────
-/**
- * Build a BindingPlan from parsed method params.
- *
- * @param params - Parsed parameter list from AST
- * @param collectorTypeNames - Registration keys of the types a Collector answers for
- */
+/** Build a BindingPlan from parsed method params. */
 export function computeBindingPlan(params, collectorTypeNames) {
     return params.map((param) => {
         const typeName = param.type.name;
         // `lowerFirst`, never `toLowerCase()`: the collector set is keyed the way the
         // scan spells it, and the two agree on one word only — `AuthorUser` looked up as
-        // `authoruser` missed `authorUser` and fell through to branch 4, the request body.
+        // `authoruser` missed `authorUser` and fell through to branch 4, the request input.
         const typeKey = lowerFirst(typeName);
         // 0. Fact — `Fact<X>` names itself, so nothing has to be known in advance. It comes
-        //    FIRST because branch 4 would otherwise hand it the caller's body under the name
+        //    FIRST because branch 4 would otherwise hand it the caller's input under the name
         //    of something that happened.
         const factOf = param.type.name === 'Fact' ? param.type.generics?.[0]?.name : undefined;
         if (factOf) {
@@ -61,64 +56,12 @@ export function computeBindingPlan(params, collectorTypeNames) {
                 optional: param.optional ?? false,
             };
         }
-        // 4. Everything else — body
+        // 4. Everything else — input
         return {
             name: param.name,
-            source: { kind: 'body' },
+            source: { kind: 'input' },
             optional: param.optional ?? false,
         };
     });
 }
-/**
- * Resolve handler arguments from a BindingPlan + InvocationContext.
- */
-export async function resolveArgs(plan, ctx, resolveCollector) {
-    const args = [];
-    for (const binding of plan) {
-        switch (binding.source.kind) {
-            case 'collector': {
-                const collector = resolveCollector?.(binding.source.typeName);
-                args.push(collector ? await collector.collect(ctx) : undefined);
-                break;
-            }
-            case 'context': {
-                args.push(ctx);
-                break;
-            }
-            case 'param': {
-                // `null` is a value, not a miss. Nullish coalescing used to make an explicit
-                // nullable path/GraphQL argument fall through to query (or become undefined),
-                // collapsing `T | null` into `T | undefined`. Only undefined means absent.
-                const fromParams = ctx.params[binding.source.name];
-                let val = fromParams === undefined
-                    ? ctx.query[binding.source.name]
-                    : fromParams;
-                if (val != null && binding.source.coerce === 'number')
-                    val = Number(val);
-                if (val != null && binding.source.coerce === 'boolean')
-                    val = val === 'true' || val === '1' || val === true;
-                args.push(val);
-                break;
-            }
-            case 'fact': {
-                // A fact IS the payload — the whole of what happened, never a piece of it.
-                // Identical to `body` today, and deliberately not sharing its branch: the two
-                // agree by coincidence, not by rule, and the day `body` learns to look up a
-                // value by parameter name a subscriber would receive ONE FIELD of the fact it
-                // subscribed to. Splitting it costs nothing and removes that trap.
-                args.push(ctx.body);
-                break;
-            }
-            case 'body': {
-                args.push(ctx.body);
-                break;
-            }
-            case 'query': {
-                args.push(ctx.query);
-                break;
-            }
-        }
-    }
-    return args;
-}
 //# sourceMappingURL=binding.js.map

package/dist/wire/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/wire/binding.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAsB7C,iDAAiD;AAEjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAE5D,SAAS,WAAW,CAAC,QAAgB;IACnC,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,iDAAiD;AAEjD,qDAAqD;AACrD,MAAM,UAAU,kBAAkB,CAChC,MAAe,EACf,kBAA+B;IAE/B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,8EAA8E;QAC9E,iFAAiF;QACjF,oFAAoF;QACpF,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAErC,oFAAoF;QACpF,sFAAsF;QACtF,iCAAiC;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE;gBAC/D,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;aAClC,CAAC;QACJ,CAAC;QAED,sEAAsE;QACtE,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,EAAE,IAAI,EAAE,WAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACzD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;aAClC,CAAC;QACJ,CAAC;QAED,iDAAiD;QACjD,IAAI,QAAQ,KAAK,mBAAmB,EAAE,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;gBACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;aAClC,CAAC;QACJ,CAAC;QAED,sDAAsD;QACtD,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE;oBACN,IAAI,EAAE,OAAgB;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;iBAC9B;gBACD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;aAClC,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,EAAE,IAAI,EAAE,OAAgB,EAAE;YAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;SAClC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/wire/call.d.ts

@@ -1,14 +1,13 @@
-/**
- * Call contract — a frond call is a value.
- *
- * (frond, entity, op, invocation) → result, or a thrown FougereError.
- * A transport is a function that executes this call elsewhere; the local
- * runner below is the reference realization. Transports move the value,
- * they never reshape it.
- */
+/** Call contract — a frond call is a value. */
 import { type SchemaDescriptor } from '@fougere/schema';
-import type { InvocationContext } from '../contract/Invocation.js';
-import type { App } from '../boot/types.js';
+import { Invocation, type InvocationContext, type PartialInvocation } from './Invocation.js';
+import type { RouteAddress } from './RouteAddress.js';
+/** One normalized request, frozen: where it goes and what the caller supplied. */
+export declare class Call {
+    readonly address: RouteAddress;
+    readonly invocation: Invocation;
+    constructor(address: RouteAddress, invocation?: PartialInvocation);
+}
 /** Target of a call — which façade operation, wherever it lives. */
 export interface FrondCall {
     /** Frond name, when the caller knows it. Routing hint only. */
@@ -21,45 +20,23 @@ export interface FrondCall {
 /** A transport executes a call somewhere else. Failures surface as thrown FougereError. */
 export type Transport = (call: FrondCall, invocation: InvocationContext) => Promise<unknown>;
 /** Reserved namespace — calls the runner answers itself, never a façade. */
-/**
- * What a receiver accepts before it stops reading a body.
- *
- * Stated once because it was stated FOUR times — `transport/http/policy.ts` said so in its
- * own comment ("spelled in four packages") while three doors kept their own literal, so
- * raising the cap here used to leave three of them refusing at the old one.
- *
- * `@fougere/http` keeps a fourth copy on purpose: it declares no Fougere dependency at all,
- * and giving a leaf port a dependency on the kernel to share a number is the wrong trade.
- */
+/** What a receiver accepts before it stops reading an input. */
 export declare const MAX_BODY_BYTES: number;
 export declare const RPC_ENTITY = "rpc";
-/**
- * What an `rpc` op answers — the door for what the app says about ITSELF, never about a row.
- *
- * `discover` is core's own, registered like any other (`bootstrap.ts`): a package declares
- * its reading beside it, and an app that installed none serves none.
- */
+/** What an `rpc` op answers — the door for what the app says about ITSELF, never about a row. */
 export type RpcAnswer = (invocation: InvocationContext, surface?: string) => unknown;
-/**
- * Everything a caller's envelope covers — the call as the sender meant it.
- *
- * Here and not beside the signing code because it is a CONTRACT: the sender binds it,
- * the receiver re-presents what arrived, and a frond written in another language reads
- * this shape without reading our crypto. `body` is bound by digest (arbitrary, possibly
- * large), the rest by value — which is what keeps a canonical-JSON dependency out.
- */
+/** Everything a caller's envelope covers — the call as the sender meant it. */
 export interface SignedCall {
     entity: string;
     op: string;
     params?: Record<string, unknown>;
     query?: Record<string, unknown>;
-    body?: unknown;
+    input?: unknown;
     state?: Record<string, unknown>;
 }
 /**
- * One operation, as a stranger meets it — its name, what it is for, what it takes
- * and whether it reads or writes. Everything here already existed on the contract;
- * it just never left the process.
+ * One operation, as a stranger meets it — its name, what it is for, what it takes and whether it
+ * reads or writes.
  */
 export interface CardOp {
     name: string;
@@ -71,56 +48,20 @@ export interface CardOp {
     output?: SchemaDescriptor;
     /** `query` reads, `command` writes — the same call REST turns into GET vs POST. */
     kind: 'query' | 'command';
-    /**
-     * How much `output` describes: one row, maybe one, many, a page, or nothing shaped.
-     * `output` alone is the shape of a ROW, so a consumer generating a signature from
-     * this card would otherwise have to guess — and `list` returning a page rather than
-     * an array is exactly the guess it would get wrong.
-     */
+    /** How much `output` describes. */
     cardinality?: 'one' | 'maybe' | 'many' | 'page' | 'none';
 }
-/**
- * What an app hosts — the wire projection of its scanned fronds.
- *
- * Two lists per frond, and they are duals: **what you may call**, and **what you will
- * receive**. A door is entered from outside; a fact leaves on its own.
- *
- * `doors` was called `entities` and the name lied: an entry is an ADDRESS, and the shape
- * behind it is optional (`facadeKeyOf` builds its key from a handler's name, which need not
- * be an entity's). The lie cost something real — `fougere sync` demanded a descriptor on
- * every entry and refused whole cards over a health check.
- */
+/** What an app hosts — the wire projection of its scanned fronds. */
 export interface IdentityCard {
     fronds: {
         name: string;
         doors: {
             name: string;
             ops: CardOp[];
-            /**
-             * The shape stored under this name — **absent when nothing is**. A handler may
-             * carry no entity (`bootstrap`: *pointing at nothing is legal*), and a door with
-             * no rows behind it is ordinary: a health check, a computation, a search across
-             * several shapes. A reader that needs the shape must say what it does without one.
-             */
+            /** The shape stored under this name — **absent when nothing is**. */
             schema?: SchemaDescriptor;
         }[];
-        /**
-         * The facts this frond ANNOUNCES — one entry per `Emit<T>` its handlers inject.
-         *
-         * They carry no operation, which is why they cannot ride in `doors`: the rule there is
-         * *hosting means answering*, and an entity with no façade is excluded on purpose (it
-         * would publish the auth tables to anyone who asks). A fact is the opposite case —
-         * someone WROTE that it leaves, so publishing its shape is honouring a statement, not
-         * leaking one.
-         *
-         * Without this, a fact stopped at the repository boundary: `remotes:` gives the
-         * location, colocation gives the contract, and across two repositories there is no
-         * colocation. The subscriber had to hand-copy the emitter's declaration.
-         *
-         * `schema` is absent when the announced type is not a declared entity — legal (nothing
-         * requires a fact to be one) and worth saying rather than hiding: the name travels, the
-         * shape does not, and a consumer can see exactly that.
-         */
+        /** The facts this frond ANNOUNCES — one entry per `Emit<T>` its handlers inject. */
         facts: {
             name: string;
             schema?: SchemaDescriptor;
@@ -141,17 +82,7 @@ export interface Edge {
     count: number;
     errors: number;
 }
-/**
- * The shape of the system as ONE process discovered it — the answer to `rpc.topology`.
- *
- * Here and not in the package that produces it, for the reason `SignedCall` is here: it
- * crosses a process boundary, so a reader consumes it without depending on the producer.
- * `@fougere/observability` fills it; a panel reads it; neither imports the other.
- *
- * Nothing in it is declared — a frond is `local` because this process scanned it, `remote`
- * because it answered a call nobody here hosts. `remotes:` states an intent, and the two
- * disagree exactly when something is misconfigured.
- */
+/** The shape of the system as ONE process discovered it — the answer to `rpc.topology`. */
 export interface TopologyReport {
     /** When this process started counting — an edge count is read against it. */
     since: number;
@@ -160,93 +91,15 @@ export interface TopologyReport {
     fronds: FrondPlacement[];
     edges: Edge[];
 }
-/**
- * The shape a card must have to be walked — `fronds`, and each frond's `doors`.
- *
- * A card crosses a process boundary, so it is judged like anything else that does.
- * The check lives beside the type because two readers walk it: the boot indexes a
- * remote's doors, and `fougere sync` writes classes from them. `TypeError:
- * card.fronds is not iterable` was what a malformed card produced at the boot,
- * naming neither the remote nor the address.
- *
- * The descriptor behind a door is NOT checked here — `Card.toSchema` refuses it, and
- * only where one is consumed.
- */
+/** The shape a card must have to be walked — `fronds`, and each frond's `doors`. */
 export declare function assertIdentityCard(value: unknown, source: string): IdentityCard;
-/**
- * The door built in front of a handler — the framework's second port, after `EntityOrm`.
- *
- * `Facade<PostHandler>` is what a neighbouring frond injects. It names what ARRIVES
- * rather than what is written: never the handler (nobody injects it, and its methods take
- * positional arguments), but the door, whose every op takes the invocation and whose
- * implementation is the local façade or a doublure. A signature therefore says nothing
- * about where the other frond runs, which is the whole point.
- *
- * `keyof T` is the right set by construction, not by approximation: the scan skips
- * `private` and `protected` (`handler-parser.ts`) because "TypeScript already has the
- * word for it", so a handler's public methods ARE its operations — and `keyof` excludes
- * the rest for the same reason.
- */
+/** A façade as the runtime holds it: op names to functions, nothing typed about them. */
+/** The door built in front of a handler — the framework's second port, after `Storage`. */
 export type Facade<T> = {
     [K in keyof T]: T[K] extends (...args: never[]) => infer R ? (invocation?: InvocationContext) => R : never;
 };
-/**
- * The container key of a façade — THE one place that spells the format.
- *
- * A surface is a named audience, and it is a key: `handlers/public/PostHandler.ts`
- * registers `public:postHandler` next to the default `postHandler`. The default
- * surface is the empty key, so callers that know nothing about surfaces keep
- * designating exactly what they designated before.
- *
- * Nobody outside this package builds this string: adapters ask `app.facadeFor()`,
- * which is why an adapter can stay structurally typed and core-free.
- */
+/** The container key of a façade — THE one place that spells the format. */
 export declare function facadeKeyOf(entityName: string, surface?: string): string;
-/**
- * Where the contracts behind a façade live — the dual of `facadeKeyOf`.
- *
- * The façade answers calls; it does not say what it answers. That sentence used
- * to be true only inside `buildFacade`, so anything asking the app what it hosts
- * got bare names. A door and its terms are registered together, under the same
- * audience.
- */
+/** Where the contracts behind a façade live — the dual of `facadeKeyOf`. */
 export declare function contractsKeyOf(entityName: string, surface?: string): string;
-/**
- * Serialize what the app hosts, for one audience. Served on `rpc.discover`,
- * cached by callers.
- *
- * Hosting means answering: an entity with no façade declares no operation, so
- * it is not among the DOORS — publishing its shape would hand an anonymous caller
- * the structure of tables it can never reach (the auth tables, typically), and
- * `fougere sync` would rebuild a schema with nothing to call on it.
- *
- * `facts` is the one thing that shape-without-a-door rule does not cover, and the
- * reason is the opposite of a leak: an entity nobody exposed is silent, whereas a
- * fact was explicitly declared to leave.
- *
- * `surface` makes that sentence audience-aware rather than app-wide: a door
- * answers with what IT serves. Nothing falls back to the full façade — under a
- * named surface, an entity with no façade of its own is simply not there.
- */
-export declare function identityCardOf(app: App, surface?: string): IdentityCard;
-/**
- * Build the local runner — the reference realization of Transport.
- *
- * Resolves strictly from the app's own container: a call that lands here is
- * judged here. A miss is a typed NOT_FOUND, never a forward to another remote.
- */
-export declare function createLocalRunner(app: App, surface?: string): Transport;
-/**
- * Build the app runner — same judgment, but resolution follows the app's
- * topology: local façades and remote doublures alike. This is the runner
- * an app's own entry points (browser endpoint, bridges) stand on.
- *
- * `surface` is the audience this runner serves, and it belongs to the DOOR that
- * builds the runner, never to the call: a caller cannot name its own audience
- * any more than it can name its own identity (`state` is stamped server-side
- * for the same reason). Reaching the admin door IS the proof. So `FrondCall`
- * gains nothing and the wire format gains nothing — a remote frond's audience
- * is simply which URL `remotes:` points at.
- */
-export declare function createAppRunner(app: App, surface?: string): Transport;
 //# sourceMappingURL=call.d.ts.map

package/dist/wire/call.d.ts.map

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