@fougere/core 0.6.0-alpha.0 → 0.8.0-alpha.0

package/dist/entry/TransportEntry.js

@@ -1,24 +0,0 @@
-import { Call } from '../contract/Call.js';
-import { RouteAddress } from '../contract/RouteAddress.js';
-/** Object entry for the historical transport contract. */
-export class TransportEntry {
-    dispatcher;
-    surface;
-    constructor(dispatcher, surface) {
-        this.dispatcher = dispatcher;
-        this.surface = surface;
-    }
-    receive(legacy, invocation) {
-        return this.dispatcher.dispatch(new Call(new RouteAddress({
-            entity: legacy.entity,
-            operation: legacy.op,
-            ...(this.surface !== undefined ? { surface: this.surface } : {}),
-        }), invocation));
-    }
-}
-/** Adapt the historical transport signature to the canonical dispatch port. */
-export function createTransportEntry(dispatcher, surface) {
-    const entry = new TransportEntry(dispatcher, surface);
-    return entry.receive.bind(entry);
-}
-//# sourceMappingURL=TransportEntry.js.map

package/dist/entry/TransportEntry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TransportEntry.js","sourceRoot":"","sources":["../../src/entry/TransportEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAK3D,0DAA0D;AAC1D,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,UAAwB,EACxB,OAAgB;QADhB,eAAU,GAAV,UAAU,CAAc;QACxB,YAAO,GAAP,OAAO,CAAS;IAChC,CAAC;IAEJ,OAAO,CAAC,MAAiB,EAAE,UAA6B;QACtD,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CACtC,IAAI,YAAY,CAAC;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC,EACF,UAAU,CACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAAC,UAAwB,EAAE,OAAgB;IAC7E,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/dist/rows.d.ts

@@ -1,40 +0,0 @@
-/**
- * The thirteen gestures of {@link Storage}, derived from four.
- *
- * A place rows live varies in ONE thing — how a row is fetched, written, dropped and
- * enumerated. Everything above that is the same everywhere: what a page is, how a criterion
- * matches, which stamps survive an upsert, and the two refusals a `create` owes its caller.
- * Measured on the Map realization: 14 lines of 140 touched the store.
- *
- * So an adapter supplies {@link Rows} and receives a whole `StorageFactory`. It is the frame
- * a third party writing a source needs — without it, `Sources.register` hands over a
- * four-gesture contract and leaves the thirteen to be re-derived, which is how three
- * divergent copies of the same store ended up in this repo's own demos.
- *
- * What is NOT here: `transacted`. A unit of work belongs to the engine that has one, and
- * this frame has none — which is why a `Source` built on it leaves the key absent and a
- * frame compensates.
- */
-import { type SchemaView } from '@fougere/schema';
-import type { StorageFactory } from './storage.js';
-/** One row, as every realization hands it over. */
-export type Row = Record<string, unknown>;
-/**
- * A keyed collection of rows — what an adapter supplies, and all of it.
- *
- * Async on purpose, even where a realization is not: a Map answers instantly and a directory
- * does not, and the frame above cannot be written twice. `client` is what the port's own
- * escape hatch exposes, `unknown` for the reason it is there.
- */
-export interface Rows {
-    get(key: string): Promise<Row | undefined>;
-    has(key: string): Promise<boolean>;
-    set(key: string, row: Row): Promise<void>;
-    delete(key: string): Promise<boolean>;
-    /** Every row it holds. A realization that cannot answer this cheaply says so in its doc. */
-    all(): Promise<Row[]>;
-    /** Handed on as `Storage.client` — the Map, the directory, whatever it is. */
-    readonly client: unknown;
-}
-export declare function storageOver(open: (entity: SchemaView, name: string) => Rows): StorageFactory;
-//# sourceMappingURL=rows.d.ts.map

package/dist/rows.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../src/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D,mDAAmD;AACnD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,4FAA4F;IAC5F,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,cAAc,CAiH5F"}

package/dist/rows.js

