hexok 1.0.0

package/dist/runtime/middleware.d.ts

@@ -0,0 +1,20 @@
+/** Onion around external `execute` (`local` and HTTP). Does not run for event handlers or nested `run`. */
+export type ApiMiddleware<Ctx = unknown> = (args: {
+    /** Request context (`ctx` on the use case). */
+    context: Ctx;
+    /** Parsed API input. */
+    input: unknown;
+    /** Continue the onion. Does not accept a replacement ctx. */
+    next: () => Promise<unknown>;
+    /** Error factories from the use-case error map. */
+    errors: {
+        [code: string]: (data?: unknown) => never;
+    };
+    /** Use-case key (`incident.close`). */
+    path: string;
+    /** Present on HTTP `router.fetch` only. Read headers here; set ctx with `.ctxFrom`. */
+    request?: Request;
+}) => Promise<unknown>;
+/** @deprecated Use `ApiMiddleware`. Same type; not HTTP-only. */
+export type RpcMiddleware<Ctx = unknown> = ApiMiddleware<Ctx>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/runtime/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/runtime/middleware.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,MAAM,aAAa,CAAC,GAAG,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE;IAChD,+CAA+C;IAC/C,OAAO,EAAE,GAAG,CAAC;IACb,wBAAwB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,mDAAmD;IACnD,MAAM,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,KAAK,CAAA;KAAE,CAAC;IACtD,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvB,iEAAiE;AACjE,MAAM,MAAM,aAAa,CAAC,GAAG,GAAG,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC"}

package/dist/runtime/middleware.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=middleware.js.map

package/dist/runtime/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/runtime/middleware.ts"],"names":[],"mappings":""}

package/dist/runtime/rpc.d.ts

@@ -0,0 +1,24 @@
+import type { CatalogEntry, UseCaseBag, UseCaseContract } from '../app/index.js';
+import type { PathTo, UnionToIntersection } from '../app/nest.js';
+import type { ExternalKeysOf } from '../app/types.js';
+/** Dotted use-case key to HTTP path (`incident.close` → `/rpc/incident/close`). */
+export declare function rpcPath(key: string): string;
+/** One API route with a POST path under `/rpc`. */
+export type RpcRoute = CatalogEntry & {
+    /** Always `POST`. */
+    method: 'POST';
+    /** `/rpc/...` path derived from the use-case key. */
+    path: string;
+};
+type NestedRpc<Bag> = UnionToIntersection<ExternalKeysOf<Bag> extends infer Key ? Key extends string ? PathTo<Key, RpcRoute> : never : never>;
+/** Flat `routes` plus nested keys (`rpc.incident.close.path`). */
+export type RpcContract<Bag extends UseCaseBag = UseCaseBag> = {
+    /** Routes keyed by use-case `key`. */
+    routes: {
+        [K in Extract<ExternalKeysOf<Bag>, string>]: RpcRoute;
+    };
+} & NestedRpc<Bag>;
+/** Attach `POST /rpc/...` paths to each external catalog entry and nest by use-case key. */
+export declare function deriveRpc<Bag extends UseCaseBag = UseCaseBag>(contract: UseCaseContract): RpcContract<Bag>;
+export {};
+//# sourceMappingURL=rpc.d.ts.map

package/dist/runtime/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/runtime/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG;IACpC,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,SAAS,CAAC,GAAG,IAAI,mBAAmB,CACvC,cAAc,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,GACjC,GAAG,SAAS,MAAM,GAChB,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,GACrB,KAAK,GACP,KAAK,CACV,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,WAAW,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,IAAI;IAC7D,sCAAsC;IACtC,MAAM,EAAE;SAAG,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,QAAQ;KAAE,CAAC;CACnE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;AAEnB,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,EAC3D,QAAQ,EAAE,eAAe,GACxB,WAAW,CAAC,GAAG,CAAC,CAQlB"}

package/dist/runtime/rpc.js

