@c9up/ream 0.1.3

package/dist/events/helix/helpers.js

@@ -0,0 +1,187 @@
+/**
+ * Helix bus testing helpers — collect, fake, assertEmitted, assertNotEmitted,
+ * waitForEvent, waitForChain.
+ *
+ * Public testing API for asserting on events emitted through EventBus.
+ *
+ * @implements FR64, FR65, FR66, FR67, FR68 (Story 11.1)
+ */
+/**
+ * Collect events matching a pattern into an array.
+ *
+ *     const { events } = collect(bus, 'order.created')
+ *     bus.emit('order.created', '{"id":"1"}')
+ *     // events[0].name === 'order.created'
+ */
+export function collect(bus, pattern) {
+    const events = [];
+    const subId = bus.subscribe(pattern, (eventJson) => {
+        try {
+            events.push(JSON.parse(eventJson));
+        }
+        catch {
+            events.push({
+                _raw: eventJson,
+                _parseError: true,
+                name: '',
+                data: undefined,
+            });
+        }
+    });
+    return { events, subId };
+}
+/**
+ * Fake (intercept) events matching a pattern.
+ *
+ * Currently captures events like collect() — true interception that suppresses
+ * other subscribers requires bus-level support and is not yet implemented.
+ */
+export function fake(bus, pattern) {
+    return collect(bus, pattern);
+}
+/**
+ * Assert that an event was emitted, optionally matching a partial payload.
+ */
+export function assertEmitted(events, name, payload) {
+    const matching = events.filter((e) => e.name === name);
+    if (matching.length === 0) {
+        const emittedNames = [...new Set(events.map((e) => e.name))].join(', ');
+        throw new Error(`[HELIX_ASSERT_EMITTED] Expected event '${name}' to be emitted, but it was not.\n` +
+            `  Emitted events: ${emittedNames || '(none)'}`);
+    }
+    if (payload !== undefined && payload !== null) {
+        const payloadMatch = matching.find((e) => {
+            const data = typeof e.data === 'string' ? safeJson(e.data) : e.data;
+            return partialMatch(data, payload);
+        });
+        if (!payloadMatch) {
+            const actualPayloads = matching
+                .map((e) => {
+                const data = typeof e.data === 'string' ? safeJson(e.data) : e.data;
+                return JSON.stringify(data);
+            })
+                .join('\n    ');
+            throw new Error(`[HELIX_ASSERT_EMITTED] Event '${name}' was emitted but no payload matched.\n` +
+                `  Expected (partial): ${JSON.stringify(payload)}\n` +
+                `  Actual payloads:\n    ${actualPayloads}`);
+        }
+    }
+}
+/** Assert that an event was NOT emitted. */
+export function assertNotEmitted(events, name) {
+    const matching = events.filter((e) => e.name === name);
+    if (matching.length > 0) {
+        throw new Error(`[HELIX_ASSERT_NOT_EMITTED] Expected event '${name}' to NOT be emitted, but it was emitted ${matching.length} time(s).`);
+    }
+}
+/** Wait for a specific event to appear in the collected events, with timeout. */
+export function waitForEvent(events, name, options = {}) {
+    const timeout = options.timeout ?? 5000;
+    const interval = options.interval ?? 10;
+    const payload = options.payload;
+    return new Promise((resolve, reject) => {
+        const start = Date.now();
+        let settled = false;
+        const check = () => {
+            if (settled)
+                return;
+            const match = events.find((e) => {
+                if (e.name !== name)
+                    return false;
+                if (payload === undefined)
+                    return true;
+                const data = typeof e.data === 'string' ? safeJson(e.data) : e.data;
+                return partialMatch(data, payload);
+            });
+            if (match) {
+                settled = true;
+                resolve(match);
+                return;
+            }
+            if (Date.now() - start >= timeout) {
+                settled = true;
+                const received = events.map((e) => e.name).join(', ');
+                reject(new Error(`[HELIX_TIMEOUT] Timed out waiting for event '${name}' after ${timeout}ms.\n` +
+                    `  Events received so far: ${received || '(none)'}`));
+                return;
+            }
+            setTimeout(check, interval);
+        };
+        check();
+    });
+}
+/**
+ * Wait for an entire event chain to complete (tracked via correlationId).
+ *
+ * @implements FR68
+ */
+export function waitForChain(events, correlationId, expectedNames, options = {}) {
+    if (!expectedNames || expectedNames.length === 0) {
+        return Promise.reject(new Error('[HELIX_CHAIN] expectedNames must be a non-empty array'));
+    }
+    const timeout = options.timeout ?? 5000;
+    const interval = options.interval ?? 10;
+    return new Promise((resolve, reject) => {
+        const start = Date.now();
+        let settled = false;
+        const check = () => {
+            if (settled)
+                return;
+            const chainEvents = events.filter((e) => e.correlationId === correlationId);
+            const chainNames = chainEvents.map((e) => e.name);
+            const allPresent = expectedNames.every((name) => chainNames.includes(name));
+            if (allPresent) {
+                settled = true;
+                resolve(chainEvents);
+                return;
+            }
+            if (Date.now() - start >= timeout) {
+                settled = true;
+                const completed = expectedNames.filter((n) => chainNames.includes(n));
+                const pending = expectedNames.filter((n) => !chainNames.includes(n));
+                reject(new Error(`[HELIX_CHAIN_TIMEOUT] Event chain timed out after ${timeout}ms.\n` +
+                    `  Correlation ID: ${correlationId}\n` +
+                    `  Completed: ${completed.join(', ') || '(none)'}\n` +
+                    `  Pending: ${pending.join(', ')}`));
+                return;
+            }
+            setTimeout(check, interval);
+        };
+        check();
+    });
+}
+/**
+ * Check if `actual` contains all key-value pairs from `expected` (deep partial match).
+ * Arrays are matched element-by-element.
+ */
+function partialMatch(actual, expected) {
+    if (actual === expected)
+        return true;
+    if (expected === null || expected === undefined)
+        return actual === expected;
+    if (typeof expected !== 'object')
+        return actual === expected;
+    if (typeof actual !== 'object' || actual === null)
+        return false;
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual))
+            return false;
+        return expected.every((item, i) => i < actual.length && partialMatch(actual[i], item));
+    }
+    for (const key of Object.keys(expected)) {
+        if (!(key in actual))
+            return false;
+        if (!partialMatch(actual[key], expected[key]))
+            return false;
+    }
+    return true;
+}
+function safeJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/events/helix/helpers.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@c9up/ream/events` — the event bus, part of ream core. A basic
+ * in-process emitter works with zero external
+ * infrastructure; the Redis store is an opt-in `redis-store` build feature.
+ *
+ * App-facing surface: `Emitter` (string + class events, wildcard, request/
+ * reply), `BaseEvent` (typed event classes), and `EventsProvider` (wires the
+ * `events`/`emitter` container tokens). The Rust-backed `EventBus` is the
+ * low-level native binding, exposed for advanced use.
+ */
+export type { EventsConfig } from './config.js';
+export { defineConfig } from './config.js';
+export { BaseEvent, type ContainerResolver, Emitter, type ListenerClass, } from './Emitter.js';
+export type { EventsAppContext } from './EventsProvider.js';
+export { default as EventsProvider } from './EventsProvider.js';
+export { EventBus } from './native.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,SAAS,EACT,KAAK,iBAAiB,EACtB,OAAO,EACP,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA"}

package/dist/events/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@c9up/ream/events` — the event bus, part of ream core. A basic
+ * in-process emitter works with zero external
+ * infrastructure; the Redis store is an opt-in `redis-store` build feature.
+ *
+ * App-facing surface: `Emitter` (string + class events, wildcard, request/
+ * reply), `BaseEvent` (typed event classes), and `EventsProvider` (wires the
+ * `events`/`emitter` container tokens). The Rust-backed `EventBus` is the
+ * low-level native binding, exposed for advanced use.
+ */
+export { defineConfig } from './config.js';
+export { BaseEvent, Emitter, } from './Emitter.js';
+export { default as EventsProvider } from './EventsProvider.js';
+export { EventBus } from './native.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,SAAS,EAET,OAAO,GAER,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA"}

