@ddd-ts-kit/testing 0.0.0-stage → 0.1.0

package/dist/builders/builder.js

@@ -0,0 +1,66 @@
+import { isResolvable } from './is-resolvable.js';
+import { RESOLVE } from './resolvable.js';
+/**
+ * Base class of hand-written test data builders.
+ *
+ * A subclass declares valid `defaults()` once, says in `construct()` how to create the object
+ * through its public API, and exposes methods named in the ubiquitous language that delegate
+ * to the protected `with`. Every such method returns a new builder: a builder is immutable,
+ * so one instance can be shared between tests without leaking state.
+ */
+export class Builder {
+    // The copy made by `withMany` carries this field: it relies on it being an own enumerable property.
+    overrides = {};
+    build() {
+        return this.construct(this.props());
+    }
+    /** Builds `count` objects, each with its own lazy and sequence values. */
+    buildMany(count, customize = (b) => b) {
+        return Array.from({ length: count }, (_, index) => customize(this, index).build());
+    }
+    [RESOLVE]() {
+        return this.build();
+    }
+    /**
+     * What `build()` hands to `construct`: the defaults, then the values set, all resolved. A
+     * subclass uses it to offer another output of the same vocabulary, such as the request
+     * payload of an API (`buildRequest()`). Each call draws its own lazy and sequence values.
+     */
+    props() {
+        const values = { ...this.defaults(), ...this.overrides };
+        const props = Object.fromEntries(Reflect.ownKeys(values).map((key) => [key, resolveValue(values[key])]));
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- every key of Props was resolved to its value type above, which the compiler cannot follow through Object.fromEntries
+        return props;
+    }
+    /** Adds items to an array property, after the ones already set or declared by default. */
+    adding(key, ...items) {
+        const current = key in this.overrides ? this.overrides[key] : this.defaults()[key];
+        if (!isList(current)) {
+            throw new TypeError(`adding("${String(key)}") needs the current value to be a list, not a lazy value or a builder`);
+        }
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- the element type was checked on `items`; the conditional type cannot be derived again from the list
+        return this.with(key, [...current, ...items]);
+    }
+    with(key, value) {
+        const values = {};
+        values[key] = value;
+        return this.withMany(values);
+    }
+    withMany(values) {
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- Object.create is untyped; the copy has the prototype of `this`, so it is a `this`
+        const copy = Object.create(Reflect.getPrototypeOf(this));
+        return Object.assign(copy, this, { overrides: { ...this.overrides, ...values } });
+    }
+}
+// Arrays are walked so builders can sit in a list; plain objects are left alone because a
+// domain object must never be rewritten by the builder that carries it.
+function resolveValue(value) {
+    if (isResolvable(value)) {
+        return resolveValue(value[RESOLVE]());
+    }
+    return Array.isArray(value) ? value.map(resolveValue) : value;
+}
+function isList(value) {
+    return Array.isArray(value);
+}
+//# sourceMappingURL=builder.js.map

package/dist/builders/builder.js.map

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

package/dist/builders/defaults.d.ts

@@ -0,0 +1,6 @@
+import type { Buildable } from './buildable.js';
+/** The defaults of a builder: every required property has one, declared once. */
+export type Defaults<Props> = {
+    readonly [K in keyof Props]: Buildable<Props[K]>;
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/builders/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/builders/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,iFAAiF;AACjF,MAAM,MAAM,QAAQ,CAAC,KAAK,IAAI;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}

package/dist/builders/defaults.js

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

package/dist/builders/defaults.js.map

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

package/dist/builders/define-builder.d.ts

