hexok 1.0.0

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

@@ -0,0 +1,21 @@
+import type { StandardSchemaV1 } from './standard-schema.js';
+/**
+ * Declared metadata for one error code. Keys of an `ErrorMap` **are** the error union.
+ *
+ * ```ts
+ * const errors = {
+ *   NOT_FOUND: { message: 'Incident not found' },
+ * }
+ * ```
+ */
+export interface ErrorDef {
+    /** Human message. Factories fall back to the code when omitted. */
+    message?: string;
+    /** Optional payload schema for `errors.CODE(data)`. */
+    data?: StandardSchemaV1;
+}
+/** `static errors` bag. Prefer `defineErrors({ ... })` so keys stay a finite union. */
+export type ErrorMap = Record<string, ErrorDef>;
+/** Infer error-code keys from an object literal. Use for `static readonly errors`. */
+export declare function defineErrors<const M extends Record<string, ErrorDef>>(map: M): M;
+//# sourceMappingURL=error-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-map.d.ts","sourceRoot":"","sources":["../../src/core/error-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,uFAAuF;AACvF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEhD,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACnE,GAAG,EAAE,CAAC,GACL,CAAC,CAEH"}

package/dist/core/error-map.js

@@ -0,0 +1,5 @@
+/** Infer error-code keys from an object literal. Use for `static readonly errors`. */
+export function defineErrors(map) {
+    return map;
+}
+//# sourceMappingURL=error-map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-map.js","sourceRoot":"","sources":["../../src/core/error-map.ts"],"names":[],"mappings":"AAqBA,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAC1B,GAAM;IAEN,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export { CodedError, validationError } from './coded-error.js';
+export { defineErrors, type ErrorDef, type ErrorMap } from './error-map.js';
+export { fail, ok, type Result } from './result.js';
+export { type Infer, validate } from './schema.js';
+export type { StandardSchemaV1 } from './standard-schema.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,KAAK,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export { CodedError, validationError } from './coded-error.js';
+export { defineErrors } from './error-map.js';
+export { fail, ok } from './result.js';
+export { validate } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAgC,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AACpD,OAAO,EAAc,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/result.d.ts

@@ -0,0 +1,23 @@
+import type { StandardSchemaV1 } from './standard-schema.js';
+/**
+ * Success-or-code result. `validate` returns this; use cases may `unwrap` it.
+ * Entity methods throw `CodedError` instead of returning a Result.
+ *
+ * ```ts
+ * const parsed = validate(schema, value)
+ * // Result<Output, 'VALIDATION'> — fail may include `issues`
+ * ```
+ */
+export type Result<T, E extends string = string> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    code: E;
+    issues?: readonly StandardSchemaV1.Issue[];
+};
+/** Wrap a value. The error arm is `never` so unions collapse from `ok`/`fail` branches. */
+export declare function ok<T>(value: T): Result<T, never>;
+/** Wrap an error code. Pass `issues` from a Standard Schema fail so callers can show field errors. */
+export declare function fail<E extends string>(code: E, issues?: readonly StandardSchemaV1.Issue[]): Result<never, E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/core/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAC3C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,CAAC;CAC5C,CAAC;AAEN,2FAA2F;AAC3F,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED,sGAAsG;AACtG,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EACnC,IAAI,EAAE,CAAC,EACP,MAAM,CAAC,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,GACzC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAIlB"}

package/dist/core/result.js

@@ -0,0 +1,11 @@
+/** Wrap a value. The error arm is `never` so unions collapse from `ok`/`fail` branches. */
+export function ok(value) {
+    return { ok: true, value };
+}
+/** Wrap an error code. Pass `issues` from a Standard Schema fail so callers can show field errors. */
+export function fail(code, issues) {
+    return issues !== undefined
+        ? { ok: false, code, issues }
+        : { ok: false, code };
+}
+//# sourceMappingURL=result.js.map

package/dist/core/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAmBA,2FAA2F;AAC3F,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,IAAI,CAClB,IAAO,EACP,MAA0C;IAE1C,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;QAC7B,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/core/schema.d.ts