package/dist/events/native.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Native event-bus loader. Resolves the Rust-backed `events.<platform>.node`
+ * binary (built from the `ream-events-napi` crate) via the shared
+ * `loadNapi` helper and re-exports the `EventBus` class it provides.
+ *
+ * The bus is part of ream core: a basic in-process
+ * emitter works with zero external infrastructure; the Redis store is an
+ * opt-in `redis-store` cargo feature for durable/distributed production use.
+ */
+/** Rust-backed bus surface (mirrors the napi `#[napi] EventBus` exports). */
+export interface EventBus {
+    emit(name: string, data: string): Promise<string>;
+    subscribe(pattern: string, callback: (eventJson: string) => void): number;
+    unsubscribe(subscriptionId: number): Promise<void>;
+    onRequest(name: string, callback: (eventJson: string, reply: (response: string) => void) => void): void;
+    request(name: string, data: string, timeoutMs?: number): Promise<string>;
+    matchesWildcard(pattern: string, eventName: string): boolean;
+    subscriptionCount(): Promise<number>;
+}
+export declare const EventBus: new (requestHandlerTimeoutMs?: number) => EventBus;
+//# sourceMappingURL=native.d.ts.map

package/dist/events/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/events/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAA;IACzE,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,GACvE,IAAI,CAAA;IACP,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;IAC5D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACrC;AAYD,eAAO,MAAM,QAAQ,iCATsB,MAAM,KAAK,QASf,CAAA"}