@@ -0,0 +1,14 @@
+import type { Defaults } from './defaults.js';
+import { GenericBuilder } from './generic-builder.js';
+/**
+ * Functional form, for plain data (DTOs, payloads, value objects) that does not deserve a
+ * class: `const aLine = defineBuilder<LineProps>({ defaults: {...} })`, then `aLine().with(...)`.
+ */
+export declare function defineBuilder<Props extends object>(definition: {
+    readonly defaults: Defaults<Props> | (() => Defaults<Props>);
+}): () => GenericBuilder<Props, Props>;
+export declare function defineBuilder<Props extends object, Output>(definition: {
+    readonly defaults: Defaults<Props> | (() => Defaults<Props>);
+    readonly build: (props: Props) => Output;
+}): () => GenericBuilder<Props, Output>;
+//# sourceMappingURL=define-builder.d.ts.map

package/dist/builders/define-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-builder.d.ts","sourceRoot":"","sources":["../../src/builders/define-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,UAAU,EAAE;IAC9D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;CAC9D,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACvC,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE;IACtE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;CAC1C,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC"}

package/dist/builders/define-builder.js

@@ -0,0 +1,10 @@
+import { GenericBuilder } from './generic-builder.js';
+export function defineBuilder(definition) {
+    const builder = new GenericBuilder({
+        defaults: definition.defaults,
+        build: definition.build ?? ((props) => props),
+    });
+    // Immutable, so every call can hand out the same instance.
+    return () => builder;
+}
+//# sourceMappingURL=define-builder.js.map

package/dist/builders/define-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-builder.js","sourceRoot":"","sources":["../../src/builders/define-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AActD,MAAM,UAAU,aAAa,CAAuB,UAGnD;IACC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAiB;QACjD,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;KAC9C,CAAC,CAAC;IAEH,2DAA2D;IAC3D,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;AACvB,CAAC"}

package/dist/builders/generic-builder.d.ts

@@ -0,0 +1,16 @@
+import type { Buildable } from './buildable.js';
+import { Builder } from './builder.js';
+import type { Defaults } from './defaults.js';
+/** The builder `defineBuilder` gives: the generic `with` and `withMany`, made public. */
+export declare class GenericBuilder<Props extends object, Output> extends Builder<Props, Output> {
+    private readonly definition;
+    constructor(definition: {
+        readonly defaults: Defaults<Props> | (() => Defaults<Props>);
+        readonly build: (props: Props) => Output;
+    });
+    with<K extends keyof Props>(key: K, value: Buildable<Props[K]>): this;
+    withMany(values: Partial<Defaults<Props>>): this;
+    protected defaults(): Defaults<Props>;
+    protected construct(props: Props): Output;
+}
+//# sourceMappingURL=generic-builder.d.ts.map

package/dist/builders/generic-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-builder.d.ts","sourceRoot":"","sources":["../../src/builders/generic-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,yFAAyF;AACzF,qBAAa,cAAc,CAAC,KAAK,SAAS,MAAM,EAAE,MAAM,CAAE,SAAQ,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;IAEpF,OAAO,CAAC,QAAQ,CAAC,UAAU;IAD7B,YACmB,UAAU,EAAE;QAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;KAC1C,EAGF;IAEQ,IAAI,CAAC,CAAC,SAAS,MAAM,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAE7E;IAEQ,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAExD;IAED,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,CAIpC;IAED,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAExC;CACF"}

package/dist/builders/generic-builder.js

@@ -0,0 +1,23 @@
+import { Builder } from './builder.js';
+/** The builder `defineBuilder` gives: the generic `with` and `withMany`, made public. */
+export class GenericBuilder extends Builder {
+    definition;
+    constructor(definition) {
+        super();
+        this.definition = definition;
+    }
+    with(key, value) {
+        return super.with(key, value);
+    }
+    withMany(values) {
+        return super.withMany(values);
+    }
+    defaults() {
+        const { defaults } = this.definition;
+        return typeof defaults === 'function' ? defaults() : defaults;
+    }
+    construct(props) {
+        return this.definition.build(props);
+    }
+}
+//# sourceMappingURL=generic-builder.js.map

