@g9tm/syncdata 1.2.1

package/dist/sqlite/connection.js

@@ -0,0 +1,322 @@
+// The store's data access over a G9SqliteDriver: the TypeScript twin of the C# helpers Exec / Scalar / Command and the
+// native layer's multi-statement commands. SQL keeps the .NET store's `$name` parameters; they are rewritten to numbered
+// `?N` placeholders (one number per name, so a name used twice binds once), and scripts are split into statements.
+import { G9Long } from '../abstractions/long.js';
+import { G9ELocalStoreFailure } from '../client/storeTypes.js';
+import { splitSql } from './sql.js';
+/** A SQLite failure raised by the store, classified for the engine (twin of `G9CSqliteException`). */
+export class G9SqliteStoreError extends Error {
+    constructor(message, driverCode, sqliteCode, cause) {
+        super(message);
+        this.name = 'G9SqliteStoreError';
+        this.driverCode = driverCode;
+        this.sqliteCode = sqliteCode;
+        if (cause !== undefined)
+            Object.defineProperty(this, 'cause', { value: cause, enumerable: false, writable: true, configurable: true });
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    /** ADR-0068: corrupt (11/26), full (13), busy/locked (5/6). */
+    get localStoreFailure() {
+        const code = this.sqliteCode !== null ? this.sqliteCode & 0xff : -1;
+        if (code === 11 || code === 26 || this.driverCode === 'corrupt')
+            return G9ELocalStoreFailure.Corrupt;
+        if (code === 13 || this.driverCode === 'full')
+            return G9ELocalStoreFailure.DiskFull;
+        if (code === 5 || code === 6 || this.driverCode === 'busy' || this.driverCode === 'locked')
+            return G9ELocalStoreFailure.Busy;
+        return G9ELocalStoreFailure.Other;
+    }
+}
+function wrap(error, sql) {
+    if (error instanceof G9SqliteStoreError)
+        return error;
+    const e = error;
+    if (e && typeof e === 'object' && (typeof e.code === 'string' || typeof e.sqliteCode === 'number')) {
+        const message = (typeof e.message === 'string' ? e.message : String(error)) + (sql ? ` [${sql.length > 160 ? sql.slice(0, 160) + '…' : sql}]` : '');
+        return new G9SqliteStoreError(message, typeof e.code === 'string' ? e.code : 'other', typeof e.sqliteCode === 'number' ? e.sqliteCode : null, error);
+    }
+    return error;
+}
+/** Converts a bind value to the driver's form. */
+export function toSqlValue(value) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value === 'boolean')
+        return value ? 1 : 0;
+    if (value instanceof G9Long)
+        return value.toSqlValue();
+    if (value instanceof Uint8Array) {
+        const copy = new Uint8Array(value.length);
+        copy.set(value);
+        return copy.buffer;
+    }
+    return value;
+}
+const compiled = new Map();
+/** Splits a script and rewrites `$name` parameters (outside strings, identifiers and comments) to `?N`. */
+export function compile(script) {
+    let entry = compiled.get(script);
+    if (entry)
+        return entry;
+    entry = { statements: splitSql(script).map(rewriteParameters) };
+    if (compiled.size > 2000)
+        compiled.clear();
+    compiled.set(script, entry);
+    return entry;
+}
+function rewriteParameters(sql) {
+    const names = [];
+    let out = '';
+    let i = 0;
+    const n = sql.length;
+    while (i < n) {
+        const c = sql.charAt(i);
+        if (c === "'" || c === '"') {
+            let j = i + 1;
+            while (j < n) {
+                if (sql.charAt(j) === c) {
+                    if (sql.charAt(j + 1) === c)
+                        j += 2;
+                    else
+                        break;
+                }
+                else
+                    j++;
+            }
+            out += sql.slice(i, j + 1);
+            i = j + 1;
+            continue;
+        }
+        if (c === '[') {
+            const close = sql.indexOf(']', i + 1);
+            const end = close < 0 ? n : close + 1;
+            out += sql.slice(i, end);
+            i = end;
+            continue;
+        }
+        if (c === '$' && i + 1 < n && /[A-Za-z0-9_]/.test(sql.charAt(i + 1))) {
+            let j = i + 1;
+            while (j < n && /[A-Za-z0-9_]/.test(sql.charAt(j)))
+                j++;
+            const name = sql.slice(i, j);
+            let index = names.indexOf(name);
+            if (index < 0) {
+                names.push(name);
+                index = names.length - 1;
+            }
+            out += '?' + (index + 1);
+            i = j;
+            continue;
+        }
+        out += c;
+        i++;
+    }
+    return { sql: out, names };
+}
+/** Statements of a script with their parameters bound by name. */
+export function statementsOf(script, params) {
+    const entry = compile(script);
+    return entry.statements.map((s) => ({
+        sql: s.sql,
+        params: s.names.map((name) => {
+            if (!params || !Object.prototype.hasOwnProperty.call(params, name))
+                throw new Error(`Must add a value for parameter '${name}'.`);
+            return toSqlValue(params[name]);
+        }),
+    }));
+}
+/** An async mutex (the SemaphoreSlim(1, 1) twin). */
+export class G9AsyncLock {
+    constructor() {
+        this._tail = Promise.resolve();
+    }
+    async run(action) {
+        let release;
+        const next = new Promise((resolve) => {
+            release = resolve;
+        });
+        const previous = this._tail;
+        this._tail = previous.then(() => next);
+        await previous;
+        try {
+            return await action();
+        }
+        finally {
+            release();
+        }
+    }
+}
+/** One driver session (a "connection") with the store's helpers. `tx` is the open transaction, if any. */
+export class G9SqliteConnection {
+    constructor(driver, session) {
+        this.tx = null;
+        this.driver = driver;
+        this.session = session;
+    }
+    /** Runs prepared driver statements in one bridge call. */
+    async runStatements(statements, signal) {
+        var _a;
+        if (statements.length === 0)
+            return [];
+        try {
+            return await this.driver.run(this.session, statements, this.tx ? { tx: this.tx, signal } : { signal });
+        }
+        catch (error) {
+            throw wrap(error, statements.length === 1 ? (_a = statements[0]) === null || _a === void 0 ? void 0 : _a.sql : undefined);
+        }
+    }
+    /** `ExecuteNonQuery`: the summed changes of every statement. */
+    async exec(script, params) {
+        const results = await this.runStatements(statementsOf(script, params));
+        let changes = 0;
+        for (const result of results)
+            changes += result.columns.length > 0 ? 0 : result.changes;
+        return changes;
+    }
+    /** Rows of the first row-producing statement (statements before it run first, like ExecuteReader). */
+    async query(script, params) {
+        const results = await this.runStatements(statementsOf(script, params));
+        for (const result of results)
+            if (result.columns.length > 0)
+                return result.rows;
+        return [];
+    }
+    /** First column of the first row, or null. */
+    async scalar(script, params) {
+        const rows = await this.query(script, params);
+        const row = rows[0];
+        return row && row.length > 0 ? row[0] : null;
+    }
+    /** `BEGIN IMMEDIATE` (or deferred) on this session. */
+    async begin(mode = 'immediate') {
+        if (this.tx)
+            throw new Error('A transaction is already open on this connection.');
+        try {
+            this.tx = await this.driver.begin(this.session, mode);
+        }
+        catch (error) {
+            throw wrap(error);
+        }
+    }
+    async commit() {
+        const tx = this.tx;
+        if (!tx)
+            throw new Error('No transaction is open.');
+        try {
+            await this.driver.commit(tx);
+            this.tx = null;
+        }
+        catch (error) {
+            throw wrap(error);
+        }
+    }
+    async rollback() {
+        const tx = this.tx;
+        if (!tx)
+            return;
+        this.tx = null;
+        try {
+            await this.driver.rollback(tx);
+        }
+        catch {
+            // SQLite may already have rolled back; the transaction is over either way.
+        }
+    }
+    /** Runs `action` in a transaction: committed when it returns, rolled back when it throws (the `using var transaction` pattern). */
+    async transaction(mode, action) {
+        await this.begin(mode);
+        try {
+            const result = await action();
+            if (this.tx)
+                await this.commit();
+            return result;
+        }
+        catch (error) {
+            await this.rollback();
+            throw error;
+        }
+    }
+}
+/** Collects statements and runs them in one driver call, handing each its result (the apply's batching). */
+export class G9StatementBatch {
+    constructor(connection, limit = 1500) {
+        this._statements = [];
+        this._callbacks = [];
+        this._connection = connection;
+        this._limit = limit;
+    }
+    get count() {
+        return this._statements.length;
+    }
+    /**
+     * Queues a script's statements; `callback` receives their results (in order) once the batch has run. Returns true when
+     * the batch is full and should be flushed.
+     */
+    add(script, params, callback) {
+        const statements = statementsOf(script, params);
+        const index = this._statements.length;
+        for (const statement of statements)
+            this._statements.push(statement);
+        this._callbacks.push(callback ? { index, callback: (all) => callback(all.slice(index, index + statements.length)) } : null);
+        return this._statements.length >= this._limit;
+    }
+    /** Queues prepared statements. */
+    addStatements(statements, callback) {
+        const index = this._statements.length;
+        for (const statement of statements)
+            this._statements.push(statement);
+        this._callbacks.push(callback ? { index, callback: (all) => callback(all.slice(index, index + statements.length)) } : null);
+        return this._statements.length >= this._limit;
+    }
+    async flush(signal) {
+        if (this._statements.length === 0)
+            return;
+        const statements = this._statements.splice(0, this._statements.length);
+        const callbacks = this._callbacks.splice(0, this._callbacks.length);
+        const results = await this._connection.runStatements(statements, signal);
+        for (const entry of callbacks)
+            if (entry)
+                entry.callback(results);
+    }
+}
+/** Reads an INTEGER cell as a number (an int64 tag rounds; the store's counters are far below 2^53). */
+export function asNumber(value) {
+    if (value === null || value === undefined)
+        return 0;
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string')
+        return Number(value);
+    if (value instanceof ArrayBuffer)
+        return 0;
+    return Number(value.int64);
+}
+/** Reads an INTEGER cell exactly. */
+export function asLong(value) {
+    var _a;
+    if (value === null || value === undefined)
+        return G9Long.ZERO;
+    if (typeof value === 'number')
+        return G9Long.fromNumber(Math.trunc(value));
+    if (typeof value === 'string')
+        return (_a = G9Long.tryParse(value)) !== null && _a !== void 0 ? _a : G9Long.ZERO;
+    if (value instanceof ArrayBuffer)
+        return G9Long.ZERO;
+    return G9Long.parse(value.int64);
+}
+/** Reads a TEXT cell (`GetString`: SQLite's text form of a number, as JavaScript prints it). */
+export function asString(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number')
+        return String(value);
+    if (value instanceof ArrayBuffer)
+        return '';
+    return value.int64;
+}
+export function asOptionalString(value) {
+    return value === null || value === undefined ? null : asString(value);
+}
+//# sourceMappingURL=connection.js.map

