hexok 1.0.1 → 2.0.0

package/dist/use-case.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Application service. Pass ports through the constructor.
+ * `execute` is required; the compiler errors on the class when it is missing.
+ * Declare the input and output on `execute` — those are the types callers see.
+ * A refusal throws an {@link Errors} catalog member. The application catches it.
+ *
+ * ```ts
+ * class CreateUser extends UseCase('user.create') {
+ *   constructor(private readonly users: UserRepository) { super() }
+ *   async execute(input: { email: string }): Promise<{ id: string }> {
+ *     return { id: input.email }
+ *   }
+ * }
+ * ```
+ */
+export declare function UseCase<const Token extends string>(token: Token): (abstract new () => {
+    /** Nominal marker. Each `UseCase(...)` call is a distinct class. */
+    readonly "__#private@#brand": true;
+    /**
+     * Required. Annotate `input` and the return type on the subclass;
+     * callers of the subclass see those types.
+     */
+    execute(input: unknown): Promise<unknown>;
+}) & {
+    /** Use-case name. Literal type of the string passed to {@link UseCase}. */
+    readonly token: Token;
+};
+type ReservedKey = 'token' | 'prototype' | 'name' | 'length';
+/** A bag that uses a reserved class static fails on that property. */
+type ReservedOk<S> = {
+    [K in keyof S]: K extends ReservedKey ? never : S[K];
+};
+type NoStatics = Record<never, never>;
+/** Static bag minus names that would overwrite the class constructor. */
+type Statics<S> = Omit<S, ReservedKey>;
+/**
+ * Family of use cases that receive a caller context on `execute`.
+ * Returns a factory: a token, or a token and statics when `Spec` has keys.
+ * `execute` is required; annotate it on the subclass — callers see those types.
+ * A guard and hooks, when set, run around that method.
+ * Statics are application data copied onto the class. The application validates `input`.
+ * {@link UseCase.GuardParameters} reads the guard's call off the factory.
+ * {@link UseCase.Ctx} reads that call's context type.
+ * {@link context} returns that factory. {@link ContextFactory.guard} and
+ * {@link ContextFactory.hooks} return it again.
+ *
+ * ```ts
+ * const ApiUseCase = UseCase.context<
+ *   ApiContext,
+ *   { input: StandardSchemaV1; permission: string }
+ * >()
+ *   .guard((call) => {
+ *     if (call.ctx.sessionId.length < 1 || call.spec.permission.length < 1) {
+ *       throw new Error('unauthorized')
+ *     }
+ *   })
+ *   .hooks({
+ *     preExecute: () => ({ started: Date.now() }),
+ *     postExecute(_call, state) {
+ *       void state.started
+ *     },
+ *   })
+ *
+ * class FindUsers extends ApiUseCase('user.find', {
+ *   input: z.object({ query: z.string() }),
+ *   permission: 'users.read',
+ * }) {
+ *   constructor(private readonly users: UserRepository) { super() }
+ *   async execute(
+ *     ctx: UseCase.Ctx<typeof ApiUseCase>,
+ *     input: { query: string },
+ *   ): Promise<User[]> {
+ *     return this.users.search(input.query)
+ *   }
+ * }
+ * ```
+ */
+export declare namespace UseCase {
+    /**
+     * Call passed to a {@link context} guard.
+     * `ctx` is the per-call context. `spec` is the static contract.
+     * `token` is the use-case name. `input` is the argument passed to `execute`.
+     *
+     * ```ts
+     * type Call = UseCase.GuardParameters<typeof ApiUseCase>
+     * ```
+     */
+    type GuardParameters<Factory> = Factory extends GuardParametersSlot<infer Ctx, infer Spec> ? Call<Ctx, Spec> : never;
+    /**
+     * Context type of a {@link context} factory.
+     * Pass the factory. A subclass, and a plain {@link UseCase} class, are `never`.
+     *
+     * ```ts
+     * async execute(
+     *   ctx: UseCase.Ctx<typeof ApiUseCase>,
+     *   input: { query: string },
+     * ): Promise<User[]> {}
+     * ```
+     */
+    type Ctx<Factory> = GuardParameters<Factory>['ctx'];
+    /**
+     * Factory returned by {@link context}.
+     * An exported const infers this type.
+     * `guard` and `hooks` return the same factory.
+     */
+    interface ContextFactory<Ctx, Spec = NoStatics> extends ReturnType<typeof buildContext<Ctx, Spec>> {
+        /**
+         * Runs after guards already registered, and before `execute`.
+         * Returns the same factory.
+         */
+        guard(guard: (call: Call<Ctx, Spec>) => void | Promise<void>): ContextFactory<Ctx, Spec>;
+        /**
+         * Lifecycle around `execute`. The value returned from `preExecute` is the
+         * `state` argument of `postExecute`, `onCatch`, and `onFinally`.
+         * A second call throws when this factory already has hooks.
+         */
+        hooks<State = void>(definition: HookDefinition<Ctx, Spec, State>): ContextFactory<Ctx, Spec>;
+    }
+    /**
+     * Family factory. Pass the context type.
+     * The argument is a settings object with no keys yet.
+     */
+    function context<Ctx, Spec = NoStatics>(config?: ContextConfig): unknown extends Ctx ? 'Pass a type argument: UseCase.context<Ctx>()' : ContextFactory<Ctx, Spec>;
+}
+/** Values a guard and the hooks share for one invocation. */
+type Call<Ctx, Spec> = {
+    readonly ctx: Ctx;
+    readonly spec: Spec;
+    readonly token: string;
+    /** The `input` argument the caller passed to `execute`. */
+    readonly input: unknown;
+};
+type Performed<Ctx, Spec> = Call<Ctx, Spec> & {
+    readonly result: unknown;
+};
+type Caught<Ctx, Spec> = Call<Ctx, Spec> & {
+    readonly error: unknown;
+};
+type Settled<Ctx, Spec> = (Call<Ctx, Spec> & {
+    readonly status: 'success';
+    readonly result: unknown;
+}) | (Call<Ctx, Spec> & {
+    readonly status: 'failure';
+    readonly error: unknown;
+});
+/** Settings for {@link UseCase.context}. There are none yet. */
+type ContextConfig = Record<string, never>;
+type ContextGuard<Ctx, Spec> = (call: Call<Ctx, Spec>) => void | Promise<void>;
+type HookDefinition<Ctx, Spec, State> = {
+    preExecute?: (call: Call<Ctx, Spec>) => State | Promise<State>;
+    postExecute?: (call: Performed<Ctx, Spec>, state: Awaited<State>) => void | Promise<void>;
+    onCatch?: (call: Caught<Ctx, Spec>, state: Awaited<State> | undefined) => void | Promise<void>;
+    onFinally?: (call: Settled<Ctx, Spec>, state: Awaited<State> | undefined) => void | Promise<void>;
+};
+/** Hooks stored on one factory. State is erased after `.hooks()` checks it. */
+type StoredHooks<Ctx, Spec> = {
+    preExecute?: (call: Call<Ctx, Spec>) => unknown;
+    postExecute?: (call: Performed<Ctx, Spec>, state: unknown) => void | Promise<void>;
+    onCatch?: (call: Caught<Ctx, Spec>, state: unknown) => void | Promise<void>;
+    onFinally?: (call: Settled<Ctx, Spec>, state: unknown) => void | Promise<void>;
+};
+/** Type-only mark. Absent at runtime. Same symbol in {@link UseCase.GuardParameters}. */
+declare const guardParameters: unique symbol;
+type GuardParametersSlot<Ctx, Spec> = {
+    readonly [guardParameters]?: (call: Call<Ctx, Spec>) => void;
+};
+declare function buildContext<Ctx, Spec = NoStatics>(options?: {
+    guard?: ContextGuard<Ctx, Spec>;
+    hooks?: StoredHooks<Ctx, Spec>;
+}): (<const Token extends string, const S extends [keyof Spec] extends [never] ? NoStatics : Spec>(token: Token, ...args: [keyof Spec] extends [never] ? [] : [statics: ReservedOk<S> & Spec]) => ((abstract new () => {
+    /** Nominal marker. Each factory call is a distinct class. */
+    readonly "__#private@#brand": true;
+    /**
+     * Required. Annotate `ctx`, `input`, and the return type on the subclass.
+     * A guard and hooks run around this method when set.
+     */
+    execute(ctx: Ctx, input: unknown): Promise<unknown>;
+}) & {
+    /** Use-case name. Literal type of the string passed to the factory. */
+    readonly token: Token;
+}) & ([keyof Spec] extends [never] ? NoStatics : Statics<S>)) & GuardParametersSlot<Ctx, Spec>;
+export {};
+//# sourceMappingURL=use-case.d.ts.map

