@nicia-ai/typegraph 0.33.0 → 0.35.0

package/dist/{chunk-3642VBVC.cjs → chunk-O7UN7OXA.cjs}

@@ -1,11 +1,12 @@
 'use strict';
 
-var chunkKY5SDVA7_cjs = require('./chunk-KY5SDVA7.cjs');
-var chunk4RBAJVEC_cjs = require('./chunk-4RBAJVEC.cjs');
-var chunkI4W7MKVG_cjs = require('./chunk-I4W7MKVG.cjs');
-var chunkOIE2UPVG_cjs = require('./chunk-OIE2UPVG.cjs');
-var chunkCFNT3ITG_cjs = require('./chunk-CFNT3ITG.cjs');
-var chunkJIEJCTDS_cjs = require('./chunk-JIEJCTDS.cjs');
+var chunkEM3CWPND_cjs = require('./chunk-EM3CWPND.cjs');
+var chunkFN35DLCN_cjs = require('./chunk-FN35DLCN.cjs');
+var chunkCTTSDJLY_cjs = require('./chunk-CTTSDJLY.cjs');
+var chunkD7ZEOS56_cjs = require('./chunk-D7ZEOS56.cjs');
+var chunk4TOD4LBZ_cjs = require('./chunk-4TOD4LBZ.cjs');
+var chunkBLZDPRXT_cjs = require('./chunk-BLZDPRXT.cjs');
+var chunkLGEALRC6_cjs = require('./chunk-LGEALRC6.cjs');
 var drizzleOrm = require('drizzle-orm');
 var sqliteCore = require('drizzle-orm/sqlite-core');
 
@@ -63,6 +64,44 @@ function detectTransactionMode(db, profileHints, isSync) {
   if (isSync) return "sql";
   return "drizzle";
 }
