@spine-event-engine/storage-postgres 2.0.0-snapshot.13

package/dist/postgres/storage-factory.js

@@ -0,0 +1,584 @@
+/*
+ * 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 { StringifierRegistry } from "@spine-event-engine/core";
+import { StorageFactory, } from "@spine-event-engine/storage";
+import { TenantBoundary } from "@spine-event-engine/storage/provider";
+import { DeliveryCleanupStorageFactories, EntityCommitStorageFactories, } from "@spine-event-engine/storage/provider";
+import { Pool } from "pg";
+import { PostgresStorageConfigurationError, PostgresStorageConnectionError } from "./errors.js";
+import { PostgresRecordStorage } from "./record-storage.js";
+import { PostgresEntityStorage } from "./entity-history.js";
+import { PostgresEntityCommitStorage } from "./entity-commit.js";
+import { PostgresDeliveryCleanupStorage } from "./delivery-cleanup.js";
+import { PostgresTableResolver } from "./table-resolver.js";
+import { PostgresTableSpecs } from "./table-spec.js";
+/**
+ * Provides the PostgreSQL storage-factory public contract.
+ */
+export class PostgresStorageFactory extends StorageFactory {
+    resolver;
+    operation;
+    stringifiers;
+    #handles = new Set();
+    #databases;
+    #catalog;
+    #closed;
+    /**
+     * Creates a connected factory from validated database resources.
+     *
+     * @param databases Supply the configured tenant databases.
+     * @param resolver Resolves record families to physical table names.
+     * @param operation Optionally creates custom table SQL.
+     * @param stringifiers Convert message IDs and columns reversibly.
+     */
+    constructor(databases, resolver, operation, stringifiers) {
+        super();
+        this.resolver = resolver;
+        this.operation = operation;
+        this.stringifiers = stringifiers;
+        this.#databases = new Map(databases.map((database) => [database.boundary.key, database]));
+        this.#catalog = new PostgresTenantCatalog(databases.map(({ boundary }) => boundary));
+        EntityCommitStorageFactories.register(this, {
+            createEntityCommitStorage: (input) => this.createEntityCommitStorage(input),
+        });
+        DeliveryCleanupStorageFactories.register(this, {
+            createDeliveryCleanupStorage: () => this.createDeliveryCleanupStorage(),
+        });
+    }
+    /**
+     * Creates a PostgreSQL storage factory builder.
+     *
+     * @returns A new builder.
+     */
+    static newBuilder() {
+        return new Builder((entries, resolver, operation, stringifiers) => PostgresStorageFactory.connect(entries, resolver, operation, stringifiers));
+    }
+    /**
+     * Returns the configured provider tenant catalog.
+     *
+     * @returns The configured tenant catalog.
+     */
+    tenantCatalog() {
+        return this.#catalog;
+    }
+    /**
+     * Closes the factory and begins idempotent PostgreSQL pool draining.
+     */
+    close() {
+        this.#closed ??= this.drain();
+        void this.#closed.catch(() => undefined);
+    }
+    /**
+     * Creates a record-storage handle for the selected PostgreSQL tenant.
+     *
+     * @typeParam I The storage identifier type.
+     * @typeParam R The stored Protobuf record type.
+     * @param context Identifies the requested storage boundary.
+     * @param recordSpec Describes the requested record family.
+     * @param group Separates records that share a source type.
+     * @returns A live handle bound to the resolved tenant table.
+     */
+    onCreateRecordStorage(context, recordSpec, group) {
+        return this.createPostgresRecordStorage(context, recordSpec, group);
+    }
+    /**
+     * Creates one PostgreSQL record handle and tracks it until closure.
+     *
+     * @typeParam I The storage identifier type.
+     * @typeParam R The stored Protobuf record type.
+     * @param context Identifies the storage boundary.
+     * @param recordSpec Describes the record family.
+     * @param group Optionally separates records sharing a source type.
+     * @returns The live PostgreSQL record handle.
+     */
+    createPostgresRecordStorage(context, recordSpec, group) {
+        const database = this.database(context);
+        const table = this.resolver.resolve(recordSpec.sourceType.typeName, group?.name, undefined, recordSpec.recordType.typeName);
+        const spec = PostgresTableSpecs.resolvedPostgresTableSpec({
+            schema: database.schema,
+            tableName: table.tableName,
+            sourceType: recordSpec.sourceType,
+            recordType: recordSpec.recordType,
+            idType: recordSpec.idType,
+            ...(group === undefined ? {} : { groupName: group.name }),
+            declaredColumns: recordSpec.columns,
+        });
+        const handle = new PostgresRecordStorage(context, recordSpec, spec, this.connections(database), () => this.#handles.delete(handle), this.operation === undefined ? undefined : createOperation(this.operation, spec), this.stringifiers);
+        this.#handles.add(handle);
+        return handle;
+    }
+    /**
+     * Creates the internal Entity-current and history storage seam.
+     *
+     * @typeParam I The Entity identifier type.
+     * @typeParam S The Entity state message type.
+     * @param input Supplies the Entity storage configuration.
+     * @returns A factory-managed PostgreSQL Entity handle.
+     */
+    createEntityStorage(input) {
+        if (!this.isOpen())
+            throw new Error("StorageFactory is closed.");
+        const registration = {};
+        const handle = new PostgresEntityStorage(input, this.createPostgresRecordStorage(input.context, input.recordSpec), (spec, group) => this.createPostgresRecordStorage(input.context, spec, group), () => this.#handles.delete(registration.handle));
+        registration.handle = handle;
+        this.#handles.add(handle);
+        return handle;
+    }
+    /**
+     * Creates the transaction coordinator for Entity current state and history.
+     *
+     * @typeParam I The Entity identifier type.
+     * @typeParam S The Entity state message type.
+     * @param input Supplies the Entity storage configuration.
+     * @returns A factory-managed commit coordinator.
+     */
+    createEntityCommitStorage(input) {
+        if (!this.isOpen())
+            throw new Error("StorageFactory is closed.");
+        const registration = {};
+        const database = this.database(input.context);
+        const handle = new PostgresEntityCommitStorage(input, (spec, group) => this.createPostgresRecordStorage(input.context, spec, group), this.connections(database), () => this.#handles.delete(registration.handle));
+        registration.handle = handle;
+        this.#handles.add(handle);
+        return handle;
+    }
+    /**
+     * Creates the provider's delivered-Inbox cleanup coordinator.
+     *
+     * @returns A factory-managed cleanup coordinator.
+     */
+    createDeliveryCleanupStorage() {
+        if (!this.isOpen())
+            throw new Error("StorageFactory is closed.");
+        const registration = {};
+        const handle = new PostgresDeliveryCleanupStorage((context, spec) => this.createPostgresRecordStorage(context, spec), (context) => this.connections(this.database(context)), () => this.#handles.delete(registration.handle));
+        registration.handle = handle;
+        this.#handles.add(handle);
+        return handle;
+    }
+    /**
+     * Closes live handles, the tenant catalog, and all pools.
+     *
+     * @returns A promise that resolves after every pool closes.
+     */
+    async drain() {
+        super.close();
+        for (const handle of this.#handles)
+            handle.close();
+        await this.#catalog.close();
+        await Promise.all([...this.#databases.values()].map(({ pool }) => pool.end()));
+    }
+    /**
+     * Connects every configured database before exposing a factory.
+     *
+     * @param entries Supply validated database configurations.
+     * @param resolver Resolves physical table names.
+     * @param operation Optionally creates custom table SQL.
+     * @param stringifiers Convert message values reversibly.
+     * @returns The connected factory.
+     */
+    static async connect(entries, resolver = new PostgresTableResolver(), operation, stringifiers = new StringifierRegistry()) {
+        const connected = [];
+        try {
+            for (const entry of entries)
+                connected.push(await PostgresStorageFactory.prove(entry));
+            return new PostgresStorageFactory(connected, resolver, operation, stringifiers);
+        }
+        catch (error) {
+            await Promise.all(connected.map(({ pool }) => pool.end().catch(() => undefined)));
+            if (error instanceof PostgresStorageConfigurationError)
+                throw error;
+            throw new PostgresStorageConnectionError("Unable to connect to PostgreSQL.");
+        }
+    }
+    /**
+     * Opens one pool and proves its selected schema is usable.
+     *
+     * @param entry Supplies one database configuration.
+     * @returns The connected database resource.
+     */
+    static async prove(entry) {
+        const pool = new Pool(entry.poolOptions);
+        try {
+            const client = await pool.connect();
+            try {
+                const schema = await PostgresSchemas.resolve(client, entry.schema);
+                await PostgresSchemas.assertUsable(client, schema);
+                return { boundary: entry.boundary, pool, schema, databaseName: entry.databaseName };
+            }
+            finally {
+                client.release();
+            }
+        }
+        catch (error) {
+            await pool.end().catch(() => undefined);
+            throw error;
+        }
+    }
+    /**
+     * Finds the configured database for a storage context.
+     *
+     * @param context Identifies the tenant boundary.
+     * @returns The matching database resource.
+     */
+    database(context) {
+        const boundary = TenantBoundary.of(context);
+        const database = this.#databases.get(boundary.key);
+        if (database !== undefined)
+            return database;
+        throw new PostgresStorageConfigurationError(boundary.single
+            ? "PostgreSQL storage is configured for multiple tenants."
+            : "PostgreSQL storage has no configured database for the requested tenant.");
+    }
+    /**
+     * Exposes record-lifecycle operations for one database resource.
+     *
+     * @param database Supplies the connected database.
+     * @returns Its package-local record lifecycle.
+     */
+    connections(database) {
+        return {
+            databaseName: database.databaseName,
+            schema: database.schema,
+            acquire: () => database.pool.connect(),
+        };
+    }
+}
+/**
+ * Collects validated options before connecting a PostgreSQL storage factory.
+ */
+class Builder {
+    connect;
+    #options;
+    #tenantOptions;
+    #operationFactory;
+    #stringifiers = new StringifierRegistry();
+    #resolver = new PostgresTableResolver();
+    /**
+     * Sets the single-database connection options.
+     *
+     * @param options Specify the PostgreSQL connection.
+     * @returns This builder.
+     */
+    setOptions(options) {
+        this.#options = {
+            ...options,
+            ...(options.tls === undefined ? {} : { tls: { ...options.tls } }),
+        };
+        return this;
+    }
+    /**
+     * Sets the complete tenant-to-database registry.
+     *
+     * @param entries Assign tenants to distinct databases.
+     * @returns This builder.
+     */
+    setTenantOptions(entries) {
+        this.#tenantOptions = entries.map(({ tenantId, options }) => ({
+            tenantId,
+            options: { ...options, ...(options.tls === undefined ? {} : { tls: { ...options.tls } }) },
+        }));
+        return this;
+    }
+    /**
+     * Sets custom reversible message stringifiers.
+     *
+     * @param registry Supplies the schema-bound registry.
+     * @returns This builder.
+     */
+    setStringifierRegistry(registry) {
+        this.#stringifiers = new StringifierRegistry(registry);
+        return this;
+    }
+    /**
+     * Applies either supported table-name overload.
+     *
+     * @param args Supply the overload arguments.
+     * @returns This builder.
+     */
+    setTableName(...args) {
+        if (args.length === 2)
+            this.#resolver.setRecordName(args[0].typeName, args[1]);
+        else
+            this.#resolver.setGroupName(args[0].typeName, args[1].typeName, args[2]);
+        return this;
+    }
+    /**
+     * Sets the custom create-table operation factory.
+     *
+     * @param factory Creates SQL for resolved table specifications.
+     * @returns This builder.
+     */
+    useOperationFactory(factory) {
+        this.#operationFactory = factory;
+        return this;
+    }
+    /**
+     * Creates a builder with its factory connection function.
+     *
+     * @param connect Connects validated database configurations.
+     */
+    constructor(connect) {
+        this.connect = connect;
+    }
+    /**
+     * Validates the selected mode and connects a factory.
+     *
+     * @returns The connected PostgreSQL storage factory.
+     */
+    build() {
+        try {
+            if (this.#options === undefined && this.#tenantOptions === undefined)
+                throw new PostgresStorageConfigurationError("PostgreSQL storage options are required.");
+            if (this.#options !== undefined && this.#tenantOptions !== undefined)
+                throw new PostgresStorageConfigurationError("Configure either single-tenant or multitenant PostgreSQL storage, not both.");
+            const entries = this.#options === undefined
+                ? PostgresConfigurations.multitenant(this.#tenantOptions ?? [])
+                : [PostgresConfigurations.single(this.#options)];
+            return this.connect(entries, this.#resolver, this.#operationFactory, this.#stringifiers);
+        }
+        catch (error) {
+            return Promise.reject(error instanceof Error
+                ? error
+                : new PostgresStorageConfigurationError("PostgreSQL storage configuration is invalid."));
+        }
+    }
+}
+/**
+ * Reports the immutable tenant boundaries configured by the factory.
+ */
+class PostgresTenantCatalog {
+    boundaries;
+    /**
+     * Creates a catalog from configured tenant boundaries.
+     *
+     * @param boundaries Supply the configured boundaries.
+     */
+    constructor(boundaries) {
+        this.boundaries = boundaries;
+    }
+    /**
+     * Returns every configured boundary.
+     *
+     * @returns The configured boundaries.
+     */
+    all() {
+        return Promise.resolve(this.boundaries);
+    }
+    /**
+     * Checks that a boundary belongs to this fixed catalog.
+     *
+     * @param boundary Supplies the boundary to confirm.
+     * @returns A promise that resolves when the boundary is configured.
+     */
+    keep(boundary) {
+        if (!this.boundaries.some(({ key }) => key === boundary.key)) {
+            return Promise.reject(new PostgresStorageConfigurationError("PostgreSQL tenant is not configured."));
+        }
+        return Promise.resolve();
+    }
+    /**
+     * Closes the catalog, which holds no external resources.
+     *
+     * @returns An already resolved promise.
+     */
+    close() {
+        return Promise.resolve();
+    }
+}
+/**
+ * Validates public options and builds internal database configurations.
+ */
+const PostgresConfigurations = Object.freeze({
+    /**
+     * Builds the single-tenant database configuration.
+     *
+     * @param options Specify the database connection.
+     * @returns The validated internal configuration.
+     */
+    single(options) {
+        return PostgresConfigurations.parse(TenantBoundary.single, options);
+    },
+    /**
+     * Builds configurations for the complete tenant registry.
+     *
+     * @param entries Assign tenants to their databases.
+     * @returns Validated internal configurations.
+     */
+    multitenant(entries) {
+        if (entries.length === 0) {
+            throw new PostgresStorageConfigurationError("Multitenant PostgreSQL storage requires tenants.");
+        }
+        const configured = entries.map(({ tenantId, options }) => PostgresConfigurations.parse(TenantBoundary.from(tenantId), options));
+        PostgresConfigurations.assertDistinct(configured);
+        return configured;
+    },
+    /**
+     * Rejects duplicate tenants and shared physical database targets.
+     *
+     * @param entries Supply validated database configurations.
+     */
+    assertDistinct(entries) {
+        const tenants = new Set();
+        const targets = new Set();
+        for (const entry of entries) {
+            if (tenants.has(entry.boundary.key)) {
+                throw new PostgresStorageConfigurationError("PostgreSQL storage has a duplicate tenant.");
+            }
+            if (targets.has(entry.target)) {
+                throw new PostgresStorageConfigurationError("PostgreSQL tenants must use distinct physical databases.");
+            }
+            tenants.add(entry.boundary.key);
+            targets.add(entry.target);
+        }
+    },
+    /**
+     * Converts one public database configuration to pool settings.
+     *
+     * @param boundary Identifies the tenant boundary.
+     * @param options Specify the database connection.
+     * @returns The internal database configuration.
+     */
+    parse(boundary, options) {
+        const url = PostgresConfigurations.url(options.url);
+        PostgresConfigurations.validate(options);
+        const port = url.port === "" ? 5432 : Number(url.port);
+        const database = decodeURIComponent(url.pathname.slice(1));
+        return {
+            boundary,
+            schema: options.schema,
+            target: `${url.hostname.toLowerCase()}:${String(port)}/${database.toLowerCase()}`,
+            databaseName: database,
+            poolOptions: {
+                host: url.hostname,
+                ...(url.port === "" ? {} : { port }),
+                database,
+                ...(url.username === "" ? {} : { user: decodeURIComponent(url.username) }),
+                ...(url.password === "" ? {} : { password: decodeURIComponent(url.password) }),
+                ...(options.connectionLimit === undefined ? {} : { max: options.connectionLimit }),
+                ...(options.connectTimeoutMs === undefined
+                    ? {}
+                    : { connectionTimeoutMillis: options.connectTimeoutMs }),
+                ...(options.tls === undefined ? {} : { ssl: options.tls }),
+            },
+        };
+    },
+    /**
+     * Parses and validates a PostgreSQL database URL.
+     *
+     * @param value Supplies the configured URL.
+     * @returns The parsed URL.
+     */
+    url(value) {
+        let url;
+        try {
+            url = new URL(value);
+        }
+        catch {
+            throw new PostgresStorageConfigurationError("PostgreSQL storage requires a valid URL.");
+        }
+        if ((url.protocol !== "postgres:" && url.protocol !== "postgresql:") ||
+            url.pathname.length <= 1 ||
+            url.hash !== "" ||
+            url.search !== "") {
+            throw new PostgresStorageConfigurationError("PostgreSQL storage URL requires a database.");
+        }
+        return url;
+    },
+    /**
+     * Validates scalar connection and schema options.
+     *
+     * @param options Supply the public configuration.
+     */
+    validate(options) {
+        if (!PostgresConfigurations.positive(options.connectionLimit)) {
+            throw new PostgresStorageConfigurationError("PostgreSQL connection limit is invalid.");
+        }
+        if (!PostgresConfigurations.positive(options.connectTimeoutMs)) {
+            throw new PostgresStorageConfigurationError("PostgreSQL connection timeout is invalid.");
+        }
+        if (options.schema !== undefined && !/^[A-Za-z_][A-Za-z0-9_]{0,62}$/u.test(options.schema)) {
+            throw new PostgresStorageConfigurationError("PostgreSQL schema name is invalid.");
+        }
+    },
+    /**
+     * Checks whether an optional numeric setting is a positive integer.
+     *
+     * @param value Supplies the optional setting.
+     * @returns Whether the setting is absent or valid.
+     */
+    positive(value) {
+        return value === undefined || (Number.isInteger(value) && value > 0);
+    },
+});
+/**
+ * Adapts a public create-table operation to the record handle callback.
+ *
+ * @typeParam I The storage identifier type.
+ * @typeParam R The stored Protobuf record type.
+ * @param operation Creates a public operation for a resolved table.
+ * @param table Supplies the resolved table specification.
+ * @returns A callback that returns the operation SQL.
+ */
+function createOperation(operation, table) {
+    return () => operation(table).sql;
+}
+/**
+ * Resolves and validates schemas used by connected pools.
+ */
+const PostgresSchemas = Object.freeze({
+    /**
+     * Resolves an explicit or connection-default schema.
+     *
+     * @param client Provides a connected client.
+     * @param explicit Optionally names the configured schema.
+     * @returns The existing schema name.
+     */
+    async resolve(client, explicit) {
+        const schema = explicit ?? (await PostgresSchemas.current(client));
+        const result = await client.query("SELECT 1 FROM information_schema.schemata WHERE schema_name = $1", [schema]);
+        if (result.rowCount !== 1)
+            throw new PostgresStorageConfigurationError("PostgreSQL schema does not exist.");
+        return schema;
+    },
+    /**
+     * Reads and validates the connection's current schema.
+     *
+     * @param client Provides a connected client.
+     * @returns The current schema name.
+     */
+    async current(client) {
+        const result = await client.query("SELECT current_schema() AS schema");
+        const schema = result.rows[0]?.schema;
+        if (schema === null || schema === undefined || !/^[A-Za-z_][A-Za-z0-9_]{0,62}$/u.test(schema)) {
+            throw new PostgresStorageConfigurationError("PostgreSQL schema is invalid.");
+        }
+        return schema;
+    },
+    /**
+     * Rejects schemas that contain the retired storage layout.
+     *
+     * @param client Provides a connected client.
+     * @param schema Names the selected schema.
+     * @returns A promise that resolves when the schema is usable.
+     */
+    async assertUsable(client, schema) {
+        const result = await client.query("SELECT 1 FROM information_schema.columns WHERE table_schema = $1 " +
+            "AND LOWER(column_name) IN ('_scope', '_revision') LIMIT 1", [schema]);
+        if ((result.rowCount ?? 0) > 0) {
+            throw new PostgresStorageConfigurationError("The configured database contains the retired storage layout.");
+        }
+    },
+});
+//# sourceMappingURL=storage-factory.js.map

package/dist/postgres/storage-factory.js.map

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

package/dist/postgres/table-initializer.d.ts

@@ -0,0 +1,66 @@
+import type { PoolClient } from "pg";
+import type { PostgresTableSpec } from "./storage-factory.js";
+/**
+ * Prepares one PostgreSQL record-family table.
+ */
+export declare class PostgresTableInitializer {
+    #private;
+    private readonly lifecycle;
+    private readonly schema;
+    private readonly table;
+    private readonly customCreate?;
+    /**
+     * Creates a private initializer for one resolved PostgreSQL table.
+     *
+     * @param lifecycle Acquires clients and supplies the stable database lock identity.
+     * @param schema Names the resolved PostgreSQL schema.
+     * @param table Describes the canonical record-family layout.
+     * @param customCreate Optionally supplies caller-defined create-table SQL.
+     */
+    constructor(lifecycle: PostgresClientLifecycle, schema: string, table: PostgresTableSpec<unknown, never>, customCreate?: (() => string) | undefined);
+    /**
+     * Prepares the table once.
+     *
+     * @returns Completion of initialization.
+     */
+    prepare(): Promise<void>;
+    /**
+     * Retries initialization only after an admitted transaction conflict.
+     *
+     * @param error Initial table-preparation failure.
+     * @returns Completion of the retry attempt.
+     */
+    private retry;
+    /**
+     * Creates and verifies the table inside one transaction.
+     *
+     * @returns Completion after commit.
+     */
+    private attempt;
+    /**
+     * Acquires the transaction lock for this physical table.
+     *
+     * @param client PostgreSQL transaction client.
+     * @returns PostgreSQL lock-query result.
+     */
+    private lock;
+    /**
+     * Builds the default idempotent table-creation statement.
+     *
+     * @returns Schema-qualified PostgreSQL DDL.
+     */
+    private create;
+    /**
+     * Verifies columns, primary key, and unsupported unique constraints.
+     *
+     * @param client PostgreSQL transaction client.
+     * @returns Completion after catalog verification.
+     */
+    private verify;
+}
+interface PostgresClientLifecycle {
+    readonly acquire: () => Promise<PoolClient>;
+    readonly lockIdentity?: string;
+}
+export {};
+//# sourceMappingURL=table-initializer.d.ts.map

package/dist/postgres/table-initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-initializer.d.ts","sourceRoot":"","sources":["../../src/postgres/table-initializer.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGrC,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AASlF;;GAEG;AACH,qBAAa,wBAAwB;;IAYjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAZhC;;;;;;;OAOG;gBAEgB,SAAS,EAAE,uBAAuB,EAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,EACxC,YAAY,CAAC,GAAE,MAAM,MAAM,aAAA;IAG9C;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB;;;;;OAKG;IACH,OAAO,CAAC,KAAK;IAKb;;;;OAIG;YACW,OAAO;IAqBrB;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAMZ;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAOd;;;;;OAKG;YACW,MAAM;CASrB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC"}