@chipmobilesdk/rn-local-db 0.4.0 → 0.5.0

package/lib/commonjs/sqlite/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_errors2","_budgets","_declare","_statements","quoted","schema","collectionTable","name","conflict","id","raise","DiagnosticCodes","RECORD_CONFLICT","message","detail","collection","recordId","missing","RECORD_NOT_FOUND","resolveInsert","resolver","operation","now","payload","assertRecordWithinBudget","record","data","state","stage","command","insertStatement","outcome","resolveUpdate","updateStatement","restore","resolveUpsert","present","resolveDelete","resolveSoftDelete","hasSoftDelete","CONFIG_INVALID","resolveOperation","type","runBatch","context","operations","assertBatchWithinBudget","length","commands","outcomes","overlay","Map","known","idsByCollection","ids","get","Set","add","set","schemaFor","result","connection","execute","JSON","stringify","row","rows","String","deleted_at","undefined","key","resolved","push","executeBatch","applied"],"sourceRoot":"../../../src","sources":["sqlite/batch.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/sqlite/catalog.js

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clearScope = clearScope;
+exports.ensureCatalog = ensureCatalog;
+exports.listEntries = listEntries;
+exports.markDeleting = markDeleting;
+exports.readEntry = readEntry;
+exports.registerScope = registerScope;
+var _values = require("./values.js");
+/**
+ * The catalog: one registry per logical database, listing the scopes that
+ * exist.
+ *
+ * This is the only structure that spans scopes, so it is deliberately the
+ * smallest thing that answers the questions the package must answer without
+ * opening every scope file. It holds a digest, timestamps, and two posture
+ * flags — **no raw scope components** (FR-014), so a device with full disk
+ * access cannot mine it for identities or tenant names even though the
+ * catalog itself is never encrypted.
+ *
+ * The `deleting` flag is the load-bearing part. It is written before a scope
+ * deletion begins and cleared last, so a crash at any point leaves the
+ * interruption visible on the next open. Clearing it first would make an
+ * interrupted deletion look complete — the exact failure FR-063 exists to
+ * prevent.
+ */
+
+const CREATE_SCOPES = `CREATE TABLE IF NOT EXISTS scopes (
+  scope_key      TEXT PRIMARY KEY,
+  created_at     INTEGER NOT NULL,
+  deletion_state TEXT NOT NULL,
+  backup_posture TEXT NOT NULL,
+  encrypted      INTEGER NOT NULL
+)`;
+async function ensureCatalog(connection) {
+  await connection.execute(CREATE_SCOPES);
+}
+async function readEntry(connection, scopeKey) {
+  const result = await connection.execute('SELECT scope_key, created_at, deletion_state, backup_posture, encrypted FROM scopes WHERE scope_key = ?', [scopeKey]);
+  const row = result.rows[0];
+  if (!row) {
+    return null;
+  }
+  return {
+    scopeKey: (0, _values.text)(row.scope_key),
+    createdAt: (0, _values.num)(row.created_at),
+    deletionState: (0, _values.text)(row.deletion_state),
+    backupPosture: (0, _values.text)(row.backup_posture),
+    encrypted: (0, _values.num)(row.encrypted) === 1
+  };
+}
+async function listEntries(connection) {
+  const result = await connection.execute('SELECT scope_key, created_at, deletion_state, backup_posture, encrypted FROM scopes');
+  return result.rows.map(row => ({
+    scopeKey: (0, _values.text)(row.scope_key),
+    createdAt: (0, _values.num)(row.created_at),
+    deletionState: (0, _values.text)(row.deletion_state),
+    backupPosture: (0, _values.text)(row.backup_posture),
+    encrypted: (0, _values.num)(row.encrypted) === 1
+  }));
+}
+async function registerScope(connection, entry) {
+  await connection.execute(`INSERT INTO scopes (scope_key, created_at, deletion_state, backup_posture, encrypted)
+		 VALUES (?, ?, ?, ?, ?)
+		 ON CONFLICT(scope_key) DO UPDATE SET
+		   deletion_state = excluded.deletion_state,
+		   backup_posture = excluded.backup_posture,
+		   encrypted = excluded.encrypted`, [entry.scopeKey, entry.createdAt, entry.deletionState, entry.backupPosture, entry.encrypted ? 1 : 0]);
+}
+async function markDeleting(connection, scopeKey) {
+  await connection.execute('UPDATE scopes SET deletion_state = ? WHERE scope_key = ?', ['deleting', scopeKey]);
+}
+
+/** Cleared last, on purpose. See the note at the top of this file. */
+async function clearScope(connection, scopeKey) {
+  await connection.execute('DELETE FROM scopes WHERE scope_key = ?', [scopeKey]);
+}
+//# sourceMappingURL=catalog.js.map

