@spine-event-engine/server 2.0.0-snapshot.25 → 2.0.0-snapshot.26

package/dist/stand/read-side-message.d.ts

@@ -0,0 +1,66 @@
+import { type Message } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Cursor for copying one object without recursive calls.
+ */
+interface CopyFrame {
+    readonly source: object;
+    readonly target: object;
+    readonly keys: readonly PropertyKey[];
+    next: number;
+}
+/**
+ * Detached Proto graph copies and shallow encodability checks.
+ */
+export declare const ReadSideMessages: {
+    /**
+     * Copies a domain graph without recursion and rejects cyclic or executable values.
+     *
+     * @typeParam Value Input value type retained by the detached copy.
+     * @param value Source value to detach.
+     * @returns Mutable detached value.
+     */
+    copy<Value>(value: Value): Value;
+    /**
+     * Returns a frozen detached parent snapshot without recursively walking its graph.
+     *
+     * @typeParam Value Detached snapshot type.
+     * @param value Detached parent value.
+     * @returns The same read-only snapshot.
+     */
+    freeze<Value>(value: Value): Readonly<Value>;
+    /**
+     * Encodes one message's own scalar content without recursively encoding children.
+     *
+     * @param schema Schema of the current message.
+     * @param message Message whose scalar fields must be encodable.
+     */
+    checkShallow(schema: GenMessage<Message>, message: Message): void;
+    /**
+     * Creates a mutable shell for a Proto object, list, or binary field.
+     *
+     * @param source Value whose shape determines the shell.
+     * @returns Empty mutable copy target.
+     */
+    shell(source: object): object;
+    /**
+     * Creates an iterative copy cursor of a plain object or repeated field.
+     *
+     * @param source Value to inspect.
+     * @param target Detached target.
+     * @returns Mutable copy cursor.
+     */
+    frame(source: object, target: object): CopyFrame;
+    /**
+     * Copies one data property and schedules its nested object when necessary.
+     *
+     * @param frame Current object pair.
+     * @param key Source property key.
+     * @param seen Previously copied values.
+     * @param active Values on the current ancestry path.
+     * @param frames Pending copy cursors.
+     */
+    copyMember(frame: CopyFrame, key: PropertyKey, seen: WeakMap<object, object>, active: WeakSet<object>, frames: CopyFrame[]): void;
+};
+export {};
+//# sourceMappingURL=read-side-message.d.ts.map

package/dist/stand/read-side-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-side-message.d.ts","sourceRoot":"","sources":["../../src/stand/read-side-message.ts"],"names":[],"mappings":"AAcA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;GAEG;AACH,UAAU,SAAS;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;;;;OAMG;SACE,KAAK,SAAS,KAAK,GAAG,KAAK;IAsBhC;;;;;;OAMG;WACI,KAAK,SAAS,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAc5C;;;;;OAKG;yBACkB,UAAU,CAAC,OAAO,CAAC,WAAW,OAAO,GAAG,IAAI;IAkBjE;;;;;OAKG;kBACW,MAAM,GAAG,MAAM;IAS7B;;;;;;OAMG;kBACW,MAAM,UAAU,MAAM,GAAG,SAAS;IAShD;;;;;;;;OAQG;sBAEM,SAAS,OACX,WAAW,QACV,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,UACrB,OAAO,CAAC,MAAM,CAAC,UACf,SAAS,EAAE,GAClB,IAAI;CA0BR,CAAC"}

package/dist/stand/read-side-message.js

