hexok 1.0.0

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

@@ -0,0 +1,52 @@
+import { type ErrorMap, type Result } from '../core/index.js';
+import type { AnyEventCatalog, PortToken } from '../domain/index.js';
+import type { EventChannelCtor } from './types.js';
+/**
+ * Request/response application use case. Declare static `key`, `input`, `output`, `errors`, `ports`.
+ *
+ * ```ts
+ * class CloseIncident extends ApiUseCase {
+ *   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 ApiUseCase {
+    /** Discriminator for `App.from` / `isApiUseCase`. Do not override. */
+    static readonly trigger: "api";
+    /** When true, omitted from contract, HTTP RPC, and `app.local`. Still in completeness. */
+    static readonly internal?: boolean;
+    /** Dotted RPC path (`incident.close`). Must be unique among API use cases. */
+    static readonly key: string;
+    /** Request Standard Schema. Validated before `execute`. */
+    static readonly input: unknown;
+    /** Success Standard Schema. Types `execute`, `run`, and the contract. */
+    static readonly output: unknown;
+    /** Declared refusals. Keys become `errors.CODE()` factories on `ExecuteCtx`. */
+    static readonly errors: ErrorMap;
+    /** Port tokens keyed by the alias used in `execute`. Required by `App.from`. */
+    static readonly ports?: Record<string, PortToken<unknown>>;
+    /** `static publishes = [DomainEvents] as const` — without `as const`, Events widens to EventClass. */
+    static readonly publishes?: readonly AnyEventCatalog[];
+    /** `static channels = [ClientChannel] as const` — without `as const`, catalog keys widen. */
+    static readonly channels?: readonly EventChannelCtor[];
+    /** RPC middleware for this use case, after app-level `App.use`. */
+    static readonly middleware?: readonly unknown[];
+    protected constructor();
+    /** Typed `never` so subclasses may take `ExecuteCtx` (tighter `publish`). */
+    abstract execute(ctx: never): Promise<unknown>;
+    /**
+     * Same one-liner as `if (!result.ok) throw new CodedError({ code: result.code })`.
+     * For `validate` / custom Results. Entity methods throw themselves.
+     */
+    unwrap<T, E extends string>(result: Result<T, E>): T;
+}
+//# sourceMappingURL=api-use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-use-case.d.ts","sourceRoot":"","sources":["../../src/app/api-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,UAAU;IAC9B,sEAAsE;IACtE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,KAAK,CAAU;IACzC,0FAA0F;IAC1F,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnC,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAC/B,yEAAyE;IACzE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAM;IACtC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,sGAAsG;IACtG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACvD,6FAA6F;IAC7F,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvD,mEAAmE;IACnE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAEhD,SAAS;IAET,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9C;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;CAYrD"}

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

@@ -0,0 +1,59 @@
+import { CodedError } from '../core/index.js';
+/**
+ * Request/response application use case. Declare static `key`, `input`, `output`, `errors`, `ports`.
+ *
+ * ```ts
+ * class CloseIncident extends ApiUseCase {
+ *   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 ApiUseCase {
+    /** Discriminator for `App.from` / `isApiUseCase`. Do not override. */
+    static trigger = 'api';
+    /** When true, omitted from contract, HTTP RPC, and `app.local`. Still in completeness. */
+    static internal;
+    /** Dotted RPC path (`incident.close`). Must be unique among API use cases. */
+    static key;
+    /** Request Standard Schema. Validated before `execute`. */
+    static input;
+    /** Success Standard Schema. Types `execute`, `run`, and the contract. */
+    static output;
+    /** Declared refusals. Keys become `errors.CODE()` factories on `ExecuteCtx`. */
+    static errors = {};
+    /** Port tokens keyed by the alias used in `execute`. Required by `App.from`. */
+    static ports;
+    /** `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;
+    /** RPC middleware for this use case, after app-level `App.use`. */
+    static middleware;
+    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=api-use-case.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-use-case.js","sourceRoot":"","sources":["../../src/app/api-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAI1E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,UAAU;IAC9B,sEAAsE;IACtE,MAAM,CAAU,OAAO,GAAG,KAAc,CAAC;IACzC,0FAA0F;IAC1F,MAAM,CAAU,QAAQ,CAAW;IACnC,8EAA8E;IAC9E,MAAM,CAAU,GAAG,CAAS;IAC5B,2DAA2D;IAC3D,MAAM,CAAU,KAAK,CAAU;IAC/B,yEAAyE;IACzE,MAAM,CAAU,MAAM,CAAU;IAChC,gFAAgF;IAChF,MAAM,CAAU,MAAM,GAAa,EAAE,CAAC;IACtC,gFAAgF;IAChF,MAAM,CAAU,KAAK,CAAsC;IAC3D,sGAAsG;IACtG,MAAM,CAAU,SAAS,CAA8B;IACvD,6FAA6F;IAC7F,MAAM,CAAU,QAAQ,CAA+B;IACvD,mEAAmE;IACnE,MAAM,CAAU,UAAU,CAAsB;IAEhD,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/callable-use-case.d.ts