package/lib/commonjs/sqlite/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_values","require","CREATE_SCOPES","ensureCatalog","connection","execute","readEntry","scopeKey","result","row","rows","text","scope_key","createdAt","num","created_at","deletionState","deletion_state","backupPosture","backup_posture","encrypted","listEntries","map","registerScope","entry","markDeleting","clearScope"],"sourceRoot":"../../../src","sources":["sqlite/catalog.ts"],"mappings":";;;;;;;;;;;AAoBA,IAAAA,OAAA,GAAAC,OAAA;AApBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA,MAAMC,aAAa,GAAG;AACtB;AACA;AACA;AACA;AACA;AACA,EAAE;AAEK,eAAeC,aAAaA,CAACC,UAAsB,EAAiB;EAC1E,MAAMA,UAAU,CAACC,OAAO,CAACH,aAAa,CAAC;AACxC;AAEO,eAAeI,SAASA,CAC9BF,UAAsB,EACtBG,QAAgB,EACe;EAC/B,MAAMC,MAAM,GAAG,MAAMJ,UAAU,CAACC,OAAO,CACtC,yGAAyG,EACzG,CAACE,QAAQ,CACV,CAAC;EACD,MAAME,GAAG,GAAGD,MAAM,CAACE,IAAI,CAAC,CAAC,CAAC;EAC1B,IAAI,CAACD,GAAG,EAAE;IACT,OAAO,IAAI;EACZ;EACA,OAAO;IACNF,QAAQ,EAAE,IAAAI,YAAI,EAACF,GAAG,CAACG,SAAS,CAAC;IAC7BC,SAAS,EAAE,IAAAC,WAAG,EAACL,GAAG,CAACM,UAAU,CAAC;IAC9BC,aAAa,EAAE,IAAAL,YAAI,EAACF,GAAG,CAACQ,cAAc,CAAuB;IAC7DC,aAAa,EAAE,IAAAP,YAAI,EAACF,GAAG,CAACU,cAAc,CAA4B;IAClEC,SAAS,EAAE,IAAAN,WAAG,EAACL,GAAG,CAACW,SAAS,CAAC,KAAK;EACnC,CAAC;AACF;AAEO,eAAeC,WAAWA,CAACjB,UAAsB,EAA2B;EAClF,MAAMI,MAAM,GAAG,MAAMJ,UAAU,CAACC,OAAO,CACtC,qFACD,CAAC;EACD,OAAOG,MAAM,CAACE,IAAI,CAACY,GAAG,CAACb,GAAG,KAAK;IAC9BF,QAAQ,EAAE,IAAAI,YAAI,EAACF,GAAG,CAACG,SAAS,CAAC;IAC7BC,SAAS,EAAE,IAAAC,WAAG,EAACL,GAAG,CAACM,UAAU,CAAC;IAC9BC,aAAa,EAAE,IAAAL,YAAI,EAACF,GAAG,CAACQ,cAAc,CAAuB;IAC7DC,aAAa,EAAE,IAAAP,YAAI,EAACF,GAAG,CAACU,cAAc,CAA4B;IAClEC,SAAS,EAAE,IAAAN,WAAG,EAACL,GAAG,CAACW,SAAS,CAAC,KAAK;EACnC,CAAC,CAAC,CAAC;AACJ;AAEO,eAAeG,aAAaA,CAACnB,UAAsB,EAAEoB,KAAmB,EAAiB;EAC/F,MAAMpB,UAAU,CAACC,OAAO,CACvB;AACF;AACA;AACA;AACA;AACA,oCAAoC,EAClC,CACCmB,KAAK,CAACjB,QAAQ,EACdiB,KAAK,CAACX,SAAS,EACfW,KAAK,CAACR,aAAa,EACnBQ,KAAK,CAACN,aAAa,EACnBM,KAAK,CAACJ,SAAS,GAAG,CAAC,GAAG,CAAC,CAEzB,CAAC;AACF;AAEO,eAAeK,YAAYA,CAACrB,UAAsB,EAAEG,QAAgB,EAAiB;EAC3F,MAAMH,UAAU,CAACC,OAAO,CAAC,0DAA0D,EAAE,CACpF,UAAU,EACVE,QAAQ,CACR,CAAC;AACH;;AAEA;AACO,eAAemB,UAAUA,CAACtB,UAAsB,EAAEG,QAAgB,EAAiB;EACzF,MAAMH,UAAU,CAACC,OAAO,CAAC,wCAAwC,EAAE,CAACE,QAAQ,CAAC,CAAC;AAC/E","ignoreList":[]}

