@spine-event-engine/server 2.0.0-snapshot.11

package/dist/server/server-environment.js

@@ -0,0 +1,418 @@
+/*
+ * 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 { InMemoryStorageFactory } from "@spine-event-engine/storage";
+import { LogLayer, StructuredTransport } from "loglayer";
+import { InMemoryTransportFactory } from "@spine-event-engine/transport";
+import { spineCoreRegistry } from "@spine-event-engine/core";
+import { RetryableCloseGroup } from "./retryable-close.js";
+import { emitServerWarning } from "./server-log.js";
+import { boundedContextAccess } from "../context/bounded-context.js";
+import { EnvironmentDeliveryWorker } from "./environment-delivery-worker.js";
+import { EnvironmentAttachments, } from "./environment-attachment.js";
+import { Environment, EnvironmentTests, EnvironmentType } from "./environment.js";
+const configuredSettings = new Map();
+let resolvedEnvironment;
+let resetInProgress;
+/**
+ * Process-wide server facilities for the canonical {@link Environment}.
+ */
+export class ServerEnvironment {
+    // prettier-ignore
+    /**
+     * The environment whose settings resolved these facilities.
+     */
+    environment;
+    /**
+     * Stable identity shared by every server in this singleton lifecycle.
+     */
+    nodeId;
+    /**
+     * Storage facility selected for server assembly, including server-added context builders.
+     */
+    storageFactory;
+    /**
+     * Message-channel factory selected for private bounded-context integration.
+     *
+     * This is either the configured override or one environment-owned
+     * `InMemoryTransportFactory` shared by every local broker in the process and
+     * closed once with the environment.
+     */
+    integrationChannelFactory;
+    /**
+     * Read-only application schema lookup used by private integration boundaries.
+     */
+    typeRegistry;
+    /**
+     * Optional closeable delivery owner selected for this environment.
+     */
+    delivery;
+    /**
+     * Optional tracing factory selected for this environment.
+     */
+    tracerFactory;
+    #ownedCloseables;
+    #closeGroup;
+    #close;
+    #deliveryOpen;
+    #deliveryOpened = false;
+    constructor(environment, settings) {
+        this.environment = environment;
+        this.nodeId = crypto.randomUUID();
+        this.storageFactory = settings.storageFactory;
+        this.integrationChannelFactory = settings.integrationChannelFactory;
+        this.typeRegistry = settings.typeRegistry;
+        this.delivery = settings.delivery;
+        this.tracerFactory = settings.tracerFactory;
+        environmentLoggers.set(this, settings.logger);
+        this.#ownedCloseables = ServerEnvironmentValues.facilitiesToClose(settings);
+        warnedVolatileRegistries.set(this, new WeakSet());
+        this.#closeGroup = new RetryableCloseGroup(this.#ownedCloseables, "ServerEnvironment close failed.");
+        environmentAttachments.set(this, new EnvironmentAttachments({
+            logger: ServerEnvironmentValues.loggerFor(this),
+            createWorker: () => {
+                const ports = ServerEnvironmentValues.ports(this.delivery);
+                return new EnvironmentDeliveryWorker({
+                    ...(ports === undefined ? {} : { ports }),
+                    nodeId: this.nodeId,
+                });
+            },
+            deliveryPorts: () => ServerEnvironmentValues.ports(this.delivery),
+        }));
+        deliveryOpeners.set(this, () => this.#openDelivery());
+        testAttachmentsInstallable.add(this);
+        Object.freeze(this);
+    }
+    /**
+     * Sets facilities for an environment type before first resolution.
+     *
+     * @param type Identifies the environment to configure.
+     * @returns A one-use configuration entry point.
+     */
+    static when(type) {
+        return Object.freeze({
+            use(settings) {
+                if (resetInProgress !== undefined) {
+                    throw new Error("ServerEnvironment reset is in progress.");
+                }
+                if (resolvedEnvironment !== undefined) {
+                    throw new Error("ServerEnvironment is already resolved and cannot be reconfigured.");
+                }
+                configuredSettings.set(type, settings);
+            },
+        });
+    }
+    /**
+     * Resolves this module graph's configured server facilities exactly once.
+     *
+     * @returns The process-wide server environment.
+     */
+    static instance() {
+        if (resetInProgress !== undefined) {
+            throw new Error("ServerEnvironment reset is in progress.");
+        }
+        return (resolvedEnvironment ??= this.#resolve());
+    }
+    static #resolve() {
+        const environment = Environment.instance();
+        const configured = configuredSettings.get(environment.type);
+        const settings = typeof configured === "function" ? configured() : configured;
+        const facilities = ServerEnvironmentValues.resolveFacilities(environment.type, settings ?? {});
+        return new ServerEnvironment(environment, facilities);
+    }
+    /**
+     * Closes this environment after all attached servers retire.
+     *
+     * Admission permanently closes the environment and prevents reuse. If it is
+     * in use, closure rejects without owned-facility teardown. Failed facility
+     * closes are retryable and already closed facilities are not closed again.
+     *
+     * @returns A promise that settles after the environment and owned facilities close.
+     *
+     */
+    close() {
+        testAttachmentsInstallable.delete(this);
+        this.#close ??= this.#attachments()
+            .admitPermanentClose()
+            .then(() => this.#closeGroup.close())
+            .catch((error) => {
+            this.#close = undefined;
+            throw error;
+        });
+        return this.#close;
+    }
+    #openDelivery() {
+        if (this.#deliveryOpened)
+            return Promise.resolve();
+        const opening = (this.#deliveryOpen ??= Promise.resolve()
+            .then(() => {
+            const delivery = ServerEnvironmentValues.openableDelivery(this.delivery);
+            if (delivery !== undefined) {
+                return delivery.open();
+            }
+            return undefined;
+        })
+            .then(() => {
+            this.#deliveryOpened = true;
+        }));
+        // spine-log-boundary: server.delivery_open_reset
+        void opening.catch(() => {
+            if (this.#deliveryOpen === opening)
+                this.#deliveryOpen = undefined;
+        });
+        return opening;
+    }
+    #attachments() {
+        const attachments = environmentAttachments.get(this);
+        if (attachments === undefined) {
+            throw new Error("ServerEnvironment attachments are not available.");
+        }
+        return attachments;
+    }
+}
+/**
+ * Provides controlled server-environment lifecycle operations for package owners.
+ *
+ * @internal
+ */
+export const ServerEnvironmentLifecycle = Object.freeze({
+    // prettier-ignore
+    /**
+     * Resets singleton facilities to deterministic local defaults for the next package test.
+     */
+    resetForTest() {
+        const current = resetInProgress;
+        if (current !== undefined) {
+            return current;
+        }
+        const resolved = resolvedEnvironment;
+        const reset = Promise.resolve()
+            .then(() => resolved?.close())
+            .then(() => {
+            resolvedEnvironment = undefined;
+            configuredSettings.clear();
+            EnvironmentTests.reset();
+        })
+            .finally(() => {
+            resetInProgress = undefined;
+        });
+        resetInProgress = reset;
+        return reset;
+    },
+});
+const environmentAttachments = new WeakMap();
+const environmentLoggers = new WeakMap();
+const deliveryOpeners = new WeakMap();
+const testAttachmentsInstallable = new WeakSet();
+const warnedVolatileRegistries = new WeakMap();
+/**
+ * Provides package-only environment delivery attachment access for server lifecycle owners.
+ *
+ * @internal
+ */
+export const serverEnvironmentAccess = Object.freeze({
+    attach(environment, options) {
+        testAttachmentsInstallable.delete(environment);
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            return Promise.reject(new TypeError("Attachment requires a ServerEnvironment instance."));
+        }
+        const openDelivery = deliveryOpeners.get(environment);
+        if (openDelivery === undefined) {
+            return Promise.reject(new TypeError("Attachment requires a ServerEnvironment instance."));
+        }
+        return openDelivery().then(() => attachments.attach(options));
+    },
+    failedStartPending(environment) {
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            throw new TypeError("Failed-start observation requires a ServerEnvironment instance.");
+        }
+        return attachments.failedStartPending;
+    },
+    failedStartRetryPending(environment, error) {
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            throw new TypeError("Failed-start retry observation requires a ServerEnvironment instance.");
+        }
+        return attachments.failedStartRetryPending(error);
+    },
+    retryFailedStart(environment) {
+        testAttachmentsInstallable.delete(environment);
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            return Promise.reject(new TypeError("Rollback retry requires a ServerEnvironment instance."));
+        }
+        return attachments.retryFailedStart();
+    },
+    detach(environment, attachment) {
+        testAttachmentsInstallable.delete(environment);
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            return Promise.reject(new TypeError("Detach requires a ServerEnvironment instance."));
+        }
+        return attachments.detach(attachment);
+    },
+    retryDetach(environment, attachment) {
+        testAttachmentsInstallable.delete(environment);
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            return Promise.reject(new TypeError("Detach retry requires a ServerEnvironment instance."));
+        }
+        return attachments.retryDetach(attachment);
+    },
+    detachRetryPending(environment, attachment) {
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            throw new TypeError("Detach-retry observation requires a ServerEnvironment instance.");
+        }
+        return attachments.detachRetryPending(attachment);
+    },
+    endpointSafe(environment, attachment) {
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            throw new TypeError("Endpoint-safety observation requires a ServerEnvironment instance.");
+        }
+        return attachments.endpointSafe(attachment);
+    },
+    stopDelivery(environment) {
+        testAttachmentsInstallable.delete(environment);
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            return Promise.reject(new TypeError("Delivery stop requires a ServerEnvironment instance."));
+        }
+        return attachments.stopDelivery();
+    },
+    retryDeliveryStop(environment) {
+        testAttachmentsInstallable.delete(environment);
+        const attachments = environmentAttachments.get(environment);
+        if (attachments === undefined) {
+            return Promise.reject(new TypeError("Delivery stop retry requires a ServerEnvironment instance."));
+        }
+        return attachments.retryDeliveryStop();
+    },
+    installTestAttachments(environment, createWorker) {
+        if (!environmentAttachments.has(environment)) {
+            throw new TypeError("Test attachments require a ServerEnvironment instance.");
+        }
+        if (!testAttachmentsInstallable.delete(environment)) {
+            throw new Error("Test attachments may only be installed before environment lifecycle use.");
+        }
+        environmentAttachments.set(environment, new EnvironmentAttachments({
+            logger: ServerEnvironmentValues.loggerFor(environment),
+            createWorker,
+        }));
+    },
+    loggerFor(environment) {
+        return ServerEnvironmentValues.loggerFor(environment);
+    },
+    warnVolatileRegistry(environment, context) {
+        if (environment.environment.type !== EnvironmentType.Production)
+            return;
+        if (boundedContextAccess.subscriptionRegistry(context).persistent)
+            return;
+        const warned = warnedVolatileRegistries.get(environment);
+        if (warned === undefined) {
+            throw new TypeError("Registry warning requires a ServerEnvironment instance.");
+        }
+        if (warned.has(context))
+            return;
+        warned.add(context);
+        // spine-log-boundary: server.volatile_subscription_registry
+        emitServerWarning(ServerEnvironmentValues.loggerFor(environment), "Stand subscription registry is not persistent.", { contextName: context.name.value, operation: "stand.registry", reasonCode: "volatile" });
+    },
+});
+/**
+ *
+ * @internal Groups private facility-assembly operations for the environment singleton.
+ */
+const ServerEnvironmentValues = Object.freeze({
+    loggerFor(environment) {
+        const logger = environmentLoggers.get(environment);
+        if (logger === undefined)
+            throw new TypeError("ServerEnvironment logger is not available.");
+        return logger;
+    },
+    openableDelivery(delivery) {
+        if (delivery === undefined)
+            return undefined;
+        const candidate = delivery;
+        if (typeof candidate.open !== "function")
+            return undefined;
+        if (typeof candidate.close !== "function" ||
+            !("inbox" in candidate) ||
+            !("workRegistry" in candidate)) {
+            throw new TypeError("ServerEnvironmentDelivery requires inbox and workRegistry ports.");
+        }
+        return candidate;
+    },
+    ports(delivery) {
+        const remote = ServerEnvironmentValues.openableDelivery(delivery);
+        if (remote === undefined)
+            return undefined;
+        return {
+            inbox: remote.inbox,
+            workRegistry: remote.workRegistry,
+            ...(remote.source === undefined ? {} : { source: remote.source }),
+        };
+    },
+    facilitiesToClose(options) {
+        return Object.freeze([
+            ...(options.delivery === undefined ? [] : [options.delivery]),
+            options.integrationChannelFactory,
+            ...(options.tracerFactory === undefined ? [] : [options.tracerFactory]),
+            options.storageFactory,
+        ]);
+    },
+    logger(logger) {
+        return (logger ??
+            new LogLayer({
+                transport: new StructuredTransport({
+                    logger: console,
+                    level: "warn",
+                    stringify: true,
+                    messageField: "message",
+                    dateField: "timestamp",
+                    levelField: "severity",
+                    levelFn: (level) => level.toUpperCase(),
+                }),
+            })).child();
+    },
+    resolveFacilities(type, settings) {
+        if (type === EnvironmentType.Production) {
+            if (settings.storageFactory === undefined) {
+                throw new Error("Production ServerEnvironment requires storageFactory.");
+            }
+            if (settings.typeRegistry === undefined) {
+                throw new Error("Production ServerEnvironment requires typeRegistry.");
+            }
+            return {
+                storageFactory: settings.storageFactory,
+                integrationChannelFactory: settings.integrationChannelFactory ?? new InMemoryTransportFactory(),
+                typeRegistry: settings.typeRegistry,
+                delivery: settings.delivery,
+                tracerFactory: settings.tracerFactory,
+                logger: ServerEnvironmentValues.logger(settings.logger),
+            };
+        }
+        return {
+            storageFactory: settings.storageFactory ?? new InMemoryStorageFactory(),
+            integrationChannelFactory: settings.integrationChannelFactory ?? new InMemoryTransportFactory(),
+            typeRegistry: settings.typeRegistry ?? spineCoreRegistry,
+            delivery: settings.delivery,
+            tracerFactory: settings.tracerFactory,
+            logger: ServerEnvironmentValues.logger(settings.logger),
+        };
+    },
+});
+//# sourceMappingURL=server-environment.js.map

