hexok 1.0.1 → 2.1.0

package/skills/hexok/references/use-case.md

@@ -0,0 +1,164 @@
+# UseCase
+
+A use case is one thing a caller can do: publish a post, save a draft, subscribe an email address. Name it with `UseCase` and write the story in `execute`. The ports it needs arrive through the constructor.
+
+```ts
+class PublishPost extends UseCase('post.publish') {}
+```
+
+When every call in a family carries the same extra context, such as a trace id or the caller IP, use `UseCase.context` below. Plain `UseCase(token)` has `execute(input)` and never wraps that method.
+
+## Why it exists
+
+Publishing a post is a story with a beginning and an end. Load the post, apply the publish rule, save it, and announce that it was published. The use case is that story in one place. Saving and announcing stay behind ports, so the story reads the same when the database or the event transport changes. A refusal throws an error-catalog member. The application catches it at the edge.
+
+## How to use it
+
+`PublishPost` receives the repository and the event publisher. `execute` is the story. Callers see the input and return types you annotate.
+
+```ts
+class PublishPost extends UseCase('post.publish') {
+  constructor(
+    private readonly posts: PostRepository,
+    private readonly events: BlogEventPublisher,
+  ) {
+    super();
+  }
+
+  async execute(input: { id: string }): Promise<{ id: string }> {
+    const post = await this.posts.get(input.id);
+    post.publish(new Date());
+    await this.posts.save(post);
+    await this.events.publish(new PostPublished(post.toProps()));
+    return { id: post.props.id };
+  }
+}
+```
+
+The application constructs `PublishPost` with concrete adapters and calls `execute` from a gateway. One action is one class and one token. A caller who can save a draft and later publish it gets `SavePost` (`post.save`) and `PublishPost` (`post.publish`).
+
+Declare `execute` as a method. A class field, or an assignment after `super()`, is the wrong shape. The class is incomplete until `execute` exists, and the compiler reports the missing method.
+
+`execute` receives the input you declare and returns what you declare. Checking that input is the application's job: a guard on a context family, or the first lines of `execute`. Hexok does not validate `execute` and does not read a static key named `input`.
+
+## API
+
+`UseCase(token)` returns the class you extend. `token` is a string literal, such as `'post.publish'`.
+
+| Member | Role |
+| --- | --- |
+| `PublishPost.token` | The name you passed in. |
+| `execute(input)` | Required. Annotate the input and the return type on the subclass. |
+| `constructor` | Receive ports here and call `super()`. |
+
+A subclass of plain `UseCase(token)` takes one argument. Adding a context argument there is a type error. Reach for the family factory instead.
+
+## UseCase.context
+
+`UseCase.context` builds a family of use cases that share one kind of call. Every member receives a context argument. The family can refuse a call in a guard or observe it with hooks. Each member still has its own token, its own ports, and its own `execute`.
+
+Use it when the call carries something the story should see, such as a trace id or the actor who published the post. Putting that bag on `execute` as a first argument keeps it out of the post payload. The use case instance stays long-lived. The gateway builds a new context per request.
+
+```ts
+type ApiContext = { traceId: string };
+
+const ApiUseCase = UseCase.context<ApiContext>().guard((call) => {
+  if (call.ctx.traceId.length < 1) throw BlogError.TraceIdMissing();
+});
+
+class PublishPost extends ApiUseCase('post.publish') {
+  constructor(
+    private readonly posts: PostRepository,
+    private readonly events: BlogEventPublisher,
+  ) {
+    super();
+  }
+
+  async execute(
+    ctx: UseCase.Ctx<typeof ApiUseCase>,
+    input: { id: string },
+  ): Promise<{ id: string }> {
+    const post = await this.posts.get(input.id);
+    post.publish(new Date());
+    await this.posts.save(post);
+    await this.events.publish(new PostPublished(post.toProps()));
+    return { id: post.props.id };
+  }
+}
+
+await new PublishPost(posts, events).execute({ traceId: 'req-1' }, { id: 'p1' });
+```
+
+A member that needs a static contract, such as a permission string or an input schema the application will read, declares that contract as the second type argument. The schema is data the guard can read. Validating the input stays in the guard or in `execute`.
+
+```ts
+const ActorUseCase = UseCase.context<
+  { traceId: string; actorId: string },
+  { permission: string }
+>().guard((call) => {
+  if (call.spec.permission.length < 1) throw BlogError.Forbidden();
+});
+
+class PublishPost extends ActorUseCase('post.publish', {
+  permission: 'posts.publish',
+}) {
+  async execute(
+    ctx: UseCase.Ctx<typeof ActorUseCase>,
+    input: { id: string },
+  ): Promise<{ id: string }> {
+    return { id: input.id };
+  }
+}
+```
+
+### Factory
+
+`UseCase.context<Ctx, Spec>(config?)` returns a factory. `Ctx` is required. Omitting it makes the return type the string `'Pass a type argument: UseCase.context<Ctx>()'`. `Spec` defaults to an empty contract, so a member is `Factory(token)` only.
+
+`config` accepts no keys yet. Call `UseCase.context<Ctx>()` or `UseCase.context<Ctx>({})`. `guard` and `hooks` are methods on the factory, not fields of that object.
+
+`.guard(fn)` and `.hooks(def)` each return the factory again, so the calls can sit in either order and either one can be left off. A further `.guard()` runs after guards already registered. A second `.hooks()` that includes at least one callback throws `hexok: UseCase hooks are already set` when the factory is created. An empty `.hooks({})` adds no callbacks and does not wrap `execute`.
+
+When `Spec` has keys, the member is `Factory(token, statics)` and the bag has to satisfy `Spec`. Those entries are copied onto the class as statics. Literals stay narrow. The names `token`, `prototype`, `name`, and `length` stay on the class. Passing one of them is a type error.
+
+`execute` is still required. Annotate `ctx` and `input` on the subclass. A member with no input omits the second parameter. Declare `execute` as a method. Assigning it as a class field, or replacing it after `super()`, skips the guard and the hooks.
+
+When the family has no guard and no hooks, `execute` stays unwrapped so a missing method is still a class-site error.
+
+`UseCase.Ctx<typeof ApiUseCase>` is the context type. Pass the factory from `UseCase.context`. A subclass, and a plain `UseCase(token)` class, resolve to `never`. Annotate member `execute` parameters with it. A guard passed into the factory names `ctx` and `spec` from the application's own types. A function passed into the factory must not mention `UseCase.Ctx` or `UseCase.GuardParameters` of that still-inferred factory.
+
+### The call
+
+A guard and `preExecute` receive `{ ctx, spec, token, input }`.
+
+| Field | Meaning |
+| --- | --- |
+| `ctx` | The context the caller passed. |
+| `spec` | The static contract, typed as `Spec`. A guard sees `permission: string` even when one member passed the literal `'posts.publish'`. |
+| `token` | This member's token. |
+| `input` | The second argument the caller passed to `execute`. Typed `unknown`. The method receives that same value. |
+
+`UseCase.GuardParameters<typeof ApiUseCase>` is that call. `UseCase.Ctx<typeof ApiUseCase>` is `ctx`.
+
+Family hook `input` stays `unknown` on purpose. One factory hook is checked against every member. `SavePost` and `SubscribeToPosts` do not share an input type. Member annotations are what callers of that class see. Read `ctx` and `spec` in a family hook. Input-field logic belongs on `execute` or in a guard that already knows the member.
+
+### Guards
+
+A guard is `(call) => void | Promise<void>`. Guards run before `execute`, and outside the hook `try`. A throw from a guard skips `preExecute`, `postExecute`, `onCatch`, and `onFinally`. A zero-argument guard typechecks. A one-argument guard receives the call, not the bare context.
+
+### Hooks
+
+`.hooks(definition)` registers one set of callbacks for the family. `State` is inferred from `preExecute`'s return. It is `void` when `preExecute` is omitted. Later hooks receive `Awaited<State>`. `onCatch` and `onFinally` receive `Awaited<State> | undefined` because `preExecute` may have thrown or been omitted.
+
+| Hook | When it runs | Extra fields |
+| --- | --- | --- |
+| `preExecute(call)` | After the guards, before the method. | Its return value is `state` for the later hooks. |
+| `postExecute(call, state)` | After the method returns. | `call.result` is the method's return value. |
+| `onCatch(call, state)` | When `preExecute`, the method, or `postExecute` throws. | `call.error` is that error. The return value is ignored. The original error is thrown again. |
+| `onFinally(call, state)` | After a successful return or a caught failure. | `call.status` is `'success'` with `result`, or `'failure'` with `error`. |
+
+The pipeline is: guards, then `preExecute`, then the method with the caller's argument, then `postExecute`, then `onCatch` which rethrows, then `onFinally`. `postExecute` runs only after `preExecute` returns. `onFinally` always runs for attempts that entered the hooks. State is local to that invocation. Overlapping `execute` calls do not share it.
+
+The method receives the caller's input, and the caller receives the method's return value. Hooks do not replace either one. Record success in `postExecute` and the failure in `onCatch`. Finish a span in `onFinally`, which runs for both outcomes. A throw inside `onCatch` replaces the error after `onFinally` has seen the original one.
+
+There is no `around` hook. Leave `AsyncLocalStorage` to the application.

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