@@ -0,0 +1,167 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { toBinary } from "@bufbuild/protobuf";
+/**
+ * Detached Proto graph copies and shallow encodability checks.
+ */
+export const ReadSideMessages = {
+    /**
+     * Copies a domain graph without recursion and rejects cyclic or executable values.
+     *
+     * @typeParam Value Input value type retained by the detached copy.
+     * @param value Source value to detach.
+     * @returns Mutable detached value.
+     */
+    copy(value) {
+        if (value === null || typeof value !== "object")
+            return value;
+        const root = ReadSideMessages.shell(value);
+        if (value instanceof Uint8Array)
+            return root;
+        const seen = new WeakMap([[value, root]]);
+        const active = new WeakSet([value]);
+        const frames = [ReadSideMessages.frame(value, root)];
+        while (frames.length > 0) {
+            const frame = frames.at(-1);
+            if (frame === undefined)
+                break;
+            if (frame.next === frame.keys.length) {
+                active.delete(frame.source);
+                frames.pop();
+                continue;
+            }
+            const key = frame.keys[frame.next++];
+            if (key === undefined)
+                throw new TypeError("Invalid read-side copy cursor.");
+            ReadSideMessages.copyMember(frame, key, seen, active, frames);
+        }
+        return root;
+    },
+    /**
+     * Returns a frozen detached parent snapshot without recursively walking its graph.
+     *
+     * @typeParam Value Detached snapshot type.
+     * @param value Detached parent value.
+     * @returns The same read-only snapshot.
+     */
+    freeze(value) {
+        const pending = [value];
+        const seen = new WeakSet();
+        while (pending.length > 0) {
+            const next = pending.pop();
+            if (next === null || typeof next !== "object" || seen.has(next))
+                continue;
+            seen.add(next);
+            if (next instanceof Uint8Array)
+                continue;
+            for (const key of Reflect.ownKeys(next))
+                pending.push(Reflect.get(next, key));
+            Object.freeze(next);
+        }
+        return value;
+    },
+    /**
+     * Encodes one message's own scalar content without recursively encoding children.
+     *
+     * @param schema Schema of the current message.
+     * @param message Message whose scalar fields must be encodable.
+     */
+    checkShallow(schema, message) {
+        if (message.$typeName !== schema.typeName)
+            throw new TypeError(`Read-side filter returned ${message.$typeName} for ${schema.typeName}.`);
+        const shallow = Object.assign(Object.create(null), message);
+        for (const field of schema.fields) {
+            if (field.fieldKind === "message" && field.oneof !== undefined) {
+                const selected = shallow[field.oneof.localName];
+                if (selected?.case === field.localName)
+                    shallow[field.oneof.localName] = { case: undefined };
+            }
+            else if (field.fieldKind === "message")
+                shallow[field.localName] = undefined;
+            else if (field.fieldKind === "list" && field.listKind === "message")
+                shallow[field.localName] = [];
+            else if (field.fieldKind === "map" && field.mapKind === "message")
+                shallow[field.localName] = {};
+        }
+        toBinary(schema, shallow);
+    },
+    /**
+     * Creates a mutable shell for a Proto object, list, or binary field.
+     *
+     * @param source Value whose shape determines the shell.
+     * @returns Empty mutable copy target.
+     */
+    shell(source) {
+        if (source instanceof Uint8Array)
+            return new Uint8Array(source);
+        if (Array.isArray(source))
+            return new Array(source.length);
+        const prototype = Object.getPrototypeOf(source);
+        if (prototype !== Object.prototype && prototype !== null)
+            throw new TypeError("Read-side message contains an unsupported object value.");
+        return Object.create(prototype);
+    },
+    /**
+     * Creates an iterative copy cursor of a plain object or repeated field.
+     *
+     * @param source Value to inspect.
+     * @param target Detached target.
+     * @returns Mutable copy cursor.
+     */
+    frame(source, target) {
+        return {
+            source,
+            target,
+            keys: Reflect.ownKeys(source).filter((key) => key !== "length"),
+            next: 0,
+        };
+    },
+    /**
+     * Copies one data property and schedules its nested object when necessary.
+     *
+     * @param frame Current object pair.
+     * @param key Source property key.
+     * @param seen Previously copied values.
+     * @param active Values on the current ancestry path.
+     * @param frames Pending copy cursors.
+     */
+    copyMember(frame, key, seen, active, frames) {
+        const descriptor = Object.getOwnPropertyDescriptor(frame.source, key);
+        if (descriptor === undefined || !("value" in descriptor))
+            throw new TypeError("Read-side message contains an accessor property.");
+        const value = descriptor.value;
+        if (typeof value === "function" || typeof value === "symbol")
+            throw new TypeError("Read-side message contains an unserializable value.");
+        let copied = value;
+        if (value !== null && typeof value === "object") {
+            if (active.has(value))
+                throw new TypeError("Cyclic read-side message.");
+            copied = seen.get(value) ?? ReadSideMessages.shell(value);
+            if (!seen.has(value)) {
+                seen.set(value, copied);
+                if (!(value instanceof Uint8Array)) {
+                    active.add(value);
+                    frames.push(ReadSideMessages.frame(value, copied));
+                }
+            }
+        }
+        Object.defineProperty(frame.target, key, {
+            value: copied,
+            enumerable: descriptor.enumerable ?? false,
+            writable: true,
+            configurable: true,
+        });
+    },
+};
+//# sourceMappingURL=read-side-message.js.map

package/dist/stand/read-side-message.js.map

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

package/dist/stand/stand-direct-delivery.d.ts