package/lib/commonjs/sqlite/connection.js

@@ -0,0 +1,210 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.assertReadable = assertReadable;
+exports.openConnection = openConnection;
+var _errors = require("../contract/errors.js");
+var _errors2 = require("../diagnostics/errors.js");
+var _mapNative = require("../diagnostics/map-native.js");
+var _fs = require("../platform/fs.js");
+var _transactionQueue = require("./transaction-queue.js");
+var _native = require("./native.js");
+/**
+ * One connection per database file.
+ *
+ * Two things about this file carry design weight:
+ *
+ * **Scope isolation is the file boundary.** A connection is opened against
+ * one scope's `data.db`, whose directory is named by the scope digest and
+ * never by the components (FR-014). No SQL this package could generate — and
+ * none a future bug could generate — reaches another scope's rows, because
+ * they are in a file this connection never opened (research.md R2).
+ *
+ * **A transaction owns the connection while it runs, and only its own
+ * executor reaches it.** Every operation queues on the connection, and a
+ * transaction holds the queue until it settles. Work issued through the
+ * connection meanwhile — a background sync, a second screen — waits and then
+ * runs on its own, rather than joining the transaction and vanishing with its
+ * rollback. Until 0.2.0 `execute` routed into whatever transaction was in
+ * flight, which is how an unrelated write was lost. Work meant to be part of
+ * the transaction goes through the executor the transaction hands out
+ * (`tx.collection`, `tx.attachments`).
+ */
+
+/**
+ * The executor a transaction body runs against, plus the one control it
+ * needs. `rollback` is handed to the body rather than returned from
+ * `transaction`, so an explicit abort cannot outlive the transaction it
+ * belongs to.
+ */
+
+function splitPath(path) {
+  const index = path.lastIndexOf('/');
+  return index === -1 ? {
+    location: '',
+    name: path
+  } : {
+    location: path.slice(0, index),
+    name: path.slice(index + 1)
+  };
+}
+async function openConnection(options) {
+  const {
+    location,
+    name
+  } = splitPath(options.path);
+  const encrypted = options.encryptionKey !== undefined;
+  try {
+    await (0, _fs.fileSystem)().mkdir(location);
+  } catch (error) {
+    (0, _mapNative.raiseNative)(error, {
+      operation: 'open'
+    });
+  }
+  let database;
+  try {
+    database = (0, _native.engine)().open({
+      name,
+      location,
+      // Passing the key only when encryption is on keeps an unencrypted
+      // database from being opened as an encrypted one with an empty key,
+      // which SQLCipher accepts and which would produce a file neither
+      // posture can reopen.
+      ...(encrypted ? {
+        encryptionKey: options.encryptionKey
+      } : {})
+    });
+  } catch (error) {
+    (0, _mapNative.raiseNative)(error, {
+      operation: 'open',
+      encrypted
+    });
+  }
+  let closed = false;
+  let active = null;
+  const queue = (0, _transactionQueue.createTransactionQueue)();
+  const assertOpen = () => {
+    if (closed) {
+      (0, _errors2.raise)(_errors.DiagnosticCodes.CLOSED_HANDLE, {
+        message: 'connection is closed'
+      });
+    }
+  };
+  const classify = sql => /^\s*select|^\s*pragma|^\s*explain/i.test(sql) ? 'read' : 'write';
+  const connection = {
+    path: options.path,
+    encrypted,
+    execute(sql, params = []) {
+      assertOpen();
+      // Never into an in-flight transaction: queued behind it instead. See
+      // the note at the top of this file.
+      return queue.run(async () => {
+        try {
+          return await database.execute(sql, params);
+        } catch (error) {
+          (0, _mapNative.raiseNative)(error, {
+            operation: classify(sql),
+            encrypted
+          });
+        }
+      });
+    },
+    async transaction(fn) {
+      assertOpen();
+      if (active) {
+        // Nested transactions would need savepoints and would let a
+        // partial rollback look like a full one. Refused rather than
+        // queued: a body that opened a second transaction would otherwise
+        // wait on itself forever.
+        (0, _errors2.raise)(_errors.DiagnosticCodes.TRANSACTION_STATE, {
+          message: 'a transaction is already in flight on this connection'
+        });
+      }
+      return queue.runTransaction(async () => {
+        try {
+          return await database.transaction(async tx => {
+            active = tx;
+            let settled = false;
+            try {
+              return await fn({
+                execute: (sql, params = []) => {
+                  if (settled) {
+                    // After an explicit rollback the body is still running
+                    // inside the engine's callback. Its remaining statements
+                    // are refused, not run in autocommit (LDB-V1).
+                    (0, _errors2.raise)(_errors.DiagnosticCodes.TRANSACTION_STATE, {
+                      message: 'transaction already rolled back'
+                    });
+                  }
+                  return tx.execute(sql, params);
+                },
+                rollback: async () => {
+                  await tx.rollback();
+                  settled = true;
+                }
+              });
+            } finally {
+              active = null;
+            }
+          });
+        } catch (error) {
+          (0, _mapNative.raiseNative)(error, {
+            operation: 'transaction',
+            encrypted
+          });
+        }
+      });
+    },
+    executeBatch(commands) {
+      assertOpen();
+      return queue.run(async () => {
+        try {
+          await database.executeBatch(commands);
+        } catch (error) {
+          (0, _mapNative.raiseNative)(error, {
+            operation: 'write',
+            encrypted
+          });
+        }
+      });
+    },
+    async close() {
+      if (closed) {
+        return;
+      }
+      closed = true;
+      try {
+        await database.close();
+      } catch {
+        // A close that fails leaves nothing for a caller to do, and
+        // reporting it would turn an orderly sign-out into an error.
+      }
+    }
+  };
+
+  // Write-ahead logging so a reader is not blocked by the writer — FR-045's
+  // "reads proceed while a write is in flight" is this pragma plus op-sqlite's
+  // single-writer serialization, not a lock this package maintains.
+  await connection.execute('PRAGMA journal_mode = WAL');
+  await connection.execute('PRAGMA foreign_keys = ON');
+  // Durability over speed: a half-written record after a crash is exactly
+  // what FR-039 promises never happens.
+  await connection.execute('PRAGMA synchronous = FULL');
+  return connection;
+}
+
+/**
+ * Confirm a freshly opened database is readable.
+ *
+ * Deliberately not `PRAGMA integrity_check`: that walks the whole file and
+ * would put open time far past the 150-millisecond budget on a large scope.
+ * One trivial read is enough to surface the failures that matter at open —
+ * a wrong key, a truncated file, a malformed header — because all three fail
+ * it, and the error mapping keeps them distinguishable (FR-076, FR-078).
+ */
+async function assertReadable(connection) {
+  await connection.execute('SELECT count(*) AS n FROM sqlite_master');
+}
+//# sourceMappingURL=connection.js.map

