@nicia-ai/typegraph 0.43.0 → 0.45.0

package/dist/{chunk-F2KVJ6FF.cjs → chunk-P7GTYOLB.cjs}

@@ -1,15 +1,16 @@
 'use strict';
 
-var chunkO7XVCLXW_cjs = require('./chunk-O7XVCLXW.cjs');
-var chunkAQR6BHB3_cjs = require('./chunk-AQR6BHB3.cjs');
-var chunkOMQ2NBOR_cjs = require('./chunk-OMQ2NBOR.cjs');
-var chunk6TJ6PKPS_cjs = require('./chunk-6TJ6PKPS.cjs');
+var chunkH7VE3FL4_cjs = require('./chunk-H7VE3FL4.cjs');
+var chunkF4NHQHEZ_cjs = require('./chunk-F4NHQHEZ.cjs');
+var chunkZ3WO6MND_cjs = require('./chunk-Z3WO6MND.cjs');
+var chunkOOA273IJ_cjs = require('./chunk-OOA273IJ.cjs');
 var chunkZDH3DX3C_cjs = require('./chunk-ZDH3DX3C.cjs');
-var chunkECU53PMN_cjs = require('./chunk-ECU53PMN.cjs');
-var chunkAO2WPYFZ_cjs = require('./chunk-AO2WPYFZ.cjs');
-var chunkUTTW2Q3M_cjs = require('./chunk-UTTW2Q3M.cjs');
-var chunkX2XOQZT3_cjs = require('./chunk-X2XOQZT3.cjs');
-var chunkKTBTSHU6_cjs = require('./chunk-KTBTSHU6.cjs');
+var chunkEKFUG4G7_cjs = require('./chunk-EKFUG4G7.cjs');
+var chunkJQXSZHF2_cjs = require('./chunk-JQXSZHF2.cjs');
+var chunkJXUTCSXX_cjs = require('./chunk-JXUTCSXX.cjs');
+var chunkU5W4LKZV_cjs = require('./chunk-U5W4LKZV.cjs');
+var chunk764JHTLT_cjs = require('./chunk-764JHTLT.cjs');
+var chunkC4F7VJ5D_cjs = require('./chunk-C4F7VJ5D.cjs');
 var drizzleOrm = require('drizzle-orm');
 var sqliteCore = require('drizzle-orm/sqlite-core');
 
