camusdb 0.1.0

package/dist/transport/http.js.map

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

package/dist/transport/ndjson-row-source.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 { ColumnType } from '../column-type.js';
+import type { ColumnValue } from '../column-value.js';
+import type { CamusRowSource } from '../row-source.js';
+/** The content type the streaming query endpoint serves and expects in `Accept`. */
+export declare const NDJSON_CONTENT_TYPE = "application/x-ndjson";
+/**
+ * Rows pulled off the network one line at a time.
+ *
+ * The streaming query endpoint writes newline-delimited JSON: one header object naming the output
+ * columns, then one array per row, then one trailer object. So a result of many thousands of rows
+ * never fully materializes on this side — the caller advances, and one more line is read.
+ *
+ * The trailer is what makes the framing more than a convenience. A conflict that surfaces after
+ * the first row has already been sent cannot be reported as an HTTP status, because the status
+ * line is long gone. The server reports it in the trailer instead, and this source raises it from
+ * the read that reaches it.
+ */
+export declare class NdjsonRowSource implements CamusRowSource {
+    readonly columnNames: readonly string[];
+    readonly columnTypes: readonly ColumnType[];
+    readonly recordsAffected = -1;
+    private readonly lines;
+    private finished;
+    private closed;
+    private constructor();
+    /** Reads the header line and reports a source positioned before the first row. */
+    static create(body: ReadableStream<Uint8Array>): Promise<NdjsonRowSource>;
+    next(): Promise<readonly ColumnValue[] | undefined>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=ndjson-row-source.d.ts.map

package/dist/transport/ndjson-row-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson-row-source.d.ts","sourceRoot":"","sources":["../../src/transport/ndjson-row-source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAE5C,QAAQ,CAAC,eAAe,MAAM;IAE9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;IAMP,kFAAkF;WACrE,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAuDzE,IAAI,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,GAAG,SAAS,CAAC;IAkCnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/transport/ndjson-row-source.js

@@ -0,0 +1,197 @@
+/**
+ * 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 { NULL_VALUE } from '../column-value.js';
+import { CamusError } from '../errors.js';
+import { CamusErrorCode } from '../error-codes.js';
+import { parseLossless } from '../json.js';
+import { sanitizeErrorText } from './error-text.js';
+import { decodeCell, readSchema } from './rest-decode.js';
+/** The content type the streaming query endpoint serves and expects in `Accept`. */
+export const NDJSON_CONTENT_TYPE = 'application/x-ndjson';
+/**
+ * Rows pulled off the network one line at a time.
+ *
+ * The streaming query endpoint writes newline-delimited JSON: one header object naming the output
+ * columns, then one array per row, then one trailer object. So a result of many thousands of rows
+ * never fully materializes on this side — the caller advances, and one more line is read.
+ *
+ * The trailer is what makes the framing more than a convenience. A conflict that surfaces after
+ * the first row has already been sent cannot be reported as an HTTP status, because the status
+ * line is long gone. The server reports it in the trailer instead, and this source raises it from
+ * the read that reaches it.
+ */
+export class NdjsonRowSource {
+    columnNames;
+    columnTypes;
+    recordsAffected = -1;
+    lines;
+    finished = false;
+    closed = false;
+    constructor(lines, names, types) {
+        this.lines = lines;
+        this.columnNames = names;
+        this.columnTypes = types;
+    }
+    /** Reads the header line and reports a source positioned before the first row. */
+    static async create(body) {
+        const lines = new LineReader(body);
+        let header;
+        try {
+            header = await readNonEmptyLine(lines);
+        }
+        catch (error) {
+            await lines.close();
+            throw error;
+        }
+        if (header === undefined) {
+            await lines.close();
+            throw new CamusError(CamusErrorCode.Generic, 'The streaming query response ended before its schema header.');
+        }
+        let parsed;
+        try {
+            parsed = parseLossless(header);
+        }
+        catch (error) {
+            await lines.close();
+            throw new CamusError(CamusErrorCode.Generic, 'The streaming query response did not start with a schema header.', { cause: error });
+        }
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            await lines.close();
+            throw new CamusError(CamusErrorCode.Generic, 'The streaming query response did not start with a schema header.');
+        }
+        try {
+            // A header can already carry a failure. The server writes it before pulling rows, so this is
+            // rare, but it is the one place such a failure can appear.
+            throwIfFailed(parsed);
+        }
+        catch (error) {
+            await lines.close();
+            throw error;
+        }
+        const { names, types } = readSchema(parsed.columns);
+        return new NdjsonRowSource(lines, names, types);
+    }
+    async next() {
+        if (this.finished)
+            return undefined;
+        const line = await readNonEmptyLine(this.lines);
+        if (line === undefined) {
+            this.finished = true;
+            return undefined;
+        }
+        const parsed = parseLossless(line);
+        if (Array.isArray(parsed)) {
+            const cells = new Array(this.columnTypes.length).fill(NULL_VALUE);
+            const limit = Math.min(cells.length, parsed.length);
+            for (let c = 0; c < limit; c++) {
+                cells[c] = decodeCell(parsed[c], this.columnTypes[c]);
+            }
+            return cells;
+        }
+        // An object is the trailer. It is the terminal line, and a failed status on it is an error
+        // reported in band.
+        this.finished = true;
+        if (typeof parsed === 'object' && parsed !== null) {
+            throwIfFailed(parsed);
+        }
+        return undefined;
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.finished = true;
+        await this.lines.close();
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+}
+/**
+ * The server writes exactly one record per line, but a blank line is skipped so stray framing
+ * never reads as an early end of stream.
+ */
+async function readNonEmptyLine(lines) {
+    for (;;) {
+        const line = await lines.read();
+        if (line === undefined)
+            return undefined;
+        if (line.trim().length > 0)
+            return line;
+    }
+}
+function throwIfFailed(meta) {
+    if (meta.status !== 'failed')
+        return;
+    const code = typeof meta.code === 'string' ? meta.code : CamusErrorCode.Generic;
+    const message = typeof meta.message === 'string' ? meta.message : '';
+    throw new CamusError(code, sanitizeErrorText(message));
+}
+/**
+ * Splits a byte stream into newline-terminated strings.
+ *
+ * A JSON line can be split across any number of network reads, so the tail of an incomplete line
+ * is held and the search for the next newline resumes where the last one stopped. Without that
+ * resume point, a line of N bytes arriving in fragments would be rescanned from its start on every
+ * read, which is what short reads from a network stream produce routinely.
+ */
+class LineReader {
+    reader;
+    decoder = new TextDecoder('utf-8');
+    buffer = '';
+    searched = 0;
+    eof = false;
+    closed = false;
+    constructor(stream) {
+        this.reader = stream.getReader();
+    }
+    /** The next line without its terminator, or `undefined` at the end of the stream. */
+    async read() {
+        for (;;) {
+            const newline = this.buffer.indexOf('\n', this.searched);
+            if (newline >= 0) {
+                const line = this.buffer.slice(0, newline);
+                this.buffer = this.buffer.slice(newline + 1);
+                this.searched = 0;
+                return line.endsWith('\r') ? line.slice(0, -1) : line;
+            }
+            // Everything held has now been examined; the next search resumes at what the next read adds.
+            this.searched = this.buffer.length;
+            if (this.eof)
+                return this.takeRemainder();
+            const { done, value } = await this.reader.read();
+            if (done) {
+                this.eof = true;
+                this.buffer += this.decoder.decode();
+                continue;
+            }
+            this.buffer += this.decoder.decode(value, { stream: true });
+        }
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            await this.reader.cancel();
+        }
+        catch {
+            // The stream is already gone. Nothing is left to release.
+        }
+        this.reader.releaseLock();
+    }
+    /** The unterminated tail after the last newline, taken once at the end of the stream. */
+    takeRemainder() {
+        if (this.buffer.length === 0)
+            return undefined;
+        const line = this.buffer;
+        this.buffer = '';
+        this.searched = 0;
+        return line.endsWith('\r') ? line.slice(0, -1) : line;
+    }
+}
+//# sourceMappingURL=ndjson-row-source.js.map

