@g9tm/syncdata 1.2.1

package/dist/internal/utf8.js

@@ -0,0 +1,143 @@
+// UTF-8 without TextEncoder/TextDecoder: Lynx's background thread (PrimJS) has neither. The native codecs are used
+// where they exist; the fallbacks follow the WHATWG encoder/decoder (lone surrogates become U+FFFD, invalid bytes
+// decode to U+FFFD), so both paths produce the same bytes and text.
+function nativeEncoder() {
+    try {
+        const ctor = globalThis.TextEncoder;
+        return typeof ctor === 'function' ? new ctor() : null;
+    }
+    catch {
+        return null;
+    }
+}
+function nativeDecoder() {
+    try {
+        const ctor = globalThis.TextDecoder;
+        return typeof ctor === 'function' ? new ctor('utf-8') : null;
+    }
+    catch {
+        return null;
+    }
+}
+const encoder = nativeEncoder();
+const decoder = nativeDecoder();
+/** UTF-8 bytes of `text`. */
+export function utf8Encode(text) {
+    if (encoder)
+        return encoder.encode(text);
+    return utf8EncodeJs(text);
+}
+/** Text of UTF-8 `bytes`. */
+export function utf8Decode(bytes) {
+    if (decoder)
+        return decoder.decode(bytes);
+    return utf8DecodeJs(bytes);
+}
+/** The pure-JS encoder (exported for tests; use {@link utf8Encode}). */
+export function utf8EncodeJs(text) {
+    const out = new Uint8Array(text.length * 3);
+    let p = 0;
+    for (let i = 0; i < text.length; i++) {
+        let c = text.charCodeAt(i);
+        if (c < 0x80) {
+            out[p++] = c;
+            continue;
+        }
+        if (c < 0x800) {
+            out[p++] = 0xc0 | (c >> 6);
+            out[p++] = 0x80 | (c & 63);
+            continue;
+        }
+        if (c >= 0xd800 && c <= 0xdfff) {
+            const next = i + 1 < text.length ? text.charCodeAt(i + 1) : 0;
+            if (c <= 0xdbff && next >= 0xdc00 && next <= 0xdfff) {
+                c = 0x10000 + ((c - 0xd800) << 10) + (next - 0xdc00);
+                i++;
+                out[p++] = 0xf0 | (c >> 18);
+                out[p++] = 0x80 | ((c >> 12) & 63);
+                out[p++] = 0x80 | ((c >> 6) & 63);
+                out[p++] = 0x80 | (c & 63);
+                continue;
+            }
+            c = 0xfffd; // lone surrogate
+        }
+        out[p++] = 0xe0 | (c >> 12);
+        out[p++] = 0x80 | ((c >> 6) & 63);
+        out[p++] = 0x80 | (c & 63);
+    }
+    return out.slice(0, p);
+}
+/** The pure-JS decoder, the WHATWG UTF-8 decode algorithm (exported for tests; use {@link utf8Decode}). */
+export function utf8DecodeJs(bytes) {
+    const parts = [];
+    let units = [];
+    const emit = (cp) => {
+        if (cp >= 0x10000) {
+            cp -= 0x10000;
+            units.push(0xd800 + (cp >> 10), 0xdc00 + (cp & 0x3ff));
+        }
+        else {
+            units.push(cp);
+        }
+        if (units.length >= 8192) {
+            parts.push(String.fromCharCode.apply(null, units));
+            units = [];
+        }
+    };
+    let codePoint = 0;
+    let needed = 0;
+    let seen = 0;
+    let lower = 0x80;
+    let upper = 0xbf;
+    for (let i = 0; i < bytes.length; i++) {
+        const b = bytes[i];
+        if (needed === 0) {
+            if (b <= 0x7f)
+                emit(b);
+            else if (b >= 0xc2 && b <= 0xdf) {
+                needed = 1;
+                codePoint = b & 0x1f;
+            }
+            else if (b >= 0xe0 && b <= 0xef) {
+                if (b === 0xe0)
+                    lower = 0xa0;
+                if (b === 0xed)
+                    upper = 0x9f;
+                needed = 2;
+                codePoint = b & 0x0f;
+            }
+            else if (b >= 0xf0 && b <= 0xf4) {
+                if (b === 0xf0)
+                    lower = 0x90;
+                if (b === 0xf4)
+                    upper = 0x8f;
+                needed = 3;
+                codePoint = b & 0x07;
+            }
+            else
+                emit(0xfffd);
+            continue;
+        }
+        if (b < lower || b > upper) {
+            // Not a valid continuation: the sequence so far is one error, and this byte is processed again on its own.
+            codePoint = needed = seen = 0;
+            lower = 0x80;
+            upper = 0xbf;
+            emit(0xfffd);
+            i--;
+            continue;
+        }
+        lower = 0x80;
+        upper = 0xbf;
+        codePoint = (codePoint << 6) | (b & 0x3f);
+        if (++seen === needed) {
+            emit(codePoint);
+            codePoint = needed = seen = 0;
+        }
+    }
+    if (needed !== 0)
+        emit(0xfffd);
+    parts.push(String.fromCharCode.apply(null, units));
+    return parts.join('');
+}
+//# sourceMappingURL=utf8.js.map

