hexok 1.0.0

package/dist/domain/event.d.ts

@@ -0,0 +1,44 @@
+import type { Infer, StandardSchemaV1 } from '../core/index.js';
+/**
+ * Domain events are classes. Construction types the payload;
+ * validation happens at the use-case edge, not in the constructor.
+ *
+ * ```ts
+ * class IncidentClosed extends DomainEvent {
+ *   static readonly key = 'incident.closed'
+ *   static readonly schema = z.object({ id: z.string(), closedAt: z.date() })
+ *   constructor(public readonly payload: Infer<typeof IncidentClosed.schema>) {
+ *     super()
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class DomainEvent<P = unknown> {
+    /** Dotted event name, e.g. `'incident.closed'`. Declare on each subclass. */
+    static readonly key: string;
+    /** Standard Schema for the payload, applied at the use-case edge. */
+    static readonly schema: StandardSchemaV1;
+    /** Event body. Typed by the subclass constructor; not validated here. */
+    abstract readonly payload: P;
+}
+/** Event subclass constructor: `key`, `schema`, and `new (payload)`. */
+export type EventClass<P = never> = {
+    /** Dotted event name, e.g. `'incident.closed'`. */
+    readonly key: string;
+    /** Standard Schema for the payload, applied at the use-case edge. */
+    readonly schema: StandardSchemaV1;
+    new (payload: P, ...args: never[]): DomainEvent<unknown>;
+};
+/** Payload type inferred from an event class's `schema`. */
+export type EventPayload<E extends EventClass> = Infer<E['schema']>;
+type EventKeyOf<E> = E extends {
+    readonly key: infer K extends string;
+} ? K : string;
+/** `catalog.event()` argument when the catalog declared `.ctx<T>()`. */
+export type EventWithCtx<E extends EventClass, Ctx> = [
+    InstanceType<E>
+] extends [{
+    ctx: Ctx;
+}] ? E : `hexok: event "${EventKeyOf<E>}" is missing ctx for this catalog`;
+export {};
+//# sourceMappingURL=event.d.ts.map

package/dist/domain/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/domain/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,8BAAsB,WAAW,CAAC,CAAC,GAAG,OAAO;IAC3C,6EAA6E;IAC7E,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;CAC9B;AAED,wEAAwE;AACxE,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,KAAK,IAAI;IAClC,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,KAAK,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CAC1D,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEpE,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GACnE,CAAC,GACD,MAAM,CAAC;AAEX,wEAAwE;AACxE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,IAAI;IACpD,YAAY,CAAC,CAAC,CAAC;CAChB,SAAS,CAAC;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC,GACpB,CAAC,GACD,iBAAiB,UAAU,CAAC,CAAC,CAAC,mCAAmC,CAAC"}

package/dist/domain/event.js

@@ -0,0 +1,21 @@
+/**
+ * Domain events are classes. Construction types the payload;
+ * validation happens at the use-case edge, not in the constructor.
+ *
+ * ```ts
+ * class IncidentClosed extends DomainEvent {
+ *   static readonly key = 'incident.closed'
+ *   static readonly schema = z.object({ id: z.string(), closedAt: z.date() })
+ *   constructor(public readonly payload: Infer<typeof IncidentClosed.schema>) {
+ *     super()
+ *   }
+ * }
+ * ```
+ */
+export class DomainEvent {
+    /** Dotted event name, e.g. `'incident.closed'`. Declare on each subclass. */
+    static key;
+    /** Standard Schema for the payload, applied at the use-case edge. */
+    static schema;
+}
+//# sourceMappingURL=event.js.map

package/dist/domain/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/domain/event.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,WAAW;IAC/B,6EAA6E;IAC7E,MAAM,CAAU,GAAG,CAAS;IAC5B,qEAAqE;IACrE,MAAM,CAAU,MAAM,CAAmB;CAG1C"}

package/dist/domain/index.d.ts

