hexok 1.0.0

package/dist/app/event-use-case.js

@@ -0,0 +1,54 @@
+import { CodedError } from '../core/index.js';
+/**
+ * Event handler. Mutually exclusive with ExternalUseCase and InternalUseCase.
+ * Queue catalogs require `static group`.
+ *
+ * ```ts
+ * class NotifyOnClose extends EventUseCase {
+ *   static readonly key = 'incident.notifyOnClose'
+ *   static readonly on = IncidentClosed
+ *   static readonly catalog = DomainEvents
+ *   async execute({ event, ports }: EventCtx<typeof NotifyOnClose>) {
+ *     await ports.notifier.send(event.payload)
+ *   }
+ * }
+ * ```
+ */
+export class EventUseCase {
+    /** Discriminator for `App.from` / `isEventUseCase`. Do not override. */
+    static trigger = 'event';
+    /** Handler id (`incident.notifyOnClose`). Used in completeness messages. */
+    static key;
+    /** Event class this handler listens to. Required by `App.from`; must be in `catalog`. */
+    static on;
+    /** Catalog that owns `on`. Required by `App.from`; bind it with `App.bind`. */
+    static catalog;
+    /** Port tokens keyed by the alias used in `execute`. */
+    static ports;
+    /** Consumer group for queue catalogs. Required when `catalog.kind` is `'queue'`. */
+    static group;
+    /** `static publishes = [DomainEvents] as const` — without `as const`, Events widens to EventClass. */
+    static publishes;
+    /** `static channels = [ClientChannel] as const` — without `as const`, catalog keys widen. */
+    static channels;
+    /** Declared refusals. Keys become `errors.CODE()` factories on `EventCtx`. */
+    static errors = {};
+    constructor() { }
+    /**
+     * Same one-liner as `if (!result.ok) throw new CodedError({ code: result.code })`.
+     * For `validate` / custom Results. Entity methods throw themselves.
+     */
+    unwrap(result) {
+        if (!result.ok) {
+            throw new CodedError({
+                code: result.code,
+                message: result.code,
+                ...(result.issues !== undefined
+                    ? { data: { issues: result.issues } }
+                    : {}),
+            });
+        }
+        return result.value;
+    }
+}
+//# sourceMappingURL=event-use-case.js.map

package/dist/app/event-use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-use-case.js","sourceRoot":"","sources":["../../src/app/event-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAQ1E;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,YAAY;IAChC,wEAAwE;IACxE,MAAM,CAAU,OAAO,GAAG,OAAgB,CAAC;IAC3C,4EAA4E;IAC5E,MAAM,CAAU,GAAG,CAAS;IAC5B,yFAAyF;IACzF,MAAM,CAAU,EAAE,CAAc;IAChC,+EAA+E;IAC/E,MAAM,CAAU,OAAO,CAAmB;IAC1C,wDAAwD;IACxD,MAAM,CAAU,KAAK,CAAsC;IAC3D,oFAAoF;IACpF,MAAM,CAAU,KAAK,CAAU;IAC/B,sGAAsG;IACtG,MAAM,CAAU,SAAS,CAA8B;IACvD,6FAA6F;IAC7F,MAAM,CAAU,QAAQ,CAA+B;IACvD,8EAA8E;IAC9E,MAAM,CAAU,MAAM,GAAa,EAAE,CAAC;IAEtC,gBAAyB,CAAC;IAK1B;;;OAGG;IACH,MAAM,CAAsB,MAAoB;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,IAAI;gBACpB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS;oBAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE;oBACrC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC"}

package/dist/app/execute-ctx.d.ts