package/dist/server/server-environment.js.map

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

package/dist/server/server-log.d.ts

@@ -0,0 +1,18 @@
+import type { ILogLayer } from "loglayer";
+/**
+ * Records one internal warning without allowing logging failures into runtime work.
+ *
+ * @param logger Receives the contained record.
+ * @param message Supplies the stable warning message.
+ * @param facts Supplies allowlisted structured facts.
+ */
+export declare function emitServerWarning(logger: ILogLayer, message: string, facts: Readonly<Record<string, unknown>>): void;
+/**
+ * Records one internal error without allowing logging failures into runtime work.
+ *
+ * @param logger Receives the contained record.
+ * @param message Supplies the stable error message.
+ * @param facts Supplies allowlisted structured facts.
+ */
+export declare function emitServerError(logger: ILogLayer, message: string, facts: Readonly<Record<string, unknown>>): void;
+//# sourceMappingURL=server-log.d.ts.map

package/dist/server/server-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log.d.ts","sourceRoot":"","sources":["../../src/server/server-log.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA8B1C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,IAAI,CAEN"}

package/dist/server/server-log.js

@@ -0,0 +1,100 @@
+/*
+ * 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.
+ */
+const allowedFields = new Set([
+    "tenantId",
+    "actorId",
+    "entityType",
+    "entityId",
+    "commandType",
+    "commandId",
+    "sourceCommandType",
+    "sourceCommandId",
+    "childCommandType",
+    "childCommandId",
+    "eventType",
+    "eventId",
+    "shardId",
+    "workerId",
+    "nodeId",
+    "subscriptionId",
+    "contextName",
+    "operation",
+    "reasonCode",
+    "slot",
+    "incarnation",
+    "attempt",
+    "delay",
+    "count",
+]);
+const code = /^[a-z0-9][a-z0-9_.-]{0,63}$/;
+/**
+ * Records one internal warning without allowing logging failures into runtime work.
+ *
+ * @param logger Receives the contained record.
+ * @param message Supplies the stable warning message.
+ * @param facts Supplies allowlisted structured facts.
+ */
+export function emitServerWarning(logger, message, facts) {
+    emitServerLog(logger, "warn", message, facts);
+}
+/**
+ * Records one internal error without allowing logging failures into runtime work.
+ *
+ * @param logger Receives the contained record.
+ * @param message Supplies the stable error message.
+ * @param facts Supplies allowlisted structured facts.
+ */
+export function emitServerError(logger, message, facts) {
+    emitServerLog(logger, "error", message, facts);
+}
+function emitServerLog(logger, level, message, facts) {
+    try {
+        const builder = logger.withMetadata(cleanFacts(facts));
+        const emit = level === "warn" ? builder.warn.bind(builder) : builder.error.bind(builder);
+        const emitted = emit(message);
+        if (isPromiseLike(emitted)) {
+            // spine-log-boundary: server.log_async_failure
+            void Promise.resolve(emitted).catch(() => undefined);
+        }
+        // spine-log-boundary: server.log_sync_failure
+    }
+    catch {
+        // Logging must not affect the containing runtime outcome.
+    }
+}
+function cleanFacts(facts) {
+    const cleaned = {};
+    for (const [key, value] of Object.entries(facts)) {
+        if (!allowedFields.has(key))
+            continue;
+        if (key === "count") {
+            if (Number.isInteger(value) && value >= 0 && value <= 2_147_483_647)
+                cleaned[key] = value;
+            continue;
+        }
+        if (typeof value !== "string" || Buffer.byteLength(value, "utf8") > 256)
+            continue;
+        if ((key === "operation" || key === "reasonCode") && !code.test(value))
+            continue;
+        cleaned[key] = value;
+    }
+    return cleaned;
+}
+function isPromiseLike(value) {
+    return ((typeof value === "object" || typeof value === "function") &&
+        value !== null &&
+        "then" in value &&
+        typeof value.then === "function");
+}
+//# sourceMappingURL=server-log.js.map

package/dist/server/server-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log.js","sourceRoot":"","sources":["../../src/server/server-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,UAAU;IACV,SAAS;IACT,YAAY;IACZ,UAAU;IACV,aAAa;IACb,WAAW;IACX,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,WAAW;IACX,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,YAAY;IACZ,MAAM;IACN,aAAa;IACb,SAAS;IACT,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AACH,MAAM,IAAI,GAAG,6BAA6B,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,OAAe,EACf,KAAwC;IAExC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiB,EACjB,OAAe,EACf,KAAwC;IAExC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,aAAa,CACpB,MAAiB,EACjB,KAAuB,EACvB,OAAe,EACf,KAAwC;IAExC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,MAAM,IAAI,GACR,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,+CAA+C;YAC/C,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvD,CAAC;QACD,8CAA8C;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAwC;IAC1D,MAAM,OAAO,GAAoC,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACtC,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC,IAAK,KAAgB,IAAI,aAAa;gBACzF,OAAO,CAAC,GAAG,CAAC,GAAG,KAAe,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,GAAG;YAAE,SAAS;QAClF,IAAI,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QACjF,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAQ,KAA4B,CAAC,IAAI,KAAK,UAAU,CACzD,CAAC;AACJ,CAAC"}