@@ -0,0 +1,16 @@
+import { nestByKey } from '../app/index.js';
+/** Dotted use-case key to HTTP path (`incident.close` → `/rpc/incident/close`). */
+export function rpcPath(key) {
+    return `/rpc/${key.split('.').join('/')}`;
+}
+/** Attach `POST /rpc/...` paths to each external catalog entry and nest by use-case key. */
+export function deriveRpc(contract) {
+    const routes = {};
+    for (const [key, entry] of Object.entries(contract.entries)) {
+        routes[key] = { ...entry, method: 'POST', path: rpcPath(entry.key) };
+    }
+    return Object.assign(nestByKey(Object.entries(routes)), {
+        routes,
+    });
+}
+//# sourceMappingURL=rpc.js.map

package/dist/runtime/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/runtime/rpc.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,mFAAmF;AACnF,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,QAAQ,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5C,CAAC;AAwBD,4FAA4F;AAC5F,MAAM,UAAU,SAAS,CACvB,QAAyB;IAEzB,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE;QACtD,MAAM;KACP,CAAqB,CAAC;AACzB,CAAC"}

package/dist/testing/app-test.d.ts

@@ -0,0 +1,77 @@
+import type { AsUseCaseBag, ChannelSession, CheckUseCase, EventChannelCtor, UseCaseBag } from '../app/index.js';
+import type { CatalogKind, ChannelAdapter, Envelope, EventCatalog, EventClass, PortToken } from '../domain/index.js';
+import { type AdapterFor, type ApiMiddleware, type AppInstance, type ChannelKindError, type DuplicateCatalogError, type DuplicateChannelError, type DuplicatePortError, type Interceptor, type MissingMessages, type NestedClient } from '../runtime/index.js';
+/**
+ * Built test app: runtime `AppInstance` plus `published` and `as(ctx)`.
+ * Use `App.test(...).build()`, then assert `app.published` or call `app.as(ctx)`.
+ */
+export type TestAppInstance<Bag extends UseCaseBag, Ctx = unknown, Routed = never> = AppInstance<Bag, Ctx, Routed> & {
+    /** Envelopes that completed `aroundPublish`, in order. */
+    published: Envelope[];
+    /** Nested local client with `ctx` fixed on every call. */
+    as: (ctx: Ctx) => NestedClient<Bag, Ctx>;
+};
+type ChannelCatalogKind<C> = C extends {
+    catalog: EventCatalog<string, infer Kind, infer _E, infer _Ctx>;
+} ? Kind : CatalogKind;
+type ChannelCatalogKey<C> = C extends {
+    catalog: EventCatalog<infer K extends string, infer _Kind, infer _E, infer _Ctx>;
+} ? K : string;
+/**
+ * Test composition root with the same `provide`/`bind`/`route`/`ctx`/`build`
+ * as runtime, plus `published` capture. Construct with `App.test`, not `new`.
+ */
+export declare class TestAppBuilder<Bag extends UseCaseBag, Provided = never, Bound = never, Ctx = unknown, Routed = never> {
+    #private;
+    private constructor();
+    /** Start a test graph from a use-case bag. The built app has `published` and `as`. */
+    static test<Bag extends {
+        [K in keyof Bag]: CheckUseCase<Bag[K]>;
+    }>(useCases: Bag): TestAppBuilder<AsUseCaseBag<Bag>>;
+    /** Bind a port token to an implementation, usually an in-memory fake. */
+    provide<I>(token: [PortToken<I>] extends [Provided] ? DuplicatePortError : PortToken<I>, impl: I): TestAppBuilder<Bag, Provided | PortToken<I>, Bound, Ctx, Routed>;
+    /** Bind a catalog to a bus or queue adapter (`InMemoryBus` / `InMemoryQueue`). */
+    bind<Key extends string, Kind extends CatalogKind, Events extends EventClass = never, CatCtx = undefined>(catalog: [EventCatalog<Key, Kind, Events, CatCtx>] extends [Bound] ? DuplicateCatalogError<Key> : EventCatalog<Key, Kind, Events, CatCtx>, adapter: AdapterFor<Kind>): TestAppBuilder<Bag, Provided, Bound | EventCatalog<Key, Kind, Events, CatCtx>, Ctx, Routed>;
+    /** Route a bus `EventChannel` to a channel adapter (`InMemoryChannel`). */
+    route<C extends EventChannelCtor>(channel: ChannelCatalogKind<C> extends 'bus' ? [C] extends [Routed] ? DuplicateChannelError<ChannelCatalogKey<C>> : C : ChannelKindError<ChannelCatalogKey<C>, ChannelCatalogKind<C> & string>, adapter: ChannelAdapter<ChannelSession<C>>): TestAppBuilder<Bag, Provided, Bound, Ctx, Routed | C>;
+    /** Set default request context for `local` and HTTP. `as(ctx)` overrides per call. */
+    ctx<C>(defaults?: C): TestAppBuilder<Bag, Provided, Bound, C, Routed>;
+    /** Set HTTP request context from the `Request`. Same as runtime `.ctxFrom`. */
+    ctxFrom(fn: (args: {
+        request: Request;
+        ctx: Ctx;
+    }) => Ctx | Promise<Ctx>): this;
+    /** Provide a factory from `Adapter.of` by calling `create(...deps)`. */
+    adapt<I, Deps extends unknown[]>(factory: {
+        token: [PortToken<I>] extends [Provided] ? DuplicatePortError : PortToken<I>;
+        create: (...deps: Deps) => I;
+    }, ...deps: Deps): TestAppBuilder<Bag, Provided | PortToken<I>, Bound, Ctx, Routed>;
+    /** Register API middleware on the inner runtime builder. */
+    use(middleware: ApiMiddleware): this;
+    /** Register an interceptor. First registered is outer; `App.test` already captured publish. */
+    intercept(interceptor: Interceptor): this;
+    /**
+     * Complete the graph; incomplete builders expose `build` as the missing
+     * port/catalog message (not callable). The instance includes `published` and `as`.
+     */
+    get build(): [MissingMessages<Bag, Provided, Bound, Routed>] extends [never] ? () => TestAppInstance<Bag, Ctx, Routed> : MissingMessages<Bag, Provided, Bound, Routed>;
+}
+/**
+ * Same completeness as `App.from`, plus `published` capture (after
+ * `aroundPublish`) and `as(ctx)` to rebind request context.
+ *
+ * ```ts
+ * const app = App.test({ close: CloseIncident })
+ *   .provide(IncidentRepository, InMemoryRepository.of(...))
+ *   .bind(DomainEvents, InMemoryBus.create())
+ *   .build()
+ * await app.local.incident.close({ id: '1' })
+ * expect(app.published).toHaveLength(1)
+ * ```
+ */
+export declare const App: {
+    /** Start a test graph. The built app has `published` and `as`. Production composition is `hexok/runtime` `App.from`. */
+    test: typeof TestAppBuilder.test;
+};
+export {};
+//# sourceMappingURL=app-test.d.ts.map