@@ -0,0 +1,92 @@
+import type { Infer, Result, StandardSchemaV1 } from '../core/index.js';
+import type { CatalogEvents, DomainEvent, Envelope, EventCatalog, EventClass, EventPayload } from '../domain/index.js';
+import type { ChannelProps } from './event-channel.js';
+import type { CallableUseCaseCtor, ErrorFactories, ResolvedPorts } from './types.js';
+/**
+ * `publish` **enqueues**. The runtime flushes only if `execute` returns.
+ * A throw drops the queue — publish after success, not a coincidence.
+ */
+export type Publish = {
+    (event: DomainEvent): void;
+    (envelope: Envelope): void;
+};
+type AllowedEventInstance<C> = C extends {
+    publishes: readonly (infer Cat)[];
+} ? CatalogEvents<Cat> extends infer E ? [E] extends [never] ? never : InstanceType<Extract<E, EventClass>> : never : DomainEvent;
+/** `publish` when `static publishes` is declared — only those catalog events. */
+export type PublishFor<C> = (event: AllowedEventInstance<C>) => void;
+/** Nested callable invocation. Shares ctx, signal, and the parent publish queue. */
+export type Run = <U extends CallableUseCaseCtor>(useCase: U, input: Infer<U['input']>) => Promise<Infer<U['output']>>;
+/** Argument to `ExternalUseCase.execute` and `InternalUseCase.execute`. Typed from the subclass statics. */
+export type ExecuteCtx<C, Ctx = unknown> = {
+    /** Validated `static input`. */
+    input: C extends {
+        input: infer S extends StandardSchemaV1;
+    } ? Infer<S> : unknown;
+    /** Bound adapters from `static ports`. */
+    ports: C extends {
+        ports: infer P;
+    } ? ResolvedPorts<P> : Record<string, never>;
+    /** App request context from `App.ctx` or the caller. */
+    ctx: Ctx;
+    /** Factories from `static errors`. Throw `errors.NOT_FOUND()`. */
+    errors: C extends {
+        errors: infer E;
+    } ? ErrorFactories<E> : ErrorFactories<never>;
+    /** Abort signal for this invocation. */
+    signal: AbortSignal;
+    /** Enqueue a catalog event. Flushed only if `execute` returns. */
+    publish: C extends {
+        publishes: readonly unknown[];
+    } ? PublishFor<C> : Publish;
+    /** Invoke an ExternalUseCase or InternalUseCase with the same ctx, signal, and publish queue. */
+    run: Run;
+    /** Presence handles for `static channels`, keyed by catalog key. */
+    channels: ChannelProps<C>;
+};
+type EventOn<C> = C extends {
+    on: infer E extends EventClass;
+} ? E : EventClass;
+type CatalogKeyOf<C> = C extends {
+    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
+} ? K : string;
+type CatalogKindOf<C> = C extends {
+    catalog: EventCatalog<string, infer Kind, infer _E, infer _Ctx>;
+} ? Kind : 'bus';
+type CatalogCtxOf<C> = C extends {
+    catalog: EventCatalog<string, infer _Kind, infer _E, infer Ctx>;
+} ? Ctx : unknown;
+/** Argument to `EventUseCase.execute`. Typed from the subclass statics. */
+export type EventCtx<C, Ctx = unknown> = {
+    /** Envelope for `static on`, including payload and catalog metadata. */
+    event: Envelope<EventOn<C>['key'] extends infer N extends string ? N : string, EventPayload<EventOn<C>>, CatalogKeyOf<C>, CatalogKindOf<C>, CatalogCtxOf<C>>;
+    /** Bound adapters from `static ports`. */
+    ports: C extends {
+        ports: infer P;
+    } ? ResolvedPorts<P> : Record<string, never>;
+    /** App request context from `App.ctx` or the caller. */
+    ctx: Ctx;
+    /** Factories from `static errors`. Throw `errors.NOT_FOUND()`. */
+    errors: C extends {
+        errors: infer E;
+    } ? ErrorFactories<E> : ErrorFactories<never>;
+    /** Abort signal for this invocation. */
+    signal: AbortSignal;
+    /** Enqueue a catalog event. Flushed only if `execute` returns. */
+    publish: C extends {
+        publishes: readonly unknown[];
+    } ? PublishFor<C> : Publish;
+    /** Invoke an ExternalUseCase or InternalUseCase with the same ctx, signal, and publish queue. */
+    run: Run;
+    /** Presence handles for `static channels`, keyed by catalog key. */
+    channels: ChannelProps<C>;
+} & (CatalogKindOf<C> extends 'queue' ? {
+    /** Delivery attempt, 1-based, for queue catalogs. */
+    attempt: number;
+} : {
+    /** Unset for bus catalogs. */
+    attempt?: number;
+});
+export type Unwrap = <T, E extends string>(result: Result<T, E>) => T;
+export {};
+//# sourceMappingURL=execute-ctx.d.ts.map

