camusdb 0.1.0

package/dist/json.js

@@ -0,0 +1,345 @@
+/**
+ * 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 JSON reader and writer that keeps 64-bit integers exact.
+ *
+ * CamusDB is a 64-bit database. An `int64` column, a transaction's physical-time component, and a
+ * date's tick count all reach the wire as JSON numbers whose value can exceed 2^53, which is where
+ * a JavaScript number stops being able to name every integer. `JSON.parse` would round such a
+ * value silently, and `JSON.stringify` refuses a `bigint` outright. Both are unacceptable in a
+ * driver: a row must come back holding what was written.
+ *
+ * So this module reads an integer that does not fit a `number` as a `bigint`, and writes a
+ * `bigint` as the bare digits a JSON number is. Everything else behaves exactly as the built-in
+ * functions do.
+ */
+/**
+ * Parses JSON text, reading an integer outside the safe range as a `bigint`.
+ *
+ * The common reply holds no such integer, and the built-in parser is far faster than any parser
+ * written in JavaScript. So the text is first tested for a run of 16 or more digits — the shortest
+ * run that can leave the safe range. Without one the built-in parser is exact and is used. A run
+ * inside a string literal costs nothing but a slower parse of that one reply.
+ */
+export function parseLossless(text) {
+    return LONG_INTEGER.test(text) ? new LosslessParser(text).parse() : JSON.parse(text);
+}
+const LONG_INTEGER = /\d{16,}/;
+/**
+ * Serializes a value as JSON, writing a `bigint` as a JSON number.
+ *
+ * `undefined`, a function, and a symbol are omitted from an object and become `null` in an array,
+ * which is what `JSON.stringify` does. A value with a `toJSON` method is replaced by its result,
+ * also as `JSON.stringify` does.
+ */
+export function stringifyLossless(value) {
+    const out = [];
+    writeValue(value, out, 0);
+    return out.join('');
+}
+const MAX_DEPTH = 200;
+function writeValue(value, out, depth) {
+    if (depth > MAX_DEPTH) {
+        throw new TypeError('Cannot serialize a value nested more than 200 levels deep.');
+    }
+    if (value === null) {
+        out.push('null');
+        return;
+    }
+    switch (typeof value) {
+        case 'bigint':
+            out.push(value.toString());
+            return;
+        case 'number':
+            out.push(Number.isFinite(value) ? String(value) : 'null');
+            return;
+        case 'boolean':
+            out.push(value ? 'true' : 'false');
+            return;
+        case 'string':
+            out.push(quote(value));
+            return;
+        case 'object':
+            break;
+        default:
+            out.push('null');
+            return;
+    }
+    const object = value;
+    if (typeof object.toJSON === 'function') {
+        writeValue(object.toJSON(), out, depth + 1);
+        return;
+    }
+    if (Array.isArray(value)) {
+        out.push('[');
+        for (let i = 0; i < value.length; i++) {
+            if (i > 0)
+                out.push(',');
+            const item = value[i];
+            if (isOmitted(item))
+                out.push('null');
+            else
+                writeValue(item, out, depth + 1);
+        }
+        out.push(']');
+        return;
+    }
+    if (value instanceof Map) {
+        writeEntries(value.entries(), out, depth);
+        return;
+    }
+    writeEntries(Object.entries(value).values(), out, depth);
+}
+function writeEntries(entries, out, depth) {
+    out.push('{');
+    let first = true;
+    for (const [key, entryValue] of entries) {
+        if (isOmitted(entryValue))
+            continue;
+        if (typeof key !== 'string')
+            continue;
+        if (!first)
+            out.push(',');
+        first = false;
+        out.push(quote(key), ':');
+        writeValue(entryValue, out, depth + 1);
+    }
+    out.push('}');
+}
+function isOmitted(value) {
+    return value === undefined || typeof value === 'function' || typeof value === 'symbol';
+}
+const ESCAPES = {
+    '"': '\\"',
+    '\\': '\\\\',
+    '\b': '\\b',
+    '\f': '\\f',
+    '\n': '\\n',
+    '\r': '\\r',
+    '\t': '\\t',
+};
+// eslint-disable-next-line no-control-regex -- JSON requires these characters to be escaped.
+const NEEDS_ESCAPE = /["\\\u0000-\u001f\u007f-\u009f]/;
+// eslint-disable-next-line no-control-regex -- JSON requires these characters to be escaped.
+const ESCAPE_ALL = /["\\\u0000-\u001f\u007f-\u009f]/g;
+function quote(value) {
+    if (!NEEDS_ESCAPE.test(value))
+        return `"${value}"`;
+    return `"${value.replace(ESCAPE_ALL, (character) => {
+        const escape = ESCAPES[character];
+        if (escape !== undefined)
+            return escape;
+        return `\\u${character.charCodeAt(0).toString(16).padStart(4, '0')}`;
+    })}"`;
+}
+const MIN_SAFE = BigInt(Number.MIN_SAFE_INTEGER);
+const MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
+/** A recursive-descent JSON reader. It is used only for text that holds a long integer run. */
+class LosslessParser {
+    text;
+    position = 0;
+    constructor(text) {
+        this.text = text;
+    }
+    parse() {
+        this.skipWhitespace();
+        const value = this.readValue(0);
+        this.skipWhitespace();
+        if (this.position < this.text.length) {
+            throw new SyntaxError(`Unexpected text after the JSON value at position ${String(this.position)}.`);
+        }
+        return value;
+    }
+    readValue(depth) {
+        if (depth > MAX_DEPTH) {
+            throw new SyntaxError('The JSON value is nested more than 200 levels deep.');
+        }
+        const character = this.text[this.position];
+        switch (character) {
+            case '{':
+                return this.readObject(depth);
+            case '[':
+                return this.readArray(depth);
+            case '"':
+                return this.readString();
+            case 't':
+                return this.readLiteral('true', true);
+            case 'f':
+                return this.readLiteral('false', false);
+            case 'n':
+                return this.readLiteral('null', null);
+            default:
+                return this.readNumber();
+        }
+    }
+    readObject(depth) {
+        const object = {};
+        this.position++; // past '{'
+        this.skipWhitespace();
+        if (this.text[this.position] === '}') {
+            this.position++;
+            return object;
+        }
+        for (;;) {
+            this.skipWhitespace();
+            if (this.text[this.position] !== '"') {
+                throw new SyntaxError(`Expected a property name at position ${String(this.position)}.`);
+            }
+            const key = this.readString();
+            this.skipWhitespace();
+            this.expect(':');
+            this.skipWhitespace();
+            const value = this.readValue(depth + 1);
+            // A prototype-polluting key is stored as an own property rather than assigned through the
+            // prototype chain, so hostile JSON cannot reach Object.prototype.
+            Object.defineProperty(object, key, { value, writable: true, enumerable: true, configurable: true });
+            this.skipWhitespace();
+            if (this.text[this.position] === ',') {
+                this.position++;
+                continue;
+            }
+            this.expect('}');
+            return object;
+        }
+    }
+    readArray(depth) {
+        const array = [];
+        this.position++; // past '['
+        this.skipWhitespace();
+        if (this.text[this.position] === ']') {
+            this.position++;
+            return array;
+        }
+        for (;;) {
+            this.skipWhitespace();
+            array.push(this.readValue(depth + 1));
+            this.skipWhitespace();
+            if (this.text[this.position] === ',') {
+                this.position++;
+                continue;
+            }
+            this.expect(']');
+            return array;
+        }
+    }
+    readString() {
+        const start = this.position;
+        this.position++; // past the opening quote
+        // A string with no escape is the common case; slice it out whole.
+        let hasEscape = false;
+        while (this.position < this.text.length) {
+            const character = this.text[this.position];
+            if (character === '\\') {
+                hasEscape = true;
+                this.position += 2;
+                continue;
+            }
+            if (character === '"') {
+                const raw = this.text.slice(start, this.position + 1);
+                this.position++;
+                return hasEscape ? JSON.parse(raw) : raw.slice(1, -1);
+            }
+            this.position++;
+        }
+        throw new SyntaxError(`Unterminated string starting at position ${String(start)}.`);
+    }
+    readNumber() {
+        const start = this.position;
+        if (this.text[this.position] === '-')
+            this.position++;
+        while (isDigit(this.text[this.position]))
+            this.position++;
+        let isInteger = true;
+        if (this.text[this.position] === '.') {
+            isInteger = false;
+            this.position++;
+            while (isDigit(this.text[this.position]))
+                this.position++;
+        }
+        const exponent = this.text[this.position];
+        if (exponent === 'e' || exponent === 'E') {
+            isInteger = false;
+            this.position++;
+            const sign = this.text[this.position];
+            if (sign === '+' || sign === '-')
+                this.position++;
+            while (isDigit(this.text[this.position]))
+                this.position++;
+        }
+        const raw = this.text.slice(start, this.position);
+        if (raw.length === 0 || raw === '-') {
+            throw new SyntaxError(`Expected a value at position ${String(start)}.`);
+        }
+        if (!isInteger)
+            return Number(raw);
+        const asNumber = Number(raw);
+        if (Number.isSafeInteger(asNumber))
+            return asNumber;
+        const asBigInt = BigInt(raw);
+        return asBigInt >= MIN_SAFE && asBigInt <= MAX_SAFE ? Number(asBigInt) : asBigInt;
+    }
+    readLiteral(literal, value) {
+        if (!this.text.startsWith(literal, this.position)) {
+            throw new SyntaxError(`Expected '${literal}' at position ${String(this.position)}.`);
+        }
+        this.position += literal.length;
+        return value;
+    }
+    expect(character) {
+        if (this.text[this.position] !== character) {
+            throw new SyntaxError(`Expected '${character}' at position ${String(this.position)}.`);
+        }
+        this.position++;
+    }
+    skipWhitespace() {
+        while (this.position < this.text.length) {
+            const character = this.text[this.position];
+            if (character === ' ' || character === '\n' || character === '\r' || character === '\t') {
+                this.position++;
+                continue;
+            }
+            return;
+        }
+    }
+}
+function isDigit(character) {
+    return character !== undefined && character >= '0' && character <= '9';
+}
+/** Reads a value that may have arrived as a number, a bigint, or a numeric string. */
+export function asBigInt(value, fallback = 0n) {
+    switch (typeof value) {
+        case 'bigint':
+            return value;
+        case 'number':
+            return Number.isFinite(value) ? BigInt(Math.trunc(value)) : fallback;
+        case 'string':
+            try {
+                return BigInt(value);
+            }
+            catch {
+                return fallback;
+            }
+        default:
+            return fallback;
+    }
+}
+/** Reads a value that may have arrived as a number or a bigint, as a `number`. */
+export function asNumber(value, fallback = 0) {
+    switch (typeof value) {
+        case 'number':
+            return Number.isFinite(value) ? value : fallback;
+        case 'bigint':
+            return Number(value);
+        case 'string': {
+            const parsed = Number(value);
+            return Number.isFinite(parsed) ? parsed : fallback;
+        }
+        default:
+            return fallback;
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;GAYG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;AACpG,CAAC;AAED,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,SAAS,UAAU,CAAC,KAAc,EAAE,GAAa,EAAE,KAAa;IAC9D,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC,4DAA4D,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjB,OAAO;IACT,CAAC;IAED,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC3B,OAAO;QAET,KAAK,QAAQ;YACX,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC1D,OAAO;QAET,KAAK,SAAS;YACZ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO;QAET,KAAK,QAAQ;YACX,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACvB,OAAO;QAET,KAAK,QAAQ;YACX,MAAM;QAER;YACE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjB,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,KAAmC,CAAC;IAEnD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAY,CAAC;YACjC,IAAI,SAAS,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;gBACjC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACd,OAAO;IACT,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,YAAY,CAAC,KAAK,CAAC,OAAO,EAA0C,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAClF,OAAO;IACT,CAAC;IAED,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,YAAY,CAAC,OAA6C,EAAE,GAAa,EAAE,KAAa;IAC/F,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,IAAI,CAAC;IAEjB,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,IAAI,SAAS,CAAC,UAAU,CAAC;YAAE,SAAS;QACpC,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QAEtC,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,KAAK,GAAG,KAAK,CAAC;QAEd,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1B,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACzF,CAAC;AAED,MAAM,OAAO,GAA2B;IACtC,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,6FAA6F;AAC7F,MAAM,YAAY,GAAG,iCAAiC,CAAC;AAEvD,6FAA6F;AAC7F,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAEtD,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,GAAG,CAAC;IAEnD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAExC,OAAO,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACvE,CAAC,CAAC,GAAG,CAAC;AACR,CAAC;AAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEjD,+FAA+F;AAC/F,MAAM,cAAc;IACD,IAAI,CAAS;IAEtB,QAAQ,GAAG,CAAC,CAAC;IAErB,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,WAAW,CAAC,oDAAoD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtG,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,WAAW,CAAC,qDAAqD,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE3C,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAChC,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC/B,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3B,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACxC,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1C,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACxC;gBACE,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,SAAS,CAAC;YACR,IAAI,CAAC,cAAc,EAAE,CAAC;YAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;gBACrC,MAAM,IAAI,WAAW,CAAC,wCAAwC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC1F,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAE9B,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,cAAc,EAAE,CAAC;YAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAExC,0FAA0F;YAC1F,kEAAkE;YAClE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpG,IAAI,CAAC,cAAc,EAAE,CAAC;YAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;gBACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,MAAM,KAAK,GAAc,EAAE,CAAC;QAE5B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,SAAS,CAAC;YACR,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,cAAc,EAAE,CAAC;YAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;gBACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,yBAAyB;QAE1C,kEAAkE;QAClE,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAE,CAAC;YAE5C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;gBACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAEhB,OAAO,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC;YAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAED,MAAM,IAAI,WAAW,CAAC,4CAA4C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtF,CAAC;IAEO,UAAU;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE5B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG;YAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEtD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE1D,IAAI,SAAS,GAAG,IAAI,CAAC;QAErB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1C,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;YACzC,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;gBAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAElD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAElD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YACpC,MAAM,IAAI,WAAW,CAAC,gCAAgC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAEpD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAE7B,OAAO,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpF,CAAC;IAEO,WAAW,CAAI,OAAe,EAAE,KAAQ;QAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,WAAW,CAAC,aAAa,OAAO,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,SAAiB;QAC9B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,IAAI,WAAW,CAAC,aAAa,SAAS,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAEO,cAAc;QACpB,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAE,CAAC;YAE5C,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACxF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,OAAO;QACT,CAAC;IACH,CAAC;CACF;AAED,SAAS,OAAO,CAAC,SAA6B;IAC5C,OAAO,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,CAAC;AACzE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,QAAQ,GAAG,EAAE;IACpD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvE,KAAK,QAAQ;YACX,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC;IACnD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnD,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACrD,CAAC;QACD;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/object-id.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 CamusDB ObjectId: the 12-byte identifier an `id` column holds, written as 24 lowercase
+ * hexadecimal characters.
+ *
+ * The layout mirrors the server's `CamusObjectIdValue` exactly, so an id this class generates is
+ * indistinguishable from one the server generates: a 4-byte second-resolution timestamp, a 3-byte
+ * machine identifier, a 2-byte process identifier, and a 3-byte counter.
+ */
+export declare class CamusObjectId {
+    readonly a: number;
+    readonly b: number;
+    readonly c: number;
+    constructor(a: number, b: number, c: number);
+    /** True when every component is zero — the value `default(CamusObjectIdValue)` holds. */
+    isNull(): boolean;
+    /** The 12 bytes, in the server's little-endian-per-component order. */
+    toBytes(): Uint8Array;
+    /** The 24 lowercase hexadecimal characters. */
+    toString(): string;
+    /** `toString`, so `JSON.stringify` renders an id the way the wire does. */
+    toJSON(): string;
+    /** Orders two ids the way the server does: by unsigned component, most significant first. */
+    compareTo(other: CamusObjectId): number;
+    /** True when both ids name the same value. */
+    equals(other: CamusObjectId): boolean;
+    /** Parses 24 hexadecimal characters. Throws `TypeError` for anything else. */
+    static parse(value: string): CamusObjectId;
+    /** A new id for the current instant. */
+    static generate(): CamusObjectId;
+    /** A new id for the current instant, as its 24-character string. */
+    static generateAsString(): string;
+}
+//# sourceMappingURL=object-id.d.ts.map

package/dist/object-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-id.d.ts","sourceRoot":"","sources":["../src/object-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;gBAEP,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAM3C,yFAAyF;IACzF,MAAM,IAAI,OAAO;IAIjB,uEAAuE;IACvE,OAAO,IAAI,UAAU;IASrB,+CAA+C;IAC/C,QAAQ,IAAI,MAAM;IAIlB,2EAA2E;IAC3E,MAAM,IAAI,MAAM;IAIhB,6FAA6F;IAC7F,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IAUvC,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAIrC,8EAA8E;IAC9E,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAY1C,wCAAwC;IACxC,MAAM,CAAC,QAAQ,IAAI,aAAa;IAWhC,oEAAoE;IACpE,MAAM,CAAC,gBAAgB,IAAI,MAAM;CAGlC"}

package/dist/object-id.js

@@ -0,0 +1,99 @@
+/**
+ * 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 { randomInt } from 'node:crypto';
+/**
+ * A CamusDB ObjectId: the 12-byte identifier an `id` column holds, written as 24 lowercase
+ * hexadecimal characters.
+ *
+ * The layout mirrors the server's `CamusObjectIdValue` exactly, so an id this class generates is
+ * indistinguishable from one the server generates: a 4-byte second-resolution timestamp, a 3-byte
+ * machine identifier, a 2-byte process identifier, and a 3-byte counter.
+ */
+export class CamusObjectId {
+    a;
+    b;
+    c;
+    constructor(a, b, c) {
+        this.a = a | 0;
+        this.b = b | 0;
+        this.c = c | 0;
+    }
+    /** True when every component is zero — the value `default(CamusObjectIdValue)` holds. */
+    isNull() {
+        return this.a === 0 && this.b === 0 && this.c === 0;
+    }
+    /** The 12 bytes, in the server's little-endian-per-component order. */
+    toBytes() {
+        const bytes = new Uint8Array(12);
+        const view = new DataView(bytes.buffer);
+        view.setInt32(0, this.a, true);
+        view.setInt32(4, this.b, true);
+        view.setInt32(8, this.c, true);
+        return bytes;
+    }
+    /** The 24 lowercase hexadecimal characters. */
+    toString() {
+        return hex8(this.a) + hex8(this.b) + hex8(this.c);
+    }
+    /** `toString`, so `JSON.stringify` renders an id the way the wire does. */
+    toJSON() {
+        return this.toString();
+    }
+    /** Orders two ids the way the server does: by unsigned component, most significant first. */
+    compareTo(other) {
+        const a = compareUnsigned(this.a, other.a);
+        if (a !== 0)
+            return a;
+        const b = compareUnsigned(this.b, other.b);
+        if (b !== 0)
+            return b;
+        return compareUnsigned(this.c, other.c);
+    }
+    /** True when both ids name the same value. */
+    equals(other) {
+        return this.a === other.a && this.b === other.b && this.c === other.c;
+    }
+    /** Parses 24 hexadecimal characters. Throws `TypeError` for anything else. */
+    static parse(value) {
+        if (value.length !== 24 || !/^[0-9a-fA-F]{24}$/.test(value)) {
+            throw new TypeError('An ObjectId is 24 hexadecimal digits.');
+        }
+        return new CamusObjectId(Number.parseInt(value.slice(0, 8), 16) | 0, Number.parseInt(value.slice(8, 16), 16) | 0, Number.parseInt(value.slice(16, 24), 16) | 0);
+    }
+    /** A new id for the current instant. */
+    static generate() {
+        const timestamp = Math.floor(Date.now() / 1000) | 0;
+        const increment = nextIncrement();
+        const a = timestamp;
+        const b = (machine << 8) | ((processId >> 8) & 0xff);
+        const c = (processId << 24) | increment;
+        return new CamusObjectId(a, b | 0, c | 0);
+    }
+    /** A new id for the current instant, as its 24-character string. */
+    static generateAsString() {
+        return CamusObjectId.generate().toString();
+    }
+}
+// One machine identity and one process identity per process, exactly as the server's generator
+// holds them. Both are random rather than derived from the host: an id must not disclose where it
+// was minted, and a container has no stable machine name to derive one from anyway.
+const machine = randomInt(0x01000000);
+const processId = randomInt(0x00010000);
+let increment = randomInt(0x7fffffff);
+function nextIncrement() {
+    increment = (increment + 1) | 0;
+    return increment & 0x00ffffff;
+}
+function hex8(value) {
+    return (value >>> 0).toString(16).padStart(8, '0');
+}
+function compareUnsigned(left, right) {
+    const a = left >>> 0;
+    const b = right >>> 0;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+//# sourceMappingURL=object-id.js.map

package/dist/object-id.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 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 SQL isolation level a transaction runs at. It is independent of `CamusLocking`.
+ *
+ * The member values are the exact strings the server accepts in the `isolationLevel` wire field.
+ */
+export declare const CamusIsolationLevel: {
+    /** Lock-free reads of the latest committed value. No repeatable-read or phantom protection. */
+    readonly ReadCommitted: "ReadCommitted";
+    /**
+     * The strongest level. The outcome is equivalent to some serial order. A read-write transaction
+     * takes point and range locks; a read-only one is a lock-free consistent snapshot.
+     */
+    readonly Serializable: "Serializable";
+};
+export type CamusIsolationLevel = (typeof CamusIsolationLevel)[keyof typeof CamusIsolationLevel];
+/** Whether a transaction may write. */
+export declare const CamusTransactionMode: {
+    /** The transaction may read and write. This is the default. */
+    readonly ReadWrite: "ReadWrite";
+    /**
+     * The transaction only reads. Together with `Serializable` this is a lock-free consistent
+     * snapshot, pinned to the instant it began and resumable across several requests.
+     */
+    readonly ReadOnly: "ReadOnly";
+};
+export type CamusTransactionMode = (typeof CamusTransactionMode)[keyof typeof CamusTransactionMode];
+/** How a transaction resolves a conflict. It is independent of `CamusIsolationLevel`. */
+export declare const CamusLocking: {
+    /**
+     * Take locks up front. A conflicting transaction blocks, or deadlock avoidance aborts it, at the
+     * moment it asks for a lock. This is the default, and what almost every caller uses.
+     */
+    readonly Pessimistic: "Pessimistic";
+    /**
+     * Take no explicit locks. Stage the writes, record what was read, and detect write-write and
+     * read-write conflicts only at commit. A losing transaction fails its commit and must be retried.
+     * Good for a read-mostly workload with little contention. It does not protect against phantoms;
+     * use `Serializable` with pessimistic locking when you need that.
+     */
+    readonly Optimistic: "Optimistic";
+};
+export type CamusLocking = (typeof CamusLocking)[keyof typeof CamusLocking];
+/**
+ * The concurrency knobs for one transaction, or for the short transaction the server begins for a
+ * single autocommit statement.
+ *
+ * Every knob is optional. A knob left unset falls back to the client's default options, then to
+ * the connection-string defaults, then to the server default.
+ */
+export interface CamusTransactionOptions {
+    readonly isolationLevel?: CamusIsolationLevel | undefined;
+    readonly mode?: CamusTransactionMode | undefined;
+    readonly locking?: CamusLocking | undefined;
+    /**
+     * The exact SQL text of the statement whose learned route decides where this transaction starts.
+     *
+     * It matters only with learned routing on. Without it, the transaction's first statement chooses
+     * the endpoint; with it, `BEGIN` is sent at once, to the endpoint that statement's route names.
+     * Set it when the transaction's hot statement is not its first one.
+     */
+    readonly affinity?: string | undefined;
+}
+/** No knob set: every one deferred to a lower level of defaults. */
+export declare const DEFAULT_TRANSACTION_OPTIONS: CamusTransactionOptions;
+/** Optimistic locking, with isolation and mode left to the defaults. */
+export declare const OPTIMISTIC_TRANSACTION_OPTIONS: CamusTransactionOptions;
+/** A lock-free consistent snapshot: serializable and read-only. */
+export declare const SNAPSHOT_TRANSACTION_OPTIONS: CamusTransactionOptions;
+/** Fills every knob this object left unset from `fallback`. */
+export declare function withDefaults(options: CamusTransactionOptions, fallback: CamusTransactionOptions | undefined): CamusTransactionOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;IAC9B,+FAA+F;;IAG/F;;;OAGG;;CAEK,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjG,uCAAuC;AACvC,eAAO,MAAM,oBAAoB;IAC/B,+DAA+D;;IAG/D;;;OAGG;;CAEK,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEpG,yFAAyF;AACzF,eAAO,MAAM,YAAY;IACvB;;;OAGG;;IAGH;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAE5C;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,oEAAoE;AACpE,eAAO,MAAM,2BAA2B,EAAE,uBAA2C,CAAC;AAEtF,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,EAAE,uBAE3C,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,4BAA4B,EAAE,uBAGzC,CAAC;AAEH,+DAA+D;AAC/D,wBAAgB,YAAY,CAC1B,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE,uBAAuB,GAAG,SAAS,GAC5C,uBAAuB,CASzB"}

package/dist/options.js

@@ -0,0 +1,68 @@
+/**
+ * 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 SQL isolation level a transaction runs at. It is independent of `CamusLocking`.
+ *
+ * The member values are the exact strings the server accepts in the `isolationLevel` wire field.
+ */
+export const CamusIsolationLevel = {
+    /** Lock-free reads of the latest committed value. No repeatable-read or phantom protection. */
+    ReadCommitted: 'ReadCommitted',
+    /**
+     * The strongest level. The outcome is equivalent to some serial order. A read-write transaction
+     * takes point and range locks; a read-only one is a lock-free consistent snapshot.
+     */
+    Serializable: 'Serializable',
+};
+/** Whether a transaction may write. */
+export const CamusTransactionMode = {
+    /** The transaction may read and write. This is the default. */
+    ReadWrite: 'ReadWrite',
+    /**
+     * The transaction only reads. Together with `Serializable` this is a lock-free consistent
+     * snapshot, pinned to the instant it began and resumable across several requests.
+     */
+    ReadOnly: 'ReadOnly',
+};
+/** How a transaction resolves a conflict. It is independent of `CamusIsolationLevel`. */
+export const CamusLocking = {
+    /**
+     * Take locks up front. A conflicting transaction blocks, or deadlock avoidance aborts it, at the
+     * moment it asks for a lock. This is the default, and what almost every caller uses.
+     */
+    Pessimistic: 'Pessimistic',
+    /**
+     * Take no explicit locks. Stage the writes, record what was read, and detect write-write and
+     * read-write conflicts only at commit. A losing transaction fails its commit and must be retried.
+     * Good for a read-mostly workload with little contention. It does not protect against phantoms;
+     * use `Serializable` with pessimistic locking when you need that.
+     */
+    Optimistic: 'Optimistic',
+};
+/** No knob set: every one deferred to a lower level of defaults. */
+export const DEFAULT_TRANSACTION_OPTIONS = Object.freeze({});
+/** Optimistic locking, with isolation and mode left to the defaults. */
+export const OPTIMISTIC_TRANSACTION_OPTIONS = Object.freeze({
+    locking: CamusLocking.Optimistic,
+});
+/** A lock-free consistent snapshot: serializable and read-only. */
+export const SNAPSHOT_TRANSACTION_OPTIONS = Object.freeze({
+    isolationLevel: CamusIsolationLevel.Serializable,
+    mode: CamusTransactionMode.ReadOnly,
+});
+/** Fills every knob this object left unset from `fallback`. */
+export function withDefaults(options, fallback) {
+    if (fallback === undefined)
+        return options;
+    return {
+        isolationLevel: options.isolationLevel ?? fallback.isolationLevel,
+        mode: options.mode ?? fallback.mode,
+        locking: options.locking ?? fallback.locking,
+        affinity: options.affinity ?? fallback.affinity,
+    };
+}
+//# sourceMappingURL=options.js.map