package/dist/builders/generic-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-builder.js","sourceRoot":"","sources":["../../src/builders/generic-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,yFAAyF;AACzF,MAAM,OAAO,cAA6C,SAAQ,OAAsB;IAEnE,UAAU;IAD7B,YACmB,UAGhB;QAED,KAAK,EAAE,CAAC;0BALS,UAAU;IAM7B,CAAC;IAEQ,IAAI,CAAwB,GAAM,EAAE,KAA0B;QACrE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAEQ,QAAQ,CAAC,MAAgC;QAChD,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAES,QAAQ;QAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAErC,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChE,CAAC;IAES,SAAS,CAAC,KAAY;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/builders/is-resolvable.d.ts

@@ -0,0 +1,3 @@
+import { type Resolvable } from './resolvable.js';
+export declare function isResolvable(value: unknown): value is Resolvable<unknown>;
+//# sourceMappingURL=is-resolvable.d.ts.map

package/dist/builders/is-resolvable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-resolvable.d.ts","sourceRoot":"","sources":["../../src/builders/is-resolvable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,CAEzE"}

package/dist/builders/is-resolvable.js

@@ -0,0 +1,5 @@
+import { RESOLVE } from './resolvable.js';
+export function isResolvable(value) {
+    return typeof value === 'object' && value !== null && RESOLVE in value;
+}
+//# sourceMappingURL=is-resolvable.js.map

package/dist/builders/is-resolvable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-resolvable.js","sourceRoot":"","sources":["../../src/builders/is-resolvable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAE3D,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC;AACzE,CAAC"}

package/dist/builders/lazy.d.ts

@@ -0,0 +1,4 @@
+import { type Resolvable } from './resolvable.js';
+/** A default computed at each `build()`, for values that must not be shared between tests. */
+export declare function lazy<T>(produce: () => T): Resolvable<T>;
+//# sourceMappingURL=lazy.d.ts.map

package/dist/builders/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/builders/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE3D,8FAA8F;AAC9F,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAEvD"}

package/dist/builders/lazy.js

@@ -0,0 +1,15 @@
+import { RESOLVE } from './resolvable.js';
+/** A default computed at each `build()`, for values that must not be shared between tests. */
+export function lazy(produce) {
+    return new Lazy(produce);
+}
+class Lazy {
+    produce;
+    constructor(produce) {
+        this.produce = produce;
+    }
+    [RESOLVE]() {
+        return this.produce();
+    }
+}
+//# sourceMappingURL=lazy.js.map

package/dist/builders/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../src/builders/lazy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAE3D,8FAA8F;AAC9F,MAAM,UAAU,IAAI,CAAI,OAAgB;IACtC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,IAAI;IACqB,OAAO;IAApC,YAA6B,OAAgB;uBAAhB,OAAO;IAAY,CAAC;IAEjD,CAAC,OAAO,CAAC;QACP,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/builders/resolvable.d.ts

@@ -0,0 +1,6 @@
+export declare const RESOLVE: unique symbol;
+/** Something that yields a value at build time: a nested builder, `lazy`, `sequence`. */
+export interface Resolvable<T> {
+    [RESOLVE](): T;
+}
+//# sourceMappingURL=resolvable.d.ts.map

package/dist/builders/resolvable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvable.d.ts","sourceRoot":"","sources":["../../src/builders/resolvable.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,eAAuC,CAAC;AAE5D,yFAAyF;AACzF,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;CAChB"}

package/dist/builders/resolvable.js

@@ -0,0 +1,2 @@
+export const RESOLVE = Symbol('ddd-ts-kit.testing.resolve');
+//# sourceMappingURL=resolvable.js.map

package/dist/builders/resolvable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvable.js","sourceRoot":"","sources":["../../src/builders/resolvable.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/builders/resolve.d.ts

@@ -0,0 +1,4 @@
+import { type Resolvable } from './resolvable.js';
+/** Builds the value when given a builder, returns it untouched otherwise. */
+export declare function resolve<T>(value: T | Resolvable<T>): T;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/builders/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/builders/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE3D,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAEtD"}