package/dist/events/native.js

@@ -0,0 +1,17 @@
+/**
+ * Native event-bus loader. Resolves the Rust-backed `events.<platform>.node`
+ * binary (built from the `ream-events-napi` crate) via the shared
+ * `loadNapi` helper and re-exports the `EventBus` class it provides.
+ *
+ * The bus is part of ream core: a basic in-process
+ * emitter works with zero external infrastructure; the Redis store is an
+ * opt-in `redis-store` cargo feature for durable/distributed production use.
+ */
+import { loadNapi } from '../helpers/napi-loader.js';
+const native = loadNapi({
+    binaryName: 'events',
+    callerMetaUrl: import.meta.url,
+    errorCodePrefix: 'EVENTS',
+});
+export const EventBus = native.EventBus;
+//# sourceMappingURL=native.js.map

package/dist/events/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/events/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAoBpD,MAAM,MAAM,GAAG,QAAQ,CAAe;IACpC,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;IAC9B,eAAe,EAAE,QAAQ;CAC1B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA"}

package/dist/events/services/main.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default `Emitter` singleton — mirror of Adonis's
+ * `import emitter from '@adonisjs/core/services/emitter'` shape.
+ *
+ *   import emitter from '@c9up/ream/events/services/main'
+ *
+ *   emitter.on(TaskAssigned, (e) => sendEmail(e.assigneeId))
+ *
+ * Populated by `EventsProvider.boot()`.
+ */
+import type { Emitter } from '../Emitter.js';
+/** @internal Bind the singleton (called by EventsProvider). */
+export declare function setEmitter(instance: Emitter): void;
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export declare function getEmitter(): Emitter | undefined;
+declare const emitter: Emitter;
+export default emitter;
+//# sourceMappingURL=main.d.ts.map

package/dist/events/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/events/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAI5C,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,IAAI,OAAO,GAAG,SAAS,CAEhD;AAED,QAAA,MAAM,OAAO,EAAE,OAWb,CAAA;AAEF,eAAe,OAAO,CAAA"}

package/dist/events/services/main.js

@@ -0,0 +1,31 @@
+/**
+ * Default `Emitter` singleton — mirror of Adonis's
+ * `import emitter from '@adonisjs/core/services/emitter'` shape.
+ *
+ *   import emitter from '@c9up/ream/events/services/main'
+ *
+ *   emitter.on(TaskAssigned, (e) => sendEmail(e.assigneeId))
+ *
+ * Populated by `EventsProvider.boot()`.
+ */
+let instance;
+/** @internal Bind the singleton (called by EventsProvider). */
+export function setEmitter(instance) {
+    instance = instance;
+}
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export function getEmitter() {
+    return instance;
+}
+const emitter = new Proxy({}, {
+    get(_target, prop) {
+        if (!instance) {
+            throw new Error('[ream:events] Emitter singleton accessed before EventsProvider.boot() ran. ' +
+                'Check that `@c9up/ream/events/provider` is listed in your reamrc.ts providers.');
+        }
+        const value = Reflect.get(instance, prop, instance);
+        return typeof value === 'function' ? value.bind(instance) : value;
+    },
+});
+export default emitter;
+//# sourceMappingURL=main.js.map