@@ -1,146 +0,0 @@
-/**
- * The thirteen gestures of {@link Storage}, derived from four.
- *
- * A place rows live varies in ONE thing — how a row is fetched, written, dropped and
- * enumerated. Everything above that is the same everywhere: what a page is, how a criterion
- * matches, which stamps survive an upsert, and the two refusals a `create` owes its caller.
- * Measured on the Map realization: 14 lines of 140 touched the store.
- *
- * So an adapter supplies {@link Rows} and receives a whole `StorageFactory`. It is the frame
- * a third party writing a source needs — without it, `Sources.register` hands over a
- * four-gesture contract and leaves the thirteen to be re-derived, which is how three
- * divergent copies of the same store ended up in this repo's own demos.
- *
- * What is NOT here: `transacted`. A unit of work belongs to the engine that has one, and
- * this frame has none — which is why a `Source` built on it leaves the key absent and a
- * frame compensates.
- */
-import { applyCreate, applyUpdate, Lifecycle, Role } from '@fougere/schema';
-export function storageOver(open) {
-    return (entity, name) => {
-        const fields = entity.getFields();
-        const rows = open(entity, name);
-        const pk = Object.entries(fields).find(([, field]) => Role.of(field).isPrimary)?.[0] ?? 'id';
-        // `Storage.findById(id: string)` — but a key can hold a number, and a Map keyed on
-        // `1` does not answer `'1'`. SQL never had the question; here the divergence was
-        // silent and only on this storage.
-        const keyOf = (value) => String(value);
-        // Same contract as SQL: a criterion may name a SET, and an empty set matches nothing.
-        const matches = (row, criteria) => Object.entries(criteria).every(([key, value]) => Array.isArray(value)
-            ? value.some((v) => Object.is(row[key], v))
-            : Object.is(row[key], value));
-        return {
-            client: rows.client,
-            async list(options) {
-                let items = await rows.all();
-                if (options?.where)
-                    items = items.filter((row) => matches(row, options.where));
-                // Held before the page is cut, and after the filter: `total` answers "how many
-                // match", which is what a paginator divides. Reading `store.size` at the end
-                // answered a different question — every row the store holds, including the ones
-                // the filter exists to keep out of this caller's sight.
-                const matching = items.length;
-                const limit = options?.limit;
-                const offset = options?.page && limit ? (options.page - 1) * limit : options?.offset ?? 0;
-                if (offset > 0)
-                    items = items.slice(offset);
-                const hasMore = limit ? items.length > limit : false;
-                if (limit)
-                    items = items.slice(0, limit);
-                const result = items;
-                result.hasMore = hasMore;
-                result.endCursor = items.length > 0 ? String(items[items.length - 1][pk] ?? '') : undefined;
-                if (options?.count)
-                    result.total = matching;
-                return result;
-            },
-            async findById(id) { return await rows.get(keyOf(id)); },
-            async findBy(criteria) {
-                return (await rows.all()).find((row) => matches(row, criteria));
-            },
-            async findAllBy(criteria) {
-                return (await rows.all()).filter((row) => matches(row, criteria));
-            },
-            // Same contract as SQL: a map keyed by the primary key, a miss being an absent key.
-            async findByKeys(ids) {
-                const found = new Map();
-                for (const id of ids) {
-                    const row = await rows.get(keyOf(id));
-                    if (row)
-                        found.set(String(id), row);
-                }
-                return found;
-            },
-            // The dual, same contract as SQL: grouped by the value read off the ROW.
-            async findAllByKeys(field, keys) {
-                const grouped = new Map();
-                if (keys.length === 0)
-                    return grouped;
-                const wanted = new Set(keys.map(String));
-                for (const row of await rows.all()) {
-                    const key = String(row[field]);
-                    if (!wanted.has(key))
-                        continue;
-                    const held = grouped.get(key);
-                    if (held)
-                        held.push(row);
-                    else
-                        grouped.set(key, [row]);
-                }
-                return grouped;
-            },
-            // Same contract as SQL: the key and the creation stamps survive an overwrite.
-            async upsert(input) {
-                const record = applyCreate(fields, applyUpdate(fields, input));
-                const id = record[pk];
-                if (id === undefined)
-                    throw new Error(`${name}.upsert(): no \`${pk}\` — an upsert needs the key it writes at.`);
-                const held = await rows.get(keyOf(id));
-                if (held) {
-                    for (const [key, field] of Object.entries(fields)) {
-                        if (key === pk || Lifecycle.of(field).stampedOnce)
-                            record[key] = held[key];
-                    }
-                }
-                await rows.set(keyOf(id), record);
-                return record;
-            },
-            async upsertAll(inputs) {
-                for (const input of inputs)
-                    await this.upsert(input);
-                return inputs.length;
-            },
-            async create(input) {
-                const record = applyCreate(fields, input);
-                const id = record[pk];
-                // `primary(text())` declares no generator, so nothing fills the hole and the
-                // caller has to. Keying on `undefined` would let the second create overwrite the
-                // first, in silence — the old version hid this by inventing an `id` field the
-                // entity never declared.
-                if (id === undefined) {
-                    throw new Error(`${name}.create: '${pk}' is the primary key and nothing supplied it — this entity declares no generator for it.`);
-                }
-                // A create is not an upsert. `Map.set` overwrites, so a second create under the
-                // same key answered "created" while destroying the previous row — SQL answers a
-                // constraint violation, and a store that loses data silently is worse than one
-                // that fails.
-                if (await rows.has(keyOf(id))) {
-                    throw new Error(`${name}.create: '${pk}' ${JSON.stringify(id)} already exists.`);
-                }
-                await rows.set(keyOf(id), record);
-                return record;
-            },
-            async update(id, input) {
-                const existing = await rows.get(keyOf(id));
-                if (!existing)
-                    throw new Error(`Not found: ${id}`);
-                const updated = { ...existing, ...applyUpdate(fields, input), [pk]: existing[pk] };
-                await rows.set(keyOf(id), updated);
-                return updated;
-            },
-            async delete(id) { return await rows.delete(keyOf(id)); },
-            output(_schema) { return this; },
-        };
-    };
-}
-//# sourceMappingURL=rows.js.map