@@ -0,0 +1,8 @@
+export type { CrudRepository, RequestScoped, Transactional, UnitOfWork, } from './capabilities.js';
+export { type AnyEventCatalog, type CatalogEvents, EventCatalog, } from './catalog.js';
+export type { ChannelAdapter, ChannelConnection, } from './channel.js';
+export { type DeepReadonly, Entity, type EntityConstructor, } from './entity.js';
+export type { BusAdapter, CatalogKind, Envelope, EventAdapter, QueueAdapter, QueueConsumeCtx, } from './envelope.js';
+export { DomainEvent, type EventClass, type EventPayload, type EventWithCtx, } from './event.js';
+export { Port, type PortCapabilities, PortToken, type PortType, } from './port.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,YAAY,EACjB,MAAM,EACN,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,IAAI,EACJ,KAAK,gBAAgB,EACrB,SAAS,EACT,KAAK,QAAQ,GACd,MAAM,WAAW,CAAC"}

package/dist/domain/index.js

@@ -0,0 +1,5 @@
+export { EventCatalog, } from './catalog.js';
+export { Entity, } from './entity.js';
+export { DomainEvent, } from './event.js';
+export { Port, PortToken, } from './port.js';
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,YAAY,GACb,MAAM,cAAc,CAAC;AAKtB,OAAO,EAEL,MAAM,GAEP,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,WAAW,GAIZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,IAAI,EAEJ,SAAS,GAEV,MAAM,WAAW,CAAC"}

package/dist/domain/port.d.ts

@@ -0,0 +1,45 @@
+declare const portType: unique symbol;
+/** Runtime flags checked by `App.provide`. Type the port with `Transactional` / `RequestScoped` as well. */
+export type PortCapabilities = {
+    transactional?: boolean;
+    requestScoped?: boolean;
+};
+/**
+ * A port is a TypeScript interface plus a token used at compose time.
+ *
+ * ```ts
+ * export interface IncidentRepository {
+ *   get(id: string): Promise<Incident | null>
+ *   save(incident: Incident): Promise<void>
+ * }
+ * export const IncidentRepository = Port.token<IncidentRepository>(
+ *   'IncidentRepository',
+ * )
+ * ```
+ *
+ * `.build()` names a missing port by its use-case alias
+ * (`ports: { incidents: IncidentRepository }` → `"incidents"`).
+ * Pass `{ transactional: true }` / `{ requestScoped: true }` so `provide`
+ * throws if the impl is missing `bindTo` / `fork`.
+ */
+export declare class PortToken<out I> {
+    /** Name used in runtime provide/completeness errors. */
+    readonly key: string;
+    /** Runtime capability flags. `provide()` checks `bindTo` / `fork` when set. */
+    readonly capabilities: {
+        readonly transactional: boolean;
+        readonly requestScoped: boolean;
+    };
+    readonly [portType]: I;
+    private constructor();
+    /** Create a token for interface `I`. Prefer `Port.token<I>('Name')` at call sites. */
+    static token<I>(key: string, capabilities?: PortCapabilities): PortToken<I>;
+}
+/** `Port.token<I>('Name')` — the usual way to create a `PortToken`. */
+export declare const Port: {
+    token: typeof PortToken.token;
+};
+/** Interface stored on a `PortToken`. */
+export type PortType<T> = T extends PortToken<infer I> ? I : never;
+export {};
+//# sourceMappingURL=port.d.ts.map

package/dist/domain/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/domain/port.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAC;AAEtC,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;KACjC,CAAC;IACF,SAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE/B,OAAO;IASP,sFAAsF;IACtF,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC;CAG5E;AAED,uEAAuE;AACvE,eAAO,MAAM,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,SAAS,CAAC,KAAK,CAAA;CAEjD,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/domain/port.js

@@ -0,0 +1,41 @@
+/**
+ * A port is a TypeScript interface plus a token used at compose time.
+ *
+ * ```ts
+ * export interface IncidentRepository {
+ *   get(id: string): Promise<Incident | null>
+ *   save(incident: Incident): Promise<void>
+ * }
+ * export const IncidentRepository = Port.token<IncidentRepository>(
+ *   'IncidentRepository',
+ * )
+ * ```
+ *
+ * `.build()` names a missing port by its use-case alias
+ * (`ports: { incidents: IncidentRepository }` → `"incidents"`).
+ * Pass `{ transactional: true }` / `{ requestScoped: true }` so `provide`
+ * throws if the impl is missing `bindTo` / `fork`.
+ */
+export class PortToken {
+    /** Name used in runtime provide/completeness errors. */
+    key;
+    /** Runtime capability flags. `provide()` checks `bindTo` / `fork` when set. */
+    capabilities;
+    constructor(key, capabilities) {
+        this.key = key;
+        this.capabilities = Object.freeze({
+            transactional: capabilities?.transactional === true,
+            requestScoped: capabilities?.requestScoped === true,
+        });
+        Object.freeze(this);
+    }
+    /** Create a token for interface `I`. Prefer `Port.token<I>('Name')` at call sites. */
+    static token(key, capabilities) {
+        return new PortToken(key, capabilities);
+    }
+}
+/** `Port.token<I>('Name')` — the usual way to create a `PortToken`. */
+export const Port = {
+    token: PortToken.token,
+};
+//# sourceMappingURL=port.js.map

