@spine-event-engine/server 2.0.0-snapshot.2 → 2.0.0-snapshot.21

package/dist/runtime/signal-publisher.d.ts

@@ -0,0 +1,144 @@
+import { type Command, type Event } from "@spine-event-engine/proto";
+import type { ILogLayer } from "loglayer";
+import { CommandBus } from "../bus/command-bus.js";
+import { EventBus } from "../bus/event-bus.js";
+type PublicationKind = "command" | "event" | "rejection-event" | "system-event" | "stored-event";
+interface ProducedSignalObserver {
+    readonly onCommand?: (command: Readonly<Command>) => void;
+    readonly onEvent?: (event: Readonly<Event>) => void;
+}
+/**
+ * Publishes produced signals and contains their detached dispatch failures for one context.
+ *
+ * @internal
+ */
+export declare class SignalPublisher {
+    #private;
+    /**
+     * Creates a publisher for the context buses.
+     *
+     * @param commandBus Accepts produced Commands.
+     * @param eventBus Accepts produced Events.
+     * @param systemEventBus Accepts produced System Events.
+     * @param contextName Names the context in failure logs.
+     */
+    constructor(commandBus: CommandBus, eventBus: EventBus, systemEventBus: EventBus, contextName: string);
+    /**
+     * Publishes a produced Command for detached handling.
+     *
+     * @param command The produced Command envelope.
+     * @returns A promise that settles after the Command is handled or its failure is contained.
+     */
+    publishCommand(command: Command): Promise<void>;
+    /**
+     * Publishes a produced Event for detached handling.
+     *
+     * @param event The produced Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    publishEvent(event: Event): Promise<void>;
+    /**
+     * Dispatches a rejection Event without recording it as committed produced output.
+     *
+     * @internal
+     * @param event The rejection Event envelope.
+     * @returns A promise that settles after detached rejection handling is contained.
+     */
+    publishRejectionEvent(event: Event): Promise<void>;
+    /**
+     * Publishes one committed Aggregate Event and records its admission.
+     *
+     * Publishes the committed Event through stored-event handling without treating stored replay as
+     * newly produced output.
+     *
+     * @internal
+     * @param event The committed Aggregate Event envelope.
+     * @returns A promise that settles after stored dispatch handling is contained.
+     */
+    publishCommittedEvent(event: Event): Promise<void>;
+    /**
+     * Publishes a committed Aggregate reactor Event as stored follow-up work and records it.
+     *
+     * @internal
+     * @param event The committed follow-up Event envelope.
+     * @returns A promise that settles after stored follow-up dispatch is contained.
+     */
+    publishReactorEvent(event: Event): Promise<void>;
+    /**
+     * Publishes a produced System Event for detached handling.
+     *
+     * @param event The produced System Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    publishSystemEvent(event: Event): Promise<void>;
+    /**
+     * Publishes a stored Event for detached handling.
+     *
+     * @param event The stored Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    redispatchStored(event: Event): Promise<void>;
+    /**
+     * Publishes a stored Event after current bus work for detached handling.
+     *
+     * @param event The stored Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    redispatchStoredFollowUp(event: Event): Promise<void>;
+    /**
+     * Records a failure that was contained during produced-signal handling.
+     *
+     * @param kind Identifies the handled signal category.
+     * @param signal Identifies the signal when it is available.
+     * @param error Contains the handled failure.
+     */
+    reportFailure(kind: PublicationKind, signal: Command | Event | undefined, error: unknown): void;
+    /**
+     * Sets the logger used for contained publication failures.
+     *
+     * @param logger Receives contained publication failure records.
+     */
+    installLogger(logger: ILogLayer): void;
+    /**
+     * Clears the installed failure logger.
+     */
+    clearLogger(): void;
+    /**
+     * Starts closing while trusted produced work admitted during context shutdown drains.
+     * New trusted work remains admissible until `finishClose()` rejects it.
+     */
+    beginClose(): void;
+    /**
+     * Waits until all admitted produced signals have settled.
+     *
+     * @returns A promise that settles when admitted signal handling is complete.
+     */
+    drain(): Promise<void>;
+    /**
+     * Completes closure after admitted signal handling settles.
+     */
+    finishClose(): void;
+    /**
+     * Stops publication while context assembly is being abandoned.
+     */
+    abortAssembly(): void;
+    /**
+     * Observes admitted produced Commands and Events for package testing.
+     *
+     * @internal
+     * @param observer Receives cloned admitted signal envelopes.
+     * @returns A handle that stops this observation.
+     */
+    observe(observer: ProducedSignalObserver): {
+        readonly close: () => void;
+    };
+    /**
+     * Returns a printable identifier for a signal.
+     *
+     * @param signal The signal to identify.
+     * @returns The signal identifier, or `"unknown"` when unavailable.
+     */
+    static signalId(signal: Command | Event | undefined): string;
+}
+export {};
+//# sourceMappingURL=signal-publisher.d.ts.map