package/dist/transport/ndjson-row-source.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * 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 { ColumnType } from '../column-type.js';
+import type { ColumnValue } from '../column-value.js';
+import { CamusResultSet } from '../result-set.js';
+/**
+ * Decodes the compact-raw wire form of a query result.
+ *
+ * The response carries an authoritative `columns` schema plus positional `rows`, where each row is
+ * a JSON array aligned to `columns`. Decoding from the schema, rather than by looking at the first
+ * row, is what lets a result with no rows still report its column count, names, and types.
+ */
+export declare function resultSetFromWire(columns: unknown, rows: unknown): CamusResultSet;
+/** The output column names and declared types of a response's `columns` element. */
+export declare function readSchema(columns: unknown): {
+    names: string[];
+    types: ColumnType[];
+};
+/**
+ * Decodes one positional cell against its declared type.
+ *
+ * A JSON `null` is the null value for every column type. The types that arrive as a string or an
+ * array — `Id`, `Bytes`, `Date`, `DateTime`, `Uuid`, `Array` — rely on the declared type being
+ * exact, which it always is for a real column reference. A scalar that arrives as a JSON-native
+ * value is read by its token instead, so an over-broad inferred type on an expression column — a
+ * numeric projection reported as a string, say — still round-trips.
+ */
+export declare function decodeCell(cell: unknown, declared: ColumnType): ColumnValue;
+//# sourceMappingURL=rest-decode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest-decode.d.ts","sourceRoot":"","sources":["../../src/transport/rest-decode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAgB,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,CA0BjF;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAgBrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,WAAW,CAgC3E"}