package/lib/commonjs/sqlite/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_errors2","_mapNative","_fs","_transactionQueue","_native","splitPath","path","index","lastIndexOf","location","name","slice","openConnection","options","encrypted","encryptionKey","undefined","fileSystem","mkdir","error","raiseNative","operation","database","engine","open","closed","active","queue","createTransactionQueue","assertOpen","raise","DiagnosticCodes","CLOSED_HANDLE","message","classify","sql","test","connection","execute","params","run","transaction","fn","TRANSACTION_STATE","runTransaction","tx","settled","rollback","executeBatch","commands","close","assertReadable"],"sourceRoot":"../../../src","sources":["sqlite/connection.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/sqlite/index-coverage.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.explainQuery = explainQuery;
+var _declare = require("../schema/declare.js");
+var _sqlBuilder = require("./sql-builder.js");
+var _rowCodec = require("./row-codec.js");
+/**
+ * "Is this query covered by an index?", answered by the engine rather than by
+ * inspection of the declarations (FR-037).
+ *
+ * Reading the schema would answer what the developer intended; `EXPLAIN QUERY
+ * PLAN` answers what SQLite will actually do, and the two diverge exactly
+ * where it matters — a filter on an indexed field that the planner declines
+ * because of a type mismatch or a leading wildcard still reports as "indexed"
+ * if you only read declarations.
+ *
+ * Exposed as a development-mode diagnostic. It runs an extra statement, so an
+ * app calling it on every list would pay for it.
+ */
+
+const SCAN = /\bSCAN\b/i;
+const USING_INDEX = /USING\s+(COVERING\s+)?INDEX\s+"?([A-Za-z0-9_]+)"?/i;
+async function explainQuery(executor, schema, query, sort) {
+  const filter = (0, _sqlBuilder.buildFilter)(query?.filter);
+  const table = (0, _declare.collectionTable)(schema.name);
+  const sql = `EXPLAIN QUERY PLAN SELECT id FROM "${table}" WHERE ${filter.sql} ORDER BY ${(0, _sqlBuilder.buildOrderBy)(sort)}`;
+  const result = await executor.execute(sql, filter.params);
+  const detail = result.rows.map(row => String(row.detail ?? row.DETAIL ?? '')).filter(Boolean).join('; ');
+  const match = USING_INDEX.exec(detail);
+  return {
+    collection: schema.name,
+    usesIndex: match !== null,
+    // Reported under the name the app declared, not the collection-scoped
+    // name it has in the file.
+    indexName: match?.[2] === undefined ? undefined : (0, _rowCodec.declaredIndexName)(schema, match[2]),
+    detail: detail || (SCAN.test(detail) ? 'full table scan' : 'the engine returned no plan for this query')
+  };
+}
+//# sourceMappingURL=index-coverage.js.map

