@nimbus-cqrs/eventsourcingdb 2.5.0 → 3.0.0-beta.1

package/dist/lib/consumerRunner.js

@@ -0,0 +1,386 @@
+import { GenericException, getLogger, } from '@nimbus-cqrs/core';
+import { eventSourcingDBEventToNimbusEvent } from "./eventMapping.js";
+/** How long the stream has to go quiet before a burst is considered over. */
+const BURST_IDLE_MS = 2000;
+const toError = (error) => {
+    return error instanceof Error ? error : new Error(String(error));
+};
+const describeError = (error) => {
+    return {
+        name: error.name,
+        message: error.message,
+        ...(error.stack !== undefined ? { stack: error.stack } : {}),
+    };
+};
+const describeFailures = (failures) => {
+    return Object.fromEntries([...failures.entries()].map(([name, error]) => {
+        return [name, describeError(error)];
+    }));
+};
+const failureSummary = (failures) => {
+    return [...failures.entries()]
+        .map(([name, error]) => {
+        return `${name}: ${error.name}: ${error.message}`;
+    })
+        .join('; ');
+};
+/**
+ * Times contiguous runs of events and logs one summary per run, so a replay
+ * reports as a single line instead of one per event. A run ends once the
+ * stream has been quiet for {@link BURST_IDLE_MS}; the reported duration
+ * covers only the events themselves, never the idle wait.
+ */
+const createBurstTimer = (observer) => {
+    let burst = null;
+    let timer;
+    let inFlight = false;
+    const log = () => {
+        if (burst === null) {
+            return;
+        }
+        const durationMs = burst.finishedAt - burst.startedAt;
+        const durationSeconds = Math.floor((durationMs / 1000) * 1000) / 1000;
+        const { events, eventsHandled, firstEventId, lastEventId } = burst;
+        burst = null;
+        getLogger().debug({
+            category: 'Nimbus',
+            message: `Observer "${observer}" processed ${events} event(s) in ${durationSeconds}s`,
+            data: {
+                observer,
+                events,
+                eventsHandled,
+                durationMs,
+                eventsPerSecond: durationMs > 0
+                    ? Math.round((events / durationMs) * 1000)
+                    : events,
+                firstEventId,
+                lastEventId,
+            },
+        });
+    };
+    const schedule = () => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        const scheduled = setTimeout(() => {
+            timer = undefined;
+            // A single event slower than the idle window must not split its
+            // own burst in two.
+            if (inFlight) {
+                schedule();
+                return;
+            }
+            log();
+        }, BURST_IDLE_MS);
+        timer = scheduled;
+        // Never hold the process open just to emit a timing line.
+        scheduled.unref();
+    };
+    return {
+        start: (eventId) => {
+            inFlight = true;
+            const now = Date.now();
+            burst ??= {
+                startedAt: now,
+                finishedAt: now,
+                events: 0,
+                eventsHandled: 0,
+                firstEventId: eventId,
+                lastEventId: eventId,
+            };
+            burst.events += 1;
+            burst.lastEventId = eventId;
+        },
+        finish: (handled) => {
+            inFlight = false;
+            if (burst !== null) {
+                burst.finishedAt = Date.now();
+                if (handled) {
+                    burst.eventsHandled += 1;
+                }
+            }
+            schedule();
+        },
+    };
+};
+/**
+ * The lowest position of all consumers. Consumers ahead of it skip the
+ * replayed events in memory.
+ */
+const lowerBoundFor = (states) => {
+    let lowest = null;
+    for (const state of states) {
+        if (state.position === null) {
+            return { id: '0', type: 'inclusive' };
+        }
+        if (lowest === null || state.position < lowest) {
+            lowest = state.position;
+        }
+    }
+    return lowest === null
+        ? { id: '0', type: 'inclusive' }
+        : { id: lowest.toString(), type: 'exclusive' };
+};
+const startsFromHead = (consumer) => {
+    return consumer.startFrom === 'head';
+};
+/**
+ * Every consumer name has to be unique and every dependency has to name a
+ * consumer declared earlier on the same observer. A consumer that resumes
+ * from its checkpoint must not depend on one that starts from the head,
+ * because that dependency never built state for older events.
+ */
+const validateConsumers = (observer, consumers) => {
+    const declared = new Map();
+    for (const consumer of consumers) {
+        if (declared.has(consumer.name)) {
+            throw new GenericException(`Observer "${observer}" declares consumer "${consumer.name}" more than once`, { observer, consumer: consumer.name });
+        }
+        for (const dependency of consumer.dependsOn ?? []) {
+            const declaredDependency = declared.get(dependency);
+            if (declaredDependency === undefined) {
+                throw new GenericException(`Consumer "${consumer.name}" of observer "${observer}" depends on "${dependency}", which is not declared before it`, { observer, consumer: consumer.name, dependency });
+            }
+            if (!startsFromHead(consumer) &&
+                startsFromHead(declaredDependency)) {
+                throw new GenericException(`Consumer "${consumer.name}" of observer "${observer}" resumes from its checkpoint but depends on "${dependency}", which starts from the head and skips older events`, { observer, consumer: consumer.name, dependency });
+            }
+        }
+        declared.set(consumer.name, consumer);
+    }
+};
+/**
+ * Wires the consumers of one observer onto a shared stream.
+ *
+ * Consumers run sequentially in declaration order. Every non-halted
+ * consumer advances its position on every event — handled or not — which
+ * keeps the position contiguous and lets a restart resume exactly where it
+ * stopped.
+ *
+ * A consumer that throws holds its position while its siblings advance, as
+ * does every consumer that depends on it. The handler then rejects so the
+ * observer retries in place. On the next retry the advanced consumers skip
+ * themselves, so only the failing ones run again. Once retries are
+ * exhausted those consumers are halted. They are skipped for the rest of
+ * the process lifetime and their checkpoint stays at the last event they
+ * finished, so a restart resumes at the event they could not handle.
+ *
+ * Consumers with `startFrom: 'head'` ignore their stored position and
+ * start at the head of the subject on every start. Their checkpoint is
+ * still written like any other, so operators see where they are.
+ */
+export const createConsumerRunner = async ({ observer, consumers, checkpointStore, head, }) => {
+    validateConsumers(observer, consumers);
+    const names = consumers.map((consumer) => {
+        return consumer.name;
+    });
+    const checkpoints = await checkpointStore.load(names);
+    const positionFor = (consumer) => {
+        if (startsFromHead(consumer)) {
+            return head === null ? null : BigInt(head);
+        }
+        const position = checkpoints.get(consumer.name)?.position;
+        return position === undefined ? null : BigInt(position);
+    };
+    const states = consumers.map((consumer) => {
+        const checkpoint = checkpoints.get(consumer.name);
+        return {
+            consumer,
+            position: positionFor(consumer),
+            pending: false,
+            halted: false,
+            ...(checkpoint?.failure !== undefined
+                ? { failure: checkpoint.failure }
+                : {}),
+        };
+    });
+    const statesByName = new Map(states.map((state) => {
+        return [state.consumer.name, state];
+    }));
+    // Failures from the most recent handler attempt, read by onExhausted
+    // to know which consumers to halt.
+    let lastFailures = new Map();
+    const burstTimer = createBurstTimer(observer);
+    const flush = async (failed) => {
+        const updates = [];
+        const now = new Date().toISOString();
+        for (const state of states) {
+            const error = failed?.errors.get(state.consumer.name);
+            if (failed !== undefined && error !== undefined) {
+                state.failure = {
+                    position: failed.position,
+                    error: `${error.name}: ${error.message}`,
+                    at: now,
+                };
+                state.pending = true;
+            }
+            if (!state.pending) {
+                continue;
+            }
+            // A halted consumer carries its marker on every write until
+            // it is reset, so a marker whose first write failed is still
+            // persisted by the next successful flush. A running consumer
+            // only has a marker loaded from the store, which the save
+            // after its next success clears.
+            const failure = state.halted && state.failure !== undefined
+                ? {
+                    position: state.failure.position,
+                    error: state.failure.error,
+                }
+                : undefined;
+            updates.push({
+                consumer: state.consumer.name,
+                observer,
+                ...(state.position !== null
+                    ? { position: state.position.toString() }
+                    : {}),
+                ...(failure !== undefined ? { failure } : {}),
+            });
+        }
+        if (updates.length === 0) {
+            return;
+        }
+        await checkpointStore.save(updates);
+        for (const state of states) {
+            state.pending = false;
+        }
+    };
+    /**
+     * The error that blocks the consumer on this event because one of its
+     * dependencies failed on it or is halted, or `undefined`.
+     */
+    const dependencyFailure = (state, failures, eventId) => {
+        const failedDependency = (state.consumer.dependsOn ?? []).find((dependency) => {
+            return (failures.has(dependency) ||
+                statesByName.get(dependency)?.halted === true);
+        });
+        return failedDependency === undefined
+            ? undefined
+            : new GenericException(`Dependency "${failedDependency}" did not finish event ${eventId}`, { dependency: failedDependency });
+    };
+    /**
+     * Offers the event to one consumer. Both the predicate and the handler
+     * run inside the error boundary, so a throwing predicate is a failure
+     * of this consumer alone and its siblings still receive the event.
+     */
+    const runConsumer = async (state, event, raw) => {
+        try {
+            if (!state.consumer.handles(event)) {
+                return { handled: false };
+            }
+            await state.consumer.handle(event, raw);
+            return { handled: true };
+        }
+        catch (error) {
+            const failure = toError(error);
+            getLogger().error({
+                category: 'Nimbus',
+                message: `Consumer "${state.consumer.name}" failed to handle event ${raw.id} (${raw.type})`,
+                error: failure,
+                data: {
+                    observer,
+                    consumer: state.consumer.name,
+                    eventId: raw.id,
+                    eventType: raw.type,
+                },
+                correlationId: event.correlationid,
+            });
+            return { handled: true, error: failure };
+        }
+    };
+    const handle = async (raw) => {
+        const eventId = BigInt(raw.id);
+        const failures = new Map();
+        let handled = false;
+        // Before mapping: an event that cannot be mapped leaves an empty
+        // map behind, which tells onExhausted to halt every consumer.
+        lastFailures = failures;
+        const event = eventSourcingDBEventToNimbusEvent(raw);
+        burstTimer.start(raw.id);
+        try {
+            for (const state of states) {
+                if (state.halted ||
+                    (state.position !== null && eventId <= state.position)) {
+                    continue;
+                }
+                const blocked = dependencyFailure(state, failures, raw.id);
+                if (blocked !== undefined) {
+                    failures.set(state.consumer.name, blocked);
+                    continue;
+                }
+                // Declaration order: a later consumer reads the earlier projection.
+                const result = await runConsumer(state, event, raw); // NOSONAR
+                handled ||= result.handled;
+                if (result.error !== undefined) {
+                    failures.set(state.consumer.name, result.error);
+                    continue;
+                }
+                state.position = eventId;
+                state.pending = true;
+                state.failure = undefined;
+            }
+            await flush();
+        }
+        finally {
+            burstTimer.finish(handled);
+        }
+        if (failures.size > 0) {
+            const exception = new GenericException(`Observer "${observer}" could not handle event ${raw.id} for ${failureSummary(failures)}`, {
+                eventId: raw.id,
+                eventType: raw.type,
+                consumers: describeFailures(failures),
+            });
+            const cause = [...failures.values()][0];
+            if (cause !== undefined) {
+                exception.cause = cause;
+            }
+            throw exception;
+        }
+    };
+    const onExhausted = async (error, raw) => {
+        // An empty failure map means the handler broke outside a consumer
+        // (event mapping or the checkpoint flush), leaving the whole
+        // observer in an unknown state — halt all of it.
+        const errors = lastFailures.size > 0
+            ? lastFailures
+            : new Map(states
+                .filter((state) => {
+                return !state.halted;
+            })
+                .map((state) => {
+                return [state.consumer.name, error];
+            }));
+        for (const state of states) {
+            if (errors.has(state.consumer.name)) {
+                state.halted = true;
+            }
+        }
+        const cause = errors.size === 1 ? [...errors.values()][0] : error;
+        getLogger().critical({
+            category: 'Nimbus',
+            message: `Halted ${errors.size} consumer(s) of observer "${observer}" at event ${raw.id}. They stay at their checkpoint until the process restarts. ${failureSummary(errors)}`,
+            error: cause ?? error,
+            data: {
+                observer,
+                eventId: raw.id,
+                eventType: raw.type,
+                consumers: describeFailures(errors),
+            },
+        });
+        await flush({ position: raw.id, errors });
+    };
+    const status = () => {
+        return states.map((state) => {
+            return {
+                name: state.consumer.name,
+                position: state.position === null ? null : state.position.toString(),
+                halted: state.halted,
+                ...(state.failure !== undefined
+                    ? { failure: { ...state.failure } }
+                    : {}),
+            };
+        });
+    };
+    return { lowerBound: lowerBoundFor(states), handle, onExhausted, status };
+};
+//# sourceMappingURL=consumerRunner.js.map

