camusdb 0.1.0

package/dist/transport/rest-transport.d.ts

@@ -0,0 +1,88 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+import type { CamusTokenProvider } from '../auth/token-provider.js';
+import type { CamusEndpointPool } from '../endpoint-pool.js';
+import type { CamusTransactionOptions } from '../options.js';
+import { CamusResultSet } from '../result-set.js';
+import type { CamusRowSource } from '../row-source.js';
+import type { CamusBranchRow, CamusTransport, NonQueryTransportResult, PreparedStatementInfo, QueryTransportResult, StartTransactionResult, TransportInsertRequest, TransportSqlRequest } from './transport.js';
+/**
+ * The REST and JSON transport, and the default.
+ *
+ * Each call is one HTTP request to an `execute-sql-*` or admin route, with JSON in and out. It is
+ * the only transport that streams rows incrementally, and the only one the backup admin API is
+ * reachable over.
+ */
+export declare class RestTransport implements CamusTransport {
+    readonly protocol: "rest";
+    private readonly pool;
+    private readonly auth;
+    private readonly prepared;
+    constructor(pool: CamusEndpointPool, auth: CamusTokenProvider);
+    startTransaction(endpoint: string, database: string, options: CamusTransactionOptions, timeoutSeconds: number, signal?: AbortSignal): Promise<StartTransactionResult>;
+    finalizeTransaction(commit: boolean, endpoint: string, database: string, txnIdPT: bigint, txnIdCounter: number, _streamSlot: number | undefined, timeoutSeconds: number, signal?: AbortSignal): Promise<void>;
+    executeQuery(request: TransportSqlRequest): Promise<QueryTransportResult>;
+    private executeQueryCore;
+    executeQueryStream(request: TransportSqlRequest): Promise<CamusRowSource>;
+    private executeQueryStreamCore;
+    executeNonQuery(request: TransportSqlRequest): Promise<NonQueryTransportResult>;
+    private executeNonQueryCore;
+    insert(request: TransportInsertRequest): Promise<number>;
+    executeDdl(request: TransportSqlRequest): Promise<boolean>;
+    ping(endpoint: string, timeoutSeconds: number, signal?: AbortSignal): Promise<boolean>;
+    createDatabase(endpoint: string, database: string, ifNotExists: boolean, timeoutSeconds: number, signal?: AbortSignal): Promise<void>;
+    /**
+     * Creates a copy-on-write branch.
+     *
+     * Branching has no REST route of its own: the server implements it only as SQL, so the statement
+     * is composed and sent down the ordinary DDL route — which is what the gRPC transport does too.
+     */
+    createBranchDatabase(endpoint: string, branchName: string, sourceDatabaseName: string, ifNotExists: boolean, timeoutSeconds: number, signal?: AbortSignal): Promise<void>;
+    dropDatabase(endpoint: string, database: string, timeoutSeconds: number, signal?: AbortSignal): Promise<void>;
+    /** See `createBranchDatabase`: a branch listing is a SQL statement, not a route. */
+    showBranches(endpoint: string, database: string, timeoutSeconds: number, signal?: AbortSignal): Promise<CamusBranchRow[]>;
+    /** See `createBranchDatabase`. */
+    showAncestors(endpoint: string, database: string, timeoutSeconds: number, signal?: AbortSignal): Promise<CamusBranchRow[]>;
+    /** Runs a composed administration statement on the DDL route. */
+    private adminDdl;
+    /** Runs a composed administration query on the ordinary query route. */
+    private adminQuery;
+    prepare(endpoint: string, database: string, sql: string, timeoutSeconds: number, signal?: AbortSignal): Promise<PreparedStatementInfo>;
+    private register;
+    closePrepared(_endpoint: string, database: string, sql: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Runs one statement, as a prepared execution when the request asked for it.
+     *
+     * Two failures are absorbed rather than reported, because preparing is an optimization and must
+     * never be the reason a working statement fails.
+     *
+     * A registration that fails at all — no server support for the route, a statement kind that may
+     * not be prepared, a full server-side cap — falls back to running the statement inline, which is
+     * what it would have done anyway.
+     *
+     * An execution refused with `CADB0520` means the handle is gone: it idled out, the node
+     * restarted, or the request landed on another node. That is routine by contract, so the
+     * registration is dropped and the statement is prepared and replayed exactly once. One replay,
+     * not a loop: a second unknown-statement failure means something is wrong beyond a stale handle
+     * — a load balancer sending every request to a different node, say — and spinning there would
+     * turn a slow path into an endless one.
+     */
+    private withPrepared;
+    close(): Promise<void>;
+    private post;
+    /**
+     * The bearer token to present, if this client has one.
+     *
+     * Every route goes through here, so none can accidentally be built unauthenticated. With no
+     * credentials configured there is no token and no `Authorization` header at all, which is what a
+     * server with authentication off expects.
+     */
+    private token;
+}
+/** Re-exported so a caller that only imports this module can still build an empty result. */
+export declare const EMPTY_RESULT_SET: CamusResultSet;
+//# sourceMappingURL=rest-transport.d.ts.map

package/dist/transport/rest-transport.d.ts.map

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

package/dist/transport/rest-transport.js

@@ -0,0 +1,388 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+import { makeCacheMetadata } from '../cache.js';
+import { columnValueToJson } from '../column-value.js';
+import { CamusProtocol } from '../config.js';
+import { CamusError } from '../errors.js';
+import { CamusErrorCode } from '../error-codes.js';
+import { asBigInt, asNumber, parseLossless } from '../json.js';
+import { bindPositional } from '../prepared/binder.js';
+import { CamusResultSet } from '../result-set.js';
+import { routingAdviceFromJson } from '../routing/advice.js';
+import { createBranchDatabaseSql, mapBranchRows, showAncestorsSql, showBranchesSql, } from './branch-statements.js';
+import { readBody, sendHttp, sendJson, translateErrorBody } from './http.js';
+import { NDJSON_CONTENT_TYPE, NdjsonRowSource } from './ndjson-row-source.js';
+import { resultSetFromWire } from './rest-decode.js';
+import { RestPreparedStatementCache } from './rest-prepared-cache.js';
+import { hasTransaction } from './transport.js';
+/**
+ * The REST and JSON transport, and the default.
+ *
+ * Each call is one HTTP request to an `execute-sql-*` or admin route, with JSON in and out. It is
+ * the only transport that streams rows incrementally, and the only one the backup admin API is
+ * reachable over.
+ */
+export class RestTransport {
+    protocol = CamusProtocol.Rest;
+    pool;
+    auth;
+    prepared = new RestPreparedStatementCache();
+    constructor(pool, auth) {
+        this.pool = pool;
+        this.auth = auth;
+    }
+    // ─── Transactions ─────────────────────────────────────────────────────────
+    async startTransaction(endpoint, database, options, timeoutSeconds, signal) {
+        const body = await this.post(endpoint, ['start-transaction'], {
+            databaseName: database,
+            ...concurrencyFields(options),
+        }, timeoutSeconds, signal);
+        if (body.status !== 'ok') {
+            throw new CamusError(body.code ?? CamusErrorCode.Generic, body.message ?? 'Empty result returned');
+        }
+        return {
+            txnIdPT: asBigInt(body.txnIdPT),
+            txnIdCounter: asNumber(body.txnIdCounter),
+        };
+    }
+    async finalizeTransaction(commit, endpoint, database, txnIdPT, txnIdCounter, _streamSlot, timeoutSeconds, signal) {
+        // REST does not pin a transaction to a stream, so the slot means nothing here.
+        const path = commit ? 'commit-transaction' : 'rollback-transaction';
+        const body = await this.post(endpoint, [path], { databaseName: database, txnIdPT, txnIdCounter }, timeoutSeconds, signal);
+        if (body.status !== 'ok') {
+            throw new CamusError(body.code ?? CamusErrorCode.Generic, body.message ?? (commit ? 'Commit failed' : 'Rollback failed'));
+        }
+    }
+    // ─── Statements ───────────────────────────────────────────────────────────
+    executeQuery(request) {
+        return this.withPrepared(request, (binding) => this.executeQueryCore(request, binding));
+    }
+    async executeQueryCore(request, binding) {
+        const { response } = await sendHttp(this.pool, {
+            endpoint: request.endpoint,
+            path: ['execute-sql-query'],
+            method: 'POST',
+            body: buildQueryBody(request, binding),
+            token: await this.token(request.signal),
+            timeoutSeconds: request.timeoutSeconds,
+            signal: request.signal,
+        });
+        const text = await readBody(response);
+        if (!response.ok)
+            throw translateErrorBody(response.status, text);
+        let body;
+        try {
+            body = parseLossless(text);
+        }
+        catch (error) {
+            throw new CamusError(CamusErrorCode.Generic, 'Empty result returned', { cause: error });
+        }
+        if (typeof body !== 'object' || body === null || Array.isArray(body)) {
+            throw new CamusError(CamusErrorCode.Generic, 'Empty result returned');
+        }
+        const record = body;
+        return {
+            resultSet: resultSetFromWire(record.columns, record.rows),
+            cacheMetadata: cacheMetadataFromJson(record),
+            routing: routingAdviceFromJson(record),
+        };
+    }
+    executeQueryStream(request) {
+        return this.withPrepared(request, (binding) => this.executeQueryStreamCore(request, binding));
+    }
+    async executeQueryStreamCore(request, binding) {
+        const { response } = await sendHttp(this.pool, {
+            endpoint: request.endpoint,
+            path: ['execute-sql-query-stream'],
+            method: 'POST',
+            body: buildQueryBody(request, binding),
+            token: await this.token(request.signal),
+            accept: NDJSON_CONTENT_TYPE,
+            timeoutSeconds: request.timeoutSeconds,
+            signal: request.signal,
+        });
+        // A failure to set the statement up — bad SQL, an unknown database — arrives as a non-2xx
+        // before the first line. A conflict that surfaces after rows start flowing is reported by the
+        // NDJSON trailer instead, and raised from the read that reaches it.
+        if (!response.ok)
+            throw translateErrorBody(response.status, await readBody(response));
+        if (response.body === null) {
+            throw new CamusError(CamusErrorCode.Generic, 'The streaming query response carried no body.');
+        }
+        return NdjsonRowSource.create(response.body);
+    }
+    executeNonQuery(request) {
+        return this.withPrepared(request, (binding) => this.executeNonQueryCore(request, binding));
+    }
+    async executeNonQueryCore(request, binding) {
+        const body = await this.post(request.endpoint, ['execute-sql-non-query'], buildNonQueryBody(request, binding), request.timeoutSeconds, request.signal);
+        return {
+            affectedRows: asNumber(body.rows),
+            routing: routingAdviceFromJson(body),
+        };
+    }
+    async insert(request) {
+        const body = {
+            databaseName: request.database,
+            tableName: request.table,
+            values: parametersToJson(request.values),
+        };
+        if (hasTransaction(request)) {
+            body.txnIdPT = request.txnIdPT;
+            body.txnIdCounter = request.txnIdCounter;
+        }
+        const reply = await this.post(request.endpoint, ['insert'], body, request.timeoutSeconds, request.signal);
+        return asNumber(reply.rows);
+    }
+    async executeDdl(request) {
+        const body = {
+            databaseName: request.database,
+            sql: request.sql,
+        };
+        if (hasTransaction(request)) {
+            body.txnIdPT = request.txnIdPT;
+            body.txnIdCounter = request.txnIdCounter;
+        }
+        else if (request.autocommitOptions !== undefined) {
+            Object.assign(body, concurrencyFields(request.autocommitOptions));
+        }
+        const reply = await this.post(request.endpoint, ['execute-sql-ddl'], body, request.timeoutSeconds, request.signal);
+        return reply.status === 'ok';
+    }
+    async ping(endpoint, timeoutSeconds, signal) {
+        const body = await sendJson(this.pool, {
+            endpoint,
+            path: ['ping'],
+            method: 'GET',
+            token: await this.token(signal),
+            timeoutSeconds,
+            signal,
+        });
+        return body.status === 'ok';
+    }
+    // ─── Database administration ──────────────────────────────────────────────
+    async createDatabase(endpoint, database, ifNotExists, timeoutSeconds, signal) {
+        const body = await this.post(endpoint, ['create-db'], { databaseName: database, ifNotExists }, timeoutSeconds, signal);
+        if (body.status !== 'ok') {
+            throw new CamusError(body.code ?? CamusErrorCode.Generic, body.message ?? 'Create database failed');
+        }
+    }
+    /**
+     * Creates a copy-on-write branch.
+     *
+     * Branching has no REST route of its own: the server implements it only as SQL, so the statement
+     * is composed and sent down the ordinary DDL route — which is what the gRPC transport does too.
+     */
+    async createBranchDatabase(endpoint, branchName, sourceDatabaseName, ifNotExists, timeoutSeconds, signal) {
+        await this.adminDdl(endpoint, createBranchDatabaseSql(branchName, sourceDatabaseName, ifNotExists), timeoutSeconds, signal);
+    }
+    async dropDatabase(endpoint, database, timeoutSeconds, signal) {
+        const body = await this.post(endpoint, ['drop-db'], { databaseName: database }, timeoutSeconds, signal);
+        if (body.status !== 'ok') {
+            throw new CamusError(body.code ?? CamusErrorCode.Generic, body.message ?? 'Drop database failed');
+        }
+    }
+    /** See `createBranchDatabase`: a branch listing is a SQL statement, not a route. */
+    async showBranches(endpoint, database, timeoutSeconds, signal) {
+        return mapBranchRows(await this.adminQuery(endpoint, database, showBranchesSql(database), timeoutSeconds, signal));
+    }
+    /** See `createBranchDatabase`. */
+    async showAncestors(endpoint, database, timeoutSeconds, signal) {
+        return mapBranchRows(await this.adminQuery(endpoint, database, showAncestorsSql(database), timeoutSeconds, signal));
+    }
+    /** Runs a composed administration statement on the DDL route. */
+    async adminDdl(endpoint, sql, timeoutSeconds, signal) {
+        await this.executeDdl({
+            endpoint,
+            database: '',
+            sql,
+            timeoutSeconds,
+            prepared: false,
+            routingAcceptVersion: 0,
+            signal,
+        });
+    }
+    /** Runs a composed administration query on the ordinary query route. */
+    async adminQuery(endpoint, database, sql, timeoutSeconds, signal) {
+        const result = await this.executeQueryCore({
+            endpoint,
+            database,
+            sql,
+            timeoutSeconds,
+            prepared: false,
+            routingAcceptVersion: 0,
+            signal,
+        }, undefined);
+        return result.resultSet;
+    }
+    // ─── Prepared statements ──────────────────────────────────────────────────
+    async prepare(endpoint, database, sql, timeoutSeconds, signal) {
+        const statement = await this.prepared.getOrAdd({ endpoint, database, sql }, () => this.register(endpoint, database, sql, timeoutSeconds, signal));
+        return { parameterNames: statement.parameterNames };
+    }
+    async register(endpoint, database, sql, timeoutSeconds, signal) {
+        const body = await this.post(endpoint, ['prepare-sql-statement'], { databaseName: database, sql }, timeoutSeconds, signal);
+        if (body.status !== 'ok' || body.statementId === undefined || body.statementId.length === 0) {
+            throw new CamusError(body.code ?? CamusErrorCode.Generic, body.message ?? 'Prepare statement failed');
+        }
+        return { statementId: body.statementId, parameterNames: body.parameterNames ?? [] };
+    }
+    async closePrepared(_endpoint, database, sql, signal) {
+        // A statement is closed on every node it was registered on, not only the one the caller is
+        // sending to, so the endpoint argument is not the one used here.
+        for (const { endpoint: registeredOn, statement } of await this.prepared.take(database, sql)) {
+            try {
+                await this.post(registeredOn, ['close-sql-statement'], { statementId: statement.statementId }, 10, signal);
+            }
+            catch {
+                // Best effort: a node that is gone, or a handle it already reclaimed, needs nothing here.
+            }
+        }
+    }
+    /**
+     * Runs one statement, as a prepared execution when the request asked for it.
+     *
+     * Two failures are absorbed rather than reported, because preparing is an optimization and must
+     * never be the reason a working statement fails.
+     *
+     * A registration that fails at all — no server support for the route, a statement kind that may
+     * not be prepared, a full server-side cap — falls back to running the statement inline, which is
+     * what it would have done anyway.
+     *
+     * An execution refused with `CADB0520` means the handle is gone: it idled out, the node
+     * restarted, or the request landed on another node. That is routine by contract, so the
+     * registration is dropped and the statement is prepared and replayed exactly once. One replay,
+     * not a loop: a second unknown-statement failure means something is wrong beyond a stale handle
+     * — a load balancer sending every request to a different node, say — and spinning there would
+     * turn a slow path into an endless one.
+     */
+    async withPrepared(request, send) {
+        if (!request.prepared)
+            return send(undefined);
+        const key = { endpoint: request.endpoint, database: request.database, sql: request.sql };
+        for (let attempt = 0;; attempt++) {
+            let statement;
+            let values;
+            try {
+                statement = await this.prepared.getOrAdd(key, () => this.register(request.endpoint, request.database, request.sql, request.timeoutSeconds, request.signal));
+                values = bindPositional(statement.parameterNames, request.parameters);
+            }
+            catch (error) {
+                if (!CamusError.is(error))
+                    throw error;
+                // Either the server would not register the statement, or the caller has not bound every
+                // placeholder it declares. Both run inline: the first because preparing is an
+                // optimization, the second so an unbound parameter is reported by the engine exactly as it
+                // would be for a statement that was never prepared.
+                return send(undefined);
+            }
+            try {
+                return await send({ statementId: statement.statementId, values });
+            }
+            catch (error) {
+                if (attempt > 0 || !CamusError.is(error) || error.code !== CamusErrorCode.UnknownPreparedStatement) {
+                    throw error;
+                }
+                this.prepared.invalidate(key, statement);
+            }
+        }
+    }
+    async close() {
+        // The REST transport holds no socket of its own; the global fetch agent owns the connections.
+    }
+    async post(endpoint, path, body, timeoutSeconds, signal) {
+        return sendJson(this.pool, {
+            endpoint,
+            path,
+            method: 'POST',
+            body,
+            token: await this.token(signal),
+            timeoutSeconds,
+            signal,
+        });
+    }
+    /**
+     * The bearer token to present, if this client has one.
+     *
+     * Every route goes through here, so none can accidentally be built unauthenticated. With no
+     * credentials configured there is no token and no `Authorization` header at all, which is what a
+     * server with authentication off expects.
+     */
+    token(signal) {
+        return this.auth.getToken(signal);
+    }
+}
+function buildQueryBody(request, binding) {
+    const body = binding === undefined
+        ? {
+            databaseName: request.database,
+            sql: request.sql,
+            parameters: parametersToJson(request.parameters),
+        }
+        : {
+            statementId: binding.statementId,
+            positionalParameters: binding.values.map(columnValueToJson),
+        };
+    if (hasTransaction(request)) {
+        body.txnIdPT = request.txnIdPT;
+        body.txnIdCounter = request.txnIdCounter;
+    }
+    if (request.routingAcceptVersion > 0)
+        body.routingAcceptVersion = request.routingAcceptVersion;
+    return body;
+}
+function buildNonQueryBody(request, binding) {
+    const body = buildQueryBody(request, binding);
+    if (!hasTransaction(request) && request.autocommitOptions !== undefined) {
+        Object.assign(body, concurrencyFields(request.autocommitOptions));
+    }
+    return body;
+}
+/** The `isolationLevel`, `transactionMode`, and `locking` fields, omitting every unset knob. */
+function concurrencyFields(options) {
+    const fields = {};
+    if (options.isolationLevel !== undefined)
+        fields.isolationLevel = options.isolationLevel;
+    if (options.mode !== undefined)
+        fields.transactionMode = options.mode;
+    if (options.locking !== undefined)
+        fields.locking = options.locking;
+    return fields;
+}
+function parametersToJson(parameters) {
+    if (parameters === undefined || parameters.size === 0)
+        return undefined;
+    const json = {};
+    for (const [name, value] of parameters)
+        json[name] = columnValueToJson(value);
+    return json;
+}
+function cacheMetadataFromJson(body) {
+    const status = readString(body.cacheStatus);
+    const name = readString(body.cacheName);
+    if (status === undefined && name === undefined)
+        return undefined;
+    let cachedAtHlc;
+    const hlc = body.cachedAtHlc;
+    if (typeof hlc === 'object' && hlc !== null) {
+        const record = hlc;
+        cachedAtHlc = { l: asBigInt(record.l), c: asNumber(record.c) };
+    }
+    return makeCacheMetadata({
+        rawStatus: status,
+        bypassReason: readString(body.cacheBypassReason),
+        name,
+        cachedAtHlc,
+        ageMs: body.ageMs === undefined || body.ageMs === null ? undefined : asNumber(body.ageMs),
+    });
+}
+function readString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+/** Re-exported so a caller that only imports this module can still build an empty result. */
+export const EMPTY_RESULT_SET = CamusResultSet.EMPTY;
+//# sourceMappingURL=rest-transport.js.map

package/dist/transport/rest-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-transport.js","sourceRoot":"","sources":["../../src/transport/rest-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAWtE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA8BhD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACf,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC;IAEtB,IAAI,CAAoB;IAExB,IAAI,CAAqB;IAEzB,QAAQ,GAAG,IAAI,0BAA0B,EAAE,CAAC;IAE7D,YAAY,IAAuB,EAAE,IAAwB;QAC3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,gBAAgB,CACpB,QAAgB,EAChB,QAAgB,EAChB,OAAgC,EAChC,cAAsB,EACtB,MAAoB;QAEpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAC1B,QAAQ,EACR,CAAC,mBAAmB,CAAC,EACrB;YACE,YAAY,EAAE,QAAQ;YACtB,GAAG,iBAAiB,CAAC,OAAO,CAAC;SAC9B,EACD,cAAc,EACd,MAAM,CACP,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC;QACrG,CAAC;QAED,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;YAC/B,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,MAAe,EACf,QAAgB,EAChB,QAAgB,EAChB,OAAe,EACf,YAAoB,EACpB,WAA+B,EAC/B,cAAsB,EACtB,MAAoB;QAEpB,+EAA+E;QAC/E,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB,CAAC;QAEpE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAC1B,QAAQ,EACR,CAAC,IAAI,CAAC,EACN,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,EACjD,cAAc,EACd,MAAM,CACP,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,UAAU,CAClB,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC,OAAO,EACnC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6EAA6E;IAE7E,YAAY,CAAC,OAA4B;QACvC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1F,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,OAA4B,EAC5B,OAAoC;QAEpC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;YAC7C,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,CAAC,mBAAmB,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC;YACtC,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACvC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAElE,IAAI,IAAa,CAAC;QAElB,IAAI,CAAC;YACH,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE,uBAAuB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,MAAM,GAAG,IAA+B,CAAC;QAE/C,OAAO;YACL,SAAS,EAAE,iBAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;YACzD,aAAa,EAAE,qBAAqB,CAAC,MAAM,CAAC;YAC5C,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,OAA4B;QAC7C,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAChG,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,OAA4B,EAC5B,OAAoC;QAEpC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;YAC7C,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,CAAC,0BAA0B,CAAC;YAClC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC;YACtC,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACvC,MAAM,EAAE,mBAAmB;YAC3B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,0FAA0F;QAC1F,8FAA8F;QAC9F,oEAAoE;QACpE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEtF,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE,+CAA+C,CAAC,CAAC;QAChG,CAAC;QAED,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,eAAe,CAAC,OAA4B;QAC1C,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7F,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,OAA4B,EAC5B,OAAoC;QAEpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAC1B,OAAO,CAAC,QAAQ,EAChB,CAAC,uBAAuB,CAAC,EACzB,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,MAAM,CACf,CAAC;QAEF,OAAO;YACL,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,OAAO,EAAE,qBAAqB,CAAC,IAAI,CAAC;SACrC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA+B;QAC1C,MAAM,IAAI,GAA4B;YACpC,YAAY,EAAE,OAAO,CAAC,QAAQ;YAC9B,SAAS,EAAE,OAAO,CAAC,KAAK;YACxB,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC;SACzC,CAAC;QAEF,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAC3B,OAAO,CAAC,QAAQ,EAChB,CAAC,QAAQ,CAAC,EACV,IAAI,EACJ,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,MAAM,CACf,CAAC;QAEF,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA4B;QAC3C,MAAM,IAAI,GAA4B;YACpC,YAAY,EAAE,OAAO,CAAC,QAAQ;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC;QAEF,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC;aAAM,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAC3B,OAAO,CAAC,QAAQ,EAChB,CAAC,iBAAiB,CAAC,EACnB,IAAI,EACJ,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,MAAM,CACf,CAAC;QAEF,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,cAAsB,EAAE,MAAoB;QACvE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAiB,IAAI,CAAC,IAAI,EAAE;YACrD,QAAQ;YACR,IAAI,EAAE,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC/B,cAAc;YACd,MAAM;SACP,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,QAAgB,EAChB,WAAoB,EACpB,cAAsB,EACtB,MAAoB;QAEpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAC1B,QAAQ,EACR,CAAC,WAAW,CAAC,EACb,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,EACvC,cAAc,EACd,MAAM,CACP,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,wBAAwB,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CACxB,QAAgB,EAChB,UAAkB,EAClB,kBAA0B,EAC1B,WAAoB,EACpB,cAAsB,EACtB,MAAoB;QAEpB,MAAM,IAAI,CAAC,QAAQ,CACjB,QAAQ,EACR,uBAAuB,CAAC,UAAU,EAAE,kBAAkB,EAAE,WAAW,CAAC,EACpE,cAAc,EACd,MAAM,CACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,QAAgB,EAChB,QAAgB,EAChB,cAAsB,EACtB,MAAoB;QAEpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAC1B,QAAQ,EACR,CAAC,SAAS,CAAC,EACX,EAAE,YAAY,EAAE,QAAQ,EAAE,EAC1B,cAAc,EACd,MAAM,CACP,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,YAAY,CAChB,QAAgB,EAChB,QAAgB,EAChB,cAAsB,EACtB,MAAoB;QAEpB,OAAO,aAAa,CAClB,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,CAC7F,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,aAAa,CACjB,QAAgB,EAChB,QAAgB,EAChB,cAAsB,EACtB,MAAoB;QAEpB,OAAO,aAAa,CAClB,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,CAC9F,CAAC;IACJ,CAAC;IAED,iEAAiE;IACzD,KAAK,CAAC,QAAQ,CACpB,QAAgB,EAChB,GAAW,EACX,cAAsB,EACtB,MAA+B;QAE/B,MAAM,IAAI,CAAC,UAAU,CAAC;YACpB,QAAQ;YACR,QAAQ,EAAE,EAAE;YACZ,GAAG;YACH,cAAc;YACd,QAAQ,EAAE,KAAK;YACf,oBAAoB,EAAE,CAAC;YACvB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IAChE,KAAK,CAAC,UAAU,CACtB,QAAgB,EAChB,QAAgB,EAChB,GAAW,EACX,cAAsB,EACtB,MAA+B;QAE/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CACxC;YACE,QAAQ;YACR,QAAQ;YACR,GAAG;YACH,cAAc;YACd,QAAQ,EAAE,KAAK;YACf,oBAAoB,EAAE,CAAC;YACvB,MAAM;SACP,EACD,SAAS,CACV,CAAC;QAEF,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,QAAgB,EAChB,GAAW,EACX,cAAsB,EACtB,MAAoB;QAEpB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAC/E,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,CAC/D,CAAC;QAEF,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,QAAgB,EAChB,QAAgB,EAChB,GAAW,EACX,cAAsB,EACtB,MAA+B;QAE/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAC1B,QAAQ,EACR,CAAC,uBAAuB,CAAC,EACzB,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,EAC/B,cAAc,EACd,MAAM,CACP,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5F,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,0BAA0B,CAAC,CAAC;QACxG,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,QAAgB,EAAE,GAAW,EAAE,MAAoB;QACxF,2FAA2F;QAC3F,iEAAiE;QACjE,KAAK,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5F,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CACb,YAAY,EACZ,CAAC,qBAAqB,CAAC,EACvB,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,EACtC,EAAE,EACF,MAAM,CACP,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,0FAA0F;YAC5F,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACK,KAAK,CAAC,YAAY,CACxB,OAA4B,EAC5B,IAA0D;QAE1D,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;QAE9C,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QAEzF,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;YAClC,IAAI,SAAgC,CAAC;YACrC,IAAI,MAAqB,CAAC;YAE1B,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,CACjD,IAAI,CAAC,QAAQ,CACX,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,MAAM,CACf,CACF,CAAC;gBAEF,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;YACxE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;gBAEvC,wFAAwF;gBACxF,8EAA8E;gBAC9E,2FAA2F;gBAC3F,oDAAoD;gBACpD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,wBAAwB,EAAE,CAAC;oBACnG,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,8FAA8F;IAChG,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,QAAgB,EAChB,IAAuB,EACvB,IAAa,EACb,cAAsB,EACtB,MAA+B;QAE/B,OAAO,QAAQ,CAAI,IAAI,CAAC,IAAI,EAAE;YAC5B,QAAQ;YACR,IAAI;YACJ,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC/B,cAAc;YACd,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,MAA+B;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,SAAS,cAAc,CACrB,OAA4B,EAC5B,OAAoC;IAEpC,MAAM,IAAI,GACR,OAAO,KAAK,SAAS;QACnB,CAAC,CAAC;YACE,YAAY,EAAE,OAAO,CAAC,QAAQ;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC;SACjD;QACH,CAAC,CAAC;YACE,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,oBAAoB,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;SAC5D,CAAC;IAER,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,CAAC,oBAAoB,GAAG,CAAC;QAAE,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAE/F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CACxB,OAA4B,EAC5B,OAAoC;IAEpC,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gGAAgG;AAChG,SAAS,iBAAiB,CAAC,OAAgC;IACzD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;QAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IACzF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IACtE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEpE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAwD;IAExD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAExE,MAAM,IAAI,GAAoC,EAAE,CAAC;IAEjD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAE9E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,qBAAqB,CAAC,IAA6B;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExC,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjE,IAAI,WAA0C,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;IAE7B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,WAAW,GAAG,EAAE,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,OAAO,iBAAiB,CAAC;QACvB,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI;QACJ,WAAW;QACX,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;KAC1F,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC,KAAK,CAAC"}

package/dist/transport/transport-pool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+import type { CamusTransport } from './transport.js';
+/**
+ * The transports in use, one per deployment and identity rather than one per client object.
+ *
+ * A transport owns server-side state that outlives the request that created it:
+ * prepared-statement registrations above all, and for gRPC a pool of long-lived streams and their
+ * channels. An application that builds a client per request would otherwise get a fresh
+ * registration cache every time — while the prepare policy, which is shared, reports a hot
+ * statement as already registered. Each new transport would then register that statement again,
+ * and nothing would close the ones it replaced, until the server's per-principal cap refused them
+ * and every statement quietly fell back to inline execution.
+ *
+ * Sharing puts the registration cache on the same lifetime as the decision to prepare, which is
+ * what the policy always assumed: one registration per statement per deployment, evicted by the
+ * policy's own bound.
+ *
+ * A shared transport lives as long as the process. That is bounded by how many distinct
+ * deployments and identities a process talks to, not by how many clients it opens.
+ */
+export declare class CamusTransportPool {
+    private static readonly shared;
+    /** The transport for a key, built once per process. */
+    static forKey(key: string, factory: () => CamusTransport): CamusTransport;
+    /**
+     * Closes every shared transport and drops them.
+     *
+     * Call it when a process is shutting down and wants its gRPC channels released promptly. A later
+     * client rebuilds whatever it needs, so this is never required for correctness.
+     */
+    static closeAll(): Promise<void>;
+    /** @internal Test hook: drops every shared transport without closing it. */
+    static resetShared(): void;
+}
+//# sourceMappingURL=transport-pool.d.ts.map

package/dist/transport/transport-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-pool.d.ts","sourceRoot":"","sources":["../../src/transport/transport-pool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAEtE,uDAAuD;IACvD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,GAAG,cAAc;IAIzE;;;;;OAKG;WACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtC,4EAA4E;IAC5E,MAAM,CAAC,WAAW,IAAI,IAAI;CAG3B"}

package/dist/transport/transport-pool.js

@@ -0,0 +1,48 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+import { SharedRegistry } from '../shared-registry.js';
+/**
+ * The transports in use, one per deployment and identity rather than one per client object.
+ *
+ * A transport owns server-side state that outlives the request that created it:
+ * prepared-statement registrations above all, and for gRPC a pool of long-lived streams and their
+ * channels. An application that builds a client per request would otherwise get a fresh
+ * registration cache every time — while the prepare policy, which is shared, reports a hot
+ * statement as already registered. Each new transport would then register that statement again,
+ * and nothing would close the ones it replaced, until the server's per-principal cap refused them
+ * and every statement quietly fell back to inline execution.
+ *
+ * Sharing puts the registration cache on the same lifetime as the decision to prepare, which is
+ * what the policy always assumed: one registration per statement per deployment, evicted by the
+ * policy's own bound.
+ *
+ * A shared transport lives as long as the process. That is bounded by how many distinct
+ * deployments and identities a process talks to, not by how many clients it opens.
+ */
+export class CamusTransportPool {
+    static shared = new SharedRegistry();
+    /** The transport for a key, built once per process. */
+    static forKey(key, factory) {
+        return CamusTransportPool.shared.get(key, factory);
+    }
+    /**
+     * Closes every shared transport and drops them.
+     *
+     * Call it when a process is shutting down and wants its gRPC channels released promptly. A later
+     * client rebuilds whatever it needs, so this is never required for correctness.
+     */
+    static async closeAll() {
+        const transports = [...CamusTransportPool.shared.values()];
+        CamusTransportPool.shared.clear();
+        await Promise.allSettled(transports.map((transport) => transport.close()));
+    }
+    /** @internal Test hook: drops every shared transport without closing it. */
+    static resetShared() {
+        CamusTransportPool.shared.clear();
+    }
+}
+//# sourceMappingURL=transport-pool.js.map

package/dist/transport/transport-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-pool.js","sourceRoot":"","sources":["../../src/transport/transport-pool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAU,MAAM,GAAG,IAAI,cAAc,EAAkB,CAAC;IAEtE,uDAAuD;IACvD,MAAM,CAAC,MAAM,CAAC,GAAW,EAAE,OAA6B;QACtD,OAAO,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ;QACnB,MAAM,UAAU,GAAG,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAE3D,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAElC,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,WAAW;QAChB,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC"}