package/dist/sqlite/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/sqlite/connection.ts"],"names":[],"mappings":"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","sourcesContent":["// The store's data access over a G9SqliteDriver: the TypeScript twin of the C# helpers Exec / Scalar / Command and the\n// native layer's multi-statement commands. SQL keeps the .NET store's `$name` parameters; they are rewritten to numbered\n// `?N` placeholders (one number per name, so a name used twice binds once), and scripts are split into statements.\nimport { G9Long } from '../abstractions/long.js';\nimport { G9ELocalStoreFailure, type G9SyncLocalStoreFailure } from '../client/storeTypes.js';\nimport type { G9DriverStatement, G9SessionToken, G9SqlResult, G9SqlValue, G9SqliteDriver, G9TxToken } from './driver.js';\nimport { splitSql } from './sql.js';\n\n/** A parameter value the store binds. */\nexport type G9BindValue = G9SqlValue | boolean | G9Long | Uint8Array | undefined;\n\nexport type G9Params = { [name: string]: G9BindValue };\n\n/** A SQLite failure raised by the store, classified for the engine (twin of `G9CSqliteException`). */\nexport class G9SqliteStoreError extends Error implements G9SyncLocalStoreFailure {\n  /** The driver's error code (`busy`, `corrupt`, `full`, `constraint`, …). */\n  readonly driverCode: string;\n  /** SQLite's primary result code when the driver reported one. */\n  readonly sqliteCode: number | null;\n\n  constructor(message: string, driverCode: string, sqliteCode: number | null, cause?: unknown) {\n    super(message);\n    this.name = 'G9SqliteStoreError';\n    this.driverCode = driverCode;\n    this.sqliteCode = sqliteCode;\n    if (cause !== undefined) Object.defineProperty(this, 'cause', { value: cause, enumerable: false, writable: true, configurable: true });\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  /** ADR-0068: corrupt (11/26), full (13), busy/locked (5/6). */\n  get localStoreFailure(): G9ELocalStoreFailure {\n    const code = this.sqliteCode !== null ? this.sqliteCode & 0xff : -1;\n    if (code === 11 || code === 26 || this.driverCode === 'corrupt') return G9ELocalStoreFailure.Corrupt;\n    if (code === 13 || this.driverCode === 'full') return G9ELocalStoreFailure.DiskFull;\n    if (code === 5 || code === 6 || this.driverCode === 'busy' || this.driverCode === 'locked') return G9ELocalStoreFailure.Busy;\n    return G9ELocalStoreFailure.Other;\n  }\n}\n\nfunction wrap(error: unknown, sql?: string): unknown {\n  if (error instanceof G9SqliteStoreError) return error;\n  const e = error as { code?: unknown; sqliteCode?: unknown; message?: unknown; name?: unknown };\n  if (e && typeof e === 'object' && (typeof e.code === 'string' || typeof e.sqliteCode === 'number')) {\n    const message = (typeof e.message === 'string' ? e.message : String(error)) + (sql ? ` [${sql.length > 160 ? sql.slice(0, 160) + '…' : sql}]` : '');\n    return new G9SqliteStoreError(message, typeof e.code === 'string' ? e.code : 'other', typeof e.sqliteCode === 'number' ? e.sqliteCode : null, error);\n  }\n  return error;\n}\n\n/** Converts a bind value to the driver's form. */\nexport function toSqlValue(value: G9BindValue): G9SqlValue {\n  if (value === undefined || value === null) return null;\n  if (typeof value === 'boolean') return value ? 1 : 0;\n  if (value instanceof G9Long) return value.toSqlValue();\n  if (value instanceof Uint8Array) {\n    const copy = new Uint8Array(value.length);\n    copy.set(value);\n    return copy.buffer;\n  }\n  return value;\n}\n\ninterface Compiled {\n  statements: { sql: string; names: string[] }[];\n}\n\nconst compiled = new Map<string, Compiled>();\n\n/** Splits a script and rewrites `$name` parameters (outside strings, identifiers and comments) to `?N`. */\nexport function compile(script: string): Compiled {\n  let entry = compiled.get(script);\n  if (entry) return entry;\n  entry = { statements: splitSql(script).map(rewriteParameters) };\n  if (compiled.size > 2000) compiled.clear();\n  compiled.set(script, entry);\n  return entry;\n}\n\nfunction rewriteParameters(sql: string): { sql: string; names: string[] } {\n  const names: string[] = [];\n  let out = '';\n  let i = 0;\n  const n = sql.length;\n  while (i < n) {\n    const c = sql.charAt(i);\n    if (c === \"'\" || c === '\"') {\n      let j = i + 1;\n      while (j < n) {\n        if (sql.charAt(j) === c) {\n          if (sql.charAt(j + 1) === c) j += 2;\n          else break;\n        } else j++;\n      }\n      out += sql.slice(i, j + 1);\n      i = j + 1;\n      continue;\n    }\n    if (c === '[') {\n      const close = sql.indexOf(']', i + 1);\n      const end = close < 0 ? n : close + 1;\n      out += sql.slice(i, end);\n      i = end;\n      continue;\n    }\n    if (c === '$' && i + 1 < n && /[A-Za-z0-9_]/.test(sql.charAt(i + 1))) {\n      let j = i + 1;\n      while (j < n && /[A-Za-z0-9_]/.test(sql.charAt(j))) j++;\n      const name = sql.slice(i, j);\n      let index = names.indexOf(name);\n      if (index < 0) {\n        names.push(name);\n        index = names.length - 1;\n      }\n      out += '?' + (index + 1);\n      i = j;\n      continue;\n    }\n    out += c;\n    i++;\n  }\n  return { sql: out, names };\n}\n\n/** Statements of a script with their parameters bound by name. */\nexport function statementsOf(script: string, params?: G9Params): G9DriverStatement[] {\n  const entry = compile(script);\n  return entry.statements.map((s) => ({\n    sql: s.sql,\n    params: s.names.map((name) => {\n      if (!params || !Object.prototype.hasOwnProperty.call(params, name)) throw new Error(`Must add a value for parameter '${name}'.`);\n      return toSqlValue(params[name]);\n    }),\n  }));\n}\n\n/** An async mutex (the SemaphoreSlim(1, 1) twin). */\nexport class G9AsyncLock {\n  private _tail: Promise<void> = Promise.resolve();\n\n  async run<T>(action: () => Promise<T>): Promise<T> {\n    let release!: () => void;\n    const next = new Promise<void>((resolve) => {\n      release = resolve;\n    });\n    const previous = this._tail;\n    this._tail = previous.then(() => next);\n    await previous;\n    try {\n      return await action();\n    } finally {\n      release();\n    }\n  }\n}\n\n/** One driver session (a \"connection\") with the store's helpers. `tx` is the open transaction, if any. */\nexport class G9SqliteConnection {\n  readonly driver: G9SqliteDriver;\n  readonly session: G9SessionToken;\n  tx: G9TxToken | null = null;\n\n  constructor(driver: G9SqliteDriver, session: G9SessionToken) {\n    this.driver = driver;\n    this.session = session;\n  }\n\n  /** Runs prepared driver statements in one bridge call. */\n  async runStatements(statements: readonly G9DriverStatement[], signal?: AbortSignal): Promise<G9SqlResult[]> {\n    if (statements.length === 0) return [];\n    try {\n      return await this.driver.run(this.session, statements, this.tx ? { tx: this.tx, signal } : { signal });\n    } catch (error) {\n      throw wrap(error, statements.length === 1 ? statements[0]?.sql : undefined);\n    }\n  }\n\n  /** `ExecuteNonQuery`: the summed changes of every statement. */\n  async exec(script: string, params?: G9Params): Promise<number> {\n    const results = await this.runStatements(statementsOf(script, params));\n    let changes = 0;\n    for (const result of results) changes += result.columns.length > 0 ? 0 : result.changes;\n    return changes;\n  }\n\n  /** Rows of the first row-producing statement (statements before it run first, like ExecuteReader). */\n  async query(script: string, params?: G9Params): Promise<(readonly G9SqlValue[])[]> {\n    const results = await this.runStatements(statementsOf(script, params));\n    for (const result of results) if (result.columns.length > 0) return result.rows as (readonly G9SqlValue[])[];\n    return [];\n  }\n\n  /** First column of the first row, or null. */\n  async scalar(script: string, params?: G9Params): Promise<G9SqlValue> {\n    const rows = await this.query(script, params);\n    const row = rows[0];\n    return row && row.length > 0 ? (row[0] as G9SqlValue) : null;\n  }\n\n  /** `BEGIN IMMEDIATE` (or deferred) on this session. */\n  async begin(mode: 'deferred' | 'immediate' = 'immediate'): Promise<void> {\n    if (this.tx) throw new Error('A transaction is already open on this connection.');\n    try {\n      this.tx = await this.driver.begin(this.session, mode);\n    } catch (error) {\n      throw wrap(error);\n    }\n  }\n\n  async commit(): Promise<void> {\n    const tx = this.tx;\n    if (!tx) throw new Error('No transaction is open.');\n    try {\n      await this.driver.commit(tx);\n      this.tx = null;\n    } catch (error) {\n      throw wrap(error);\n    }\n  }\n\n  async rollback(): Promise<void> {\n    const tx = this.tx;\n    if (!tx) return;\n    this.tx = null;\n    try {\n      await this.driver.rollback(tx);\n    } catch {\n      // SQLite may already have rolled back; the transaction is over either way.\n    }\n  }\n\n  /** Runs `action` in a transaction: committed when it returns, rolled back when it throws (the `using var transaction` pattern). */\n  async transaction<T>(mode: 'deferred' | 'immediate', action: () => Promise<T>): Promise<T> {\n    await this.begin(mode);\n    try {\n      const result = await action();\n      if (this.tx) await this.commit();\n      return result;\n    } catch (error) {\n      await this.rollback();\n      throw error;\n    }\n  }\n}\n\n/** Collects statements and runs them in one driver call, handing each its result (the apply's batching). */\nexport class G9StatementBatch {\n  private readonly _connection: G9SqliteConnection;\n  private readonly _statements: G9DriverStatement[] = [];\n  private readonly _callbacks: ({ index: number; callback: (results: G9SqlResult[]) => void } | null)[] = [];\n  private readonly _limit: number;\n\n  constructor(connection: G9SqliteConnection, limit = 1500) {\n    this._connection = connection;\n    this._limit = limit;\n  }\n\n  get count(): number {\n    return this._statements.length;\n  }\n\n  /**\n   * Queues a script's statements; `callback` receives their results (in order) once the batch has run. Returns true when\n   * the batch is full and should be flushed.\n   */\n  add(script: string, params?: G9Params, callback?: (results: G9SqlResult[]) => void): boolean {\n    const statements = statementsOf(script, params);\n    const index = this._statements.length;\n    for (const statement of statements) this._statements.push(statement);\n    this._callbacks.push(callback ? { index, callback: (all) => callback(all.slice(index, index + statements.length)) } : null);\n    return this._statements.length >= this._limit;\n  }\n\n  /** Queues prepared statements. */\n  addStatements(statements: readonly G9DriverStatement[], callback?: (results: G9SqlResult[]) => void): boolean {\n    const index = this._statements.length;\n    for (const statement of statements) this._statements.push(statement);\n    this._callbacks.push(callback ? { index, callback: (all) => callback(all.slice(index, index + statements.length)) } : null);\n    return this._statements.length >= this._limit;\n  }\n\n  async flush(signal?: AbortSignal): Promise<void> {\n    if (this._statements.length === 0) return;\n    const statements = this._statements.splice(0, this._statements.length);\n    const callbacks = this._callbacks.splice(0, this._callbacks.length);\n    const results = await this._connection.runStatements(statements, signal);\n    for (const entry of callbacks) if (entry) entry.callback(results);\n  }\n}\n\n/** Reads an INTEGER cell as a number (an int64 tag rounds; the store's counters are far below 2^53). */\nexport function asNumber(value: G9SqlValue | undefined): number {\n  if (value === null || value === undefined) return 0;\n  if (typeof value === 'number') return value;\n  if (typeof value === 'string') return Number(value);\n  if (value instanceof ArrayBuffer) return 0;\n  return Number(value.int64);\n}\n\n/** Reads an INTEGER cell exactly. */\nexport function asLong(value: G9SqlValue | undefined): G9Long {\n  if (value === null || value === undefined) return G9Long.ZERO;\n  if (typeof value === 'number') return G9Long.fromNumber(Math.trunc(value));\n  if (typeof value === 'string') return G9Long.tryParse(value) ?? G9Long.ZERO;\n  if (value instanceof ArrayBuffer) return G9Long.ZERO;\n  return G9Long.parse(value.int64);\n}\n\n/** Reads a TEXT cell (`GetString`: SQLite's text form of a number, as JavaScript prints it). */\nexport function asString(value: G9SqlValue | undefined): string {\n  if (value === null || value === undefined) return '';\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number') return String(value);\n  if (value instanceof ArrayBuffer) return '';\n  return value.int64;\n}\n\nexport function asOptionalString(value: G9SqlValue | undefined): string | null {\n  return value === null || value === undefined ? null : asString(value);\n}\n"]}