package/dist/lib/consumerRunner.js.map

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

package/dist/lib/eventConsumer.d.ts

@@ -0,0 +1,94 @@
+import type { CheckpointFailure, Event } from '@nimbus-cqrs/core';
+import type { Event as EventSourcingDBEvent } from 'eventsourcingdb';
+/**
+ * One stateful consumer of an observed event stream.
+ *
+ * A read-model projection, a policy, an event handler and a process manager
+ * all share this shape. Each consumer owns a checkpoint keyed by its
+ * {@link name}, so one of them can be rebuilt or halted without moving the
+ * others on the same observer.
+ *
+ * Consumers run sequentially in the order they are declared on the
+ * observer. A consumer that reads what another one writes should declare
+ * it in {@link dependsOn} instead of relying on the order alone.
+ *
+ * @example
+ * ```ts
+ * import type { EventConsumer } from '@nimbus-cqrs/eventsourcingdb';
+ *
+ * export const ticketsProjection: EventConsumer = {
+ *     name: 'ticketing.tickets',
+ *     handles: (event) => event.type.startsWith('at.example.ticketing.ticket.'),
+ *     handle: async (event) => {
+ *         const ticket = ticketEventSchema.parse(event);
+ *         await ticketsRepository.apply(ticket);
+ *     },
+ * };
+ * ```
+ */
+export type EventConsumer = {
+    /**
+     * The checkpoint key. It has to be unique across the whole application,
+     * not just within one observer, because checkpoint stores key on the
+     * consumer name alone. It also has to stay stable: renaming a consumer
+     * makes it replay the subject from the beginning.
+     */
+    readonly name: string;
+    /**
+     * Whether the consumer handles the given event. Events it does not
+     * handle still advance its checkpoint, so the position stays
+     * contiguous.
+     *
+     * @param event - The observed event, mapped to a Nimbus event.
+     */
+    readonly handles: (event: Event) => boolean;
+    /**
+     * Handles one event. A thrown error holds the consumer's checkpoint
+     * while its siblings advance; the observer retries in place and halts
+     * the consumer once the handler retries are exhausted.
+     *
+     * @param event - The observed event, mapped to a Nimbus event.
+     * @param raw - The original EventSourcingDB event.
+     */
+    readonly handle: (event: Event, raw: EventSourcingDBEvent) => Promise<void>;
+    /**
+     * Names of consumers on the same observer this one reads from. They
+     * have to be declared before this consumer. When a dependency fails on
+     * an event, this consumer holds its position as well, so it never
+     * checkpoints past data its dependency has not written yet. When a
+     * dependency is halted, this consumer is halted too.
+     *
+     * A consumer that starts from its checkpoint must not depend on one
+     * that starts from the head, since the latter never built state for
+     * older events.
+     */
+    readonly dependsOn?: readonly string[];
+    /**
+     * Where the consumer starts on every start of the observer.
+     *
+     * - `checkpoint` (default): resumes after its stored checkpoint, or
+     *   from the beginning of the subject when it has none.
+     * - `head`: starts at the newest event of the subject, ignoring its
+     *   stored checkpoint. Events written while the process was down are
+     *   never delivered. Use this for live-only consumers such as pushing
+     *   to connected clients or invalidating in-memory caches. The
+     *   checkpoint is still persisted for visibility, but it has no effect
+     *   on where the consumer resumes, so resetting it does nothing.
+     */
+    readonly startFrom?: 'checkpoint' | 'head';
+};
+/**
+ * The runtime state of one {@link EventConsumer}.
+ *
+ * @property {string} name - The consumer name.
+ * @property {string | null} position - The id of the last event the consumer finished, `null` before its first.
+ * @property {boolean} halted - Whether the consumer gave up for the rest of the process lifetime.
+ * @property {CheckpointFailure} [failure] - The most recent failure, from this run or loaded from the checkpoint store.
+ */
+export type ConsumerStatus = {
+    name: string;
+    position: string | null;
+    halted: boolean;
+    failure?: CheckpointFailure;
+};
+//# sourceMappingURL=eventConsumer.d.ts.map

