hexok 1.0.0 → 2.0.0

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":"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"}

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"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { Adapter } from './adapter.js';
+export { EventCatalog, type EventInstance, type EventMessage, } from './catalog.js';
+export { CodedError, validationError } from './coded-error.js';
+export { type DeepReadonly, Entity, type EntityInstance } from './entity.js';
+export type { ErrorDef, ErrorMap } from './error-map.js';
+export { type CatalogMember, type CatalogUnion, catalogBrand, Errors, type ErrorsHandle, } from './errors.js';
+export { Event } from './event.js';
+export { EventHandler } from './event-handler.js';
+export { Mapper, type MapperClass } from './mapper.js';
+export { Port } from './port.js';
+export { fail, ok, type Result } from './result.js';
+export { type InferSchema, Schema, type SchemaSource } from './schema.js';
+export type { StandardSchemaV1 } from './standard-schema.js';
+export { UseCase } from './use-case.js';
+export { type Infer, validate } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,YAAY,EACZ,MAAM,EACN,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { Adapter } from './adapter.js';
+export { EventCatalog, } from './catalog.js';
+export { CodedError, validationError } from './coded-error.js';
+export { Entity } from './entity.js';
+export { catalogBrand, Errors, } from './errors.js';
+export { Event } from './event.js';
+export { EventHandler } from './event-handler.js';
+export { Mapper } from './mapper.js';
+export { Port } from './port.js';
+export { fail, ok } from './result.js';
+export { Schema } from './schema.js';
+export { UseCase } from './use-case.js';
+export { validate } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,YAAY,GAGb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAqB,MAAM,EAAuB,MAAM,aAAa,CAAC;AAE7E,OAAO,EAGL,YAAY,EACZ,MAAM,GAEP,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AACpD,OAAO,EAAoB,MAAM,EAAqB,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAc,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/mapper.d.ts

@@ -0,0 +1,100 @@
+import { type InferSchema, type ResolvedSchema, type SchemaSource } from './schema.js';
+import type { StandardSchemaV1 } from './standard-schema.js';
+/** Instance type of a constructor. Raw schemas have no prototype, so this is `never`. */
+type PrototypeOf<T> = T extends {
+    readonly prototype: infer P;
+} ? P : never;
+/**
+ * Entity instances expose `props` and `toProps`.
+ * A missing prototype is `never`, and `never extends …` is true, so raw schemas are excluded.
+ */
+type IsEntity<T> = [PrototypeOf<T>] extends [never] ? false : PrototypeOf<T> extends {
+    readonly props: object;
+    toProps(): unknown;
+} ? true : false;
+/** Value `fromSource` receives and `fromModel` returns. */
+type SourceModel<T> = IsEntity<T> extends true ? PrototypeOf<T> : T extends SchemaSource ? InferSchema<T> : never;
+/** Draft `toSource` returns. Entities yield props; the kit builds the instance. */
+type SourceDraft<T> = IsEntity<T> extends true ? T extends {
+    readonly schema: infer S extends SchemaSource;
+} ? InferSchema<S> : never : T extends SchemaSource ? InferSchema<T> : never;
+type MapperOptions = {
+    readonly validate?: boolean;
+};
+/**
+ * Instance base of {@link Mapper}. Exported so declaration emit can name it.
+ * An anonymous base cannot publish protected `fromSource` or `toSource` (TS4094).
+ * Extend {@link Mapper}, not this class.
+ */
+export declare abstract class MapperClass<Token extends string, Source, Stored extends SchemaSource> {
+    #private;
+    /** Mapper name. Literal type of the string passed to {@link Mapper}. */
+    static readonly token: string;
+    /** Stored Standard Schema. A Schema class is stored as its definition. */
+    static readonly schema: StandardSchemaV1;
+    /** Entity, Schema class, or Standard Schema this mapper reads and builds. */
+    static readonly source: unknown;
+    protected constructor(brand: Token);
+    /**
+     * Source to an unchecked model draft.
+     * An entity source receives the instance. A schema source receives its output.
+     */
+    protected abstract fromSource(source: SourceModel<Source>): unknown;
+    /**
+     * Model output to a source draft.
+     * An entity draft is props. A schema draft is that schema's output.
+     */
+    protected abstract toSource(model: InferSchema<Stored>): SourceDraft<Source>;
+    /**
+     * Run `fromSource`. With `{ validate: true }`, check the draft against the model schema.
+     * A failure throws `CodedError` `VALIDATION` using this mapper's token.
+     * Do not override.
+     */
+    toModel(source: SourceModel<Source>, options?: MapperOptions): InferSchema<Stored>;
+    /**
+     * Run `toSource` and build the source.
+     * With `{ validate: true }`, check `value` against the model schema first.
+     * An entity is then `parse`d. Otherwise an entity is `restore`d.
+     * Do not override.
+     */
+    fromModel(value: unknown, options?: MapperOptions): SourceModel<Source>;
+}
+type MapperCtor<Token extends string, Source, Stored extends SchemaSource> = (abstract new () => MapperClass<Token, Source, Stored>) & {
+    readonly token: Token;
+    readonly schema: ResolvedSchema<Stored>;
+    readonly source: Source;
+};
+/**
+ * Persistence translator. An adapter maps the source a port speaks — an
+ * entity, a Schema class, or a Standard Schema — to the shape that adapter
+ * stores. Domain code does not import the stored schema. The mapper is
+ * stateless; do not `commit()` inside it. The adapter commits after the
+ * driver succeeds.
+ *
+ * The subclass writes `fromSource` and `toSource`. Adapters call `toModel` and
+ * `fromModel` and do not override them. Checks are off. Pass
+ * `{ validate: true }` to the factory or to a call to run the model schema.
+ * A checked `fromModel` uses `parse`. The default restores an entity.
+ *
+ * ```ts
+ * class MongoUser extends Mapper('mongo.User', User, mongoUserSchema) {
+ *   protected fromSource(user: User) {
+ *     const props = user.toProps()
+ *     const [lat, lng] = props.location
+ *     return {
+ *       _id: props.id,
+ *       name: props.name,
+ *       location: { type: 'Point' as const, coordinates: [lng, lat] },
+ *     }
+ *   }
+ *
+ *   protected toSource(doc: MongoUserDoc) {
+ *     const [lng, lat] = doc.location.coordinates
+ *     return { id: doc._id, name: doc.name, location: [lat, lng] }
+ *   }
+ * }
+ * ```
+ */
+export declare function Mapper<const Token extends string, Source, Stored extends SchemaSource>(token: Token, source: Source, storedSchema: Stored, options?: MapperOptions): MapperCtor<Token, Source, Stored>;
+export {};
+//# sourceMappingURL=mapper.d.ts.map