package/dist/internal/utf8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utf8.js","sourceRoot":"","sources":["../../src/internal/utf8.ts"],"names":[],"mappings":"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","sourcesContent":["// UTF-8 without TextEncoder/TextDecoder: Lynx's background thread (PrimJS) has neither. The native codecs are used\n// where they exist; the fallbacks follow the WHATWG encoder/decoder (lone surrogates become U+FFFD, invalid bytes\n// decode to U+FFFD), so both paths produce the same bytes and text.\n\ninterface Encoder {\n  encode(text: string): Uint8Array;\n}\ninterface Decoder {\n  decode(bytes: Uint8Array): string;\n}\n\nfunction nativeEncoder(): Encoder | null {\n  try {\n    const ctor = (globalThis as { TextEncoder?: new () => Encoder }).TextEncoder;\n    return typeof ctor === 'function' ? new ctor() : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction nativeDecoder(): Decoder | null {\n  try {\n    const ctor = (globalThis as { TextDecoder?: new (label?: string) => Decoder }).TextDecoder;\n    return typeof ctor === 'function' ? new ctor('utf-8') : null;\n  } catch {\n    return null;\n  }\n}\n\nconst encoder = nativeEncoder();\nconst decoder = nativeDecoder();\n\n/** UTF-8 bytes of `text`. */\nexport function utf8Encode(text: string): Uint8Array {\n  if (encoder) return encoder.encode(text);\n  return utf8EncodeJs(text);\n}\n\n/** Text of UTF-8 `bytes`. */\nexport function utf8Decode(bytes: Uint8Array): string {\n  if (decoder) return decoder.decode(bytes);\n  return utf8DecodeJs(bytes);\n}\n\n/** The pure-JS encoder (exported for tests; use {@link utf8Encode}). */\nexport function utf8EncodeJs(text: string): Uint8Array {\n  const out = new Uint8Array(text.length * 3);\n  let p = 0;\n  for (let i = 0; i < text.length; i++) {\n    let c = text.charCodeAt(i);\n    if (c < 0x80) {\n      out[p++] = c;\n      continue;\n    }\n    if (c < 0x800) {\n      out[p++] = 0xc0 | (c >> 6);\n      out[p++] = 0x80 | (c & 63);\n      continue;\n    }\n    if (c >= 0xd800 && c <= 0xdfff) {\n      const next = i + 1 < text.length ? text.charCodeAt(i + 1) : 0;\n      if (c <= 0xdbff && next >= 0xdc00 && next <= 0xdfff) {\n        c = 0x10000 + ((c - 0xd800) << 10) + (next - 0xdc00);\n        i++;\n        out[p++] = 0xf0 | (c >> 18);\n        out[p++] = 0x80 | ((c >> 12) & 63);\n        out[p++] = 0x80 | ((c >> 6) & 63);\n        out[p++] = 0x80 | (c & 63);\n        continue;\n      }\n      c = 0xfffd; // lone surrogate\n    }\n    out[p++] = 0xe0 | (c >> 12);\n    out[p++] = 0x80 | ((c >> 6) & 63);\n    out[p++] = 0x80 | (c & 63);\n  }\n  return out.slice(0, p);\n}\n\n/** The pure-JS decoder, the WHATWG UTF-8 decode algorithm (exported for tests; use {@link utf8Decode}). */\nexport function utf8DecodeJs(bytes: Uint8Array): string {\n  const parts: string[] = [];\n  let units: number[] = [];\n  const emit = (cp: number): void => {\n    if (cp >= 0x10000) {\n      cp -= 0x10000;\n      units.push(0xd800 + (cp >> 10), 0xdc00 + (cp & 0x3ff));\n    } else {\n      units.push(cp);\n    }\n    if (units.length >= 8192) {\n      parts.push(String.fromCharCode.apply(null, units));\n      units = [];\n    }\n  };\n\n  let codePoint = 0;\n  let needed = 0;\n  let seen = 0;\n  let lower = 0x80;\n  let upper = 0xbf;\n  for (let i = 0; i < bytes.length; i++) {\n    const b = bytes[i]!;\n    if (needed === 0) {\n      if (b <= 0x7f) emit(b);\n      else if (b >= 0xc2 && b <= 0xdf) {\n        needed = 1;\n        codePoint = b & 0x1f;\n      } else if (b >= 0xe0 && b <= 0xef) {\n        if (b === 0xe0) lower = 0xa0;\n        if (b === 0xed) upper = 0x9f;\n        needed = 2;\n        codePoint = b & 0x0f;\n      } else if (b >= 0xf0 && b <= 0xf4) {\n        if (b === 0xf0) lower = 0x90;\n        if (b === 0xf4) upper = 0x8f;\n        needed = 3;\n        codePoint = b & 0x07;\n      } else emit(0xfffd);\n      continue;\n    }\n    if (b < lower || b > upper) {\n      // Not a valid continuation: the sequence so far is one error, and this byte is processed again on its own.\n      codePoint = needed = seen = 0;\n      lower = 0x80;\n      upper = 0xbf;\n      emit(0xfffd);\n      i--;\n      continue;\n    }\n    lower = 0x80;\n    upper = 0xbf;\n    codePoint = (codePoint << 6) | (b & 0x3f);\n    if (++seen === needed) {\n      emit(codePoint);\n      codePoint = needed = seen = 0;\n    }\n  }\n  if (needed !== 0) emit(0xfffd);\n  parts.push(String.fromCharCode.apply(null, units));\n  return parts.join('');\n}\n"]}