package/dist/sqlite/driver.d.ts

@@ -0,0 +1,63 @@
+/** An int64 outside ±(2^53 − 1), tagged so it is never mistaken for text. */
+export interface G9Int64Tag {
+    readonly int64: string;
+}
+/** A value crossing the driver boundary: null, a number, text, a BLOB (ArrayBuffer) or an int64 tag. */
+export type G9SqlValue = null | number | string | ArrayBuffer | G9Int64Tag;
+export interface G9DriverStatement {
+    readonly sql: string;
+    readonly params: readonly G9SqlValue[];
+}
+export interface G9SqlResult {
+    readonly columns: readonly string[];
+    readonly rows: readonly (readonly G9SqlValue[])[];
+    readonly changes: number;
+    readonly lastInsertRowId: G9SqlValue;
+}
+export type G9SessionToken = string & {
+    readonly __g9Session: true;
+};
+export type G9TxToken = string & {
+    readonly __g9Tx: true;
+};
+export interface G9ConnectionPragmas {
+    readonly journalMode?: 'wal' | 'delete' | 'truncate' | 'memory';
+    readonly busyTimeoutMs?: number;
+    readonly foreignKeys?: boolean;
+    readonly tempStore?: 'memory' | 'file' | 'default';
+    readonly cacheSize?: number;
+    readonly mmapSize?: number;
+}
+export interface G9OpenOptions {
+    readonly path: string;
+    readonly readOnly?: boolean;
+    readonly create?: boolean;
+    readonly durability?: 'full' | 'normal';
+    readonly pragmas?: G9ConnectionPragmas;
+}
+export interface G9RunOptions {
+    readonly tx?: G9TxToken;
+    readonly signal?: AbortSignal;
+    readonly maxRows?: number;
+    readonly atomic?: boolean;
+}
+export interface G9DriverCapabilities {
+    readonly sqliteVersion: string;
+    readonly maxVariables: number;
+    readonly json1: boolean;
+    readonly returning: boolean;
+    readonly upsert: boolean;
+    readonly interrupt: boolean;
+}
+export interface G9SqliteDriver {
+    readonly name: string;
+    capabilities(): Promise<G9DriverCapabilities>;
+    open(options: G9OpenOptions): Promise<G9SessionToken>;
+    run(session: G9SessionToken, statements: readonly G9DriverStatement[], options?: G9RunOptions): Promise<G9SqlResult[]>;
+    begin(session: G9SessionToken, mode: 'deferred' | 'immediate'): Promise<G9TxToken>;
+    commit(tx: G9TxToken): Promise<void>;
+    rollback(tx: G9TxToken): Promise<void>;
+    close(session: G9SessionToken): Promise<void>;
+}
+/** True for an `{ int64 }` tag. */
+export declare function isInt64Tag(value: unknown): value is G9Int64Tag;