package/dist/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,yFAAyF;AACzF,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAE5E;;;GAGG;AACH,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC/C,KAAK,GACL,WAAW,CAAC,CAAC,CAAC,SAAS;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC;CACpB,GACD,IAAI,GACJ,KAAK,CAAC;AAEZ,2DAA2D;AAC3D,KAAK,WAAW,CAAC,CAAC,IAChB,QAAQ,CAAC,CAAC,CAAC,SAAS,IAAI,GACpB,WAAW,CAAC,CAAC,CAAC,GACd,CAAC,SAAS,YAAY,GACpB,WAAW,CAAC,CAAC,CAAC,GACd,KAAK,CAAC;AAEd,mFAAmF;AACnF,KAAK,WAAW,CAAC,CAAC,IAChB,QAAQ,CAAC,CAAC,CAAC,SAAS,IAAI,GACpB,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,YAAY,CAAA;CAAE,GACzD,WAAW,CAAC,CAAC,CAAC,GACd,KAAK,GACP,CAAC,SAAS,YAAY,GACpB,WAAW,CAAC,CAAC,CAAC,GACd,KAAK,CAAC;AAOd,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAUF;;;;GAIG;AACH,8BAAsB,WAAW,CAC/B,KAAK,SAAS,MAAM,EACpB,MAAM,EACN,MAAM,SAAS,YAAY;;IAE3B,wEAAwE;IACxE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACzC,6EAA6E;IAC7E,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAIhC,SAAS,aAAa,KAAK,EAAE,KAAK;IAKlC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO;IAEnE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;IAE5E;;;;OAIG;IACH,OAAO,CACL,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,WAAW,CAAC,MAAM,CAAC;IActB;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC;CAYxE;AAED,KAAK,UAAU,CACb,KAAK,SAAS,MAAM,EACpB,MAAM,EACN,MAAM,SAAS,YAAY,IACzB,CAAC,QAAQ,WAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG;IAC5D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CACpB,KAAK,CAAC,KAAK,SAAS,MAAM,EAC1B,MAAM,EACN,MAAM,SAAS,YAAY,EAE3B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAkBnC"}