package/dist/transport/rest-decode.js

@@ -0,0 +1,162 @@
+/**
+ * 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 { ColumnType, isColumnType } from '../column-type.js';
+import { NULL_VALUE } from '../column-value.js';
+import { asBigInt, asNumber } from '../json.js';
+import { CamusResultSet } from '../result-set.js';
+/**
+ * Decodes the compact-raw wire form of a query result.
+ *
+ * The response carries an authoritative `columns` schema plus positional `rows`, where each row is
+ * a JSON array aligned to `columns`. Decoding from the schema, rather than by looking at the first
+ * row, is what lets a result with no rows still report its column count, names, and types.
+ */
+export function resultSetFromWire(columns, rows) {
+    const { names, types } = readSchema(columns);
+    if (!Array.isArray(rows) || names.length === 0) {
+        return new CamusResultSet(names, types, [], 0);
+    }
+    const columnCount = names.length;
+    const rowCount = rows.length;
+    const cells = new Array(rowCount * columnCount).fill(NULL_VALUE);
+    for (let r = 0; r < rowCount; r++) {
+        const row = rows[r];
+        if (!Array.isArray(row))
+            continue;
+        const base = r * columnCount;
+        const limit = Math.min(columnCount, row.length);
+        for (let c = 0; c < limit; c++) {
+            cells[base + c] = decodeCell(row[c], types[c]);
+        }
+        // Any position the row omitted keeps the null the array was filled with.
+    }
+    return new CamusResultSet(names, types, cells, rowCount);
+}
+/** The output column names and declared types of a response's `columns` element. */
+export function readSchema(columns) {
+    if (!Array.isArray(columns))
+        return { names: [], types: [] };
+    const names = new Array(columns.length);
+    const types = new Array(columns.length);
+    for (let i = 0; i < columns.length; i++) {
+        const column = columns[i];
+        names[i] = typeof column?.name === 'string' ? column.name : '';
+        const type = asNumber(column?.type, ColumnType.Null);
+        types[i] = isColumnType(type) ? type : ColumnType.Null;
+    }
+    return { names, types };
+}
+/**
+ * Decodes one positional cell against its declared type.
+ *
+ * A JSON `null` is the null value for every column type. The types that arrive as a string or an
+ * array — `Id`, `Bytes`, `Date`, `DateTime`, `Uuid`, `Array` — rely on the declared type being
+ * exact, which it always is for a real column reference. A scalar that arrives as a JSON-native
+ * value is read by its token instead, so an over-broad inferred type on an expression column — a
+ * numeric projection reported as a string, say — still round-trips.
+ */
+export function decodeCell(cell, declared) {
+    if (cell === null || cell === undefined)
+        return NULL_VALUE;
+    switch (declared) {
+        case ColumnType.Id:
+            return { type: ColumnType.Id, strValue: typeof cell === 'string' ? cell : stringifyScalar(cell) };
+        case ColumnType.Bytes:
+            return { type: ColumnType.Bytes, bytesValue: decodeBase64(cell) };
+        case ColumnType.Date:
+            return { type: ColumnType.Date, longValue: asBigInt(cell) };
+        case ColumnType.DateTime:
+            return { type: ColumnType.DateTime, longValue: asBigInt(cell) };
+        case ColumnType.Uuid:
+            return decodeUuidCell(cell);
+        case ColumnType.Array:
+            return decodeArrayCell(cell);
+        default:
+            // A defensive recovery for a gap in the server's type inference: a join projection can
+            // report a uuid column's type as a string while still sending the two-int64 wire form. A
+            // scalar cell never legitimately arrives as a JSON array, so a two-element array here is
+            // that mis-tagged UUID. Decode it structurally rather than trusting the declared type and
+            // dropping the value.
+            if (Array.isArray(cell) && cell.length === 2)
+                return decodeUuidCell(cell);
+            return decodeScalarByToken(cell, declared);
+    }
+}
+/** A `uuid` is wired as `[high, low]`, two big-endian 64-bit halves. A string is accepted too. */
+function decodeUuidCell(cell) {
+    if (Array.isArray(cell) && cell.length === 2) {
+        return {
+            type: ColumnType.Uuid,
+            uuidHigh: asBigInt(cell[0]),
+            longValue: asBigInt(cell[1]),
+        };
+    }
+    if (typeof cell === 'string')
+        return { type: ColumnType.Uuid, uuidValue: cell };
+    return NULL_VALUE;
+}
+/**
+ * Decodes an array cell.
+ *
+ * The wire schema carries no per-element type for an array, so element types are read from the
+ * JSON token. That is exact for every element type JSON has a token for. An element type that is
+ * itself string-encoded or array-encoded — a uuid, a date, or bytes inside an array — is not
+ * reconstructed, and reaches the caller as the string or number the token held.
+ */
+function decodeArrayCell(cell) {
+    if (!Array.isArray(cell))
+        return NULL_VALUE;
+    const values = new Array(cell.length);
+    let elementType = ColumnType.Null;
+    for (let i = 0; i < cell.length; i++) {
+        const decoded = decodeScalarByToken(cell[i], ColumnType.Null);
+        if (decoded.type !== ColumnType.Null)
+            elementType = decoded.type;
+        values[i] = decoded;
+    }
+    return { type: ColumnType.Array, arrayValues: values, arrayElementType: elementType };
+}
+function decodeScalarByToken(cell, declared) {
+    switch (typeof cell) {
+        case 'string':
+            return { type: ColumnType.String, strValue: cell };
+        case 'boolean':
+            return { type: ColumnType.Bool, boolValue: cell };
+        case 'bigint':
+            return { type: ColumnType.Integer64, longValue: cell };
+        case 'number':
+            if (declared === ColumnType.Float64 || declared === ColumnType.Float32) {
+                return { type: declared, floatValue: cell };
+            }
+            return Number.isInteger(cell)
+                ? { type: ColumnType.Integer64, longValue: BigInt(cell) }
+                : { type: ColumnType.Float64, floatValue: cell };
+        default:
+            return NULL_VALUE;
+    }
+}
+/**
+ * An `id` cell that did not arrive as a string. The server always sends one as text, so this is a
+ * defence against a malformed reply rather than a path a healthy server takes.
+ */
+function stringifyScalar(cell) {
+    switch (typeof cell) {
+        case 'number':
+        case 'bigint':
+        case 'boolean':
+            return String(cell);
+        default:
+            return '';
+    }
+}
+function decodeBase64(cell) {
+    if (typeof cell !== 'string')
+        return new Uint8Array(0);
+    const buffer = Buffer.from(cell, 'base64');
+    return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+}
+//# sourceMappingURL=rest-decode.js.map

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * 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.
+ */
+/** A statement the server registered over REST: its handle and its binding order. */
+export interface RestPreparedStatement {
+    readonly statementId: string;
+    readonly parameterNames: readonly string[];
+}
+interface CacheKey {
+    readonly endpoint: string;
+    readonly database: string;
+    readonly sql: string;
+}
+/**
+ * The prepared-statement handles this transport holds, keyed by endpoint, database, and SQL.
+ *
+ * A REST handle is node-local: the node that minted it is the only one that knows it. So the
+ * endpoint is part of the key, and a statement registered on three nodes has three entries.
+ *
+ * A registration in flight is stored as its promise, so concurrent first calls for the same
+ * statement share one registration instead of racing to register it three times. Its result is
+ * stored beside the promise once it arrives, so a caller that must drop a dead handle can do it
+ * before its own next lookup — reading the promise instead would defer the drop by a microtask,
+ * and the retry would then find and re-send the very handle it had just discarded.
+ *
+ * A registration that fails is dropped, so the next call tries again rather than inheriting a
+ * poisoned entry forever.
+ */
+export declare class RestPreparedStatementCache {
+    private readonly statements;
+    /** The registration for a statement, starting one when there is none. */
+    getOrAdd(key: CacheKey, register: () => Promise<RestPreparedStatement>): Promise<RestPreparedStatement>;
+    /** Drops a registration the server no longer honours, but only if it is still the current one. */
+    invalidate(key: CacheKey, stale: RestPreparedStatement): void;
+    /**
+     * Removes and reports every node's registration of one statement, so the caller can release each
+     * handle on the node that minted it. A statement is closed everywhere it was registered, not
+     * only where the caller happens to be sending.
+     */
+    take(database: string, sql: string): Promise<{
+        endpoint: string;
+        statement: RestPreparedStatement;
+    }[]>;
+    private remove;
+}
+export {};
+//# sourceMappingURL=rest-prepared-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest-prepared-cache.d.ts","sourceRoot":"","sources":["../../src/transport/rest-prepared-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,UAAU,QAAQ;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AASD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD,yEAAyE;IACnE,QAAQ,CACZ,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,GAC7C,OAAO,CAAC,qBAAqB,CAAC;IAkCjC,kGAAkG;IAClG,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAO7D;;;;OAIG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,qBAAqB,CAAA;KAAE,EAAE,CAAC;IAoBpE,OAAO,CAAC,MAAM;CAGf"}