package/dist/sqlite/driver.js

@@ -0,0 +1,9 @@
+// The SQLite driver boundary, structurally identical to G9LynxControls' `G9SqliteDriver` (@g9lynx/sqlite,
+// driver/types.ts): the Lynx native driver (Android androidx.sqlite bundled, iOS), the Lynxtron driver and the Node
+// reference driver all satisfy it, and this package depends on none of them. One `run` = one bridge round trip for N
+// statements, each statement ONE SQL statement with `?` placeholders.
+/** True for an `{ int64 }` tag. */
+export function isInt64Tag(value) {
+    return typeof value === 'object' && value !== null && !(value instanceof ArrayBuffer) && typeof value.int64 === 'string';
+}
+//# sourceMappingURL=driver.js.map

package/dist/sqlite/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/sqlite/driver.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,oHAAoH;AACpH,qHAAqH;AACrH,sEAAsE;AAqEtE,mCAAmC;AACnC,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC,IAAI,OAAQ,KAA6B,CAAC,KAAK,KAAK,QAAQ,CAAC;AACpJ,CAAC","sourcesContent":["// The SQLite driver boundary, structurally identical to G9LynxControls' `G9SqliteDriver` (@g9lynx/sqlite,\n// driver/types.ts): the Lynx native driver (Android androidx.sqlite bundled, iOS), the Lynxtron driver and the Node\n// reference driver all satisfy it, and this package depends on none of them. One `run` = one bridge round trip for N\n// statements, each statement ONE SQL statement with `?` placeholders.\n\n/** An int64 outside ±(2^53 − 1), tagged so it is never mistaken for text. */\nexport interface G9Int64Tag {\n  readonly int64: string;\n}\n\n/** A value crossing the driver boundary: null, a number, text, a BLOB (ArrayBuffer) or an int64 tag. */\nexport type G9SqlValue = null | number | string | ArrayBuffer | G9Int64Tag;\n\nexport interface G9DriverStatement {\n  readonly sql: string;\n  readonly params: readonly G9SqlValue[];\n}\n\nexport interface G9SqlResult {\n  readonly columns: readonly string[];\n  readonly rows: readonly (readonly G9SqlValue[])[];\n  readonly changes: number;\n  readonly lastInsertRowId: G9SqlValue;\n}\n\nexport type G9SessionToken = string & { readonly __g9Session: true };\nexport type G9TxToken = string & { readonly __g9Tx: true };\n\nexport interface G9ConnectionPragmas {\n  readonly journalMode?: 'wal' | 'delete' | 'truncate' | 'memory';\n  readonly busyTimeoutMs?: number;\n  readonly foreignKeys?: boolean;\n  readonly tempStore?: 'memory' | 'file' | 'default';\n  readonly cacheSize?: number;\n  readonly mmapSize?: number;\n}\n\nexport interface G9OpenOptions {\n  readonly path: string;\n  readonly readOnly?: boolean;\n  readonly create?: boolean;\n  readonly durability?: 'full' | 'normal';\n  readonly pragmas?: G9ConnectionPragmas;\n}\n\nexport interface G9RunOptions {\n  readonly tx?: G9TxToken;\n  readonly signal?: AbortSignal;\n  readonly maxRows?: number;\n  readonly atomic?: boolean;\n}\n\nexport interface G9DriverCapabilities {\n  readonly sqliteVersion: string;\n  readonly maxVariables: number;\n  readonly json1: boolean;\n  readonly returning: boolean;\n  readonly upsert: boolean;\n  readonly interrupt: boolean;\n}\n\nexport interface G9SqliteDriver {\n  readonly name: string;\n  capabilities(): Promise<G9DriverCapabilities>;\n  open(options: G9OpenOptions): Promise<G9SessionToken>;\n  run(session: G9SessionToken, statements: readonly G9DriverStatement[], options?: G9RunOptions): Promise<G9SqlResult[]>;\n  begin(session: G9SessionToken, mode: 'deferred' | 'immediate'): Promise<G9TxToken>;\n  commit(tx: G9TxToken): Promise<void>;\n  rollback(tx: G9TxToken): Promise<void>;\n  close(session: G9SessionToken): Promise<void>;\n}\n\n/** True for an `{ int64 }` tag. */\nexport function isInt64Tag(value: unknown): value is G9Int64Tag {\n  return typeof value === 'object' && value !== null && !(value instanceof ArrayBuffer) && typeof (value as { int64?: unknown }).int64 === 'string';\n}\n"]}