package/lib/commonjs/sqlite/index-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_declare","require","_sqlBuilder","_rowCodec","SCAN","USING_INDEX","explainQuery","executor","schema","query","sort","filter","buildFilter","table","collectionTable","name","sql","buildOrderBy","result","execute","params","detail","rows","map","row","String","DETAIL","Boolean","join","match","exec","collection","usesIndex","indexName","undefined","declaredIndexName","test"],"sourceRoot":"../../../src","sources":["sqlite/index-coverage.ts"],"mappings":";;;;;;AAgBA,IAAAA,QAAA,GAAAC,OAAA;AAEA,IAAAC,WAAA,GAAAD,OAAA;AACA,IAAAE,SAAA,GAAAF,OAAA;AAnBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,MAAMG,IAAI,GAAG,WAAW;AACxB,MAAMC,WAAW,GAAG,oDAAoD;AAEjE,eAAeC,YAAYA,CACjCC,QAAkB,EAClBC,MAAwB,EACxBC,KAAwB,EACxBC,IAAe,EACgB;EAC/B,MAAMC,MAAM,GAAG,IAAAC,uBAAW,EAACH,KAAK,EAAEE,MAAM,CAAC;EACzC,MAAME,KAAK,GAAG,IAAAC,wBAAe,EAACN,MAAM,CAACO,IAAI,CAAC;EAC1C,MAAMC,GAAG,GAAG,sCAAsCH,KAAK,WAAWF,MAAM,CAACK,GAAG,aAAa,IAAAC,wBAAY,EACpGP,IACD,CAAC,EAAE;EAEH,MAAMQ,MAAM,GAAG,MAAMX,QAAQ,CAACY,OAAO,CAACH,GAAG,EAAEL,MAAM,CAACS,MAAM,CAAC;EACzD,MAAMC,MAAM,GAAGH,MAAM,CAACI,IAAI,CACxBC,GAAG,CAACC,GAAG,IAAIC,MAAM,CAACD,GAAG,CAACH,MAAM,IAAIG,GAAG,CAACE,MAAM,IAAI,EAAE,CAAC,CAAC,CAClDf,MAAM,CAACgB,OAAO,CAAC,CACfC,IAAI,CAAC,IAAI,CAAC;EAEZ,MAAMC,KAAK,GAAGxB,WAAW,CAACyB,IAAI,CAACT,MAAM,CAAC;EACtC,OAAO;IACNU,UAAU,EAAEvB,MAAM,CAACO,IAAI;IACvBiB,SAAS,EAAEH,KAAK,KAAK,IAAI;IACzB;IACA;IACAI,SAAS,EAAEJ,KAAK,GAAG,CAAC,CAAC,KAAKK,SAAS,GAAGA,SAAS,GAAG,IAAAC,2BAAiB,EAAC3B,MAAM,EAAEqB,KAAK,CAAC,CAAC,CAAC,CAAC;IACrFR,MAAM,EACLA,MAAM,KACLjB,IAAI,CAACgC,IAAI,CAACf,MAAM,CAAC,GAAG,iBAAiB,GAAG,4CAA4C;EACvF,CAAC;AACF","ignoreList":[]}