@@ -0,0 +1,34 @@
+import { type ErrorMap, type Result } from '../core/index.js';
+import type { AnyEventCatalog, PortToken } from '../domain/index.js';
+import type { EventChannelCtor } from './types.js';
+/**
+ * Request/response base for ExternalUseCase and InternalUseCase.
+ * Do not declare `trigger` here — each sibling sets a distinct literal.
+ * Not re-exported from hexok/app; application authors extend ExternalUseCase
+ * or InternalUseCase.
+ */
+export declare abstract class CallableUseCase {
+    /** Use-case id (`incident.close`). Unique among the callable family. */
+    static readonly key: string;
+    /** Request Standard Schema. Validated before `execute`. */
+    static readonly input: unknown;
+    /** Success Standard Schema. Types `execute`, `run`, and the contract. */
+    static readonly output: unknown;
+    /** Declared refusals. Keys become `errors.CODE()` factories on `ExecuteCtx`. */
+    static readonly errors: ErrorMap;
+    /** Port tokens keyed by the alias used in `execute`. Required by `App.from`. */
+    static readonly ports?: Record<string, PortToken<unknown>>;
+    /** `static publishes = [DomainEvents] as const` — without `as const`, Events widens to EventClass. */
+    static readonly publishes?: readonly AnyEventCatalog[];
+    /** `static channels = [ClientChannel] as const` — without `as const`, catalog keys widen. */
+    static readonly channels?: readonly EventChannelCtor[];
+    protected constructor();
+    /** Typed `never` so subclasses may take `ExecuteCtx` (tighter `publish`). */
+    abstract execute(ctx: never): Promise<unknown>;
+    /**
+     * Same one-liner as `if (!result.ok) throw new CodedError({ code: result.code })`.
+     * For `validate` / custom Results. Entity methods throw themselves.
+     */
+    unwrap<T, E extends string>(result: Result<T, E>): T;
+}
+//# sourceMappingURL=callable-use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callable-use-case.d.ts","sourceRoot":"","sources":["../../src/app/callable-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,8BAAsB,eAAe;IACnC,wEAAwE;IACxE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAC/B,yEAAyE;IACzE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAM;IACtC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,sGAAsG;IACtG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACvD,6FAA6F;IAC7F,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAEvD,SAAS;IAET,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9C;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;CAYrD"}

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