package/dist/transport/rest-prepared-cache.js

@@ -0,0 +1,101 @@
+/**
+ * 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.
+ */
+/**
+ * The prepared-statement handles this transport holds, keyed by endpoint, database, and SQL.
+ *
+ * A REST handle is node-local: the node that minted it is the only one that knows it. So the
+ * endpoint is part of the key, and a statement registered on three nodes has three entries.
+ *
+ * A registration in flight is stored as its promise, so concurrent first calls for the same
+ * statement share one registration instead of racing to register it three times. Its result is
+ * stored beside the promise once it arrives, so a caller that must drop a dead handle can do it
+ * before its own next lookup — reading the promise instead would defer the drop by a microtask,
+ * and the retry would then find and re-send the very handle it had just discarded.
+ *
+ * A registration that fails is dropped, so the next call tries again rather than inheriting a
+ * poisoned entry forever.
+ */
+export class RestPreparedStatementCache {
+    statements = new Map();
+    /** The registration for a statement, starting one when there is none. */
+    async getOrAdd(key, register) {
+        const cacheKey = keyOf(key);
+        for (;;) {
+            const existing = this.statements.get(cacheKey);
+            if (existing !== undefined) {
+                try {
+                    return await existing.pending;
+                }
+                catch {
+                    // Whoever started it already reported the failure to its own caller. Drop the poisoned
+                    // entry and take a fresh turn rather than failing every later execution.
+                    this.remove(cacheKey, existing);
+                    continue;
+                }
+            }
+            const pending = register();
+            const entry = { pending, resolved: undefined };
+            this.statements.set(cacheKey, entry);
+            try {
+                const statement = await pending;
+                entry.resolved = statement;
+                return statement;
+            }
+            catch (error) {
+                this.remove(cacheKey, entry);
+                throw error;
+            }
+        }
+    }
+    /** Drops a registration the server no longer honours, but only if it is still the current one. */
+    invalidate(key, stale) {
+        const cacheKey = keyOf(key);
+        const existing = this.statements.get(cacheKey);
+        if (existing?.resolved === stale)
+            this.remove(cacheKey, existing);
+    }
+    /**
+     * Removes and reports every node's registration of one statement, so the caller can release each
+     * handle on the node that minted it. A statement is closed everywhere it was registered, not
+     * only where the caller happens to be sending.
+     */
+    async take(database, sql) {
+        const taken = [];
+        for (const [cacheKey, entry] of [...this.statements]) {
+            const parsed = parseKey(cacheKey);
+            if (parsed.database !== database || parsed.sql !== sql)
+                continue;
+            this.statements.delete(cacheKey);
+            try {
+                taken.push({ endpoint: parsed.endpoint, statement: await entry.pending });
+            }
+            catch {
+                // A registration that never succeeded has no handle to release.
+            }
+        }
+        return taken;
+    }
+    remove(cacheKey, expected) {
+        if (this.statements.get(cacheKey) === expected)
+            this.statements.delete(cacheKey);
+    }
+}
+// A newline cannot appear in an endpoint URL or a database name, so it separates the three parts
+// without ambiguity — and the parts stay recoverable, which `take` needs.
+function keyOf(key) {
+    return `${key.endpoint}\n${key.database}\n${key.sql}`;
+}
+function parseKey(cacheKey) {
+    const firstBreak = cacheKey.indexOf('\n');
+    const secondBreak = cacheKey.indexOf('\n', firstBreak + 1);
+    return {
+        endpoint: cacheKey.slice(0, firstBreak),
+        database: cacheKey.slice(firstBreak + 1, secondBreak),
+        sql: cacheKey.slice(secondBreak + 1),
+    };
+}
+//# sourceMappingURL=rest-prepared-cache.js.map

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

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