package/dist/app/execute-ctx.d.ts.map

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

package/dist/app/execute-ctx.js

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

package/dist/app/execute-ctx.js.map

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

package/dist/app/external-use-case.d.ts

@@ -0,0 +1,25 @@
+import { CallableUseCase } from './callable-use-case.js';
+/**
+ * Public request/response use case. Declare static `key`, `input`, `output`,
+ * `errors`, `ports`. Implement `execute`.
+ *
+ * ```ts
+ * class CloseIncident extends ExternalUseCase {
+ *   static readonly key = 'incident.close'
+ *   static readonly input = z.object({ id: z.string() })
+ *   static readonly output = Incident.schema
+ *   static readonly errors = { NOT_FOUND: { message: 'Incident not found' } } as const
+ *   static readonly ports = { incidents: IncidentRepository }
+ *   async execute({ input, ports, errors }: ExecuteCtx<typeof CloseIncident>) {
+ *     const incident = await ports.incidents.get(input.id)
+ *     if (!incident) throw errors.NOT_FOUND()
+ *     return incident.toProps()
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class ExternalUseCase extends CallableUseCase {
+    /** Discriminator for `App.from` / `isExternalUseCase`. Do not override. */
+    static readonly trigger: "external";
+}
+//# sourceMappingURL=external-use-case.d.ts.map

package/dist/app/external-use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-use-case.d.ts","sourceRoot":"","sources":["../../src/app/external-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,eAAgB,SAAQ,eAAe;IAC3D,2EAA2E;IAC3E,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,UAAU,CAAU;CAC/C"}

package/dist/app/external-use-case.js

@@ -0,0 +1,25 @@
+import { CallableUseCase } from './callable-use-case.js';
+/**
+ * Public request/response use case. Declare static `key`, `input`, `output`,
+ * `errors`, `ports`. Implement `execute`.
+ *
+ * ```ts
+ * class CloseIncident extends ExternalUseCase {
+ *   static readonly key = 'incident.close'
+ *   static readonly input = z.object({ id: z.string() })
+ *   static readonly output = Incident.schema
+ *   static readonly errors = { NOT_FOUND: { message: 'Incident not found' } } as const
+ *   static readonly ports = { incidents: IncidentRepository }
+ *   async execute({ input, ports, errors }: ExecuteCtx<typeof CloseIncident>) {
+ *     const incident = await ports.incidents.get(input.id)
+ *     if (!incident) throw errors.NOT_FOUND()
+ *     return incident.toProps()
+ *   }
+ * }
+ * ```
+ */
+export class ExternalUseCase extends CallableUseCase {
+    /** Discriminator for `App.from` / `isExternalUseCase`. Do not override. */
+    static trigger = 'external';
+}
+//# sourceMappingURL=external-use-case.js.map

package/dist/app/external-use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-use-case.js","sourceRoot":"","sources":["../../src/app/external-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAgB,eAAgB,SAAQ,eAAe;IAC3D,2EAA2E;IAC3E,MAAM,CAAU,OAAO,GAAG,UAAmB,CAAC"}

package/dist/app/index.d.ts