package/dist/app/error-factory.d.ts

@@ -1,9 +0,0 @@
-import { type ErrorMap, type Infer } from '../core/index.js';
-import type { ErrorFactories } from './types.js';
-/**
- * Build `errors.NOT_FOUND()` factories from an error map.
- * Each factory throws `CodedError` and types as `never`.
- */
-export declare function errorFactories<M extends ErrorMap>(map: M): ErrorFactories<M>;
-export type { Infer };
-//# sourceMappingURL=error-factory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"error-factory.d.ts","sourceRoot":"","sources":["../../src/app/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,KAAK,EAGX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAqB5E;AAED,YAAY,EAAE,KAAK,EAAE,CAAC"}

package/dist/app/error-factory.js

@@ -1,30 +0,0 @@
-import { CodedError, validate, } from '../core/index.js';
-/**
- * Build `errors.NOT_FOUND()` factories from an error map.
- * Each factory throws `CodedError` and types as `never`.
- */
-export function errorFactories(map) {
-    const factories = {};
-    for (const code of Object.keys(map)) {
-        const def = map[code];
-        if (def === undefined)
-            continue;
-        factories[code] = (data) => {
-            let payload;
-            if (def.data !== undefined && data !== undefined) {
-                const parsed = validate(def.data, data);
-                payload = parsed.ok ? parsed.value : data;
-            }
-            else if (data !== undefined) {
-                payload = data;
-            }
-            throw new CodedError({
-                code,
-                message: def.message ?? code,
-                ...(payload !== undefined ? { data: payload } : {}),
-            });
-        };
-    }
-    return factories;
-}
-//# sourceMappingURL=error-factory.js.map