package/dist/use-case.d.ts.map

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

package/dist/use-case.js

@@ -0,0 +1,221 @@
+/**
+ * Application service. Pass ports through the constructor.
+ * `execute` is required; the compiler errors on the class when it is missing.
+ * Declare the input and output on `execute` — those are the types callers see.
+ * A refusal throws an {@link Errors} catalog member. The application catches it.
+ *
+ * ```ts
+ * class CreateUser extends UseCase('user.create') {
+ *   constructor(private readonly users: UserRepository) { super() }
+ *   async execute(input: { email: string }): Promise<{ id: string }> {
+ *     return { id: input.email }
+ *   }
+ * }
+ * ```
+ */
+export function UseCase(token) {
+    class UseCaseClass {
+        /** Use-case name. Literal type of the string passed to {@link UseCase}. */
+        static token = token;
+        /** Nominal marker. Each `UseCase(...)` call is a distinct class. */
+        #brand = true;
+        constructor() {
+            void this.#brand;
+        }
+    }
+    return UseCaseClass;
+}
+const RESERVED_STATICS = new Set([
+    'token',
+    'prototype',
+    'name',
+    'length',
+]);
+/**
+ * Family of use cases that receive a caller context on `execute`.
+ * Returns a factory: a token, or a token and statics when `Spec` has keys.
+ * `execute` is required; annotate it on the subclass — callers see those types.
+ * A guard and hooks, when set, run around that method.
+ * Statics are application data copied onto the class. The application validates `input`.
+ * {@link UseCase.GuardParameters} reads the guard's call off the factory.
+ * {@link UseCase.Ctx} reads that call's context type.
+ * {@link context} returns that factory. {@link ContextFactory.guard} and
+ * {@link ContextFactory.hooks} return it again.
+ *
+ * ```ts
+ * const ApiUseCase = UseCase.context<
+ *   ApiContext,
+ *   { input: StandardSchemaV1; permission: string }
+ * >()
+ *   .guard((call) => {
+ *     if (call.ctx.sessionId.length < 1 || call.spec.permission.length < 1) {
+ *       throw new Error('unauthorized')
+ *     }
+ *   })
+ *   .hooks({
+ *     preExecute: () => ({ started: Date.now() }),
+ *     postExecute(_call, state) {
+ *       void state.started
+ *     },
+ *   })
+ *
+ * class FindUsers extends ApiUseCase('user.find', {
+ *   input: z.object({ query: z.string() }),
+ *   permission: 'users.read',
+ * }) {
+ *   constructor(private readonly users: UserRepository) { super() }
+ *   async execute(
+ *     ctx: UseCase.Ctx<typeof ApiUseCase>,
+ *     input: { query: string },
+ *   ): Promise<User[]> {
+ *     return this.users.search(input.query)
+ *   }
+ * }
+ * ```
+ */
+(function (UseCase) {
+    /**
+     * Family factory. Pass the context type.
+     * The argument is a settings object with no keys yet.
+     */
+    function context(config) {
+        void config;
+        return bindFactory({});
+    }
+    UseCase.context = context;
+})(UseCase || (UseCase = {}));
+function storedHooks(definition) {
+    if (definition.preExecute === undefined &&
+        definition.postExecute === undefined &&
+        definition.onCatch === undefined &&
+        definition.onFinally === undefined) {
+        return undefined;
+    }
+    return definition;
+}
+function composeGuard(current, next) {
+    if (current === undefined)
+        return next;
+    return async (call) => {
+        await current(call);
+        await next(call);
+    };
+}
+function bindFactory(slots) {
+    const factory = buildContext(slots);
+    Object.defineProperty(factory, 'guard', {
+        configurable: true,
+        enumerable: false,
+        writable: true,
+        value: (guard) => bindFactory({
+            ...slots,
+            guard: composeGuard(slots.guard, guard),
+        }),
+    });
+    Object.defineProperty(factory, 'hooks', {
+        configurable: true,
+        enumerable: false,
+        writable: true,
+        value: (definition) => {
+            const hooks = storedHooks(definition);
+            if (slots.hooks !== undefined && hooks !== undefined) {
+                throw new Error('hexok: UseCase hooks are already set');
+            }
+            return bindFactory({
+                ...slots,
+                ...(hooks !== undefined ? { hooks } : {}),
+            });
+        },
+    });
+    return factory;
+}
+function buildContext(options) {
+    const guard = options?.guard;
+    const hooks = options?.hooks;
+    const factory = function family(token, ...args) {
+        // Conditional rest tuple: index 0 is the statics bag, or absent.
+        const statics = bagOf(args);
+        const spec = (statics ?? {});
+        class Runtime {
+            /** Use-case name. Literal type of the string passed to the factory. */
+            static token = token;
+            /** Nominal marker. Each factory call is a distinct class. */
+            #brand = true;
+            constructor() {
+                void this.#brand;
+                if (guard === undefined && hooks === undefined)
+                    return;
+                installExecute(this, token, guard, hooks, spec);
+            }
+        }
+        if (statics !== undefined)
+            assignStatics(Runtime, statics);
+        return Runtime;
+    };
+    return factory;
+}
+function bagOf(args) {
+    const value = args[0];
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    return value;
+}
+function assignStatics(target, statics) {
+    const copy = {};
+    const record = statics;
+    for (const key of Object.keys(statics)) {
+        if (RESERVED_STATICS.has(key))
+            continue;
+        copy[key] = record[key];
+    }
+    Object.assign(target, copy);
+}
+function installExecute(instance, token, guard, hooks, spec) {
+    const prototype = Object.getPrototypeOf(instance);
+    // Own property would shadow this and recurse.
+    const execute = prototype.execute;
+    Object.defineProperty(instance, 'execute', {
+        configurable: true,
+        writable: true,
+        value: async (ctx, input) => {
+            const call = { ctx, spec, token, input };
+            if (guard !== undefined)
+                await guard(call);
+            // Local to this invocation. Overlapping execute calls must not share it.
+            let state;
+            let succeeded = false;
+            let result;
+            let caught;
+            let failed = false;
+            try {
+                if (hooks?.preExecute !== undefined) {
+                    state = await hooks.preExecute(call);
+                }
+                result = await execute.call(instance, ctx, input);
+                if (hooks?.postExecute !== undefined) {
+                    await hooks.postExecute({ ...call, result }, state);
+                }
+                succeeded = true;
+                return result;
+            }
+            catch (error) {
+                failed = true;
+                caught = error;
+                if (hooks?.onCatch !== undefined) {
+                    await hooks.onCatch({ ...call, error }, state);
+                }
+                throw error;
+            }
+            finally {
+                if (hooks?.onFinally !== undefined) {
+                    const settled = succeeded
+                        ? { ...call, status: 'success', result }
+                        : { ...call, status: 'failure', error: caught };
+                    if (failed || succeeded)
+                        await hooks.onFinally(settled, state);
+                }
+            }
+        },
+    });
+}
+//# sourceMappingURL=use-case.js.map

