@korajs/store 0.4.0 → 0.6.0

package/dist/chunk-EZSTD2XC.js

@@ -0,0 +1,380 @@
+import {
+  deserializeOperationWithCollection
+} from "./chunk-56LL4XP6.js";
+
+// src/backup/backup.ts
+import "@korajs/core";
+function encodeSection(name, content) {
+  const nameBytes = new TextEncoder().encode(name);
+  const header = new Uint8Array(8);
+  const dv = new DataView(header.buffer);
+  dv.setUint32(0, nameBytes.length, true);
+  dv.setUint32(4, content.length, true);
+  const result = new Uint8Array(header.length + nameBytes.length + content.length);
+  result.set(header, 0);
+  result.set(nameBytes, 8);
+  result.set(content, 8 + nameBytes.length);
+  return result;
+}
+function encodeJsonSection(name, data) {
+  const json = JSON.stringify(data);
+  return encodeSection(name, new TextEncoder().encode(json));
+}
+function readUint32(view, offset) {
+  return view.getUint32(offset, true);
+}
+function parseSections(data) {
+  const sections = [];
+  const dv = new DataView(data.buffer, data.byteOffset, data.byteLength);
+  let offset = 0;
+  while (offset + 8 <= data.byteLength) {
+    const nameLen = readUint32(dv, offset);
+    const contentLen = readUint32(dv, offset + 4);
+    offset += 8;
+    if (offset + nameLen + contentLen > data.byteLength) break;
+    const name = new TextDecoder().decode(data.slice(offset, offset + nameLen));
+    offset += nameLen;
+    const content = data.slice(offset, offset + contentLen);
+    offset += contentLen;
+    sections.push({ name, content });
+  }
+  return sections;
+}
+function findSection(sections, name) {
+  for (const s of sections) {
+    if (s.name === name) return s.content;
+  }
+  return null;
+}
+function parseJsonSection(sections, name) {
+  const content = findSection(sections, name);
+  if (!content) return null;
+  return JSON.parse(new TextDecoder().decode(content));
+}
+var BACKUP_VERSION = 1;
+async function exportBackup(adapter, schema, nodeId, schemaVersion, options) {
+  const onProgress = options?.onProgress ?? (() => {
+  });
+  const includeRecords = options?.includeRecords ?? true;
+  const collectionFilter = options?.collections;
+  const collections = collectionFilter ? Object.keys(schema.collections).filter((c) => collectionFilter.includes(c)) : Object.keys(schema.collections);
+  onProgress({ phase: "reading", progress: 0, message: "Reading version vector" });
+  const versionVector = await readVersionVector(adapter);
+  onProgress({ phase: "reading", progress: 0.1, message: "Reading metadata" });
+  const meta = await readMeta(adapter);
+  onProgress({ phase: "reading", progress: 0.2, message: "Reading operations" });
+  const operations = await readAllOperations(adapter, schema);
+  onProgress({ phase: "reading", progress: 0.5, message: "Reading records" });
+  const sections = [];
+  let allContentForChecksum = new Uint8Array(0);
+  const addSection = (name, data) => {
+    sections.push(data);
+    const newLen = allContentForChecksum.length + data.length;
+    const combined = new Uint8Array(newLen);
+    combined.set(allContentForChecksum, 0);
+    combined.set(data, allContentForChecksum.length);
+    allContentForChecksum = combined;
+  };
+  const vvObj = {};
+  for (const [nid, seq] of versionVector) {
+    vvObj[nid] = seq;
+  }
+  addSection("version_vector", encodeJsonSection("version_vector", vvObj));
+  const metaObj = {};
+  for (const row of meta) {
+    metaObj[row.key] = row.value;
+  }
+  addSection("meta", encodeJsonSection("meta", metaObj));
+  const opLines = `${operations.map((op) => JSON.stringify(op)).join("\n")}
+`;
+  addSection("operations", encodeSection("operations", new TextEncoder().encode(opLines)));
+  let totalRecords = 0;
+  if (includeRecords) {
+    for (const col of collections) {
+      const records = await readCollectionRecords(adapter, col);
+      if (records.length > 0) {
+        const lines = `${records.map((r) => JSON.stringify(r)).join("\n")}
+`;
+        const sectionName = `records:${col}`;
+        addSection(sectionName, encodeSection(sectionName, new TextEncoder().encode(lines)));
+        totalRecords += records.length;
+      }
+    }
+  }
+  onProgress({ phase: "reading", progress: 0.9, message: "Computing checksum" });
+  const checksumHex = await computeSha256(allContentForChecksum);
+  onProgress({ phase: "writing", progress: 1, message: "Finalizing" });
+  const manifest = {
+    version: BACKUP_VERSION,
+    createdAt: Date.now(),
+    nodeId,
+    schemaVersion,
+    operationCount: operations.length,
+    collections,
+    includesRecords: includeRecords,
+    checksum: checksumHex
+  };
+  const header = new Uint8Array(0);
+  const manifestSection = encodeJsonSection("manifest", manifest);
+  const checksumSection = encodeSection("checksum", new TextEncoder().encode(checksumHex));
+  const totalLen = manifestSection.length + allContentForChecksum.length + checksumSection.length;
+  const result = new Uint8Array(totalLen);
+  let pos = 0;
+  result.set(manifestSection, pos);
+  pos += manifestSection.length;
+  result.set(allContentForChecksum, pos);
+  pos += allContentForChecksum.length;
+  result.set(checksumSection, pos);
+  return result;
+}
+function readBackupManifest(data) {
+  const sections = parseSections(data);
+  const manifest = parseJsonSection(sections, "manifest");
+  if (!manifest) {
+    throw new Error("Invalid backup: manifest section not found");
+  }
+  return manifest;
+}
+async function verifyBackupChecksum(data) {
+  const sections = parseSections(data);
+  const manifest = parseJsonSection(sections, "manifest");
+  if (!manifest) return false;
+  const storedChecksum = manifest.checksum;
+  if (!storedChecksum) return false;
+  const manifestSection = findSection(sections, "manifest");
+  if (!manifestSection) return false;
+  const checksumSection = findSection(sections, "checksum");
+  const checksumBytes = checksumSection ? new TextEncoder().encode(manifest.checksum) : new Uint8Array(0);
+  const contentSections = sections.filter((s) => s.name !== "manifest" && s.name !== "checksum");
+  let contentForHash = new Uint8Array(0);
+  for (const section of contentSections) {
+    const sectionBytes = encodeSection(section.name, section.content);
+    const newLen = contentForHash.length + sectionBytes.length;
+    const combined = new Uint8Array(newLen);
+    combined.set(contentForHash, 0);
+    combined.set(sectionBytes, contentForHash.length);
+    contentForHash = combined;
+  }
+  const computed = await computeSha256(contentForHash);
+  return computed === storedChecksum;
+}
+async function restoreBackup(adapter, schema, data, options) {
+  const startTime = Date.now();
+  const onProgress = options?.onProgress ?? (() => {
+  });
+  const collectionFilter = options?.collections;
+  onProgress({ phase: "verifying", progress: 0, message: "Parsing backup" });
+  const sections = parseSections(data);
+  const manifest = parseJsonSection(sections, "manifest");
+  if (!manifest) {
+    return {
+      operationsRestored: 0,
+      recordsRestored: 0,
+      success: false,
+      error: "Invalid backup: manifest section not found",
+      duration: Date.now() - startTime
+    };
+  }
+  if (manifest.version !== BACKUP_VERSION) {
+    return {
+      operationsRestored: 0,
+      recordsRestored: 0,
+      success: false,
+      error: `Unsupported backup version: ${manifest.version}`,
+      duration: Date.now() - startTime
+    };
+  }
+  onProgress({ phase: "verifying", progress: 0.2, message: "Verifying checksum" });
+  const valid = await verifyBackupChecksum(data);
+  if (!valid) {
+    return {
+      operationsRestored: 0,
+      recordsRestored: 0,
+      success: false,
+      error: "Backup checksum mismatch: data may be corrupted",
+      duration: Date.now() - startTime
+    };
+  }
+  onProgress({ phase: "restoring", progress: 0.3, message: "Loading operations" });
+  const opsContent = findSection(sections, "operations");
+  let operations = [];
+  if (opsContent) {
+    const text = new TextDecoder().decode(opsContent);
+    const lines = text.trim().split("\n").filter((l) => l.length > 0);
+    operations = lines.map((line) => JSON.parse(line));
+  }
+  if (collectionFilter) {
+    operations = operations.filter((op) => collectionFilter.includes(op.collection));
+  }
+  const vvData = parseJsonSection(sections, "version_vector");
+  const metaData = parseJsonSection(sections, "meta");
+  onProgress({ phase: "restoring", progress: 0.4, message: "Applying operations" });
+  if (options?.merge) {
+    await adapter.transaction(async (tx) => {
+      if (vvData) {
+        for (const [nid, seq] of Object.entries(vvData)) {
+          await tx.execute(
+            "INSERT OR REPLACE INTO _kora_version_vector (node_id, sequence_number) VALUES (?, ?)",
+            [nid, seq]
+          );
+        }
+      }
+      if (metaData) {
+        for (const [key, value] of Object.entries(metaData)) {
+          await tx.execute("INSERT OR REPLACE INTO _kora_meta (key, value) VALUES (?, ?)", [
+            key,
+            value
+          ]);
+        }
+      }
+      for (const op of operations) {
+        const collection = op.collection;
+        const opRow = {
+          id: op.id,
+          node_id: op.nodeId,
+          type: op.type,
+          record_id: op.recordId,
+          data: op.data !== null ? JSON.stringify(op.data) : null,
+          previous_data: op.previousData !== null ? JSON.stringify(op.previousData) : null,
+          timestamp: JSON.stringify(op.timestamp),
+          sequence_number: op.sequenceNumber,
+          causal_deps: JSON.stringify(op.causalDeps),
+          schema_version: op.schemaVersion
+        };
+        await tx.execute(
+          `INSERT OR IGNORE INTO _kora_ops_${collection} (id, node_id, type, record_id, data, previous_data, timestamp, sequence_number, causal_deps, schema_version) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          [
+            opRow.id,
+            opRow.node_id,
+            opRow.type,
+            opRow.record_id,
+            opRow.data,
+            opRow.previous_data,
+            opRow.timestamp,
+            opRow.sequence_number,
+            opRow.causal_deps,
+            opRow.schema_version
+          ]
+        );
+      }
+    });
+  } else {
+    await adapter.transaction(async (tx) => {
+      for (const collection of Object.keys(schema.collections)) {
+        await tx.execute(`DELETE FROM _kora_ops_${collection}`);
+        await tx.execute(`DELETE FROM ${collection}`);
+      }
+      await tx.execute("DELETE FROM _kora_version_vector");
+      await tx.execute("DELETE FROM _kora_meta");
+      if (vvData) {
+        for (const [nid, seq] of Object.entries(vvData)) {
+          await tx.execute(
+            "INSERT INTO _kora_version_vector (node_id, sequence_number) VALUES (?, ?)",
+            [nid, seq]
+          );
+        }
+      }
+      if (metaData) {
+        for (const [key, value] of Object.entries(metaData)) {
+          await tx.execute("INSERT INTO _kora_meta (key, value) VALUES (?, ?)", [key, value]);
+        }
+      }
+      for (const op of operations) {
+        const collection = op.collection;
+        await tx.execute(
+          `INSERT INTO _kora_ops_${collection} (id, node_id, type, record_id, data, previous_data, timestamp, sequence_number, causal_deps, schema_version) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          [
+            op.id,
+            op.nodeId,
+            op.type,
+            op.recordId,
+            op.data !== null ? JSON.stringify(op.data) : null,
+            op.previousData !== null ? JSON.stringify(op.previousData) : null,
+            JSON.stringify(op.timestamp),
+            op.sequenceNumber,
+            JSON.stringify(op.causalDeps),
+            op.schemaVersion
+          ]
+        );
+      }
+    });
+  }
+  onProgress({ phase: "restoring", progress: 0.8, message: "Restoring records" });
+  let recordsRestored = 0;
+  if (manifest.includesRecords) {
+    for (const col of manifest.collections) {
+      if (collectionFilter && !collectionFilter.includes(col)) continue;
+      const sectionContent = findSection(sections, `records:${col}`);
+      if (!sectionContent) continue;
+      const text = new TextDecoder().decode(sectionContent);
+      const lines = text.trim().split("\n").filter((l) => l.length > 0);
+      const records = lines.map((line) => JSON.parse(line));
+      if (records.length === 0) continue;
+      await adapter.transaction(async (tx) => {
+        for (const record of records) {
+          const keys = Object.keys(record);
+          const placeholders = keys.map(() => "?").join(", ");
+          const values = keys.map((k) => {
+            const v = record[k];
+            if (typeof v === "boolean") return v ? 1 : 0;
+            if (Array.isArray(v) || typeof v === "object" && v !== null) return JSON.stringify(v);
+            return v;
+          });
+          await tx.execute(
+            `INSERT OR REPLACE INTO ${col} (${keys.join(", ")}) VALUES (${placeholders})`,
+            values
+          );
+        }
+      });
+      recordsRestored += records.length;
+    }
+  }
+  onProgress({ phase: "restoring", progress: 1, message: "Done" });
+  return {
+    operationsRestored: operations.length,
+    recordsRestored,
+    success: true,
+    duration: Date.now() - startTime
+  };
+}
+async function readVersionVector(adapter) {
+  const rows = await adapter.query(
+    "SELECT node_id, sequence_number FROM _kora_version_vector"
+  );
+  const vv = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    vv.set(row.node_id, row.sequence_number);
+  }
+  return vv;
+}
+async function readMeta(adapter) {
+  return adapter.query("SELECT key, value FROM _kora_meta");
+}
+async function readAllOperations(adapter, schema) {
+  const allOps = [];
+  for (const collectionName of Object.keys(schema.collections)) {
+    const rows = await adapter.query(
+      `SELECT * FROM _kora_ops_${collectionName} ORDER BY sequence_number ASC`
+    );
+    for (const row of rows) {
+      allOps.push(deserializeOperationWithCollection(row, collectionName));
+    }
+  }
+  return allOps;
+}
+async function readCollectionRecords(adapter, collection) {
+  return adapter.query(`SELECT * FROM ${collection} WHERE _deleted = 0`);
+}
+async function computeSha256(data) {
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+export {
+  exportBackup,
+  readBackupManifest,
+  verifyBackupChecksum,
+  restoreBackup
+};
+//# sourceMappingURL=chunk-EZSTD2XC.js.map

package/dist/chunk-EZSTD2XC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/backup/backup.ts"],"sourcesContent":["import { generateUUIDv7 } from '@korajs/core'\nimport type { Operation, SchemaDefinition, VersionVector } from '@korajs/core'\nimport { deserializeOperationWithCollection } from '../serialization/serializer'\nimport type { OperationRow, StorageAdapter } from '../types'\nimport type {\n\tBackupManifest,\n\tBackupOptions,\n\tBackupProgress,\n\tRestoreOptions,\n\tRestoreResult,\n} from './types'\n\n// ── Section I/O helpers ──────────────────────────────────────────────────────\n\nfunction encodeSection(name: string, content: Uint8Array): Uint8Array {\n\tconst nameBytes = new TextEncoder().encode(name)\n\tconst header = new Uint8Array(8)\n\tconst dv = new DataView(header.buffer)\n\tdv.setUint32(0, nameBytes.length, true)\n\tdv.setUint32(4, content.length, true)\n\n\tconst result = new Uint8Array(header.length + nameBytes.length + content.length)\n\tresult.set(header, 0)\n\tresult.set(nameBytes, 8)\n\tresult.set(content, 8 + nameBytes.length)\n\treturn result\n}\n\nfunction encodeJsonSection(name: string, data: unknown): Uint8Array {\n\tconst json = JSON.stringify(data)\n\treturn encodeSection(name, new TextEncoder().encode(json))\n}\n\nfunction encodeNdjsonSection(name: string, records: unknown[]): Uint8Array {\n\tconst lines = `${records.map((r) => JSON.stringify(r)).join('\\n')}\\n`\n\treturn encodeSection(name, new TextEncoder().encode(lines))\n}\n\nfunction readUint32(view: DataView, offset: number): number {\n\treturn view.getUint32(offset, true)\n}\n\ninterface Section {\n\tname: string\n\tcontent: Uint8Array\n}\n\nfunction parseSections(data: Uint8Array): Section[] {\n\tconst sections: Section[] = []\n\tconst dv = new DataView(data.buffer, data.byteOffset, data.byteLength)\n\tlet offset = 0\n\n\twhile (offset + 8 <= data.byteLength) {\n\t\tconst nameLen = readUint32(dv, offset)\n\t\tconst contentLen = readUint32(dv, offset + 4)\n\t\toffset += 8\n\n\t\tif (offset + nameLen + contentLen > data.byteLength) break\n\n\t\tconst name = new TextDecoder().decode(data.slice(offset, offset + nameLen))\n\t\toffset += nameLen\n\n\t\tconst content = data.slice(offset, offset + contentLen)\n\t\toffset += contentLen\n\n\t\tsections.push({ name, content })\n\t}\n\n\treturn sections\n}\n\nfunction findSection(sections: Section[], name: string): Uint8Array | null {\n\tfor (const s of sections) {\n\t\tif (s.name === name) return s.content\n\t}\n\treturn null\n}\n\nfunction parseJsonSection<T>(sections: Section[], name: string): T | null {\n\tconst content = findSection(sections, name)\n\tif (!content) return null\n\treturn JSON.parse(new TextDecoder().decode(content)) as T\n}\n\n/**\n * Export format version. Bump on breaking changes.\n */\nconst BACKUP_VERSION = 1\n\n/**\n * Export a backup from a store.\n *\n * Reads all data via the adapter and produces a portable binary backup.\n *\n * @param adapter - The storage adapter\n * @param schema - The schema definition\n * @param nodeId - Current node ID\n * @param schemaVersion - Schema version\n * @param options - Backup options\n * @returns Backup as a Uint8Array\n */\nexport async function exportBackup(\n\tadapter: StorageAdapter,\n\tschema: SchemaDefinition,\n\tnodeId: string,\n\tschemaVersion: number,\n\toptions?: BackupOptions,\n): Promise<Uint8Array> {\n\tconst onProgress = options?.onProgress ?? (() => {})\n\tconst includeRecords = options?.includeRecords ?? true\n\tconst collectionFilter = options?.collections\n\tconst collections = collectionFilter\n\t\t? Object.keys(schema.collections).filter((c) => collectionFilter.includes(c))\n\t\t: Object.keys(schema.collections)\n\n\tonProgress({ phase: 'reading', progress: 0, message: 'Reading version vector' })\n\tconst versionVector = await readVersionVector(adapter)\n\tonProgress({ phase: 'reading', progress: 0.1, message: 'Reading metadata' })\n\tconst meta = await readMeta(adapter)\n\tonProgress({ phase: 'reading', progress: 0.2, message: 'Reading operations' })\n\tconst operations = await readAllOperations(adapter, schema)\n\tonProgress({ phase: 'reading', progress: 0.5, message: 'Reading records' })\n\n\tconst sections: Uint8Array[] = []\n\tlet allContentForChecksum = new Uint8Array(0)\n\n\t// Helper: add a section and update running checksum content\n\tconst addSection = (name: string, data: Uint8Array) => {\n\t\tsections.push(data)\n\t\tconst newLen = allContentForChecksum.length + data.length\n\t\tconst combined = new Uint8Array(newLen)\n\t\tcombined.set(allContentForChecksum, 0)\n\t\tcombined.set(data, allContentForChecksum.length)\n\t\tallContentForChecksum = combined\n\t}\n\n\t// Version vector section\n\tconst vvObj: Record<string, number> = {}\n\tfor (const [nid, seq] of versionVector) {\n\t\tvvObj[nid] = seq\n\t}\n\taddSection('version_vector', encodeJsonSection('version_vector', vvObj))\n\n\t// Meta section\n\tconst metaObj: Record<string, string> = {}\n\tfor (const row of meta) {\n\t\tmetaObj[row.key] = row.value\n\t}\n\taddSection('meta', encodeJsonSection('meta', metaObj))\n\n\t// Operations section\n\tconst opLines = `${operations.map((op) => JSON.stringify(op)).join('\\n')}\\n`\n\taddSection('operations', encodeSection('operations', new TextEncoder().encode(opLines)))\n\n\t// Records sections (optional)\n\tlet totalRecords = 0\n\tif (includeRecords) {\n\t\tfor (const col of collections) {\n\t\t\tconst records = await readCollectionRecords(adapter, col)\n\t\t\tif (records.length > 0) {\n\t\t\t\tconst lines = `${records.map((r) => JSON.stringify(r)).join('\\n')}\\n`\n\t\t\t\tconst sectionName = `records:${col}`\n\t\t\t\taddSection(sectionName, encodeSection(sectionName, new TextEncoder().encode(lines)))\n\t\t\t\ttotalRecords += records.length\n\t\t\t}\n\t\t}\n\t}\n\tonProgress({ phase: 'reading', progress: 0.9, message: 'Computing checksum' })\n\n\t// Compute SHA-256 checksum over all content sections\n\tconst checksumHex = await computeSha256(allContentForChecksum)\n\tonProgress({ phase: 'writing', progress: 1, message: 'Finalizing' })\n\n\t// Build manifest\n\tconst manifest: BackupManifest = {\n\t\tversion: BACKUP_VERSION,\n\t\tcreatedAt: Date.now(),\n\t\tnodeId,\n\t\tschemaVersion,\n\t\toperationCount: operations.length,\n\t\tcollections,\n\t\tincludesRecords: includeRecords,\n\t\tchecksum: checksumHex,\n\t}\n\n\t// Final output: header + manifest + all content sections + checksum section\n\tconst header = new Uint8Array(0)\n\n\t// Merge manifest + all sections + checksum section\n\tconst manifestSection = encodeJsonSection('manifest', manifest)\n\tconst checksumSection = encodeSection('checksum', new TextEncoder().encode(checksumHex))\n\n\tconst totalLen = manifestSection.length + allContentForChecksum.length + checksumSection.length\n\tconst result = new Uint8Array(totalLen)\n\tlet pos = 0\n\tresult.set(manifestSection, pos)\n\tpos += manifestSection.length\n\tresult.set(allContentForChecksum, pos)\n\tpos += allContentForChecksum.length\n\tresult.set(checksumSection, pos)\n\n\treturn result\n}\n\n/**\n * Read backup manifest without loading the entire backup.\n * Parses only the first section (which is always the manifest).\n *\n * @param data - The raw backup data\n * @returns The backup manifest\n */\nexport function readBackupManifest(data: Uint8Array): BackupManifest {\n\tconst sections = parseSections(data)\n\tconst manifest = parseJsonSection<BackupManifest>(sections, 'manifest')\n\tif (!manifest) {\n\t\tthrow new Error('Invalid backup: manifest section not found')\n\t}\n\treturn manifest\n}\n\n/**\n * Validate the backup checksum.\n *\n * @param data - The raw backup data\n * @returns True if the checksum is valid\n */\nexport async function verifyBackupChecksum(data: Uint8Array): Promise<boolean> {\n\tconst sections = parseSections(data)\n\tconst manifest = parseJsonSection<BackupManifest>(sections, 'manifest')\n\tif (!manifest) return false\n\n\tconst storedChecksum = manifest.checksum\n\tif (!storedChecksum) return false\n\n\t// Recompute checksum over content sections (everything after manifest, before checksum)\n\tconst manifestSection = findSection(sections, 'manifest')\n\tif (!manifestSection) return false\n\n\t// Find the checksum section\n\tconst checksumSection = findSection(sections, 'checksum')\n\n\t// The content spans from end of manifest section to start of checksum section\n\tconst checksumBytes = checksumSection\n\t\t? new TextEncoder().encode(manifest.checksum)\n\t\t: new Uint8Array(0)\n\n\t// Rebuild all content sections and hash them\n\tconst contentSections = sections.filter((s) => s.name !== 'manifest' && s.name !== 'checksum')\n\n\tlet contentForHash = new Uint8Array(0)\n\tfor (const section of contentSections) {\n\t\tconst sectionBytes = encodeSection(section.name, section.content)\n\t\tconst newLen = contentForHash.length + sectionBytes.length\n\t\tconst combined = new Uint8Array(newLen)\n\t\tcombined.set(contentForHash, 0)\n\t\tcombined.set(sectionBytes, contentForHash.length)\n\t\tcontentForHash = combined\n\t}\n\n\tconst computed = await computeSha256(contentForHash)\n\treturn computed === storedChecksum\n}\n\n/**\n * Restore a backup into a store.\n *\n * @param adapter - The storage adapter\n * @param schema - The schema definition\n * @param data - The backup data\n * @param options - Restore options\n * @returns Result of the restore operation\n */\nexport async function restoreBackup(\n\tadapter: StorageAdapter,\n\tschema: SchemaDefinition,\n\tdata: Uint8Array,\n\toptions?: RestoreOptions,\n): Promise<RestoreResult> {\n\tconst startTime = Date.now()\n\tconst onProgress = options?.onProgress ?? (() => {})\n\tconst collectionFilter = options?.collections\n\n\tonProgress({ phase: 'verifying', progress: 0, message: 'Parsing backup' })\n\n\tconst sections = parseSections(data)\n\tconst manifest = parseJsonSection<BackupManifest>(sections, 'manifest')\n\tif (!manifest) {\n\t\treturn {\n\t\t\toperationsRestored: 0,\n\t\t\trecordsRestored: 0,\n\t\t\tsuccess: false,\n\t\t\terror: 'Invalid backup: manifest section not found',\n\t\t\tduration: Date.now() - startTime,\n\t\t}\n\t}\n\n\t// Validate format version\n\tif (manifest.version !== BACKUP_VERSION) {\n\t\treturn {\n\t\t\toperationsRestored: 0,\n\t\t\trecordsRestored: 0,\n\t\t\tsuccess: false,\n\t\t\terror: `Unsupported backup version: ${manifest.version}`,\n\t\t\tduration: Date.now() - startTime,\n\t\t}\n\t}\n\n\tonProgress({ phase: 'verifying', progress: 0.2, message: 'Verifying checksum' })\n\n\t// Verify checksum\n\tconst valid = await verifyBackupChecksum(data)\n\tif (!valid) {\n\t\treturn {\n\t\t\toperationsRestored: 0,\n\t\t\trecordsRestored: 0,\n\t\t\tsuccess: false,\n\t\t\terror: 'Backup checksum mismatch: data may be corrupted',\n\t\t\tduration: Date.now() - startTime,\n\t\t}\n\t}\n\n\tonProgress({ phase: 'restoring', progress: 0.3, message: 'Loading operations' })\n\n\t// Parse operations\n\tconst opsContent = findSection(sections, 'operations')\n\tlet operations: Operation[] = []\n\tif (opsContent) {\n\t\tconst text = new TextDecoder().decode(opsContent)\n\t\tconst lines = text\n\t\t\t.trim()\n\t\t\t.split('\\n')\n\t\t\t.filter((l) => l.length > 0)\n\t\toperations = lines.map((line) => JSON.parse(line) as Operation)\n\t}\n\n\t// Filter collections if requested\n\tif (collectionFilter) {\n\t\toperations = operations.filter((op) => collectionFilter.includes(op.collection))\n\t}\n\n\t// Load version vector\n\tconst vvData = parseJsonSection<Record<string, number>>(sections, 'version_vector')\n\n\t// Load meta\n\tconst metaData = parseJsonSection<Record<string, string>>(sections, 'meta')\n\n\tonProgress({ phase: 'restoring', progress: 0.4, message: 'Applying operations' })\n\n\tif (options?.merge) {\n\t\t// Merge mode: replay operations through applyRemoteOperation.\n\t\t// This won't work directly since adapter doesn't have applyRemoteOperation.\n\t\t// Instead, we import the raw data into the adapter.\n\t\tawait adapter.transaction(async (tx) => {\n\t\t\t// Import version vector\n\t\t\tif (vvData) {\n\t\t\t\tfor (const [nid, seq] of Object.entries(vvData)) {\n\t\t\t\t\tawait tx.execute(\n\t\t\t\t\t\t'INSERT OR REPLACE INTO _kora_version_vector (node_id, sequence_number) VALUES (?, ?)',\n\t\t\t\t\t\t[nid, seq],\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Import meta\n\t\t\tif (metaData) {\n\t\t\t\tfor (const [key, value] of Object.entries(metaData)) {\n\t\t\t\t\tawait tx.execute('INSERT OR REPLACE INTO _kora_meta (key, value) VALUES (?, ?)', [\n\t\t\t\t\t\tkey,\n\t\t\t\t\t\tvalue,\n\t\t\t\t\t])\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Import operations into _kora_ops_ tables\n\t\t\tfor (const op of operations) {\n\t\t\t\tconst collection = op.collection\n\t\t\t\tconst opRow = {\n\t\t\t\t\tid: op.id,\n\t\t\t\t\tnode_id: op.nodeId,\n\t\t\t\t\ttype: op.type,\n\t\t\t\t\trecord_id: op.recordId,\n\t\t\t\t\tdata: op.data !== null ? JSON.stringify(op.data) : null,\n\t\t\t\t\tprevious_data: op.previousData !== null ? JSON.stringify(op.previousData) : null,\n\t\t\t\t\ttimestamp: JSON.stringify(op.timestamp),\n\t\t\t\t\tsequence_number: op.sequenceNumber,\n\t\t\t\t\tcausal_deps: JSON.stringify(op.causalDeps),\n\t\t\t\t\tschema_version: op.schemaVersion,\n\t\t\t\t}\n\n\t\t\t\tawait tx.execute(\n\t\t\t\t\t`INSERT OR IGNORE INTO _kora_ops_${collection} (id, node_id, type, record_id, data, previous_data, timestamp, sequence_number, causal_deps, schema_version) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t\t\t[\n\t\t\t\t\t\topRow.id,\n\t\t\t\t\t\topRow.node_id,\n\t\t\t\t\t\topRow.type,\n\t\t\t\t\t\topRow.record_id,\n\t\t\t\t\t\topRow.data,\n\t\t\t\t\t\topRow.previous_data,\n\t\t\t\t\t\topRow.timestamp,\n\t\t\t\t\t\topRow.sequence_number,\n\t\t\t\t\t\topRow.causal_deps,\n\t\t\t\t\t\topRow.schema_version,\n\t\t\t\t\t],\n\t\t\t\t)\n\t\t\t}\n\t\t})\n\t} else {\n\t\t// Replace mode: clear existing data and bulk import\n\t\tawait adapter.transaction(async (tx) => {\n\t\t\t// Clear existing data\n\t\t\tfor (const collection of Object.keys(schema.collections)) {\n\t\t\t\tawait tx.execute(`DELETE FROM _kora_ops_${collection}`)\n\t\t\t\tawait tx.execute(`DELETE FROM ${collection}`)\n\t\t\t}\n\t\t\tawait tx.execute('DELETE FROM _kora_version_vector')\n\t\t\tawait tx.execute('DELETE FROM _kora_meta')\n\n\t\t\t// Import version vector\n\t\t\tif (vvData) {\n\t\t\t\tfor (const [nid, seq] of Object.entries(vvData)) {\n\t\t\t\t\tawait tx.execute(\n\t\t\t\t\t\t'INSERT INTO _kora_version_vector (node_id, sequence_number) VALUES (?, ?)',\n\t\t\t\t\t\t[nid, seq],\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Import meta\n\t\t\tif (metaData) {\n\t\t\t\tfor (const [key, value] of Object.entries(metaData)) {\n\t\t\t\t\tawait tx.execute('INSERT INTO _kora_meta (key, value) VALUES (?, ?)', [key, value])\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Import operations\n\t\t\tfor (const op of operations) {\n\t\t\t\tconst collection = op.collection\n\t\t\t\tawait tx.execute(\n\t\t\t\t\t`INSERT INTO _kora_ops_${collection} (id, node_id, type, record_id, data, previous_data, timestamp, sequence_number, causal_deps, schema_version) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t\t\t[\n\t\t\t\t\t\top.id,\n\t\t\t\t\t\top.nodeId,\n\t\t\t\t\t\top.type,\n\t\t\t\t\t\top.recordId,\n\t\t\t\t\t\top.data !== null ? JSON.stringify(op.data) : null,\n\t\t\t\t\t\top.previousData !== null ? JSON.stringify(op.previousData) : null,\n\t\t\t\t\t\tJSON.stringify(op.timestamp),\n\t\t\t\t\t\top.sequenceNumber,\n\t\t\t\t\t\tJSON.stringify(op.causalDeps),\n\t\t\t\t\t\top.schemaVersion,\n\t\t\t\t\t],\n\t\t\t\t)\n\t\t\t}\n\t\t})\n\t}\n\n\tonProgress({ phase: 'restoring', progress: 0.8, message: 'Restoring records' })\n\n\t// Restore records sections (optional)\n\tlet recordsRestored = 0\n\tif (manifest.includesRecords) {\n\t\tfor (const col of manifest.collections) {\n\t\t\tif (collectionFilter && !collectionFilter.includes(col)) continue\n\n\t\t\tconst sectionContent = findSection(sections, `records:${col}`)\n\t\t\tif (!sectionContent) continue\n\n\t\t\tconst text = new TextDecoder().decode(sectionContent)\n\t\t\tconst lines = text\n\t\t\t\t.trim()\n\t\t\t\t.split('\\n')\n\t\t\t\t.filter((l) => l.length > 0)\n\t\t\tconst records = lines.map((line) => JSON.parse(line) as Record<string, unknown>)\n\n\t\t\tif (records.length === 0) continue\n\n\t\t\tawait adapter.transaction(async (tx) => {\n\t\t\t\tfor (const record of records) {\n\t\t\t\t\tconst keys = Object.keys(record)\n\t\t\t\t\tconst placeholders = keys.map(() => '?').join(', ')\n\t\t\t\t\tconst values = keys.map((k) => {\n\t\t\t\t\t\tconst v = record[k]\n\t\t\t\t\t\tif (typeof v === 'boolean') return v ? 1 : 0\n\t\t\t\t\t\tif (Array.isArray(v) || (typeof v === 'object' && v !== null)) return JSON.stringify(v)\n\t\t\t\t\t\treturn v\n\t\t\t\t\t})\n\n\t\t\t\t\tawait tx.execute(\n\t\t\t\t\t\t`INSERT OR REPLACE INTO ${col} (${keys.join(', ')}) VALUES (${placeholders})`,\n\t\t\t\t\t\tvalues,\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t})\n\n\t\t\trecordsRestored += records.length\n\t\t}\n\t}\n\n\tonProgress({ phase: 'restoring', progress: 1, message: 'Done' })\n\n\treturn {\n\t\toperationsRestored: operations.length,\n\t\trecordsRestored,\n\t\tsuccess: true,\n\t\tduration: Date.now() - startTime,\n\t}\n}\n\n// ── Reading helpers ──────────────────────────────────────────────────────────\n\nasync function readVersionVector(adapter: StorageAdapter): Promise<Map<string, number>> {\n\tconst rows = await adapter.query<{ node_id: string; sequence_number: number }>(\n\t\t'SELECT node_id, sequence_number FROM _kora_version_vector',\n\t)\n\tconst vv = new Map<string, number>()\n\tfor (const row of rows) {\n\t\tvv.set(row.node_id, row.sequence_number)\n\t}\n\treturn vv\n}\n\ninterface MetaRow {\n\tkey: string\n\tvalue: string\n}\n\nasync function readMeta(adapter: StorageAdapter): Promise<MetaRow[]> {\n\treturn adapter.query<MetaRow>('SELECT key, value FROM _kora_meta')\n}\n\nasync function readAllOperations(\n\tadapter: StorageAdapter,\n\tschema: SchemaDefinition,\n): Promise<Operation[]> {\n\tconst allOps: Operation[] = []\n\n\tfor (const collectionName of Object.keys(schema.collections)) {\n\t\tconst rows = await adapter.query<OperationRow>(\n\t\t\t`SELECT * FROM _kora_ops_${collectionName} ORDER BY sequence_number ASC`,\n\t\t)\n\n\t\tfor (const row of rows) {\n\t\t\tallOps.push(deserializeOperationWithCollection(row, collectionName))\n\t\t}\n\t}\n\n\treturn allOps\n}\n\nasync function readCollectionRecords(\n\tadapter: StorageAdapter,\n\tcollection: string,\n): Promise<Record<string, unknown>[]> {\n\treturn adapter.query<Record<string, unknown>>(`SELECT * FROM ${collection} WHERE _deleted = 0`)\n}\n\n// ── Crypto helpers ───────────────────────────────────────────────────────────\n\nasync function computeSha256(data: Uint8Array<ArrayBuffer>): Promise<string> {\n\tconst hashBuffer = await crypto.subtle.digest('SHA-256', data)\n\tconst hashArray = Array.from(new Uint8Array(hashBuffer))\n\treturn hashArray.map((b) => b.toString(16).padStart(2, '0')).join('')\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-MYSJN3DF.js

@@ -0,0 +1,117 @@
+// src/audit/audit-trace-store.ts
+import { generateUUIDv7 } from "@korajs/core";
+
+// src/audit/audit-json.ts
+var WIRE_BYTES_KEY = "__kora_bytes__";
+function auditJsonReplacer(_key, value) {
+  if (value instanceof Uint8Array) {
+    let binary = "";
+    for (let i = 0; i < value.length; i++) {
+      binary += String.fromCharCode(value[i]);
+    }
+    return { [WIRE_BYTES_KEY]: btoa(binary) };
+  }
+  return value;
+}
+function auditJsonReviver(_key, value) {
+  if (value !== null && typeof value === "object" && WIRE_BYTES_KEY in value && typeof value[WIRE_BYTES_KEY] === "string") {
+    const encoded = value[WIRE_BYTES_KEY];
+    if (typeof encoded !== "string") {
+      return value;
+    }
+    const binary = atob(encoded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+  }
+  return value;
+}
+function serializeAuditJson(value) {
+  return JSON.stringify(value, auditJsonReplacer);
+}
+function deserializeAuditJson(json) {
+  return JSON.parse(json, auditJsonReviver);
+}
+
+// src/audit/audit-trace-store.ts
+function persistedAuditTraceFromEvent(event) {
+  return {
+    id: generateUUIDv7(),
+    recordedAt: Date.now(),
+    eventType: event.type,
+    constraint: event.type === "constraint:violated" ? event.constraint : void 0,
+    trace: event.trace
+  };
+}
+async function appendAuditTrace(adapter, trace) {
+  const collection = trace.trace.operationA.collection;
+  const recordId = trace.trace.operationA.recordId;
+  await adapter.execute(
+    `INSERT INTO _kora_audit_traces (
+			id, recorded_at, event_type, collection, record_id, field, strategy, tier, constraint_name, trace_json
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+    [
+      trace.id,
+      trace.recordedAt,
+      trace.eventType,
+      collection,
+      recordId,
+      trace.trace.field,
+      trace.trace.strategy,
+      trace.trace.tier,
+      trace.constraint ?? null,
+      serializeAuditJson(trace)
+    ]
+  );
+}
+async function readAuditTraces(adapter, query) {
+  const conditions = [];
+  const params = [];
+  if (query?.collections && query.collections.length > 0) {
+    const placeholders = query.collections.map(() => "?").join(", ");
+    conditions.push(`collection IN (${placeholders})`);
+    params.push(...query.collections);
+  }
+  if (query?.since !== void 0) {
+    conditions.push("recorded_at >= ?");
+    params.push(query.since);
+  }
+  if (query?.until !== void 0) {
+    conditions.push("recorded_at <= ?");
+    params.push(query.until);
+  }
+  const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = await adapter.query(
+    `SELECT * FROM _kora_audit_traces ${whereClause} ORDER BY recorded_at ASC, id ASC`,
+    params
+  );
+  return rows.map(rowToPersistedTrace);
+}
+function rowToPersistedTrace(row) {
+  return deserializeAuditJson(row.trace_json);
+}
+async function countAuditTraces(adapter) {
+  const rows = await adapter.query(
+    "SELECT COUNT(*) as count FROM _kora_audit_traces"
+  );
+  return rows[0]?.count ?? 0;
+}
+function auditTraceIndexFields(trace) {
+  return {
+    collection: trace.operationA.collection,
+    recordId: trace.operationA.recordId
+  };
+}
+
+export {
+  serializeAuditJson,
+  deserializeAuditJson,
+  persistedAuditTraceFromEvent,
+  appendAuditTrace,
+  readAuditTraces,
+  countAuditTraces,
+  auditTraceIndexFields
+};
+//# sourceMappingURL=chunk-MYSJN3DF.js.map

package/dist/chunk-MYSJN3DF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audit/audit-trace-store.ts","../src/audit/audit-json.ts"],"sourcesContent":["import { generateUUIDv7 } from '@korajs/core'\nimport type { KoraEvent, MergeTrace } from '@korajs/core'\nimport type { StorageAdapter } from '../types'\nimport { deserializeAuditJson, serializeAuditJson } from './audit-json'\nimport type { AuditTraceQuery, PersistedAuditTrace } from './types'\n\ninterface AuditTraceRow {\n\tid: string\n\trecorded_at: number\n\tevent_type: string\n\tcollection: string\n\trecord_id: string\n\tfield: string\n\tstrategy: string\n\ttier: number\n\tconstraint_name: string | null\n\ttrace_json: string\n}\n\n/**\n * Build a {@link PersistedAuditTrace} from a merge-related Kora event.\n */\nexport function persistedAuditTraceFromEvent(\n\tevent: Extract<KoraEvent, { type: 'merge:completed' | 'merge:conflict' | 'constraint:violated' }>,\n): PersistedAuditTrace {\n\treturn {\n\t\tid: generateUUIDv7(),\n\t\trecordedAt: Date.now(),\n\t\teventType: event.type,\n\t\tconstraint: event.type === 'constraint:violated' ? event.constraint : undefined,\n\t\ttrace: event.trace,\n\t}\n}\n\n/**\n * Append a merge trace to the durable audit log.\n */\nexport async function appendAuditTrace(\n\tadapter: StorageAdapter,\n\ttrace: PersistedAuditTrace,\n): Promise<void> {\n\tconst collection = trace.trace.operationA.collection\n\tconst recordId = trace.trace.operationA.recordId\n\n\tawait adapter.execute(\n\t\t`INSERT INTO _kora_audit_traces (\n\t\t\tid, recorded_at, event_type, collection, record_id, field, strategy, tier, constraint_name, trace_json\n\t\t) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n\t\t[\n\t\t\ttrace.id,\n\t\t\ttrace.recordedAt,\n\t\t\ttrace.eventType,\n\t\t\tcollection,\n\t\t\trecordId,\n\t\t\ttrace.trace.field,\n\t\t\ttrace.trace.strategy,\n\t\t\ttrace.trace.tier,\n\t\t\ttrace.constraint ?? null,\n\t\t\tserializeAuditJson(trace),\n\t\t],\n\t)\n}\n\n/**\n * Load persisted audit traces with optional filters.\n */\nexport async function readAuditTraces(\n\tadapter: StorageAdapter,\n\tquery?: AuditTraceQuery,\n): Promise<PersistedAuditTrace[]> {\n\tconst conditions: string[] = []\n\tconst params: unknown[] = []\n\n\tif (query?.collections && query.collections.length > 0) {\n\t\tconst placeholders = query.collections.map(() => '?').join(', ')\n\t\tconditions.push(`collection IN (${placeholders})`)\n\t\tparams.push(...query.collections)\n\t}\n\tif (query?.since !== undefined) {\n\t\tconditions.push('recorded_at >= ?')\n\t\tparams.push(query.since)\n\t}\n\tif (query?.until !== undefined) {\n\t\tconditions.push('recorded_at <= ?')\n\t\tparams.push(query.until)\n\t}\n\n\tconst whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : ''\n\tconst rows = await adapter.query<AuditTraceRow>(\n\t\t`SELECT * FROM _kora_audit_traces ${whereClause} ORDER BY recorded_at ASC, id ASC`,\n\t\tparams,\n\t)\n\n\treturn rows.map(rowToPersistedTrace)\n}\n\nfunction rowToPersistedTrace(row: AuditTraceRow): PersistedAuditTrace {\n\treturn deserializeAuditJson<PersistedAuditTrace>(row.trace_json)\n}\n\n/**\n * Count persisted audit traces (for diagnostics).\n */\nexport async function countAuditTraces(adapter: StorageAdapter): Promise<number> {\n\tconst rows = await adapter.query<{ count: number }>(\n\t\t'SELECT COUNT(*) as count FROM _kora_audit_traces',\n\t)\n\treturn rows[0]?.count ?? 0\n}\n\n/**\n * Extract collection and record id from a merge trace for indexing.\n */\nexport function auditTraceIndexFields(trace: MergeTrace): {\n\tcollection: string\n\trecordId: string\n} {\n\treturn {\n\t\tcollection: trace.operationA.collection,\n\t\trecordId: trace.operationA.recordId,\n\t}\n}\n","const WIRE_BYTES_KEY = '__kora_bytes__'\n\n/**\n * JSON.stringify replacer that preserves binary field values (e.g. richtext).\n */\nexport function auditJsonReplacer(_key: string, value: unknown): unknown {\n\tif (value instanceof Uint8Array) {\n\t\tlet binary = ''\n\t\tfor (let i = 0; i < value.length; i++) {\n\t\t\tbinary += String.fromCharCode(value[i] as number)\n\t\t}\n\t\treturn { [WIRE_BYTES_KEY]: btoa(binary) }\n\t}\n\treturn value\n}\n\n/**\n * JSON.parse reviver that restores binary field values.\n */\nexport function auditJsonReviver(_key: string, value: unknown): unknown {\n\tif (\n\t\tvalue !== null &&\n\t\ttypeof value === 'object' &&\n\t\tWIRE_BYTES_KEY in value &&\n\t\ttypeof (value as Record<string, unknown>)[WIRE_BYTES_KEY] === 'string'\n\t) {\n\t\tconst encoded = (value as Record<string, unknown>)[WIRE_BYTES_KEY]\n\t\tif (typeof encoded !== 'string') {\n\t\t\treturn value\n\t\t}\n\t\tconst binary = atob(encoded)\n\t\tconst bytes = new Uint8Array(binary.length)\n\t\tfor (let i = 0; i < binary.length; i++) {\n\t\t\tbytes[i] = binary.charCodeAt(i)\n\t\t}\n\t\treturn bytes\n\t}\n\treturn value\n}\n\n/**\n * Serialize a value for durable audit storage or export.\n */\nexport function serializeAuditJson(value: unknown): string {\n\treturn JSON.stringify(value, auditJsonReplacer)\n}\n\n/**\n * Deserialize audit JSON back to typed values.\n */\nexport function deserializeAuditJson<T>(json: string): T {\n\treturn JSON.parse(json, auditJsonReviver) as T\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-DXKLAQ6P.js → chunk-XO4LMPAH.js}

@@ -108,4 +108,4 @@ export {
   Mutex,
   WebWorkerBridge
 };
-//# sourceMappingURL=chunk-DXKLAQ6P.js.map
+//# sourceMappingURL=chunk-XO4LMPAH.js.map

package/dist/chunk-XO4LMPAH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/sqlite-wasm-channel.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\nimport { WorkerTimeoutError } from '../errors'\n\n// === Message Protocol ===\n\n/**\n * Request message sent from the main thread to the SQLite WASM worker.\n * Each request carries a unique `id` for response correlation.\n */\nexport type WorkerRequest =\n\t| { id: number; type: 'open'; ddlStatements: string[]; dbName?: string }\n\t| { id: number; type: 'close' }\n\t| { id: number; type: 'execute'; sql: string; params?: unknown[] }\n\t| { id: number; type: 'query'; sql: string; params?: unknown[] }\n\t| { id: number; type: 'begin' }\n\t| { id: number; type: 'commit' }\n\t| { id: number; type: 'rollback' }\n\t| { id: number; type: 'migrate'; from: number; to: number; statements: string[] }\n\t| { id: number; type: 'export' }\n\t| { id: number; type: 'import'; data: Uint8Array }\n\n/**\n * Response message sent from the worker back to the main thread.\n * Matches the request `id` for correlation.\n */\nexport type WorkerResponse =\n\t| { id: number; type: 'success'; data?: unknown }\n\t| { id: number; type: 'error'; message: string; code: string; context?: Record<string, unknown> }\n\n// === WorkerBridge Interface ===\n\n/**\n * Abstraction over the communication channel with the SQLite WASM worker.\n * In browsers, this is backed by a real Web Worker via MessagePort.\n * In Node.js tests, this is backed by better-sqlite3 via MockWorkerBridge.\n */\nexport interface WorkerBridge {\n\t/** Send a request to the worker and wait for a response. */\n\tsend(request: WorkerRequest): Promise<WorkerResponse>\n\n\t/** Terminate the worker. Safe to call multiple times. */\n\tterminate(): void\n}\n\n// === Mutex ===\n\n/**\n * Async mutex for serializing transaction access across the async worker boundary.\n * Only one transaction may be active at a time.\n */\nexport class Mutex {\n\tprivate locked = false\n\tprivate waiters: Array<() => void> = []\n\n\t/**\n\t * Acquire the mutex. Returns a release function.\n\t * If the mutex is already held, the caller waits until it's released.\n\t */\n\tasync acquire(): Promise<() => void> {\n\t\tif (!this.locked) {\n\t\t\tthis.locked = true\n\t\t\treturn this.createRelease()\n\t\t}\n\n\t\treturn new Promise<() => void>((resolve) => {\n\t\t\tthis.waiters.push(() => {\n\t\t\t\tresolve(this.createRelease())\n\t\t\t})\n\t\t})\n\t}\n\n\tprivate createRelease(): () => void {\n\t\tlet released = false\n\t\treturn () => {\n\t\t\tif (released) return\n\t\t\treleased = true\n\t\t\tconst next = this.waiters.shift()\n\t\t\tif (next) {\n\t\t\t\tnext()\n\t\t\t} else {\n\t\t\t\tthis.locked = false\n\t\t\t}\n\t\t}\n\t}\n}\n\n// === WebWorkerBridge ===\n\n/**\n * WorkerBridge implementation for browser environments.\n * Communicates with an actual Web Worker running SQLite WASM.\n */\nexport class WebWorkerBridge implements WorkerBridge {\n\tprivate worker: Worker\n\tprivate pending = new Map<\n\t\tnumber,\n\t\t{ resolve: (r: WorkerResponse) => void; reject: (e: Error) => void }\n\t>()\n\tprivate nextId = 1\n\tprivate terminated = false\n\tprivate timeoutMs: number\n\n\t/**\n\t * @param workerUrl - URL to the sqlite-wasm-worker script\n\t * @param timeoutMs - Timeout for worker responses in milliseconds (default: 30000)\n\t */\n\tconstructor(workerUrl: string | URL, timeoutMs = 30000) {\n\t\tthis.timeoutMs = timeoutMs\n\t\tthis.worker = new Worker(workerUrl, { type: 'module' })\n\t\tthis.worker.onmessage = (event: MessageEvent<WorkerResponse>) => {\n\t\t\tconst response = event.data\n\t\t\tconst entry = this.pending.get(response.id)\n\t\t\tif (entry) {\n\t\t\t\tthis.pending.delete(response.id)\n\t\t\t\tentry.resolve(response)\n\t\t\t}\n\t\t}\n\t\tthis.worker.onerror = (event) => {\n\t\t\t// Reject all pending requests on worker error\n\t\t\tconst error = new Error(`Worker error: ${event.message}`)\n\t\t\tfor (const [id, entry] of this.pending) {\n\t\t\t\tthis.pending.delete(id)\n\t\t\t\tentry.reject(error)\n\t\t\t}\n\t\t}\n\t}\n\n\tasync send(request: WorkerRequest): Promise<WorkerResponse> {\n\t\tif (this.terminated) {\n\t\t\treturn {\n\t\t\t\tid: request.id,\n\t\t\t\ttype: 'error',\n\t\t\t\tmessage: 'Worker has been terminated',\n\t\t\t\tcode: 'WORKER_TERMINATED',\n\t\t\t}\n\t\t}\n\n\t\tconst id = this.nextId++\n\t\tconst req = { ...request, id }\n\n\t\treturn new Promise<WorkerResponse>((resolve, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tthis.pending.delete(id)\n\t\t\t\treject(new WorkerTimeoutError(req.type, this.timeoutMs))\n\t\t\t}, this.timeoutMs)\n\n\t\t\tthis.pending.set(id, {\n\t\t\t\tresolve: (response) => {\n\t\t\t\t\tclearTimeout(timer)\n\t\t\t\t\tresolve(response)\n\t\t\t\t},\n\t\t\t\treject: (error) => {\n\t\t\t\t\tclearTimeout(timer)\n\t\t\t\t\treject(error)\n\t\t\t\t},\n\t\t\t})\n\n\t\t\tthis.worker.postMessage(req)\n\t\t})\n\t}\n\n\tterminate(): void {\n\t\tif (this.terminated) return\n\t\tthis.terminated = true\n\t\tthis.worker.terminate()\n\t\t// Reject any pending requests\n\t\tfor (const [id, entry] of this.pending) {\n\t\t\tthis.pending.delete(id)\n\t\t\tentry.reject(new Error('Worker terminated'))\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AAkDO,IAAM,QAAN,MAAY;AAAA,EACV,SAAS;AAAA,EACT,UAA6B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtC,MAAM,UAA+B;AACpC,QAAI,CAAC,KAAK,QAAQ;AACjB,WAAK,SAAS;AACd,aAAO,KAAK,cAAc;AAAA,IAC3B;AAEA,WAAO,IAAI,QAAoB,CAAC,YAAY;AAC3C,WAAK,QAAQ,KAAK,MAAM;AACvB,gBAAQ,KAAK,cAAc,CAAC;AAAA,MAC7B,CAAC;AAAA,IACF,CAAC;AAAA,EACF;AAAA,EAEQ,gBAA4B;AACnC,QAAI,WAAW;AACf,WAAO,MAAM;AACZ,UAAI,SAAU;AACd,iBAAW;AACX,YAAM,OAAO,KAAK,QAAQ,MAAM;AAChC,UAAI,MAAM;AACT,aAAK;AAAA,MACN,OAAO;AACN,aAAK,SAAS;AAAA,MACf;AAAA,IACD;AAAA,EACD;AACD;AAQO,IAAM,kBAAN,MAA8C;AAAA,EAC5C;AAAA,EACA,UAAU,oBAAI,IAGpB;AAAA,EACM,SAAS;AAAA,EACT,aAAa;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,YAAY,WAAyB,YAAY,KAAO;AACvD,SAAK,YAAY;AACjB,SAAK,SAAS,IAAI,OAAO,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,SAAK,OAAO,YAAY,CAAC,UAAwC;AAChE,YAAM,WAAW,MAAM;AACvB,YAAM,QAAQ,KAAK,QAAQ,IAAI,SAAS,EAAE;AAC1C,UAAI,OAAO;AACV,aAAK,QAAQ,OAAO,SAAS,EAAE;AAC/B,cAAM,QAAQ,QAAQ;AAAA,MACvB;AAAA,IACD;AACA,SAAK,OAAO,UAAU,CAAC,UAAU;AAEhC,YAAM,QAAQ,IAAI,MAAM,iBAAiB,MAAM,OAAO,EAAE;AACxD,iBAAW,CAAC,IAAI,KAAK,KAAK,KAAK,SAAS;AACvC,aAAK,QAAQ,OAAO,EAAE;AACtB,cAAM,OAAO,KAAK;AAAA,MACnB;AAAA,IACD;AAAA,EACD;AAAA,EAEA,MAAM,KAAK,SAAiD;AAC3D,QAAI,KAAK,YAAY;AACpB,aAAO;AAAA,QACN,IAAI,QAAQ;AAAA,QACZ,MAAM;AAAA,QACN,SAAS;AAAA,QACT,MAAM;AAAA,MACP;AAAA,IACD;AAEA,UAAM,KAAK,KAAK;AAChB,UAAM,MAAM,EAAE,GAAG,SAAS,GAAG;AAE7B,WAAO,IAAI,QAAwB,CAAC,SAAS,WAAW;AACvD,YAAM,QAAQ,WAAW,MAAM;AAC9B,aAAK,QAAQ,OAAO,EAAE;AACtB,eAAO,IAAI,mBAAmB,IAAI,MAAM,KAAK,SAAS,CAAC;AAAA,MACxD,GAAG,KAAK,SAAS;AAEjB,WAAK,QAAQ,IAAI,IAAI;AAAA,QACpB,SAAS,CAAC,aAAa;AACtB,uBAAa,KAAK;AAClB,kBAAQ,QAAQ;AAAA,QACjB;AAAA,QACA,QAAQ,CAAC,UAAU;AAClB,uBAAa,KAAK;AAClB,iBAAO,KAAK;AAAA,QACb;AAAA,MACD,CAAC;AAED,WAAK,OAAO,YAAY,GAAG;AAAA,IAC5B,CAAC;AAAA,EACF;AAAA,EAEA,YAAkB;AACjB,QAAI,KAAK,WAAY;AACrB,SAAK,aAAa;AAClB,SAAK,OAAO,UAAU;AAEtB,eAAW,CAAC,IAAI,KAAK,KAAK,KAAK,SAAS;AACvC,WAAK,QAAQ,OAAO,EAAE;AACtB,YAAM,OAAO,IAAI,MAAM,mBAAmB,CAAC;AAAA,IAC5C;AAAA,EACD;AACD;","names":[]}

package/dist/export-audit-5GV6VRDZ.js

@@ -0,0 +1,15 @@
+import {
+  decodeAuditExport,
+  exportAudit,
+  readAuditExportManifest,
+  verifyAuditExportChecksum
+} from "./chunk-AGN3CIPB.js";
+import "./chunk-MYSJN3DF.js";
+import "./chunk-56LL4XP6.js";
+export {
+  decodeAuditExport,
+  exportAudit,
+  readAuditExportManifest,
+  verifyAuditExportChecksum
+};
+//# sourceMappingURL=export-audit-5GV6VRDZ.js.map

package/dist/export-audit-5GV6VRDZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}