@@ -0,0 +1,19 @@
+import { type Result } from './result.js';
+import type { StandardSchemaV1 } from './standard-schema.js';
+/** Output type of a Standard Schema V1 schema. */
+export type Infer<S extends StandardSchemaV1> = NonNullable<S['~standard']['types']>['output'];
+/**
+ * Validate `value` with a Standard Schema. Sync only.
+ *
+ * Failures are `'VALIDATION'` plus Standard Schema `issues`. Entity
+ * `create` / `parse` / `set` / `validate()` throw that as `CodedError`.
+ * `restore` does not run the schema.
+ * Async schemas belong at the application edge and throw.
+ *
+ * ```ts
+ * const parsed = validate(Incident.schema, body)
+ * if (!parsed.ok) return parsed
+ * ```
+ */
+export declare function validate<S extends StandardSchemaV1>(schema: S, value: unknown): Result<Infer<S>, 'VALIDATION'>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,kDAAkD;AAClD,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,gBAAgB,IAAI,WAAW,CACzD,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CACxB,CAAC,QAAQ,CAAC,CAAC;AAEZ;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,gBAAgB,EACjD,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAShC"}

package/dist/core/schema.js

@@ -0,0 +1,28 @@
+import { fail, ok } from './result.js';
+/**
+ * Validate `value` with a Standard Schema. Sync only.
+ *
+ * Failures are `'VALIDATION'` plus Standard Schema `issues`. Entity
+ * `create` / `parse` / `set` / `validate()` throw that as `CodedError`.
+ * `restore` does not run the schema.
+ * Async schemas belong at the application edge and throw.
+ *
+ * ```ts
+ * const parsed = validate(Incident.schema, body)
+ * if (!parsed.ok) return parsed
+ * ```
+ */
+export function validate(schema, value) {
+    const result = schema['~standard'].validate(value);
+    if (isPromise(result)) {
+        throw new Error('hexok: async schemas belong at the application edge');
+    }
+    if (result.issues) {
+        return fail('VALIDATION', result.issues);
+    }
+    return ok(result.value);
+}
+function isPromise(value) {
+    return typeof value.then === 'function';
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAQpD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAS,EACT,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,CAAC,MAAM,CAAC,KAAiB,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAChB,KAE6C;IAE7C,OAAO,OAAQ,KAA0B,CAAC,IAAI,KAAK,UAAU,CAAC;AAChE,CAAC"}

package/dist/core/standard-schema.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Vendored Standard Schema V1. Copy of https://standardschema.dev
+ * so `hexok/core` has zero runtime dependencies.
+ */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** Spec bag: version, vendor, validate, optional inferred types. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+export declare namespace StandardSchemaV1 {
+    /** Version, vendor, `validate`, and optional input/output types. */
+    interface Props<Input = unknown, Output = Input> {
+        /** Spec version. Always `1`. */
+        readonly version: 1;
+        /** Schema library name, e.g. `'zod'`. */
+        readonly vendor: string;
+        /** Parse unknown input. Hexok `validate` rejects a returned Promise. */
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        /** Present so `Infer` can read input/output. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** Success or failure from `~standard.validate`. Not hexok `Result`. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** Passed validation. `issues` is absent. */
+    interface SuccessResult<Output> {
+        readonly value: Output;
+        readonly issues?: undefined;
+    }
+    /** Failed validation. `issues` is always present. */
+    interface FailureResult {
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** One validation problem. Hexok `validate` copies these onto the fail arm. */
+    interface Issue {
+        readonly message: string;
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** Path entry when the key is not a plain PropertyKey. */
+    interface PathSegment {
+        readonly key: PropertyKey;
+    }
+    /** Inferred input and output types carried on `~standard.types`. */
+    interface Types<Input = unknown, Output = Input> {
+        readonly input: Input;
+        readonly output: Output;
+    }
+    /** Input type of a Standard Schema. Prefer hexok `Infer` for output. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Output type of a Standard Schema. Same as hexok `Infer`. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+//# sourceMappingURL=standard-schema.d.ts.map

package/dist/core/standard-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../../src/core/standard-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/D,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,oEAAoE;IACpE,UAAiB,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QACpD,gCAAgC;QAChC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,yCAAyC;QACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,wEAAwE;QACxE,QAAQ,CAAC,QAAQ,EAAE,CACjB,KAAK,EAAE,OAAO,KACX,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,gDAAgD;QAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;KACnD;IAED,wEAAwE;IACxE,KAAY,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;IAEnE,6CAA6C;IAC7C,UAAiB,aAAa,CAAC,MAAM;QACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;KAC7B;IAED,qDAAqD;IACrD,UAAiB,aAAa;QAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;KACvC;IAED,+EAA+E;IAC/E,UAAiB,KAAK;QACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC;KACtE;IAED,0DAA0D;IAC1D,UAAiB,WAAW;QAC1B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;KAC3B;IAED,oEAAoE;IACpE,UAAiB,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QACpD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB;IAED,wEAAwE;IACxE,KAAY,UAAU,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CACnE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,OAAO,CAAC,CAAC;IAEX,+DAA+D;IAC/D,KAAY,WAAW,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CACpE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,QAAQ,CAAC,CAAC;CACb"}

package/dist/core/standard-schema.js

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

package/dist/core/standard-schema.js.map

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

package/dist/domain/capabilities.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Optional adapter capabilities. Intersect these with a port interface.
+ * Pass `{ transactional: true }` / `{ requestScoped: true }` to `Port.token`
+ * so `provide()` throws if the impl is missing `bindTo` / `fork`.
+ *
+ * ```ts
+ * class PgIncidentRepo implements IncidentRepository, Transactional<IncidentRepository> {
+ *   bindTo(uow: UnitOfWork): IncidentRepository { return this }
+ * }
+ * ```
+ */
+export interface UnitOfWork {
+    /** Register work to run after a successful commit. */
+    onCommit(fn: () => void | Promise<void>): void;
+    /** Register work to run after a rollback. */
+    onRollback(fn: () => void | Promise<void>): void;
+}
+/** Port capability: the adapter can bind itself to a unit of work. */
+export interface Transactional<T = unknown> {
+    /** Return this port bound to `uow` (often `return this`). */
+    bindTo(uow: UnitOfWork): T;
+}
+/** Port capability: the adapter can fork a request-scoped instance. */
+export interface RequestScoped<T = unknown> {
+    /** Return a new instance scoped to the current request. */
+    fork(): T;
+}
+/**
+ * Standard repository shape. Authors write their own port interface;
+ * this is the contract `InMemoryRepository` can fake.
+ */
+export interface CrudRepository<E> {
+    /** Load one entity by id, or `null` if missing. */
+    get(id: string): Promise<E | null>;
+    /** Persist an entity. Adapters call `entity.commit()` after a successful write. */
+    save(entity: E): Promise<void>;
+    /** List all entities. Optional on the port. */
+    list?(): Promise<E[]>;
+    /** Delete by id. Optional on the port. */
+    delete?(id: string): Promise<void>;
+}
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/domain/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,6CAA6C;IAC7C,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,6DAA6D;IAC7D,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,CAAC;CAC5B;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,2DAA2D;IAC3D,IAAI,IAAI,CAAC,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,mDAAmD;IACnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACnC,mFAAmF;IACnF,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,+CAA+C;IAC/C,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACtB,0CAA0C;IAC1C,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/domain/capabilities.js

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

package/dist/domain/capabilities.js.map

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

package/dist/domain/catalog.d.ts

@@ -0,0 +1,46 @@
+import type { CatalogKind } from './envelope.js';
+import type { EventClass, EventWithCtx } from './event.js';
+/**
+ * Registry of event classes. `kind` is `'bus'` (fan-out, fire-and-forget, no
+ * persistence) or `'queue'` (work queue: one consumer in a group, ack/nack).
+ * `.event()` accumulates each class on the covariant `Events` generic (empty is `never`).
+ * Use-case convention: `static publishes = [DomainEvents] as const`.
+ *
+ * ```ts
+ * const DomainEvents = new EventCatalog('domain', { kind: 'bus' })
+ *   .event(IncidentClosed)
+ * DomainEvents.get(IncidentClosed)
+ * DomainEvents.incident.closed // when every segment is a JS identifier
+ * ```
+ */
+export declare class EventCatalog<Key extends string = string, Kind extends CatalogKind = CatalogKind, out Events extends EventClass = never, out Ctx = undefined> {
+    #private;
+    /** Catalog name, copied onto envelopes and used in error messages. */
+    readonly key: Key;
+    /** `'bus'` (fan-out) or `'queue'` (work queue). Copied onto every envelope. */
+    readonly kind: Kind;
+    /** Create a named `'bus'` or `'queue'` catalog. Chain `.event(...)` then `.freeze()`. */
+    constructor(key: Key, options: {
+        kind: Kind;
+    });
+    /** Require `ctx: C` on every event in this catalog. Call before `.event()`. */
+    ctx<C>(): EventCatalog<Key, Kind, Events, C>;
+    /** True after `.ctx()` — every registered event must expose `ctx`. */
+    get hasCtx(): boolean;
+    /** Registered event classes, in registration order. */
+    list(): EventClass[];
+    /** Register an event class. Dotted keys become nested properties when each segment is a JS identifier. */
+    event<E extends EventClass>(eventClass: [Ctx] extends [undefined] ? E : EventWithCtx<E, Ctx>): EventCatalog<Key, Kind, Events | E, Ctx>;
+    /** Look up a registered class. Throws if it is not in this catalog. */
+    get<E extends EventClass>(eventClass: E): E;
+    /** Seal the catalog. Further `.event()` / `.ctx()` throw. */
+    freeze(): EventCatalog<Key, Kind, Events, Ctx>;
+    /** True after `.freeze()`. */
+    get frozen(): boolean;
+    private assertWritable;
+}
+/** Safe annotation / Map key. Bare `EventCatalog` is Events=never and rejects populated catalogs. */
+export type AnyEventCatalog = EventCatalog<string, CatalogKind, EventClass, unknown>;
+/** Event classes registered on `Cat`, or `never` when the catalog is empty. */
+export type CatalogEvents<Cat> = Cat extends EventCatalog<infer _Key, infer _Kind, infer E extends EventClass, infer _Ctx> ? E : never;
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/domain/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI3D;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY,CACvB,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,IAAI,SAAS,WAAW,GAAG,WAAW,EACtC,GAAG,CAAC,MAAM,SAAS,UAAU,GAAG,KAAK,EACrC,GAAG,CAAC,GAAG,GAAG,SAAS;;IAEnB,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAKpB,yFAAyF;gBAC7E,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE;IAK7C,+EAA+E;IAC/E,GAAG,CAAC,CAAC,KAAK,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAc5C,sEAAsE;IACtE,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,uDAAuD;IACvD,IAAI,IAAI,UAAU,EAAE;IAIpB,0GAA0G;IAC1G,KAAK,CAAC,CAAC,SAAS,UAAU,EACxB,UAAU,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,GAC/D,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,CAAC;IAkB3C,uEAAuE;IACvE,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC;IAU3C,6DAA6D;IAC7D,MAAM,IAAI,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC;IAO9C,8BAA8B;IAC9B,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,CAAC,cAAc;CAKvB;AAED,qGAAqG;AACrG,MAAM,MAAM,eAAe,GAAG,YAAY,CACxC,MAAM,EACN,WAAW,EACX,UAAU,EACV,OAAO,CACR,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,aAAa,CAAC,GAAG,IAC3B,GAAG,SAAS,YAAY,CACtB,MAAM,IAAI,EACV,MAAM,KAAK,EACX,MAAM,CAAC,SAAS,UAAU,EAC1B,MAAM,IAAI,CACX,GACG,CAAC,GACD,KAAK,CAAC"}

package/dist/domain/catalog.js

@@ -0,0 +1,114 @@
+const IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/**
+ * Registry of event classes. `kind` is `'bus'` (fan-out, fire-and-forget, no
+ * persistence) or `'queue'` (work queue: one consumer in a group, ack/nack).
+ * `.event()` accumulates each class on the covariant `Events` generic (empty is `never`).
+ * Use-case convention: `static publishes = [DomainEvents] as const`.
+ *
+ * ```ts
+ * const DomainEvents = new EventCatalog('domain', { kind: 'bus' })
+ *   .event(IncidentClosed)
+ * DomainEvents.get(IncidentClosed)
+ * DomainEvents.incident.closed // when every segment is a JS identifier
+ * ```
+ */
+export class EventCatalog {
+    /** Catalog name, copied onto envelopes and used in error messages. */
+    key;
+    /** `'bus'` (fan-out) or `'queue'` (work queue). Copied onto every envelope. */
+    kind;
+    #events = new Map();
+    #frozen = false;
+    #hasCtx = false;
+    /** Create a named `'bus'` or `'queue'` catalog. Chain `.event(...)` then `.freeze()`. */
+    constructor(key, options) {
+        this.key = key;
+        this.kind = options.kind;
+    }
+    /** Require `ctx: C` on every event in this catalog. Call before `.event()`. */
+    ctx() {
+        this.assertWritable();
+        if (this.#hasCtx) {
+            throw new Error(`hexok: catalog "${this.key}" already has ctx`);
+        }
+        if (this.#events.size > 0) {
+            throw new Error(`hexok: catalog "${this.key}" ctx() must be called before .event()`);
+        }
+        this.#hasCtx = true;
+        return this;
+    }
+    /** True after `.ctx()` — every registered event must expose `ctx`. */
+    get hasCtx() {
+        return this.#hasCtx;
+    }
+    /** Registered event classes, in registration order. */
+    list() {
+        return [...this.#events.values()];
+    }
+    /** Register an event class. Dotted keys become nested properties when each segment is a JS identifier. */
+    event(eventClass) {
+        this.assertWritable();
+        const ctor = eventClass;
+        const eventKey = ctor.key;
+        if (this.#events.has(eventKey)) {
+            throw new Error(`hexok: duplicate event "${eventKey}" in catalog "${this.key}"`);
+        }
+        this.#events.set(eventKey, ctor);
+        nestIdentifierPath(this, eventKey, ctor);
+        return this;
+    }
+    /** Look up a registered class. Throws if it is not in this catalog. */
+    get(eventClass) {
+        const found = this.#events.get(eventClass.key);
+        if (!found) {
+            throw new Error(`hexok: event "${eventClass.key}" is not in catalog "${this.key}"`);
+        }
+        return found;
+    }
+    /** Seal the catalog. Further `.event()` / `.ctx()` throw. */
+    freeze() {
+        if (this.#frozen)
+            return this;
+        this.#frozen = true;
+        Object.freeze(this);
+        return this;
+    }
+    /** True after `.freeze()`. */
+    get frozen() {
+        return this.#frozen;
+    }
+    assertWritable() {
+        if (this.#frozen) {
+            throw new Error(`hexok: catalog "${this.key}" is frozen`);
+        }
+    }
+}
+function nestIdentifierPath(root, dotted, value) {
+    const parts = dotted.split('.');
+    if (parts.length === 0 || parts.some((part) => !IDENT.test(part))) {
+        return;
+    }
+    let cursor = root;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        if (key === undefined)
+            return;
+        const existing = cursor[key];
+        if (existing === undefined) {
+            const next = Object.create(null);
+            cursor[key] = next;
+            cursor = next;
+            continue;
+        }
+        if (typeof existing === 'object' && existing !== null) {
+            cursor = existing;
+            continue;
+        }
+        return;
+    }
+    const last = parts[parts.length - 1];
+    if (last === undefined)
+        return;
+    cursor[last] = value;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/domain/catalog.js.map

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

package/dist/domain/channel.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Byte sink for one connected client. WebSocket and SSE adapters wrap their
+ * native connection as this shape.
+ */
+export type ChannelConnection = {
+    /** Write one frame to this client. */
+    send(data: string): void;
+    /** Disconnect this client. */
+    close(): void;
+    /** Subscribe to the native close. */
+    addEventListener(type: 'close', listener: () => void): void;
+};
+/**
+ * Local presence + send. Bound with `.route(Channel, adapter)`.
+ * Does not interpret routing hints or session claims.
+ */
+export interface ChannelAdapter<Session = unknown> {
+    /** Bind a connected client into local presence. */
+    join(id: string, session: Session, connection: ChannelConnection): void;
+    /** Remove a client that left. */
+    leave(id: string): void;
+    /** Force-disconnect a client. */
+    eject(id: string): void;
+    /** Replace the session attached to a connected id. */
+    update(id: string, session: Session): void;
+    /** Snapshot of who is present. */
+    list(): ReadonlyArray<{
+        id: string;
+        session: Session;
+    }>;
+    /** Send a payload to one connected id. */
+    send(id: string, payload: string): void;
+    /** Tear down the adapter. Optional. */
+    stop?(): Promise<void>;
+}
+//# sourceMappingURL=channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/domain/channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sCAAsC;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,qCAAqC;IACrC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC7D,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAC/C,mDAAmD;IACnD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxE,iCAAiC;IACjC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sDAAsD;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,kCAAkC;IAClC,IAAI,IAAI,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxD,0CAA0C;IAC1C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,uCAAuC;IACvC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/domain/channel.js

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

package/dist/domain/channel.js.map

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

package/dist/domain/cow-draft.d.ts

@@ -0,0 +1,10 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function applyCowDraft<T extends object>(root: T, owned: WeakSet<object> | undefined, producer: (draft: T) => void): {
+    root: T;
+    owned: WeakSet<object> | undefined;
+    wrote: boolean;
+};
+export declare function frozenSnapshot<T>(value: T): T;
+/** Unfrozen deep clone of plain objects, arrays, and `Date`. */
+export declare function cloneValue<T>(value: T): T;
+//# sourceMappingURL=cow-draft.d.ts.map

package/dist/domain/cow-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cow-draft.d.ts","sourceRoot":"","sources":["../../src/domain/cow-draft.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKlC;AAMD,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,EAClC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC3B;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CA+FjE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE7C;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEzC"}