@@ -0,0 +1,161 @@
+import type { MessageShape } from "@bufbuild/protobuf";
+import type { MessageSchema } from "@spine-event-engine/core";
+import type { TenantId, Version } from "@spine-event-engine/proto";
+import type { ReadSideContext } from "./read-side-filter.js";
+import type { ReadSideFilterEngine } from "./read-side-filter-engine.js";
+/**
+ * Preserves committed metadata and detached domain values before public filtering.
+ *
+ * @typeParam Schema The registered state schema.
+ */
+export interface StandSourceUpdate<Schema extends MessageSchema = MessageSchema> {
+    /**
+     * Registered state type URL.
+     */
+    readonly typeUrl: string;
+    /**
+     * Typed Entity identifier from the committed update.
+     */
+    readonly id: unknown;
+    /**
+     * Committed current state before filtering.
+     */
+    readonly state: MessageShape<Schema>;
+    /**
+     * Committed prior state when the update replaced one.
+     */
+    readonly previousState?: MessageShape<Schema>;
+    /**
+     * Committed state version when supplied.
+     */
+    readonly version?: Version;
+    /**
+     * Tenant recorded with the committed state.
+     */
+    readonly tenantId?: TenantId;
+}
+/**
+ * Preserves original identity when a read policy removes the domain state.
+ */
+export interface StandUpdateMetadata {
+    /**
+     * Registered state type URL.
+     */
+    readonly typeUrl: string;
+    /**
+     * Typed Entity identifier from the committed update.
+     */
+    readonly id: unknown;
+    /**
+     * Committed state version when supplied.
+     */
+    readonly version?: Version;
+    /**
+     * Tenant recorded with the committed state.
+     */
+    readonly tenantId?: TenantId;
+}
+/**
+ * Delivers a visible state or a removal after the producing Bounded Context's policies.
+ *
+ * @typeParam Schema The registered state schema.
+ */
+export type StandUpdate<Schema extends MessageSchema = MessageSchema> = (StandUpdateMetadata & {
+    /**
+     * Indicates that the current state survived read policies.
+     */
+    readonly kind: "state";
+    /**
+     * Visible current state.
+     */
+    readonly state: MessageShape<Schema>;
+    /**
+     * Visible prior state when it survived independently.
+     */
+    readonly previousState?: MessageShape<Schema>;
+}) | (StandUpdateMetadata & {
+    /**
+     * Indicates that read policies removed the current state.
+     */
+    readonly kind: "removal";
+    /**
+     * Marks a state no longer visible to this reader.
+     */
+    readonly noLongerMatching: true;
+});
+/**
+ * Receives serial filtered values and one terminal local delivery error.
+ *
+ * @typeParam Schema The registered state schema.
+ */
+export interface StandObserver<Schema extends MessageSchema> {
+    /**
+     * Processes one visible state or removal before the next filter starts.
+     *
+     * @param update Visible state or removal with original committed metadata.
+     * @returns Completion of this delivery before the next update begins.
+     */
+    next(update: StandUpdate<Schema>): void | Promise<void>;
+    /**
+     * Notifies the observer of a terminal policy, callback, or waiting-capacity fault.
+     *
+     * @param error The local delivery fault that closed this observer.
+     * @returns Completion of local error notification, which cannot affect committed writes.
+     */
+    error(error: Error): void | Promise<void>;
+}
+/**
+ * Indicates that one direct subscriber exhausted its waiting-update capacity.
+ */
+export declare class StandSubscriptionCapacityError extends Error {
+    /**
+     * Creates a local fault with the configured waiting capacity.
+     *
+     * @param limit Maximum number of waiting updates after the active update.
+     */
+    constructor(limit: number);
+}
+/**
+ * Serializes one direct observer independently of peer subscriptions.
+ *
+ * @typeParam Schema The registered state schema.
+ */
+export declare class StandDirectDelivery<Schema extends MessageSchema> {
+    #private;
+    readonly schema: Schema;
+    readonly observer: StandObserver<Schema>;
+    readonly filters: ReadSideFilterEngine | undefined;
+    readonly facts: ReadSideContext;
+    readonly queueCapacity: number;
+    readonly onClose: () => void;
+    readonly externalSignal: AbortSignal | undefined;
+    /**
+     * Captures this subscription's policy and trusted invocation facts.
+     *
+     * @param schema Registered state schema.
+     * @param observer Local observer receiving visible values or one terminal fault.
+     * @param filters Producing Bounded Context read policies, if installed.
+     * @param facts Detached actor, tenant, and verified reader facts.
+     * @param queueCapacity Maximum waiting updates beyond the active update.
+     * @param onClose Removes this observer from its Stand registration.
+     * @param externalSignal Caller cancellation signal, if provided.
+     */
+    constructor(schema: Schema, observer: StandObserver<Schema>, filters: ReadSideFilterEngine | undefined, facts: ReadSideContext, queueCapacity: number, onClose: () => void, externalSignal: AbortSignal | undefined);
+    /**
+     * Returns whether this subscriber still accepts source updates.
+     *
+     * @returns True after cancellation, overflow, a policy fault, or close.
+     */
+    get closed(): boolean;
+    /**
+     * Admits one detached update without waiting for policy code.
+     *
+     * @param update Committed source update for this subscriber.
+     */
+    admit(update: StandSourceUpdate<Schema>): void;
+    /**
+     * Closes active work and clears queued snapshots without waiting on policy code.
+     */
+    readonly close: () => void;
+}
+//# sourceMappingURL=stand-direct-delivery.d.ts.map