package/dist/builders/resolve.js

@@ -0,0 +1,7 @@
+import { isResolvable } from './is-resolvable.js';
+import { RESOLVE } from './resolvable.js';
+/** Builds the value when given a builder, returns it untouched otherwise. */
+export function resolve(value) {
+    return isResolvable(value) ? value[RESOLVE]() : value;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/builders/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/builders/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAE3D,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAI,KAAwB;IACjD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACxD,CAAC"}

package/dist/builders/sequence.d.ts

@@ -0,0 +1,10 @@
+import type { Resolvable } from './resolvable.js';
+/**
+ * A default drawn from a named, deterministic sequence: `sequence('order')` gives `order-1`,
+ * `order-2`... The counter is shared by every builder using the same name.
+ */
+export declare function sequence(name: string): Resolvable<string>;
+export declare function sequence<T>(name: string, format: (n: number) => T): Resolvable<T>;
+/** Restarts every sequence at 1. Call it in `beforeEach` so tests do not depend on their order. */
+export declare function resetSequences(): void;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/builders/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../src/builders/sequence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAC3D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAYnF,mGAAmG;AACnG,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/builders/sequence.js

@@ -0,0 +1,14 @@
+import { lazy } from './lazy.js';
+const counters = new Map();
+export function sequence(name, format = (n) => `${name}-${n}`) {
+    return lazy(() => {
+        const next = (counters.get(name) ?? 0) + 1;
+        counters.set(name, next);
+        return format(next);
+    });
+}
+/** Restarts every sequence at 1. Call it in `beforeEach` so tests do not depend on their order. */
+export function resetSequences() {
+    counters.clear();
+}
+//# sourceMappingURL=sequence.js.map

package/dist/builders/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../src/builders/sequence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAS3C,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAM,GAA2B,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE;IAC3F,OAAO,IAAI,CAAC,GAAG,EAAE;QACf,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAE3C,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEzB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,cAAc;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/contracts/awaitable.d.ts

@@ -0,0 +1,2 @@
+export type Awaitable<T> = T | Promise<T>;
+//# sourceMappingURL=awaitable.d.ts.map

package/dist/contracts/awaitable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awaitable.d.ts","sourceRoot":"","sources":["../../src/contracts/awaitable.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/contracts/awaitable.js

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

package/dist/contracts/awaitable.js.map

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

package/dist/contracts/cache-contract.d.ts

@@ -0,0 +1,13 @@
+import { type Cache } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface CacheContractOptions {
+    readonly name: string;
+    /** A fresh, empty cache; called before each test. */
+    createCache(): Awaitable<Cache>;
+    /** Makes the time of the cache pass: advances its clock, or really waits. */
+    elapse(ms: number): Awaitable<void>;
+}
+/** What every adapter of the kernel `Cache` port guarantees, the in-memory one included. */
+export declare function cacheContract(runner: ContractRunner, options: CacheContractOptions): void;
+//# sourceMappingURL=cache-contract.d.ts.map

package/dist/contracts/cache-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/cache-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,KAAK,EAAiB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAEzF"}

package/dist/contracts/cache-contract.js

@@ -0,0 +1,81 @@
+import { cacheKey } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from './contract-suite.js';
+/** What every adapter of the kernel `Cache` port guarantees, the in-memory one included. */
+export function cacheContract(runner, options) {
+    new CacheSuite(runner, options).describe(`${options.name} (cache contract)`);
+}
+class CacheSuite extends ContractSuite {
+    options;
+    constructor(runner, options) {
+        super(runner, () => options.createCache());
+        this.options = options;
+    }
+    tests() {
+        this.readsWhatWasWritten();
+        this.forgets();
+        this.expires();
+    }
+    readsWhatWasWritten() {
+        this.it('answers undefined for an entry nobody wrote', async () => {
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toBe(undefined);
+        });
+        this.it('gives back the value that was written, whatever its shape', async () => {
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD);
+            await this.subject.set(cacheKey('count'), 0);
+            await this.subject.set(cacheKey('label'), '');
+            await this.subject.set(cacheKey('flag'), false);
+            await this.subject.set(cacheKey('list'), [3, 1, 2]);
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toEqual(EUR_USD);
+            this.expect(await this.subject.get(cacheKey('count'))).toBe(0);
+            this.expect(await this.subject.get(cacheKey('label'))).toBe('');
+            this.expect(await this.subject.get(cacheKey('flag'))).toBe(false);
+            this.expect(await this.subject.get(cacheKey('list'))).toEqual([3, 1, 2]);
+        });
+        this.it('keeps entries apart, and the last write of one', async () => {
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD);
+            await this.subject.set(quoteOf('EUR/GBP'), { ...EUR_USD, pair: 'EUR/GBP' });
+            await this.subject.set(quoteOf('EUR/USD'), { ...EUR_USD, rate: 1.09 });
+            this.expect((await this.subject.get(quoteOf('EUR/USD')))?.rate).toBe(1.09);
+            this.expect((await this.subject.get(quoteOf('EUR/GBP')))?.pair).toBe('EUR/GBP');
+        });
+    }
+    forgets() {
+        this.it('forgets a deleted entry, and only that one', async () => {
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD);
+            await this.subject.set(quoteOf('EUR/GBP'), EUR_USD);
+            await this.subject.delete(quoteOf('EUR/USD'));
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toBe(undefined);
+            this.expect(await this.subject.get(quoteOf('EUR/GBP'))).toEqual(EUR_USD);
+        });
+        this.it('accepts the deletion of an entry that does not exist', async () => {
+            await this.subject.delete(quoteOf('EUR/USD'));
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toBe(undefined);
+        });
+    }
+    expires() {
+        this.it('keeps an entry until its time to live has passed, then answers undefined', async () => {
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD, { ttlMs: 400 });
+            await this.subject.set(quoteOf('EUR/GBP'), EUR_USD);
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toEqual(EUR_USD);
+            await this.options.elapse(500);
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toBe(undefined);
+            this.expect(await this.subject.get(quoteOf('EUR/GBP'))).toEqual(EUR_USD);
+        });
+        this.it('gives an entry written again the time to live of its last write', async () => {
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD, { ttlMs: 100 });
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD);
+            await this.options.elapse(200);
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toEqual(EUR_USD);
+        });
+        this.it('does not keep an entry whose time to live is zero', async () => {
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD);
+            await this.subject.set(quoteOf('EUR/USD'), EUR_USD, { ttlMs: 0 });
+            this.expect(await this.subject.get(quoteOf('EUR/USD'))).toBe(undefined);
+        });
+    }
+}
+const EUR_USD = { pair: 'EUR/USD', rate: 1.0842, sources: ['ecb', 'desk'] };
+function quoteOf(pair) {
+    return cacheKey('quote', pair);
+}
+//# sourceMappingURL=cache-contract.js.map