package/lib/commonjs/sqlite/native.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.engine = engine;
+exports.isEncryptionAvailable = isEncryptionAvailable;
+exports.setEngine = setEngine;
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _errors = require("../contract/errors.js");
+var _errors2 = require("../diagnostics/errors.js");
+/**
+ * The storage engine peer, behind one lazy accessor.
+ *
+ * Every native call the package makes to SQLite passes through this type.
+ * Note what is missing: `executeSync`. op-sqlite ships it, and using it would
+ * put a database read on the interface thread — the one thing PERF-001's
+ * 16-millisecond rule cannot survive (research.md R9). A surface that cannot
+ * express the synchronous call is a stronger guarantee than a review comment.
+ */
+
+/** Loaded on first use (rn-core's lazy peer); a missing peer is `OPEN_FAILED`. */
+const sqlite = (0, _rnCore.lazyPeer)('@op-engineering/op-sqlite', () => {
+  // Inside `try`, so Metro bundles an app that leaves this optional peer out.
+  try {
+    return require('@op-engineering/op-sqlite');
+  } catch (cause) {
+    throw cause;
+  }
+});
+
+/** Swap the engine. Tests only; `null` goes back to the real one. */
+function setEngine(next) {
+  sqlite.override(next ?? undefined);
+}
+function engine() {
+  return sqlite.require((_peer, cause) => new _errors2.StorageError(_errors.DiagnosticCodes.OPEN_FAILED, {
+    message: 'storage engine peer is not installed',
+    cause
+  }));
+}
+
+/**
+ * Whether SQLCipher is compiled into this build.
+ *
+ * A build flag in the consuming app, not a separate peer (research.md R1a).
+ * An app that enables encryption without it must fail loudly rather than
+ * write plaintext to a file it believes is encrypted.
+ */
+function isEncryptionAvailable() {
+  const current = engine();
+  return typeof current.isSQLCipher === 'function' ? current.isSQLCipher() === true : false;
+}
+//# sourceMappingURL=native.js.map

package/lib/commonjs/sqlite/native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","_errors","_errors2","sqlite","lazyPeer","cause","setEngine","next","override","undefined","engine","_peer","StorageError","DiagnosticCodes","OPEN_FAILED","message","isEncryptionAvailable","current","isSQLCipher"],"sourceRoot":"../../../src","sources":["sqlite/native.ts"],"mappings":";;;;;;;;AAUA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,OAAA,GAAAD,OAAA;AACA,IAAAE,QAAA,GAAAF,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAwCA;AACA,MAAMG,MAAM,GAAG,IAAAC,gBAAQ,EAAC,2BAA2B,EAAE,MAAM;EAC1D;EACA,IAAI;IACH,OAAOJ,OAAO,CAAC,2BAA2B,CAAC;EAC5C,CAAC,CAAC,OAAOK,KAAK,EAAE;IACf,MAAMA,KAAK;EACZ;AACD,CAAC,CAAC;;AAEF;AACO,SAASC,SAASA,CAACC,IAAmB,EAAQ;EACpDJ,MAAM,CAACK,QAAQ,CAACD,IAAI,IAAIE,SAAS,CAAC;AACnC;AAEO,SAASC,MAAMA,CAAA,EAAW;EAChC,OAAOP,MAAM,CAACH,OAAO,CACpB,CAACW,KAAK,EAAEN,KAAK,KACZ,IAAIO,qBAAY,CAACC,uBAAe,CAACC,WAAW,EAAE;IAC7CC,OAAO,EAAE,sCAAsC;IAC/CV;EACD,CAAC,CACH,CAAC;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASW,qBAAqBA,CAAA,EAAY;EAChD,MAAMC,OAAO,GAAGP,MAAM,CAAC,CAAC;EACxB,OAAO,OAAOO,OAAO,CAACC,WAAW,KAAK,UAAU,GAAGD,OAAO,CAACC,WAAW,CAAC,CAAC,KAAK,IAAI,GAAG,KAAK;AAC1F","ignoreList":[]}