package/dist/node/index.d.ts

@@ -0,0 +1,9 @@
+import { type G9FrameDecompressor } from '../protocol/rowBatch/reader.js';
+import type { G9FrameCompressor } from '../protocol/rowBatch/writer.js';
+export { nodeSqliteDriver, G9NodeSqliteError } from './sqliteDriver.js';
+/** A frame decompressor over node:zlib. */
+export declare function nodeBrotliDecompressor(): G9FrameDecompressor;
+/** A push-frame compressor over node:zlib. */
+export declare function nodeBrotliCompressor(): G9FrameCompressor;
+/** Makes node:zlib the process-wide frame decompressor (setDefaultFrameDecompressor). */
+export declare function useNodeBrotli(): G9FrameDecompressor;

package/dist/node/index.js

@@ -0,0 +1,35 @@
+/// <reference types="node" />
+// @g9tm/syncdata/node — Node helpers: the node:sqlite reference driver and Brotli through node:zlib (the same
+// quality 4 / window 22 the .NET writer uses).
+import { brotliCompressSync, brotliDecompressSync, constants } from 'node:zlib';
+import { setDefaultFrameDecompressor } from '../protocol/rowBatch/reader.js';
+export { nodeSqliteDriver, G9NodeSqliteError } from './sqliteDriver.js';
+/** A frame decompressor over node:zlib. */
+export function nodeBrotliDecompressor() {
+    return {
+        decompress(compressed, expectedLength) {
+            const out = brotliDecompressSync(compressed, { maxOutputLength: Math.max(1, expectedLength + 1) });
+            if (out.length !== expectedLength)
+                throw new Error(`Brotli body decoded to ${out.length} bytes, ${expectedLength} expected.`);
+            return new Uint8Array(out.buffer, out.byteOffset, out.length);
+        },
+    };
+}
+/** A push-frame compressor over node:zlib. */
+export function nodeBrotliCompressor() {
+    return {
+        compress(body, quality, window) {
+            const out = brotliCompressSync(body, {
+                params: { [constants.BROTLI_PARAM_QUALITY]: quality, [constants.BROTLI_PARAM_LGWIN]: window, [constants.BROTLI_PARAM_SIZE_HINT]: body.length },
+            });
+            return new Uint8Array(out.buffer, out.byteOffset, out.length);
+        },
+    };
+}
+/** Makes node:zlib the process-wide frame decompressor (setDefaultFrameDecompressor). */
+export function useNodeBrotli() {
+    const decompressor = nodeBrotliDecompressor();
+    setDefaultFrameDecompressor(decompressor);
+    return decompressor;
+}
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,8GAA8G;AAC9G,+CAA+C;AAC/C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAA4B,MAAM,gCAAgC,CAAC;AAGvG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExE,2CAA2C;AAC3C,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,UAAU,CAAC,UAAsB,EAAE,cAAsB;YACvD,MAAM,GAAG,GAAG,oBAAoB,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YACnG,IAAI,GAAG,CAAC,MAAM,KAAK,cAAc;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,WAAW,cAAc,YAAY,CAAC,CAAC;YAC9H,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,QAAQ,CAAC,IAAgB,EAAE,OAAe,EAAE,MAAc;YACxD,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,EAAE;gBACnC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE;aAC/I,CAAC,CAAC;YACH,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa;IAC3B,MAAM,YAAY,GAAG,sBAAsB,EAAE,CAAC;IAC9C,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["/// <reference types=\"node\" />\n// @g9tm/syncdata/node — Node helpers: the node:sqlite reference driver and Brotli through node:zlib (the same\n// quality 4 / window 22 the .NET writer uses).\nimport { brotliCompressSync, brotliDecompressSync, constants } from 'node:zlib';\nimport { setDefaultFrameDecompressor, type G9FrameDecompressor } from '../protocol/rowBatch/reader.js';\nimport type { G9FrameCompressor } from '../protocol/rowBatch/writer.js';\n\nexport { nodeSqliteDriver, G9NodeSqliteError } from './sqliteDriver.js';\n\n/** A frame decompressor over node:zlib. */\nexport function nodeBrotliDecompressor(): G9FrameDecompressor {\n  return {\n    decompress(compressed: Uint8Array, expectedLength: number): Uint8Array {\n      const out = brotliDecompressSync(compressed, { maxOutputLength: Math.max(1, expectedLength + 1) });\n      if (out.length !== expectedLength) throw new Error(`Brotli body decoded to ${out.length} bytes, ${expectedLength} expected.`);\n      return new Uint8Array(out.buffer, out.byteOffset, out.length);\n    },\n  };\n}\n\n/** A push-frame compressor over node:zlib. */\nexport function nodeBrotliCompressor(): G9FrameCompressor {\n  return {\n    compress(body: Uint8Array, quality: number, window: number): Uint8Array {\n      const out = brotliCompressSync(body, {\n        params: { [constants.BROTLI_PARAM_QUALITY]: quality, [constants.BROTLI_PARAM_LGWIN]: window, [constants.BROTLI_PARAM_SIZE_HINT]: body.length },\n      });\n      return new Uint8Array(out.buffer, out.byteOffset, out.length);\n    },\n  };\n}\n\n/** Makes node:zlib the process-wide frame decompressor (setDefaultFrameDecompressor). */\nexport function useNodeBrotli(): G9FrameDecompressor {\n  const decompressor = nodeBrotliDecompressor();\n  setDefaultFrameDecompressor(decompressor);\n  return decompressor;\n}\n"]}