package/dist/rows.js.map

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

package/src/boot/HandlerFacade.ts

@@ -1,242 +0,0 @@
-import { lowerFirst, type Fields } from '@fougere/schema';
-import type { Container } from '@fougere/container';
-import type { AppMiddleware } from '../wire/middleware.js';
-import type { CollectorResolver } from '../dispatch/ArgumentResolver.js';
-import { collectorKeyOf } from '../prefab/collector.js';
-import { presenterKeyOf } from '../prefab/presenter.js';
-import { repositoryKeyOf } from '../prefab/repository.js';
-import { targetOf } from '../prefab/prefab.js';
-import type { OperationContract, OperationsMap } from '../wire/operation.js';
-import type { EffectiveOperation, EffectiveOperationsMap } from '../effective-operation.js';
-import type { InvocationContext } from '../contract/Invocation.js';
-import type { Emissions } from './Emissions.js';
-import type { Logger } from '../builtins/logger.js';
-import type { EntityEntry, HandlerEntry, PresenterEntry } from '../descriptor/frond.js';
-import { InputValidator } from '../dispatch/InputValidator.js';
-import { ArgumentResolver } from '../dispatch/ArgumentResolver.js';
-import { OperationExecutor } from '../dispatch/OperationExecutor.js';
-import { OutputProjector } from '../dispatch/OutputProjector.js';
-import { OutputView } from '../dispatch/OutputView.js';
-import { PresenterExecutor } from '../dispatch/PresenterExecutor.js';
-import { PresenterArgumentResolver } from '../dispatch/PresenterArgumentResolver.js';
-
-/** What this door is about: a handler, the entity behind it when there is one, and where it resolves. */
-export interface Doorway {
-  handler: HandlerEntry;
-  /** Handlers in the owning frond, used to realize a resolved implementation override. */
-  handlers: readonly HandlerEntry[];
-  /** The canonical operation table resolved before boot performs any side effect. */
-  operations: EffectiveOperationsMap;
-  /** The subject — absent is ordinary: a health check owns no row. */
-  entity: EntityEntry | undefined;
-  /** The scope the handler and its collectors resolve in — a surface gets its own. */
-  scope: Container;
-  /** The container key this door answers under. */
-  key: string;
-}
-
-/** What the frond and the boot supply to every door alike. */
-export interface Wiring {
-  /** The frond this door belongs to — travels on every OperationContext. */
-  frond: string;
-  /** The frond's own scope — where presenters live, whatever sub-scope the door uses. */
-  frondScope: Container;
-  log: Logger;
-  /** Entity names this frond has a collector for. */
-  collectors: Set<string>;
-  presenters: Map<string, PresenterEntry>;
-  /** The middlewares that apply to an address, read at call time and never at boot. */
-  middlewaresFor: (address: string) => AppMiddleware[];
-  emissions: Emissions;
-}
-
-/** Adapts one handler door to executable operations. */
-export class HandlerFacade {
-  /** Rich operation facts shared with check, explain and adapters. */
-  readonly effectiveOperations: EffectiveOperationsMap;
-  /** Contracts served by this door. */
-  readonly contracts: OperationsMap;
-
-  /** The callable surface: op name → the function a caller reaches. */
-  readonly ops: Record<string, Function> = {};
-
-  private readonly cachedViews = new Map<string, OutputView>();
-  private instance: any;
-  private readonly implementationKeys = new Map<string, string>();
-  private readonly implementationInstances = new Map<string, any>();
-  private readonly inputValidator = new InputValidator();
-  private readonly argumentResolver = new ArgumentResolver(
-    (typeName) => this.collectorResolver(typeName),
-  );
-  private readonly presenterArguments: PresenterArgumentResolver;
-
-  constructor(private readonly door: Doorway, private readonly wiring: Wiring) {
-    const { handler, entity } = door;
-    this.presenterArguments = new PresenterArgumentResolver(
-      this.argumentResolver,
-      wiring.collectors,
-    );
-    this.refuseCrudWithoutRepository(handler);
-
-    door.scope.register(this.handlerKey, handler.ctor, { deps: this.depsOf(handler) });
-
-    this.effectiveOperations = door.operations;
-    this.contracts = new Map(
-      [...door.operations].map(([name, operation]) => [name, operation as OperationContract] as const),
-    );
-    handler.operations = this.contracts;
-
-    // Register model-selected implementations in the same execution scope.
-    for (const [name, operation] of door.operations) {
-      if (this.isBaseImplementation(operation)) continue;
-      const implementation = this.implementationHandler(name);
-      this.refuseCrudWithoutRepository(implementation);
-      const key = `${this.handlerKey}:implementation:${operation.implementation.className}`;
-      if (!this.implementationKeys.has(operation.implementation.className)) {
-        door.scope.register(key, implementation.ctor, { deps: this.depsOf(implementation) });
-        this.implementationKeys.set(operation.implementation.className, key);
-      }
-    }
-
-    // Emissions use the same contracts and execution path as direct calls.
-    wiring.emissions.note(this.contracts, door.key);
-    // Only declared operations become callable façade members.
-    for (const op of this.contracts.keys()) this.ops[op] = this.wrap(op);
-
-    if (this.inheritsCrud(handler) && !entity) {
-      // An installed Crud subject may be absent from the local scan.
-      wiring.log.debug(`${handler.ctor.name} extends Crud() and no scanned entity is named `
-        + `'${this.subjectOf(handler)}' — installed entity, or a missing one: no storage will be injected`);
-    }
-  }
-
-  /** Storage follows the Crud subject, which may differ from the door address. */
-  private subjectOf(handler: HandlerEntry): string {
-    const target = targetOf(handler.ctor);
-    return target?.name ? lowerFirst(target.name) : handler.address;
-  }
-
-  private inheritsCrud(handler: HandlerEntry): boolean {
-    const proto = handler.ctor.prototype;
-    return typeof proto?.list === 'function' && typeof proto?.findById === 'function';
-  }
-
-  private get handlerKey(): string {
-    return `_handler:${this.door.key}`;
-  }
-
-  private depsOf(handler: HandlerEntry): string[] {
-    const { deps } = handler;
-    if (deps.length > 0) return deps;
-    return this.inheritsCrud(handler) ? [repositoryKeyOf(this.subjectOf(handler))] : [];
-  }
-
-  /** A custom Crud constructor must explicitly receive its repository. */
-  private refuseCrudWithoutRepository(handler: HandlerEntry): void {
-    const repoTypeName = repositoryKeyOf(this.subjectOf(handler));
-    if (!this.inheritsCrud(handler) || handler.deps.length === 0 || handler.deps.includes(repoTypeName)) return;
-    throw new Error(
-      `${handler.ctor.name} extends Crud() and declares a constructor, so its storage is no ` +
-      `longer injected for it — but it does not take any.\n` +
-      `  Add it and hand it to super():\n` +
-      `    constructor(repo: ${repoTypeName}, …) { super(repo); }`,
-    );
-  }
-
-  /** Resolve and cache the output view declared for one operation. */
-  private viewOf(op: string): OutputView {
-    const known = this.cachedViews.get(op);
-    if (known) return known;
-
-    const operation = this.effectiveOperations.get(op);
-    const schema = operation?.output as { getFields?: () => Fields } | undefined;
-    const resolved = new OutputView(
-      typeof schema?.getFields === 'function' ? schema.getFields() : {},
-      operation?.outputClosed ?? false,
-    );
-    this.cachedViews.set(op, resolved);
-    return resolved;
-  }
-
-  private collectorResolver = (typeName: string): CollectorResolver | undefined => {
-    try { return this.door.scope.resolve(collectorKeyOf(typeName)) as CollectorResolver; }
-    catch { return undefined; }
-  };
-
-  /** The handler itself, resolved on first call — never at boot. */
-  private resolvedHandler(): any {
-    if (!this.instance) this.instance = this.door.scope.resolve(this.handlerKey);
-    return this.instance;
-  }
-
-  private isBaseImplementation(operation: EffectiveOperation): boolean {
-    return operation.implementation.className === this.door.handler.ctor.name
-      && operation.implementation.address === this.door.handler.address
-      && operation.implementation.filePath === this.door.handler.filePath;
-  }
-
-  /** The exact handler entry the pure model selected; no name-only retry or fallback. */
-  private implementationHandler(operationName: string): HandlerEntry {
-    const operation = this.effectiveOperations.get(operationName)!;
-    const matches = this.door.handlers.filter((handler) =>
-      handler.ctor.name === operation.implementation.className
-      && handler.address === operation.implementation.address
-      && handler.filePath === operation.implementation.filePath);
-    if (matches.length !== 1) {
-      throw new Error(
-        `EffectiveOperation '${operation.id}' names ${operation.implementation.className}.`
-        + `${operation.implementation.method}, but boot found ${matches.length} matching handlers.`,
-      );
-    }
-    return matches[0]!;
-  }
-
-  private resolvedImplementation(operationName: string): { instance: any; method: string } {
-    const operation = this.effectiveOperations.get(operationName)!;
-    if (this.isBaseImplementation(operation)) {
-      return { instance: this.resolvedHandler(), method: operation.implementation.method };
-    }
-
-    const className = operation.implementation.className;
-    const key = this.implementationKeys.get(className);
-    if (!key) throw new Error(`No registered implementation for EffectiveOperation '${operation.id}'.`);
-    let instance = this.implementationInstances.get(key);
-    if (!instance) {
-      instance = this.door.scope.resolve(key);
-      this.implementationInstances.set(key, instance);
-    }
-    return { instance, method: operation.implementation.method };
-  }
-
-  private wrap(op: string): (invocation?: InvocationContext) => Promise<unknown> {
-    const address = this.door.handler.address;
-    const contract = this.contracts.get(op);
-    const view = this.viewOf(op);
-    const presenter = this.wiring.presenters.get(address);
-    const executor = new OperationExecutor({
-      entity: address,
-      frond: this.wiring.frond,
-      operation: op,
-      contract,
-      middlewares: () => this.wiring.middlewaresFor(address),
-      validator: this.inputValidator,
-      arguments: this.argumentResolver,
-      invoke: async (args) => {
-        const implementation = this.resolvedImplementation(op);
-        return implementation.instance[implementation.method](...args);
-      },
-      projector: new OutputProjector(view),
-      ...(view.closed || !presenter ? {} : {
-        present: async (result: unknown, effective: InvocationContext) =>
-          new PresenterExecutor(
-            this.wiring.frondScope.resolve(presenterKeyOf(address)),
-            presenter.fields,
-            address,
-            op,
-          ).present(result, await this.presenterArguments.resolve(presenter, effective)),
-      }),
-    });
-
-    return (invocation) => executor.execute(invocation);
-  }
-}