package/dist/stand/stand-direct-delivery.d.ts.map

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

package/dist/stand/stand-direct-delivery.js

@@ -0,0 +1,210 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/**
+ * Indicates that one direct subscriber exhausted its waiting-update capacity.
+ */
+export class StandSubscriptionCapacityError extends Error {
+    /**
+     * Creates a local fault with the configured waiting capacity.
+     *
+     * @param limit Maximum number of waiting updates after the active update.
+     */
+    constructor(limit) {
+        super(`Stand subscription exceeded ${String(limit)} waiting updates.`);
+        this.name = "StandSubscriptionCapacityError";
+    }
+}
+/**
+ * Serializes one direct observer independently of peer subscriptions.
+ *
+ * @typeParam Schema The registered state schema.
+ */
+export class StandDirectDelivery {
+    schema;
+    observer;
+    filters;
+    facts;
+    queueCapacity;
+    onClose;
+    externalSignal;
+    #pending = [];
+    #abort = new AbortController();
+    #active = false;
+    #closed = false;
+    /**
+     * Captures this subscription's policy and trusted invocation facts.
+     *
+     * @param schema Registered state schema.
+     * @param observer Local observer receiving visible values or one terminal fault.
+     * @param filters Producing Bounded Context read policies, if installed.
+     * @param facts Detached actor, tenant, and verified reader facts.
+     * @param queueCapacity Maximum waiting updates beyond the active update.
+     * @param onClose Removes this observer from its Stand registration.
+     * @param externalSignal Caller cancellation signal, if provided.
+     */
+    constructor(schema, observer, filters, facts, queueCapacity, onClose, externalSignal) {
+        this.schema = schema;
+        this.observer = observer;
+        this.filters = filters;
+        this.facts = facts;
+        this.queueCapacity = queueCapacity;
+        this.onClose = onClose;
+        this.externalSignal = externalSignal;
+        externalSignal?.addEventListener("abort", this.close, { once: true });
+        if (externalSignal?.aborted)
+            this.close();
+    }
+    /**
+     * Returns whether this subscriber still accepts source updates.
+     *
+     * @returns True after cancellation, overflow, a policy fault, or close.
+     */
+    get closed() {
+        return this.#closed;
+    }
+    /**
+     * Admits one detached update without waiting for policy code.
+     *
+     * @param update Committed source update for this subscriber.
+     */
+    admit(update) {
+        if (this.#closed)
+            return;
+        if (!this.#active) {
+            this.#active = true;
+            void this.#run(update);
+            return;
+        }
+        if (this.#pending.length >= this.queueCapacity) {
+            this.#fail(new StandSubscriptionCapacityError(this.queueCapacity));
+            return;
+        }
+        this.#pending.push(update);
+    }
+    /**
+     * Closes active work and clears queued snapshots without waiting on policy code.
+     */
+    close = () => {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#pending.length = 0;
+        this.#abort.abort();
+        this.externalSignal?.removeEventListener("abort", this.close);
+        this.onClose();
+    };
+    /**
+     * Completes one filter and delivery before beginning the next.
+     *
+     * @param source Detached committed update selected for active processing.
+     */
+    async #run(source) {
+        try {
+            const update = this.filters === undefined
+                ? this.#visible(source)
+                : await this.#filtered(source, this.filters);
+            if (!this.#closed)
+                await this.observer.next(update);
+        }
+        catch (error) {
+            if (!this.#closed)
+                this.#fail(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            this.#active = false;
+            const next = this.#pending.shift();
+            if (!this.#closed && next !== undefined) {
+                this.#active = true;
+                void this.#run(next);
+            }
+        }
+    }
+    /**
+     * Applies current and previous policies in source order, retaining original metadata.
+     *
+     * @param source Detached committed update.
+     * @param filters Installed read policy engine.
+     * @returns Visible state or removal with original metadata.
+     */
+    async #filtered(source, filters) {
+        const context = {
+            ...this.facts,
+            signal: this.#abort.signal,
+        };
+        const state = await filters.apply(this.schema, source.state, context);
+        if (this.#closed || state === null)
+            return this.#removal(source);
+        const previousState = source.previousState === undefined
+            ? undefined
+            : await filters.apply(this.schema, source.previousState, context);
+        return {
+            ...this.#metadata(source),
+            kind: "state",
+            state,
+            ...(previousState === undefined || previousState === null ? {} : { previousState }),
+        };
+    }
+    /**
+     * Passes a detached source value when the context installed no read policies.
+     *
+     * @param source Detached committed update.
+     * @returns State delivery without policy transformation.
+     */
+    #visible(source) {
+        return {
+            ...this.#metadata(source),
+            kind: "state",
+            state: source.state,
+            ...(source.previousState === undefined ? {} : { previousState: source.previousState }),
+        };
+    }
+    /**
+     * Keeps removal identity independent of edited domain values.
+     *
+     * @param source Detached committed update.
+     * @returns Removal with original identity and version.
+     */
+    #removal(source) {
+        return { ...this.#metadata(source), kind: "removal", noLongerMatching: true };
+    }
+    /**
+     * Selects original version and tenant fields from this committed notification.
+     *
+     * @param source Detached committed update.
+     * @returns Original metadata unaffected by policy mutations.
+     */
+    #metadata(source) {
+        return {
+            typeUrl: source.typeUrl,
+            id: source.id,
+            ...(source.version === undefined ? {} : { version: source.version }),
+            ...(source.tenantId === undefined ? {} : { tenantId: source.tenantId }),
+        };
+    }
+    /**
+     * Terminates only this subscriber and contains errors from the error observer.
+     *
+     * @param error Policy, callback, or waiting-capacity fault.
+     */
+    #fail(error) {
+        this.close();
+        try {
+            void Promise.resolve(this.observer.error(error)).catch(() => undefined);
+        }
+        catch {
+            /* A terminal observer cannot affect an already committed update. */
+        }
+    }
+}
+//# sourceMappingURL=stand-direct-delivery.js.map

