@fougere/core 0.2.0-alpha.2 → 0.3.0-alpha.0

package/dist/boot/HandlerFacade.js

@@ -0,0 +1,174 @@
+import { registrationKeyOf } from '@fougere/schema';
+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 { 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';
+/** Adapts one handler door to executable operations. */
+export class HandlerFacade {
+    door;
+    wiring;
+    /** Rich operation facts shared with check, explain and adapters. */
+    effectiveOperations;
+    /** Contracts served by this door. */
+    contracts;
+    /** The callable surface: op name → the function a caller reaches. */
+    ops = {};
+    cachedViews = new Map();
+    instance;
+    implementationKeys = new Map();
+    implementationInstances = new Map();
+    inputValidator = new InputValidator();
+    argumentResolver = new ArgumentResolver((typeName) => this.collectorResolver(typeName));
+    presenterArguments;
+    constructor(door, wiring) {
+        this.door = door;
+        this.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]));
+        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 ORM will be injected`);
+        }
+    }
+    /** Storage follows the Crud subject, which may differ from the door address. */
+    subjectOf(handler) {
+        const target = targetOf(handler.ctor);
+        return target?.name ? registrationKeyOf(target.name) : handler.address;
+    }
+    inheritsCrud(handler) {
+        const proto = handler.ctor.prototype;
+        return typeof proto?.list === 'function' && typeof proto?.findById === 'function';
+    }
+    get handlerKey() {
+        return `_handler:${this.door.key}`;
+    }
+    depsOf(handler) {
+        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. */
+    refuseCrudWithoutRepository(handler) {
+        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. */
+    viewOf(op) {
+        const known = this.cachedViews.get(op);
+        if (known)
+            return known;
+        const operation = this.effectiveOperations.get(op);
+        const schema = operation?.output;
+        const resolved = new OutputView(typeof schema?.getFields === 'function' ? schema.getFields() : {}, operation?.outputClosed ?? false);
+        this.cachedViews.set(op, resolved);
+        return resolved;
+    }
+    collectorResolver = (typeName) => {
+        try {
+            return this.door.scope.resolve(collectorKeyOf(typeName));
+        }
+        catch {
+            return undefined;
+        }
+    };
+    /** The handler itself, resolved on first call — never at boot. */
+    resolvedHandler() {
+        if (!this.instance)
+            this.instance = this.door.scope.resolve(this.handlerKey);
+        return this.instance;
+    }
+    isBaseImplementation(operation) {
+        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. */
+    implementationHandler(operationName) {
+        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];
+    }
+    resolvedImplementation(operationName) {
+        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 };
+    }
+    wrap(op) {
+        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, effective) => 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);
+    }
+}
+//# sourceMappingURL=HandlerFacade.js.map

package/dist/boot/HandlerFacade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandlerFacade.js","sourceRoot":"","sources":["../../src/boot/HandlerFacade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAe,MAAM,iBAAiB,CAAC;AAIjE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAO/C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAgCrF,wDAAwD;AACxD,MAAM,OAAO,aAAa;IAmBK;IAAgC;IAlB7D,oEAAoE;IAC3D,mBAAmB,CAAyB;IACrD,qCAAqC;IAC5B,SAAS,CAAgB;IAElC,qEAAqE;IAC5D,GAAG,GAA6B,EAAE,CAAC;IAE3B,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IACrD,QAAQ,CAAM;IACL,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,uBAAuB,GAAG,IAAI,GAAG,EAAe,CAAC;IACjD,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,gBAAgB,GAAG,IAAI,gBAAgB,CACtD,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAC/C,CAAC;IACe,kBAAkB,CAA4B;IAE/D,YAA6B,IAAa,EAAmB,MAAc;QAA9C,SAAI,GAAJ,IAAI,CAAS;QAAmB,WAAM,GAAN,MAAM,CAAQ;QACzE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACjC,IAAI,CAAC,kBAAkB,GAAG,IAAI,yBAAyB,CACrD,IAAI,CAAC,gBAAgB,EACrB,MAAM,CAAC,UAAU,CAClB,CAAC;QACF,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEnF,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,UAAU,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CACtB,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,SAA8B,CAAU,CAAC,CACjG,CAAC;QACF,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QAEpC,uEAAuE;QACvE,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC;gBAAE,SAAS;YACnD,MAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,CAAC,2BAA2B,CAAC,cAAc,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,mBAAmB,SAAS,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;YACtF,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBACrF,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,2DAA2D;QAC3D,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAErE,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1C,+DAA+D;YAC/D,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,iDAAiD;kBAClF,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,iEAAiE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,gFAAgF;IACxE,SAAS,CAAC,OAAqB;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACzE,CAAC;IAEO,YAAY,CAAC,OAAqB;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QACrC,OAAO,OAAO,KAAK,EAAE,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,EAAE,QAAQ,KAAK,UAAU,CAAC;IACpF,CAAC;IAED,IAAY,UAAU;QACpB,OAAO,YAAY,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAEO,MAAM,CAAC,OAAqB;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,CAAC;IAED,wEAAwE;IAChE,2BAA2B,CAAC,OAAqB;QACvD,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO;QAC5G,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,mEAAmE;YACvF,sDAAsD;YACtD,oCAAoC;YACpC,yBAAyB,YAAY,uBAAuB,CAC7D,CAAC;IACJ,CAAC;IAED,oEAAoE;IAC5D,MAAM,CAAC,EAAU;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,SAAS,EAAE,MAAkD,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAI,UAAU,CAC7B,OAAO,MAAM,EAAE,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EACjE,SAAS,EAAE,YAAY,IAAI,KAAK,CACjC,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,iBAAiB,GAAG,CAAC,QAAgB,EAAiC,EAAE;QAC9E,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAsB,CAAC;QAAC,CAAC;QACtF,MAAM,CAAC;YAAC,OAAO,SAAS,CAAC;QAAC,CAAC;IAC7B,CAAC,CAAC;IAEF,kEAAkE;IAC1D,eAAe;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEO,oBAAoB,CAAC,SAA6B;QACxD,OAAO,SAAS,CAAC,cAAc,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI;eACpE,SAAS,CAAC,cAAc,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;eAC9D,SAAS,CAAC,cAAc,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACxE,CAAC;IAED,uFAAuF;IAC/E,qBAAqB,CAAC,aAAqB;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACpD,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,cAAc,CAAC,SAAS;eACrD,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,cAAc,CAAC,OAAO;eACpD,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,uBAAuB,SAAS,CAAC,EAAE,WAAW,SAAS,CAAC,cAAc,CAAC,SAAS,GAAG;kBACjF,GAAG,SAAS,CAAC,cAAc,CAAC,MAAM,oBAAoB,OAAO,CAAC,MAAM,qBAAqB,CAC5F,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;IACrB,CAAC;IAEO,sBAAsB,CAAC,aAAqB;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;QAC/D,IAAI,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QACvF,CAAC;QAED,MAAM,SAAS,GAAG,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACpG,IAAI,QAAQ,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;IAC/D,CAAC;IAEO,IAAI,CAAC,EAAU;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;YACrC,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,SAAS,EAAE,EAAE;YACb,QAAQ;YACR,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC;YACtD,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,SAAS,EAAE,IAAI,CAAC,gBAAgB;YAChC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrB,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;gBACvD,OAAO,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACjE,CAAC;YACD,SAAS,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACnC,OAAO,EAAE,KAAK,EAAE,MAAe,EAAE,SAA4B,EAAE,EAAE,CAC/D,IAAI,iBAAiB,CACnB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EACvD,SAAS,CAAC,MAAM,EAChB,OAAO,EACP,EAAE,CACH,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;aACjF,CAAC;SACH,CAAC,CAAC;QAEH,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/boot/Lifecycle.d.ts

@@ -0,0 +1,4 @@
+/** Compatibility module. Prefer AppLifecycle for the process-level lifecycle. */
+export { AppLifecycle, AppLifecycle as Lifecycle, migrating } from './AppLifecycle.js';
+export type { Extension } from './AppLifecycle.js';
+//# sourceMappingURL=Lifecycle.d.ts.map

package/dist/boot/Lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.d.ts","sourceRoot":"","sources":["../../src/boot/Lifecycle.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,IAAI,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACvF,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/boot/Lifecycle.js

@@ -0,0 +1,3 @@
+/** Compatibility module. Prefer AppLifecycle for the process-level lifecycle. */
+export { AppLifecycle, AppLifecycle as Lifecycle, migrating } from './AppLifecycle.js';
+//# sourceMappingURL=Lifecycle.js.map

package/dist/boot/Lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.js","sourceRoot":"","sources":["../../src/boot/Lifecycle.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,IAAI,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/boot/ambient-port.d.ts

@@ -0,0 +1,38 @@
+/**
+ * What a call needs to know about the call it is inside, and the two ways to answer it.
+ *
+ * One realization reads an async context (`ambient.als.ts`), the other cannot and waits
+ * its turn instead (`ambient.queue.ts`). `#ambient` in package.json picks one per runtime,
+ * so a bundle for a host without async context never names `node:async_hooks`.
+ */
+export interface Ambient {
+    /** True when this runtime has no async context, and the boot says so. */
+    readonly degraded: boolean;
+    /**
+     * Run `fn` as the frame `key`. A frame opened inside another must not proceed.
+     *
+     * Measured on SQLite: a second transaction on the same connection WAITS for the first,
+     * so a nested frame hangs on one engine and returns when split across two.
+     */
+    enterFrame<R>(key: string, fn: () => Promise<R>): Promise<R>;
+    /**
+     * Settle before `fact` is dispatched: a fact announced inside a frame that then rolls
+     * back is a lie. Refuses when the caller's own frame can be told, waits when it cannot.
+     */
+    beforeAnnounce(fact: string): Promise<void>;
+    /**
+     * The facts already being announced up the stack, so a fact cannot cause itself.
+     *
+     * A CHAIN and not a depth: `A → B → D` and `A → C → D` is a diamond, perfectly legal,
+     * while `A → … → A` never ends. Empty where it cannot be followed.
+     *
+     * Detecting this at boot was the first idea and it was wrong: `Emit<G>` is a CONSTRUCTOR
+     * dependency, so it belongs to the handler and not to one of its methods. A handler that
+     * subscribes to `A` in one method and emits `G` from another would have been refused for
+     * a cycle it never walks.
+     */
+    currentChain(): readonly string[];
+    /** Run `fn` with `fact` appended to the emission chain. */
+    enterChain<R>(fact: string, fn: () => Promise<R>): Promise<R>;
+}
+//# sourceMappingURL=ambient-port.d.ts.map

