hexok 1.0.1 → 2.1.0

package/README.md

@@ -1,31 +1,18 @@
 # hexok
 
-Hexo Kit — a TypeScript kit for writing a clean-architecture backend as ordinary classes: Entity, Port, Adapter, UseCase, Event, Interceptor.
+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`.
 
-**Docs:** https://crobinson42.github.io/hexok/
+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.
 
-## Install
+`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)`.
 
-```bash
-npm i hexok
-```
+## Agent skill
 
-Import from a layer. There is no root barrel.
+This package's repository includes an agent skill named `hexok`. It walks a feature from the user story through entities, use cases, events, adapters, the gateway, and where handlers run. Install it from GitHub. `npx skills update` refreshes that install from GitHub.
 
-```ts
-import { Entity } from 'hexok/domain'
-import { ExternalUseCase } from 'hexok/app'
-import { App } from 'hexok/runtime'
-import { App as TestApp, InMemoryRepository } from 'hexok/testing'
+```bash
+npx skills add crobinson42/hexok
+npx skills update
 ```
 
-| Import | What it is |
-| --- | --- |
-| `hexok/core` | `Result`, Standard Schema V1, `ErrorMap`, `CodedError` |
-| `hexok/domain` | `Entity`, `Port`, `EventCatalog`, `DomainEvent` |
-| `hexok/app` | `ExternalUseCase`, `InternalUseCase`, `EventUseCase`, `EventChannel` |
-| `hexok/infra` | `Mapper`, `Adapter.of` |
-| `hexok/runtime` | `App.from`, interceptors, local client, HTTP |
-| `hexok/testing` | `App.test`, in-memory adapters |
-
-Full API: https://crobinson42.github.io/hexok/
+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":"AAYA;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAG1B,KAAY,EAAE,MAAc;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,CAAC,KAAK,iBAAiB,KAAK,GAAG,CAChE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAW,CAAC;IAE1D,MAAe,YAAY;QACzB,+EAA+E;QAC/E,MAAM,CAAU,KAAK,GAAU,KAAK,CAAC;QACrC,kEAAkE;QAClE,MAAM,CAAU,MAAM,GAAW,UAAU,CAAC;QAE5C,8EAA8E;QAC9E,MAAM,CAAC,GAAG,CAAqC,IAAU;YACvD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,wBAAwB,KAAK,GAAG,CAAC,CAAC;YACzE,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED;;;WAGG;QACH,MAAM,CAAC,OAAO,CACZ,KAAuC;YAEvC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAA8B,EAAE,CAAC;gBACvE,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;oBAChD,wDAAwD;oBACxD,MAAM,OAAO,GAAI,KAAuC,CAAC,OAAO,CAAC;oBACjE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAqC,CAAC;gBAC7D,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GACR,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBACjD,CAAC,CAAC,KAAK,CAAC,KAAK;gBACb,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,wBAAwB,KAAK,GAAG,CAAC,CAAC;QACzE,CAAC;QAED;;;;WAIG;QACH,MAAM,CAAC,KAAK,CAAC,KAAc;YACzB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,6BAA6B,CAAC,CAAC;YACzE,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CACb,iBAAiB,KAAK,CAAC,GAAG,wBAAwB,KAAK,GAAG,CAC3D,CAAC;YACJ,CAAC;YACD,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,GAAmB,CAEtD,CAAC;YACF,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CACb,iBAAiB,KAAK,CAAC,GAAG,iBAAiB,KAAK,gBAAgB,CACjE,CAAC;YACJ,CAAC;YACD,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;;IAGH,OAAO,YAAY,CAAC;AACtB,CAAC;AAkED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrE,OAAO,SAAS,IAAI,KAAK,CAAC;AAC5B,CAAC"}

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":"AAOA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAMrB,4EAA4E;AAC5E,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GACxC,CAAC,GACD,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC5B,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC9B,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC/C,CAAC,CAAC;AAWV,oFAAoF;AACpF,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,CAAC,SAAS,KAAK,GACrD,MAAM,GACN,MAAM,CAAC,GAAG,MAAM,CAAC;AAErB,qEAAqE;AACrE,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACxC,QAAQ,IAAI,IAAI,CAAC;IACjB,cAAc,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,MAAM,EAAE,CAAC;IAC/C,cAAc,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,EAAE,CAAC;IACpD,OAAO,IAAI,OAAO,CAAC;IACnB,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;CAC3B;AAED,KAAK,YAAY,CAAC,KAAK,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,IAAI;IAChE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,EACrE,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACnD,CAAC,CAAC,WAAW,CAAC,CAAC;IAClB,OAAO,CAAC,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,EACtE,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACnD,CAAC,CAAC,WAAW,CAAC,CAAC;IAClB,KAAK,CAAC,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,EACpE,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,OAAO,GACb,CAAC,CAAC,WAAW,CAAC,CAAC;CACnB,GAAG,CAAC,QAAQ,MACX,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,KAAK,KACR,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS,YAAY,IACrC,WAAW,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAEzD,wBAAgB,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,EACvE,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,CAAC,GACR,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAkBxB"}