package/dist/node/sqliteDriver.d.ts

@@ -0,0 +1,11 @@
+import type { G9SqliteDriver } from '../sqlite/driver.js';
+/** A driver error with the shape the store classifies (`code` + SQLite's `sqliteCode`). */
+export declare class G9NodeSqliteError extends Error {
+    readonly code: string;
+    readonly sqliteCode: number | undefined;
+    constructor(code: string, message: string, sqliteCode?: number, cause?: unknown);
+}
+/** The node:sqlite G9SqliteDriver (tests, tools, Node hosts). */
+export declare function nodeSqliteDriver(options?: {
+    name?: string;
+}): G9SqliteDriver;

package/dist/node/sqliteDriver.js

@@ -0,0 +1,252 @@
+/// <reference types="node" />
+// The Node reference G9SqliteDriver over node:sqlite (Node ≥ 22.13), structurally the driver G9LynxControls tests its
+// SQL against (@g9lynx/testing createNodeTestDriver). Safe integers bind as INTEGER (node binds a plain number as REAL),
+// int64 beyond 2^53 travels as `{ int64 }` tags, BLOBs as ArrayBuffers. Node only.
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+/** A driver error with the shape the store classifies (`code` + SQLite's `sqliteCode`). */
+export class G9NodeSqliteError extends Error {
+    constructor(code, message, sqliteCode, cause) {
+        super(message);
+        this.name = 'G9SqliteError';
+        this.code = code;
+        this.sqliteCode = sqliteCode;
+        if (cause !== undefined)
+            Object.defineProperty(this, 'cause', { value: cause, enumerable: false, writable: true, configurable: true });
+    }
+}
+function codeFor(resultCode) {
+    switch (resultCode & 0xff) {
+        case 5:
+            return 'busy';
+        case 6:
+            return 'locked';
+        case 19:
+            return 'constraint';
+        case 11:
+        case 26:
+            return 'corrupt';
+        case 8:
+            return 'readonly';
+        case 13:
+            return 'full';
+        case 9:
+            return 'interrupted';
+        case 21:
+            return 'misuse';
+        case 14:
+            return 'not-found';
+        default:
+            return 'other';
+    }
+}
+function toError(error, sql) {
+    var _a;
+    if (error instanceof G9NodeSqliteError)
+        return error;
+    const e = error;
+    const sqliteCode = typeof (e === null || e === void 0 ? void 0 : e.errcode) === 'number' ? e.errcode : undefined;
+    return new G9NodeSqliteError(sqliteCode !== undefined ? codeFor(sqliteCode) : 'misuse', ((_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : String(error)) + (sql ? ` [${sql}]` : ''), sqliteCode, error);
+}
+function bind(value) {
+    if (value === null || typeof value === 'string')
+        return value;
+    if (typeof value === 'number') {
+        if (Number.isNaN(value))
+            throw new G9NodeSqliteError('misuse', 'NaN is not a SQL value.');
+        return Number.isSafeInteger(value) ? BigInt(value) : value;
+    }
+    if (value instanceof ArrayBuffer)
+        return value.byteLength === 0 ? new Uint8Array(0) : new Uint8Array(value);
+    if (typeof value === 'object' && typeof value.int64 === 'string')
+        return BigInt(value.int64);
+    throw new G9NodeSqliteError('misuse', `Not a G9SqlValue (${typeof value}).`);
+}
+function read(value) {
+    if (typeof value === 'bigint') {
+        const n = Number(value);
+        return Number.isSafeInteger(n) ? n : { int64: value.toString() };
+    }
+    if (ArrayBuffer.isView(value)) {
+        const copy = new Uint8Array(value.byteLength);
+        copy.set(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));
+        return copy.buffer;
+    }
+    return value;
+}
+let seed = 0;
+/** The node:sqlite G9SqliteDriver (tests, tools, Node hosts). */
+export function nodeSqliteDriver(options = {}) {
+    var _a;
+    const sessions = new Map();
+    const owners = new Map();
+    const session = (token) => {
+        const s = sessions.get(token);
+        if (!s)
+            throw new G9NodeSqliteError('misuse', 'The database session is closed or unknown.');
+        return s;
+    };
+    const prepare = (s, sql) => {
+        let statement = s.statements.get(sql);
+        if (!statement) {
+            statement = s.db.prepare(sql);
+            statement.setReadBigInts(true);
+            statement.setReturnArrays(true);
+            if (s.statements.size > 500)
+                s.statements.clear();
+            s.statements.set(sql, statement);
+        }
+        return statement;
+    };
+    const execute = (s, statement, maxRows) => {
+        const prepared = prepare(s, statement.sql);
+        const args = statement.params.map(bind);
+        const columns = prepared.columns().map((c) => c.name);
+        if (columns.length > 0) {
+            const rows = [];
+            for (const row of prepared.iterate(...args)) {
+                if (maxRows !== undefined && rows.length >= maxRows)
+                    throw new G9NodeSqliteError('too-many-rows', `More than ${maxRows} rows.`);
+                rows.push(row.map(read));
+            }
+            return { columns, rows, changes: 0, lastInsertRowId: s.lastInsertRowId };
+        }
+        const result = prepared.run(...args);
+        s.lastInsertRowId = read(result.lastInsertRowid);
+        return { columns: [], rows: [], changes: Number(result.changes), lastInsertRowId: s.lastInsertRowId };
+    };
+    return {
+        name: (_a = options.name) !== null && _a !== void 0 ? _a : 'node-sqlite',
+        async capabilities() {
+            const db = new DatabaseSync(':memory:');
+            try {
+                const row = db.prepare('SELECT sqlite_version() AS v').get();
+                return { sqliteVersion: row.v, maxVariables: 32766, json1: true, returning: true, upsert: true, interrupt: false };
+            }
+            finally {
+                db.close();
+            }
+        },
+        async open(open) {
+            var _a;
+            const memory = open.path === ':memory:' || open.path === '';
+            if (!memory && !open.create && !existsSync(open.path))
+                throw new G9NodeSqliteError('not-found', `Database file does not exist: ${open.path}`);
+            if (!memory && open.create)
+                mkdirSync(dirname(open.path), { recursive: true });
+            let db;
+            try {
+                db = new DatabaseSync(open.path || ':memory:', { readOnly: open.readOnly === true });
+            }
+            catch (error) {
+                throw toError(error);
+            }
+            const pragmas = (_a = open.pragmas) !== null && _a !== void 0 ? _a : {};
+            try {
+                if (pragmas.journalMode)
+                    db.exec(`PRAGMA journal_mode=${pragmas.journalMode.toUpperCase()}`);
+                db.exec(`PRAGMA synchronous=${open.durability === 'normal' ? 'NORMAL' : 'FULL'}`);
+                if (pragmas.busyTimeoutMs !== undefined)
+                    db.exec(`PRAGMA busy_timeout=${Math.max(0, Math.floor(pragmas.busyTimeoutMs))}`);
+                if (pragmas.foreignKeys !== undefined)
+                    db.exec(`PRAGMA foreign_keys=${pragmas.foreignKeys ? 'ON' : 'OFF'}`);
+            }
+            catch (error) {
+                db.close();
+                throw toError(error);
+            }
+            const token = `node-session-${++seed}`;
+            sessions.set(token, { token, db, statements: new Map(), tx: null, lastInsertRowId: 0 });
+            return token;
+        },
+        async run(token, statements, run = {}) {
+            var _a;
+            const s = session(token);
+            if (run.tx !== undefined && s.tx !== run.tx)
+                throw new G9NodeSqliteError('misuse', 'The transaction is finished or belongs to another session.');
+            if (run.tx === undefined && s.tx !== null)
+                throw new G9NodeSqliteError('misuse', 'A transaction is open on this session; pass its token (tx).');
+            if ((_a = run.signal) === null || _a === void 0 ? void 0 : _a.aborted)
+                throw new G9NodeSqliteError('cancelled', 'Cancelled before the batch started.');
+            const atomic = run.atomic === true && run.tx === undefined && statements.length > 0;
+            if (atomic)
+                s.db.exec('BEGIN');
+            const results = [];
+            try {
+                for (const statement of statements) {
+                    try {
+                        results.push(execute(s, statement, run.maxRows));
+                    }
+                    catch (error) {
+                        throw toError(error, statement.sql);
+                    }
+                }
+                if (atomic)
+                    s.db.exec('COMMIT');
+            }
+            catch (error) {
+                if (atomic) {
+                    try {
+                        s.db.exec('ROLLBACK');
+                    }
+                    catch {
+                        // already rolled back
+                    }
+                }
+                throw toError(error);
+            }
+            return results;
+        },
+        async begin(token, mode) {
+            const s = session(token);
+            if (s.tx !== null)
+                throw new G9NodeSqliteError('misuse', 'A transaction is already open on this session.');
+            try {
+                s.db.exec(mode === 'immediate' ? 'BEGIN IMMEDIATE' : 'BEGIN DEFERRED');
+            }
+            catch (error) {
+                throw toError(error);
+            }
+            const tx = `node-tx-${++seed}`;
+            s.tx = tx;
+            owners.set(tx, s);
+            return tx;
+        },
+        async commit(tx) {
+            const s = owners.get(tx);
+            if (!s || s.tx !== tx)
+                throw new G9NodeSqliteError('misuse', 'The transaction is finished or unknown.');
+            try {
+                s.db.exec('COMMIT');
+            }
+            catch (error) {
+                throw toError(error);
+            }
+            s.tx = null;
+            owners.delete(tx);
+        },
+        async rollback(tx) {
+            const s = owners.get(tx);
+            if (!s || s.tx !== tx)
+                throw new G9NodeSqliteError('misuse', 'The transaction is finished or unknown.');
+            s.tx = null;
+            owners.delete(tx);
+            try {
+                s.db.exec('ROLLBACK');
+            }
+            catch {
+                // SQLite may already have rolled back
+            }
+        },
+        async close(token) {
+            const s = session(token);
+            sessions.delete(token);
+            if (s.tx)
+                owners.delete(s.tx);
+            s.statements.clear();
+            s.db.close();
+        },
+    };
+}
+//# sourceMappingURL=sqliteDriver.js.map