package/dist/boot/ambient-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-port.d.ts","sourceRoot":"","sources":["../../src/boot/ambient-port.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7D;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;;;;;;;OAUG;IACH,YAAY,IAAI,SAAS,MAAM,EAAE,CAAC;IAElC,2DAA2D;IAC3D,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/D"}

package/dist/boot/ambient-port.js

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

package/dist/boot/ambient-port.js.map

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

package/dist/boot/ambient.als.d.ts

@@ -0,0 +1,3 @@
+import type { Ambient } from './ambient-port.js';
+export declare const ambient: Ambient;
+//# sourceMappingURL=ambient.als.d.ts.map

package/dist/boot/ambient.als.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient.als.d.ts","sourceRoot":"","sources":["../../src/boot/ambient.als.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKjD,eAAO,MAAM,OAAO,EAAE,OA8BrB,CAAC"}

package/dist/boot/ambient.als.js

@@ -0,0 +1,34 @@
+/**
+ * The realization that can tell whose frame is open: an async context.
+ *
+ * Chosen by `#ambient` wherever `node:async_hooks` exists — Node, Deno, Bun, and workerd
+ * with `nodejs_als`. Every refusal here is immediate and names its cause.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+const frame = new AsyncLocalStorage();
+const chain = new AsyncLocalStorage();
+export const ambient = {
+    degraded: false,
+    enterFrame(key, fn) {
+        const held = frame.getStore();
+        if (held !== undefined) {
+            return Promise.reject(new Error(`Together<[…]> (${key}) cannot be opened inside ${held}: on one engine the second `
+                + `transaction waits for the first and the call hangs. Two frames that must both hold `
+                + `are ONE frame — declare a single Together naming every member.`));
+        }
+        return frame.run(key, fn);
+    },
+    beforeAnnounce(fact) {
+        const held = frame.getStore();
+        if (held === undefined)
+            return Promise.resolve();
+        return Promise.reject(new Error(`${fact} cannot be announced inside Together<[…]> (${held}): announcing is dispatch, `
+            + `so subscribers and the carrier would have it while these writes can still be taken `
+            + `back. Announce after run() returns, when it is true.`));
+    },
+    currentChain: () => chain.getStore() ?? [],
+    enterChain(fact, fn) {
+        return chain.run([...(chain.getStore() ?? []), fact], fn);
+    },
+};
+//# sourceMappingURL=ambient.als.js.map

package/dist/boot/ambient.als.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient.als.js","sourceRoot":"","sources":["../../src/boot/ambient.als.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAU,CAAC;AAC9C,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAqB,CAAC;AAEzD,MAAM,CAAC,MAAM,OAAO,GAAY;IAC9B,QAAQ,EAAE,KAAK;IAEf,UAAU,CAAI,GAAW,EAAE,EAAoB;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAC7B,kBAAkB,GAAG,6BAA6B,IAAI,6BAA6B;kBACjF,qFAAqF;kBACrF,gEAAgE,CACnE,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACjD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAC7B,GAAG,IAAI,8CAA8C,IAAI,6BAA6B;cACpF,qFAAqF;cACrF,sDAAsD,CACzD,CAAC,CAAC;IACL,CAAC;IAED,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE;IAE1C,UAAU,CAAI,IAAY,EAAE,EAAoB;QAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/dist/boot/ambient.queue.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The realization for a runtime with no async context: it cannot tell whose frame is
+ * open, so it never guesses — it waits its turn.
+ *
+ * Two consequences the boot reports rather than hides: frames run one at a time, and a
+ * frame opened inside another is not refused, it waits for itself and times out.
+ */
+import type { Ambient } from './ambient-port.js';
+export declare const ambient: Ambient;
+//# sourceMappingURL=ambient.queue.d.ts.map