package/dist/contracts/cache-contract.js.map

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

package/dist/contracts/contract-runner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The part of a test runner the suites use, passed in so that this module imports no runner.
+ * The globals of vitest and jest both fit: `{ describe, it, expect, beforeEach }`.
+ */
+export interface ContractRunner {
+    describe(name: string, suite: () => void): unknown;
+    it(name: string, test: () => Promise<void>): unknown;
+    beforeEach(setup: () => Promise<void>): unknown;
+    /** Optional: when given, subjects exposing `close()` are closed after each test. */
+    afterEach?(teardown: () => Promise<void>): unknown;
+    expect(actual: unknown): {
+        toBe(expected: unknown): unknown;
+        toEqual(expected: unknown): unknown;
+    };
+}
+//# sourceMappingURL=contract-runner.d.ts.map

package/dist/contracts/contract-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-runner.d.ts","sourceRoot":"","sources":["../../src/contracts/contract-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACnD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACrD,UAAU,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAChD,oFAAoF;IACpF,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACnD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG;QAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAC;CACpG"}

package/dist/contracts/contract-runner.js

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

package/dist/contracts/contract-runner.js.map

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

package/dist/contracts/contract-suite.d.ts

@@ -0,0 +1,23 @@
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+type Expectation = ReturnType<ContractRunner['expect']>;
+/**
+ * The base of a contract suite: tests about one subject, created anew before each test. A
+ * package holding a port extends it to publish the contract of that port. The runner is
+ * always called as an object, never through functions taken off it, so a runner that relies
+ * on `this` works too.
+ */
+export declare abstract class ContractSuite<Subject> {
+    private readonly runner;
+    private readonly createSubject;
+    private subjectOfTheTest;
+    constructor(runner: ContractRunner, createSubject: () => Awaitable<Subject>);
+    describe(name: string): void;
+    protected abstract tests(): void;
+    protected it(name: string, test: () => Promise<void>): void;
+    protected expect(actual: unknown): Expectation;
+    protected afterEach(teardown: () => Promise<void>): void;
+    protected get subject(): Subject;
+}
+export {};
+//# sourceMappingURL=contract-suite.d.ts.map