@@ -0,0 +1,9 @@
+export { type CatalogEntry, type DerivedContract, deriveContract, nestByKey, type UseCaseContract, } from './contract.js';
+export { errorFactories } from './error-factory.js';
+export { type ChannelControl, type ChannelProps, type ChannelSession, EventChannel, type JoinCtx, type RefreshCtx, type RouteCtx, } from './event-channel.js';
+export { EventUseCase } from './event-use-case.js';
+export type { EventCtx, ExecuteCtx, Publish, PublishFor, Run, } from './execute-ctx.js';
+export { ExternalUseCase } from './external-use-case.js';
+export { InternalUseCase } from './internal-use-case.js';
+export { type AsUseCaseBag, type CallableUseCaseCtor, type CheckUseCase, type ErrorFactories, type EventChannelCtor, type EventUseCaseCtor, type ExternalUseCaseCtor, type InternalUseCaseCtor, isCallableUseCase, isEventUseCase, isExternalUseCase, isInternalUseCase, type ResolvedPorts, type UseCaseBag, type UseCaseClass, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,cAAc,EACd,SAAS,EACT,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,QAAQ,EACR,UAAU,EACV,OAAO,EACP,UAAU,EACV,GAAG,GACJ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC"}

package/dist/app/index.js

@@ -0,0 +1,8 @@
+export { deriveContract, nestByKey, } from './contract.js';
+export { errorFactories } from './error-factory.js';
+export { EventChannel, } from './event-channel.js';
+export { EventUseCase } from './event-use-case.js';
+export { ExternalUseCase } from './external-use-case.js';
+export { InternalUseCase } from './internal-use-case.js';
+export { isCallableUseCase, isEventUseCase, isExternalUseCase, isInternalUseCase, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACd,SAAS,GAEV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAIL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EASL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,YAAY,CAAC"}

package/dist/app/internal-use-case.d.ts

@@ -0,0 +1,26 @@
+import { CallableUseCase } from './callable-use-case.js';
+/**
+ * Composition-only request/response use case. Same execute shape as
+ * ExternalUseCase. Omitted from `deriveContract`, `app.contract`, `app.local`,
+ * and HTTP. Still in completeness. Invocable via `ctx.run`.
+ *
+ * ```ts
+ * class CreateUser extends InternalUseCase {
+ *   static readonly key = 'user.create'
+ *   static readonly input = z.object({ id: z.string(), name: z.string() })
+ *   static readonly output = z.object({ id: z.string() })
+ *   static readonly errors = { USER_EXISTS: { message: 'User already exists' } } as const
+ *   static readonly ports = { users: UserRepository }
+ *   async execute({ input, ports, errors }: ExecuteCtx<typeof CreateUser>) {
+ *     if (await ports.users.getUser(input.id)) throw errors.USER_EXISTS()
+ *     await ports.users.saveUser(input)
+ *     return { id: input.id }
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class InternalUseCase extends CallableUseCase {
+    /** Discriminator for `App.from` / `isInternalUseCase`. Do not override. */
+    static readonly trigger: "internal";
+}
+//# sourceMappingURL=internal-use-case.d.ts.map

package/dist/app/internal-use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-use-case.d.ts","sourceRoot":"","sources":["../../src/app/internal-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,eAAgB,SAAQ,eAAe;IAC3D,2EAA2E;IAC3E,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,UAAU,CAAU;CAC/C"}

package/dist/app/internal-use-case.js

@@ -0,0 +1,26 @@
+import { CallableUseCase } from './callable-use-case.js';
+/**
+ * Composition-only request/response use case. Same execute shape as
+ * ExternalUseCase. Omitted from `deriveContract`, `app.contract`, `app.local`,
+ * and HTTP. Still in completeness. Invocable via `ctx.run`.
+ *
+ * ```ts
+ * class CreateUser extends InternalUseCase {
+ *   static readonly key = 'user.create'
+ *   static readonly input = z.object({ id: z.string(), name: z.string() })
+ *   static readonly output = z.object({ id: z.string() })
+ *   static readonly errors = { USER_EXISTS: { message: 'User already exists' } } as const
+ *   static readonly ports = { users: UserRepository }
+ *   async execute({ input, ports, errors }: ExecuteCtx<typeof CreateUser>) {
+ *     if (await ports.users.getUser(input.id)) throw errors.USER_EXISTS()
+ *     await ports.users.saveUser(input)
+ *     return { id: input.id }
+ *   }
+ * }
+ * ```
+ */
+export class InternalUseCase extends CallableUseCase {
+    /** Discriminator for `App.from` / `isInternalUseCase`. Do not override. */
+    static trigger = 'internal';
+}
+//# sourceMappingURL=internal-use-case.js.map

package/dist/app/internal-use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-use-case.js","sourceRoot":"","sources":["../../src/app/internal-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAgB,eAAgB,SAAQ,eAAe;IAC3D,2EAA2E;IAC3E,MAAM,CAAU,OAAO,GAAG,UAAmB,CAAC"}

package/dist/app/nest.d.ts

@@ -0,0 +1,9 @@
+export type PathTo<Path extends string, V> = Path extends `${infer Head}.${infer Rest}` ? {
+    readonly [K in Head]: PathTo<Rest, V>;
+} : {
+    readonly [K in Path]: V;
+};
+export type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/** Nest dotted keys (`incident.close` → `{ incident: { close } }`). */
+export declare function nestByKey<V>(entries: Iterable<[string, V]>): Record<string, unknown>;
+//# sourceMappingURL=nest.d.ts.map

package/dist/app/nest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.d.ts","sourceRoot":"","sources":["../../src/app/nest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAChB,IAAI,SAAS,MAAM,EACnB,CAAC,IACC,IAAI,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GAC1C;IAAE,QAAQ,EAAE,CAAC,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;CAAE,GACzC;IAAE,QAAQ,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC;CAAE,CAAC;AAEhC,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CACnC,CAAC,SAAS,OAAO,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GACd,KAAK,CACV,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAC1B,CAAC,GACD,KAAK,CAAC;AAEV,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB"}

package/dist/app/nest.js

@@ -0,0 +1,28 @@
+/** Nest dotted keys (`incident.close` → `{ incident: { close } }`). */
+export function nestByKey(entries) {
+    const root = Object.create(null);
+    for (const [key, value] of entries) {
+        const parts = key.split('.');
+        let cursor = root;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            if (part === undefined)
+                continue;
+            const existing = cursor[part];
+            if (existing === undefined || typeof existing !== 'object') {
+                const next = Object.create(null);
+                cursor[part] = next;
+                cursor = next;
+            }
+            else {
+                cursor = existing;
+            }
+        }
+        const last = parts[parts.length - 1];
+        if (last === undefined)
+            continue;
+        cursor[last] = value;
+    }
+    return root;
+}
+//# sourceMappingURL=nest.js.map