package/dist/sqlite/index.d.ts

@@ -0,0 +1,6 @@
+export { G9SqliteSyncStore, type G9PendingExport } from './store.js';
+export { fileIncarnationMarker, type G9IncarnationMarker, type G9MarkerFileSystem, type G9SqliteSyncStoreOptions, type G9ResolvedSqliteStoreOptions, } from './options.js';
+export { G9ESqliteDateTimeStorage, G9ESqliteDecimalStorage, splitSql } from './sql.js';
+export { G9SqliteStoreError } from './connection.js';
+export { formatTicks, formatDateTimeOffset, parseDateTime, parseDateTimeOffset, ticksOf, ticksToUnixMs } from './values.js';
+export type { G9ConnectionPragmas, G9DriverCapabilities, G9DriverStatement, G9Int64Tag, G9OpenOptions, G9RunOptions, G9SessionToken, G9SqlResult, G9SqlValue, G9SqliteDriver, G9TxToken, } from './driver.js';

package/dist/sqlite/index.js

@@ -0,0 +1,7 @@
+// @g9tm/syncdata/sqlite — the SQLite client store (twin of G9SyncData.Client.Sqlite) over the G9SqliteDriver contract.
+export { G9SqliteSyncStore } from './store.js';
+export { fileIncarnationMarker, } from './options.js';
+export { G9ESqliteDateTimeStorage, G9ESqliteDecimalStorage, splitSql } from './sql.js';
+export { G9SqliteStoreError } from './connection.js';
+export { formatTicks, formatDateTimeOffset, parseDateTime, parseDateTimeOffset, ticksOf, ticksToUnixMs } from './values.js';
+//# sourceMappingURL=index.js.map