package/dist/contracts/contract-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-suite.d.ts","sourceRoot":"","sources":["../../src/contracts/contract-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,KAAK,WAAW,GAAG,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAExD;;;;;GAKG;AACH,8BAAsB,aAAa,CAAC,OAAO;IAIvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,YACmB,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,SAAS,CAAC,OAAO,CAAC,EACtD;IAEJ,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ3B;IAED,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC;IAEjC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE1D;IAED,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAE7C;IAED,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEvD;IAED,SAAS,KAAK,OAAO,IAAI,OAAO,CAM/B;CACF"}

package/dist/contracts/contract-suite.js

@@ -0,0 +1,39 @@
+/**
+ * The base of a contract suite: tests about one subject, created anew before each test. A
+ * package holding a port extends it to publish the contract of that port. The runner is
+ * always called as an object, never through functions taken off it, so a runner that relies
+ * on `this` works too.
+ */
+export class ContractSuite {
+    runner;
+    createSubject;
+    subjectOfTheTest;
+    constructor(runner, createSubject) {
+        this.runner = runner;
+        this.createSubject = createSubject;
+    }
+    describe(name) {
+        this.runner.describe(name, () => {
+            this.runner.beforeEach(async () => {
+                this.subjectOfTheTest = await this.createSubject();
+            });
+            this.tests();
+        });
+    }
+    it(name, test) {
+        this.runner.it(name, test);
+    }
+    expect(actual) {
+        return this.runner.expect(actual);
+    }
+    afterEach(teardown) {
+        this.runner.afterEach?.(teardown);
+    }
+    get subject() {
+        if (this.subjectOfTheTest === undefined) {
+            throw new Error('The subject of a contract suite only exists while a test runs');
+        }
+        return this.subjectOfTheTest;
+    }
+}
+//# sourceMappingURL=contract-suite.js.map

package/dist/contracts/contract-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-suite.js","sourceRoot":"","sources":["../../src/contracts/contract-suite.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,OAAgB,aAAa;IAId,MAAM;IACN,aAAa;IAJxB,gBAAgB,CAAsB;IAE9C,YACmB,MAAsB,EACtB,aAAuC;sBADvC,MAAM;6BACN,aAAa;IAC7B,CAAC;IAEJ,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;gBAChC,IAAI,CAAC,gBAAgB,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACrD,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAIS,EAAE,CAAC,IAAY,EAAE,IAAyB;QAClD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IAES,MAAM,CAAC,MAAe;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAES,SAAS,CAAC,QAA6B;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,IAAc,OAAO;QACnB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/contracts/criteria/criteria-case.d.ts