package/dist/app/nest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.js","sourceRoot":"","sources":["../../src/app/nest.ts"],"names":[],"mappings":"AAeA,uEAAuE;AACvE,MAAM,UAAU,SAAS,CACvB,OAA8B;IAE9B,MAAM,IAAI,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAS;YACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC3D,MAAM,IAAI,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;gBACpB,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,QAAmC,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/app/types.d.ts

@@ -0,0 +1,153 @@
+import type { ErrorMap, Infer, StandardSchemaV1 } from '../core/index.js';
+import type { AnyEventCatalog, EventCatalog, EventClass, PortToken } from '../domain/index.js';
+/** Port map with tokens replaced by their bound implementations. */
+export type ResolvedPorts<P> = {
+    [K in keyof P]: P[K] extends PortToken<infer I> ? I : never;
+};
+/** `errors.CODE()` map. Each factory throws `CodedError` and types as `never`. */
+export type ErrorFactories<M> = {
+    [K in keyof M]: M[K] extends {
+        data: infer S;
+    } ? S extends StandardSchemaV1 ? (data: Infer<S>) => never : () => never : () => never;
+};
+type KeyOf<C> = C extends {
+    key: infer I extends string;
+} ? I : 'unknown';
+type OnInCatalog<C> = C extends {
+    key: infer Key extends string;
+    on: infer On;
+    catalog: EventCatalog<infer _K, infer _Kind, infer Events extends EventClass, infer _Ctx>;
+} ? [On] extends [Events] ? C : `hexok: EventUseCase "${Key}" static on is not in catalog` : C;
+type HasLiteralKey<C> = C extends {
+    key: infer K extends string;
+} ? string extends K ? false : true : false;
+type IsWideArray<T> = T extends readonly unknown[] ? number extends T['length'] ? true : false : false;
+type CheckAsConst<C, Field extends string, Kind extends string> = [C] extends [
+    string
+] ? C : Field extends keyof C ? undefined extends C[Field] ? C : IsWideArray<C[Field]> extends true ? `hexok: ${Kind} "${KeyOf<C>}" static ${Field} must be \`as const\`` : C : C;
+type CheckCallableShape<C, Kind extends string> = HasLiteralKey<C> extends false ? `hexok: ${Kind} "${KeyOf<C>}" is missing static key` : C extends {
+    input: StandardSchemaV1;
+} ? C extends {
+    output: StandardSchemaV1;
+} ? C extends {
+    ports: Record<string, PortToken<unknown>>;
+} ? C : `hexok: ${Kind} "${KeyOf<C>}" is missing static ports` : `hexok: ${Kind} "${KeyOf<C>}" is missing static output` : `hexok: ${Kind} "${KeyOf<C>}" is missing static input`;
+type CheckQueueGroup<C> = [C] extends [string] ? C : C extends {
+    catalog: {
+        kind: 'queue';
+    };
+} ? C extends {
+    group: string;
+} ? C : `hexok: EventUseCase "${KeyOf<C>}" is missing static group` : C;
+type CheckEventShape<C> = HasLiteralKey<C> extends false ? `hexok: EventUseCase "${KeyOf<C>}" is missing static key` : C extends {
+    on: {
+        readonly key: string;
+    };
+} ? C extends {
+    catalog: AnyEventCatalog;
+} ? CheckQueueGroup<OnInCatalog<C>> : `hexok: EventUseCase "${KeyOf<C>}" is missing static catalog` : `hexok: EventUseCase "${KeyOf<C>}" is missing static on`;
+/**
+ * Per-entry diagnostic for `App.from` / `App.test`. Missing statics become a
+ * `hexok:` sentence instead of a UseCaseClass union dump.
+ */
+export type CheckUseCase<C> = C extends {
+    trigger: 'external';
+} ? CheckAsConst<CheckAsConst<CheckCallableShape<C, 'ExternalUseCase'>, 'publishes', 'ExternalUseCase'>, 'channels', 'ExternalUseCase'> : C extends {
+    trigger: 'internal';
+} ? CheckAsConst<CheckAsConst<CheckCallableShape<C, 'InternalUseCase'>, 'publishes', 'InternalUseCase'>, 'channels', 'InternalUseCase'> : C extends {
+    trigger: 'event';
+} ? CheckAsConst<CheckAsConst<CheckEventShape<C>, 'publishes', 'EventUseCase'>, 'channels', 'EventUseCase'> : C extends {
+    trigger: 'api';
+} ? `hexok: ApiUseCase was renamed to ExternalUseCase; composition-only use cases extend InternalUseCase — delete static internal` : `hexok: "${KeyOf<C>}" must extend ExternalUseCase, InternalUseCase, or EventUseCase`;
+/** Named map of use-case classes passed to `App.from`. */
+export type UseCaseBag = Record<string, UseCaseClass>;
+/** Keep a checked bag's specific classes; do not intersect with UseCaseBag. */
+export type AsUseCaseBag<Bag> = Bag extends UseCaseBag ? Bag : UseCaseBag;
+/** An external, internal, or event use-case constructor. */
+export type UseCaseClass = ExternalUseCaseCtor | InternalUseCaseCtor | EventUseCaseCtor;
+/** Constructor shape of an ExternalUseCase or InternalUseCase subclass. */
+export interface CallableUseCaseCtor {
+    readonly trigger: 'external' | 'internal';
+    /** Use-case id (`incident.close`). Unique among the callable family. */
+    readonly key: string;
+    /** Request Standard Schema. */
+    readonly input: StandardSchemaV1;
+    /** Success Standard Schema. */
+    readonly output: StandardSchemaV1;
+    /** Declared refusals. */
+    readonly errors: ErrorMap;
+    /** Port tokens keyed by the alias used in `execute`. */
+    readonly ports: Record<string, PortToken<unknown>>;
+    /** Catalogs this use case may `publish` to. */
+    readonly publishes?: readonly AnyEventCatalog[];
+    /** Channels available as `channels` on execute ctx. */
+    readonly channels?: readonly EventChannelCtor[];
+    readonly prototype: {
+        execute(ctx: never): Promise<unknown>;
+    };
+}
+/** Constructor shape of an `ExternalUseCase` subclass. */
+export interface ExternalUseCaseCtor extends CallableUseCaseCtor {
+    readonly trigger: 'external';
+}
+/** Constructor shape of an `InternalUseCase` subclass. */
+export interface InternalUseCaseCtor extends CallableUseCaseCtor {
+    readonly trigger: 'internal';
+}
+export type ExternalKeyOf<C> = C extends {
+    trigger: 'external';
+    key: infer Key extends string;
+} ? Key : never;
+export type ExternalKeysOf<Bag> = {
+    [K in keyof Bag]: ExternalKeyOf<Bag[K]>;
+}[keyof Bag];
+/** Constructor shape of an `EventUseCase` subclass. */
+export interface EventUseCaseCtor {
+    readonly trigger: 'event';
+    /** Handler id (`incident.notifyOnClose`). */
+    readonly key: string;
+    /** Event class this handler listens to. Must be in `catalog`. */
+    readonly on: EventClass;
+    /** Catalog that owns `on`. Bind it with `App.bind`. */
+    readonly catalog: AnyEventCatalog;
+    /** Consumer group for queue catalogs. */
+    readonly group?: string;
+    /** Port tokens keyed by the alias used in `execute`. */
+    readonly ports?: Record<string, PortToken<unknown>>;
+    /** Catalogs this handler may `publish` to. */
+    readonly publishes?: readonly AnyEventCatalog[];
+    /** Channels available as `channels` on event ctx. */
+    readonly channels?: readonly EventChannelCtor[];
+    /** Declared refusals. */
+    readonly errors?: ErrorMap;
+    readonly prototype: {
+        execute(ctx: never): Promise<void>;
+    };
+}
+/** Constructor shape of an `EventChannel` subclass (`catalog`, `joinInput`, optional `ports`). */
+export interface EventChannelCtor {
+    readonly trigger: 'channel';
+    /** Catalog whose events this channel delivers. Must be a bus. */
+    readonly catalog: AnyEventCatalog;
+    /** Port tokens keyed by the alias used in join, refresh, and route. */
+    readonly ports?: Record<string, PortToken<unknown>>;
+    /** Join-claims Standard Schema. Validated before `join`. */
+    readonly joinInput: StandardSchemaV1;
+    /** Declared refusals for join/refresh. */
+    readonly errors?: ErrorMap;
+    readonly prototype: {
+        join(ctx: never): Promise<unknown>;
+        refresh(ctx: never): Promise<unknown>;
+        route(ctx: never): Promise<void>;
+    };
+}
+/** True when `ctor.trigger === 'event'`. */
+export declare function isEventUseCase(ctor: UseCaseClass): ctor is EventUseCaseCtor;
+/** True when `ctor.trigger === 'external'`. */
+export declare function isExternalUseCase(ctor: UseCaseClass): ctor is ExternalUseCaseCtor;
+/** True when `ctor.trigger === 'internal'`. */
+export declare function isInternalUseCase(ctor: UseCaseClass): ctor is InternalUseCaseCtor;
+/** True when `ctor.trigger` is `'external'` or `'internal'`. */
+export declare function isCallableUseCase(ctor: UseCaseClass): ctor is CallableUseCaseCtor;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/app/types.d.ts.map

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