package/dist/stand/stand-direct-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stand-direct-delivery.js","sourceRoot":"","sources":["../../src/stand/stand-direct-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+HH;;GAEG;AACH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD;;;;OAIG;IACH,YAAY,KAAa;QACvB,KAAK,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAqBnB;IACA;IACA;IACA;IACA;IACA;IACA;IA1BF,QAAQ,GAAgC,EAAE,CAAC;IAE3C,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAExC,OAAO,GAAG,KAAK,CAAC;IAEhB,OAAO,GAAG,KAAK,CAAC;IAEhB;;;;;;;;;;OAUG;IACH,YACW,MAAc,EACd,QAA+B,EAC/B,OAAyC,EACzC,KAAsB,EACtB,aAAqB,EACrB,OAAmB,EACnB,cAAuC;QANvC,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,YAAO,GAAP,OAAO,CAAkC;QACzC,UAAK,GAAL,KAAK,CAAiB;QACtB,kBAAa,GAAb,aAAa,CAAQ;QACrB,YAAO,GAAP,OAAO,CAAY;QACnB,mBAAc,GAAd,cAAc,CAAyB;QAEhD,cAAc,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,IAAI,cAAc,EAAE,OAAO;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAiC;QACrC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,8BAA8B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACM,KAAK,GAAG,GAAS,EAAE;QAC1B,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,cAAc,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC;IAEF;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAAiC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GACV,IAAI,CAAC,OAAO,KAAK,SAAS;gBACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvB,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CACb,MAAiC,EACjC,OAA6B;QAE7B,MAAM,OAAO,GAAoB;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,OAAO,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,aAAa,GACjB,MAAM,CAAC,aAAa,KAAK,SAAS;YAChC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO;YACL,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,OAAO;YACb,KAAK;YACL,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;SACpF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAiC;QACxC,OAAO;YACL,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;SACvF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAiC;QACxC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAChF,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAiC;QACzC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACpE,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;SACxE,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAY;QAChB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC;YACH,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;CACF"}