@@ -0,0 +1,41 @@
+import { CodedError } from '../core/index.js';
+/**
+ * Request/response base for ExternalUseCase and InternalUseCase.
+ * Do not declare `trigger` here — each sibling sets a distinct literal.
+ * Not re-exported from hexok/app; application authors extend ExternalUseCase
+ * or InternalUseCase.
+ */
+export class CallableUseCase {
+    /** Use-case id (`incident.close`). Unique among the callable family. */
+    static key;
+    /** Request Standard Schema. Validated before `execute`. */
+    static input;
+    /** Success Standard Schema. Types `execute`, `run`, and the contract. */
+    static output;
+    /** Declared refusals. Keys become `errors.CODE()` factories on `ExecuteCtx`. */
+    static errors = {};
+    /** Port tokens keyed by the alias used in `execute`. Required by `App.from`. */
+    static ports;
+    /** `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;
+    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=callable-use-case.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callable-use-case.js","sourceRoot":"","sources":["../../src/app/callable-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAI1E;;;;;GAKG;AACH,MAAM,OAAgB,eAAe;IACnC,wEAAwE;IACxE,MAAM,CAAU,GAAG,CAAS;IAC5B,2DAA2D;IAC3D,MAAM,CAAU,KAAK,CAAU;IAC/B,yEAAyE;IACzE,MAAM,CAAU,MAAM,CAAU;IAChC,gFAAgF;IAChF,MAAM,CAAU,MAAM,GAAa,EAAE,CAAC;IACtC,gFAAgF;IAChF,MAAM,CAAU,KAAK,CAAsC;IAC3D,sGAAsG;IACtG,MAAM,CAAU,SAAS,CAA8B;IACvD,6FAA6F;IAC7F,MAAM,CAAU,QAAQ,CAA+B;IAEvD,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/contract.d.ts

@@ -0,0 +1,46 @@
+import type { ErrorMap, StandardSchemaV1 } from '../core/index.js';
+import type { PathTo, UnionToIntersection } from './nest.js';
+import { type ExternalKeysOf, type UseCaseBag } from './types.js';
+/** One external use case in the runtime catalog. Transport-neutral, wide. */
+export type CatalogEntry = {
+    /** Use-case `key` (`incident.close`). */
+    key: string;
+    /** Request schema. */
+    input: StandardSchemaV1;
+    /** Success schema. */
+    output: StandardSchemaV1;
+    /** Declared error map. */
+    errors: ErrorMap;
+};
+/** Flat catalog from `deriveContract`. Event and internal use cases are omitted. */
+export type UseCaseContract = {
+    /** Entries keyed by use-case `key`. */
+    entries: Record<string, CatalogEntry>;
+};
+type UseCaseWithKey<Bag, Key> = Extract<Bag[keyof Bag], {
+    trigger: 'external';
+    key: Key;
+}>;
+type RouteView<C> = C extends {
+    key: infer Key extends string;
+    input: infer Input;
+    output: infer Output;
+    errors: infer Errors;
+} ? {
+    readonly key: Key;
+    readonly input: Input;
+    readonly output: Output;
+    readonly errors: Errors;
+} : never;
+/**
+ * Nested by use-case `key` (`incident.close` → `{ incident: { close } }`).
+ * Event and internal use cases are omitted.
+ */
+export type DerivedContract<Bag> = UnionToIntersection<ExternalKeysOf<Bag> extends infer Key ? Key extends string ? PathTo<Key, RouteView<UseCaseWithKey<Bag, Key>>> : never : never>;
+/**
+ * Build a transport-neutral catalog from a use-case class list.
+ * Duplicate `key` throws. Event use cases and InternalUseCase are skipped.
+ */
+export declare function deriveContract(useCases: UseCaseBag): UseCaseContract;
+export { nestByKey } from './nest.js';
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/app/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG;IACzB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,sBAAsB;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG;IAC5B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CACrC,GAAG,CAAC,MAAM,GAAG,CAAC,EACd;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAClC,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,CAAC;IAC9B,KAAK,EAAE,MAAM,KAAK,CAAC;IACnB,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB,GACG;IACE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,GAAG,IAAI,mBAAmB,CACpD,cAAc,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,GACjC,GAAG,SAAS,MAAM,GAChB,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAChD,KAAK,GACP,KAAK,CACV,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,UAAU,GAAG,eAAe,CAkBpE;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/app/contract.js

@@ -0,0 +1,28 @@
+import { isCallableUseCase, isExternalUseCase, } from './types.js';
+/**
+ * Build a transport-neutral catalog from a use-case class list.
+ * Duplicate `key` throws. Event use cases and InternalUseCase are skipped.
+ */
+export function deriveContract(useCases) {
+    const entries = {};
+    const seen = new Set();
+    for (const ctor of Object.values(useCases)) {
+        if (!isCallableUseCase(ctor))
+            continue;
+        if (seen.has(ctor.key)) {
+            throw new Error(`hexok: duplicate use-case key "${ctor.key}"`);
+        }
+        seen.add(ctor.key);
+        if (!isExternalUseCase(ctor))
+            continue;
+        entries[ctor.key] = {
+            key: ctor.key,
+            input: ctor.input,
+            output: ctor.output,
+            errors: ctor.errors,
+        };
+    }
+    return { entries };
+}
+export { nestByKey } from './nest.js';
+//# sourceMappingURL=contract.js.map

package/dist/app/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/app/contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,YAAY,CAAC;AAmDpB;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAoB;IACjD,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAmB,EAAE,CAAC;QAC7D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;YAClB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/app/error-factory.d.ts

@@ -0,0 +1,9 @@
+import { type ErrorMap, type Infer } from '../core/index.js';
+import type { ErrorFactories } from './types.js';
+/**
+ * Build `errors.NOT_FOUND()` factories from an error map.
+ * Each factory throws `CodedError` and types as `never`.
+ */
+export declare function errorFactories<M extends ErrorMap>(map: M): ErrorFactories<M>;
+export type { Infer };
+//# sourceMappingURL=error-factory.d.ts.map

package/dist/app/error-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-factory.d.ts","sourceRoot":"","sources":["../../src/app/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,KAAK,EAGX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAqB5E;AAED,YAAY,EAAE,KAAK,EAAE,CAAC"}

package/dist/app/error-factory.js

@@ -0,0 +1,30 @@
+import { CodedError, validate, } from '../core/index.js';
+/**
+ * Build `errors.NOT_FOUND()` factories from an error map.
+ * Each factory throws `CodedError` and types as `never`.
+ */
+export function errorFactories(map) {
+    const factories = {};
+    for (const code of Object.keys(map)) {
+        const def = map[code];
+        if (def === undefined)
+            continue;
+        factories[code] = (data) => {
+            let payload;
+            if (def.data !== undefined && data !== undefined) {
+                const parsed = validate(def.data, data);
+                payload = parsed.ok ? parsed.value : data;
+            }
+            else if (data !== undefined) {
+                payload = data;
+            }
+            throw new CodedError({
+                code,
+                message: def.message ?? code,
+                ...(payload !== undefined ? { data: payload } : {}),
+            });
+        };
+    }
+    return factories;
+}
+//# sourceMappingURL=error-factory.js.map

package/dist/app/error-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-factory.js","sourceRoot":"","sources":["../../src/app/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAIV,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAqB,GAAM;IACvD,MAAM,SAAS,GAAG,EAA+C,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAc,EAAE,EAAE;YACnC,IAAI,OAAgB,CAAC;YACrB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAwB,EAAE,IAAI,CAAC,CAAC;gBAC5D,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5C,CAAC;iBAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC9B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI;gBACJ,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;gBAC5B,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,SAA8B,CAAC;AACxC,CAAC"}

package/dist/app/event-channel.d.ts

@@ -0,0 +1,133 @@
+import { type ErrorMap, type Infer, type Result, type StandardSchemaV1 } from '../core/index.js';
+import type { AnyEventCatalog, Envelope, EventCatalog, PortToken } from '../domain/index.js';
+import type { ErrorFactories, ResolvedPorts } from './types.js';
+/**
+ * Catalog-scoped delivery policy. Join, refresh, and route are app authority.
+ * Presence I/O is a ChannelAdapter passed to `.route()`.
+ *
+ * ```ts
+ * class ClientChannel extends EventChannel {
+ *   static readonly catalog = ClientEvents
+ *   static readonly joinInput = actorSchema
+ *   async join({ input }: JoinCtx<typeof ClientChannel>) { return input }
+ *   async refresh({ session }: RefreshCtx<typeof ClientChannel>) { return session }
+ *   async route({ ctx, clients, send }: RouteCtx<typeof ClientChannel>) {
+ *     for (const { id, session } of clients) {
+ *       if (visibleTo(session, ctx)) await send(id)
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class EventChannel {
+    /** Discriminator for routed channels. Do not override. */
+    static readonly trigger: "channel";
+    /** Catalog whose events this channel delivers. Must be a bus. */
+    static readonly catalog: AnyEventCatalog;
+    /** Join-claims Standard Schema. Validated before `join`. */
+    static readonly joinInput: unknown;
+    /** Port tokens keyed by the alias used in join, refresh, and route. */
+    static readonly ports?: Record<string, PortToken<unknown>>;
+    /** Declared refusals. Keys become `errors.CODE()` factories on join/refresh. */
+    static readonly errors: ErrorMap;
+    protected constructor();
+    /** Admit a client and return the session to store. Typed `never` so subclasses may take `JoinCtx`. */
+    abstract join(ctx: never): Promise<unknown>;
+    /** Recompute a session; return `'eject'` to drop the client. Typed `never` so subclasses may take `RefreshCtx`. */
+    abstract refresh(ctx: never): Promise<unknown>;
+    /** Choose recipients for a catalog event via `send(id)`. Typed `never` so subclasses may take `RouteCtx`. */
+    abstract route(ctx: never): Promise<void>;
+    /**
+     * Same one-liner as `if (!result.ok) throw new CodedError({ code: result.code })`.
+     * For `validate` / custom Results. Entity methods throw themselves.
+     */
+    unwrap<T, E extends string>(result: Result<T, E>): T;
+}
+/** Session type returned from `join` and later passed to refresh and route. */
+export type ChannelSession<C> = C extends {
+    prototype: {
+        join: (ctx: never) => Promise<infer S>;
+    };
+} ? S : unknown;
+type CatalogKeyOfChannel<C> = C extends {
+    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
+} ? K : string;
+type CatalogCtxOfChannel<C> = C extends {
+    catalog: EventCatalog<string, infer _Kind, infer _E, infer Ctx>;
+} ? Ctx : unknown;
+/** Argument to `EventChannel.join`. Typed from the channel class statics. */
+export type JoinCtx<C> = {
+    /** Validated `static joinInput`. */
+    input: C extends {
+        joinInput: infer S extends StandardSchemaV1;
+    } ? Infer<S> : unknown;
+    /** Bound adapters from `static ports`. */
+    ports: C extends {
+        ports: infer P;
+    } ? ResolvedPorts<P> : Record<string, never>;
+    /** Factories from `static errors`. Throw `errors.FORBIDDEN()`. */
+    errors: C extends {
+        errors: infer E;
+    } ? ErrorFactories<E> : ErrorFactories<never>;
+};
+/** Argument to `EventChannel.refresh`. Typed from the channel class statics. */
+export type RefreshCtx<C> = {
+    /** Current session from join or the last successful refresh. */
+    session: ChannelSession<C>;
+    /** Bound adapters from `static ports`. */
+    ports: C extends {
+        ports: infer P;
+    } ? ResolvedPorts<P> : Record<string, never>;
+    /** Factories from `static errors`. Throw `errors.FORBIDDEN()`. */
+    errors: C extends {
+        errors: infer E;
+    } ? ErrorFactories<E> : ErrorFactories<never>;
+};
+/** Argument to `EventChannel.route`. `ctx` here is catalog context, not app request context. */
+export type RouteCtx<C> = {
+    /** Envelope just published on this channel's catalog. */
+    event: Envelope<string, unknown, CatalogKeyOfChannel<C>, 'bus', CatalogCtxOfChannel<C>>;
+    /** Catalog `ctx` from the envelope — not `ExecuteCtx.ctx`. */
+    ctx: CatalogCtxOfChannel<C>;
+    /** Connected clients and their sessions. */
+    clients: ReadonlyArray<{
+        id: string;
+        session: ChannelSession<C>;
+    }>;
+    /** Bound adapters from `static ports`. */
+    ports: C extends {
+        ports: infer P;
+    } ? ResolvedPorts<P> : Record<string, never>;
+    /** Deliver the serialized event to one client id. */
+    send: (id: string) => Promise<void>;
+};
+/** Presence handle for one catalog, from `channels` in `execute`. */
+export type ChannelControl<Session = unknown> = {
+    /** Connected clients and their sessions. */
+    list(): ReadonlyArray<{
+        id: string;
+        session: Session;
+    }>;
+    /** Drop one client by id. */
+    eject(id: string): void;
+    /** Drop every client whose session matches. */
+    ejectWhere(pred: (session: Session) => boolean): void;
+    /** Re-run `refresh` for one client. */
+    refresh(id: string): Promise<void>;
+    /** Re-run `refresh` for matching sessions. */
+    refreshWhere(pred: (session: Session) => boolean): Promise<void>;
+    /** Replace a session without running `refresh`. */
+    update(id: string, session: Session): void;
+};
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type ChannelHandleMap<Ch> = [Ch] extends [never] ? Record<string, never> : UnionToIntersection<Ch extends infer C ? C extends {
+    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
+} ? {
+    [P in K]: ChannelControl<ChannelSession<C>>;
+} : never : never>;
+/** `channels` on execute ctx, keyed by catalog key from `static channels`. */
+export type ChannelProps<C> = C extends {
+    channels: readonly (infer Ch)[];
+} ? [Ch] extends [never] ? Record<string, never> : ChannelHandleMap<Ch> : Record<string, never>;
+export {};
+//# sourceMappingURL=event-channel.d.ts.map