package/src/contract/Call.ts

@@ -1,18 +0,0 @@
-import { Invocation, type InvocationInput } from './Invocation.js';
-import type { RouteAddress } from './RouteAddress.js';
-
-/** One normalized request: where it goes and what the caller supplied. */
-export class Call {
-  readonly address: RouteAddress;
-  readonly invocation: Invocation;
-
-  constructor(address: RouteAddress, invocation?: InvocationInput) {
-    this.address = address;
-    this.invocation = Invocation.from(invocation);
-    Object.freeze(this);
-  }
-
-  withInvocation(invocation: Invocation): Call {
-    return new Call(this.address, invocation);
-  }
-}

package/src/contract/CallLog.ts

@@ -1,55 +0,0 @@
-import type { RouteKind } from './RouteAddress.js';
-
-/**
- * What crosses the door: the address, the route it took, and the verdict.
- *
- * It lives here rather than beside its producer for the reason `TopologyReport` does: it
- * crosses a process boundary, so a reader that never installed `@fougere/calls` — the CLI
- * — needs its shape, and putting it there is what produces a hand-copied duplicate.
- *
- * Never the body. Same rule the topology report states — a remote destination is named,
- * not disclosed — and it holds here for the same reason: this answer leaves the process.
- */
-export interface CallRecord {
-  /** Monotonic, and the whole cursor protocol: a reader asks for what is above its own. */
-  seq: number;
-  frond?: string;
-  entity: string;
-  operation: string;
-  surface?: string;
-  /** Known at `resolved`, so absent on a call that never found a route. */
-  route?: RouteKind;
-  /**
-   * The traceparent the invocation carried, when one did.
-   *
-   * One panel reads one process, so this is what lets two of them be sewn: the process
-   * that sent and the process that executed share it, and the gap between their two
-   * durations IS the cost of the wire rather than a deduction.
-   */
-  trace?: string;
-  /**
-   * The peer that established this call, when one did.
-   *
-   * A hosted frond serves several consumers, so its own ring mixes them: this is what
-   * separates them. Absent on a call nobody signed — a loopback dev boot has no identity.
-   */
-  caller?: string;
-  startedAt: number;
-  /** Known at `settled`. */
-  ms?: number;
-  verdict: 'running' | 'ok' | 'failed';
-  refusal?: { code?: string; message: string };
-}
-
-/**
- * One page of the ring.
- *
- * `dropped` is what the ring could not keep — an absence is named rather than left to
- * look like a quiet period.
- */
-export interface CallPage {
-  calls: CallRecord[];
-  cursor: number;
-  inFlight: number;
-  dropped: number;
-}

