hexok 1.0.0 → 2.0.0

package/README.md

@@ -0,0 +1,9 @@
+# hexok
+
+TypeScript primitives for hexagonal software: `Schema`, `Entity`, `UseCase`, `Port`, `Adapter`, `Mapper`, `Event`, `EventCatalog`, `EventHandler`, and `Errors`. A `Mapper` subclass implements `fromSource` and `toSource`; adapters call `toModel` and `fromModel`.
+
+Import them from `hexok`. There is no HTTP layer and no composition root in this package. Construct use cases with the ports they need. A schema argument is a Standard Schema. Zod satisfies that interface. `@hexok/typebox` adapts a `typebox` 1 schematic: `typebox(schema)` infers `Static`, and `typeboxDecode(schema)` infers `StaticDecode` and decodes. `EventInstance<typeof Catalog>` is the catalog's event objects. `EventMessage<typeof Catalog>` is the `{ key, payload }` union an adapter sends. `message` and `parse` on the catalog convert between them.
+
+`UseCase.context<Ctx, Spec>()` is a family factory for a per-call context, optional guards, optional hooks, and required statics. The optional argument is a settings object with no keys yet. Pass nothing. `{}` is allowed. `guard` and `hooks` are methods, not fields of that object. A missing `<Ctx>` type argument is a type error. `Spec` defaults to no required statics. `.guard(fn)` and `.hooks(def)` each return the same factory. Order does not matter. Either may be omitted. Another `.guard()` runs after guards already registered. A second `.hooks()` throws `hexok: UseCase hooks are already set` when the factory is created, if the first registration had at least one callback. An empty `.hooks({})` does not register hooks and does not wrap `execute`. The call is `{ ctx, spec, token, input }`. `input` is the argument passed to `execute`. The method receives that same value. Hexok does not validate it. `UseCase.GuardParameters<typeof Factory>` is that call. `UseCase.Ctx<typeof Factory>` is that `ctx`. Pass the factory. `.hooks` infers the value returned from `preExecute` as the `state` argument of `postExecute`, `onCatch`, and `onFinally`. If `preExecute` is omitted, that state is `void`. `postExecute` also receives `result`. `onFinally` receives `status: 'success'` with `result`, or `status: 'failure'` with `error`. The pipeline is guard (outside try), `preExecute`, the method, `postExecute`, `onCatch` then rethrow, `onFinally`. A guard throw does not enter the hooks. A throw inside `onCatch` replaces the error after `onFinally` sees the original one. `UseCase(token)` still has `execute(input)`.
+
+The root [README](../../README.md) shows the shape. Tokens and schemas are arguments of each primitive, so they cannot be forgotten. `execute`, `handle`, and port methods are abstract, so a missing method is a compiler error on the class. `start`, `stop`, `parse`, and `set` are concrete methods you can override.

package/dist/adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Implementation of a port. Missing port methods are errors on the class.
+ * `start` and `stop` are optional overrides. The token is the port's token.
+ *
+ * ```ts
+ * class InMemoryUsers extends Adapter(UserRepository) {
+ *   override async get(id: string): Promise<User | null> { ... }
+ *   override async save(user: User): Promise<void> { ... }
+ * }
+ * ```
+ */
+export declare function Adapter<P extends abstract new (...args: any[]) => object>(PortClass: P): (abstract new (...args: any[]) => {
+    /** Called by the application before the adapter is used. Override to connect. */
+    start(): Promise<void>;
+    /** Called by the application when it is finished with the adapter. Override to disconnect. */
+    stop(): Promise<void>;
+}) & P;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,CAAC,SAAS,QAAQ,MAEhB,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,MAAM,EACX,SAAS,EAAE,CAAC,2BAFD,GAAG,EAAE;IAId,iFAAiF;aAClE,OAAO,CAAC,IAAI,CAAC;IAE5B,8FAA8F;YAChF,OAAO,CAAC,IAAI,CAAC;OAI9B"}

package/dist/adapter.js