package/dist/app/event-channel.d.ts.map

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

package/dist/app/event-channel.js

@@ -0,0 +1,49 @@
+import { CodedError, } from '../core/index.js';
+/**
+ * Catalog-scoped delivery policy. Join, refresh, and route are app authority.
+ * Presence I/O is a ChannelAdapter passed to `.route()`.
+ *
+ * ```ts
+ * class ClientChannel extends EventChannel {
+ *   static readonly catalog = ClientEvents
+ *   static readonly joinInput = actorSchema
+ *   async join({ input }: JoinCtx<typeof ClientChannel>) { return input }
+ *   async refresh({ session }: RefreshCtx<typeof ClientChannel>) { return session }
+ *   async route({ ctx, clients, send }: RouteCtx<typeof ClientChannel>) {
+ *     for (const { id, session } of clients) {
+ *       if (visibleTo(session, ctx)) await send(id)
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class EventChannel {
+    /** Discriminator for routed channels. Do not override. */
+    static trigger = 'channel';
+    /** Catalog whose events this channel delivers. Must be a bus. */
+    static catalog;
+    /** Join-claims Standard Schema. Validated before `join`. */
+    static joinInput;
+    /** Port tokens keyed by the alias used in join, refresh, and route. */
+    static ports;
+    /** Declared refusals. Keys become `errors.CODE()` factories on join/refresh. */
+    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-channel.js.map