package/dist/testing/app-test.d.ts.map

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

package/dist/testing/app-test.js

@@ -0,0 +1,109 @@
+import { App as RuntimeApp, } from '../runtime/index.js';
+/**
+ * Test composition root with the same `provide`/`bind`/`route`/`ctx`/`build`
+ * as runtime, plus `published` capture. Construct with `App.test`, not `new`.
+ */
+export class TestAppBuilder {
+    #inner;
+    #published;
+    constructor(inner, published) {
+        this.#inner = inner;
+        this.#published = published;
+    }
+    /** Start a test graph from a use-case bag. The built app has `published` and `as`. */
+    static test(useCases) {
+        const published = [];
+        const inner = RuntimeApp.from(useCases).intercept({
+            key: 'hexok:published',
+            aroundPublish: async (envelope, next) => {
+                await next();
+                published.push(envelope);
+            },
+        });
+        return new TestAppBuilder(inner, published);
+    }
+    /** Bind a port token to an implementation, usually an in-memory fake. */
+    provide(token, impl) {
+        const next = this.#inner.provide(token, impl);
+        return new TestAppBuilder(next, this.#published);
+    }
+    /** Bind a catalog to a bus or queue adapter (`InMemoryBus` / `InMemoryQueue`). */
+    bind(catalog, adapter) {
+        const next = this.#inner.bind(catalog, adapter);
+        return new TestAppBuilder(next, this.#published);
+    }
+    /** Route a bus `EventChannel` to a channel adapter (`InMemoryChannel`). */
+    route(channel, adapter) {
+        const next = this.#inner.route(channel, adapter);
+        return new TestAppBuilder(next, this.#published);
+    }
+    /** Set default request context for `local` and HTTP. `as(ctx)` overrides per call. */
+    ctx(defaults) {
+        const next = this.#inner.ctx(defaults);
+        return new TestAppBuilder(next, this.#published);
+    }
+    /** Set HTTP request context from the `Request`. Same as runtime `.ctxFrom`. */
+    ctxFrom(fn) {
+        this.#inner.ctxFrom(fn);
+        return this;
+    }
+    /** Provide a factory from `Adapter.of` by calling `create(...deps)`. */
+    adapt(factory, ...deps) {
+        return this.provide(factory.token, factory.create(...deps));
+    }
+    /** Register API middleware on the inner runtime builder. */
+    use(middleware) {
+        this.#inner.use(middleware);
+        return this;
+    }
+    /** Register an interceptor. First registered is outer; `App.test` already captured publish. */
+    intercept(interceptor) {
+        this.#inner.intercept(interceptor);
+        return this;
+    }
+    /**
+     * Complete the graph; incomplete builders expose `build` as the missing
+     * port/catalog message (not callable). The instance includes `published` and `as`.
+     */
+    get build() {
+        const published = this.#published;
+        return (() => {
+            const app = this.#inner.build();
+            return Object.assign(app, {
+                published,
+                as: (ctx) => rebindLocal(app.local, ctx),
+            });
+        });
+    }
+}
+/**
+ * Same completeness as `App.from`, plus `published` capture (after
+ * `aroundPublish`) and `as(ctx)` to rebind request context.
+ *
+ * ```ts
+ * const app = App.test({ close: CloseIncident })
+ *   .provide(IncidentRepository, InMemoryRepository.of(...))
+ *   .bind(DomainEvents, InMemoryBus.create())
+ *   .build()
+ * await app.local.incident.close({ id: '1' })
+ * expect(app.published).toHaveLength(1)
+ * ```
+ */
+export const App = {
+    /** Start a test graph. The built app has `published` and `as`. Production composition is `hexok/runtime` `App.from`. */
+    test: TestAppBuilder.test,
+};
+function rebindLocal(value, ctx) {
+    if (typeof value === 'function') {
+        return (input, opts) => value(input, { ...opts, ctx });
+    }
+    if (value !== null && typeof value === 'object') {
+        const out = Object.create(null);
+        for (const [key, child] of Object.entries(value)) {
+            out[key] = rebindLocal(child, ctx);
+        }
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=app-test.js.map

package/dist/testing/app-test.js.map

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

package/dist/testing/in-memory-broker.d.ts

@@ -0,0 +1,18 @@
+import type { BrokerAdapter, BrokerConsumeCtx, Envelope } from '../domain/index.js';
+type Consumer = (envelope: Envelope, ctx: BrokerConsumeCtx) => Promise<void>;
+/**
+ * In-process broker. `consume` dispatches with attempt; ack/nack are no-ops
+ * besides recording. `stop()` clears consumers.
+ */
+export declare class InMemoryBroker implements BrokerAdapter {
+    #private;
+    readonly kind: "broker";
+    readonly published: Envelope[];
+    attempts: number;
+    static create(): InMemoryBroker;
+    publish(envelope: Envelope): Promise<void>;
+    consume(key: string, group: string, handler: Consumer): void;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=in-memory-broker.d.ts.map

package/dist/testing/in-memory-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-broker.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAE5B,KAAK,QAAQ,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7E;;;GAGG;AACH,qBAAa,cAAe,YAAW,aAAa;;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAM;IAEpC,QAAQ,SAAK;IAEb,MAAM,CAAC,MAAM,IAAI,cAAc;IAIzB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAMtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/testing/in-memory-broker.js

@@ -0,0 +1,42 @@
+/**
+ * In-process broker. `consume` dispatches with attempt; ack/nack are no-ops
+ * besides recording. `stop()` clears consumers.
+ */
+export class InMemoryBroker {
+    kind = 'broker';
+    published = [];
+    #consumers = new Map();
+    attempts = 1;
+    static create() {
+        return new InMemoryBroker();
+    }
+    async publish(envelope) {
+        this.published.push(envelope);
+        const groups = this.#consumers.get(envelope.key);
+        if (!groups)
+            return;
+        for (const consumer of groups.values()) {
+            let acked = false;
+            const ctx = {
+                attempt: this.attempts,
+                ack: async () => {
+                    acked = true;
+                },
+                nack: async () => {
+                    acked = false;
+                },
+            };
+            await consumer(envelope, ctx);
+            void acked;
+        }
+    }
+    consume(key, group, handler) {
+        const groups = this.#consumers.get(key) ?? new Map();
+        groups.set(group, handler);
+        this.#consumers.set(key, groups);
+    }
+    async stop() {
+        this.#consumers.clear();
+    }
+}
+//# sourceMappingURL=in-memory-broker.js.map

package/dist/testing/in-memory-broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-broker.js","sourceRoot":"","sources":["../../src/testing/in-memory-broker.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,QAAiB,CAAC;IACzB,SAAS,GAAe,EAAE,CAAC;IACpC,UAAU,GAAG,IAAI,GAAG,EAAiC,CAAC;IACtD,QAAQ,GAAG,CAAC,CAAC;IAEb,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAkB;QAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,MAAM,GAAG,GAAqB;gBAC5B,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,GAAG,EAAE,KAAK,IAAI,EAAE;oBACd,KAAK,GAAG,IAAI,CAAC;gBACf,CAAC;gBACD,IAAI,EAAE,KAAK,IAAI,EAAE;oBACf,KAAK,GAAG,KAAK,CAAC;gBAChB,CAAC;aACF,CAAC;YACF,MAAM,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC9B,KAAK,KAAK,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,KAAa,EAAE,OAAiB;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAoB,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/testing/in-memory-bus.d.ts

@@ -0,0 +1,19 @@
+import type { BusAdapter, Envelope } from '../domain/index.js';
+/**
+ * In-process bus. Records `published`. `stop()` clears subscribers.
+ */
+export declare class InMemoryBus implements BusAdapter {
+    #private;
+    readonly kind: "bus";
+    /** Envelopes passed to `publish`, in order. */
+    readonly published: Envelope[];
+    /** Empty bus. Pass to `.bind(catalog, InMemoryBus.create())`. */
+    static create(): InMemoryBus;
+    /** Record the envelope, then await each subscriber for its key. */
+    publish(envelope: Envelope): Promise<void>;
+    /** Register a handler for `key`. Cleared by `stop()`. */
+    subscribe(key: string, handler: (envelope: Envelope) => Promise<void>): void;
+    /** Drop all subscribers. Does not clear `published`. */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=in-memory-bus.d.ts.map

package/dist/testing/in-memory-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-bus.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,qBAAa,WAAY,YAAW,UAAU;;IAC5C,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAM;IAMpC,iEAAiE;IACjE,MAAM,CAAC,MAAM,IAAI,WAAW;IAI5B,mEAAmE;IAC7D,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,yDAAyD;IACzD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAM5E,wDAAwD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/testing/in-memory-bus.js

@@ -0,0 +1,31 @@
+/**
+ * In-process bus. Records `published`. `stop()` clears subscribers.
+ */
+export class InMemoryBus {
+    kind = 'bus';
+    /** Envelopes passed to `publish`, in order. */
+    published = [];
+    #subscribers = new Map();
+    /** Empty bus. Pass to `.bind(catalog, InMemoryBus.create())`. */
+    static create() {
+        return new InMemoryBus();
+    }
+    /** Record the envelope, then await each subscriber for its key. */
+    async publish(envelope) {
+        this.published.push(envelope);
+        for (const handler of this.#subscribers.get(envelope.key) ?? []) {
+            await handler(envelope);
+        }
+    }
+    /** Register a handler for `key`. Cleared by `stop()`. */
+    subscribe(key, handler) {
+        const list = this.#subscribers.get(key) ?? [];
+        list.push(handler);
+        this.#subscribers.set(key, list);
+    }
+    /** Drop all subscribers. Does not clear `published`. */
+    async stop() {
+        this.#subscribers.clear();
+    }
+}
+//# sourceMappingURL=in-memory-bus.js.map

package/dist/testing/in-memory-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-bus.js","sourceRoot":"","sources":["../../src/testing/in-memory-bus.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,KAAc,CAAC;IAC/B,+CAA+C;IACtC,SAAS,GAAe,EAAE,CAAC;IACpC,YAAY,GAAG,IAAI,GAAG,EAGnB,CAAC;IAEJ,iEAAiE;IACjE,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,OAAO,CAAC,QAAkB;QAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAChE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,SAAS,CAAC,GAAW,EAAE,OAA8C;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/testing/in-memory-channel.d.ts

@@ -0,0 +1,32 @@
+import type { ChannelAdapter, ChannelConnection } from '../domain/index.js';
+/**
+ * In-process channel adapter. Records `sent`. `stop()` closes connections.
+ */
+export declare class InMemoryChannel<Session = unknown> implements ChannelAdapter<Session> {
+    #private;
+    /** `{ id, payload }` records from `send`, in order. */
+    readonly sent: Array<{
+        id: string;
+        payload: string;
+    }>;
+    /** Empty channel. Pass to `.route(Channel, InMemoryChannel.create())`. */
+    static create<S>(): InMemoryChannel<S>;
+    /** Track a connected client. Replaces an existing row with the same `id`. */
+    join(id: string, session: Session, connection: ChannelConnection): void;
+    /** Drop the client without closing the connection. */
+    leave(id: string): void;
+    /** Close the connection; the `close` listener then `leave`s. */
+    eject(id: string): void;
+    /** Replace session claims for a connected client. No-op if unknown `id`. */
+    update(id: string, session: Session): void;
+    /** Snapshot of connected `{ id, session }` rows. */
+    list(): Array<{
+        id: string;
+        session: Session;
+    }>;
+    /** Record and deliver `payload` to `id`. Leaves the client if `send` throws. */
+    send(id: string, payload: string): void;
+    /** Close every connection and clear clients. Does not clear `sent`. */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=in-memory-channel.d.ts.map

package/dist/testing/in-memory-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-channel.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5E;;GAEG;AACH,qBAAa,eAAe,CAAC,OAAO,GAAG,OAAO,CAC5C,YAAW,cAAc,CAAC,OAAO,CAAC;;IAElC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAG3D,0EAA0E;IAC1E,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC;IAItC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAOvE,sDAAsD;IACtD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvB,gEAAgE;IAChE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMvB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAM1C,oDAAoD;IACpD,IAAI,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAO/C,gFAAgF;IAChF,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWvC,uEAAuE;IACjE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAM5B"}

package/dist/testing/in-memory-channel.js

@@ -0,0 +1,65 @@
+/**
+ * In-process channel adapter. Records `sent`. `stop()` closes connections.
+ */
+export class InMemoryChannel {
+    /** `{ id, payload }` records from `send`, in order. */
+    sent = [];
+    #clients = new Map();
+    /** Empty channel. Pass to `.route(Channel, InMemoryChannel.create())`. */
+    static create() {
+        return new InMemoryChannel();
+    }
+    /** Track a connected client. Replaces an existing row with the same `id`. */
+    join(id, session, connection) {
+        this.#clients.set(id, { session, connection });
+        connection.addEventListener('close', () => {
+            this.leave(id);
+        });
+    }
+    /** Drop the client without closing the connection. */
+    leave(id) {
+        this.#clients.delete(id);
+    }
+    /** Close the connection; the `close` listener then `leave`s. */
+    eject(id) {
+        const row = this.#clients.get(id);
+        if (!row)
+            return;
+        row.connection.close();
+    }
+    /** Replace session claims for a connected client. No-op if unknown `id`. */
+    update(id, session) {
+        const row = this.#clients.get(id);
+        if (!row)
+            return;
+        row.session = session;
+    }
+    /** Snapshot of connected `{ id, session }` rows. */
+    list() {
+        return [...this.#clients.entries()].map(([id, row]) => ({
+            id,
+            session: row.session,
+        }));
+    }
+    /** Record and deliver `payload` to `id`. Leaves the client if `send` throws. */
+    send(id, payload) {
+        const row = this.#clients.get(id);
+        if (!row)
+            return;
+        this.sent.push({ id, payload });
+        try {
+            row.connection.send(payload);
+        }
+        catch {
+            this.leave(id);
+        }
+    }
+    /** Close every connection and clear clients. Does not clear `sent`. */
+    async stop() {
+        for (const { connection } of this.#clients.values()) {
+            connection.close();
+        }
+        this.#clients.clear();
+    }
+}
+//# sourceMappingURL=in-memory-channel.js.map

package/dist/testing/in-memory-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-channel.js","sourceRoot":"","sources":["../../src/testing/in-memory-channel.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,OAAO,eAAe;IAG1B,uDAAuD;IAC9C,IAAI,GAA2C,EAAE,CAAC;IAC3D,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE3C,0EAA0E;IAC1E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,eAAe,EAAK,CAAC;IAClC,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,EAAU,EAAE,OAAgB,EAAE,UAA6B;QAC9D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/C,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACxC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,EAAU;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,EAAU,EAAE,OAAgB;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,oDAAoD;IACpD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,EAAE;YACF,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,gFAAgF;IAChF,IAAI,CAAC,EAAU,EAAE,OAAe;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,IAAI;QACR,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/testing/in-memory-queue.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope, QueueAdapter, QueueConsumeCtx } from '../domain/index.js';
+type Consumer = (envelope: Envelope, ctx: QueueConsumeCtx) => Promise<void>;
+/**
+ * In-process queue. `nack` (or a throw) redelivers with `attempt + 1` up to
+ * `maxAttempts` (default 3). `stop()` clears consumers.
+ */
+export declare class InMemoryQueue implements QueueAdapter {
+    #private;
+    readonly kind: "queue";
+    /** Envelopes passed to `publish`, in order (one entry per publish, not per attempt). */
+    readonly published: Envelope[];
+    /** Stop redelivering after this many attempts. */
+    maxAttempts: number;
+    /** Empty queue. Pass to `.bind(catalog, InMemoryQueue.create())`. */
+    static create(): InMemoryQueue;
+    /** Record the envelope and dispatch every consumer group for its key. */
+    publish(envelope: Envelope): Promise<void>;
+    /** Register the consumer for `key`+`group`. Later calls replace that group. */
+    consume(key: string, group: string, handler: Consumer): void;
+    /** Drop all consumers. Does not clear `published`. */
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=in-memory-queue.d.ts.map

package/dist/testing/in-memory-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-queue.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B,KAAK,QAAQ,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5E;;;GAGG;AACH,qBAAa,aAAc,YAAW,YAAY;;IAChD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAM;IAEpC,kDAAkD;IAClD,WAAW,SAAK;IAEhB,qEAAqE;IACrE,MAAM,CAAC,MAAM,IAAI,aAAa;IAI9B,yEAAyE;IACnE,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAuChD,+EAA+E;IAC/E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAM5D,sDAAsD;IAChD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/testing/in-memory-queue.js

@@ -0,0 +1,66 @@
+/**
+ * In-process queue. `nack` (or a throw) redelivers with `attempt + 1` up to
+ * `maxAttempts` (default 3). `stop()` clears consumers.
+ */
+export class InMemoryQueue {
+    kind = 'queue';
+    /** Envelopes passed to `publish`, in order (one entry per publish, not per attempt). */
+    published = [];
+    #consumers = new Map();
+    /** Stop redelivering after this many attempts. */
+    maxAttempts = 3;
+    /** Empty queue. Pass to `.bind(catalog, InMemoryQueue.create())`. */
+    static create() {
+        return new InMemoryQueue();
+    }
+    /** Record the envelope and dispatch every consumer group for its key. */
+    async publish(envelope) {
+        this.published.push(envelope);
+        const groups = this.#consumers.get(envelope.key);
+        if (!groups)
+            return;
+        for (const consumer of groups.values()) {
+            await this.#deliver(envelope, consumer, 1);
+        }
+    }
+    async #deliver(envelope, consumer, attempt) {
+        let outcome = 'none';
+        let thrown;
+        const ctx = {
+            attempt,
+            ack: async () => {
+                outcome = 'ack';
+            },
+            nack: async () => {
+                outcome = 'nack';
+            },
+        };
+        try {
+            await consumer(envelope, ctx);
+        }
+        catch (error) {
+            thrown = error;
+            if (outcome === 'none')
+                outcome = 'nack';
+        }
+        if (outcome !== 'nack')
+            return;
+        if (attempt < this.maxAttempts) {
+            await this.#deliver(envelope, consumer, attempt + 1);
+            return;
+        }
+        if (thrown !== undefined)
+            throw thrown;
+    }
+    /** Register the consumer for `key`+`group`. Later calls replace that group. */
+    consume(key, group, handler) {
+        const groups = this.#consumers.get(key) ?? new Map();
+        groups.set(group, handler);
+        this.#consumers.set(key, groups);
+    }
+    /** Drop all consumers. Does not clear `published`. */
+    async stop() {
+        this.#consumers.clear();
+    }
+}
+//# sourceMappingURL=in-memory-queue.js.map

package/dist/testing/in-memory-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-queue.js","sourceRoot":"","sources":["../../src/testing/in-memory-queue.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,OAAgB,CAAC;IACjC,wFAAwF;IAC/E,SAAS,GAAe,EAAE,CAAC;IACpC,UAAU,GAAG,IAAI,GAAG,EAAiC,CAAC;IACtD,kDAAkD;IAClD,WAAW,GAAG,CAAC,CAAC;IAEhB,qEAAqE;IACrE,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,OAAO,CAAC,QAAkB;QAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,QAAkB,EAClB,QAAkB,EAClB,OAAe;QAEf,IAAI,OAAO,GAA4B,MAAM,CAAC;QAC9C,IAAI,MAAe,CAAC;QACpB,MAAM,GAAG,GAAoB;YAC3B,OAAO;YACP,GAAG,EAAE,KAAK,IAAI,EAAE;gBACd,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,OAAO,GAAG,MAAM,CAAC;YACnB,CAAC;SACF,CAAC;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,OAAO,KAAK,MAAM;gBAAE,OAAO,GAAG,MAAM,CAAC;QAC3C,CAAC;QACD,IAAI,OAAO,KAAK,MAAM;YAAE,OAAO;QAC/B,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QACD,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,MAAM,CAAC;IACzC,CAAC;IAED,+EAA+E;IAC/E,OAAO,CAAC,GAAW,EAAE,KAAa,EAAE,OAAiB;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAoB,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}