@@ -0,0 +1,11 @@
+import type { Criteria, ReadScope } from '@ddd-ts-kit/kernel';
+import type { CriteriaContractRow } from './criteria-contract-row.js';
+/** One line of the contract: a read, and the ids it answers, in order. */
+export interface CriteriaCase {
+    readonly name: string;
+    readonly read: (criteria: Criteria<CriteriaContractRow>) => Criteria<CriteriaContractRow>;
+    /** What the actor may read. Everything by default. */
+    readonly scope?: ReadScope;
+    readonly ids: readonly string[];
+}
+//# sourceMappingURL=criteria-case.d.ts.map

package/dist/contracts/criteria/criteria-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-case.d.ts","sourceRoot":"","sources":["../../../src/contracts/criteria/criteria-case.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,CAAC,KAAK,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAC1F,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC"}

package/dist/contracts/criteria/criteria-case.js

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

package/dist/contracts/criteria/criteria-case.js.map

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

package/dist/contracts/criteria/criteria-contract-definition.d.ts

@@ -0,0 +1,5 @@
+import { type CriteriaDefinition } from '@ddd-ts-kit/kernel';
+import type { CriteriaContractRow } from './criteria-contract-row.js';
+/** What the read port of the contract accepts: every operator of every type, groups two deep. */
+export declare const criteriaContractDefinition: CriteriaDefinition<CriteriaContractRow>;
+//# sourceMappingURL=criteria-contract-definition.d.ts.map

package/dist/contracts/criteria/criteria-contract-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-contract-definition.d.ts","sourceRoot":"","sources":["../../../src/contracts/criteria/criteria-contract-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,EAAE,kBAAkB,CAAC,mBAAmB,CAgB7E,CAAC"}

package/dist/contracts/criteria/criteria-contract-definition.js

@@ -0,0 +1,20 @@
+import { defineCriteria } from '@ddd-ts-kit/kernel';
+/** What the read port of the contract accepts: every operator of every type, groups two deep. */
+export const criteriaContractDefinition = defineCriteria({
+    fields: {
+        id: { type: 'string', filter: ['eq', 'in'] },
+        status: { type: 'string', filter: ['eq', 'ne', 'in'], sortable: true },
+        title: { type: 'string', filter: ['eq', 'ne', 'in', 'contains', 'startsWith'] },
+        seats: { type: 'number', filter: ['eq', 'ne', 'in', 'gt', 'gte', 'lt', 'lte', 'between'], sortable: true },
+        price: { type: 'decimal', filter: ['eq', 'ne', 'in', 'gt', 'gte', 'lt', 'lte', 'between'], sortable: true },
+        startsAt: { type: 'instant', filter: ['eq', 'in', 'gt', 'gte', 'lt', 'lte', 'between'], sortable: true },
+        cancelledAt: { type: 'instant', filter: ['isNull', 'gte', 'lt'], sortable: true, nullable: true },
+        room: { type: 'string', filter: ['eq', 'ne', 'in', 'isNull', 'gt'], sortable: true, nullable: true },
+        remote: { type: 'boolean', filter: ['eq', 'ne'], sortable: true },
+        tenantId: { type: 'string', filter: ['eq'] },
+    },
+    defaultSort: [{ field: 'startsAt', direction: 'asc' }],
+    tieBreaker: 'id',
+    limits: { maxDepth: 2 },
+});
+//# sourceMappingURL=criteria-contract-definition.js.map

package/dist/contracts/criteria/criteria-contract-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-contract-definition.js","sourceRoot":"","sources":["../../../src/contracts/criteria/criteria-contract-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2B,MAAM,oBAAoB,CAAC;AAG7E,iGAAiG;AACjG,MAAM,CAAC,MAAM,0BAA0B,GAA4C,cAAc,CAAsB;IACrH,MAAM,EAAE;QACN,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE;QAC/E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1G,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3G,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxG,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QACjG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACjE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;KAC7C;IACD,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACtD,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;CACxB,CAAC,CAAC"}