@webority/mobile-core 0.0.29 → 0.2.0

package/lib/module/sqlite/index.js

@@ -1,594 +1 @@
-"use strict";
-
-import * as ExpoSqlite from 'expo-sqlite';
-import { Logger } from "../logger/index.js";
-import { adaptExpoSqlite } from "./adapters/expo.js";
-
-/**
- * expo-sqlite is the fleet's only sanctioned SQLite driver (react-native.md:
- * "we will always use expo-sqlite, what Expo gives, we don't look elsewhere
- * ever") — this module resolves it automatically, with no app-side wiring.
- * `setSqliteImplementation` still exists, narrowed to tests and the showcase:
- * it injects a denying/failing backend to reach error paths a healthy device
- * never takes, the same pattern every other injectable surface in this
- * library follows. It is not a way to pick an alternate real driver.
- */
-
-/** Only what a test or an app injected; null means use expo-sqlite. */
-let backend = null;
-
-/** expo-sqlite, adapted once and memoised. The only driver this module resolves. */
-let expoDriver;
-
-/**
- * Test/showcase-only injection point — see the module header. Not a way to
- * pick an alternate real driver; `@webority/mobile-core` always
- * resolves expo-sqlite when nothing is injected. Pass `null` to clear it.
- */
-export const setSqliteImplementation = impl => {
-  backend = impl;
-};
-
-/**
- * expo-sqlite is a required peer, so the JS module always resolves. What can be
- * missing is the NATIVE side: an app that installed the package without running
- * the native install gets a module without the one call the adapter needs.
- * Checking it is what lets `isSqliteAvailable` mean something and makes the
- * error below reachable.
- *
- * An INJECTED driver is taken on trust, like every other seam in this package.
- */
-const hasNativeSqlite = mod => typeof mod?.openDatabaseAsync === 'function';
-const resolveDriver = () => {
-  if (backend) {
-    return backend;
-  }
-  if (expoDriver === undefined) {
-    const mod = ExpoSqlite;
-    expoDriver = hasNativeSqlite(mod) ? adaptExpoSqlite(mod) : null;
-  }
-  return expoDriver;
-};
-export const isSqliteAvailable = () => resolveDriver() !== null;
-const requireBackend = op => {
-  const b = resolveDriver();
-  if (!b) {
-    const err = new Error(`[@webority/mobile-core] No SQLite driver available; cannot ${op}. ` + 'Install expo-sqlite (the only sanctioned driver) in the consuming app.');
-    Logger.error(err.message);
-    throw err;
-  }
-  return b;
-};
-
-/** The ledger of applied migrations. Never emptied by `wipe`. */
-export const MIGRATIONS_TABLE = '_webority_migrations';
-const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
-
-/**
- * SQLite cannot bind an identifier to `?`, so every table/column name reaching
- * a statement is concatenated. This is the ONE place that is allowed to happen,
- * and it throws rather than quoting a hostile name into something executable.
- */
-export const assertSqlIdentifier = (value, kind = 'identifier') => {
-  if (typeof value !== 'string' || !IDENTIFIER.test(value)) {
-    throw new Error(`[@webority/mobile-core] Invalid SQL ${kind} ${JSON.stringify(value)}. ` + 'Only letters, digits and underscores are allowed, and it must not start with a digit. ' + 'Pass values as bound parameters instead of building them into the name.');
-  }
-  return value;
-};
-const quoteIdentifier = (value, kind = 'identifier') => `"${assertSqlIdentifier(value, kind)}"`;
-
-/** For names read back out of sqlite_master, which may legitimately be quoted. */
-const escapeIdentifier = value => `"${value.replace(/"/g, '""')}"`;
-const COLUMN_DEFINITION = /^[A-Za-z0-9_ ,.()'"+*/=<>|%:$-]+$/;
-const assertColumnDefinition = (definition, column) => {
-  const trimmed = typeof definition === 'string' ? definition.trim() : '';
-  if (trimmed.length === 0 || !COLUMN_DEFINITION.test(trimmed) || trimmed.includes('--')) {
-    throw new Error(`[@webority/mobile-core] Invalid column definition for "${column}": ` + `${JSON.stringify(definition)}. A definition is raw SQL such as ` + "'INTEGER NOT NULL DEFAULT 0' and may not contain a statement separator or a comment.");
-  }
-  return trimmed;
-};
-
-/** Normalise a JS value into something every SQLite driver can bind. */
-export const toSqliteValue = value => {
-  if (value === undefined) {
-    return null;
-  }
-  if (typeof value === 'boolean') {
-    return value ? 1 : 0;
-  }
-  if (value instanceof Date) {
-    return value.toISOString();
-  }
-  return value;
-};
-
-/** SQLite has no boolean type, so a stored flag comes back as 0/1 or '0'/'1'. */
-export const fromSqliteBoolean = value => {
-  if (typeof value === 'boolean') {
-    return value;
-  }
-  if (typeof value === 'number') {
-    return value !== 0;
-  }
-  if (typeof value === 'string') {
-    const normalised = value.trim().toLowerCase();
-    return normalised === '1' || normalised === 'true';
-  }
-  return false;
-};
-
-/**
- * Build an `IN (...)` clause with one placeholder per value. An empty list
- * yields a clause that matches nothing, because `IN ()` is a syntax error.
- */
-export const whereIn = (column, values) => {
-  const quoted = quoteIdentifier(column, 'column name');
-  if (values.length === 0) {
-    return {
-      sql: '1 = 0',
-      params: []
-    };
-  }
-  return {
-    sql: `${quoted} IN (${values.map(() => '?').join(', ')})`,
-    params: values.map(toSqliteValue)
-  };
-};
-
-/**
- * Either a map of column to value (ANDed, `null` meaning IS NULL) or a raw
- * fragment for anything the object form cannot express.
- */
-
-const isRawWhere = where => typeof where.sql === 'string' && Object.keys(where).every(key => key === 'sql' || key === 'params');
-const buildWhere = where => {
-  if (!where) {
-    return {
-      clause: '',
-      params: []
-    };
-  }
-  if (isRawWhere(where)) {
-    const sql = where.sql.trim();
-    if (sql.length === 0) {
-      return {
-        clause: '',
-        params: []
-      };
-    }
-    return {
-      clause: ` WHERE ${sql}`,
-      params: [...(where.params ?? [])]
-    };
-  }
-  const entries = Object.entries(where);
-  if (entries.length === 0) {
-    return {
-      clause: '',
-      params: []
-    };
-  }
-  const parts = [];
-  const params = [];
-  for (const [column, rawValue] of entries) {
-    const quoted = quoteIdentifier(column, 'column name');
-    const value = toSqliteValue(rawValue);
-    if (value === null) {
-      parts.push(`${quoted} IS NULL`);
-    } else {
-      parts.push(`${quoted} = ?`);
-      params.push(value);
-    }
-  }
-  return {
-    clause: ` WHERE ${parts.join(' AND ')}`,
-    params
-  };
-};
-const buildOrderBy = orderBy => {
-  if (orderBy === undefined) {
-    return '';
-  }
-  const terms = orderBy.split(',').map(term => term.trim()).filter(term => term.length > 0);
-  if (terms.length === 0) {
-    return '';
-  }
-  const rendered = terms.map(term => {
-    const [column, direction, ...rest] = term.split(/\s+/);
-    if (rest.length > 0) {
-      throw new Error(`[@webority/mobile-core] Invalid orderBy term ${JSON.stringify(term)}. ` + 'Expected a column name optionally followed by ASC or DESC.');
-    }
-    const quoted = quoteIdentifier(column, 'orderBy column');
-    if (direction === undefined) {
-      return quoted;
-    }
-    const upper = direction.toUpperCase();
-    if (upper !== 'ASC' && upper !== 'DESC') {
-      throw new Error(`[@webority/mobile-core] Invalid sort direction ${JSON.stringify(direction)} ` + `in orderBy ${JSON.stringify(orderBy)}. Expected ASC or DESC.`);
-    }
-    return `${quoted} ${upper}`;
-  });
-  return ` ORDER BY ${rendered.join(', ')}`;
-};
-const assertNonNegativeInteger = (value, kind) => {
-  if (!Number.isInteger(value) || value < 0) {
-    throw new Error(`[@webority/mobile-core] Invalid ${kind} ${JSON.stringify(value)}. ` + 'Expected a non-negative integer.');
-  }
-  return value;
-};
-/**
- * FNV-1a with the length mixed in, so two different bodies must also share a
- * length before they can be mistaken for one another. Deliberately hand-rolled:
- * this module ships with zero dependencies.
- */
-const hashString = value => {
-  let hash = 0x811c9dc5;
-  for (let index = 0; index < value.length; index += 1) {
-    hash ^= value.charCodeAt(index);
-    hash = Math.imul(hash, 0x01000193) >>> 0;
-  }
-  return `${hash.toString(16).padStart(8, '0')}-${value.length.toString(16)}`;
-};
-
-/**
- * A function migration has no stable text: release bundles are minified, so
- * hashing its source would report a mismatch on every production build. Its
- * body is therefore unverifiable, and only the switch between a function and
- * SQL is detected.
- */
-const migrationChecksum = migration => {
-  if (typeof migration.up === 'function') {
-    return hashString('fn');
-  }
-  const sql = Array.isArray(migration.up) ? migration.up.join('\n') : migration.up;
-  return hashString(sql);
-};
-export const DEFAULT_PRAGMAS = {
-  journal_mode: 'WAL',
-  synchronous: 'NORMAL',
-  foreign_keys: 'ON',
-  busy_timeout: 5000
-};
-const PRAGMA_VALUE = /^[A-Za-z0-9_-]+$/;
-const renderPragmaValue = (name, value) => {
-  if (typeof value === 'number') {
-    if (!Number.isFinite(value)) {
-      throw new Error(`[@webority/mobile-core] Invalid value for PRAGMA ${name}: ${value}.`);
-    }
-    return String(value);
-  }
-  if (!PRAGMA_VALUE.test(value)) {
-    throw new Error(`[@webority/mobile-core] Invalid value ${JSON.stringify(value)} for ` + `PRAGMA ${name}. PRAGMA values cannot be bound, so only letters, digits, ` + 'underscores and hyphens are accepted.');
-  }
-  return value;
-};
-const createDb = (name, raw) => {
-  // SQLite has ONE transaction per connection, so two concurrent transaction()
-  // calls would interleave their BEGIN/COMMIT and the second BEGIN would be
-  // rejected outright. An outbox flush racing a UI write is exactly that case,
-  // so transactions queue on this chain rather than run concurrently.
-  let txQueue = Promise.resolve();
-  const execute = async (sql, params) => {
-    try {
-      return await raw.execute(sql, params);
-    } catch (error) {
-      Logger.error(`[@webority/mobile-core] SQLite execute failed: ${sql}`, error);
-      throw error;
-    }
-  };
-  const select = async (sql, params) => {
-    const result = await execute(sql, params);
-    return result.rows;
-  };
-  const selectOne = async (sql, params) => {
-    const rows = await select(sql, params);
-    return rows.length > 0 ? rows[0] : null;
-  };
-  const runTransaction = async work => {
-    await raw.execute('BEGIN');
-    let result;
-    try {
-      result = await work({
-        execute,
-        select,
-        selectOne
-      });
-    } catch (error) {
-      try {
-        await raw.execute('ROLLBACK');
-      } catch (rollbackError) {
-        Logger.error('[@webority/mobile-core] SQLite ROLLBACK failed', rollbackError);
-      }
-      throw error;
-    }
-    try {
-      await raw.execute('COMMIT');
-    } catch (commitError) {
-      // A failed COMMIT leaves the transaction open, which would poison every
-      // later one on this connection. Roll back before surfacing it.
-      try {
-        await raw.execute('ROLLBACK');
-      } catch {
-        /* the connection is already in a bad state; the commit error is the useful one */
-      }
-      throw commitError;
-    }
-    return result;
-  };
-  const transaction = work => {
-    // A rejected link must not break the chain for everyone behind it.
-    const next = txQueue.then(() => runTransaction(work), () => runTransaction(work));
-    txQueue = next.catch(() => undefined);
-    return next;
-  };
-  const insertSql = (table, row) => {
-    const quotedTable = quoteIdentifier(table, 'table name');
-    const entries = Object.entries(row);
-    if (entries.length === 0) {
-      throw new Error(`[@webority/mobile-core] Cannot insert an empty row into ${table}. ` + 'Pass at least one column.');
-    }
-    const columns = entries.map(([column]) => quoteIdentifier(column, 'column name'));
-    const placeholders = entries.map(() => '?');
-    return {
-      sql: `INSERT INTO ${quotedTable} (${columns.join(', ')}) VALUES (${placeholders.join(', ')})`,
-      params: entries.map(([, value]) => toSqliteValue(value))
-    };
-  };
-  const insert = async (table, row) => {
-    const {
-      sql,
-      params
-    } = insertSql(table, row);
-    const result = await execute(sql, params);
-    return result.insertId;
-  };
-  const insertMany = async (table, rows) => {
-    if (rows.length === 0) {
-      return 0;
-    }
-    // Built before the transaction opens so a bad identifier throws without
-    // leaving a BEGIN behind.
-    const statements = rows.map(row => insertSql(table, row));
-    await transaction(async tx => {
-      for (const statement of statements) {
-        await tx.execute(statement.sql, statement.params);
-      }
-    });
-    return rows.length;
-  };
-  const update = async (table, values, where) => {
-    const quotedTable = quoteIdentifier(table, 'table name');
-    const entries = Object.entries(values);
-    if (entries.length === 0) {
-      throw new Error(`[@webority/mobile-core] Cannot update ${table} with no values. ` + 'Pass at least one column to set.');
-    }
-    const assignments = entries.map(([column]) => `${quoteIdentifier(column, 'column name')} = ?`);
-    const params = entries.map(([, value]) => toSqliteValue(value));
-    const built = buildWhere(where);
-    const result = await execute(`UPDATE ${quotedTable} SET ${assignments.join(', ')}${built.clause}`, [...params, ...built.params]);
-    return result.rowsAffected;
-  };
-  const remove = async (table, where) => {
-    const quotedTable = quoteIdentifier(table, 'table name');
-    const built = buildWhere(where);
-    const result = await execute(`DELETE FROM ${quotedTable}${built.clause}`, built.params);
-    return result.rowsAffected;
-  };
-  const upsert = async (table, row, conflictColumns) => {
-    if (conflictColumns.length === 0) {
-      throw new Error(`[@webority/mobile-core] upsert on ${table} needs at least one conflict ` + 'column; without one SQLite has no key to match an existing row on.');
-    }
-    const {
-      sql,
-      params
-    } = insertSql(table, row);
-    const conflictSet = new Set(conflictColumns);
-    const targets = conflictColumns.map(column => quoteIdentifier(column, 'column name'));
-    const updates = Object.keys(row).filter(column => !conflictSet.has(column)).map(column => {
-      const quoted = quoteIdentifier(column, 'column name');
-      return `${quoted} = excluded.${quoted}`;
-    });
-    const action = updates.length > 0 ? `DO UPDATE SET ${updates.join(', ')}` : 'DO NOTHING';
-    await execute(`${sql} ON CONFLICT (${targets.join(', ')}) ${action}`, params);
-  };
-  const findAll = async (table, where, options) => {
-    const quotedTable = quoteIdentifier(table, 'table name');
-    const built = buildWhere(where);
-    const params = [...built.params];
-    let sql = `SELECT * FROM ${quotedTable}${built.clause}${buildOrderBy(options?.orderBy)}`;
-    if (options?.limit !== undefined) {
-      assertNonNegativeInteger(options.limit, 'limit');
-      sql += ' LIMIT ?';
-      params.push(options.limit);
-    } else if (options?.offset !== undefined) {
-      // SQLite rejects OFFSET without LIMIT; -1 is its documented "no limit".
-      sql += ' LIMIT -1';
-    }
-    if (options?.offset !== undefined) {
-      assertNonNegativeInteger(options.offset, 'offset');
-      sql += ' OFFSET ?';
-      params.push(options.offset);
-    }
-    return select(sql, params);
-  };
-  const findOne = async (table, where) => {
-    const rows = await findAll(table, where, {
-      limit: 1
-    });
-    return rows.length > 0 ? rows[0] : null;
-  };
-  const count = async (table, where) => {
-    const quotedTable = quoteIdentifier(table, 'table name');
-    const built = buildWhere(where);
-    const row = await selectOne(`SELECT COUNT(*) AS cnt FROM ${quotedTable}${built.clause}`, built.params);
-    return Number(row?.cnt ?? 0);
-  };
-  const tableExists = async table => {
-    assertSqlIdentifier(table, 'table name');
-    const row = await selectOne("SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?", [table]);
-    return row !== null;
-  };
-  const createTable = async (table, columns, options) => {
-    const quotedTable = quoteIdentifier(table, 'table name');
-    const entries = Object.entries(columns);
-    if (entries.length === 0) {
-      throw new Error(`[@webority/mobile-core] Cannot create table ${table} with no columns.`);
-    }
-    const definitions = entries.map(([column, definition]) => `${quoteIdentifier(column, 'column name')} ${assertColumnDefinition(definition, column)}`);
-    const guard = options?.ifNotExists === false ? '' : 'IF NOT EXISTS ';
-    await execute(`CREATE TABLE ${guard}${quotedTable} (${definitions.join(', ')})`);
-  };
-  const dropTable = async (table, options) => {
-    const quotedTable = quoteIdentifier(table, 'table name');
-    const guard = options?.ifExists === false ? '' : 'IF EXISTS ';
-    await execute(`DROP TABLE ${guard}${quotedTable}`);
-  };
-  const ensureLedger = async () => {
-    await execute(`CREATE TABLE IF NOT EXISTS ${escapeIdentifier(MIGRATIONS_TABLE)} (` + 'version INTEGER PRIMARY KEY, name TEXT, applied_at TEXT NOT NULL, checksum TEXT NOT NULL)');
-  };
-  const recordLedgerSql = `INSERT OR REPLACE INTO ${escapeIdentifier(MIGRATIONS_TABLE)} ` + '(version, name, applied_at, checksum) VALUES (?, ?, ?, ?)';
-  const wipe = async () => {
-    const pragmaRow = await selectOne('PRAGMA foreign_keys');
-    const wasOn = Number(pragmaRow?.foreign_keys ?? 0) === 1;
-    // PRAGMA foreign_keys is a documented no-op inside a transaction, so the
-    // toggle has to straddle it. Left on, deleting a parent table before its
-    // children aborts the run and leaves the database half emptied.
-    await execute('PRAGMA foreign_keys = OFF');
-    try {
-      await transaction(async tx => {
-        const tables = await tx.select("SELECT name FROM sqlite_master WHERE type = 'table' " + "AND name NOT LIKE 'sqlite_%' AND name <> ?", [MIGRATIONS_TABLE]);
-        for (const table of tables) {
-          await tx.execute(`DELETE FROM ${escapeIdentifier(table.name)}`);
-        }
-      });
-    } finally {
-      await execute(`PRAGMA foreign_keys = ${wasOn ? 'ON' : 'OFF'}`);
-    }
-  };
-  const migrate = async (migrations, options) => {
-    const seenVersions = new Set();
-    for (const migration of migrations) {
-      if (seenVersions.has(migration.version)) {
-        throw new Error(`[@webority/mobile-core] Duplicate migration version ${migration.version} ` + `for database "${name}".`);
-      }
-      seenVersions.add(migration.version);
-    }
-    const versionRow = await selectOne('PRAGMA user_version');
-    let currentVersion = Number(versionRow?.user_version ?? 0);
-    if (migrations.length > 0 && !options?.allowDowngrade) {
-      const highest = migrations.reduce((max, m) => Math.max(max, m.version), 0);
-      if (currentVersion > highest) {
-        throw new Error(`[@webority/mobile-core] Database "${name}" is at schema version ` + `${currentVersion}, which is newer than the highest migration supplied (${highest}). ` + 'This build would run old code against a newer schema. Ship the missing migrations, ' + 'or pass { allowDowngrade: true } if this build is known to be compatible.');
-      }
-    }
-    await ensureLedger();
-    const appliedRows = await select(`SELECT version, checksum FROM ${escapeIdentifier(MIGRATIONS_TABLE)}`);
-    const appliedChecksums = new Map(appliedRows.map(row => [Number(row.version), String(row.checksum)]));
-    for (const migration of migrations) {
-      if (migration.version > currentVersion) {
-        continue;
-      }
-      const recorded = appliedChecksums.get(migration.version);
-      // A database migrated before the ledger existed has no row to compare
-      // against, which is not a mismatch.
-      if (recorded === undefined) {
-        continue;
-      }
-      const checksum = migrationChecksum(migration);
-      if (recorded !== checksum) {
-        throw new Error(`[@webority/mobile-core] Migration ${migration.version} has changed since ` + `it was applied to database "${name}" (recorded ${recorded}, now ${checksum}). ` + 'A released migration must never be edited; add a new one instead.');
-      }
-    }
-    const pending = migrations.filter(migration => migration.version > currentVersion).sort((a, b) => a.version - b.version);
-    for (const migration of pending) {
-      const checksum = migrationChecksum(migration);
-      await transaction(async tx => {
-        if (typeof migration.up === 'function') {
-          await migration.up(tx);
-        } else {
-          const statements = Array.isArray(migration.up) ? migration.up : [migration.up];
-          for (const statement of statements) {
-            await tx.execute(statement);
-          }
-        }
-        // The ledger row is written inside the migration's own transaction so
-        // it can never disagree with user_version after a partial failure.
-        await tx.execute(recordLedgerSql, [migration.version, migration.name ?? null, new Date().toISOString(), checksum]);
-        // PRAGMA statements do not accept bound `?` parameters in SQLite, so the
-        // version (a validated integer from this module's own loop, never user
-        // input) is inlined rather than passed as a param.
-        await tx.execute(`PRAGMA user_version = ${migration.version}`);
-      });
-      currentVersion = migration.version;
-    }
-    return currentVersion;
-  };
-  const reset = async migrations => {
-    await wipe();
-    await ensureLedger();
-    await transaction(async tx => {
-      await tx.execute(`DELETE FROM ${escapeIdentifier(MIGRATIONS_TABLE)}`);
-      await tx.execute('PRAGMA user_version = 0');
-    });
-    return migrate(migrations);
-  };
-  const baseline = async (version, migrations) => {
-    assertNonNegativeInteger(version, 'baseline version');
-    await ensureLedger();
-    const appliedAt = new Date().toISOString();
-    await transaction(async tx => {
-      for (const migration of migrations ?? []) {
-        if (migration.version > version) {
-          continue;
-        }
-        await tx.execute(recordLedgerSql, [migration.version, migration.name ?? null, appliedAt, migrationChecksum(migration)]);
-      }
-      await tx.execute(`PRAGMA user_version = ${version}`);
-    });
-  };
-  const close = async () => {
-    await raw.close();
-  };
-  return {
-    name,
-    execute,
-    select,
-    selectOne,
-    transaction,
-    insert,
-    insertMany,
-    update,
-    remove,
-    upsert,
-    findAll,
-    findOne,
-    count,
-    tableExists,
-    createTable,
-    dropTable,
-    wipe,
-    reset,
-    migrate,
-    baseline,
-    close
-  };
-};
-export const openDatabase = async (name, options) => {
-  const driver = requireBackend('open');
-  const raw = await driver.open(name, options ? {
-    location: options.location
-  } : undefined);
-  const db = createDb(name, raw);
-  if (options?.pragmas !== false) {
-    const pragmas = {
-      ...DEFAULT_PRAGMAS,
-      ...(options?.pragmas ?? {})
-    };
-    for (const [pragma, value] of Object.entries(pragmas)) {
-      assertSqlIdentifier(pragma, 'PRAGMA name');
-      await db.execute(`PRAGMA ${pragma} = ${renderPragmaValue(pragma, value)}`);
-    }
-  }
-  return db;
-};
-//# sourceMappingURL=index.js.map
+"use strict";import*as ExpoSqlite from"expo-sqlite";import{Logger}from"../logger/index.js";import{adaptExpoSqlite}from"./adapters/expo.js";let expoDriver,backend=null;export const setSqliteImplementation=e=>{backend=e};const hasNativeSqlite=e=>"function"==typeof e?.openDatabaseAsync,resolveDriver=()=>{if(backend)return backend;if(void 0===expoDriver){const e=ExpoSqlite;expoDriver=hasNativeSqlite(e)?adaptExpoSqlite(e):null}return expoDriver};export const isSqliteAvailable=()=>null!==resolveDriver();const requireBackend=e=>{const t=resolveDriver();if(!t){const t=new Error(`[@webority/mobile-core] No SQLite driver available; cannot ${e}. Install expo-sqlite (the only sanctioned driver) in the consuming app.`);throw Logger.error(t.message),t}return t};export const MIGRATIONS_TABLE="_webority_migrations";const IDENTIFIER=/^[A-Za-z_][A-Za-z0-9_]*$/;export const assertSqlIdentifier=(e,t="identifier")=>{if("string"!=typeof e||!IDENTIFIER.test(e))throw new Error(`[@webority/mobile-core] Invalid SQL ${t} ${JSON.stringify(e)}. Only letters, digits and underscores are allowed, and it must not start with a digit. Pass values as bound parameters instead of building them into the name.`);return e};const quoteIdentifier=(e,t="identifier")=>`"${assertSqlIdentifier(e,t)}"`,escapeIdentifier=e=>`"${e.replace(/"/g,'""')}"`,COLUMN_DEFINITION=/^[A-Za-z0-9_ ,.()'"+*/=<>|%:$-]+$/,assertColumnDefinition=(e,t)=>{const r="string"==typeof e?e.trim():"";if(0===r.length||!COLUMN_DEFINITION.test(r)||r.includes("--"))throw new Error(`[@webority/mobile-core] Invalid column definition for "${t}": ${JSON.stringify(e)}. A definition is raw SQL such as 'INTEGER NOT NULL DEFAULT 0' and may not contain a statement separator or a comment.`);return r};export const toSqliteValue=e=>void 0===e?null:"boolean"==typeof e?e?1:0:e instanceof Date?e.toISOString():e;export const fromSqliteBoolean=e=>{if("boolean"==typeof e)return e;if("number"==typeof e)return 0!==e;if("string"==typeof e){const t=e.trim().toLowerCase();return"1"===t||"true"===t}return!1};export const whereIn=(e,t)=>{const r=quoteIdentifier(e,"column name");return 0===t.length?{sql:"1 = 0",params:[]}:{sql:`${r} IN (${t.map(()=>"?").join(", ")})`,params:t.map(toSqliteValue)}};const isRawWhere=e=>"string"==typeof e.sql&&Object.keys(e).every(e=>"sql"===e||"params"===e),buildWhere=e=>{if(!e)return{clause:"",params:[]};if(isRawWhere(e)){const t=e.sql.trim();return 0===t.length?{clause:"",params:[]}:{clause:` WHERE ${t}`,params:[...e.params??[]]}}const t=Object.entries(e);if(0===t.length)return{clause:"",params:[]};const r=[],n=[];for(const[e,i]of t){const t=quoteIdentifier(e,"column name"),o=toSqliteValue(i);null===o?r.push(`${t} IS NULL`):(r.push(`${t} = ?`),n.push(o))}return{clause:` WHERE ${r.join(" AND ")}`,params:n}},buildOrderBy=e=>{if(void 0===e)return"";const t=e.split(",").map(e=>e.trim()).filter(e=>e.length>0);if(0===t.length)return"";return` ORDER BY ${t.map(t=>{const[r,n,...i]=t.split(/\s+/);if(i.length>0)throw new Error(`[@webority/mobile-core] Invalid orderBy term ${JSON.stringify(t)}. Expected a column name optionally followed by ASC or DESC.`);const o=quoteIdentifier(r,"orderBy column");if(void 0===n)return o;const a=n.toUpperCase();if("ASC"!==a&&"DESC"!==a)throw new Error(`[@webority/mobile-core] Invalid sort direction ${JSON.stringify(n)} in orderBy ${JSON.stringify(e)}. Expected ASC or DESC.`);return`${o} ${a}`}).join(", ")}`},assertNonNegativeInteger=(e,t)=>{if(!Number.isInteger(e)||e<0)throw new Error(`[@webority/mobile-core] Invalid ${t} ${JSON.stringify(e)}. Expected a non-negative integer.`);return e},hashString=e=>{let t=2166136261;for(let r=0;r<e.length;r+=1)t^=e.charCodeAt(r),t=Math.imul(t,16777619)>>>0;return`${t.toString(16).padStart(8,"0")}-${e.length.toString(16)}`},migrationChecksum=e=>{if("function"==typeof e.up)return hashString("fn");const t=Array.isArray(e.up)?e.up.join("\n"):e.up;return hashString(t)};export const DEFAULT_PRAGMAS={journal_mode:"WAL",synchronous:"NORMAL",foreign_keys:"ON",busy_timeout:5e3};const PRAGMA_VALUE=/^[A-Za-z0-9_-]+$/,renderPragmaValue=(e,t)=>{if("number"==typeof t){if(!Number.isFinite(t))throw new Error(`[@webority/mobile-core] Invalid value for PRAGMA ${e}: ${t}.`);return String(t)}if(!PRAGMA_VALUE.test(t))throw new Error(`[@webority/mobile-core] Invalid value ${JSON.stringify(t)} for PRAGMA ${e}. PRAGMA values cannot be bound, so only letters, digits, underscores and hyphens are accepted.`);return t},createDb=(e,t)=>{let r=Promise.resolve();const execute=async(e,r)=>{try{return await t.execute(e,r)}catch(t){throw Logger.error(`[@webority/mobile-core] SQLite execute failed: ${e}`,t),t}},select=async(e,t)=>(await execute(e,t)).rows,selectOne=async(e,t)=>{const r=await select(e,t);return r.length>0?r[0]:null},runTransaction=async e=>{let r;await t.execute("BEGIN");try{r=await e({execute:execute,select:select,selectOne:selectOne})}catch(e){try{await t.execute("ROLLBACK")}catch(e){Logger.error("[@webority/mobile-core] SQLite ROLLBACK failed",e)}throw e}try{await t.execute("COMMIT")}catch(e){try{await t.execute("ROLLBACK")}catch{}throw e}return r},transaction=e=>{const t=r.then(()=>runTransaction(e),()=>runTransaction(e));return r=t.catch(()=>{}),t},insertSql=(e,t)=>{const r=quoteIdentifier(e,"table name"),n=Object.entries(t);if(0===n.length)throw new Error(`[@webority/mobile-core] Cannot insert an empty row into ${e}. Pass at least one column.`);const i=n.map(([e])=>quoteIdentifier(e,"column name")),o=n.map(()=>"?");return{sql:`INSERT INTO ${r} (${i.join(", ")}) VALUES (${o.join(", ")})`,params:n.map(([,e])=>toSqliteValue(e))}},findAll=async(e,t,r)=>{const n=quoteIdentifier(e,"table name"),i=buildWhere(t),o=[...i.params];let a=`SELECT * FROM ${n}${i.clause}${buildOrderBy(r?.orderBy)}`;return void 0!==r?.limit?(assertNonNegativeInteger(r.limit,"limit"),a+=" LIMIT ?",o.push(r.limit)):void 0!==r?.offset&&(a+=" LIMIT -1"),void 0!==r?.offset&&(assertNonNegativeInteger(r.offset,"offset"),a+=" OFFSET ?",o.push(r.offset)),select(a,o)},ensureLedger=async()=>{await execute(`CREATE TABLE IF NOT EXISTS ${escapeIdentifier(MIGRATIONS_TABLE)} (version INTEGER PRIMARY KEY, name TEXT, applied_at TEXT NOT NULL, checksum TEXT NOT NULL)`)},n=`INSERT OR REPLACE INTO ${escapeIdentifier(MIGRATIONS_TABLE)} (version, name, applied_at, checksum) VALUES (?, ?, ?, ?)`,wipe=async()=>{const e=await selectOne("PRAGMA foreign_keys"),t=1===Number(e?.foreign_keys??0);await execute("PRAGMA foreign_keys = OFF");try{await transaction(async e=>{const t=await e.select("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' AND name <> ?",[MIGRATIONS_TABLE]);for(const r of t)await e.execute(`DELETE FROM ${escapeIdentifier(r.name)}`)})}finally{await execute("PRAGMA foreign_keys = "+(t?"ON":"OFF"))}},migrate=async(t,r)=>{const i=new Set;for(const r of t){if(i.has(r.version))throw new Error(`[@webority/mobile-core] Duplicate migration version ${r.version} for database "${e}".`);i.add(r.version)}const o=await selectOne("PRAGMA user_version");let a=Number(o?.user_version??0);if(t.length>0&&!r?.allowDowngrade){const r=t.reduce((e,t)=>Math.max(e,t.version),0);if(a>r)throw new Error(`[@webority/mobile-core] Database "${e}" is at schema version ${a}, which is newer than the highest migration supplied (${r}). This build would run old code against a newer schema. Ship the missing migrations, or pass { allowDowngrade: true } if this build is known to be compatible.`)}await ensureLedger();const s=await select(`SELECT version, checksum FROM ${escapeIdentifier(MIGRATIONS_TABLE)}`),c=new Map(s.map(e=>[Number(e.version),String(e.checksum)]));for(const r of t){if(r.version>a)continue;const t=c.get(r.version);if(void 0===t)continue;const n=migrationChecksum(r);if(t!==n)throw new Error(`[@webority/mobile-core] Migration ${r.version} has changed since it was applied to database "${e}" (recorded ${t}, now ${n}). A released migration must never be edited; add a new one instead.`)}const l=t.filter(e=>e.version>a).sort((e,t)=>e.version-t.version);for(const e of l){const t=migrationChecksum(e);await transaction(async r=>{if("function"==typeof e.up)await e.up(r);else{const t=Array.isArray(e.up)?e.up:[e.up];for(const e of t)await r.execute(e)}await r.execute(n,[e.version,e.name??null,(new Date).toISOString(),t]),await r.execute(`PRAGMA user_version = ${e.version}`)}),a=e.version}return a};return{name:e,execute:execute,select:select,selectOne:selectOne,transaction:transaction,insert:async(e,t)=>{const{sql:r,params:n}=insertSql(e,t);return(await execute(r,n)).insertId},insertMany:async(e,t)=>{if(0===t.length)return 0;const r=t.map(t=>insertSql(e,t));return await transaction(async e=>{for(const t of r)await e.execute(t.sql,t.params)}),t.length},update:async(e,t,r)=>{const n=quoteIdentifier(e,"table name"),i=Object.entries(t);if(0===i.length)throw new Error(`[@webority/mobile-core] Cannot update ${e} with no values. Pass at least one column to set.`);const o=i.map(([e])=>`${quoteIdentifier(e,"column name")} = ?`),a=i.map(([,e])=>toSqliteValue(e)),s=buildWhere(r);return(await execute(`UPDATE ${n} SET ${o.join(", ")}${s.clause}`,[...a,...s.params])).rowsAffected},remove:async(e,t)=>{const r=quoteIdentifier(e,"table name"),n=buildWhere(t);return(await execute(`DELETE FROM ${r}${n.clause}`,n.params)).rowsAffected},upsert:async(e,t,r)=>{if(0===r.length)throw new Error(`[@webority/mobile-core] upsert on ${e} needs at least one conflict column; without one SQLite has no key to match an existing row on.`);const{sql:n,params:i}=insertSql(e,t),o=new Set(r),a=r.map(e=>quoteIdentifier(e,"column name")),s=Object.keys(t).filter(e=>!o.has(e)).map(e=>{const t=quoteIdentifier(e,"column name");return`${t} = excluded.${t}`}),c=s.length>0?`DO UPDATE SET ${s.join(", ")}`:"DO NOTHING";await execute(`${n} ON CONFLICT (${a.join(", ")}) ${c}`,i)},findAll:findAll,findOne:async(e,t)=>{const r=await findAll(e,t,{limit:1});return r.length>0?r[0]:null},count:async(e,t)=>{const r=quoteIdentifier(e,"table name"),n=buildWhere(t),i=await selectOne(`SELECT COUNT(*) AS cnt FROM ${r}${n.clause}`,n.params);return Number(i?.cnt??0)},tableExists:async e=>{assertSqlIdentifier(e,"table name");return null!==await selectOne("SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?",[e])},createTable:async(e,t,r)=>{const n=quoteIdentifier(e,"table name"),i=Object.entries(t);if(0===i.length)throw new Error(`[@webority/mobile-core] Cannot create table ${e} with no columns.`);const o=i.map(([e,t])=>`${quoteIdentifier(e,"column name")} ${assertColumnDefinition(t,e)}`),a=!1===r?.ifNotExists?"":"IF NOT EXISTS ";await execute(`CREATE TABLE ${a}${n} (${o.join(", ")})`)},dropTable:async(e,t)=>{const r=quoteIdentifier(e,"table name"),n=!1===t?.ifExists?"":"IF EXISTS ";await execute(`DROP TABLE ${n}${r}`)},wipe:wipe,reset:async e=>(await wipe(),await ensureLedger(),await transaction(async e=>{await e.execute(`DELETE FROM ${escapeIdentifier(MIGRATIONS_TABLE)}`),await e.execute("PRAGMA user_version = 0")}),migrate(e)),migrate:migrate,baseline:async(e,t)=>{assertNonNegativeInteger(e,"baseline version"),await ensureLedger();const r=(new Date).toISOString();await transaction(async i=>{for(const o of t??[])o.version>e||await i.execute(n,[o.version,o.name??null,r,migrationChecksum(o)]);await i.execute(`PRAGMA user_version = ${e}`)})},close:async()=>{await t.close()}}};export const openDatabase=async(e,t)=>{const r=requireBackend("open"),n=await r.open(e,t?{location:t.location}:void 0),i=createDb(e,n);if(!1!==t?.pragmas){const e={...DEFAULT_PRAGMAS,...t?.pragmas??{}};for(const[t,r]of Object.entries(e))assertSqlIdentifier(t,"PRAGMA name"),await i.execute(`PRAGMA ${t} = ${renderPragmaValue(t,r)}`)}return i};