package/dist/runtime/signal-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-publisher.d.ts","sourceRoot":"","sources":["../../src/runtime/signal-publisher.ts"],"names":[],"mappings":"AAeA,OAAO,EAA8B,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAoB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAkB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/D,KAAK,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,iBAAiB,GAAG,cAAc,GAAG,cAAc,CAAC;AAEjG,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CACrD;AAED;;;;GAIG;AACH,qBAAa,eAAe;;IAU1B;;;;;;;OAOG;gBAED,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,QAAQ,EACxB,WAAW,EAAE,MAAM;IAQrB;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;;;;OAMG;IACH,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD;;;;;;;;;OASG;IACH,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;;;;;OAMG;IACH,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;;;OAKG;IACH,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAc/F;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAItC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE;IAyCzE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM;CAK7D"}

package/dist/runtime/signal-publisher.js

@@ -0,0 +1,248 @@
+/*
+ * 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 { clone } from "@bufbuild/protobuf";
+import { CommandSchema, EventSchema } from "@spine-event-engine/proto";
+import { commandBusAccess, CommandBus } from "../bus/command-bus.js";
+import { eventBusAccess, EventBus } from "../bus/event-bus.js";
+import { emitServerError } from "../server/server-log.js";
+/**
+ * Publishes produced signals and contains their detached dispatch failures for one context.
+ *
+ * @internal
+ */
+export class SignalPublisher {
+    #commandBus;
+    #eventBus;
+    #systemEventBus;
+    #contextName;
+    #inFlight = new Set();
+    #observers = new Set();
+    #logger;
+    #state = "open";
+    /**
+     * Creates a publisher for the context buses.
+     *
+     * @param commandBus Accepts produced Commands.
+     * @param eventBus Accepts produced Events.
+     * @param systemEventBus Accepts produced System Events.
+     * @param contextName Names the context in failure logs.
+     */
+    constructor(commandBus, eventBus, systemEventBus, contextName) {
+        this.#commandBus = commandBus;
+        this.#eventBus = eventBus;
+        this.#systemEventBus = systemEventBus;
+        this.#contextName = contextName;
+    }
+    /**
+     * Publishes a produced Command for detached handling.
+     *
+     * @param command The produced Command envelope.
+     * @returns A promise that settles after the Command is handled or its failure is contained.
+     */
+    publishCommand(command) {
+        return this.#publish("command", command, () => commandBusAccess.postInternalFollowUp(this.#commandBus, command));
+    }
+    /**
+     * Publishes a produced Event for detached handling.
+     *
+     * @param event The produced Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    publishEvent(event) {
+        return this.#publish("event", event, () => eventBusAccess.postFollowUp(this.#eventBus, event));
+    }
+    /**
+     * Dispatches a rejection Event without recording it as committed produced output.
+     *
+     * @internal
+     * @param event The rejection Event envelope.
+     * @returns A promise that settles after detached rejection handling is contained.
+     */
+    publishRejectionEvent(event) {
+        return this.#publish("rejection-event", event, () => eventBusAccess.postFollowUp(this.#eventBus, event));
+    }
+    /**
+     * Publishes one committed Aggregate Event and records its admission.
+     *
+     * Publishes the committed Event through stored-event handling without treating stored replay as
+     * newly produced output.
+     *
+     * @internal
+     * @param event The committed Aggregate Event envelope.
+     * @returns A promise that settles after stored dispatch handling is contained.
+     */
+    publishCommittedEvent(event) {
+        return this.#publish("event", event, () => eventBusAccess.postStored(this.#eventBus, event));
+    }
+    /**
+     * Publishes a committed Aggregate reactor Event as stored follow-up work and records it.
+     *
+     * @internal
+     * @param event The committed follow-up Event envelope.
+     * @returns A promise that settles after stored follow-up dispatch is contained.
+     */
+    publishReactorEvent(event) {
+        return this.#publish("event", event, () => eventBusAccess.postStoredFollowUp(this.#eventBus, event));
+    }
+    /**
+     * Publishes a produced System Event for detached handling.
+     *
+     * @param event The produced System Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    publishSystemEvent(event) {
+        return this.#publish("system-event", event, () => eventBusAccess.postFollowUp(this.#systemEventBus, event));
+    }
+    /**
+     * Publishes a stored Event for detached handling.
+     *
+     * @param event The stored Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    redispatchStored(event) {
+        return this.#publish("stored-event", event, () => eventBusAccess.postStored(this.#eventBus, event));
+    }
+    /**
+     * Publishes a stored Event after current bus work for detached handling.
+     *
+     * @param event The stored Event envelope.
+     * @returns A promise that settles after the Event is handled or its failure is contained.
+     */
+    redispatchStoredFollowUp(event) {
+        return this.#publish("stored-event", event, () => eventBusAccess.postStoredFollowUp(this.#eventBus, event));
+    }
+    /**
+     * Records a failure that was contained during produced-signal handling.
+     *
+     * @param kind Identifies the handled signal category.
+     * @param signal Identifies the signal when it is available.
+     * @param error Contains the handled failure.
+     */
+    reportFailure(kind, signal, error) {
+        const logger = this.#logger;
+        if (logger === undefined)
+            return;
+        emitServerError(logger, "Produced signal handling failed.", {
+            context: this.#contextName,
+            kind,
+            signalId: SignalPublisher.signalId(signal),
+            signalType: signal?.message?.typeUrl ?? "unknown",
+            operation: "signal_publisher.handle",
+            reasonCode: "handled_failure",
+        });
+        void error;
+    }
+    /**
+     * Sets the logger used for contained publication failures.
+     *
+     * @param logger Receives contained publication failure records.
+     */
+    installLogger(logger) {
+        this.#logger = logger;
+    }
+    /**
+     * Clears the installed failure logger.
+     */
+    clearLogger() {
+        this.#logger = undefined;
+    }
+    /**
+     * Starts closing while trusted produced work admitted during context shutdown drains.
+     * New trusted work remains admissible until `finishClose()` rejects it.
+     */
+    beginClose() {
+        if (this.#state === "open")
+            this.#state = "closing";
+    }
+    /**
+     * Waits until all admitted produced signals have settled.
+     *
+     * @returns A promise that settles when admitted signal handling is complete.
+     */
+    async drain() {
+        while (this.#inFlight.size > 0) {
+            await Promise.all([...this.#inFlight]);
+        }
+    }
+    /**
+     * Completes closure after admitted signal handling settles.
+     */
+    finishClose() {
+        this.#state = "closed";
+    }
+    /**
+     * Stops publication while context assembly is being abandoned.
+     */
+    abortAssembly() {
+        this.#state = "closed";
+        this.#inFlight.clear();
+    }
+    /**
+     * Observes admitted produced Commands and Events for package testing.
+     *
+     * @internal
+     * @param observer Receives cloned admitted signal envelopes.
+     * @returns A handle that stops this observation.
+     */
+    observe(observer) {
+        this.#observers.add(observer);
+        return Object.freeze({ close: () => this.#observers.delete(observer) });
+    }
+    #publish(kind, signal, publish) {
+        if (this.#state === "closed") {
+            const rejected = Promise.reject(new Error("SignalPublisher is closed."));
+            void rejected.catch((error) => {
+                this.reportFailure(kind, signal, error);
+            });
+            return rejected;
+        }
+        this.#observe(kind, signal);
+        const handled = Promise.resolve()
+            .then(publish)
+            .catch((error) => {
+            this.reportFailure(kind, signal, error);
+        });
+        this.#inFlight.add(handled);
+        void handled.then(() => {
+            this.#inFlight.delete(handled);
+        });
+        return handled;
+    }
+    #observe(kind, signal) {
+        for (const observer of this.#observers) {
+            try {
+                if (kind === "command")
+                    observer.onCommand?.(clone(CommandSchema, signal));
+                if (kind === "event")
+                    observer.onEvent?.(clone(EventSchema, signal));
+            }
+            catch {
+                // Testing observation cannot change produced-signal publication.
+            }
+        }
+    }
+    /**
+     * Returns a printable identifier for a signal.
+     *
+     * @param signal The signal to identify.
+     * @returns The signal identifier, or `"unknown"` when unavailable.
+     */
+    static signalId(signal) {
+        const id = signal?.id;
+        if (id === undefined)
+            return "unknown";
+        return "uuid" in id ? id.uuid : id.value;
+    }
+}
+//# sourceMappingURL=signal-publisher.js.map

package/dist/runtime/signal-publisher.js.map

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

package/dist/runtime/standalone-handler-runtime.d.ts

@@ -0,0 +1,130 @@
+import { type MessageSchema } from "@spine-event-engine/core";
+import { type CommandContext, type EventContext, type Command, type Event } from "@spine-event-engine/proto";
+import type { CommandDispatcher } from "../bus/command-dispatcher.js";
+import type { EventDispatcher } from "../bus/event-dispatcher.js";
+import type { GeneratedHandlerRecordInput, GeneratedStandaloneHandlerGroup } from "../handler/generated-handler-registry.js";
+import { type EventHandlerFilterPlan } from "../handler/event-handler-filter.js";
+import { SignalPublisher } from "./signal-publisher.js";
+/**
+ * Materializes generated standalone receivers without treating them as Entities.
+ *
+ * @internal
+ */
+export declare class StandaloneHandlerRuntime {
+    #private;
+    /**
+     * Creates runtime bindings for registered standalone receivers.
+     *
+     * @param receivers Generated receiver groups with their application instances and publisher.
+     */
+    constructor(receivers: readonly StandaloneBinding[]);
+    /**
+     * Creates a dispatcher for standalone Command receptors.
+     *
+     * @returns The dispatcher, or `undefined` when no Command receptor is bound.
+     */
+    commandDispatcher(): CommandDispatcher | undefined;
+    /**
+     * Creates a dispatcher for standalone Event receptors.
+     *
+     * @returns The dispatcher, or `undefined` when no Event receptor is bound.
+     */
+    eventDispatcher(): EventDispatcher | undefined;
+    /**
+     * Creates a System Event Bus dispatcher for standalone state subscribers.
+     *
+     * @returns The dispatcher, or `undefined` when no state subscriber is bound.
+     */
+    stateDispatcher(): EventDispatcher | undefined;
+    /**
+     * Binds one generated handler declaration to its standalone application instance.
+     *
+     * @param group The generated receiver group.
+     * @param instance The registered application instance.
+     * @param handler The generated handler declaration.
+     * @returns The immutable runtime binding.
+     */
+    static bind(group: GeneratedStandaloneHandlerGroup, instance: object, handler: GeneratedHandlerRecordInput): Binding;
+    /**
+     * Lists distinct signal schemas used by bindings.
+     *
+     * @param bindings The bindings to inspect.
+     * @returns Distinct signal schemas in binding order.
+     */
+    static schemas(bindings: readonly Binding[]): readonly MessageSchema[];
+    /**
+     * Builds Event filters for standalone Event receptors.
+     *
+     * @param bindings The bindings to organize.
+     * @returns Filter plans keyed by signal schema and origin.
+     */
+    static eventFilters(bindings: readonly Binding[]): ReadonlyMap<string, EventHandlerFilterPlan<Binding>>;
+    /**
+     * Copies a Command context or creates its generated default.
+     *
+     * @param command The Command that provides the context.
+     * @returns An independent Command context.
+     */
+    static commandContext(command: Command): CommandContext;
+    /**
+     * Copies an Event context or creates its generated default.
+     *
+     * @param event The Event that provides the context.
+     * @returns An independent Event context.
+     */
+    static eventContext(event: Event): EventContext;
+    /**
+     * Creates a key for one Event schema and origin.
+     *
+     * @param typeName The Event schema type name.
+     * @param origin The required Event origin.
+     * @returns The filter-map key.
+     */
+    static eventFilterKey(typeName: string, origin: "domestic" | "external"): string;
+    /**
+     * Throws for a missing publisher during invalid runtime construction.
+     *
+     * @returns This method never returns because it throws.
+     */
+    static missingPublisher(): SignalPublisher;
+}
+/**
+ * Connects generated standalone metadata with its registered application instance.
+ */
+export interface StandaloneBinding {
+    /**
+     * The generated group for the standalone receiver.
+     */
+    readonly group: GeneratedStandaloneHandlerGroup;
+    /**
+     * The registered standalone application instance.
+     */
+    readonly instance: object;
+    /**
+     * Publishes signals produced by the bound receiver.
+     */
+    readonly publisher: SignalPublisher;
+}
+/**
+ * Generated handler declaration paired with its bound application method.
+ */
+interface Binding {
+    /**
+     * Generated group containing the standalone receiver's declarations.
+     */
+    readonly group: GeneratedStandaloneHandlerGroup;
+    /**
+     * Generated declaration for the bound method.
+     */
+    readonly handler: GeneratedHandlerRecordInput;
+    /**
+     * Invokes the application method with the argument count declared in metadata.
+     *
+     * @param message Unpacked input signal or Entity state.
+     * @param context Invocation context, passed only to a two-parameter method.
+     * @returns The application's synchronous result or Promise.
+     */
+    readonly invoke: (message: unknown, context: unknown) => unknown;
+}
+export {};
+//# sourceMappingURL=standalone-handler-runtime.d.ts.map

package/dist/runtime/standalone-handler-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-handler-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/standalone-handler-runtime.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,KAAK,EACX,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EACV,2BAA2B,EAC3B,+BAA+B,EAChC,MAAM,0CAA0C,CAAC;AAElD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;GAIG;AACH,qBAAa,wBAAwB;;IASnC;;;;OAIG;gBACS,SAAS,EAAE,SAAS,iBAAiB,EAAE;IAUnD;;;;OAIG;IACH,iBAAiB,IAAI,iBAAiB,GAAG,SAAS;IAalD;;;;OAIG;IACH,eAAe,IAAI,eAAe,GAAG,SAAS;IA6B9C;;;;OAIG;IACH,eAAe,IAAI,eAAe,GAAG,SAAS;IAwP9C;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,+BAA+B,EACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,2BAA2B,GACnC,OAAO;IAgBV;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,aAAa,EAAE;IAQtE;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CACjB,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAwBvD;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc;IAMvD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY;IAM/C;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM;IAIhF;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,eAAe;CAG3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAGhC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC;AAED;;GAEG;AACH,UAAU,OAAO;IAGf;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAE9C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAClE"}