hexok 1.0.1 → 2.1.0

package/dist/{domain/entity.js → entity.js}

@@ -1,46 +1,38 @@
-import { CodedError, validate, validationError, } from '../core/index.js';
+import { validationError } from './coded-error.js';
 import { applyCowDraft, cloneValue, frozenSnapshot, isPlainObject, } from './cow-draft.js';
+import { schemaDefinition, } from './schema.js';
+import { validate } from './validate.js';
 const EMPTY_CHANGED_KEYS = Object.freeze([]);
-/**
- * Aggregates mutate **this** via `set` and return `this`.
- * They never I/O, never publish, never hold ports.
- *
- * Validation, invariants, and declared refusals **throw**.
- * `create` / `parse` run the schema. `restore` does not — it rehydrates
- * mapper output as-is. `set` re-runs the schema after a write.
- * `validate()` is the optional fail-fast for a restored instance.
- *
- * ```ts
- * class Incident extends Entity<IncidentProps> {
- *   static readonly key = 'Incident'
- *   static readonly schema = z.object({ id: z.string(), status: z.enum(['open', 'closed']) })
- *   static readonly errors = { ALREADY_CLOSED: { message: 'Incident already closed' } } as const
- *   close(now: Date): this {
- *     if (this.props.status === 'closed') Incident.error('ALREADY_CLOSED')
- *     return this.set((draft) => {
- *       draft.status = 'closed'
- *       draft.closedAt = now
- *     })
- *   }
- * }
- * ```
- */
-export class Entity {
-    /** Entity name used in validation and undeclared-error messages. Declare on each subclass. */
-    static key;
-    /** Standard Schema for `create` / `parse` / `set` / `validate()`. Declare on each subclass. */
+export function Entity(token, schema) {
+    const definition = schemaDefinition(schema);
+    class EntityClass extends EntityBase {
+        /** Entity name. Literal type of the string passed to {@link Entity}. */
+        static token = token;
+        /** Schema used by `create`, `parse`, `set`, and `validate`. */
+        static schema = definition;
+        /** Nominal marker. Each `Entity(...)` call is a distinct class. */
+        #brand = true;
+        constructor(props) {
+            super(props);
+            void this.#brand;
+        }
+    }
+    return EntityClass;
+}
+class EntityBase {
+    /** Entity name used in validation messages. */
+    static token;
+    /** Schema for `create` / `parse` / `set` / `validate()`. */
     static schema;
-    /** Declared refusal codes. Keys are the `error()` union. Declare on each subclass. */
-    static errors;
     #isNew = false;
     #validated = false;
     #original = undefined;
     #owned = undefined;
     #snapshot = undefined;
-    _props;
+    #props;
     /** Live props. Read-only; write through `set`. */
     get props() {
-        return this._props;
+        return this.#props;
     }
     /** True after `create` until `commit`. `restore` / `parse` start false. */
     get isNew() {
@@ -59,22 +51,22 @@ export class Entity {
      */
     get original() {
         if (this.#original === undefined ||
-            Object.is(this._props, this.#original)) {
+            Object.is(this.#props, this.#original)) {
             return undefined;
         }
         return this.#original;
     }
     constructor(props) {
-        this._props = props;
+        this.#props = props;
     }
-    /** Copy-on-write mutate. Edit `draft` and return `this`. Re-validates the schema after a write. */
+    /** Copy-on-write mutate. Edit `draft` and return `this`. Re-validates after a write. */
     set(producer) {
-        const previousRoot = this._props;
-        const backup = cloneValue(this._props);
+        const previousRoot = this.#props;
+        const backup = cloneValue(this.#props);
         const previousSnapshot = this.#snapshot;
-        const wasOwned = this.#owned?.has(this._props) === true;
-        const result = applyCowDraft(this._props, this.#owned, producer);
-        this._props = result.root;
+        const wasOwned = this.#owned?.has(this.#props) === true;
+        const result = applyCowDraft(this.#props, this.#owned, producer);
+        this.#props = result.root;
         this.#owned = result.owned;
         if (result.wrote) {
             this.#snapshot = undefined;
@@ -82,7 +74,7 @@ export class Entity {
                 this.#assertSchema();
             }
             catch (error) {
-                this._props = wasOwned ? backup : previousRoot;
+                this.#props = wasOwned ? backup : previousRoot;
                 this.#owned = wasOwned ? new WeakSet([backup]) : undefined;
                 this.#snapshot = previousSnapshot;
                 throw error;
@@ -105,18 +97,18 @@ export class Entity {
     }
     getChangedKeys(opts) {
         if (!this.#isNew &&
-            (this.#original === undefined || Object.is(this._props, this.#original))) {
+            (this.#original === undefined || Object.is(this.#props, this.#original))) {
             return EMPTY_CHANGED_KEYS;
         }
         if (opts?.deep) {
             const out = [];
-            diffDeep(this._props, this.#isNew ? undefined : this.#original, '', out);
+            diffDeep(this.#props, this.#isNew ? undefined : this.#original, '', out);
             return out.length === 0 ? EMPTY_CHANGED_KEYS : out;
         }
         if (this.#isNew) {
-            return Object.keys(this._props);
+            return Object.keys(this.#props);
         }
-        const current = this._props;
+        const current = this.#props;
         const original = this.#original;
         const keys = new Set([
             ...Object.keys(current),
@@ -134,9 +126,9 @@ export class Entity {
     isDirty() {
         return this.#isNew || this.getChangedKeys().length > 0;
     }
-    /** Accept current props as original; `isNew` becomes false. Adapters after persist; not use-cases. */
+    /** Accept current props as original; `isNew` becomes false. */
     commit() {
-        this.#original = this._props;
+        this.#original = this.#props;
         this.#isNew = false;
         this.#owned = undefined;
         return this;
@@ -144,7 +136,7 @@ export class Entity {
     /** Deep frozen snapshot for persistence and use-case output. Reused until the next `set`. */
     toProps() {
         if (this.#snapshot === undefined) {
-            this.#snapshot = frozenSnapshot(this._props);
+            this.#snapshot = frozenSnapshot(this.#props);
         }
         return this.#snapshot;
     }
@@ -152,15 +144,6 @@ export class Entity {
     toJSON() {
         return this.toProps();
     }
-    /**
-     * Throw a declared entity error. Codes are the keys of the subclass
-     * `static errors` when called as `Incident.error('ALREADY_CLOSED')`.
-     * An undeclared code is a type error on that call, and a programming
-     * error at runtime.
-     */
-    static error(code, data) {
-        throwEntityError(this, code, data);
-    }
     /**
      * Validate typed props and construct a new instance (`isNew: true`).
      * Throws `CodedError` `VALIDATION` if the schema rejects the props.
@@ -173,8 +156,8 @@ export class Entity {
     }
     /**
      * Reconstruct an existing instance (`isNew: false`) without running the
-     * schema. Props are stored as given (no strip/defaults). `isValidated`
-     * starts false until `set` writes or `validate()` runs.
+     * schema. Props are stored as given. `isValidated` starts false until
+     * `set` writes or `validate()` runs.
      */
     static restore(props) {
         const instance = construct(this, props);
@@ -182,8 +165,8 @@ export class Entity {
         return instance;
     }
     /**
-     * Trust boundary for untyped input. Validates like `create`;
-     * tracking matches `restore` (`isNew: false`).
+     * Trust boundary for untyped input. Validates like `create`.
+     * Tracking matches `restore` (`isNew: false`).
      * Throws `CodedError` `VALIDATION` if the schema rejects the value.
      */
     static parse(value) {
@@ -193,31 +176,31 @@ export class Entity {
         return instance;
     }
     #markNew() {
-        this._props = { ...this._props };
+        this.#props = { ...this.#props };
         this.#original = undefined;
         this.#isNew = true;
         this.#owned = new WeakSet();
-        this.#owned.add(this._props);
+        this.#owned.add(this.#props);
         this.#snapshot = undefined;
     }
     #markRestored() {
-        this.#original = this._props;
+        this.#original = this.#props;
         this.#isNew = false;
         this.#owned = undefined;
         this.#snapshot = undefined;
     }
     #assertSchema() {
-        const Ctor = this.constructor;
-        const parsed = validate(Ctor.schema, this._props);
+        const ctor = this.constructor;
+        const parsed = validate(ctor.schema, this.#props);
         if (!parsed.ok) {
-            throw validationError(`hexok: ${Ctor.key} validation failed`, parsed.issues);
+            throw validationError(`hexok: ${ctor.token} validation failed`, parsed.issues);
         }
     }
 }
 function instantiate(Ctor, value) {
     const parsed = validate(Ctor.schema, value);
     if (!parsed.ok) {
-        throw validationError(`hexok: ${Ctor.key} validation failed`, parsed.issues);
+        throw validationError(`hexok: ${Ctor.token} validation failed`, parsed.issues);
     }
     return construct(Ctor, parsed.value);
 }
@@ -249,15 +232,4 @@ function diffDeep(current, original, path, out) {
     if (path)
         out.push(path);
 }
-function throwEntityError(ctor, code, data) {
-    const def = ctor.errors[code];
-    if (def === undefined) {
-        throw new Error(`hexok: undeclared error "${code}" on ${ctor.key}`);
-    }
-    throw new CodedError({
-        code,
-        message: def.message ?? code,
-        ...(data !== undefined ? { data } : {}),
-    });
-}
 //# sourceMappingURL=entity.js.map

package/dist/entity.js.map

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

package/dist/error-map.d.ts

@@ -0,0 +1,22 @@
+import type { StandardSchemaV1 } from './standard-schema.js';
+/**
+ * One code in an {@link Errors} catalog. The key of an {@link ErrorMap} is the code.
+ *
+ * ```ts
+ * const defs = {
+ *   UserExists: { message: 'User already exists' },
+ * }
+ * ```
+ */
+export interface ErrorDef {
+    /**
+     * Default message. The factory uses the code when this is omitted.
+     * A call may override it by passing a string first.
+     */
+    message?: string;
+    /** Payload schema. The member factory requires this schema's output. */
+    data?: StandardSchemaV1;
+}
+/** Definition map passed to {@link Errors}. Keys are the member codes. */
+export type ErrorMap = Record<string, ErrorDef>;
+//# sourceMappingURL=error-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-map.d.ts","sourceRoot":"","sources":["../src/error-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC"}

package/dist/error-map.js

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

package/dist/error-map.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,85 @@
+import type { ErrorMap } from './error-map.js';
+import type { StandardSchemaV1 } from './standard-schema.js';
+import type { Infer } from './validate.js';
+/**
+ * Nominal catalog brand. The symbol is shared. The type argument is the
+ * catalog token, so two catalogs are not the same error.
+ */
+export declare const catalogBrand: unique symbol;
+type MessageOf<Code extends string, Def> = Def extends {
+    readonly message: infer M extends string;
+} ? M : Code;
+type DataOf<Def> = Def extends {
+    readonly data: infer S extends StandardSchemaV1;
+} ? Infer<S> : undefined;
+/** One member. `code` and `data` are the pair a gateway matches on. */
+export type CatalogMember<Token extends string, Code extends string, Message extends string, Data> = Error & {
+    readonly [catalogBrand]: Token;
+    readonly catalog: Token;
+    readonly code: Code;
+    readonly message: Message;
+    readonly data: Data;
+};
+/** Discriminated union of every member. Returned by {@link ErrorsHandle.is}. */
+export type CatalogUnion<Token extends string, M> = {
+    [K in keyof M & string]: CatalogMember<Token, K, string, DataOf<M[K]>>;
+}[keyof M & string];
+/**
+ * One object type so `class X extends Errors(...)` is legal.
+ * A union here is TS2509. Payloads are discriminated by `is()`.
+ */
+export interface CatalogInstance<Token extends string, M extends ErrorMap> extends Error {
+    readonly [catalogBrand]: Token;
+    readonly catalog: Token;
+    readonly code: keyof M & string;
+    readonly data: unknown;
+}
+type MatchReturns<Keys extends string> = Record<Keys, any>;
+type Matchers<Token extends string, M, R extends MatchReturns<keyof M & string>> = {
+    [K in keyof M & string]: (error: CatalogMember<Token, K, string, DataOf<M[K]>>) => R[K];
+};
+/**
+ * Message, when passed, is the first argument. The catalog message is the default.
+ * With `data`: `(data)` or `(message, data)`. Without `data`: `()` or `(message)`.
+ */
+type Factory<Token extends string, Code extends string, Def> = Def extends {
+    readonly data: infer S extends StandardSchemaV1;
+} ? {
+    <M extends string>(message: M, data: Infer<S>): CatalogMember<Token, Code, M, Infer<S>>;
+    (data: Infer<S>): CatalogMember<Token, Code, MessageOf<Code, Def>, Infer<S>>;
+} : {
+    (): CatalogMember<Token, Code, MessageOf<Code, Def>, undefined>;
+    <M extends string>(message: M): CatalogMember<Token, Code, M, undefined>;
+};
+/**
+ * Abstract constructor, `is`, `match`, and one static factory per code.
+ * Factories return the error. The caller throws.
+ * `init: never` blocks `new DomainError()`.
+ */
+export type ErrorsHandle<Token extends string, M extends ErrorMap> = {
+    readonly token: Token;
+    readonly prototype: CatalogInstance<Token, M>;
+    is(error: unknown): error is CatalogUnion<Token, M>;
+    match<R extends MatchReturns<keyof M & string>>(error: CatalogUnion<Token, M>, cases: Matchers<Token, M, R>): R[keyof R & keyof M & string];
+} & {
+    [K in keyof M & string]: Factory<Token, K, M[K]>;
+} & (abstract new (init: never) => CatalogInstance<Token, M>);
+/**
+ * Branded error catalog. Throw a member from any layer. A gateway imports
+ * the catalog and maps it. The catalog does not know about HTTP.
+ *
+ * ```ts
+ * class DomainError extends Errors('domain', {
+ *   BlankName: { message: 'Name is blank' },
+ *   UserExists: { message: 'User already exists', data: z.object({ id: z.string() }) },
+ * }) {}
+ *
+ * throw DomainError.BlankName()
+ * throw DomainError.BlankName('Name cannot be empty')
+ * throw DomainError.UserExists({ id })
+ * throw DomainError.UserExists('User ada already exists', { id })
+ * ```
+ */
+export declare function Errors<const Token extends string, const M extends ErrorMap>(token: Token, defs: M): ErrorsHandle<Token, M>;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,85 @@
+/**
+ * Nominal catalog brand. The symbol is shared. The type argument is the
+ * catalog token, so two catalogs are not the same error.
+ */
+export const catalogBrand = Symbol('hexok.catalog');
+const RESERVED = new Set(['is', 'match', 'prototype', 'token']);
+/**
+ * Branded error catalog. Throw a member from any layer. A gateway imports
+ * the catalog and maps it. The catalog does not know about HTTP.
+ *
+ * ```ts
+ * class DomainError extends Errors('domain', {
+ *   BlankName: { message: 'Name is blank' },
+ *   UserExists: { message: 'User already exists', data: z.object({ id: z.string() }) },
+ * }) {}
+ *
+ * throw DomainError.BlankName()
+ * throw DomainError.BlankName('Name cannot be empty')
+ * throw DomainError.UserExists({ id })
+ * throw DomainError.UserExists('User ada already exists', { id })
+ * ```
+ */
+export function Errors(token, defs) {
+    for (const code of Object.keys(defs)) {
+        if (RESERVED.has(code)) {
+            throw new Error(`hexok: error code "${code}" is reserved`);
+        }
+    }
+    class CatalogError extends Error {
+        /** Catalog name. Literal type of the string passed to {@link Errors}. */
+        static token = token;
+        catalog = token;
+        code;
+        data;
+        [catalogBrand];
+        /** Per-call class identity. Public nominality is `catalogBrand`. */
+        #brand = true;
+        constructor(code, message, data) {
+            super(message);
+            this.name = `${token}.${code}`;
+            this.code = code;
+            this.data = data;
+            this[catalogBrand] = token;
+            void this.#brand;
+        }
+        /** True when `error` is a member of this catalog. */
+        static is(error) {
+            return error instanceof this;
+        }
+        /**
+         * Run the handler for `error.code`. A missing handler is a type error.
+         * An unknown code at runtime is a programming error.
+         */
+        static match(error, cases) {
+            const handler = cases[error.code];
+            if (handler === undefined) {
+                throw new Error(`hexok: unmatched ${token}.${error.code}`);
+            }
+            return handler(error);
+        }
+    }
+    for (const code of Object.keys(defs)) {
+        const def = defs[code];
+        if (def === undefined)
+            continue;
+        const fallback = def.message ?? code;
+        const withData = def.data !== undefined;
+        Object.defineProperty(CatalogError, code, {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value(...args) {
+                if (!withData) {
+                    return new this(code, args.length === 0 ? fallback : args[0], undefined);
+                }
+                if (args.length > 1) {
+                    return new this(code, args[0], args[1]);
+                }
+                return new this(code, fallback, args[0]);
+            },
+        });
+    }
+    return CatalogError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkB,MAAM,CAAC,eAAe,CAAC,CAAC;AAEnE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAyGhE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,MAAM,CACpB,KAAY,EACZ,IAAO;IAEP,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,eAAe,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,MAAe,YAAa,SAAQ,KAAK;QACvC,yEAAyE;QACzE,MAAM,CAAU,KAAK,GAAU,KAAK,CAAC;QAC5B,OAAO,GAAU,KAAK,CAAC;QACvB,IAAI,CAAS;QACb,IAAI,CAAU;QACd,CAAC,YAAY,CAAC,CAAQ;QAC/B,oEAAoE;QAC3D,MAAM,GAAG,IAAI,CAAC;QAEvB,YAAY,IAAY,EAAE,OAAe,EAAE,IAAa;YACtD,KAAK,CAAC,OAAO,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;YAC3B,KAAK,IAAI,CAAC,MAAM,CAAC;QACnB,CAAC;QAED,qDAAqD;QACrD,MAAM,CAAC,EAAE,CAAC,KAAc;YACtB,OAAO,KAAK,YAAY,IAAI,CAAC;QAC/B,CAAC;QAED;;;WAGG;QACH,MAAM,CAAC,KAAK,CACV,KAA6B,EAC7B,KAA4B;YAE5B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,IAAwB,CAAC,CAAC;YACtD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,OAAO,CAAC,KAAc,CAAC,CAAC;QACjC,CAAC;;IAGH,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE;YACxC,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,KAAK,CAAkB,GAAG,IAAe;gBACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,IAAI,IAAI,CACb,IAAI,EACJ,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAY,EAClD,SAAS,CACV,CAAC;gBACJ,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpD,CAAC;gBACD,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,YAAiD,CAAC;AAC3D,CAAC"}

package/dist/event-handler.d.ts

@@ -0,0 +1,31 @@
+import type { EventConstructor } from './catalog.js';
+type EventInstanceOf<Event> = Event extends abstract new (...args: never[]) => infer Instance ? Instance : never;
+/**
+ * Application service for one event. Pass ports through the constructor.
+ * `handle` is required; the compiler errors on the class when it is missing.
+ * Annotate the event parameter with the event class.
+ *
+ * ```ts
+ * class OnUserCreated extends EventHandler('on.user.created', UserCreated) {
+ *   handle(event: UserCreated): void {
+ *     event.payload.email
+ *   }
+ * }
+ * ```
+ */
+export declare function EventHandler<const Token extends string, E extends EventConstructor>(token: Token, event: E): (abstract new () => {
+    /** Nominal marker. Each `EventHandler(...)` call is a distinct class. */
+    readonly "__#private@#brand": true;
+    /**
+     * Required. Annotate `event` with the event class passed to
+     * {@link EventHandler}. Return `void` or `Promise<void>`.
+     */
+    handle(event: EventInstanceOf<E>): Promise<void> | void;
+}) & {
+    /** Handler name. Literal type of the string passed to {@link EventHandler}. */
+    readonly token: Token;
+    /** Event class this handler receives. */
+    readonly event: E;
+};
+export {};
+//# sourceMappingURL=event-handler.d.ts.map

package/dist/event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.d.ts","sourceRoot":"","sources":["../src/event-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,KAAK,eAAe,CAAC,KAAK,IAAI,KAAK,SAAS,QAAQ,MAClD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb,MAAM,QAAQ,GACf,QAAQ,GACR,KAAK,CAAC;AAEV;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,KAAK,CAAC,KAAK,SAAS,MAAM,EAC1B,CAAC,SAAS,gBAAgB,EAC1B,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAQpB,yEAAyE;kCACvD,IAAI;IAMtB;;;OAGG;uCAC+B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;;IAftD,+EAA+E;oBACxD,KAAK;IAC5B,yCAAyC;oBAClB,CAAC;EAgB3B"}

package/dist/event-handler.js

@@ -0,0 +1,28 @@
+/**
+ * Application service for one event. Pass ports through the constructor.
+ * `handle` is required; the compiler errors on the class when it is missing.
+ * Annotate the event parameter with the event class.
+ *
+ * ```ts
+ * class OnUserCreated extends EventHandler('on.user.created', UserCreated) {
+ *   handle(event: UserCreated): void {
+ *     event.payload.email
+ *   }
+ * }
+ * ```
+ */
+export function EventHandler(token, event) {
+    class HandlerClass {
+        /** Handler name. Literal type of the string passed to {@link EventHandler}. */
+        static token = token;
+        /** Event class this handler receives. */
+        static event = event;
+        /** Nominal marker. Each `EventHandler(...)` call is a distinct class. */
+        #brand = true;
+        constructor() {
+            void this.#brand;
+        }
+    }
+    return HandlerClass;
+}
+//# sourceMappingURL=event-handler.js.map

package/dist/event-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.js","sourceRoot":"","sources":["../src/event-handler.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAG1B,KAAY,EAAE,KAAQ;IAGtB,MAAe,YAAY;QACzB,+EAA+E;QAC/E,MAAM,CAAU,KAAK,GAAU,KAAK,CAAC;QACrC,yCAAyC;QACzC,MAAM,CAAU,KAAK,GAAM,KAAK,CAAC;QACjC,yEAAyE;QAChE,MAAM,GAAG,IAAI,CAAC;QAEvB;YACE,KAAK,IAAI,CAAC,MAAM,CAAC;QACnB,CAAC;;IASH,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/event.d.ts

@@ -0,0 +1,37 @@
+import { type InferSchema, type ResolvedSchema, type SchemaSource } from './schema.js';
+/**
+ * A fact the domain records. The token and payload schema are arguments.
+ * `new` trusts an already-typed payload. `parse` validates unknown input.
+ *
+ * ```ts
+ * class UserCreated extends Event('user.created', userSchema) {}
+ * ```
+ */
+export declare function Event<const Token extends string, S extends SchemaSource>(token: Token, schema: S): {
+    new (payload: InferSchema<S>): {
+        /** Nominal marker. Each `Event(...)` call is a distinct class. */
+        readonly "__#private@#brand": true;
+        /** Event name. Same literal as the static token. */
+        readonly token: Token;
+        /** Typed payload. Not validated in the constructor. */
+        readonly payload: InferSchema<S>;
+    };
+    /** Event name. Literal type of the string passed to {@link Event}. */
+    readonly token: Token;
+    /** Payload schema. A Schema class is stored as its definition. */
+    readonly schema: ResolvedSchema<S>;
+    /**
+     * Validate `value` and construct an event.
+     * Throws `CodedError` `VALIDATION` when the schema rejects it.
+     * A subclass receives its own instance. Override to customize the boundary.
+     */
+    parse<T extends {
+        /** Nominal marker. Each `Event(...)` call is a distinct class. */
+        readonly "__#private@#brand": true;
+        /** Event name. Same literal as the static token. */
+        readonly token: Token;
+        /** Typed payload. Not validated in the constructor. */
+        readonly payload: InferSchema<S>;
+    }>(this: new (payload: InferSchema<S>) => T, value: unknown): T;
+};
+//# sourceMappingURL=event.d.ts.map

package/dist/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAGrB;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,EACtE,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,CAAC;kBAiBc,WAAW,CAAC,CAAC,CAAC;QAPnC,kEAAkE;sCAChD,IAAI;QACtB,oDAAoD;wBACpC,KAAK;QACrB,uDAAuD;0BACrC,WAAW,CAAC,CAAC,CAAC;;IAVhC,sEAAsE;oBAC/C,KAAK;IAC5B,kEAAkE;qBAC1C,cAAc,CAAC,CAAC,CAAC;IAczC;;;;OAIG;UACU,CAAC;QAjBd,kEAAkE;sCAChD,IAAI;QACtB,oDAAoD;wBACpC,KAAK;QACrB,uDAAuD;0BACrC,WAAW,CAAC,CAAC,CAAC;aAaxB,KACJ,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KACpB,CAAC,SACC,OAAO,GACb,CAAC;EAaP"}

package/dist/event.js

@@ -0,0 +1,44 @@
+import { validationError } from './coded-error.js';
+import { schemaDefinition, } from './schema.js';
+import { validate } from './validate.js';
+/**
+ * A fact the domain records. The token and payload schema are arguments.
+ * `new` trusts an already-typed payload. `parse` validates unknown input.
+ *
+ * ```ts
+ * class UserCreated extends Event('user.created', userSchema) {}
+ * ```
+ */
+export function Event(token, schema) {
+    const definition = schemaDefinition(schema);
+    class EventClass {
+        /** Event name. Literal type of the string passed to {@link Event}. */
+        static token = token;
+        /** Payload schema. A Schema class is stored as its definition. */
+        static schema = definition;
+        /** Nominal marker. Each `Event(...)` call is a distinct class. */
+        #brand = true;
+        /** Event name. Same literal as the static token. */
+        token = token;
+        /** Typed payload. Not validated in the constructor. */
+        payload;
+        constructor(payload) {
+            this.payload = payload;
+            void this.#brand;
+        }
+        /**
+         * Validate `value` and construct an event.
+         * Throws `CodedError` `VALIDATION` when the schema rejects it.
+         * A subclass receives its own instance. Override to customize the boundary.
+         */
+        static parse(value) {
+            const parsed = validate(definition, value);
+            if (!parsed.ok) {
+                throw validationError(`hexok: ${token} validation failed`, parsed.issues);
+            }
+            return new this(parsed.value);
+        }
+    }
+    return EventClass;
+}
+//# sourceMappingURL=event.js.map

package/dist/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAIL,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CACnB,KAAY,EACZ,MAAS;IAET,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,UAAU;QACd,sEAAsE;QACtE,MAAM,CAAU,KAAK,GAAU,KAAK,CAAC;QACrC,kEAAkE;QAClE,MAAM,CAAU,MAAM,GAAsB,UAAU,CAAC;QAEvD,kEAAkE;QACzD,MAAM,GAAG,IAAI,CAAC;QACvB,oDAAoD;QAC3C,KAAK,GAAU,KAAK,CAAC;QAC9B,uDAAuD;QAC9C,OAAO,CAAiB;QAEjC,YAAY,OAAuB;YACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,KAAK,IAAI,CAAC,MAAM,CAAC;QACnB,CAAC;QAED;;;;WAIG;QACH,MAAM,CAAC,KAAK,CAIV,KAAc;YAEd,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,eAAe,CACnB,UAAU,KAAK,oBAAoB,EACnC,MAAM,CAAC,MAAM,CACd,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,KAAuB,CAAC,CAAC;QAClD,CAAC;;IAGH,OAAO,UAAU,CAAC;AACpB,CAAC"}