package/dist/domain/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/domain/port.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,SAAS;IACpB,wDAAwD;IAC/C,GAAG,CAAS;IACrB,+EAA+E;IACtE,YAAY,CAGnB;IAGF,YAAoB,GAAW,EAAE,YAA+B;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;YAChC,aAAa,EAAE,YAAY,EAAE,aAAa,KAAK,IAAI;YACnD,aAAa,EAAE,YAAY,EAAE,aAAa,KAAK,IAAI;SACpD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,KAAK,CAAI,GAAW,EAAE,YAA+B;QAC1D,OAAO,IAAI,SAAS,CAAI,GAAG,EAAE,YAAY,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,IAAI,GAAsC;IACrD,KAAK,EAAE,SAAS,CAAC,KAAK;CACvB,CAAC"}

package/dist/infra/adapter.d.ts

@@ -0,0 +1,22 @@
+import type { PortToken } from '../domain/index.js';
+/**
+ * Typed factory holder. Pass the **impl** to `provide`, or use `App.adapt(factory, ...deps)`.
+ *
+ * ```ts
+ * const factory = Adapter.of(IncidentRepository, (db: Pool) => new PgIncidentRepo(db))
+ * const app = App.from(useCases).adapt(factory, pool)
+ * ```
+ */
+export declare const Adapter: {
+    /**
+     * Pair a port token with a factory. Call `create(...deps)` and pass the impl
+     * to `App.provide` — not this holder.
+     */
+    of<I, Deps extends unknown[]>(token: PortToken<I>, create: (...deps: Deps) => I): {
+        /** Port token for this adapter. Use with `App.provide(token, impl)`. */
+        token: PortToken<I>;
+        /** Build the adapter impl. Composition receives that value, not the holder. */
+        create: (...deps: Deps) => I;
+    };
+};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/infra/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/infra/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO;IAClB;;;OAGG;OACA,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,SACnB,SAAS,CAAC,CAAC,CAAC,UACX,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GAC3B;QACD,wEAAwE;QACxE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QACpB,+EAA+E;QAC/E,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC;KAC9B;CAGF,CAAC"}

package/dist/infra/adapter.js

@@ -0,0 +1,18 @@
+/**
+ * Typed factory holder. Pass the **impl** to `provide`, or use `App.adapt(factory, ...deps)`.
+ *
+ * ```ts
+ * const factory = Adapter.of(IncidentRepository, (db: Pool) => new PgIncidentRepo(db))
+ * const app = App.from(useCases).adapt(factory, pool)
+ * ```
+ */
+export const Adapter = {
+    /**
+     * Pair a port token with a factory. Call `create(...deps)` and pass the impl
+     * to `App.provide` — not this holder.
+     */
+    of(token, create) {
+        return { token, create };
+    },
+};
+//# sourceMappingURL=adapter.js.map

package/dist/infra/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/infra/adapter.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB;;;OAGG;IACH,EAAE,CACA,KAAmB,EACnB,MAA4B;QAO5B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC"}

package/dist/infra/index.d.ts

@@ -0,0 +1,3 @@
+export { Adapter } from './adapter.js';
+export { Mapper } from './mapper.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infra/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/infra/index.js

@@ -0,0 +1,3 @@
+export { Adapter } from './adapter.js';
+export { Mapper } from './mapper.js';
+//# sourceMappingURL=index.js.map

package/dist/infra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infra/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/infra/mapper.d.ts