+var MAX_VARIABLE_NUMBER_COMPILE_OPTION = /^MAX_VARIABLE_NUMBER=(\d+)$/;
+var FIRST_MODERN_BIND_LIMIT_MAJOR = 3;
+var FIRST_MODERN_BIND_LIMIT_MINOR = 32;
+function parseCompiledMaxVariableNumber(rows) {
+  for (const row of rows) {
+    if (typeof row !== "object" || row === null) continue;
+    const option = row.compile_options;
+    if (typeof option !== "string") continue;
+    const match = MAX_VARIABLE_NUMBER_COMPILE_OPTION.exec(option);
+    if (match !== null) return Number(match[1]);
+  }
+  return void 0;
+}
+function hasModernBindLimitByVersion(rows) {
+  const first = rows[0];
+  if (typeof first !== "object" || first === null) return false;
+  const version = first.version;
+  if (typeof version !== "string") return false;
+  const [major = 0, minor = 0] = version.split(".").map(Number);
+  if (!Number.isFinite(major) || !Number.isFinite(minor)) return false;
+  return major > FIRST_MODERN_BIND_LIMIT_MAJOR || major === FIRST_MODERN_BIND_LIMIT_MAJOR && minor >= FIRST_MODERN_BIND_LIMIT_MINOR;
+}
+function detectMaxBindParameters(db, sqliteClient) {
+  if (isD1DatabaseBySessionName(db)) return chunk4TOD4LBZ_cjs.D1_MAX_BIND_PARAMETERS;
+  if (sqliteClient === void 0) return chunk4TOD4LBZ_cjs.SQLITE_MAX_BIND_PARAMETERS;
+  try {
+    const compiled = parseCompiledMaxVariableNumber(
+      sqliteClient.prepare("PRAGMA compile_options").all()
+    );
+    if (compiled !== void 0) return compiled;
+    const isModern = hasModernBindLimitByVersion(
+      sqliteClient.prepare("SELECT sqlite_version() AS version").all()
+    );
+    return isModern ? chunk4TOD4LBZ_cjs.MODERN_SQLITE_MAX_BIND_PARAMETERS : chunk4TOD4LBZ_cjs.SQLITE_MAX_BIND_PARAMETERS;
+  } catch {
+    return chunk4TOD4LBZ_cjs.SQLITE_MAX_BIND_PARAMETERS;
+  }
+}
 function resolveSqliteClient(db) {
   const databaseWithClient = db;
   const sqliteClient = databaseWithClient.$client;
@@ -72,7 +111,7 @@ function resolveSqliteClient(db) {
   return sqliteClient;
 }
 function getOrCreatePreparedStatement(cache, sqliteClient, sqlText, cacheMax) {
-  return chunkKY5SDVA7_cjs.getOrCreateLru(
+  return chunkEM3CWPND_cjs.getOrCreateLru(
     cache,
     sqlText,
     cacheMax,
@@ -105,10 +144,11 @@ function createSqliteExecutionAdapter(db, statementCacheMaxOrOptions = {}) {
   const transactionMode = detectTransactionMode(db, profileHints, isSync);
   const profile = {
     isSync,
+    maxBindParameters: detectMaxBindParameters(db, sqliteClient),
     supportsCompiledExecution: sqliteClient !== void 0,
     transactionMode
   };
-  const compile = (query) => chunkKY5SDVA7_cjs.compileQueryWithDialect(db, query, "SQLite");
+  const compile = (query) => chunkEM3CWPND_cjs.compileQueryWithDialect(db, query, "SQLite");
   if (sqliteClient !== void 0) {
     let executeCompiled2 = function(compiledQuery) {
       const preparedStatement = getOrCreatePreparedStatement(
@@ -119,6 +159,19 @@ function createSqliteExecutionAdapter(db, statementCacheMaxOrOptions = {}) {
       );
       const rows = preparedStatement.all(...compiledQuery.params);
       return Promise.resolve(rows);
+    }, executeCompiledRun2 = function(compiledQuery) {
+      const preparedStatement = getOrCreatePreparedStatement(
+        statementCache,
+        client,
+        compiledQuery.sql,
+        statementCacheMax
+      );
+      if (preparedStatement.run === void 0 || preparedStatement.reader === true) {
+        preparedStatement.all(...compiledQuery.params);
+      } else {
+        preparedStatement.run(...compiledQuery.params);
+      }
+      return Promise.resolve();
     };
     const client = sqliteClient;
     const statementCache = /* @__PURE__ */ new Map();
@@ -132,6 +185,7 @@ function createSqliteExecutionAdapter(db, statementCacheMaxOrOptions = {}) {
         return executeCompiled2(compiledQuery);
       },
       executeCompiled: executeCompiled2,
+      executeCompiledRun: executeCompiledRun2,
       prepare(sqlText) {
         return createPreparedStatementExecutor(
           client,
@@ -157,32 +211,58 @@ function createSqliteExecutionAdapter(db, statementCacheMaxOrOptions = {}) {
 // src/backend/drizzle/sqlite.ts
 var NODE_INSERT_PARAM_COUNT = 9;
 var EDGE_INSERT_PARAM_COUNT = 12;
-var SQLITE_NODE_INSERT_BATCH_SIZE = Math.max(
-  1,
-  Math.floor(chunkI4W7MKVG_cjs.SQLITE_MAX_BIND_PARAMETERS / NODE_INSERT_PARAM_COUNT)
-);
-var SQLITE_EDGE_INSERT_BATCH_SIZE = Math.max(
-  1,
-  Math.floor(chunkI4W7MKVG_cjs.SQLITE_MAX_BIND_PARAMETERS / EDGE_INSERT_PARAM_COUNT)
-);
-var SQLITE_GET_NODES_ID_CHUNK_SIZE = Math.max(
-  1,
-  chunkI4W7MKVG_cjs.SQLITE_MAX_BIND_PARAMETERS - 2
-);
-var SQLITE_GET_EDGES_ID_CHUNK_SIZE = Math.max(
-  1,
-  chunkI4W7MKVG_cjs.SQLITE_MAX_BIND_PARAMETERS - 1
-);
+var GET_NODES_FIXED_PARAM_COUNT = 2;
+var GET_EDGES_FIXED_PARAM_COUNT = 1;
 var CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT = 3;
-var SQLITE_CHECK_UNIQUE_BATCH_CHUNK_SIZE = Math.max(
-  1,
-  chunkI4W7MKVG_cjs.SQLITE_MAX_BIND_PARAMETERS - CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT
-);
-var toNodeRow = chunkI4W7MKVG_cjs.createNodeRowMapper(chunkI4W7MKVG_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toEdgeRow = chunkI4W7MKVG_cjs.createEdgeRowMapper(chunkI4W7MKVG_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toUniqueRow = chunkI4W7MKVG_cjs.createUniqueRowMapper(chunkI4W7MKVG_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toSchemaVersionRow = chunkI4W7MKVG_cjs.createSchemaVersionRowMapper(
-  chunkI4W7MKVG_cjs.SQLITE_ROW_MAPPER_CONFIG
+var FULLTEXT_UPSERT_PARAM_COUNT = 6;
+var FULLTEXT_DELETE_FIXED_PARAM_COUNT = 2;
+var UNIQUE_INSERT_PARAM_COUNT = 6;
+var SQLITE_ANALYZE_ROW_LIMIT = 1e3;
+function computeSqliteBatchChunkSizes(maxBindParameters) {
+  return {
+    checkUniqueBatchChunkSize: Math.max(
+      1,
+      maxBindParameters - CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT
+    ),
+    embeddingUpsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / chunkEM3CWPND_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
+    ),
+    fulltextUpsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / FULLTEXT_UPSERT_PARAM_COUNT)
+    ),
+    fulltextDeleteChunkSize: Math.max(
+      1,
+      maxBindParameters - FULLTEXT_DELETE_FIXED_PARAM_COUNT
+    ),
+    edgeInsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / EDGE_INSERT_PARAM_COUNT)
+    ),
+    getEdgesChunkSize: Math.max(
+      1,
+      maxBindParameters - GET_EDGES_FIXED_PARAM_COUNT
+    ),
+    getNodesChunkSize: Math.max(
+      1,
+      maxBindParameters - GET_NODES_FIXED_PARAM_COUNT
+    ),
+    nodeInsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / NODE_INSERT_PARAM_COUNT)
+    ),
+    uniqueInsertBatchSize: Math.max(
+      1,
+      Math.floor(maxBindParameters / UNIQUE_INSERT_PARAM_COUNT)
+    )
+  };
+}
+var toNodeRow = chunkCTTSDJLY_cjs.createNodeRowMapper(chunkCTTSDJLY_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunkCTTSDJLY_cjs.createEdgeRowMapper(chunkCTTSDJLY_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunkCTTSDJLY_cjs.createUniqueRowMapper(chunkCTTSDJLY_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunkCTTSDJLY_cjs.createSchemaVersionRowMapper(
+  chunkCTTSDJLY_cjs.SQLITE_ROW_MAPPER_CONFIG
 );
 var PENDING_FOREVER = new Promise(noop);
 function pendingForever() {
@@ -190,9 +270,30 @@ function pendingForever() {
 }
 function noop() {
 }
+var queueTaskContext;
+async function loadQueueTaskContext() {
+  try {
+    const asyncHooks = await import('async_hooks');
+    queueTaskContext = new asyncHooks.AsyncLocalStorage();
+  } catch {
+  }
+}
+void loadQueueTaskContext();
+function rejectReentrantQueueSubmission() {
+  return Promise.reject(
+    new chunkLGEALRC6_cjs.ConfigurationError(
+      "This operation was awaited from inside a transaction running on the same SQLite backend and would deadlock: the transaction holds the backend's serialized execution slot until it completes, so the operation could never run.",
+      { backend: "sqlite", capability: "concurrentRootAccess" },
+      {
+        suggestion: "Inside a store.transaction callback, use the transaction-scoped context (tx.nodes / tx.edges / tx.backend) instead of the root store or backend, or move the operation outside the transaction."
+      }
+    )
+  );
+}
 function createSerializedExecutionQueue() {
   let tail = Promise.resolve();
   let disposed = false;
+  const taskMarker = {};
   function isDisposed() {
     return disposed;
   }
@@ -201,11 +302,15 @@ function createSerializedExecutionQueue() {
       disposed = true;
     },
     runExclusive(task) {
-      if (isDisposed()) return Promise.reject(new chunkJIEJCTDS_cjs.BackendDisposedError());
+      if (isDisposed()) return Promise.reject(new chunkLGEALRC6_cjs.BackendDisposedError());
+      if (queueTaskContext?.getStore() === taskMarker) {
+        return rejectReentrantQueueSubmission();
+      }
       const runTask = async () => {
         if (isDisposed()) return pendingForever();
         try {
-          return await task();
+          const context = queueTaskContext;
+          return context === void 0 ? await task() : await context.run(taskMarker, () => task());
         } catch (error) {
           if (isDisposed()) return pendingForever();
           throw error;
@@ -225,18 +330,19 @@ function runWithSerializedQueue(queue, task) {
   return queue.runExclusive(task);
 }
 function throwSqliteTransactionsDisabled(message) {
-  throw new chunkJIEJCTDS_cjs.ConfigurationError(message, {
+  throw new chunkLGEALRC6_cjs.ConfigurationError(message, {
     backend: "sqlite",
     capability: "transactions",
     supportsTransactions: false
   });
 }
 function buildSqliteCapabilities(options) {
-  const base = options.transactionMode === "none" ? { ...chunkI4W7MKVG_cjs.SQLITE_CAPABILITIES, transactions: false } : chunkI4W7MKVG_cjs.SQLITE_CAPABILITIES;
+  const base = options.transactionMode === "none" ? { ...chunk4TOD4LBZ_cjs.SQLITE_CAPABILITIES, transactions: false } : chunk4TOD4LBZ_cjs.SQLITE_CAPABILITIES;
   return {
     ...base,
-    fulltext: chunkCFNT3ITG_cjs.buildFulltextCapabilities(options.fulltextStrategy),
-    ...options.vectorStrategy === void 0 ? {} : { vector: chunkCFNT3ITG_cjs.buildVectorCapabilities(options.vectorStrategy) }
+    maxBindParameters: options.maxBindParameters,
+    fulltext: chunkD7ZEOS56_cjs.buildFulltextCapabilities(options.fulltextStrategy),
+    ...options.vectorStrategy === void 0 ? {} : { vector: chunkD7ZEOS56_cjs.buildVectorCapabilities(options.vectorStrategy) }
   };
 }
 function createSqliteOperationBackend(options) {
@@ -251,36 +357,46 @@ function createSqliteOperationBackend(options) {
     vectorStrategy,
     vectorSlotLatch
   } = options;
+  const compiledExecute = executionAdapter.executeCompiled;
+  const compiledRun = executionAdapter.executeCompiledRun;
   function execGet(query) {
     return runWithSerializedQueue(serializedQueue, async () => {
-      const rows = await db.all(query);
+      if (compiledExecute === void 0) {
+        const rows2 = await db.all(query);
+        return rows2[0];
+      }
+      const rows = await compiledExecute(executionAdapter.compile(query));
       return rows[0];
     });
   }
   function execAll(query) {
     return runWithSerializedQueue(serializedQueue, async () => {
-      return await db.all(query);
+      if (compiledExecute === void 0) {
+        return await db.all(query);
+      }
+      return [...await compiledExecute(executionAdapter.compile(query))];
     });
   }
   function execRun(query) {
     return runWithSerializedQueue(serializedQueue, async () => {
-      await db.run(query);
+      if (compiledRun === void 0) {
+        await db.run(query);
+        return;
+      }
+      await compiledRun(executionAdapter.compile(query));
     });
   }
-  const commonBackend = chunkKY5SDVA7_cjs.createCommonOperationBackend({
-    batchConfig: {
-      checkUniqueBatchChunkSize: SQLITE_CHECK_UNIQUE_BATCH_CHUNK_SIZE,
-      edgeInsertBatchSize: SQLITE_EDGE_INSERT_BATCH_SIZE,
-      getEdgesChunkSize: SQLITE_GET_EDGES_ID_CHUNK_SIZE,
-      getNodesChunkSize: SQLITE_GET_NODES_ID_CHUNK_SIZE,
-      nodeInsertBatchSize: SQLITE_NODE_INSERT_BATCH_SIZE
-    },
+  const batchConfig = computeSqliteBatchChunkSizes(
+    capabilities.maxBindParameters ?? chunk4TOD4LBZ_cjs.SQLITE_MAX_BIND_PARAMETERS
+  );
+  const commonBackend = chunkEM3CWPND_cjs.createCommonOperationBackend({
+    batchConfig,
     execution: {
       execAll,
       execGet,
       execRun
     },
-    nowIso: chunkI4W7MKVG_cjs.nowIso,
+    nowIso: chunkCTTSDJLY_cjs.nowIso,
     operationStrategy,
     rowMappers: {
       toEdgeRow,
@@ -306,19 +422,61 @@ function createSqliteOperationBackend(options) {
   }
   const vectorEmbeddingMethods = vectorStrategy === void 0 ? {} : {
     async upsertEmbedding(params) {
-      const slot = chunkKY5SDVA7_cjs.vectorSlotFromParams(params);
+      const slot = chunkEM3CWPND_cjs.vectorSlotFromParams(params);
       await ensureVectorSlotStorage(slot);
-      const statements = vectorStrategy.buildUpsert(slot, params, chunkI4W7MKVG_cjs.nowIso());
+      const statements = vectorStrategy.buildUpsert(slot, params, chunkCTTSDJLY_cjs.nowIso());
       try {
         for (const statement of statements) {
           await execRun(statement);
         }
       } catch (error) {
-        throw chunkKY5SDVA7_cjs.mapVectorWriteError(error, params);
+        throw chunkEM3CWPND_cjs.mapVectorWriteError(error, params);
+      }
+    },
+    async upsertEmbeddingBatch(params) {
+      if (params.rows.length === 0) return;
+      const slot = chunkEM3CWPND_cjs.vectorSlotFromParams(params);
+      await ensureVectorSlotStorage(slot);
+      const rowsById = new Map(
+        params.rows.map((row) => [row.nodeId, row])
+      );
+      const rows = [...rowsById.values()];
+      const timestamp = chunkCTTSDJLY_cjs.nowIso();
+      try {
+        for (const chunk2 of chunk4TOD4LBZ_cjs.chunk(
+          rows,
+          batchConfig.embeddingUpsertBatchSize
+        )) {
+          const statements = vectorStrategy.buildUpsertBatch === void 0 ? chunk2.flatMap(
+            (row) => vectorStrategy.buildUpsert(
+              slot,
+              {
+                graphId: params.graphId,
+                nodeKind: params.nodeKind,
+                nodeId: row.nodeId,
+                fieldPath: params.fieldPath,
+                embedding: row.embedding,
+                dimensions: params.dimensions,
+                metric: params.metric,
+                indexType: params.indexType
+              },
+              timestamp
+            )
+          ) : vectorStrategy.buildUpsertBatch(
+            slot,
+            { ...params, rows: chunk2 },
+            timestamp
+          );
+          for (const statement of statements) {
+            await execRun(statement);
+          }
+        }
+      } catch (error) {
+        throw chunkEM3CWPND_cjs.mapVectorWriteError(error, params);
       }
     },
     async deleteEmbedding(params) {
-      const slot = chunkKY5SDVA7_cjs.vectorSlotFromParams(params);
+      const slot = chunkEM3CWPND_cjs.vectorSlotFromParams(params);
       await ensureVectorSlotStorage(slot);
       const statements = vectorStrategy.buildDelete(slot, params);
       for (const statement of statements) {
@@ -326,21 +484,80 @@ function createSqliteOperationBackend(options) {
       }
     },
     async vectorSearch(params) {
-      chunkCFNT3ITG_cjs.assertVectorSearchLimit(params.limit);
-      const slot = chunkKY5SDVA7_cjs.vectorSlotFromParams(params);
+      chunkD7ZEOS56_cjs.assertVectorSearchLimit(params.limit);
+      const slot = chunkEM3CWPND_cjs.vectorSlotFromParams(params);
       await ensureVectorSlotStorage(slot);
-      const query = vectorStrategy.buildSearch(slot, params);
+      const query = vectorStrategy.buildSearch(
+        slot,
+        params,
+        // Store-compiled candidates (predicates + subclass + currency)
+        // take precedence; the live-node default covers direct backend use.
+        params.candidates ?? operationStrategy.buildLiveNodeIds(
+          params.graphId,
+          params.nodeKind
+        )
+      );
       let rows;
       try {
         rows = await execAll(query);
       } catch (error) {
-        throw chunkKY5SDVA7_cjs.mapVectorWriteError(error, params);
+        throw chunkEM3CWPND_cjs.mapVectorWriteError(error, params);
       }
       return rows.map((row) => ({
         nodeId: row.node_id,
         score: row.score
       }));
-    }
+    },
+    // Single-statement hybrid needs ROW_NUMBER(); a capability profile
+    // that disables window functions keeps the store's multi-statement
+    // fallback by simply not exposing the member.
+    ...capabilities.windowFunctions ? {
+      async hybridSearch(params) {
+        chunkD7ZEOS56_cjs.assertVectorSearchLimit(params.limit);
+        chunkD7ZEOS56_cjs.assertVectorSearchLimit(params.vector.k);
+        const slot = chunkEM3CWPND_cjs.vectorSlotFromParams({
+          graphId: params.graphId,
+          nodeKind: params.nodeKind,
+          fieldPath: params.vector.fieldPath,
+          dimensions: params.vector.dimensions,
+          metric: params.vector.metric,
+          indexType: params.vector.indexType
+        });
+        await ensureVectorSlotStorage(slot);
+        const candidates = params.candidates ?? operationStrategy.buildLiveNodeIds(
+          params.graphId,
+          params.nodeKind
+        );
+        const vectorParams = {
+          graphId: params.graphId,
+          nodeKind: params.nodeKind,
+          fieldPath: params.vector.fieldPath,
+          queryEmbedding: params.vector.queryEmbedding,
+          metric: params.vector.metric,
+          dimensions: params.vector.dimensions,
+          indexType: params.vector.indexType,
+          limit: params.vector.k,
+          ...params.vector.minScore === void 0 ? {} : { minScore: params.vector.minScore }
+        };
+        const vectorSql = vectorStrategy.buildSearch(
+          slot,
+          vectorParams,
+          chunkEM3CWPND_cjs.hybridCandidatesRef()
+        );
+        const statement = operationStrategy.buildHybridSearch(
+          { ...params, candidates },
+          vectorSql,
+          params.vector.metric === "cosine"
+        );
+        let raw;
+        try {
+          raw = await execAll(statement);
+        } catch (error) {
+          throw chunkEM3CWPND_cjs.mapVectorWriteError(error, vectorParams);
+        }
+        return raw.map((row) => chunkEM3CWPND_cjs.mapHybridSearchRow(row, toNodeRow));
+      }
+    } : {}
   };
   const operationBackend = {
     ...commonBackend,
@@ -353,7 +570,7 @@ function createSqliteOperationBackend(options) {
     ...vectorStrategy === void 0 ? {} : { vectorStrategy },
     async createVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkKY5SDVA7_cjs.vectorSlotFromCreateIndexParams(params);
+      const slot = chunkEM3CWPND_cjs.vectorSlotFromCreateIndexParams(params);
       await ensureVectorSlotStorage(slot);
       const indexStatement = vectorStrategy.buildCreateIndex?.(slot);
       if (indexStatement !== void 0) {
@@ -362,18 +579,18 @@ function createSqliteOperationBackend(options) {
     },
     async dropVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkKY5SDVA7_cjs.vectorSlotFromDropIndexParams(params);
+      const slot = chunkEM3CWPND_cjs.vectorSlotFromDropIndexParams(params);
       const dropStatement = vectorStrategy.buildDropIndex?.(slot);
       if (dropStatement === void 0) return;
       try {
         await execRun(dropStatement);
       } catch (error) {
-        if (!chunkOIE2UPVG_cjs.isMissingTableError(error)) throw error;
+        if (!chunkBLZDPRXT_cjs.isMissingTableError(error)) throw error;
       }
     },
     // === Fulltext Operations ===
     async upsertFulltext(params) {
-      const timestamp = chunkI4W7MKVG_cjs.nowIso();
+      const timestamp = chunkCTTSDJLY_cjs.nowIso();
       const statements = operationStrategy.buildUpsertFulltext(
         params,
         timestamp
@@ -390,20 +607,33 @@ function createSqliteOperationBackend(options) {
     },
     async upsertFulltextBatch(params) {
       if (params.rows.length === 0) return;
-      const timestamp = chunkI4W7MKVG_cjs.nowIso();
-      const statements = operationStrategy.buildUpsertFulltextBatch(
-        params,
-        timestamp
-      );
-      for (const stmt of statements) {
-        await execRun(stmt);
+      const timestamp = chunkCTTSDJLY_cjs.nowIso();
+      for (const rows of chunk4TOD4LBZ_cjs.chunk(
+        params.rows,
+        batchConfig.fulltextUpsertBatchSize
+      )) {
+        const statements = operationStrategy.buildUpsertFulltextBatch(
+          { ...params, rows },
+          timestamp
+        );
+        for (const stmt of statements) {
+          await execRun(stmt);
+        }
       }
     },
     async deleteFulltextBatch(params) {
       if (params.nodeIds.length === 0) return;
-      const statements = operationStrategy.buildDeleteFulltextBatch(params);
-      for (const stmt of statements) {
-        await execRun(stmt);
+      for (const nodeIds of chunk4TOD4LBZ_cjs.chunk(
+        params.nodeIds,
+        batchConfig.fulltextDeleteChunkSize
+      )) {
+        const statements = operationStrategy.buildDeleteFulltextBatch({
+          ...params,
+          nodeIds
+        });
+        for (const stmt of statements) {
+          await execRun(stmt);
+        }
       }
     },
     async fulltextSearch(params) {
@@ -411,7 +641,7 @@ function createSqliteOperationBackend(options) {
       const rows = await execAll(query);
       return rows.map((row, index) => ({
         nodeId: row.node_id,
-        score: chunkI4W7MKVG_cjs.coerceNumericScore(row.score),
+        score: chunkCTTSDJLY_cjs.coerceNumericScore(row.score),
         rank: index + 1,
         ...row.snippet === null ? {} : { snippet: row.snippet }
       }));
@@ -430,18 +660,19 @@ function createSqliteOperationBackend(options) {
   return operationBackend;
 }
 function createSqliteBackend(db, options = {}) {
-  const tables2 = options.tables ?? chunk4RBAJVEC_cjs.tables;
-  const fulltextStrategy = options.fulltext ?? chunkCFNT3ITG_cjs.fts5Strategy;
+  const tables2 = options.tables ?? chunkFN35DLCN_cjs.tables;
+  const fulltextStrategy = options.fulltext ?? chunkD7ZEOS56_cjs.fts5Strategy;
   const profileHints = options.executionProfile ?? {};
   const executionAdapter = createSqliteExecutionAdapter(db, { profileHints });
   const { isSync, transactionMode } = executionAdapter.profile;
   const vectorStrategy = options.vector;
-  const vectorSlotLatch = vectorStrategy === void 0 ? void 0 : chunkKY5SDVA7_cjs.createVectorSlotLatch();
+  const vectorSlotLatch = vectorStrategy === void 0 ? void 0 : chunkEM3CWPND_cjs.createVectorSlotLatch();
   const capabilities = {
     ...buildSqliteCapabilities({
       fulltextStrategy,
       vectorStrategy,
-      transactionMode
+      transactionMode,
+      maxBindParameters: executionAdapter.profile.maxBindParameters
     }),
     ...options.capabilities
   };
@@ -451,14 +682,26 @@ function createSqliteBackend(db, options = {}) {
     recordedNodes: drizzleOrm.getTableName(tables2.recordedNodes),
     recordedEdges: drizzleOrm.getTableName(tables2.recordedEdges),
     recordedClock: drizzleOrm.getTableName(tables2.recordedClock),
+    revisionOrigins: drizzleOrm.getTableName(tables2.revisionOrigins),
     fulltext: tables2.fulltextTableName,
     uniques: drizzleOrm.getTableName(tables2.uniques)
   };
-  const operationStrategy = chunkKY5SDVA7_cjs.createSqliteOperationStrategy(
+  const coreAnalyzeTables = [
+    tableNames.nodes,
+    tableNames.edges,
+    tableNames.uniques,
+    tableNames.fulltext
+  ];
+  const recordedAnalyzeTables = [
+    tableNames.recordedNodes,
+    tableNames.recordedEdges,
+    tableNames.recordedClock
+  ];
+  const operationStrategy = chunkEM3CWPND_cjs.createSqliteOperationStrategy(
     tables2,
     fulltextStrategy
   );
-  const serializedQueue = isSync ? createSerializedExecutionQueue() : void 0;
+  const serializedQueue = transactionMode === "none" ? void 0 : createSerializedExecutionQueue();
   const operations = createSqliteOperationBackend({
     capabilities,
     db,
@@ -483,6 +726,14 @@ function createSqliteBackend(db, options = {}) {
       async () => storageTransaction.call(storage, run)
     );
   }
+  async function runFrameStatement(query) {
+    const compiledRun = executionAdapter.executeCompiledRun;
+    if (compiledRun === void 0) {
+      await db.run(query);
+      return;
+    }
+    await compiledRun(executionAdapter.compile(query));
+  }
   function runSchemaWriteTransaction(fn) {
     if (transactionMode === "none") {
       throwSqliteTransactionsDisabled(
@@ -496,17 +747,17 @@ function createSqliteBackend(db, options = {}) {
           db,
           executionAdapter,
           operationStrategy,
-          profileHints: { isSync: true },
+          profileHints: { isSync },
           tableNames,
           fulltextStrategy,
           vectorStrategy});
-        db.run(drizzleOrm.sql`BEGIN IMMEDIATE`);
+        await runFrameStatement(drizzleOrm.sql`BEGIN IMMEDIATE`);
         try {
           const result = await fn(txBackend);
-          db.run(drizzleOrm.sql`COMMIT`);
+          await runFrameStatement(drizzleOrm.sql`COMMIT`);
           return result;
         } catch (error) {
-          db.run(drizzleOrm.sql`ROLLBACK`);
+          await runFrameStatement(drizzleOrm.sql`ROLLBACK`);
           throw error;
         }
       });
@@ -544,7 +795,7 @@ function createSqliteBackend(db, options = {}) {
   }
   const matTable = tables2.contributionMaterializations;
   async function ensureContributionMaterializationsTableImpl() {
-    await db.run(drizzleOrm.sql.raw(chunkKY5SDVA7_cjs.generateSqliteCreateTableSQL(matTable)));
+    await db.run(drizzleOrm.sql.raw(chunkEM3CWPND_cjs.generateSqliteCreateTableSQL(matTable)));
   }
   async function getContributionMaterializationRow(identity) {
     const rows = await db.select().from(matTable).where(
@@ -557,16 +808,16 @@ function createSqliteBackend(db, options = {}) {
     );
     const row = rows[0];
     if (row === void 0) return void 0;
-    return chunkKY5SDVA7_cjs.mapContributionMaterializationRow(
+    return chunkEM3CWPND_cjs.mapContributionMaterializationRow(
       row,
-      chunkKY5SDVA7_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.decode
+      chunkEM3CWPND_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.decode
     );
   }
   async function recordContributionMaterializationRow(params) {
     await db.insert(matTable).values(
-      chunkKY5SDVA7_cjs.buildContributionInsertValues(
+      chunkEM3CWPND_cjs.buildContributionInsertValues(
         params,
-        chunkKY5SDVA7_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.encode
+        chunkEM3CWPND_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.encode
       )
     ).onConflictDoUpdate({
       target: [
@@ -575,13 +826,13 @@ function createSqliteBackend(db, options = {}) {
         matTable.owner,
         matTable.tableName
       ],
-      set: chunkKY5SDVA7_cjs.buildContributionOnConflictSet(
+      set: chunkEM3CWPND_cjs.buildContributionOnConflictSet(
         matTable.materializedAt,
         params.materializedAt
       )
     });
   }
-  const contributionMaterializer = chunkKY5SDVA7_cjs.createContributionMaterializer({
+  const contributionMaterializer = chunkEM3CWPND_cjs.createContributionMaterializer({
     dialect: "sqlite",
     fulltextStrategy,
     fulltextTableName: tables2.fulltextTableName,
@@ -601,22 +852,27 @@ function createSqliteBackend(db, options = {}) {
       tableNames,
       fulltextStrategy,
       vectorStrategy});
-    return chunkKY5SDVA7_cjs.gateFulltext(txBackend, contributionMaterializer.assertInitialized);
+    return chunkEM3CWPND_cjs.gateFulltext(txBackend, contributionMaterializer.assertInitialized);
   }
   const backend = {
     ...operations,
     async bootstrapTables() {
-      const statements = chunkKY5SDVA7_cjs.generateSqliteDDL(tables2, fulltextStrategy);
+      const statements = chunkEM3CWPND_cjs.generateSqliteDDL(tables2, fulltextStrategy);
       for (const statement of statements) {
         await db.run(drizzleOrm.sql.raw(statement));
       }
     },
+    async ensureRevisionOriginsTable() {
+      await db.run(
+        drizzleOrm.sql.raw(chunkEM3CWPND_cjs.generateSqliteCreateTableSQL(tables2.revisionOrigins))
+      );
+    },
     // Every fulltext-touching method asserts the durable marker instead
     // of lazily emitting DDL. Steady state performs zero ensure; an
     // uninitialized database throws `StoreNotInitializedError` rather
     // than self-healing (#135). Shared verbatim with the tx-scoped gate
     // via `gateFulltextMethods`.
-    ...chunkKY5SDVA7_cjs.gateFulltextMethods(
+    ...chunkEM3CWPND_cjs.gateFulltextMethods(
       operations,
       contributionMaterializer.assertInitialized
     ),
@@ -625,7 +881,7 @@ function createSqliteBackend(db, options = {}) {
     },
     async ensureIndexMaterializationsTable() {
       await db.run(
-        drizzleOrm.sql.raw(chunkKY5SDVA7_cjs.generateSqliteCreateTableSQL(tables2.indexMaterializations))
+        drizzleOrm.sql.raw(chunkEM3CWPND_cjs.generateSqliteCreateTableSQL(tables2.indexMaterializations))
       );
     },
     async getIndexMaterialization(indexName) {
@@ -633,26 +889,26 @@ function createSqliteBackend(db, options = {}) {
       const rows = await db.select().from(t).where(drizzleOrm.eq(t.indexName, indexName));
       const row = rows[0];
       if (row === void 0) return void 0;
-      return chunkKY5SDVA7_cjs.mapMaterializationRow(row, chunkKY5SDVA7_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode);
+      return chunkEM3CWPND_cjs.mapMaterializationRow(row, chunkEM3CWPND_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode);
     },
     async getIndexMaterializations(statusKeys) {
       if (statusKeys.length === 0) return [];
       const t = tables2.indexMaterializations;
       const rows = await db.select().from(t).where(drizzleOrm.inArray(t.indexName, [...statusKeys]));
       return rows.map(
-        (row) => chunkKY5SDVA7_cjs.mapMaterializationRow(row, chunkKY5SDVA7_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode)
+        (row) => chunkEM3CWPND_cjs.mapMaterializationRow(row, chunkEM3CWPND_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode)
       );
     },
     async recordIndexMaterialization(params) {
       const t = tables2.indexMaterializations;
       await db.insert(t).values(
-        chunkKY5SDVA7_cjs.buildMaterializationInsertValues(
+        chunkEM3CWPND_cjs.buildMaterializationInsertValues(
           params,
-          chunkKY5SDVA7_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.encode
+          chunkEM3CWPND_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: t.indexName,
-        set: chunkKY5SDVA7_cjs.buildMaterializationOnConflictSet(
+        set: chunkEM3CWPND_cjs.buildMaterializationOnConflictSet(
           t.materializedAt,
           params.materializedAt
         )
@@ -671,37 +927,37 @@ function createSqliteBackend(db, options = {}) {
       await contributionMaterializer.assertInitialized(graphId);
     },
     async ensureKindRemovalsTable() {
-      await db.run(drizzleOrm.sql.raw(chunkKY5SDVA7_cjs.generateSqliteCreateTableSQL(tables2.kindRemovals)));
+      await db.run(drizzleOrm.sql.raw(chunkEM3CWPND_cjs.generateSqliteCreateTableSQL(tables2.kindRemovals)));
     },
     async getPendingKindRemovals(graphId) {
       const t = tables2.kindRemovals;
       const rows = await db.select().from(t).where(drizzleOrm.and(drizzleOrm.eq(t.graphId, graphId), drizzleOrm.isNull(t.removedAt)));
       return rows.map(
-        (row) => chunkKY5SDVA7_cjs.mapKindRemovalRow(row, chunkKY5SDVA7_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkEM3CWPND_cjs.mapKindRemovalRow(row, chunkEM3CWPND_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
       );
     },
     async getAllKindRemovals(graphId) {
       const t = tables2.kindRemovals;
       const rows = await db.select().from(t).where(drizzleOrm.eq(t.graphId, graphId));
       return rows.map(
-        (row) => chunkKY5SDVA7_cjs.mapKindRemovalRow(row, chunkKY5SDVA7_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkEM3CWPND_cjs.mapKindRemovalRow(row, chunkEM3CWPND_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
       );
     },
     async recordKindRemoval(params) {
       const t = tables2.kindRemovals;
       await db.insert(t).values(
-        chunkKY5SDVA7_cjs.buildKindRemovalInsertValues(
+        chunkEM3CWPND_cjs.buildKindRemovalInsertValues(
           params,
-          chunkKY5SDVA7_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.encode
+          chunkEM3CWPND_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: [t.graphId, t.kindName, t.entity, t.schemaVersion],
-        set: chunkKY5SDVA7_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
+        set: chunkEM3CWPND_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
       });
     },
     async ensureReconciliationMarkersTable() {
       await db.run(
-        drizzleOrm.sql.raw(chunkKY5SDVA7_cjs.generateSqliteCreateTableSQL(tables2.reconciliationMarkers))
+        drizzleOrm.sql.raw(chunkEM3CWPND_cjs.generateSqliteCreateTableSQL(tables2.reconciliationMarkers))
       );
     },
     async ensureRuntimeContributions(graphId) {
@@ -728,7 +984,19 @@ function createSqliteBackend(db, options = {}) {
       });
     },
     async refreshStatistics() {
-      await db.run(drizzleOrm.sql`ANALYZE`);
+      await db.run(
+        drizzleOrm.sql`PRAGMA analysis_limit = ${drizzleOrm.sql.raw(String(SQLITE_ANALYZE_ROW_LIMIT))}`
+      );
+      for (const tableName of coreAnalyzeTables) {
+        await db.run(drizzleOrm.sql`ANALYZE ${chunkCTTSDJLY_cjs.quoteIdentifier(tableName)}`);
+      }
+      for (const tableName of recordedAnalyzeTables) {
+        try {
+          await db.run(drizzleOrm.sql`ANALYZE ${chunkCTTSDJLY_cjs.quoteIdentifier(tableName)}`);
+        } catch (error) {
+          if (!chunkBLZDPRXT_cjs.isMissingTableError(error)) throw error;
+        }
+      }
     },
     async commitSchemaVersion(params) {
       return runSchemaWriteTransaction(
@@ -753,23 +1021,23 @@ function createSqliteBackend(db, options = {}) {
             db,
             executionAdapter,
             operationStrategy,
-            profileHints: { isSync: true },
+            profileHints: { isSync },
             tableNames,
             fulltextStrategy,
             vectorStrategy});
-          db.run(drizzleOrm.sql`BEGIN`);
+          await runFrameStatement(drizzleOrm.sql`BEGIN IMMEDIATE`);
           try {
             const result = await fn(
-              chunkKY5SDVA7_cjs.gateFulltext(
+              chunkEM3CWPND_cjs.gateFulltext(
                 txBackend,
                 contributionMaterializer.assertInitialized
               ),
               db
             );
-            db.run(drizzleOrm.sql`COMMIT`);
+            await runFrameStatement(drizzleOrm.sql`COMMIT`);
             return result;
           } catch (error) {
-            db.run(drizzleOrm.sql`ROLLBACK`);
+            await runFrameStatement(drizzleOrm.sql`ROLLBACK`);
             throw error;
           }
         });
@@ -781,9 +1049,9 @@ function createSqliteBackend(db, options = {}) {
       }
       return runWithSerializedQueue(
         serializedQueue,
-        async () => db.transaction(
-          async (tx) => fn(bindTransactionBackend(tx), tx)
-        )
+        async () => db.transaction(async (tx) => fn(bindTransactionBackend(tx), tx), {
+          behavior: "immediate"
+        })
       );
     },
     adoptTransaction(externalTx) {
@@ -792,7 +1060,7 @@ function createSqliteBackend(db, options = {}) {
           "Cross-store atomicity is unavailable on this SQLite backend: transactions are disabled (transactionMode: 'none'). Adopting an external transaction here would let the caller's relational write commit with no way to roll back the graph write. Configure a driver that supports transactions (better-sqlite3, libsql, bun:sqlite)."
         );
       }
-      chunkKY5SDVA7_cjs.assertAdoptedDialect(
+      chunkEM3CWPND_cjs.assertAdoptedDialect(
         externalTx,
         sqliteCore.BaseSQLiteDatabase,
         "sqlite"
@@ -818,10 +1086,10 @@ function createTransactionBackend(options) {
     tableNames: options.tableNames,
     fulltextStrategy: options.fulltextStrategy,
     vectorStrategy: options.vectorStrategy,
-    ...options.vectorStrategy === void 0 ? {} : { vectorSlotLatch: chunkKY5SDVA7_cjs.createVectorSlotLatch() }
+    ...options.vectorStrategy === void 0 ? {} : { vectorSlotLatch: chunkEM3CWPND_cjs.createVectorSlotLatch() }
   });
 }
 
 exports.createSqliteBackend = createSqliteBackend;
-//# sourceMappingURL=chunk-3642VBVC.cjs.map
-//# sourceMappingURL=chunk-3642VBVC.cjs.map
+//# sourceMappingURL=chunk-O7UN7OXA.cjs.map
+//# sourceMappingURL=chunk-O7UN7OXA.cjs.map