package/dist/app/error-factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-factory.js","sourceRoot":"","sources":["../../src/app/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAIV,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAqB,GAAM;IACvD,MAAM,SAAS,GAAG,EAA+C,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAc,EAAE,EAAE;YACnC,IAAI,OAAgB,CAAC;YACrB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAwB,EAAE,IAAI,CAAC,CAAC;gBAC5D,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5C,CAAC;iBAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC9B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI;gBACJ,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;gBAC5B,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,SAA8B,CAAC;AACxC,CAAC"}

package/dist/app/event-channel.d.ts

@@ -1,133 +0,0 @@
-import { type ErrorMap, type Infer, type Result, type StandardSchemaV1 } from '../core/index.js';
-import type { AnyEventCatalog, Envelope, EventCatalog, PortToken } from '../domain/index.js';
-import type { ErrorFactories, ResolvedPorts } from './types.js';
-/**
- * Catalog-scoped delivery policy. Join, refresh, and route are app authority.
- * Presence I/O is a ChannelAdapter passed to `.route()`.
- *
- * ```ts
- * class ClientChannel extends EventChannel {
- *   static readonly catalog = ClientEvents
- *   static readonly joinInput = actorSchema
- *   async join({ input }: JoinCtx<typeof ClientChannel>) { return input }
- *   async refresh({ session }: RefreshCtx<typeof ClientChannel>) { return session }
- *   async route({ ctx, clients, send }: RouteCtx<typeof ClientChannel>) {
- *     for (const { id, session } of clients) {
- *       if (visibleTo(session, ctx)) await send(id)
- *     }
- *   }
- * }
- * ```
- */
-export declare abstract class EventChannel {
-    /** Discriminator for routed channels. Do not override. */
-    static readonly trigger: "channel";
-    /** Catalog whose events this channel delivers. Must be a bus. */
-    static readonly catalog: AnyEventCatalog;
-    /** Join-claims Standard Schema. Validated before `join`. */
-    static readonly joinInput: unknown;
-    /** Port tokens keyed by the alias used in join, refresh, and route. */
-    static readonly ports?: Record<string, PortToken<unknown>>;
-    /** Declared refusals. Keys become `errors.CODE()` factories on join/refresh. */
-    static readonly errors: ErrorMap;
-    protected constructor();
-    /** Admit a client and return the session to store. Typed `never` so subclasses may take `JoinCtx`. */
-    abstract join(ctx: never): Promise<unknown>;
-    /** Recompute a session; return `'eject'` to drop the client. Typed `never` so subclasses may take `RefreshCtx`. */
-    abstract refresh(ctx: never): Promise<unknown>;
-    /** Choose recipients for a catalog event via `send(id)`. Typed `never` so subclasses may take `RouteCtx`. */
-    abstract route(ctx: never): Promise<void>;
-    /**
-     * 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;
-}
-/** Session type returned from `join` and later passed to refresh and route. */
-export type ChannelSession<C> = C extends {
-    prototype: {
-        join: (ctx: never) => Promise<infer S>;
-    };
-} ? S : unknown;
-type CatalogKeyOfChannel<C> = C extends {
-    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
-} ? K : string;
-type CatalogCtxOfChannel<C> = C extends {
-    catalog: EventCatalog<string, infer _Kind, infer _E, infer Ctx>;
-} ? Ctx : unknown;
-/** Argument to `EventChannel.join`. Typed from the channel class statics. */
-export type JoinCtx<C> = {
-    /** Validated `static joinInput`. */
-    input: C extends {
-        joinInput: infer S extends StandardSchemaV1;
-    } ? Infer<S> : unknown;
-    /** Bound adapters from `static ports`. */
-    ports: C extends {
-        ports: infer P;
-    } ? ResolvedPorts<P> : Record<string, never>;
-    /** Factories from `static errors`. Throw `errors.FORBIDDEN()`. */
-    errors: C extends {
-        errors: infer E;
-    } ? ErrorFactories<E> : ErrorFactories<never>;
-};
-/** Argument to `EventChannel.refresh`. Typed from the channel class statics. */
-export type RefreshCtx<C> = {
-    /** Current session from join or the last successful refresh. */
-    session: ChannelSession<C>;
-    /** Bound adapters from `static ports`. */
-    ports: C extends {
-        ports: infer P;
-    } ? ResolvedPorts<P> : Record<string, never>;
-    /** Factories from `static errors`. Throw `errors.FORBIDDEN()`. */
-    errors: C extends {
-        errors: infer E;
-    } ? ErrorFactories<E> : ErrorFactories<never>;
-};
-/** Argument to `EventChannel.route`. `ctx` here is catalog context, not app request context. */
-export type RouteCtx<C> = {
-    /** Envelope just published on this channel's catalog. */
-    event: Envelope<string, unknown, CatalogKeyOfChannel<C>, 'bus', CatalogCtxOfChannel<C>>;
-    /** Catalog `ctx` from the envelope — not `ExecuteCtx.ctx`. */
-    ctx: CatalogCtxOfChannel<C>;
-    /** Connected clients and their sessions. */
-    clients: ReadonlyArray<{
-        id: string;
-        session: ChannelSession<C>;
-    }>;
-    /** Bound adapters from `static ports`. */
-    ports: C extends {
-        ports: infer P;
-    } ? ResolvedPorts<P> : Record<string, never>;
-    /** Deliver the serialized event to one client id. */
-    send: (id: string) => Promise<void>;
-};
-/** Presence handle for one catalog, from `channels` in `execute`. */
-export type ChannelControl<Session = unknown> = {
-    /** Connected clients and their sessions. */
-    list(): ReadonlyArray<{
-        id: string;
-        session: Session;
-    }>;
-    /** Drop one client by id. */
-    eject(id: string): void;
-    /** Drop every client whose session matches. */
-    ejectWhere(pred: (session: Session) => boolean): void;
-    /** Re-run `refresh` for one client. */
-    refresh(id: string): Promise<void>;
-    /** Re-run `refresh` for matching sessions. */
-    refreshWhere(pred: (session: Session) => boolean): Promise<void>;
-    /** Replace a session without running `refresh`. */
-    update(id: string, session: Session): void;
-};
-type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
-type ChannelHandleMap<Ch> = [Ch] extends [never] ? Record<string, never> : UnionToIntersection<Ch extends infer C ? C extends {
-    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
-} ? {
-    [P in K]: ChannelControl<ChannelSession<C>>;
-} : never : never>;
-/** `channels` on execute ctx, keyed by catalog key from `static channels`. */
-export type ChannelProps<C> = C extends {
-    channels: readonly (infer Ch)[];
-} ? [Ch] extends [never] ? Record<string, never> : ChannelHandleMap<Ch> : Record<string, never>;
-export {};
-//# sourceMappingURL=event-channel.d.ts.map

package/dist/app/event-channel.d.ts.map

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

package/dist/app/event-channel.js

@@ -1,49 +0,0 @@
-import { CodedError, } from '../core/index.js';
-/**
- * Catalog-scoped delivery policy. Join, refresh, and route are app authority.
- * Presence I/O is a ChannelAdapter passed to `.route()`.
- *
- * ```ts
- * class ClientChannel extends EventChannel {
- *   static readonly catalog = ClientEvents
- *   static readonly joinInput = actorSchema
- *   async join({ input }: JoinCtx<typeof ClientChannel>) { return input }
- *   async refresh({ session }: RefreshCtx<typeof ClientChannel>) { return session }
- *   async route({ ctx, clients, send }: RouteCtx<typeof ClientChannel>) {
- *     for (const { id, session } of clients) {
- *       if (visibleTo(session, ctx)) await send(id)
- *     }
- *   }
- * }
- * ```
- */
-export class EventChannel {
-    /** Discriminator for routed channels. Do not override. */
-    static trigger = 'channel';
-    /** Catalog whose events this channel delivers. Must be a bus. */
-    static catalog;
-    /** Join-claims Standard Schema. Validated before `join`. */
-    static joinInput;
-    /** Port tokens keyed by the alias used in join, refresh, and route. */
-    static ports;
-    /** Declared refusals. Keys become `errors.CODE()` factories on join/refresh. */
-    static errors = {};
-    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=event-channel.js.map

package/dist/app/event-channel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-channel.js","sourceRoot":"","sources":["../../src/app/event-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,MAAM,kBAAkB,CAAC;AAS1B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,YAAY;IAChC,0DAA0D;IAC1D,MAAM,CAAU,OAAO,GAAG,SAAkB,CAAC;IAC7C,iEAAiE;IACjE,MAAM,CAAU,OAAO,CAAkB;IACzC,4DAA4D;IAC5D,MAAM,CAAU,SAAS,CAAU;IACnC,uEAAuE;IACvE,MAAM,CAAU,KAAK,CAAsC;IAC3D,gFAAgF;IAChF,MAAM,CAAU,MAAM,GAAa,EAAE,CAAC;IAEtC,gBAAyB,CAAC;IAS1B;;;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/event-use-case.d.ts

@@ -1,47 +0,0 @@
-import { type ErrorMap, type Result } from '../core/index.js';
-import type { AnyEventCatalog, EventClass, PortToken } from '../domain/index.js';
-import type { EventChannelCtor } from './types.js';
-/**
- * Event handler. Mutually exclusive with ExternalUseCase and InternalUseCase.
- * Queue catalogs require `static group`.
- *
- * ```ts
- * class NotifyOnClose extends EventUseCase {
- *   static readonly key = 'incident.notifyOnClose'
- *   static readonly on = IncidentClosed
- *   static readonly catalog = DomainEvents
- *   async execute({ event, ports }: EventCtx<typeof NotifyOnClose>) {
- *     await ports.notifier.send(event.payload)
- *   }
- * }
- * ```
- */
-export declare abstract class EventUseCase {
-    /** Discriminator for `App.from` / `isEventUseCase`. Do not override. */
-    static readonly trigger: "event";
-    /** Handler id (`incident.notifyOnClose`). Used in completeness messages. */
-    static readonly key: string;
-    /** Event class this handler listens to. Required by `App.from`; must be in `catalog`. */
-    static readonly on?: EventClass;
-    /** Catalog that owns `on`. Required by `App.from`; bind it with `App.bind`. */
-    static readonly catalog?: AnyEventCatalog;
-    /** Port tokens keyed by the alias used in `execute`. */
-    static readonly ports?: Record<string, PortToken<unknown>>;
-    /** Consumer group for queue catalogs. Required when `catalog.kind` is `'queue'`. */
-    static readonly group?: string;
-    /** `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[];
-    /** Declared refusals. Keys become `errors.CODE()` factories on `EventCtx`. */
-    static readonly errors: ErrorMap;
-    protected constructor();
-    /** Typed `never` so subclasses may take `EventCtx` (tighter `publish`). */
-    abstract execute(ctx: never): Promise<void>;
-    /**
-     * 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=event-use-case.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"event-use-case.d.ts","sourceRoot":"","sources":["../../src/app/event-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,YAAY;IAChC,wEAAwE;IACxE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAU;IAC3C,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC;IAChC,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1C,wDAAwD;IACxD,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,oFAAoF;IACpF,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,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;IACvD,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAM;IAEtC,SAAS;IAET,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;CAYrD"}