@@ -0,0 +1,48 @@
+import { type Result } from '../core/index.js';
+import type { EntityConstructor } from '../domain/index.js';
+/**
+ * One entity, two functions. Inbound `from` wraps the mapping.
+ * `restore` does not run the schema; `parse` does (untyped trust
+ * boundary). `VALIDATION` from `parse` / `create` / `set` is rethrown
+ * with a mapper message.
+ *
+ * ```ts
+ * const IncidentMapper = Mapper.for(Incident)
+ *   .to((e) => ({ id: e.id, closed_at: e.closedAt?.toISOString() ?? null }))
+ *   .from((row) => Incident.restore({
+ *     id: row.id,
+ *     closedAt: row.closed_at ? new Date(row.closed_at) : null,
+ *   }))
+ * ```
+ */
+export declare class Mapper<E extends EntityConstructor, Row> {
+    #private;
+    private constructor();
+    /** Start a mapper for this entity class. Chain `.to` then `.from`. */
+    static for<E extends EntityConstructor>(_entity: E): MapperTo<E>;
+    /** Outbound. No parse. */
+    to(entity: E['prototype']): Row;
+    /** Run the inbound mapping. Rethrows `VALIDATION` from `parse` / `create` / `set`. */
+    from(row: Row): E['prototype'];
+    /**
+     * Same mapping, but `from` returns `Result` instead of throwing.
+     */
+    unsafe(): {
+        to: Mapper<E, Row>['to'];
+        from: (row: Row) => Result<E['prototype'], 'VALIDATION'>;
+    };
+}
+/** Next step after `Mapper.for`. Call `.to` with the outbound mapping. */
+export type MapperTo<E extends EntityConstructor> = {
+    /** Set the outbound mapping (entity → row). Returns the `.from` builder. */
+    to<Row>(toFn: (entity: E['prototype']) => Row): MapperFrom<E, Row>;
+};
+/** Next step after `.to`. Call `.from` with the inbound mapping to finish. */
+export type MapperFrom<E extends EntityConstructor, Row> = {
+    /**
+     * Set the inbound mapping (row → entity) and return the mapper.
+     * `restore` does not run the schema; `parse` does.
+     */
+    from(fromFn: (row: Row) => E['prototype']): Mapper<E, Row>;
+};
+//# sourceMappingURL=mapper.d.ts.map

package/dist/infra/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/infra/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EAEZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAAE,GAAG;;IAIlD,OAAO;IAQP,sEAAsE;IACtE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQhE,0BAA0B;IAC1B,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,GAAG;IAI/B,sFAAsF;IACtF,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC;IAe9B;;OAEG;IACH,MAAM,IAAI;QACR,EAAE,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC;KAC1D;CAoBF;AAED,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,iBAAiB,IAAI;IAClD,4EAA4E;IAC5E,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;CACpE,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,iBAAiB,EAAE,GAAG,IAAI;IACzD;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;CAC5D,CAAC"}

package/dist/infra/mapper.js