package/dist/app/event-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-channel.js","sourceRoot":"","sources":["../../src/app/event-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,MAAM,kBAAkB,CAAC;AAS1B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,YAAY;IAChC,0DAA0D;IAC1D,MAAM,CAAU,OAAO,GAAG,SAAkB,CAAC;IAC7C,iEAAiE;IACjE,MAAM,CAAU,OAAO,CAAkB;IACzC,4DAA4D;IAC5D,MAAM,CAAU,SAAS,CAAU;IACnC,uEAAuE;IACvE,MAAM,CAAU,KAAK,CAAsC;IAC3D,gFAAgF;IAChF,MAAM,CAAU,MAAM,GAAa,EAAE,CAAC;IAEtC,gBAAyB,CAAC;IAS1B;;;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/event-use-case.d.ts

@@ -0,0 +1,47 @@
+import { type ErrorMap, type Result } from '../core/index.js';
+import type { AnyEventCatalog, EventClass, PortToken } from '../domain/index.js';
+import type { EventChannelCtor } from './types.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 declare abstract class EventUseCase {
+    /** Discriminator for `App.from` / `isEventUseCase`. Do not override. */
+    static readonly trigger: "event";
+    /** Handler id (`incident.notifyOnClose`). Used in completeness messages. */
+    static readonly key: string;
+    /** Event class this handler listens to. Required by `App.from`; must be in `catalog`. */
+    static readonly on?: EventClass;
+    /** Catalog that owns `on`. Required by `App.from`; bind it with `App.bind`. */
+    static readonly catalog?: AnyEventCatalog;
+    /** Port tokens keyed by the alias used in `execute`. */
+    static readonly ports?: Record<string, PortToken<unknown>>;
+    /** Consumer group for queue catalogs. Required when `catalog.kind` is `'queue'`. */
+    static readonly group?: string;
+    /** `static publishes = [DomainEvents] as const` — without `as const`, Events widens to EventClass. */
+    static readonly publishes?: readonly AnyEventCatalog[];
+    /** `static channels = [ClientChannel] as const` — without `as const`, catalog keys widen. */
+    static readonly channels?: readonly EventChannelCtor[];
+    /** Declared refusals. Keys become `errors.CODE()` factories on `EventCtx`. */
+    static readonly errors: ErrorMap;
+    protected constructor();
+    /** Typed `never` so subclasses may take `EventCtx` (tighter `publish`). */
+    abstract execute(ctx: never): Promise<void>;
+    /**
+     * Same one-liner as `if (!result.ok) throw new CodedError({ code: result.code })`.
+     * For `validate` / custom Results. Entity methods throw themselves.
+     */
+    unwrap<T, E extends string>(result: Result<T, E>): T;
+}
+//# sourceMappingURL=event-use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-use-case.d.ts","sourceRoot":"","sources":["../../src/app/event-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,YAAY;IAChC,wEAAwE;IACxE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAU;IAC3C,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC;IAChC,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1C,wDAAwD;IACxD,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,oFAAoF;IACpF,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,sGAAsG;IACtG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACvD,6FAA6F;IAC7F,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvD,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAM;IAEtC,SAAS;IAET,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;CAYrD"}