hexok 1.0.0

package/dist/runtime/app.js

@@ -0,0 +1,292 @@
+import { deriveContract, isEventUseCase, isExternalUseCase, isInternalUseCase, nestByKey, } from '../app/index.js';
+import { createChannelHandle, resolveChannelPorts, startChannels, stopChannelAdapters, } from './channel.js';
+import { startHandlers, stopAdapters } from './events.js';
+import { createFetchHandler } from './http.js';
+import { requireCapability } from './interceptor.js';
+import { invokeExternal, publishNow } from './invoke.js';
+import { deriveRpc } from './rpc.js';
+/** Fluent composition. `build` is callable only after every required port, catalog, and channel is wired. */
+export class AppBuilder {
+    #useCases;
+    #provided = new Map();
+    #bound = new Map();
+    #routed = new Map();
+    #interceptors = [];
+    #middleware = [];
+    #defaultCtx;
+    #ctxFrom;
+    constructor(useCases) {
+        this.#useCases = useCases;
+    }
+    /** Start composition from a map of use-case classes. */
+    static from(useCases) {
+        return new AppBuilder(useCases);
+    }
+    /** Register a port implementation. A second `provide` for the same token is a compile-time error and a runtime throw. */
+    provide(token, impl) {
+        const port = token;
+        if (this.#provided.has(port)) {
+            throw new Error(`hexok: port "${port.key}" already provided`);
+        }
+        for (const existing of this.#provided.keys()) {
+            if (existing.key === port.key && existing !== port) {
+                throw new Error(`hexok: two tokens share the key "${port.key}"`);
+            }
+        }
+        if (port.capabilities.transactional) {
+            requireCapability(port, impl, 'bindTo', 'Transactional');
+        }
+        if (port.capabilities.requestScoped) {
+            requireCapability(port, impl, 'fork', 'RequestScoped');
+        }
+        this.#provided.set(port, impl);
+        return this;
+    }
+    /** Bind an event adapter to a catalog. Adapter `kind` must match; a second bind of the same catalog fails. */
+    bind(catalog, adapter) {
+        const cat = catalog;
+        if (this.#bound.has(cat)) {
+            throw new Error(`hexok: catalog "${cat.key}" already bound`);
+        }
+        if (adapter.kind !== cat.kind) {
+            throw new Error(`hexok: catalog "${cat.key}" is kind "${cat.kind}" but the adapter is "${adapter.kind}"`);
+        }
+        cat.freeze();
+        this.#bound.set(cat, adapter);
+        return this;
+    }
+    /** Route a channel class to a presence adapter. The channel catalog must be a bus and still needs `bind`. */
+    route(channel, adapter) {
+        const ctor = channel;
+        const catalog = ctor.catalog;
+        if (catalog.kind !== 'bus') {
+            throw new Error(`hexok: channel catalog "${catalog.key}" is kind "${catalog.kind}". Channels require a bus catalog.`);
+        }
+        if (this.#routed.has(catalog)) {
+            throw new Error(`hexok: catalog "${catalog.key}" already routed`);
+        }
+        catalog.freeze();
+        const instance = new ctor();
+        this.#routed.set(catalog, {
+            ctor,
+            instance,
+            adapter: adapter,
+            ports: {},
+        });
+        return this;
+    }
+    /** Set the default request context for `local`, HTTP, and event handlers. Per-call `ctx` overrides it. */
+    ctx(defaults) {
+        this.#defaultCtx = defaults;
+        return this;
+    }
+    /**
+     * Set HTTP request context from the `Request`. `body.ctx` is ignored.
+     * Call `.ctx<C>()` first so `ctx` is typed. `local` still uses `.ctx()` / per-call `{ ctx }`.
+     */
+    ctxFrom(fn) {
+        this.#ctxFrom = fn;
+        return this;
+    }
+    /**
+     * Provide a factory from `Adapter.of` by calling `create(...deps)`.
+     * Same as `.provide(factory.token, factory.create(...deps))`.
+     */
+    adapt(factory, ...deps) {
+        return this.provide(factory.token, factory.create(...deps));
+    }
+    /** Register middleware around external `execute` (`local` and HTTP) — not event handlers or nested `run`. */
+    use(middleware) {
+        this.#middleware.push(middleware);
+        return this;
+    }
+    /** Register an interceptor. First registered is outer for execute, adapter, publish, and dispatch. Duplicate `key` throws. */
+    intercept(interceptor) {
+        if (this.#interceptors.some((item) => item.key === interceptor.key)) {
+            throw new Error(`hexok: duplicate interceptor key "${interceptor.key}"`);
+        }
+        this.#interceptors.push(interceptor);
+        return this;
+    }
+    /**
+     * Complete the graph. Incomplete builders expose `build` as the missing
+     * port/catalog message (not callable). Runtime throws the same sentences.
+     */
+    get build() {
+        return (() => this.#build());
+    }
+    #build() {
+        this.#assertComplete();
+        const adapted = new Map();
+        for (const [token, impl] of this.#provided) {
+            let current = impl;
+            for (let i = this.#interceptors.length - 1; i >= 0; i--) {
+                const interceptor = this.#interceptors[i];
+                if (interceptor?.aroundAdapter) {
+                    current = interceptor.aroundAdapter(token, current);
+                }
+            }
+            adapted.set(token, current);
+        }
+        for (const routed of this.#routed.values()) {
+            routed.ports = resolveChannelPorts(routed.ctor, adapted);
+        }
+        const catalog = deriveContract(this.#useCases);
+        const rpc = deriveRpc(catalog);
+        const external = new Map();
+        const eventHandlers = new Map();
+        const handlersView = {};
+        for (const ctor of Object.values(this.#useCases)) {
+            if (isExternalUseCase(ctor)) {
+                external.set(ctor.key, ctor);
+                continue;
+            }
+            if (isInternalUseCase(ctor)) {
+                continue;
+            }
+            if (isEventUseCase(ctor)) {
+                const handlerKey = `${ctor.catalog.key}:${ctor.on.key}`;
+                const list = eventHandlers.get(handlerKey) ?? [];
+                list.push(ctor);
+                eventHandlers.set(handlerKey, list);
+                const byCatalog = handlersView[ctor.catalog.key] ?? {};
+                const byEvent = byCatalog[ctor.on.key] ?? [];
+                byEvent.push(ctor);
+                byCatalog[ctor.on.key] = byEvent;
+                handlersView[ctor.catalog.key] = byCatalog;
+            }
+        }
+        const channelHandles = {};
+        for (const [cat, routed] of this.#routed) {
+            channelHandles[cat.key] = createChannelHandle(routed.ctor, routed.instance, routed.adapter, routed.ports);
+        }
+        const started = { value: false };
+        const handlerKeys = new Set(eventHandlers.keys());
+        const deps = () => ({
+            ports: adapted,
+            catalogs: this.#bound,
+            interceptors: this.#interceptors,
+            middleware: this.#middleware,
+            defaultCtx: this.#defaultCtx,
+            channels: channelHandles,
+            started,
+            handlerKeys,
+            ...(this.#ctxFrom !== undefined ? { ctxFrom: this.#ctxFrom } : {}),
+        });
+        const local = nestByKey([...external.entries()].map(([key, ctor]) => [
+            key,
+            (input, opts) => invokeExternal(ctor, input, deps(), opts),
+        ]));
+        const instance = {
+            contract: nestedContract(catalog),
+            rpc,
+            router: { fetch: createFetchHandler(external, deps()) },
+            local,
+            handlers: handlersView,
+            channels: channelHandles,
+            publish: (envelope) => publishNow(envelope, deps()),
+            start: async () => {
+                if (started.value)
+                    throw new Error('hexok: start() called twice');
+                started.value = true;
+                await startHandlers(this.#bound, eventHandlers, deps());
+                startChannels(this.#routed, this.#bound);
+            },
+            stop: async () => {
+                await stopChannelAdapters(this.#routed);
+                if (!started.value)
+                    return;
+                await stopAdapters(this.#bound);
+                started.value = false;
+            },
+        };
+        return instance;
+    }
+    #assertComplete() {
+        const requiredPorts = new Map();
+        const requiredCatalogs = new Map();
+        const requiredChannels = new Map();
+        for (const ctor of Object.values(this.#useCases)) {
+            const ports = (ctor.ports ?? {});
+            for (const token of Object.values(ports)) {
+                const rec = requiredPorts.get(token.key) ?? { token, usedBy: [] };
+                rec.usedBy.push(ctor.key);
+                requiredPorts.set(token.key, rec);
+            }
+            const catalogs = [
+                ...(ctor.publishes ?? []),
+                ...('catalog' in ctor && ctor.catalog ? [ctor.catalog] : []),
+            ];
+            for (const catalog of catalogs) {
+                const rec = requiredCatalogs.get(catalog.key) ?? {
+                    catalog,
+                    usedBy: [],
+                };
+                rec.usedBy.push(ctor.key);
+                requiredCatalogs.set(catalog.key, rec);
+            }
+            for (const channel of ctor.channels ?? []) {
+                const rec = requiredChannels.get(channel.catalog.key) ?? {
+                    ctor: channel,
+                    usedBy: [],
+                };
+                rec.usedBy.push(ctor.key);
+                requiredChannels.set(channel.catalog.key, rec);
+            }
+        }
+        for (const routed of this.#routed.values()) {
+            const ports = (routed.ctor.ports ?? {});
+            for (const token of Object.values(ports)) {
+                const rec = requiredPorts.get(token.key) ?? {
+                    token,
+                    usedBy: [],
+                };
+                rec.usedBy.push(routed.ctor.catalog.key);
+                requiredPorts.set(token.key, rec);
+            }
+            const catalog = routed.ctor.catalog;
+            const rec = requiredCatalogs.get(catalog.key) ?? {
+                catalog,
+                usedBy: [],
+            };
+            rec.usedBy.push('channel');
+            requiredCatalogs.set(catalog.key, rec);
+        }
+        for (const { token, usedBy } of requiredPorts.values()) {
+            if (!this.#provided.has(token)) {
+                throw new Error(`hexok: unprovided port "${token.key}" (used by ${usedBy.join(', ')})`);
+            }
+        }
+        for (const { catalog, usedBy } of requiredCatalogs.values()) {
+            if (!this.#bound.has(catalog)) {
+                throw new Error(`hexok: unbound catalog "${catalog.key}" (used by ${usedBy.join(', ')})`);
+            }
+        }
+        for (const { ctor, usedBy } of requiredChannels.values()) {
+            if (!this.#routed.has(ctor.catalog)) {
+                throw new Error(`hexok: unrouted channel "${ctor.catalog.key}" (used by ${usedBy.join(', ')}). Call .route(...) before .build()`);
+            }
+        }
+    }
+}
+/**
+ * Composition root. `build()` is only callable when every required port
+ * and event catalog is provided.
+ *
+ * ```ts
+ * const app = App.from({ close: CloseIncident })
+ *   .provide(IncidentRepository, repo)
+ *   .provide(Clock, clock)
+ *   .bind(DomainEvents, bus)
+ *   .build()
+ * await app.local.incident.close({ id: '1' })
+ * ```
+ */
+export const App = {
+    /** Start composition from a map of use-case classes. */
+    from: AppBuilder.from,
+};
+function nestedContract(catalog) {
+    return nestByKey(Object.entries(catalog.entries));
+}
+//# sourceMappingURL=app.js.map

package/dist/runtime/app.js.map

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

package/dist/runtime/channel.d.ts

@@ -0,0 +1,34 @@
+import type { ChannelControl, ChannelSession, EventChannelCtor } from '../app/index.js';
+import { type Infer, type StandardSchemaV1 } from '../core/index.js';
+import type { AnyEventCatalog, ChannelAdapter, ChannelConnection, Envelope, EventAdapter, EventCatalog, PortToken } from '../domain/index.js';
+/** Presence handle for one routed channel: join, list, eject, refresh, update. */
+export type ChannelGateway<C extends EventChannelCtor> = ChannelControl<ChannelSession<C>> & {
+    /** Admit a connection after validating `joinInput`. Routing of events starts on `app.start()`. */
+    join(input: C extends {
+        joinInput: infer S extends StandardSchemaV1;
+    } ? Infer<S> : unknown, connection: ChannelConnection): Promise<ChannelSession<C>>;
+};
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+/** Routed channel gateways keyed by catalog key (`app.channels.client`). */
+export type ChannelGateways<Routed> = [Routed] extends [never] ? Record<string, never> : UnionToIntersection<Routed extends infer C ? C extends EventChannelCtor ? C extends {
+    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
+} ? {
+    [P in K]: ChannelGateway<C>;
+} : never : never : never>;
+export type RoutedChannel = {
+    ctor: EventChannelCtor;
+    instance: {
+        join(ctx: never): Promise<unknown>;
+        refresh(ctx: never): Promise<unknown>;
+        route(ctx: never): Promise<void>;
+    };
+    adapter: ChannelAdapter<unknown>;
+    ports: Record<string, unknown>;
+};
+export declare function serializeChannelEnvelope(envelope: Envelope): string;
+export declare function createChannelHandle(ctor: EventChannelCtor, instance: RoutedChannel['instance'], adapter: ChannelAdapter<unknown>, ports: Record<string, unknown>): ChannelGateway<EventChannelCtor>;
+export declare function startChannels(routed: Map<AnyEventCatalog, RoutedChannel>, bound: Map<AnyEventCatalog, EventAdapter>): void;
+export declare function stopChannelAdapters(routed: Map<AnyEventCatalog, RoutedChannel>): Promise<void>;
+export declare function resolveChannelPorts(ctor: EventChannelCtor, provided: Map<PortToken<unknown>, unknown>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=channel.d.ts.map

package/dist/runtime/channel.d.ts.map

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

package/dist/runtime/channel.js

@@ -0,0 +1,110 @@
+import { errorFactories } from '../app/error-factory.js';
+import { CodedError, validate, } from '../core/index.js';
+import { aliasPorts } from './invoke.js';
+export function serializeChannelEnvelope(envelope) {
+    return JSON.stringify({
+        key: envelope.key,
+        catalog: envelope.catalog,
+        payload: envelope.payload,
+        occurredAt: envelope.occurredAt,
+    });
+}
+export function createChannelHandle(ctor, instance, adapter, ports) {
+    const errors = errorFactories(ctor.errors ?? {});
+    const refreshOne = async (id, session) => {
+        const next = await instance.refresh({
+            session,
+            ports,
+            errors,
+        });
+        if (next === 'eject') {
+            adapter.eject(id);
+            return;
+        }
+        adapter.update(id, next);
+    };
+    return {
+        list: () => adapter.list(),
+        eject: (id) => {
+            adapter.eject(id);
+        },
+        ejectWhere: (pred) => {
+            for (const { id, session } of [...adapter.list()]) {
+                if (pred(session))
+                    adapter.eject(id);
+            }
+        },
+        refresh: async (id) => {
+            const row = adapter.list().find((item) => item.id === id);
+            if (!row)
+                return;
+            await refreshOne(id, row.session);
+        },
+        refreshWhere: async (pred) => {
+            for (const { id, session } of [...adapter.list()]) {
+                if (pred(session))
+                    await refreshOne(id, session);
+            }
+        },
+        update: (id, session) => {
+            adapter.update(id, session);
+        },
+        join: async (input, connection) => {
+            const parsed = validate(ctor.joinInput, input);
+            if (!parsed.ok) {
+                throw new CodedError({
+                    code: 'VALIDATION',
+                    message: 'Validation failed',
+                });
+            }
+            const session = await instance.join({
+                input: parsed.value,
+                ports,
+                errors,
+            });
+            const id = crypto.randomUUID();
+            adapter.join(id, session, connection);
+            connection.addEventListener('close', () => {
+                adapter.leave(id);
+            });
+            return session;
+        },
+    };
+}
+export function startChannels(routed, bound) {
+    for (const [catalog, { instance, adapter, ports }] of routed) {
+        const eventAdapter = bound.get(catalog);
+        if (eventAdapter?.kind !== 'bus') {
+            throw new Error(`hexok: channel catalog "${catalog.key}" must be bound as a bus`);
+        }
+        const bus = eventAdapter;
+        for (const eventClass of catalog.list()) {
+            bus.subscribe(eventClass.key, async (envelope) => {
+                const payload = serializeChannelEnvelope(envelope);
+                await instance.route({
+                    event: envelope,
+                    ctx: envelope.ctx,
+                    clients: adapter.list(),
+                    ports,
+                    send: async (id) => {
+                        try {
+                            adapter.send(id, payload);
+                        }
+                        catch {
+                            adapter.leave(id);
+                        }
+                    },
+                });
+            });
+        }
+    }
+}
+export async function stopChannelAdapters(routed) {
+    for (const { adapter } of routed.values()) {
+        await adapter.stop?.();
+    }
+}
+export function resolveChannelPorts(ctor, provided) {
+    return aliasPorts(ctor.ports ?? {}, provided);
+}
+//# sourceMappingURL=channel.js.map

package/dist/runtime/channel.js.map

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

package/dist/runtime/client.d.ts

@@ -0,0 +1,21 @@
+import type { UseCaseBag } from '../app/index.js';
+import type { PathTo, UnionToIntersection } from '../app/nest.js';
+import type { Infer, StandardSchemaV1 } from '../core/index.js';
+type ExternalCall<C, Ctx> = C extends {
+    input: infer Input extends StandardSchemaV1;
+    output: infer Output extends StandardSchemaV1;
+} ? (input: Infer<Input>, opts?: {
+    ctx?: Ctx;
+    signal?: AbortSignal;
+}) => Promise<Infer<Output>> : never;
+/**
+ * In-process client nested by use-case key. Event and internal use cases are omitted.
+ */
+export type NestedClient<Bag extends UseCaseBag, Ctx> = UnionToIntersection<{
+    [K in keyof Bag]: Bag[K] extends {
+        trigger: 'external';
+        key: infer Id extends string;
+    } ? PathTo<Id, ExternalCall<Bag[K], Ctx>> : never;
+}[keyof Bag]>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/runtime/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/runtime/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,KAAK,YAAY,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS;IACpC,KAAK,EAAE,MAAM,KAAK,SAAS,gBAAgB,CAAC;IAC5C,MAAM,EAAE,MAAM,MAAM,SAAS,gBAAgB,CAAC;CAC/C,GACG,CACE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EACnB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KACvC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAC3B,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,GAAG,SAAS,UAAU,EAAE,GAAG,IAAI,mBAAmB,CACzE;KACG,CAAC,IAAI,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS;QAC/B,OAAO,EAAE,UAAU,CAAC;QACpB,GAAG,EAAE,MAAM,EAAE,SAAS,MAAM,CAAC;KAC9B,GACG,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GACrC,KAAK;CACV,CAAC,MAAM,GAAG,CAAC,CACb,CAAC"}

package/dist/runtime/client.js

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

package/dist/runtime/client.js.map

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

package/dist/runtime/completeness.d.ts

@@ -0,0 +1,89 @@
+import type { UseCaseBag } from '../app/index.js';
+import type { EventCatalog } from '../domain/index.js';
+export type RequiredPorts<Bag extends UseCaseBag, Routed = never> = {
+    [K in keyof Bag]: Bag[K] extends {
+        ports: infer P;
+    } ? P[keyof P] : never;
+}[keyof Bag] | ChannelPorts<Routed>;
+type ChannelPorts<Routed> = Routed extends {
+    ports: infer P;
+} ? P[keyof P] : never;
+export type RequiredCatalogs<Bag extends UseCaseBag, Routed = never> = {
+    [K in keyof Bag]: (Bag[K] extends {
+        publishes: readonly (infer C)[];
+    } ? C : never) | (Bag[K] extends {
+        catalog: infer C;
+    } ? C : never);
+}[keyof Bag] | ChannelCatalogs<Routed>;
+type ChannelCatalogs<Routed> = Routed extends {
+    catalog: infer C;
+} ? C : never;
+type RequiredChannels<Bag extends UseCaseBag> = {
+    [K in keyof Bag]: Bag[K] extends {
+        channels: readonly (infer Ch)[];
+    } ? Ch : never;
+}[keyof Bag];
+type UsedByPort<Bag extends UseCaseBag, Routed, Token> = {
+    [K in keyof Bag]: Bag[K] extends {
+        ports: infer P;
+        key: infer Id extends string;
+    } ? Token extends P[keyof P] ? Id : never : never;
+}[keyof Bag] | ChannelUsedByPort<Routed, Token>;
+type ChannelUsedByPort<Routed, Token> = Routed extends {
+    ports: infer P;
+    catalog: EventCatalog<infer Key extends string>;
+} ? Token extends P[keyof P] ? Key : never : never;
+type UsedByCatalog<Bag extends UseCaseBag, Routed, Cat> = {
+    [K in keyof Bag]: Bag[K] extends {
+        key: infer Id extends string;
+    } ? (Bag[K] extends {
+        publishes: readonly (infer C)[];
+    } ? Cat extends C ? Id : never : never) | (Bag[K] extends {
+        catalog: infer C;
+    } ? Cat extends C ? Id : never : never) : never;
+}[keyof Bag] | ChannelUsedByCatalog<Routed, Cat>;
+type ChannelUsedByCatalog<Routed, Cat> = Routed extends {
+    catalog: infer C;
+} ? Cat extends C ? 'channel' : never : never;
+type UsedByChannel<Bag extends UseCaseBag, Ch> = {
+    [K in keyof Bag]: Bag[K] extends {
+        channels: readonly (infer C)[];
+        key: infer Id extends string;
+    } ? Ch extends C ? Id : never : never;
+}[keyof Bag];
+type PortAlias<Bag extends UseCaseBag, Routed, Token> = {
+    [K in keyof Bag]: Bag[K] extends {
+        ports: infer P;
+    } ? {
+        [A in keyof P]: [P[A]] extends [Token] ? [Token] extends [P[A]] ? A & string : never : never;
+    }[keyof P] : never;
+}[keyof Bag] | ChannelPortAlias<Routed, Token>;
+type ChannelPortAlias<Routed, Token> = Routed extends {
+    ports: infer P;
+} ? {
+    [A in keyof P]: [P[A]] extends [Token] ? [Token] extends [P[A]] ? A & string : never : never;
+}[keyof P] : never;
+type PortDisplayName<Bag extends UseCaseBag, Routed, Token> = JoinUnion<PortAlias<Bag, Routed, Token>>;
+type CatalogKeyOf<T> = T extends EventCatalog<infer Key extends string, infer _Kind, infer _Events, infer _Ctx> ? Key : 'unknown';
+type CatalogKeyOfChannel<T> = T extends {
+    catalog: EventCatalog<infer Key extends string, infer _Kind, infer _Events, infer _Ctx>;
+} ? Key : 'unknown';
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type LastOf<U> = UnionToIntersection<U extends unknown ? (x: U) => void : never> extends (x: infer L) => void ? L : never;
+/** Collapse `'a' | 'b'` into `'a, b'` so one missing port is one message. */
+type JoinUnion<U extends string> = [U] extends [never] ? never : LastOf<U> extends infer L extends string ? Exclude<U, L> extends infer Rest extends string ? [Rest] extends [never] ? L : `${JoinUnion<Rest>}, ${L}` : L : never;
+type MissingPortMessages<Bag extends UseCaseBag, Provided, Routed> = Exclude<RequiredPorts<Bag, Routed>, Provided> extends infer T ? T extends unknown ? `hexok: unprovided port "${PortDisplayName<Bag, Routed, T>}" (used by ${JoinUnion<UsedByPort<Bag, Routed, T>>}). Call .provide(token, impl) before .build()` : never : never;
+type MissingCatalogMessages<Bag extends UseCaseBag, Bound, Routed> = Exclude<RequiredCatalogs<Bag, Routed>, Bound> extends infer T ? T extends unknown ? `hexok: unbound catalog "${CatalogKeyOf<T>}" (used by ${JoinUnion<UsedByCatalog<Bag, Routed, T>>}). Call .bind(...) before .build()` : never : never;
+type MissingChannelMessages<Bag extends UseCaseBag, Routed> = Exclude<RequiredChannels<Bag>, Routed> extends infer T ? T extends unknown ? `hexok: unrouted channel "${CatalogKeyOfChannel<T>}" (used by ${JoinUnion<UsedByChannel<Bag, T>>}). Call .route(...) before .build()` : never : never;
+/** Compile-time type of `build` when a required port, catalog, or channel is still missing. */
+export type MissingMessages<Bag extends UseCaseBag, Provided, Bound, Routed = never> = MissingPortMessages<Bag, Provided, Routed> | MissingCatalogMessages<Bag, Bound, Routed> | MissingChannelMessages<Bag, Routed>;
+/** Compile-time error when `provide` is called twice for the same token. */
+export type DuplicatePortError = `hexok: port already provided`;
+/** Compile-time error when `bind` is called twice for the same catalog. */
+export type DuplicateCatalogError<N extends string = string> = string extends N ? `hexok: catalog already bound` : `hexok: catalog "${N}" already bound`;
+/** Compile-time error when `route` is called twice for the same channel catalog. */
+export type DuplicateChannelError<N extends string = string> = string extends N ? `hexok: channel already routed` : `hexok: catalog "${N}" already routed`;
+/** Compile-time error when `route` is given a catalog that is not a bus. */
+export type ChannelKindError<Key extends string = string, Kind extends string = string> = `hexok: channel catalog "${Key}" is kind "${Kind}". Channels require a bus catalog.`;
+export {};
+//# sourceMappingURL=completeness.d.ts.map

package/dist/runtime/completeness.d.ts.map

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

package/dist/runtime/completeness.js

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

package/dist/runtime/completeness.js.map

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

package/dist/runtime/envelope.d.ts

@@ -0,0 +1,7 @@
+import type { AnyEventCatalog, DomainEvent, Envelope } from '../domain/index.js';
+export declare function isEnvelope(value: unknown): value is Envelope;
+/** Wrap a domain event in an envelope, or pass an envelope through. The event must belong to one of `catalogs`. */
+export declare function wrapEvent(event: DomainEvent | Envelope, catalogs: readonly AnyEventCatalog[], requestCtx?: unknown): Envelope;
+/** Request ctx plus `correlationId` inherited from an incoming envelope when ctx omits it. */
+export declare function tracingCtx(requestCtx: unknown, incoming?: Envelope): unknown;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/runtime/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/runtime/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EAET,MAAM,oBAAoB,CAAC;AAE5B,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAU5D;AAED,mHAAmH;AACnH,wBAAgB,SAAS,CACvB,KAAK,EAAE,WAAW,GAAG,QAAQ,EAC7B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,UAAU,CAAC,EAAE,OAAO,GACnB,QAAQ,CA4BV;AA8BD,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAc5E"}