@@ -0,0 +1,77 @@
+import { CodedError, fail, ok, } from '../core/index.js';
+const TRUST = 'hexok: model.from() failed entity.parse (trust boundary)';
+/**
+ * One entity, two functions. Inbound `from` wraps the mapping.
+ * `restore` does not run the schema; `parse` does (untyped trust
+ * boundary). `VALIDATION` from `parse` / `create` / `set` is rethrown
+ * with a mapper message.
+ *
+ * ```ts
+ * const IncidentMapper = Mapper.for(Incident)
+ *   .to((e) => ({ id: e.id, closed_at: e.closedAt?.toISOString() ?? null }))
+ *   .from((row) => Incident.restore({
+ *     id: row.id,
+ *     closedAt: row.closed_at ? new Date(row.closed_at) : null,
+ *   }))
+ * ```
+ */
+export class Mapper {
+    #toFn;
+    #fromFn;
+    constructor(toFn, fromFn) {
+        this.#toFn = toFn;
+        this.#fromFn = fromFn;
+    }
+    /** Start a mapper for this entity class. Chain `.to` then `.from`. */
+    static for(_entity) {
+        return {
+            to: (toFn) => ({
+                from: (fromFn) => new Mapper(toFn, fromFn),
+            }),
+        };
+    }
+    /** Outbound. No parse. */
+    to(entity) {
+        return this.#toFn(entity);
+    }
+    /** Run the inbound mapping. Rethrows `VALIDATION` from `parse` / `create` / `set`. */
+    from(row) {
+        try {
+            return this.#fromFn(row);
+        }
+        catch (error) {
+            if (isValidation(error)) {
+                throw new CodedError({
+                    code: error.code,
+                    message: TRUST,
+                    ...(error.data !== undefined ? { data: error.data } : {}),
+                });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Same mapping, but `from` returns `Result` instead of throwing.
+     */
+    unsafe() {
+        return {
+            to: (entity) => this.to(entity),
+            from: (row) => {
+                try {
+                    return ok(this.#fromFn(row));
+                }
+                catch (error) {
+                    if (isValidation(error)) {
+                        const issues = error.data?.issues;
+                        return fail('VALIDATION', issues);
+                    }
+                    throw error;
+                }
+            },
+        };
+    }
+}
+function isValidation(error) {
+    return error instanceof CodedError && error.code === 'VALIDATION';
+}
+//# sourceMappingURL=mapper.js.map

package/dist/infra/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../src/infra/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,IAAI,EACJ,EAAE,GAGH,MAAM,kBAAkB,CAAC;AAG1B,MAAM,KAAK,GAAG,0DAA0D,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,MAAM;IACjB,KAAK,CAAkC;IACvC,OAAO,CAA+B;IAEtC,YACE,IAAqC,EACrC,MAAoC;QAEpC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,GAAG,CAA8B,OAAU;QAChD,OAAO;YACL,EAAE,EAAE,CAAM,IAAqC,EAAsB,EAAE,CAAC,CAAC;gBACvE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;aAC3C,CAAC;SACH,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,EAAE,CAAC,MAAsB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,sFAAsF;IACtF,IAAI,CAAC,GAAQ;QACX,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,UAAU,CAAC;oBACnB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK;oBACd,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QAIJ,OAAO;YACL,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;YAC/B,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACZ,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;wBACxB,MAAM,MAAM,GACV,KAAK,CAAC,IAGP,EAAE,MAAM,CAAC;wBACV,OAAO,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;oBACpC,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAiBD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;AACpE,CAAC"}

package/dist/runtime/app.d.ts

@@ -0,0 +1,100 @@
+import { type AsUseCaseBag, type ChannelSession, type CheckUseCase, type DerivedContract, type EventChannelCtor, type EventUseCaseCtor, type UseCaseBag } from '../app/index.js';
+import type { BusAdapter, CatalogKind, ChannelAdapter, Envelope, EventAdapter, EventCatalog, EventClass, PortToken, QueueAdapter } from '../domain/index.js';
+import { type ChannelGateways } from './channel.js';
+import type { NestedClient } from './client.js';
+import type { ChannelKindError, DuplicateCatalogError, DuplicateChannelError, DuplicatePortError, MissingMessages } from './completeness.js';
+import { type Interceptor } from './interceptor.js';
+import type { ApiMiddleware } from './middleware.js';
+import { type RpcContract } from './rpc.js';
+/** Built app: in-process client, HTTP RPC, event lifecycle, and routed channels. */
+export type AppInstance<Bag extends UseCaseBag, Ctx = unknown, Routed = never> = {
+    /** Nested API contract (`incident.close` → `contract.incident.close`). Event and internal use cases are omitted (`trigger !== 'external'`). */
+    contract: DerivedContract<Bag>;
+    /** `fetch` handler for `POST /rpc/...`. Event handlers still require `start()`. */
+    router: {
+        fetch: (request: Request) => Promise<Response>;
+    };
+    /** In-process nested client. Same keys as `contract`; pass `{ ctx, signal }` as the second argument. */
+    local: NestedClient<Bag, Ctx>;
+    /** Event use-case constructors grouped by catalog key then event key. They subscribe only after `start()`. */
+    handlers: Record<string, Record<string, EventUseCaseCtor[]>>;
+    /** Routed channel gateways keyed by catalog key. Routing starts on `start()`. */
+    channels: ChannelGateways<Routed>;
+    /** Publish an envelope to its bound adapter now. Does not start handlers. */
+    publish(envelope: Envelope): Promise<void>;
+    /** Subscribe event handlers and start channel routing. Throws if called twice without `stop()`. */
+    start(): Promise<void>;
+    /** Stop channel and event adapters. Safe to call more than once. */
+    stop(): Promise<void>;
+    /** Nested RPC catalog (`rpc.incident.close.path`) plus flat `routes`. */
+    readonly rpc: RpcContract<Bag>;
+};
+/** Adapter `bind` expects for a catalog kind. */
+export type AdapterFor<K extends CatalogKind> = K extends 'bus' ? BusAdapter : K extends 'queue' ? QueueAdapter : EventAdapter;
+type ChannelCatalogKind<C> = C extends {
+    catalog: EventCatalog<string, infer Kind, infer _E, infer _Ctx>;
+} ? Kind : CatalogKind;
+type ChannelCatalogKey<C> = C extends {
+    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
+} ? K : string;
+/** Fluent composition. `build` is callable only after every required port, catalog, and channel is wired. */
+export declare class AppBuilder<Bag extends UseCaseBag, Provided = never, Bound = never, Ctx = unknown, Routed = never> {
+    #private;
+    private constructor();
+    /** Start composition from a map of use-case classes. */
+    static from<Bag extends {
+        [K in keyof Bag]: CheckUseCase<Bag[K]>;
+    }>(useCases: Bag): AppBuilder<AsUseCaseBag<Bag>, never, never, unknown>;
+    /** Register a port implementation. A second `provide` for the same token is a compile-time error and a runtime throw. */
+    provide<I>(token: [PortToken<I>] extends [Provided] ? DuplicatePortError : PortToken<I>, impl: I): AppBuilder<Bag, Provided | PortToken<I>, Bound, Ctx, Routed>;
+    /** Bind an event adapter to a catalog. Adapter `kind` must match; a second bind of the same catalog fails. */
+    bind<Key extends string, Kind extends CatalogKind, Events extends EventClass = never, CatCtx = undefined>(catalog: [EventCatalog<Key, Kind, Events, CatCtx>] extends [Bound] ? DuplicateCatalogError<Key> : EventCatalog<Key, Kind, Events, CatCtx>, adapter: AdapterFor<Kind>): AppBuilder<Bag, Provided, Bound | EventCatalog<Key, Kind, Events, CatCtx>, Ctx, Routed>;
+    /** Route a channel class to a presence adapter. The channel catalog must be a bus and still needs `bind`. */
+    route<C extends EventChannelCtor>(channel: ChannelCatalogKind<C> extends 'bus' ? [C] extends [Routed] ? DuplicateChannelError<ChannelCatalogKey<C>> : C : ChannelKindError<ChannelCatalogKey<C>, ChannelCatalogKind<C> & string>, adapter: ChannelAdapter<ChannelSession<C>>): AppBuilder<Bag, Provided, Bound, Ctx, Routed | C>;
+    /** Set the default request context for `local`, HTTP, and event handlers. Per-call `ctx` overrides it. */
+    ctx<C>(defaults?: C): AppBuilder<Bag, Provided, Bound, C, Routed>;
+    /**
+     * 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: (args: {
+        request: Request;
+        ctx: Ctx;
+    }) => Ctx | Promise<Ctx>): this;
+    /**
+     * Provide a factory from `Adapter.of` by calling `create(...deps)`.
+     * Same as `.provide(factory.token, factory.create(...deps))`.
+     */
+    adapt<I, Deps extends unknown[]>(factory: {
+        token: [PortToken<I>] extends [Provided] ? DuplicatePortError : PortToken<I>;
+        create: (...deps: Deps) => I;
+    }, ...deps: Deps): AppBuilder<Bag, Provided | PortToken<I>, Bound, Ctx, Routed>;
+    /** Register middleware around external `execute` (`local` and HTTP) — not event handlers or nested `run`. */
+    use(middleware: ApiMiddleware): this;
+    /** Register an interceptor. First registered is outer for execute, adapter, publish, and dispatch. Duplicate `key` throws. */
+    intercept(interceptor: Interceptor): this;
+    /**
+     * Complete the graph. Incomplete builders expose `build` as the missing
+     * port/catalog message (not callable). Runtime throws the same sentences.
+     */
+    get build(): [MissingMessages<Bag, Provided, Bound, Routed>] extends [never] ? () => AppInstance<Bag, Ctx, Routed> : MissingMessages<Bag, Provided, Bound, Routed>;
+}
+/**
+ * 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 declare const App: {
+    /** Start composition from a map of use-case classes. */
+    from: typeof AppBuilder.from;
+};
+export {};
+//# sourceMappingURL=app.d.ts.map

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

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