package/dist/boot/ambient.queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient.queue.d.ts","sourceRoot":"","sources":["../../src/boot/ambient.queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAmBjD,eAAO,MAAM,OAAO,EAAE,OAgDrB,CAAC"}

package/dist/boot/ambient.queue.js

@@ -0,0 +1,60 @@
+/** What a nested frame waits before it is told what it did — the hang, measured, plus a name. */
+const NESTED_TIMEOUT_MS = 5_000;
+let busy;
+let holder;
+const settled = () => undefined;
+/** Resolves when `p` settles or `ms` elapses, whichever comes first, holding no timer after. */
+function raceWith(p, ms) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        const clear = () => { clearTimeout(timer); resolve(); };
+        void p.then(clear, clear);
+    });
+}
+export const ambient = {
+    degraded: true,
+    async enterFrame(key, fn) {
+        const deadline = Date.now() + NESTED_TIMEOUT_MS;
+        for (;;) {
+            // Nothing may await between this test and the reservation below, or two waiters
+            // woken in the same tick would both take the frame.
+            if (busy === undefined)
+                break;
+            const left = deadline - Date.now();
+            if (left <= 0) {
+                throw new Error(`Together<[…]> (${key}) waited ${NESTED_TIMEOUT_MS}ms for ${holder} and gave up. `
+                    + `This runtime has no async context, so a frame opened inside another waits for `
+                    + `itself instead of being refused. Two frames that must both hold are ONE frame — `
+                    + `declare a single Together naming every member.`);
+            }
+            await raceWith(busy, left);
+        }
+        // Held BEFORE `fn` runs: the first thing a frame's body does may be to open another,
+        // and reserving on the returned promise would be one tick too late to see it.
+        let release = settled;
+        busy = new Promise((resolve) => { release = resolve; });
+        holder = key;
+        try {
+            return await fn();
+        }
+        finally {
+            busy = undefined;
+            holder = undefined;
+            release();
+        }
+    },
+    /**
+     * Waits rather than refuses: whose frame is open cannot be told here, and refusing on
+     * that would refuse an announcement made by an unrelated call.
+     */
+    async beforeAnnounce(_fact) {
+        while (busy)
+            await raceWith(busy, NESTED_TIMEOUT_MS);
+    },
+    /** No chain can be followed here — an emission ring is not detected. Said at boot. */
+    currentChain: () => [],
+    enterChain(_fact, fn) {
+        return fn();
+    },
+};
+//# sourceMappingURL=ambient.queue.js.map