package/dist/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,OAAO,EAAE,iBAAiB,EAAwB,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,qBAAqB,GAKtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC","sourcesContent":["// @g9tm/syncdata/sqlite — the SQLite client store (twin of G9SyncData.Client.Sqlite) over the G9SqliteDriver contract.\nexport { G9SqliteSyncStore, type G9PendingExport } from './store.js';\nexport {\n  fileIncarnationMarker,\n  type G9IncarnationMarker,\n  type G9MarkerFileSystem,\n  type G9SqliteSyncStoreOptions,\n  type G9ResolvedSqliteStoreOptions,\n} from './options.js';\nexport { G9ESqliteDateTimeStorage, G9ESqliteDecimalStorage, splitSql } from './sql.js';\nexport { G9SqliteStoreError } from './connection.js';\nexport { formatTicks, formatDateTimeOffset, parseDateTime, parseDateTimeOffset, ticksOf, ticksToUnixMs } from './values.js';\nexport type {\n  G9ConnectionPragmas,\n  G9DriverCapabilities,\n  G9DriverStatement,\n  G9Int64Tag,\n  G9OpenOptions,\n  G9RunOptions,\n  G9SessionToken,\n  G9SqlResult,\n  G9SqlValue,\n  G9SqliteDriver,\n  G9TxToken,\n} from './driver.js';\n"]}