package/dist/lib/eventConsumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventConsumer.d.ts","sourceRoot":"","sources":["../../src/lib/eventConsumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,IAAI,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAC5C;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;CAC9C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC"}

package/dist/lib/eventConsumer.js

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

package/dist/lib/eventConsumer.js.map

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

package/{esm → dist}/lib/eventMapping.d.ts

@@ -1,5 +1,5 @@
 import { type Event } from '@nimbus-cqrs/core';
-import type { Event as EventSourcingDBEvent, EventCandidate } from 'eventsourcingdb';
+import type { EventCandidate, Event as EventSourcingDBEvent } from 'eventsourcingdb';
 /**
  * Metadata that Nimbus attaches to events stored in EventSourcingDB
  * to preserve correlation and schema information.

package/dist/lib/eventMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventMapping.d.ts","sourceRoot":"","sources":["../../src/lib/eventMapping.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,KAAK,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACR,cAAc,EACd,KAAK,IAAI,oBAAoB,EAChC,MAAM,iBAAiB,CAAC;AAGzB;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,mBAAmB,CAAC;CACnC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,OAAO,KAAG,IAAI,IAAI,SAOnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0CAA0C,GACnD,OAAO,KAAK,EACZ,cAAc,MAAM,EACpB,aAAa,MAAM,KACpB,cAeF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAAI,MAAM,SAAS,KAAK,EAClE,sBAAsB,oBAAoB,KAC3C,MAwBF,CAAC"}

package/{esm → dist}/lib/eventMapping.js

@@ -1,5 +1,5 @@
 import { createEvent, } from '@nimbus-cqrs/core';
-import { ulid } from '../deps/jsr.io/@std/ulid/1.0.0/mod.js';
+import { ulid } from 'ulid';
 /**
  * Type guard that checks whether the given value conforms to the {@link EventData} structure
  * by verifying the presence of both `payload` and `nimbusMeta` properties.
@@ -69,3 +69,4 @@ export const eventSourcingDBEventToNimbusEvent = (eventSourcingDBEvent) => {
         ...(dataschema && { dataschema: dataschema }),
     });
 };
+//# sourceMappingURL=eventMapping.js.map

package/dist/lib/eventMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventMapping.js","sourceRoot":"","sources":["../../src/lib/eventMapping.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,WAAW,GAEd,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA0B5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAa,EAAqB,EAAE;IAC5D,OAAO,CACH,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,SAAS,IAAI,IAAI;QACjB,YAAY,IAAI,IAAI,CACvB,CAAC;AACN,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,CACtD,KAAY,EACZ,WAAoB,EACpB,UAAmB,EACL,EAAE;IAChB,OAAO;QACH,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE;YACF,OAAO,EAAE,KAAK,CAAC,IAAI;YACnB,UAAU,EAAE;gBACR,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;aAC5D;SACJ;QACD,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAChD,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;KAChD,CAAC;AACN,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC7C,oBAA0C,EACpC,EAAE;IACR,IAAI,IAA6B,CAAC;IAClC,IAAI,aAAqB,CAAC;IAC1B,IAAI,UAA8B,CAAC;IAEnC,IAAI,WAAW,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC;QACzC,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QACnE,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;IACjE,CAAC;SAAM,CAAC;QACJ,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC;QACjC,aAAa,GAAG,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,WAAW,CAAC;QACf,EAAE,EAAE,oBAAoB,CAAC,EAAE;QAC3B,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE;QAC7C,MAAM,EAAE,oBAAoB,CAAC,MAAM;QACnC,OAAO,EAAE,oBAAoB,CAAC,OAAO;QACrC,IAAI,EAAE,oBAAoB,CAAC,IAAI;QAC/B,aAAa,EAAE,aAAa;QAC5B,IAAI,EAAE,IAAI;QACV,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;KACpB,CAAC,CAAC;AACnC,CAAC,CAAC"}