package/src/dispatch/InputValidator.ts

@@ -1,28 +0,0 @@
-import { RowJudge, type SchemaView } from '@fougere/schema';
-import type { InvocationContext } from '../contract/Invocation.js';
-import { ErrorCode, FougereError } from '../wire/errors.js';
-
-/** Validates and decodes the input body declared by one operation contract. */
-export class InputValidator {
-  validate(
-    schema: SchemaView | undefined,
-    invocation: InvocationContext,
-    entity: string,
-    operation: string,
-  ): InvocationContext {
-    if (!schema || invocation.body === undefined || invocation.body === null) return invocation;
-
-    const result = RowJudge.of(schema.getFields(), { patch: schema.getOpts().patch })
-      .check(invocation.body);
-    if (!result.success) {
-      throw new FougereError({
-        code: ErrorCode.VALIDATION_FAILED,
-        message: result.errors.map((error) => `${error.path}: ${error.message}`).join(', '),
-        details: result.errors,
-        entity,
-        operation,
-      });
-    }
-    return { ...invocation, body: result.data };
-  }
-}

package/src/dispatch/OperationExecutor.ts

@@ -1,60 +0,0 @@
-import type { InvocationContext } from '../contract/Invocation.js';
-import { canonicalInvocation } from '../contract/Invocation.js';
-import type { OperationContract } from '../wire/operation.js';
-import {
-  runMiddlewares,
-  type AppMiddleware,
-  type OperationContext,
-} from '../wire/middleware.js';
-import type { ArgumentResolver } from './ArgumentResolver.js';
-import type { InputValidator } from './InputValidator.js';
-import type { OutputProjector } from './OutputProjector.js';
-
-export interface OperationExecution {
-  entity: string;
-  frond: string;
-  operation: string;
-  contract: OperationContract | undefined;
-  middlewares: () => AppMiddleware[];
-  validator: InputValidator;
-  arguments: ArgumentResolver;
-  invoke: (args: unknown[]) => unknown | Promise<unknown>;
-  projector: OutputProjector;
-  present?: (result: unknown, invocation: InvocationContext) => Promise<unknown>;
-}
-
-/** Executes one operation through the same ordered boundary steps on every route. */
-export class OperationExecutor {
-  constructor(private readonly execution: OperationExecution) {}
-
-  async execute(input?: Partial<InvocationContext>): Promise<unknown> {
-    const invocation = canonicalInvocation(input);
-    const context: OperationContext = {
-      entity: this.execution.entity,
-      frond: this.execution.frond,
-      operation: this.execution.operation,
-      args: [],
-      state: invocation.state,
-      invocation,
-    };
-    return runMiddlewares(this.execution.middlewares(), context, async () => {
-      const effective = this.execution.validator.validate(
-        this.execution.contract?.input,
-        invocation,
-        context.entity,
-        context.operation,
-      );
-      context.invocation = effective;
-
-      const args = this.execution.contract?.binding
-        ? await this.execution.arguments.resolve(this.execution.contract.binding, effective)
-        : [];
-      const projected = this.execution.projector.project(
-        await this.execution.invoke(args),
-      );
-      return this.execution.present
-        ? this.execution.present(projected, effective)
-        : projected;
-    });
-  }
-}