package/dist/app/types.js

@@ -0,0 +1,17 @@
+/** True when `ctor.trigger === 'event'`. */
+export function isEventUseCase(ctor) {
+    return ctor.trigger === 'event';
+}
+/** True when `ctor.trigger === 'external'`. */
+export function isExternalUseCase(ctor) {
+    return ctor.trigger === 'external';
+}
+/** True when `ctor.trigger === 'internal'`. */
+export function isInternalUseCase(ctor) {
+    return ctor.trigger === 'internal';
+}
+/** True when `ctor.trigger` is `'external'` or `'internal'`. */
+export function isCallableUseCase(ctor) {
+    return ctor.trigger === 'external' || ctor.trigger === 'internal';
+}
+//# sourceMappingURL=types.js.map

package/dist/app/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/app/types.ts"],"names":[],"mappings":"AA0NA,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC;AAClC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,iBAAiB,CAC/B,IAAkB;IAElB,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,iBAAiB,CAC/B,IAAkB;IAElB,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAC/B,IAAkB;IAElB,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC;AACpE,CAAC"}

package/dist/core/coded-error.d.ts

@@ -0,0 +1,24 @@
+import type { StandardSchemaV1 } from './standard-schema.js';
+/**
+ * Thrown by entity refusals and use-case error factories.
+ * Carries `code`, optional `message`, and optional `data`.
+ *
+ * ```ts
+ * throw new CodedError({ code: 'NOT_FOUND', message: 'Incident not found' })
+ * ```
+ */
+export declare class CodedError<C extends string = string> extends Error {
+    /** Machine-readable refusal code. Catch and switch on this; a runtime transport may map it to a status. */
+    readonly code: C;
+    /** Optional payload. Set only when the constructor received `data`. */
+    readonly data?: unknown;
+    /** `message` defaults to `code`. */
+    constructor(args: {
+        code: C;
+        message?: string;
+        data?: unknown;
+    });
+}
+/** `VALIDATION` refusal. `data.issues` is the Standard Schema issue list when present. */
+export declare function validationError(message: string, issues?: readonly StandardSchemaV1.Issue[]): CodedError<'VALIDATION'>;
+//# sourceMappingURL=coded-error.d.ts.map