package/dist/sqlite/internals.d.ts

@@ -0,0 +1,63 @@
+import { G9SyncException } from '../abstractions/errors.js';
+import type { G9SyncClientModel, G9SyncClientTable } from '../client/model.js';
+import type { G9SyncLogger, G9SyncLogLevel } from '../client/runs.js';
+import { type G9SyncSubscriptionRecord } from '../client/storeTypes.js';
+import type { G9DtNegotiatedTable } from '../protocol/dtos.js';
+import { type G9AsyncLock, type G9SqliteConnection } from './connection.js';
+import { type G9SqlValue } from './driver.js';
+import type { G9ResolvedSqliteStoreOptions } from './options.js';
+/** A table of the model with its local metadata (`LocalTable`). */
+export declare class LocalTable {
+    readonly model: G9SyncClientTable;
+    readonly tid: number;
+    negotiated: G9DtNegotiatedTable | null;
+    syncedColumns: string[];
+    constructor(model: G9SyncClientTable, tid: number, negotiated: G9DtNegotiatedTable | null, syncedColumns: string[]);
+    get quoted(): string;
+    get keyQuoted(): string;
+}
+/** What the store's parts share. */
+export interface StoreInternals {
+    readonly options: G9ResolvedSqliteStoreOptions;
+    readonly writeLock: G9AsyncLock;
+    /** The connection library writes go through (under the write lock). */
+    writer(): G9SqliteConnection;
+    /** A connection for reads that never wait on a running write. */
+    reader(): G9SqliteConnection;
+    ensureInitialized(): G9SyncClientModel;
+    byLocal: Map<string, LocalTable>;
+    byServerId: Map<number, LocalTable>;
+    log(level: G9SyncLogLevel, eventId: number, message: string, error?: unknown): void;
+}
+export declare function logTo(logger: G9SyncLogger | null, level: G9SyncLogLevel, eventId: number, message: string, error?: unknown): void;
+export declare function nowMs(): number;
+export declare function meta(connection: G9SqliteConnection, key: string): Promise<string | null>;
+export declare function setMeta(connection: G9SqliteConnection, key: string, value: string | null): Promise<void>;
+/** `KeyValue`: the key in the table's storage form (integers for an integer key). */
+export declare function keyValue(table: LocalTable, canonicalKey: string): G9SqlValue;
+export declare function getLocal(store: StoreInternals, localName: string): LocalTable;
+export declare function findByServerName(store: StoreInternals, serverName: string): LocalTable | null;
+export declare function byTid(store: StoreInternals, tid: number): LocalTable | null;
+/** Reads subscriptions, all or one key, oldest first. */
+export declare function readSubscriptions(connection: G9SqliteConnection, key: string | null): Promise<G9SyncSubscriptionRecord[]>;
+/**
+ * JSON of a persisted DTO in the form .NET's source-generated context writes (camelCase, nulls omitted), so a database
+ * written by either side reads on the other.
+ */
+export declare function persistedJson(value: unknown): string;
+export declare function readPersistedNegotiated(json: string | null): G9DtNegotiatedTable | null;
+export declare function readPersistedDefinitions(json: string | null): import("../protocol/dtos.js").G9DtSubscriptionDefinition[];
+/** SQLite values as JSON (`SerializeValues`): text as strings, numbers as numbers, blobs as `{"$b64": "…"}`. */
+export declare function serializeValues(values: {
+    [column: string]: unknown;
+}): string;
+/** `DeserializeValues`: numbers as integers when they are, int64 beyond 2^53 as tags, `{"$b64"}` as BLOBs. */
+export declare function deserializeValues(json: string): {
+    [column: string]: G9SqlValue;
+};
+/** Reads every column of a local row (`ReadLocalValues`): column name → stored value; empty when the row is gone. */
+export declare function readLocalValues(connection: G9SqliteConnection, table: LocalTable, key: string): Promise<{
+    [column: string]: G9SqlValue;
+}>;
+/** A store error that the engine maps to G9S-LOCAL-STORE. */
+export declare function storeError(message: string): G9SyncException;