package/dist/events/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/events/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,IAAI,QAA6B,CAAA;AAEjC,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,QAAiB;IAC1C,QAAQ,GAAG,QAAQ,CAAA;AACrB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,OAAO,GAAY,IAAI,KAAK,CAAC,EAAa,EAAE;IAChD,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,6EAA6E;gBAC3E,gFAAgF,CACnF,CAAA;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QACnD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACnE,CAAC;CACF,CAAC,CAAA;AAEF,eAAe,OAAO,CAAA"}

package/dist/events/testing/FakeBus.d.ts

@@ -0,0 +1,66 @@
+/**
+ * In-memory `EventBus` substitute for tests — captures every
+ * `emit(name, data)` / `request(name, data)` call and exposes
+ * `assertEmitted` / `assertNotEmitted` helpers in the same shape as
+ * Rover's `FakeMail`, Bay's `FakeQueue`, Storage's `FakeStorage`,
+ * Nova's `FakeNova`, and Relay's `FakeRelay`.
+ *
+ * Mirrors the public `EventBus` surface (`emit`, `subscribe`,
+ * `unsubscribe`, `onRequest`, `request`, `matchesWildcard`,
+ * `subscriptionCount`) with pure-TS, NAPI-free semantics. Wildcard
+ * matching is ported from `crates/ream-events/src/router.rs` — the
+ * Rust router is authoritative; any divergence is a bug here.
+ *
+ * Reach via `@c9up/ream/events/testing` (NOT the main barrel).
+ */
+export interface CapturedEmit {
+    kind: 'emit';
+    name: string;
+    data: string;
+    parsedData?: unknown;
+    correlationId?: string;
+    causationId?: string;
+}
+export interface CapturedRequest {
+    kind: 'request';
+    name: string;
+    data: string;
+    parsedData?: unknown;
+}
+export interface FakeBusPredicate {
+    name?: string;
+    dataMatches?: (data: unknown) => boolean;
+    correlationId?: string;
+    causationId?: string;
+}
+export type FakeBusPredicateArg = FakeBusPredicate | ((event: CapturedEmit) => boolean);
+/** Request handler may return `void` (sync, fire-and-forget after `reply`)
+ *  or `PromiseLike<void>` (async — the bus awaits and routes any rejection
+ *  through `request()`'s reject path). */
+export type FakeBusRequestHandler = (eventJson: string, reply: (response: string) => void) => void | PromiseLike<void>;
+export declare class FakeBus {
+    #private;
+    emit(name: string, data: string): Promise<string>;
+    subscribe(pattern: string, callback: (eventJson: string) => void | PromiseLike<void>): number;
+    unsubscribe(subscriptionId: number): Promise<void>;
+    onRequest(name: string, callback: FakeBusRequestHandler): void;
+    request(name: string, data: string, timeoutMs?: number): Promise<string>;
+    matchesWildcard(pattern: string, eventName: string): boolean;
+    subscriptionCount(): Promise<number>;
+    /**
+     * Defensive clone of the captured emits. **Clone is lossy** for
+     * non-cloneable values: `structuredClone` is tried first, JSON
+     * round-trip is the fallback. BigInt, functions, and other
+     * non-stringifiable payloads collapse to `undefined` in the fallback
+     * path (with a `[FakeBus] non-cloneable capture` `console.warn`).
+     * Internal assertions (`assertEmitted` etc.) read the live capture,
+     * not the clone, so this caveat only affects external readers.
+     */
+    getEmitted(): CapturedEmit[];
+    /** See `getEmitted` — same lossy-clone caveat for non-cloneable values. */
+    getRequests(): CapturedRequest[];
+    reset(): void;
+    assertEmitted(name: string, predicate?: FakeBusPredicateArg): void;
+    assertNotEmitted(name: string, predicate?: FakeBusPredicateArg): void;
+}
+//# sourceMappingURL=FakeBus.d.ts.map

package/dist/events/testing/FakeBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeBus.d.ts","sourceRoot":"","sources":["../../../src/events/testing/FakeBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;IACxC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,CAAA;AAUvF;;0CAE0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAC9B,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;AAE7B,qBAAa,OAAO;;IAOlB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CjD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM;IAM7F,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAS9D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAiD9E,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAI5D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIpC;;;;;;;;OAQG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B,2EAA2E;IAC3E,WAAW,IAAI,eAAe,EAAE;IAIhC,KAAK,IAAI,IAAI;IAQb,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAQlE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,mBAAmB,GAAG,IAAI;CAOtE"}