package/dist/core/coded-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coded-error.d.ts","sourceRoot":"","sources":["../../src/core/coded-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;GAOG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAC9D,2GAA2G;IAC3G,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAExB,oCAAoC;gBACxB,IAAI,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB;CAQF;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,GACzC,UAAU,CAAC,YAAY,CAAC,CAM1B"}

package/dist/core/coded-error.js

@@ -0,0 +1,32 @@
+/**
+ * Thrown by entity refusals and use-case error factories.
+ * Carries `code`, optional `message`, and optional `data`.
+ *
+ * ```ts
+ * throw new CodedError({ code: 'NOT_FOUND', message: 'Incident not found' })
+ * ```
+ */
+export class CodedError extends Error {
+    /** Machine-readable refusal code. Catch and switch on this; a runtime transport may map it to a status. */
+    code;
+    /** Optional payload. Set only when the constructor received `data`. */
+    data;
+    /** `message` defaults to `code`. */
+    constructor(args) {
+        super(args.message ?? args.code);
+        this.name = 'CodedError';
+        this.code = args.code;
+        if ('data' in args) {
+            this.data = args.data;
+        }
+    }
+}
+/** `VALIDATION` refusal. `data.issues` is the Standard Schema issue list when present. */
+export function validationError(message, issues) {
+    return new CodedError({
+        code: 'VALIDATION',
+        message,
+        ...(issues !== undefined ? { data: { issues } } : {}),
+    });
+}
+//# sourceMappingURL=coded-error.js.map

package/dist/core/coded-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coded-error.js","sourceRoot":"","sources":["../../src/core/coded-error.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,UAAsC,SAAQ,KAAK;IAC9D,2GAA2G;IAClG,IAAI,CAAI;IACjB,uEAAuE;IAC9D,IAAI,CAAW;IAExB,oCAAoC;IACpC,YAAY,IAIX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,MAA0C;IAE1C,OAAO,IAAI,UAAU,CAAC;QACpB,IAAI,EAAE,YAAY;QAClB,OAAO;QACP,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;AACL,CAAC"}