package/dist/boot/ambient.queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient.queue.js","sourceRoot":"","sources":["../../src/boot/ambient.queue.ts"],"names":[],"mappings":"AASA,iGAAiG;AACjG,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,IAAI,IAA+B,CAAC;AACpC,IAAI,MAA0B,CAAC;AAE/B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;AAEhC,gGAAgG;AAChG,SAAS,QAAQ,CAAC,CAAgB,EAAE,EAAU;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACxD,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAY;IAC9B,QAAQ,EAAE,IAAI;IAEd,KAAK,CAAC,UAAU,CAAI,GAAW,EAAE,EAAoB;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC;QAChD,SAAS,CAAC;YACR,gFAAgF;YAChF,oDAAoD;YACpD,IAAI,IAAI,KAAK,SAAS;gBAAE,MAAM;YAC9B,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,kBAAkB,GAAG,YAAY,iBAAiB,UAAU,MAAM,gBAAgB;sBAChF,gFAAgF;sBAChF,kFAAkF;sBAClF,gDAAgD,CACnD,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,qFAAqF;QACrF,8EAA8E;QAC9E,IAAI,OAAO,GAAG,OAAqB,CAAC;QACpC,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,CAAC;QACb,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,GAAG,SAAS,CAAC;YACjB,MAAM,GAAG,SAAS,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,KAAa;QAChC,OAAO,IAAI;YAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACvD,CAAC;IAED,sFAAsF;IACtF,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE;IAEtB,UAAU,CAAI,KAAa,EAAE,EAAoB;QAC/C,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/boot/apply.d.ts