@@ -100,14 +101,14 @@ function hasModernBindLimitByVersion(rows) {
 }
 function detectHardMaxBindParameters(transactionMode, hostedPlatform) {
   if (hostedPlatform === "durable-object" || transactionMode === "do-sqlite") {
-    return chunkECU53PMN_cjs.DURABLE_OBJECT_MAX_BIND_PARAMETERS;
+    return chunkEKFUG4G7_cjs.DURABLE_OBJECT_MAX_BIND_PARAMETERS;
   }
-  if (hostedPlatform === "d1") return chunkECU53PMN_cjs.D1_MAX_BIND_PARAMETERS;
+  if (hostedPlatform === "d1") return chunkEKFUG4G7_cjs.D1_MAX_BIND_PARAMETERS;
   return void 0;
 }
 function detectMaxBindParameters(sqliteClient, hardMaxBindParameters) {
   if (hardMaxBindParameters !== void 0) return hardMaxBindParameters;
-  if (sqliteClient === void 0) return chunkECU53PMN_cjs.SQLITE_MAX_BIND_PARAMETERS;
+  if (sqliteClient === void 0) return chunkEKFUG4G7_cjs.SQLITE_MAX_BIND_PARAMETERS;
   try {
     const compiled = parseCompiledMaxVariableNumber(
       sqliteClient.prepare("PRAGMA compile_options").all()
@@ -116,9 +117,9 @@ function detectMaxBindParameters(sqliteClient, hardMaxBindParameters) {
     const isModern = hasModernBindLimitByVersion(
       sqliteClient.prepare("SELECT sqlite_version() AS version").all()
     );
-    return isModern ? chunkECU53PMN_cjs.MODERN_SQLITE_MAX_BIND_PARAMETERS : chunkECU53PMN_cjs.SQLITE_MAX_BIND_PARAMETERS;
+    return isModern ? chunkEKFUG4G7_cjs.MODERN_SQLITE_MAX_BIND_PARAMETERS : chunkEKFUG4G7_cjs.SQLITE_MAX_BIND_PARAMETERS;
   } catch {
-    return chunkECU53PMN_cjs.SQLITE_MAX_BIND_PARAMETERS;
+    return chunkEKFUG4G7_cjs.SQLITE_MAX_BIND_PARAMETERS;
   }
 }
 function resolveSqliteClient(db) {
@@ -129,7 +130,7 @@ function resolveSqliteClient(db) {
   return sqliteClient;
 }
 function getOrCreatePreparedStatement(cache, sqliteClient, sqlText, cacheMax) {
-  return chunkO7XVCLXW_cjs.getOrCreateLru(
+  return chunkH7VE3FL4_cjs.getOrCreateLru(
     cache,
     sqlText,
     cacheMax,
@@ -181,7 +182,7 @@ function createSqliteExecutionAdapter(db, statementCacheMaxOrOptions = {}) {
     supportsCompiledExecution: sqliteClient !== void 0,
     transactionMode
   };
-  const compile = (query) => chunk6TJ6PKPS_cjs.compileQueryWithDialect(db, query, "SQLite");
+  const compile = (query) => chunkOOA273IJ_cjs.compileQueryWithDialect(db, query, "SQLite");
   if (sqliteClient !== void 0) {
     let executeCompiled2 = function(compiledQuery) {
       const preparedStatement = getOrCreatePreparedStatement(
@@ -254,7 +255,7 @@ function createSqliteExecutionAdapter(db, statementCacheMaxOrOptions = {}) {
     execute(query) {
       return executeDrizzleQuery(
         db,
-        chunkX2XOQZT3_cjs.isSqlFragment(query) ? chunk6TJ6PKPS_cjs.toDrizzleSql(query, "sqlite") : query
+        chunkU5W4LKZV_cjs.isSqlFragment(query) ? chunkOOA273IJ_cjs.toDrizzleSql(query, "sqlite") : query
       );
     },
     profile
@@ -269,6 +270,7 @@ var GET_EDGES_FIXED_PARAM_COUNT = 1;
 var CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT = 3;
 var FULLTEXT_UPSERT_PARAM_COUNT = 6;
 var FULLTEXT_DELETE_FIXED_PARAM_COUNT = 2;
+var UNIQUE_DELETE_FIXED_PARAM_COUNT = 2;
 var UNIQUE_INSERT_PARAM_COUNT = 6;
 var SQLITE_ANALYZE_ROW_LIMIT = 1e3;
 function computeSqliteBatchChunkSizes(maxBindParameters) {
@@ -279,7 +281,7 @@ function computeSqliteBatchChunkSizes(maxBindParameters) {
     ),
     embeddingUpsertBatchSize: Math.max(
       1,
-      Math.floor(maxBindParameters / chunkO7XVCLXW_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
+      Math.floor(maxBindParameters / chunkH7VE3FL4_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
     ),
     fulltextUpsertBatchSize: Math.max(
       1,
@@ -293,6 +295,10 @@ function computeSqliteBatchChunkSizes(maxBindParameters) {
       1,
       Math.floor(maxBindParameters / EDGE_INSERT_PARAM_COUNT)
     ),
+    findEdgesEndpointChunkSize: Math.max(
+      1,
+      maxBindParameters - chunkH7VE3FL4_cjs.FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT
+    ),
     getEdgesChunkSize: Math.max(
       1,
       maxBindParameters - GET_EDGES_FIXED_PARAM_COUNT
@@ -305,17 +311,21 @@ function computeSqliteBatchChunkSizes(maxBindParameters) {
       1,
       Math.floor(maxBindParameters / NODE_INSERT_PARAM_COUNT)
     ),
+    uniqueDeleteChunkSize: Math.max(
+      1,
+      maxBindParameters - UNIQUE_DELETE_FIXED_PARAM_COUNT
+    ),
     uniqueInsertBatchSize: Math.max(
       1,
       Math.floor(maxBindParameters / UNIQUE_INSERT_PARAM_COUNT)
     )
   };
 }
-var toNodeRow = chunkAQR6BHB3_cjs.createNodeRowMapper(chunkAQR6BHB3_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toEdgeRow = chunkAQR6BHB3_cjs.createEdgeRowMapper(chunkAQR6BHB3_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toUniqueRow = chunkAQR6BHB3_cjs.createUniqueRowMapper(chunkAQR6BHB3_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toSchemaVersionRow = chunkAQR6BHB3_cjs.createSchemaVersionRowMapper(
-  chunkAQR6BHB3_cjs.SQLITE_ROW_MAPPER_CONFIG
+var toNodeRow = chunkF4NHQHEZ_cjs.createNodeRowMapper(chunkF4NHQHEZ_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunkF4NHQHEZ_cjs.createEdgeRowMapper(chunkF4NHQHEZ_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunkF4NHQHEZ_cjs.createUniqueRowMapper(chunkF4NHQHEZ_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunkF4NHQHEZ_cjs.createSchemaVersionRowMapper(
+  chunkF4NHQHEZ_cjs.SQLITE_ROW_MAPPER_CONFIG
 );
 var PENDING_FOREVER = new Promise(noop);
 function pendingForever() {
@@ -334,7 +344,7 @@ async function loadQueueTaskContext() {
 void loadQueueTaskContext();
 function rejectReentrantQueueSubmission() {
   return Promise.reject(
-    new chunkKTBTSHU6_cjs.ConfigurationError(
+    new chunkC4F7VJ5D_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" },
       {
@@ -355,7 +365,7 @@ function createSerializedExecutionQueue() {
       disposed = true;
     },
     runExclusive(task) {
-      if (isDisposed()) return Promise.reject(new chunkKTBTSHU6_cjs.BackendDisposedError());
+      if (isDisposed()) return Promise.reject(new chunkC4F7VJ5D_cjs.BackendDisposedError());
       if (queueTaskContext?.getStore() === taskMarker) {
         return rejectReentrantQueueSubmission();
       }
@@ -383,7 +393,7 @@ function runWithSerializedQueue(queue, task) {
   return queue.runExclusive(task);
 }
 function throwSqliteTransactionsDisabled(message) {
-  throw new chunkKTBTSHU6_cjs.ConfigurationError(message, {
+  throw new chunkC4F7VJ5D_cjs.ConfigurationError(message, {
     backend: "sqlite",
     capability: "transactions",
     supportsTransactions: false
@@ -391,20 +401,20 @@ function throwSqliteTransactionsDisabled(message) {
 }
 function buildSqliteCapabilities(options) {
   const base = options.transactionMode === "none" ? {
-    ...chunkECU53PMN_cjs.SQLITE_CAPABILITIES,
+    ...chunkEKFUG4G7_cjs.SQLITE_CAPABILITIES,
     transactions: false,
     graphAnalytics: {
-      ...chunkECU53PMN_cjs.SQLITE_CAPABILITIES.graphAnalytics ?? {
+      ...chunkEKFUG4G7_cjs.SQLITE_CAPABILITIES.graphAnalytics ?? {
         mathFunctions: false
       },
       supported: false
     }
-  } : chunkECU53PMN_cjs.SQLITE_CAPABILITIES;
+  } : chunkEKFUG4G7_cjs.SQLITE_CAPABILITIES;
   return {
     ...base,
     maxBindParameters: options.maxBindParameters,
-    fulltext: chunkUTTW2Q3M_cjs.buildFulltextCapabilities(options.fulltextStrategy),
-    ...options.vectorStrategy === void 0 ? {} : { vector: chunkUTTW2Q3M_cjs.buildVectorCapabilities(options.vectorStrategy) }
+    fulltext: chunkJXUTCSXX_cjs.buildFulltextCapabilities(options.fulltextStrategy),
+    ...options.vectorStrategy === void 0 ? {} : { vector: chunkJXUTCSXX_cjs.buildVectorCapabilities(options.vectorStrategy) }
   };
 }
 function resolveMaxBindParametersCapability(profile, override) {
@@ -412,7 +422,7 @@ function resolveMaxBindParametersCapability(profile, override) {
   return profile.hardMaxBindParameters === void 0 ? requested : Math.min(requested, profile.hardMaxBindParameters);
 }
 function resolveSqliteGraphAnalyticsCapabilities(profile, override) {
-  const requested = override ?? chunkECU53PMN_cjs.SQLITE_CAPABILITIES.graphAnalytics ?? {
+  const requested = override ?? chunkEKFUG4G7_cjs.SQLITE_CAPABILITIES.graphAnalytics ?? {
     supported: false,
     mathFunctions: false
   };
@@ -431,7 +441,8 @@ function createSqliteOperationBackend(options) {
     tableNames,
     fulltextStrategy,
     vectorStrategy,
-    contributionMaterializer
+    contributionMaterializer,
+    transactionScoped
   } = options;
   const compiledExecute = executionAdapter.executeCompiled;
   const compiledRun = executionAdapter.executeCompiledRun;
@@ -457,7 +468,7 @@ function createSqliteOperationBackend(options) {
     return runWithSerializedQueue(serializedQueue, async () => {
       if (compiledRun === void 0) {
         await db.run(
-          chunkX2XOQZT3_cjs.isSqlFragment(query) ? chunk6TJ6PKPS_cjs.toDrizzleSql(query, "sqlite") : query
+          chunkU5W4LKZV_cjs.isSqlFragment(query) ? chunkOOA273IJ_cjs.toDrizzleSql(query, "sqlite") : query
         );
         return;
       }
@@ -465,16 +476,17 @@ function createSqliteOperationBackend(options) {
     });
   }
   const batchConfig = computeSqliteBatchChunkSizes(
-    capabilities.maxBindParameters ?? chunkECU53PMN_cjs.SQLITE_MAX_BIND_PARAMETERS
+    capabilities.maxBindParameters ?? chunkEKFUG4G7_cjs.SQLITE_MAX_BIND_PARAMETERS
   );
-  const commonBackend = chunkO7XVCLXW_cjs.createCommonOperationBackend({
+  const commonBackend = chunkH7VE3FL4_cjs.createCommonOperationBackend({
     batchConfig,
     execution: {
       execAll,
       execGet,
       execRun
     },
-    nowIso: chunkAQR6BHB3_cjs.nowIso,
+    nowIso: chunkF4NHQHEZ_cjs.nowIso,
+    maxBindParameters: capabilities.maxBindParameters ?? chunkEKFUG4G7_cjs.SQLITE_MAX_BIND_PARAMETERS,
     operationStrategy,
     rowMappers: {
       toEdgeRow,
@@ -494,26 +506,26 @@ function createSqliteOperationBackend(options) {
   };
   const vectorEmbeddingMethods = vectorStrategy === void 0 ? {} : {
     async upsertEmbedding(params) {
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
-      const statements = vectorStrategy.buildUpsert(slot, params, chunkAQR6BHB3_cjs.nowIso());
+      const statements = vectorStrategy.buildUpsert(slot, params, chunkF4NHQHEZ_cjs.nowIso());
       try {
         for (const statement of statements) {
           await execRun(statement);
         }
       } catch (error) {
-        throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, params);
+        throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, params);
       }
     },
     async upsertEmbeddingBatch(params) {
       if (params.rows.length === 0) return;
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const rowsById = new Map(
         params.rows.map((row) => [row.nodeId, row])
       );
       const rows = [...rowsById.values()];
-      const timestamp = chunkAQR6BHB3_cjs.nowIso();
+      const timestamp = chunkF4NHQHEZ_cjs.nowIso();
       try {
         for (const chunk2 of chunkZDH3DX3C_cjs.chunk(
           rows,
@@ -544,37 +556,52 @@ function createSqliteOperationBackend(options) {
           }
         }
       } catch (error) {
-        throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, params);
+        throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, params);
       }
     },
     async deleteEmbedding(params) {
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const statements = vectorStrategy.buildDelete(slot, params);
       for (const statement of statements) {
         await execRun(statement);
       }
     },
+    async deleteEmbeddingBatch(params) {
+      if (params.nodeIds.length === 0) return;
+      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
+      await contributionMaterializer.assertVectorSlot(slot);
+      for (const nodeIds of chunkZDH3DX3C_cjs.chunk(
+        [...new Set(params.nodeIds)],
+        batchConfig.embeddingUpsertBatchSize
+      )) {
+        const statements = vectorStrategy.buildDeleteBatch(slot, {
+          ...params,
+          nodeIds
+        });
+        for (const statement of statements) await execRun(statement);
+      }
+    },
     async vectorSearch(params) {
-      chunkUTTW2Q3M_cjs.assertVectorSearchLimit(params.limit);
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      chunkJXUTCSXX_cjs.assertVectorSearchLimit(params.limit);
+      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(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 ?? chunkO7XVCLXW_cjs.buildLiveNodeCandidates(
+        params.candidates ?? chunkH7VE3FL4_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkAQR6BHB3_cjs.nowIso()
+          chunkF4NHQHEZ_cjs.nowIso()
         )
       );
       let rows;
       try {
         rows = await execAll(query);
       } catch (error) {
-        throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, params);
+        throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, params);
       }
       return rows.map((row) => ({
         nodeId: row.node_id,
@@ -586,9 +613,9 @@ function createSqliteOperationBackend(options) {
     // fallback by simply not exposing the member.
     ...capabilities.windowFunctions ? {
       async hybridSearch(params) {
-        chunkUTTW2Q3M_cjs.assertVectorSearchLimit(params.limit);
-        chunkUTTW2Q3M_cjs.assertVectorSearchLimit(params.vector.k);
-        const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams({
+        chunkJXUTCSXX_cjs.assertVectorSearchLimit(params.limit);
+        chunkJXUTCSXX_cjs.assertVectorSearchLimit(params.vector.k);
+        const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams({
           graphId: params.graphId,
           nodeKind: params.nodeKind,
           fieldPath: params.vector.fieldPath,
@@ -596,11 +623,11 @@ function createSqliteOperationBackend(options) {
           metric: params.vector.metric,
           indexType: params.vector.indexType
         });
-        const candidates = params.candidates ?? chunkO7XVCLXW_cjs.buildLiveNodeCandidates(
+        const candidates = params.candidates ?? chunkH7VE3FL4_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkAQR6BHB3_cjs.nowIso()
+          chunkF4NHQHEZ_cjs.nowIso()
         );
         const vectorParams = {
           graphId: params.graphId,
@@ -616,20 +643,20 @@ function createSqliteOperationBackend(options) {
         const vectorSql = vectorStrategy.buildSearch(
           slot,
           vectorParams,
-          chunkX2XOQZT3_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
+          chunkU5W4LKZV_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
         );
         const statement = operationStrategy.buildHybridSearch(
           { ...params, candidates },
-          chunk6TJ6PKPS_cjs.toDrizzleSql(vectorSql, "sqlite"),
+          chunkOOA273IJ_cjs.toDrizzleSql(vectorSql, "sqlite"),
           params.vector.metric === "cosine"
         );
         let raw;
         try {
           raw = await execAll(statement);
         } catch (error) {
-          throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, vectorParams);
+          throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, vectorParams);
         }
-        return raw.map((row) => chunkO7XVCLXW_cjs.mapHybridSearchRow(row, toNodeRow));
+        return raw.map((row) => chunkH7VE3FL4_cjs.mapHybridSearchRow(row, toNodeRow));
       }
     } : {}
   };
@@ -637,14 +664,45 @@ function createSqliteOperationBackend(options) {
     ...commonBackend,
     ...executeRawMethod,
     ...vectorEmbeddingMethods,
+    async deleteSchemaVectorSlotContribution(slot) {
+      if (vectorStrategy === void 0) return;
+      for (const contribution of vectorStrategy.ownedTables(slot)) {
+        await execRun(
+          operationStrategy.buildDeleteContributionMaterialization({
+            graphId: slot.graphId,
+            logicalName: contribution.logicalName,
+            owner: contribution.owner,
+            tableName: contribution.tableName
+          })
+        );
+      }
+      contributionMaterializer.evictVectorSlot(slot);
+    },
     capabilities,
     dialect: "sqlite",
     tableNames,
     fulltextStrategy,
     ...vectorStrategy === void 0 ? {} : { vectorStrategy },
+    async lockSchemaVersionForWrite(params) {
+      if (!transactionScoped) {
+        throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+          "The schema write fence requires an explicit SQLite transaction.",
+          {
+            code: "SCHEMA_WRITE_FENCE_TRANSACTION_REQUIRED",
+            graphId: params.graphId
+          }
+        );
+      }
+      const active = await commonBackend.getActiveSchema(params.graphId);
+      chunkH7VE3FL4_cjs.assertActiveSchemaVersion(
+        params.graphId,
+        params.expectedVersion,
+        active?.version ?? 0
+      );
+    },
     async createVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromCreateIndexParams(params);
+      const slot = chunkH7VE3FL4_cjs.vectorSlotFromCreateIndexParams(params);
       await contributionMaterializer.ensureVectorSlot(slot);
       const indexStatement = vectorStrategy.buildCreateIndex?.(slot);
       if (indexStatement !== void 0) {
@@ -653,18 +711,18 @@ function createSqliteOperationBackend(options) {
     },
     async dropVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromDropIndexParams(params);
+      const slot = chunkH7VE3FL4_cjs.vectorSlotFromDropIndexParams(params);
       const dropStatement = vectorStrategy.buildDropIndex?.(slot);
       if (dropStatement === void 0) return;
       try {
         await execRun(dropStatement);
       } catch (error) {
-        if (!chunkAO2WPYFZ_cjs.isMissingTableError(error)) throw error;
+        if (!chunkJQXSZHF2_cjs.isMissingTableError(error)) throw error;
       }
     },
     // === Fulltext Operations ===
     async upsertFulltext(params) {
-      const timestamp = chunkAQR6BHB3_cjs.nowIso();
+      const timestamp = chunkF4NHQHEZ_cjs.nowIso();
       const statements = operationStrategy.buildUpsertFulltext(
         params,
         timestamp
@@ -681,7 +739,7 @@ function createSqliteOperationBackend(options) {
     },
     async upsertFulltextBatch(params) {
       if (params.rows.length === 0) return;
-      const timestamp = chunkAQR6BHB3_cjs.nowIso();
+      const timestamp = chunkF4NHQHEZ_cjs.nowIso();
       for (const rows of chunkZDH3DX3C_cjs.chunk(
         params.rows,
         batchConfig.fulltextUpsertBatchSize
@@ -715,7 +773,7 @@ function createSqliteOperationBackend(options) {
       const rows = await execAll(query);
       return rows.map((row, index) => ({
         nodeId: row.node_id,
-        score: chunkAQR6BHB3_cjs.coerceNumericScore(row.score),
+        score: chunkF4NHQHEZ_cjs.coerceNumericScore(row.score),
         rank: index + 1,
         ...row.snippet === null ? {} : { snippet: row.snippet }
       }));
@@ -734,14 +792,14 @@ function createSqliteOperationBackend(options) {
   return operationBackend;
 }
 function createSqliteBackend(db, options = {}) {
-  const tables2 = options.tables ?? chunkOMQ2NBOR_cjs.tables2;
-  const fulltextStrategy = options.fulltext ?? chunkUTTW2Q3M_cjs.fts5Strategy;
+  const tables2 = options.tables ?? chunkZ3WO6MND_cjs.tables2;
+  const fulltextStrategy = options.fulltext ?? chunkJXUTCSXX_cjs.fts5Strategy;
   const profileHints = options.executionProfile ?? {};
   const executionAdapter = createSqliteExecutionAdapter(db, { profileHints });
   const { isSync, transactionMode } = executionAdapter.profile;
   const vectorStrategy = options.vector;
   const capabilityOverrides = options.capabilities ?? {};
-  const capabilities = chunkECU53PMN_cjs.normalizeGraphAnalyticsCapabilities({
+  const capabilities = chunkEKFUG4G7_cjs.normalizeGraphAnalyticsCapabilities({
     ...buildSqliteCapabilities({
       fulltextStrategy,
       vectorStrategy,
@@ -779,14 +837,14 @@ function createSqliteBackend(db, options = {}) {
     tableNames.recordedEdges,
     tableNames.recordedClock
   ];
-  const operationStrategy = chunkO7XVCLXW_cjs.createSqliteOperationStrategy(
+  const operationStrategy = chunkH7VE3FL4_cjs.createSqliteOperationStrategy(
     tables2,
     fulltextStrategy
   );
   const serializedQueue = transactionMode === "none" ? void 0 : createSerializedExecutionQueue();
   const matTable = tables2.contributionMaterializations;
   async function ensureContributionMaterializationsTableImpl() {
-    await db.run(drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generateSqliteCreateTableSQL(matTable)));
+    await db.run(drizzleOrm.sql.raw(chunkZ3WO6MND_cjs.generateSqliteCreateTableSQL(matTable)));
   }
   async function getContributionMaterializationRow(identity) {
     const rows = await db.select().from(matTable).where(
@@ -799,25 +857,25 @@ function createSqliteBackend(db, options = {}) {
     );
     const row = rows[0];
     if (row === void 0) return void 0;
-    return chunkO7XVCLXW_cjs.mapContributionMaterializationRow(
+    return chunkH7VE3FL4_cjs.mapContributionMaterializationRow(
       row,
-      chunkO7XVCLXW_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.decode
+      chunkH7VE3FL4_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.decode
     );
   }
   async function getContributionMaterializationRows(graphId) {
     const rows = await db.select().from(matTable).where(drizzleOrm.eq(matTable.graphId, graphId));
     return rows.map(
-      (row) => chunkO7XVCLXW_cjs.mapContributionMaterializationRow(
+      (row) => chunkH7VE3FL4_cjs.mapContributionMaterializationRow(
         row,
-        chunkO7XVCLXW_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.decode
+        chunkH7VE3FL4_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.decode
       )
     );
   }
   async function recordContributionMaterializationRow(params) {
     await db.insert(matTable).values(
-      chunkO7XVCLXW_cjs.buildContributionInsertValues(
+      chunkH7VE3FL4_cjs.buildContributionInsertValues(
         params,
-        chunkO7XVCLXW_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.encode
+        chunkH7VE3FL4_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.encode
       )
     ).onConflictDoUpdate({
       target: [
@@ -826,7 +884,7 @@ function createSqliteBackend(db, options = {}) {
         matTable.owner,
         matTable.tableName
       ],
-      set: chunkO7XVCLXW_cjs.buildContributionOnConflictSet(
+      set: chunkH7VE3FL4_cjs.buildContributionOnConflictSet(
         matTable.materializedAt,
         params.materializedAt
       )
@@ -842,7 +900,13 @@ function createSqliteBackend(db, options = {}) {
       )
     );
   }
-  const contributionMaterializer = chunkO7XVCLXW_cjs.createContributionMaterializer({
+  async function contributionTableExists(tableName) {
+    const rows = await executionAdapter.execute(
+      operationStrategy.buildTableExists(tableName)
+    );
+    return chunkH7VE3FL4_cjs.tableExistsFromRow(rows[0]);
+  }
+  const contributionMaterializer = chunkH7VE3FL4_cjs.createContributionMaterializer({
     dialect: "sqlite",
     fulltextStrategy,
     fulltextTableName: tables2.fulltextTableName,
@@ -853,7 +917,8 @@ function createSqliteBackend(db, options = {}) {
     ensureMarkerTable: ensureContributionMaterializationsTableImpl,
     getMarkers: getContributionMaterializationRows,
     recordMarker: recordContributionMaterializationRow,
-    deleteMarker: deleteContributionMaterializationRow
+    deleteMarker: deleteContributionMaterializationRow,
+    tableExists: contributionTableExists
   });
   const operations = createSqliteOperationBackend({
     capabilities,
@@ -864,6 +929,7 @@ function createSqliteBackend(db, options = {}) {
     fulltextStrategy,
     vectorStrategy,
     contributionMaterializer,
+    transactionScoped: false,
     ...serializedQueue === void 0 ? {} : { serializedQueue }
   });
   function runDoSqliteStorageTransaction(run) {
@@ -889,7 +955,7 @@ function createSqliteBackend(db, options = {}) {
   function runSchemaWriteTransaction(fn) {
     if (transactionMode === "none") {
       throwSqliteTransactionsDisabled(
-        "commitSchemaVersion and setActiveVersion require atomic transactions, but this SQLite backend has transactions disabled. Configure a driver that supports transactions (better-sqlite3, libsql, bun:sqlite) to use schema commits."
+        "Schema writes and removal cleanup require atomic transactions, but this SQLite backend has transactions disabled. Configure a driver that supports transactions (better-sqlite3, libsql, bun:sqlite) to use schema commits."
       );
     }
     if (transactionMode === "sql") {
@@ -962,36 +1028,41 @@ function createSqliteBackend(db, options = {}) {
       vectorStrategy,
       contributionMaterializer
     });
-    return chunkO7XVCLXW_cjs.gateFulltext(txBackend, contributionMaterializer.assertInitialized);
+    return chunkH7VE3FL4_cjs.gateFulltext(txBackend, contributionMaterializer.assertInitialized);
   }
   const backend = {
     ...operations,
     ...isSync && transactionMode === "sql" && executionAdapter.executePreparedRunBatch !== void 0 ? {
-      async trustedImport(fn) {
+      async trustedImport(fn, options_) {
         return backend.transaction(async (tx) => {
-          await chunkO7XVCLXW_cjs.assertTrustedImportDatabaseEmpty(tx, tableNames);
-          const indexDefinitions = await chunkO7XVCLXW_cjs.suspendSqliteSecondaryIndexes(
+          if (options_?.schemaWrite !== void 0) {
+            await chunk764JHTLT_cjs.requireDefined(tx.lockSchemaVersionForWrite)({
+              ...options_.schemaWrite
+            });
+          }
+          await chunkH7VE3FL4_cjs.assertTrustedImportDatabaseEmpty(tx, tableNames);
+          const indexDefinitions = await chunkH7VE3FL4_cjs.suspendSqliteSecondaryIndexes(
             tx,
             tableNames
           );
           const result = await fn(
-            chunkO7XVCLXW_cjs.createSqliteTrustedImportSession(executionAdapter, tableNames)
+            chunkH7VE3FL4_cjs.createSqliteTrustedImportSession(executionAdapter, tableNames)
           );
-          await chunkO7XVCLXW_cjs.restoreSecondaryIndexes(tx, indexDefinitions);
-          await chunkO7XVCLXW_cjs.analyzeImportedTables(tx, tableNames);
+          await chunkH7VE3FL4_cjs.restoreSecondaryIndexes(tx, indexDefinitions);
+          await chunkH7VE3FL4_cjs.analyzeImportedTables(tx, tableNames);
           return result;
         });
       }
     } : {},
     async bootstrapTables() {
-      const statements = chunkOMQ2NBOR_cjs.generateSqliteDDL(tables2, fulltextStrategy);
+      const statements = chunkZ3WO6MND_cjs.generateSqliteDDL(tables2, fulltextStrategy);
       for (const statement of statements) {
         await db.run(drizzleOrm.sql.raw(statement));
       }
     },
     async ensureRevisionOriginsTable() {
       await db.run(
-        drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generateSqliteCreateTableSQL(tables2.revisionOrigins))
+        drizzleOrm.sql.raw(chunkZ3WO6MND_cjs.generateSqliteCreateTableSQL(tables2.revisionOrigins))
       );
     },
     // Every fulltext-touching method asserts the durable marker instead
@@ -999,7 +1070,7 @@ function createSqliteBackend(db, options = {}) {
     // uninitialized database throws `StoreNotInitializedError` rather
     // than self-healing (#135). Shared verbatim with the tx-scoped gate
     // via `gateFulltextMethods`.
-    ...chunkO7XVCLXW_cjs.gateFulltextMethods(
+    ...chunkH7VE3FL4_cjs.gateFulltextMethods(
       operations,
       contributionMaterializer.assertInitialized
     ),
@@ -1008,7 +1079,7 @@ function createSqliteBackend(db, options = {}) {
     },
     async ensureIndexMaterializationsTable() {
       await db.run(
-        drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generateSqliteCreateTableSQL(tables2.indexMaterializations))
+        drizzleOrm.sql.raw(chunkZ3WO6MND_cjs.generateSqliteCreateTableSQL(tables2.indexMaterializations))
       );
     },
     async getIndexMaterialization(indexName) {
@@ -1016,26 +1087,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 chunkO7XVCLXW_cjs.mapMaterializationRow(row, chunkO7XVCLXW_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode);
+      return chunkH7VE3FL4_cjs.mapMaterializationRow(row, chunkH7VE3FL4_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) => chunkO7XVCLXW_cjs.mapMaterializationRow(row, chunkO7XVCLXW_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode)
+        (row) => chunkH7VE3FL4_cjs.mapMaterializationRow(row, chunkH7VE3FL4_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode)
       );
     },
     async recordIndexMaterialization(params) {
       const t = tables2.indexMaterializations;
       await db.insert(t).values(
-        chunkO7XVCLXW_cjs.buildMaterializationInsertValues(
+        chunkH7VE3FL4_cjs.buildMaterializationInsertValues(
           params,
-          chunkO7XVCLXW_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.encode
+          chunkH7VE3FL4_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: t.indexName,
-        set: chunkO7XVCLXW_cjs.buildMaterializationOnConflictSet(params.materializedAt)
+        set: chunkH7VE3FL4_cjs.buildMaterializationOnConflictSet(params.materializedAt)
       });
     },
     async ensureContributionMaterializationsTable() {
@@ -1051,37 +1122,37 @@ function createSqliteBackend(db, options = {}) {
       await contributionMaterializer.assertInitialized(graphId);
     },
     async ensureKindRemovalsTable() {
-      await db.run(drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generateSqliteCreateTableSQL(tables2.kindRemovals)));
+      await db.run(drizzleOrm.sql.raw(chunkZ3WO6MND_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) => chunkO7XVCLXW_cjs.mapKindRemovalRow(row, chunkO7XVCLXW_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkH7VE3FL4_cjs.mapKindRemovalRow(row, chunkH7VE3FL4_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) => chunkO7XVCLXW_cjs.mapKindRemovalRow(row, chunkO7XVCLXW_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkH7VE3FL4_cjs.mapKindRemovalRow(row, chunkH7VE3FL4_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
       );
     },
     async recordKindRemoval(params) {
       const t = tables2.kindRemovals;
       await db.insert(t).values(
-        chunkO7XVCLXW_cjs.buildKindRemovalInsertValues(
+        chunkH7VE3FL4_cjs.buildKindRemovalInsertValues(
           params,
-          chunkO7XVCLXW_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.encode
+          chunkH7VE3FL4_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: [t.graphId, t.kindName, t.entity, t.schemaVersion],
-        set: chunkO7XVCLXW_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
+        set: chunkH7VE3FL4_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
       });
     },
     async ensureReconciliationMarkersTable() {
       await db.run(
-        drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generateSqliteCreateTableSQL(tables2.reconciliationMarkers))
+        drizzleOrm.sql.raw(chunkZ3WO6MND_cjs.generateSqliteCreateTableSQL(tables2.reconciliationMarkers))
       );
     },
     async ensureRuntimeContributions(graphId) {
@@ -1095,6 +1166,12 @@ function createSqliteBackend(db, options = {}) {
     async ensureFulltextTable(graphId) {
       await contributionMaterializer.ensureRuntimeContributions(graphId);
     },
+    async verifyContributions(graphId, vectorSlots) {
+      return contributionMaterializer.verifyContributions(graphId, vectorSlots);
+    },
+    async repairContributions(graphId, vectorSlots) {
+      return contributionMaterializer.repairContributions(graphId, vectorSlots);
+    },
     // Vector counterparts of the runtime-contribution methods. Present
     // only when a vector strategy is wired (omitted on a plain SQLite
     // connection with no vector extension), mirroring the embedding/
@@ -1131,18 +1208,18 @@ function createSqliteBackend(db, options = {}) {
     async refreshStatistics() {
       try {
         await db.run(
-          chunk6TJ6PKPS_cjs.toDrizzleSql(
-            chunkX2XOQZT3_cjs.sql`PRAGMA analysis_limit = ${chunkX2XOQZT3_cjs.sql.raw(String(SQLITE_ANALYZE_ROW_LIMIT))}`,
+          chunkOOA273IJ_cjs.toDrizzleSql(
+            chunkU5W4LKZV_cjs.sql`PRAGMA analysis_limit = ${chunkU5W4LKZV_cjs.sql.raw(String(SQLITE_ANALYZE_ROW_LIMIT))}`,
             "sqlite"
           )
         );
       } catch (error) {
-        if (!chunkAO2WPYFZ_cjs.isSqliteNotAuthorizedError(error)) throw error;
+        if (!chunkJQXSZHF2_cjs.isSqliteNotAuthorizedError(error)) throw error;
       }
       for (const tableName of coreAnalyzeTables) {
         await db.run(
-          chunk6TJ6PKPS_cjs.toDrizzleSql(
-            chunkX2XOQZT3_cjs.sql`ANALYZE ${chunkX2XOQZT3_cjs.sql.identifier(tableName)}`,
+          chunkOOA273IJ_cjs.toDrizzleSql(
+            chunkU5W4LKZV_cjs.sql`ANALYZE ${chunkU5W4LKZV_cjs.sql.identifier(tableName)}`,
             "sqlite"
           )
         );
@@ -1150,13 +1227,13 @@ function createSqliteBackend(db, options = {}) {
       for (const tableName of recordedAnalyzeTables) {
         try {
           await db.run(
-            chunk6TJ6PKPS_cjs.toDrizzleSql(
-              chunkX2XOQZT3_cjs.sql`ANALYZE ${chunkX2XOQZT3_cjs.sql.identifier(tableName)}`,
+            chunkOOA273IJ_cjs.toDrizzleSql(
+              chunkU5W4LKZV_cjs.sql`ANALYZE ${chunkU5W4LKZV_cjs.sql.identifier(tableName)}`,
               "sqlite"
             )
           );
         } catch (error) {
-          if (!chunkAO2WPYFZ_cjs.isMissingTableError(error)) throw error;
+          if (!chunkJQXSZHF2_cjs.isMissingTableError(error)) throw error;
         }
       }
     },
@@ -1165,18 +1242,26 @@ function createSqliteBackend(db, options = {}) {
         (target) => target.commitSchemaVersion(params)
       );
     },
+    async commitSchemaVersionIfKindsEmpty(params, probes) {
+      return runSchemaWriteTransaction(
+        (target) => chunkH7VE3FL4_cjs.commitSchemaVersionIfKindsEmpty(target, params, probes)
+      );
+    },
     async setActiveVersion(params) {
       await runSchemaWriteTransaction(
         (target) => target.setActiveVersion(params)
       );
     },
+    async schemaWriteTransaction(_graphId, fn) {
+      return runSchemaWriteTransaction((target) => fn(target));
+    },
     async transaction(fn, options2) {
       return backend.transactionWithNative((tx) => fn(tx), options2);
     },
     async transactionWithNative(fn, options2) {
-      const temporaryWrites = options2?.temporaryWrites === chunkECU53PMN_cjs.INTERNAL_TEMPORARY_WRITES;
+      const temporaryWrites = options2?.temporaryWrites === chunkEKFUG4G7_cjs.INTERNAL_TEMPORARY_WRITES;
       if (temporaryWrites && options2.accessMode !== "read_only") {
-        throw new chunkKTBTSHU6_cjs.ConfigurationError(
+        throw new chunkC4F7VJ5D_cjs.ConfigurationError(
           "Temporary-write transactions must be semantically read-only.",
           { dialect: "sqlite" }
         );
@@ -1204,7 +1289,7 @@ function createSqliteBackend(db, options = {}) {
           );
           try {
             const result = await fn(
-              chunkO7XVCLXW_cjs.gateFulltext(
+              chunkH7VE3FL4_cjs.gateFulltext(
                 txBackend,
                 contributionMaterializer.assertInitialized
               ),
@@ -1236,7 +1321,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)."
         );
       }
-      chunkO7XVCLXW_cjs.assertAdoptedDialect(
+      chunkH7VE3FL4_cjs.assertAdoptedDialect(
         externalTx,
         sqliteCore.BaseSQLiteDatabase,
         "sqlite"
@@ -1262,10 +1347,11 @@ function createTransactionBackend(options) {
     tableNames: options.tableNames,
     fulltextStrategy: options.fulltextStrategy,
     vectorStrategy: options.vectorStrategy,
-    contributionMaterializer: options.contributionMaterializer
+    contributionMaterializer: options.contributionMaterializer,
+    transactionScoped: true
   });
 }
 
 exports.createSqliteBackend = createSqliteBackend;
-//# sourceMappingURL=chunk-F2KVJ6FF.cjs.map
-//# sourceMappingURL=chunk-F2KVJ6FF.cjs.map
+//# sourceMappingURL=chunk-P7GTYOLB.cjs.map
+//# sourceMappingURL=chunk-P7GTYOLB.cjs.map