package/dist/use-case.js.map

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

package/dist/{core/schema.d.ts → validate.d.ts}

@@ -16,4 +16,4 @@ export type Infer<S extends StandardSchemaV1> = NonNullable<S['~standard']['type
  * ```
  */
 export declare function validate<S extends StandardSchemaV1>(schema: S, value: unknown): Result<Infer<S>, 'VALIDATION'>;
-//# sourceMappingURL=schema.d.ts.map
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

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

package/dist/{core/schema.js → validate.js}

@@ -25,4 +25,4 @@ export function validate(schema, value) {
 function isPromise(value) {
     return typeof value.then === 'function';
 }
-//# sourceMappingURL=schema.js.map
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hexok",
-  "version": "1.0.1",
-  "description": "A TypeScript kit for writing a clean-architecture backend as ordinary classes.",
+  "version": "2.0.0",
+  "description": "TypeScript primitives for hexagonal software: Schema, Entity, UseCase, Port, Adapter, Mapper, Event, EventCatalog, EventHandler, and Errors.",
   "type": "module",
   "license": "MIT",
   "sideEffects": false,
@@ -28,29 +28,9 @@
     "access": "public"
   },
   "exports": {
-    "./core": {
-      "types": "./dist/core/index.d.ts",
-      "import": "./dist/core/index.js"
-    },
-    "./domain": {
-      "types": "./dist/domain/index.d.ts",
-      "import": "./dist/domain/index.js"
-    },
-    "./app": {
-      "types": "./dist/app/index.d.ts",
-      "import": "./dist/app/index.js"
-    },
-    "./infra": {
-      "types": "./dist/infra/index.d.ts",
-      "import": "./dist/infra/index.js"
-    },
-    "./runtime": {
-      "types": "./dist/runtime/index.d.ts",
-      "import": "./dist/runtime/index.js"
-    },
-    "./testing": {
-      "types": "./dist/testing/index.d.ts",
-      "import": "./dist/testing/index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },

package/dist/app/callable-use-case.d.ts

@@ -1,34 +0,0 @@
-import { type ErrorMap, type Result } from '../core/index.js';
-import type { AnyEventCatalog, PortToken } from '../domain/index.js';
-import type { EventChannelCtor } from './types.js';
-/**
- * Request/response base for ExternalUseCase and InternalUseCase.
- * Do not declare `trigger` here — each sibling sets a distinct literal.
- * Not re-exported from hexok/app; application authors extend ExternalUseCase
- * or InternalUseCase.
- */
-export declare abstract class CallableUseCase {
-    /** Use-case id (`incident.close`). Unique among the callable family. */
-    static readonly key: string;
-    /** Request Standard Schema. Validated before `execute`. */
-    static readonly input: unknown;
-    /** Success Standard Schema. Types `execute`, `run`, and the contract. */
-    static readonly output: unknown;
-    /** Declared refusals. Keys become `errors.CODE()` factories on `ExecuteCtx`. */
-    static readonly errors: ErrorMap;
-    /** Port tokens keyed by the alias used in `execute`. Required by `App.from`. */
-    static readonly ports?: Record<string, PortToken<unknown>>;
-    /** `static publishes = [DomainEvents] as const` — without `as const`, Events widens to EventClass. */
-    static readonly publishes?: readonly AnyEventCatalog[];
-    /** `static channels = [ClientChannel] as const` — without `as const`, catalog keys widen. */
-    static readonly channels?: readonly EventChannelCtor[];
-    protected constructor();
-    /** Typed `never` so subclasses may take `ExecuteCtx` (tighter `publish`). */
-    abstract execute(ctx: never): Promise<unknown>;
-    /**
-     * Same one-liner as `if (!result.ok) throw new CodedError({ code: result.code })`.
-     * For `validate` / custom Results. Entity methods throw themselves.
-     */
-    unwrap<T, E extends string>(result: Result<T, E>): T;
-}
-//# sourceMappingURL=callable-use-case.d.ts.map

package/dist/app/callable-use-case.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"callable-use-case.d.ts","sourceRoot":"","sources":["../../src/app/callable-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,8BAAsB,eAAe;IACnC,wEAAwE;IACxE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAC/B,yEAAyE;IACzE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAM;IACtC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,sGAAsG;IACtG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACvD,6FAA6F;IAC7F,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAEvD,SAAS;IAET,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9C;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;CAYrD"}

package/dist/app/callable-use-case.js

@@ -1,41 +0,0 @@
-import { CodedError } from '../core/index.js';
-/**
- * Request/response base for ExternalUseCase and InternalUseCase.
- * Do not declare `trigger` here — each sibling sets a distinct literal.
- * Not re-exported from hexok/app; application authors extend ExternalUseCase
- * or InternalUseCase.
- */
-export class CallableUseCase {
-    /** Use-case id (`incident.close`). Unique among the callable family. */
-    static key;
-    /** Request Standard Schema. Validated before `execute`. */
-    static input;
-    /** Success Standard Schema. Types `execute`, `run`, and the contract. */
-    static output;
-    /** Declared refusals. Keys become `errors.CODE()` factories on `ExecuteCtx`. */
-    static errors = {};
-    /** Port tokens keyed by the alias used in `execute`. Required by `App.from`. */
-    static ports;
-    /** `static publishes = [DomainEvents] as const` — without `as const`, Events widens to EventClass. */
-    static publishes;
-    /** `static channels = [ClientChannel] as const` — without `as const`, catalog keys widen. */
-    static channels;
-    constructor() { }
-    /**
-     * Same one-liner as `if (!result.ok) throw new CodedError({ code: result.code })`.
-     * For `validate` / custom Results. Entity methods throw themselves.
-     */
-    unwrap(result) {
-        if (!result.ok) {
-            throw new CodedError({
-                code: result.code,
-                message: result.code,
-                ...(result.issues !== undefined
-                    ? { data: { issues: result.issues } }
-                    : {}),
-            });
-        }
-        return result.value;
-    }
-}
-//# sourceMappingURL=callable-use-case.js.map

package/dist/app/callable-use-case.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"callable-use-case.js","sourceRoot":"","sources":["../../src/app/callable-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AAI1E;;;;;GAKG;AACH,MAAM,OAAgB,eAAe;IACnC,wEAAwE;IACxE,MAAM,CAAU,GAAG,CAAS;IAC5B,2DAA2D;IAC3D,MAAM,CAAU,KAAK,CAAU;IAC/B,yEAAyE;IACzE,MAAM,CAAU,MAAM,CAAU;IAChC,gFAAgF;IAChF,MAAM,CAAU,MAAM,GAAa,EAAE,CAAC;IACtC,gFAAgF;IAChF,MAAM,CAAU,KAAK,CAAsC;IAC3D,sGAAsG;IACtG,MAAM,CAAU,SAAS,CAA8B;IACvD,6FAA6F;IAC7F,MAAM,CAAU,QAAQ,CAA+B;IAEvD,gBAAyB,CAAC;IAK1B;;;OAGG;IACH,MAAM,CAAsB,MAAoB;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,IAAI;gBACpB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS;oBAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE;oBACrC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC"}

package/dist/app/contract.d.ts

@@ -1,46 +0,0 @@
-import type { ErrorMap, StandardSchemaV1 } from '../core/index.js';
-import type { PathTo, UnionToIntersection } from './nest.js';
-import { type ExternalKeysOf, type UseCaseBag } from './types.js';
-/** One external use case in the runtime catalog. Transport-neutral, wide. */
-export type CatalogEntry = {
-    /** Use-case `key` (`incident.close`). */
-    key: string;
-    /** Request schema. */
-    input: StandardSchemaV1;
-    /** Success schema. */
-    output: StandardSchemaV1;
-    /** Declared error map. */
-    errors: ErrorMap;
-};
-/** Flat catalog from `deriveContract`. Event and internal use cases are omitted. */
-export type UseCaseContract = {
-    /** Entries keyed by use-case `key`. */
-    entries: Record<string, CatalogEntry>;
-};
-type UseCaseWithKey<Bag, Key> = Extract<Bag[keyof Bag], {
-    trigger: 'external';
-    key: Key;
-}>;
-type RouteView<C> = C extends {
-    key: infer Key extends string;
-    input: infer Input;
-    output: infer Output;
-    errors: infer Errors;
-} ? {
-    readonly key: Key;
-    readonly input: Input;
-    readonly output: Output;
-    readonly errors: Errors;
-} : never;
-/**
- * Nested by use-case `key` (`incident.close` → `{ incident: { close } }`).
- * Event and internal use cases are omitted.
- */
-export type DerivedContract<Bag> = UnionToIntersection<ExternalKeysOf<Bag> extends infer Key ? Key extends string ? PathTo<Key, RouteView<UseCaseWithKey<Bag, Key>>> : never : never>;
-/**
- * Build a transport-neutral catalog from a use-case class list.
- * Duplicate `key` throws. Event use cases and InternalUseCase are skipped.
- */
-export declare function deriveContract(useCases: UseCaseBag): UseCaseContract;
-export { nestByKey } from './nest.js';
-//# sourceMappingURL=contract.d.ts.map

package/dist/app/contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/app/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG;IACzB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,sBAAsB;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG;IAC5B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CACrC,GAAG,CAAC,MAAM,GAAG,CAAC,EACd;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAClC,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,CAAC;IAC9B,KAAK,EAAE,MAAM,KAAK,CAAC;IACnB,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB,GACG;IACE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,GAAG,IAAI,mBAAmB,CACpD,cAAc,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,GACjC,GAAG,SAAS,MAAM,GAChB,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAChD,KAAK,GACP,KAAK,CACV,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,UAAU,GAAG,eAAe,CAkBpE;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/app/contract.js

@@ -1,28 +0,0 @@
-import { isCallableUseCase, isExternalUseCase, } from './types.js';
-/**
- * Build a transport-neutral catalog from a use-case class list.
- * Duplicate `key` throws. Event use cases and InternalUseCase are skipped.
- */
-export function deriveContract(useCases) {
-    const entries = {};
-    const seen = new Set();
-    for (const ctor of Object.values(useCases)) {
-        if (!isCallableUseCase(ctor))
-            continue;
-        if (seen.has(ctor.key)) {
-            throw new Error(`hexok: duplicate use-case key "${ctor.key}"`);
-        }
-        seen.add(ctor.key);
-        if (!isExternalUseCase(ctor))
-            continue;
-        entries[ctor.key] = {
-            key: ctor.key,
-            input: ctor.input,
-            output: ctor.output,
-            errors: ctor.errors,
-        };
-    }
-    return { entries };
-}
-export { nestByKey } from './nest.js';
-//# sourceMappingURL=contract.js.map

package/dist/app/contract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/app/contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,YAAY,CAAC;AAmDpB;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAoB;IACjD,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAmB,EAAE,CAAC;QAC7D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;YAClB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}