package/dist/node/sqliteDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteDriver.js","sourceRoot":"","sources":["../../src/node/sqliteDriver.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference types=\"node\" />\n// The Node reference G9SqliteDriver over node:sqlite (Node ≥ 22.13), structurally the driver G9LynxControls tests its\n// SQL against (@g9lynx/testing createNodeTestDriver). Safe integers bind as INTEGER (node binds a plain number as REAL),\n// int64 beyond 2^53 travels as `{ int64 }` tags, BLOBs as ArrayBuffers. Node only.\nimport { existsSync, mkdirSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport { DatabaseSync, type StatementSync } from 'node:sqlite';\nimport type {\n  G9DriverCapabilities,\n  G9DriverStatement,\n  G9OpenOptions,\n  G9RunOptions,\n  G9SessionToken,\n  G9SqlResult,\n  G9SqlValue,\n  G9SqliteDriver,\n  G9TxToken,\n} from '../sqlite/driver.js';\n\ninterface Session {\n  readonly token: G9SessionToken;\n  readonly db: DatabaseSync;\n  readonly statements: Map<string, StatementSync>;\n  tx: G9TxToken | null;\n  lastInsertRowId: G9SqlValue;\n}\n\n/** A driver error with the shape the store classifies (`code` + SQLite's `sqliteCode`). */\nexport class G9NodeSqliteError extends Error {\n  readonly code: string;\n  readonly sqliteCode: number | undefined;\n\n  constructor(code: string, message: string, sqliteCode?: number, cause?: unknown) {\n    super(message);\n    this.name = 'G9SqliteError';\n    this.code = code;\n    this.sqliteCode = sqliteCode;\n    if (cause !== undefined) Object.defineProperty(this, 'cause', { value: cause, enumerable: false, writable: true, configurable: true });\n  }\n}\n\nfunction codeFor(resultCode: number): string {\n  switch (resultCode & 0xff) {\n    case 5:\n      return 'busy';\n    case 6:\n      return 'locked';\n    case 19:\n      return 'constraint';\n    case 11:\n    case 26:\n      return 'corrupt';\n    case 8:\n      return 'readonly';\n    case 13:\n      return 'full';\n    case 9:\n      return 'interrupted';\n    case 21:\n      return 'misuse';\n    case 14:\n      return 'not-found';\n    default:\n      return 'other';\n  }\n}\n\nfunction toError(error: unknown, sql?: string): G9NodeSqliteError {\n  if (error instanceof G9NodeSqliteError) return error;\n  const e = error as { errcode?: number; message?: string };\n  const sqliteCode = typeof e?.errcode === 'number' ? e.errcode : undefined;\n  return new G9NodeSqliteError(sqliteCode !== undefined ? codeFor(sqliteCode) : 'misuse', (e?.message ?? String(error)) + (sql ? ` [${sql}]` : ''), sqliteCode, error);\n}\n\nfunction bind(value: G9SqlValue): null | number | bigint | string | Uint8Array {\n  if (value === null || typeof value === 'string') return value;\n  if (typeof value === 'number') {\n    if (Number.isNaN(value)) throw new G9NodeSqliteError('misuse', 'NaN is not a SQL value.');\n    return Number.isSafeInteger(value) ? BigInt(value) : value;\n  }\n  if (value instanceof ArrayBuffer) return value.byteLength === 0 ? new Uint8Array(0) : new Uint8Array(value);\n  if (typeof value === 'object' && typeof (value as { int64?: unknown }).int64 === 'string') return BigInt((value as { int64: string }).int64);\n  throw new G9NodeSqliteError('misuse', `Not a G9SqlValue (${typeof value}).`);\n}\n\nfunction read(value: unknown): G9SqlValue {\n  if (typeof value === 'bigint') {\n    const n = Number(value);\n    return Number.isSafeInteger(n) ? n : { int64: value.toString() };\n  }\n  if (ArrayBuffer.isView(value)) {\n    const copy = new Uint8Array(value.byteLength);\n    copy.set(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));\n    return copy.buffer;\n  }\n  return value as G9SqlValue;\n}\n\nlet seed = 0;\n\n/** The node:sqlite G9SqliteDriver (tests, tools, Node hosts). */\nexport function nodeSqliteDriver(options: { name?: string } = {}): G9SqliteDriver {\n  const sessions = new Map<string, Session>();\n  const owners = new Map<string, Session>();\n\n  const session = (token: G9SessionToken): Session => {\n    const s = sessions.get(token);\n    if (!s) throw new G9NodeSqliteError('misuse', 'The database session is closed or unknown.');\n    return s;\n  };\n\n  const prepare = (s: Session, sql: string): StatementSync => {\n    let statement = s.statements.get(sql);\n    if (!statement) {\n      statement = s.db.prepare(sql);\n      statement.setReadBigInts(true);\n      statement.setReturnArrays(true);\n      if (s.statements.size > 500) s.statements.clear();\n      s.statements.set(sql, statement);\n    }\n    return statement;\n  };\n\n  const execute = (s: Session, statement: G9DriverStatement, maxRows: number | undefined): G9SqlResult => {\n    const prepared = prepare(s, statement.sql);\n    const args = statement.params.map(bind);\n    const columns = prepared.columns().map((c) => c.name);\n    if (columns.length > 0) {\n      const rows: G9SqlValue[][] = [];\n      for (const row of prepared.iterate(...args) as Iterable<unknown[]>) {\n        if (maxRows !== undefined && rows.length >= maxRows) throw new G9NodeSqliteError('too-many-rows', `More than ${maxRows} rows.`);\n        rows.push(row.map(read));\n      }\n      return { columns, rows, changes: 0, lastInsertRowId: s.lastInsertRowId };\n    }\n    const result = prepared.run(...args);\n    s.lastInsertRowId = read(result.lastInsertRowid);\n    return { columns: [], rows: [], changes: Number(result.changes), lastInsertRowId: s.lastInsertRowId };\n  };\n\n  return {\n    name: options.name ?? 'node-sqlite',\n\n    async capabilities(): Promise<G9DriverCapabilities> {\n      const db = new DatabaseSync(':memory:');\n      try {\n        const row = db.prepare('SELECT sqlite_version() AS v').get() as { v: string };\n        return { sqliteVersion: row.v, maxVariables: 32766, json1: true, returning: true, upsert: true, interrupt: false };\n      } finally {\n        db.close();\n      }\n    },\n\n    async open(open: G9OpenOptions): Promise<G9SessionToken> {\n      const memory = open.path === ':memory:' || open.path === '';\n      if (!memory && !open.create && !existsSync(open.path)) throw new G9NodeSqliteError('not-found', `Database file does not exist: ${open.path}`);\n      if (!memory && open.create) mkdirSync(dirname(open.path), { recursive: true });\n      let db: DatabaseSync;\n      try {\n        db = new DatabaseSync(open.path || ':memory:', { readOnly: open.readOnly === true });\n      } catch (error) {\n        throw toError(error);\n      }\n      const pragmas = open.pragmas ?? {};\n      try {\n        if (pragmas.journalMode) db.exec(`PRAGMA journal_mode=${pragmas.journalMode.toUpperCase()}`);\n        db.exec(`PRAGMA synchronous=${open.durability === 'normal' ? 'NORMAL' : 'FULL'}`);\n        if (pragmas.busyTimeoutMs !== undefined) db.exec(`PRAGMA busy_timeout=${Math.max(0, Math.floor(pragmas.busyTimeoutMs))}`);\n        if (pragmas.foreignKeys !== undefined) db.exec(`PRAGMA foreign_keys=${pragmas.foreignKeys ? 'ON' : 'OFF'}`);\n      } catch (error) {\n        db.close();\n        throw toError(error);\n      }\n      const token = `node-session-${++seed}` as G9SessionToken;\n      sessions.set(token, { token, db, statements: new Map(), tx: null, lastInsertRowId: 0 });\n      return token;\n    },\n\n    async run(token: G9SessionToken, statements: readonly G9DriverStatement[], run: G9RunOptions = {}): Promise<G9SqlResult[]> {\n      const s = session(token);\n      if (run.tx !== undefined && s.tx !== run.tx) throw new G9NodeSqliteError('misuse', 'The transaction is finished or belongs to another session.');\n      if (run.tx === undefined && s.tx !== null) throw new G9NodeSqliteError('misuse', 'A transaction is open on this session; pass its token (tx).');\n      if (run.signal?.aborted) throw new G9NodeSqliteError('cancelled', 'Cancelled before the batch started.');\n      const atomic = run.atomic === true && run.tx === undefined && statements.length > 0;\n      if (atomic) s.db.exec('BEGIN');\n      const results: G9SqlResult[] = [];\n      try {\n        for (const statement of statements) {\n          try {\n            results.push(execute(s, statement, run.maxRows));\n          } catch (error) {\n            throw toError(error, statement.sql);\n          }\n        }\n        if (atomic) s.db.exec('COMMIT');\n      } catch (error) {\n        if (atomic) {\n          try {\n            s.db.exec('ROLLBACK');\n          } catch {\n            // already rolled back\n          }\n        }\n        throw toError(error);\n      }\n      return results;\n    },\n\n    async begin(token: G9SessionToken, mode: 'deferred' | 'immediate'): Promise<G9TxToken> {\n      const s = session(token);\n      if (s.tx !== null) throw new G9NodeSqliteError('misuse', 'A transaction is already open on this session.');\n      try {\n        s.db.exec(mode === 'immediate' ? 'BEGIN IMMEDIATE' : 'BEGIN DEFERRED');\n      } catch (error) {\n        throw toError(error);\n      }\n      const tx = `node-tx-${++seed}` as G9TxToken;\n      s.tx = tx;\n      owners.set(tx, s);\n      return tx;\n    },\n\n    async commit(tx: G9TxToken): Promise<void> {\n      const s = owners.get(tx);\n      if (!s || s.tx !== tx) throw new G9NodeSqliteError('misuse', 'The transaction is finished or unknown.');\n      try {\n        s.db.exec('COMMIT');\n      } catch (error) {\n        throw toError(error);\n      }\n      s.tx = null;\n      owners.delete(tx);\n    },\n\n    async rollback(tx: G9TxToken): Promise<void> {\n      const s = owners.get(tx);\n      if (!s || s.tx !== tx) throw new G9NodeSqliteError('misuse', 'The transaction is finished or unknown.');\n      s.tx = null;\n      owners.delete(tx);\n      try {\n        s.db.exec('ROLLBACK');\n      } catch {\n        // SQLite may already have rolled back\n      }\n    },\n\n    async close(token: G9SessionToken): Promise<void> {\n      const s = session(token);\n      sessions.delete(token);\n      if (s.tx) owners.delete(s.tx);\n      s.statements.clear();\n      s.db.close();\n    },\n  };\n}\n"]}