@@ -0,0 +1,22 @@
+import type { FougereConfig } from '../config-loader.js';
+export interface ConfigApplication {
+    /** What this call changed in the running process. */
+    applied: string[];
+    /** What differs from the config in force and did NOT take effect. */
+    pending: string[];
+}
+/**
+ * What a (re-)read config changes in a process that is already running.
+ *
+ * The rule it realizes, and the only one worth remembering: **a value that is
+ * CONSULTED can change under a running app; a value that was CONSUMED to build
+ * something cannot, without rebuilding what it built.** `logLevel` is consulted at
+ * every emission, so it moves. `db` opened a connection, `ports:` registered a class,
+ * the entities built façades — those are consumed, and this function reports them
+ * rather than pretending.
+ *
+ * The list of consulted keys is not declared anywhere: a key is consulted when this
+ * function does something with it, which is the only definition that cannot go stale.
+ */
+export declare function applyConfig(next: FougereConfig, inForce?: FougereConfig): ConfigApplication;
+//# sourceMappingURL=apply.d.ts.map

package/dist/boot/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/boot/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAsB3F"}

package/dist/boot/apply.js

@@ -0,0 +1,48 @@
+import { setLogLevel, logLevel, envLevel } from '../builtins/logger.js';
+/**
+ * What a (re-)read config changes in a process that is already running.
+ *
+ * The rule it realizes, and the only one worth remembering: **a value that is
+ * CONSULTED can change under a running app; a value that was CONSUMED to build
+ * something cannot, without rebuilding what it built.** `logLevel` is consulted at
+ * every emission, so it moves. `db` opened a connection, `ports:` registered a class,
+ * the entities built façades — those are consumed, and this function reports them
+ * rather than pretending.
+ *
+ * The list of consulted keys is not declared anywhere: a key is consulted when this
+ * function does something with it, which is the only definition that cannot go stale.
+ */
+export function applyConfig(next, inForce) {
+    const applied = [];
+    const pending = [];
+    // The CLI speaks through the environment, so it keeps winning over the file — read
+    // through `envLevel`, which is where the environment is already judged. Casting it
+    // here was a second reader that validated nothing: `FOUGERE_LOG_LEVEL=verbose` set
+    // the threshold to `undefined` and every log passed.
+    const wanted = envLevel() ?? next.logLevel ?? 'debug';
+    const before = logLevel();
+    if (wanted !== before) {
+        setLogLevel(wanted);
+        applied.push(`logLevel: ${before} → ${wanted}`);
+    }
+    for (const key of new Set([...Object.keys(next), ...Object.keys(inForce ?? {})])) {
+        if (key === 'logLevel' || !inForce)
+            continue;
+        if (!same(next[key], inForce[key])) {
+            pending.push(key);
+        }
+    }
+    return { applied, pending };
+}
+/** Equal enough to decide "nothing changed". Anything unserialisable counts as changed. */
+function same(a, b) {
+    if (a === b)
+        return true;
+    try {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=apply.js.map

package/dist/boot/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/boot/apply.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AASxE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,IAAmB,EAAE,OAAuB;IACtE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,mFAAmF;IACnF,mFAAmF;IACnF,mFAAmF;IACnF,qDAAqD;IACrD,MAAM,MAAM,GAAG,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC;IACtD,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;IAC1B,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,WAAW,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,aAAa,MAAM,MAAM,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,IAAI,GAAG,KAAK,UAAU,IAAI,CAAC,OAAO;YAAE,SAAS;QAC7C,IAAI,CAAC,IAAI,CAAE,IAAgC,CAAC,GAAG,CAAC,EAAG,OAAmC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7F,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,2FAA2F;AAC3F,SAAS,IAAI,CAAC,CAAU,EAAE,CAAU;IAClC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/boot/auth.d.ts

@@ -0,0 +1,53 @@
+/**
+ * What an auth provider promises the boot, and what the boot hands it — the whole of
+ * the contract between core and an `@fougere/auth-*` package.
+ */
+import type { SchemaView } from '@fougere/schema';
+import type { EntityOrm, OrmFactory } from '../orm.js';
+/**
+ * Lazy auth declaration written in fougere.config.ts.
+ *
+ * Each @fougere/auth-* package exports a factory (e.g. `betterAuth(opts)`) that
+ * returns this shape. The `create()` method is called once at boot with the
+ * resolved db + ormFactory, so the provider can wire its engine through Fougere.
+ */
+export interface AuthConfig {
+    /** Build the runtime — invoked by createApp at boot with the resolved storage handles. */
+    create(ctx: AuthContext): AuthRuntime | Promise<AuthRuntime>;
+    /**
+     * Entities the provider will use. Optional metadata — useful for the core's
+     * future migration registry to know which tables auth needs.
+     */
+    entities?: Record<string, SchemaView>;
+}
+/**
+ * Context passed by the core to an auth provider's create() function.
+ * Provides the resources the provider needs to integrate with the app.
+ */
+export interface AuthContext {
+    /** Storage handle (Kysely DB instance, Prisma client, etc.) — opaque to core. */
+    db: unknown;
+    /** Per-entity ORM factory — auth provider uses this to back its adapter. */
+    ormFactory: OrmFactory;
+}
+/**
+ * Runtime returned by an auth provider's create(config, ctx) function.
+ * The core mounts this on the App and the HTTP layer (Nuxt module / router) uses it.
+ */
+export interface AuthRuntime {
+    /** Entities used by the provider, including any defaults it filled in. */
+    entities: Record<string, SchemaView>;
+    /**
+     * Per-entity ORMs the provider built for itself. Exposed so app code can
+     * query auth tables (e.g. list active sessions for a user) without rebuilding
+     * the same EntityOrm.
+     */
+    orms: Record<string, EntityOrm>;
+    /** Web Standard handler that processes /auth/* requests. */
+    handler: (request: Request) => Promise<Response>;
+    /** Programmatic API exposed by the provider (getSession, signOut, ...). */
+    api: Record<string, unknown>;
+    /** Effective mount path (echoes config.basePath or the provider's default). */
+    basePath: string;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/boot/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/boot/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,0FAA0F;IAC1F,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,EAAE,EAAE,OAAO,CAAC;IACZ,4EAA4E;IAC5E,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,4DAA4D;IAC5D,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/boot/auth.js

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

package/dist/boot/auth.js.map

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

package/dist/{binding.d.ts → boot/binding.d.ts}

@@ -1,20 +1,16 @@
 /**
- * Binding — unified parameter resolution for handler operations.
+ * Where each parameter of an operation gets its value — decided once at boot from the
+ * parsed signature, replayed per call by `resolveArgs`.
  *
- * A BindingPlan is computed once at boot from parsed method signatures.
- * At call time, resolveArgs() produces the argument array from an InvocationContext.
- *
- * Algorithm (by param type):
- * 1. Collector entity type → resolved via Collector.collect(ctx)
- * 2. InvocationContext → the context itself
- * 3. Primitive (string, number, boolean) → matched by name from params then query
- * 4. Object/entity type → matched from body
+ * The branches are ORDERED and each states why it sits where it does; the list used to
+ * be repeated here too, and it had already lost `Fact` — the one whose position is
+ * load-bearing, since the fall-through would otherwise hand it the caller's body.
  */
-import type { ParsedParam } from './handler-parser.js';
-import type { InvocationContext } from './invocation.js';
-export type ParamSource = {
+import type { ParsedParam } from '../scan/handler-parser.js';
+import type { InvocationContext } from '../wire/invocation.js';
+type ParamSource = {
     kind: 'collector';
-    entityName: string;
+    typeName: string;
 }
 /**
  * `Fact<PostPublished>` — something that happened, not something a caller typed.
@@ -40,7 +36,7 @@ export type ParamSource = {
  | {
     kind: 'query';
 };
-export interface ParamBinding {
+interface ParamBinding {
     name: string;
     source: ParamSource;
     optional: boolean;
@@ -50,14 +46,15 @@ export type BindingPlan = ParamBinding[];
  * Build a BindingPlan from parsed method params.
  *
  * @param params - Parsed parameter list from AST
- * @param collectorEntityNames - Set of entity names that have a Collector
+ * @param collectorTypeNames - Registration keys of the types a Collector answers for
  */
-export declare function computeBindingPlan(params: ParsedParam[], collectorEntityNames: Set<string>): BindingPlan;
+export declare function computeBindingPlan(params: ParsedParam[], collectorTypeNames: Set<string>): BindingPlan;
 export interface CollectorResolver {
     collect(ctx: InvocationContext): Promise<unknown>;
 }
 /**
  * Resolve handler arguments from a BindingPlan + InvocationContext.
  */
-export declare function resolveArgs(plan: BindingPlan, ctx: InvocationContext, resolveCollector?: (entityName: string) => CollectorResolver | undefined): Promise<unknown[]>;
+export declare function resolveArgs(plan: BindingPlan, ctx: InvocationContext, resolveCollector?: (typeName: string) => CollectorResolver | undefined): Promise<unknown[]>;
+export {};
 //# sourceMappingURL=binding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/boot/binding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAK/D,KAAK,WAAW,GACZ;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACzC;;;;;;;GAOG;GACD;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,MAAM,CAAA;CAAE,GAChB;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;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EAAE,EACrB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,WAAW,CA0Db;AAID,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,iBAAiB,EACtB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,GACrE,OAAO,CAAC,OAAO,EAAE,CAAC,CAgDpB"}