package/lib/commonjs/sqlite/row-codec.js

@@ -0,0 +1,192 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RESERVED_COLUMNS = void 0;
+exports.addColumnSql = addColumnSql;
+exports.createIndexSql = createIndexSql;
+exports.createTableSql = createTableSql;
+exports.declaredIndexName = declaredIndexName;
+exports.decodeRow = decodeRow;
+exports.encodePayload = encodePayload;
+exports.insertColumns = insertColumns;
+exports.physicalIndexName = physicalIndexName;
+exports.projectValue = projectValue;
+exports.projectedColumnNames = projectedColumnNames;
+exports.projectedValues = projectedValues;
+exports.updateAssignments = updateAssignments;
+var _declare = require("../schema/declare.js");
+var _values = require("./values.js");
+/**
+ * Table shape, and the payload-as-truth rule.
+ *
+ * Every read reconstructs the record from `payload` alone. The projected
+ * `f_*` columns are written on every write and consulted only by `WHERE` and
+ * `ORDER BY` — never by a read path (research.md R6).
+ *
+ * That single rule is what makes two requirements structural rather than
+ * carefully maintained. FR-018's byte fidelity holds because nothing else is
+ * consulted to rebuild a record, and FR-019's explicit-null versus
+ * absent-field distinction holds because a NULL projected column cannot be
+ * ambiguous if no read ever looks at it.
+ */
+
+const RESERVED_COLUMNS = exports.RESERVED_COLUMNS = ['id', 'payload', 'created_at', 'updated_at', 'deleted_at'];
+
+/** SQLite affinity for a declared field type. */
+function affinityOf(field) {
+  switch (field.type) {
+    case 'number':
+    case 'timestamp':
+      return 'REAL';
+    case 'boolean':
+      return 'INTEGER';
+    case 'string':
+    default:
+      return 'TEXT';
+  }
+}
+function createTableSql(schema) {
+  const columns = ['id TEXT PRIMARY KEY', 'payload TEXT NOT NULL', 'created_at INTEGER', 'updated_at INTEGER', 'deleted_at INTEGER', ...(schema.fields ?? []).map(field => `"${(0, _declare.projectedColumn)(field.name)}" ${affinityOf(field)}`)];
+  return `CREATE TABLE IF NOT EXISTS "${(0, _declare.collectionTable)(schema.name)}" (${columns.join(', ')})`;
+}
+function addColumnSql(schema, field) {
+  return `ALTER TABLE "${(0, _declare.collectionTable)(schema.name)}" ADD COLUMN "${(0, _declare.projectedColumn)(field.name)}" ${affinityOf(field)}`;
+}
+
+/**
+ * The name an index has in the database file.
+ *
+ * Index names are database-wide in SQLite, but declared per collection. Until
+ * 0.2.0 the declared name was used as is, so a second collection declaring an
+ * index of the same name hit `IF NOT EXISTS` and silently got no index — a
+ * UNIQUE constraint included. The double underscore keeps a declared name from
+ * colliding with the package's own `<table>_live` index.
+ */
+function physicalIndexName(schema, declaredName) {
+  return `${(0, _declare.collectionTable)(schema.name)}__${declaredName}`;
+}
+
+/** The declared name back from a physical one, for reporting to the app. */
+function declaredIndexName(schema, physicalName) {
+  const prefix = `${(0, _declare.collectionTable)(schema.name)}__`;
+  return physicalName.startsWith(prefix) ? physicalName.slice(prefix.length) : physicalName;
+}
+function createIndexSql(schema) {
+  const table = (0, _declare.collectionTable)(schema.name);
+  const statements = (schema.indexes ?? []).map(index => {
+    const columns = index.fields.map(field => `"${(0, _declare.projectedColumn)(field)}"`).join(', ');
+    return `CREATE ${index.unique ? 'UNIQUE ' : ''}INDEX IF NOT EXISTS "${physicalIndexName(schema, index.name)}" ON "${table}" (${columns})`;
+  });
+  if ((0, _declare.hasSoftDelete)(schema)) {
+    // Every default query carries `deleted_at IS NULL`, so without this the
+    // exclusion turns the cheapest possible filter into a full scan.
+    statements.push(`CREATE INDEX IF NOT EXISTS "${table}_live" ON "${table}" (deleted_at)`);
+  }
+  return statements;
+}
+
+/**
+ * Project a declared field for the WHERE and ORDER BY columns.
+ *
+ * Anything that is not a comparable primitive projects to NULL. A nested
+ * object has no defensible ordering, and inventing one would make a filter
+ * silently match records a consumer never meant to select.
+ */
+function projectValue(data, field) {
+  if (!Object.prototype.hasOwnProperty.call(data, field.name)) {
+    return null;
+  }
+  const value = data[field.name];
+  if (value === null) {
+    return null;
+  }
+  switch (typeof value) {
+    case 'boolean':
+      return value ? 1 : 0;
+    case 'number':
+      return Number.isFinite(value) ? value : null;
+    case 'string':
+      return value;
+    default:
+      return null;
+  }
+}
+function projectedValues(schema, data) {
+  return (schema.fields ?? []).map(field => projectValue(data, field));
+}
+function projectedColumnNames(schema) {
+  return (schema.fields ?? []).map(field => (0, _declare.projectedColumn)(field.name));
+}
+
+/** Serialize on the way in, so a caller mutating its object cannot change
+ * what is stored (FR-022). */
+function encodePayload(data) {
+  return JSON.stringify(data ?? {});
+}
+/**
+ * Rebuild a record from the payload column and nothing else.
+ *
+ * The timestamp and soft-delete fields are surfaced only when the collection
+ * declared them, so a consumer cannot come to depend on a field the schema
+ * never promised.
+ */
+function decodeRow(schema, row) {
+  const record = {
+    id: (0, _values.text)(row.id),
+    data: JSON.parse((0, _values.text)(row.payload))
+  };
+  if ((0, _declare.hasTimestamps)(schema)) {
+    if (row.created_at != null) {
+      record.createdAt = (0, _values.num)(row.created_at);
+    }
+    if (row.updated_at != null) {
+      record.updatedAt = (0, _values.num)(row.updated_at);
+    }
+  }
+  if ((0, _declare.hasSoftDelete)(schema)) {
+    record.deletedAt = row.deleted_at == null ? null : (0, _values.num)(row.deleted_at);
+  }
+  return record;
+}
+function insertColumns(schema, id, data, now, /** The payload already serialized by the budget check, to avoid a second pass. */
+payload = encodePayload(data)) {
+  const columns = ['id', 'payload'];
+  const values = [id, payload];
+  if ((0, _declare.hasTimestamps)(schema)) {
+    columns.push('created_at', 'updated_at');
+    values.push(now, now);
+  }
+  if ((0, _declare.hasSoftDelete)(schema)) {
+    columns.push('deleted_at');
+    values.push(null);
+  }
+  const projected = projectedValues(schema, data);
+  for (const [index, name] of projectedColumnNames(schema).entries()) {
+    columns.push(name);
+    values.push(projected[index]);
+  }
+  return {
+    columns,
+    values
+  };
+}
+function updateAssignments(schema, data, now, payload = encodePayload(data)) {
+  const columns = ['payload'];
+  const values = [payload];
+  if ((0, _declare.hasTimestamps)(schema)) {
+    columns.push('updated_at');
+    values.push(now);
+  }
+  const projected = projectedValues(schema, data);
+  for (const [index, name] of projectedColumnNames(schema).entries()) {
+    columns.push(name);
+    values.push(projected[index]);
+  }
+  return {
+    columns,
+    values
+  };
+}
+//# sourceMappingURL=row-codec.js.map

package/lib/commonjs/sqlite/row-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_declare","require","_values","RESERVED_COLUMNS","exports","affinityOf","field","type","createTableSql","schema","columns","fields","map","projectedColumn","name","collectionTable","join","addColumnSql","physicalIndexName","declaredName","declaredIndexName","physicalName","prefix","startsWith","slice","length","createIndexSql","table","statements","indexes","index","unique","hasSoftDelete","push","projectValue","data","Object","prototype","hasOwnProperty","call","value","Number","isFinite","projectedValues","projectedColumnNames","encodePayload","JSON","stringify","decodeRow","row","record","id","text","parse","payload","hasTimestamps","created_at","createdAt","num","updated_at","updatedAt","deletedAt","deleted_at","insertColumns","now","values","projected","entries","updateAssignments"],"sourceRoot":"../../../src","sources":["sqlite/row-codec.ts"],"mappings":"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","ignoreList":[]}