@@ -0,0 +1,21 @@
+/**
+ * Implementation of a port. Missing port methods are errors on the class.
+ * `start` and `stop` are optional overrides. The token is the port's token.
+ *
+ * ```ts
+ * class InMemoryUsers extends Adapter(UserRepository) {
+ *   override async get(id: string): Promise<User | null> { ... }
+ *   override async save(user: User): Promise<void> { ... }
+ * }
+ * ```
+ */
+export function Adapter(PortClass) {
+    class AdapterClass extends PortClass {
+        /** Called by the application before the adapter is used. Override to connect. */
+        async start() { }
+        /** Called by the application when it is finished with the adapter. Override to disconnect. */
+        async stop() { }
+    }
+    return AdapterClass;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAKrB,SAAY;IACZ,MAAe,YAAa,SAAQ,SAAS;QAC3C,iFAAiF;QACjF,KAAK,CAAC,KAAK,KAAmB,CAAC;QAE/B,8FAA8F;QAC9F,KAAK,CAAC,IAAI,KAAmB,CAAC;KAC/B;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/catalog.d.ts

@@ -0,0 +1,88 @@
+import type { StandardSchemaV1 } from './standard-schema.js';
+/** Constructor registered on an {@link EventCatalog}. */
+export type EventConstructor = {
+    /** Event name. */
+    readonly token: string;
+    /** Payload schema. */
+    readonly schema: StandardSchemaV1;
+    new (...args: any[]): object;
+};
+/**
+ * Named set of event classes. Map keys stay literal without `as const`.
+ * Duplicate event tokens throw when the catalog is defined.
+ *
+ * ```ts
+ * class DomainEvents extends EventCatalog('domain', {
+ *   userCreated: UserCreated,
+ * }) {}
+ * ```
+ */
+export declare function EventCatalog<const Token extends string, const Events extends Record<string, EventConstructor>>(token: Token, events: Events): (abstract new () => {}) & {
+    /** Catalog name. Literal type of the string passed to {@link EventCatalog}. */
+    readonly token: Token;
+    /** Event classes, in the shape passed to {@link EventCatalog}. */
+    readonly events: Events;
+    /** Registered class for `name`. Throws when `name` is not in this catalog. */
+    get<Name extends keyof Events & string>(name: Name): Events[Name];
+    /**
+     * Serializable `{ key, payload }` for an instance from this catalog.
+     * `key` is the map name. Throws when `event` is not registered here.
+     */
+    message(event: EventInstance<CatalogOf<Events>>): EventMessage<CatalogOf<Events>>;
+    /**
+     * Validate a `{ key, payload }` message and construct the event.
+     * Throws when `key` is not in this catalog.
+     * Throws `CodedError` `VALIDATION` when the payload schema rejects it.
+     */
+    parse(value: unknown): EventInstance<CatalogOf<Events>>;
+};
+/**
+ * Instance of an event class. Read from the constructor so
+ * {@link EventConstructor}'s `object` return does not erase it.
+ */
+type EventInstanceOf<Event> = Event extends abstract new (...args: never[]) => infer Instance ? Instance : never;
+/**
+ * Payload of an event class. Read from the instance so
+ * {@link EventConstructor}'s `object` return does not erase it.
+ */
+type EventPayload<Event> = EventInstanceOf<Event> extends {
+    readonly payload: infer Payload;
+} ? Payload : never;
+/** Catalog shape {@link EventInstance} and {@link EventMessage} read. */
+type CatalogOf<Events extends Record<string, EventConstructor>> = {
+    readonly events: Events;
+};
+/**
+ * Instance of one catalog entry, or every entry when `Key` is omitted.
+ * `token` is the event name. `payload` is the schema output.
+ *
+ * ```ts
+ * abstract publish(event: EventInstance<typeof DomainEvents>): Promise<void>
+ * publish(new UserCreated({ id, name, email }))
+ * ```
+ *
+ * `EventInstance<typeof DomainEvents, 'userCreated'>` keeps that one entry.
+ */
+export type EventInstance<Catalog extends {
+    readonly events: Record<string, EventConstructor>;
+}, Key extends keyof Catalog['events'] & string = keyof Catalog['events'] & string> = {
+    [K in Key]: EventInstanceOf<Catalog['events'][K]>;
+}[Key];
+/**
+ * `{ key, payload }` for one catalog entry, or every entry when `Key` is omitted.
+ * `key` is the catalog map name. The event token stays on the instance.
+ * Adapters send this value. {@link EventCatalog} `message` and `parse` convert
+ * it to and from an {@link EventInstance}.
+ *
+ * `EventMessage<typeof DomainEvents, 'userCreated'>` keeps that one entry.
+ */
+export type EventMessage<Catalog extends {
+    readonly events: Record<string, EventConstructor>;
+}, Key extends keyof Catalog['events'] & string = keyof Catalog['events'] & string> = {
+    [K in Key]: {
+        key: K;
+        payload: EventPayload<Catalog['events'][K]>;
+    };
+}[Key];
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAElC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,KAAK,CAAC,KAAK,SAAS,MAAM,EAC1B,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACrD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IAa1B,+EAA+E;oBACxD,KAAK;IAC5B,kEAAkE;qBAC1C,MAAM;IAE9B,8EAA8E;QACnE,IAAI,SAAS,MAAM,MAAM,GAAG,MAAM,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAQxE;;;OAGG;mBAEM,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GACtC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAgBlC;;;;OAIG;iBACiB,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;EAsBjE;AAED;;;GAGG;AACH,KAAK,eAAe,CAAC,KAAK,IAAI,KAAK,SAAS,QAAQ,MAClD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb,MAAM,QAAQ,GACf,QAAQ,GACR,KAAK,CAAC;AAEV;;;GAGG;AACH,KAAK,YAAY,CAAC,KAAK,IACrB,eAAe,CAAC,KAAK,CAAC,SAAS;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;CACjC,GACG,OAAO,GACP,KAAK,CAAC;AAEZ,yEAAyE;AACzE,KAAK,SAAS,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,CACvB,OAAO,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAAE,EACrE,GAAG,SAAS,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,GACpE,MAAM,IACN;KACD,CAAC,IAAI,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAClD,CAAC,GAAG,CAAC,CAAC;AAEP;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CACtB,OAAO,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAAE,EACrE,GAAG,SAAS,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,GACpE,MAAM,IACN;KACD,CAAC,IAAI,GAAG,GAAG;QACV,GAAG,EAAE,CAAC,CAAC;QACP,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC7C;CACF,CAAC,GAAG,CAAC,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,79 @@
+/**
+ * Named set of event classes. Map keys stay literal without `as const`.
+ * Duplicate event tokens throw when the catalog is defined.
+ *
+ * ```ts
+ * class DomainEvents extends EventCatalog('domain', {
+ *   userCreated: UserCreated,
+ * }) {}
+ * ```
+ */
+export function EventCatalog(token, events) {
+    const seen = new Set();
+    for (const event of Object.values(events)) {
+        if (seen.has(event.token)) {
+            throw new Error(`hexok: duplicate event "${event.token}" in catalog "${token}"`);
+        }
+        seen.add(event.token);
+    }
+    const registered = Object.freeze({ ...events });
+    class CatalogClass {
+        /** Catalog name. Literal type of the string passed to {@link EventCatalog}. */
+        static token = token;
+        /** Event classes, in the shape passed to {@link EventCatalog}. */
+        static events = registered;
+        /** Registered class for `name`. Throws when `name` is not in this catalog. */
+        static get(name) {
+            const event = registered[name];
+            if (event === undefined) {
+                throw new Error(`hexok: event "${name}" is not in catalog "${token}"`);
+            }
+            return event;
+        }
+        /**
+         * Serializable `{ key, payload }` for an instance from this catalog.
+         * `key` is the map name. Throws when `event` is not registered here.
+         */
+        static message(event) {
+            for (const key of Object.keys(registered)) {
+                const Ctor = registered[key];
+                if (Ctor !== undefined && event instanceof Ctor) {
+                    // The instance type does not narrow to one catalog key.
+                    const payload = event.payload;
+                    return { key, payload };
+                }
+            }
+            const name = 'token' in event && typeof event.token === 'string'
+                ? event.token
+                : 'unknown';
+            throw new Error(`hexok: event "${name}" is not in catalog "${token}"`);
+        }
+        /**
+         * Validate a `{ key, payload }` message and construct the event.
+         * Throws when `key` is not in this catalog.
+         * Throws `CodedError` `VALIDATION` when the payload schema rejects it.
+         */
+        static parse(value) {
+            if (!isMessage(value)) {
+                throw new Error(`hexok: catalog "${token}" expected { key, payload }`);
+            }
+            if (!Object.hasOwn(registered, value.key)) {
+                throw new Error(`hexok: event "${value.key}" is not in catalog "${token}"`);
+            }
+            const EventClass = registered[value.key];
+            if (typeof EventClass.parse !== 'function') {
+                throw new Error(`hexok: event "${value.key}" in catalog "${token}" has no parse`);
+            }
+            return EventClass.parse(value.payload);
+        }
+    }
+    return CatalogClass;
+}
+function isMessage(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (!('key' in value) || typeof value.key !== 'string')
+        return false;
+    return 'payload' in value;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/{core/coded-error.d.ts → coded-error.d.ts}

@@ -1,14 +1,19 @@
 import type { StandardSchemaV1 } from './standard-schema.js';
 /**
- * Thrown by entity refusals and use-case error factories.
- * Carries `code`, optional `message`, and optional `data`.
+ * Code, message, and optional data. Schema checks throw this with code
+ * `VALIDATION`. The application catches it where errors bubble.
+ *
+ * Application refusals use an {@link Errors} catalog.
  *
  * ```ts
- * throw new CodedError({ code: 'NOT_FOUND', message: 'Incident not found' })
+ * new CodedError({
+ *   code: 'VALIDATION',
+ *   message: 'hexok: User validation failed',
+ * })
  * ```
  */
 export declare class CodedError<C extends string = string> extends Error {
-    /** Machine-readable refusal code. Catch and switch on this; a runtime transport may map it to a status. */
+    /** Machine-readable code. Schema checks use `VALIDATION`. */
     readonly code: C;
     /** Optional payload. Set only when the constructor received `data`. */
     readonly data?: unknown;

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

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

package/dist/{core/coded-error.js → coded-error.js}

@@ -1,13 +1,18 @@
 /**
- * Thrown by entity refusals and use-case error factories.
- * Carries `code`, optional `message`, and optional `data`.
+ * Code, message, and optional data. Schema checks throw this with code
+ * `VALIDATION`. The application catches it where errors bubble.
+ *
+ * Application refusals use an {@link Errors} catalog.
  *
  * ```ts
- * throw new CodedError({ code: 'NOT_FOUND', message: 'Incident not found' })
+ * new CodedError({
+ *   code: 'VALIDATION',
+ *   message: 'hexok: User validation failed',
+ * })
  * ```
  */
 export class CodedError extends Error {
-    /** Machine-readable refusal code. Catch and switch on this; a runtime transport may map it to a status. */
+    /** Machine-readable code. Schema checks use `VALIDATION`. */
     code;
     /** Optional payload. Set only when the constructor received `data`. */
     data;

package/dist/coded-error.js.map

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

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

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

package/dist/cow-draft.js.map

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

package/dist/entity.d.ts

@@ -0,0 +1,63 @@
+import { type InferSchema, type ResolvedSchema, type SchemaSource } from './schema.js';
+/** Recursively readonly view of entity props. `Date` values stay `Date`. */
+export type DeepReadonly<T> = T extends Date ? T : T extends readonly (infer U)[] ? ReadonlyArray<DeepReadonly<U>> : T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
+/** `keyof object` is `never`; widen so an open props type still has string keys. */
+type ChangedKey<P extends object> = keyof P extends never ? string : keyof P & string;
+/** Public instance of an entity. Subclass methods stay on `this`. */
+export interface EntityInstance<P extends object> {
+    readonly props: DeepReadonly<P>;
+    readonly isNew: boolean;
+    readonly isValidated: boolean;
+    readonly original: DeepReadonly<P> | undefined;
+    set(producer: (draft: P) => void): this;
+    validate(): this;
+    getChangedKeys(): Array<ChangedKey<P>>;
+    getChangedKeys(opts: {
+        deep: true;
+    }): string[];
+    getChangedKeys(opts?: {
+        deep?: boolean;
+    }): string[];
+    isDirty(): boolean;
+    commit(): this;
+    toProps(): DeepReadonly<P>;
+    toJSON(): DeepReadonly<P>;
+}
+type EntityHandle<Token extends string, S extends SchemaSource> = {
+    readonly token: Token;
+    readonly schema: ResolvedSchema<S>;
+    readonly prototype: EntityInstance<EntityProps<S>>;
+    create<T extends {
+        readonly prototype: EntityInstance<EntityProps<S>>;
+    }>(this: T, props: EntityProps<S> | DeepReadonly<EntityProps<S>>): T['prototype'];
+    restore<T extends {
+        readonly prototype: EntityInstance<EntityProps<S>>;
+    }>(this: T, props: EntityProps<S> | DeepReadonly<EntityProps<S>>): T['prototype'];
+    parse<T extends {
+        readonly prototype: EntityInstance<EntityProps<S>>;
+    }>(this: T, value: unknown): T['prototype'];
+} & (abstract new (props: EntityProps<S>, init: never) => EntityInstance<EntityProps<S>>);
+/**
+ * Mutable aggregate. The token and schema are arguments of {@link Entity},
+ * so a subclass cannot forget them. Rules are methods. A refusal throws an
+ * {@link Errors} catalog member. Override `set` only when the copy-on-write
+ * write path itself must change.
+ *
+ * ```ts
+ * class Incident extends Entity('Incident', incidentSchema) {
+ *   close(now: Date): this {
+ *     if (this.props.status === 'closed') throw DomainError.AlreadyClosed()
+ *     return this.set((draft) => {
+ *       draft.status = 'closed'
+ *       draft.closedAt = now
+ *     })
+ *   }
+ * }
+ * ```
+ */
+type EntityProps<S extends SchemaSource> = InferSchema<S> extends object ? InferSchema<S> : never;
+export declare function Entity<const Token extends string, S extends SchemaSource>(token: Token, schema: S): EntityHandle<Token, S>;
+export {};
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

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

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