@nicia-ai/typegraph 0.25.0 → 0.26.0

package/dist/{chunk-ZEMNF3QK.cjs → chunk-RVT2N4RF.cjs}

@@ -1,10 +1,11 @@
 'use strict';
 
-var chunkO2P3KAUT_cjs = require('./chunk-O2P3KAUT.cjs');
-var chunk7CDXX3QZ_cjs = require('./chunk-7CDXX3QZ.cjs');
-var chunkJTI5WT4P_cjs = require('./chunk-JTI5WT4P.cjs');
-var chunkW5MTHMTE_cjs = require('./chunk-W5MTHMTE.cjs');
+var chunkTVUARC7S_cjs = require('./chunk-TVUARC7S.cjs');
+var chunkDN4RUDF3_cjs = require('./chunk-DN4RUDF3.cjs');
+var chunkPN37HVAV_cjs = require('./chunk-PN37HVAV.cjs');
+var chunkYEDQLNVE_cjs = require('./chunk-YEDQLNVE.cjs');
 var drizzleOrm = require('drizzle-orm');
+var sqliteCore = require('drizzle-orm/sqlite-core');
 
 var DEFAULT_PREPARED_STATEMENT_CACHE_MAX = 256;
 function getSessionName(db) {
@@ -20,7 +21,7 @@ function isD1DatabaseBySessionName(db) {
 }
 function isDurableObjectBySessionName(db) {
   const sessionName = getSessionName(db);
-  return sessionName === "SQLiteDurableObjectSession";
+  return sessionName === "SQLiteDOSession" || sessionName === "SQLiteDurableObjectSession";
 }
 function isSyncDatabaseBySessionName(db) {
   const sessionName = getSessionName(db);
@@ -34,6 +35,9 @@ function detectSyncProfile(db, profileHints) {
   if (sessionName === "BetterSQLiteSession" || sessionName === "BunSQLiteSession") {
     return true;
   }
+  if (isDurableObjectBySessionName(db)) {
+    return true;
+  }
   if (sessionName === "SQLiteD1Session") {
     return false;
   }
@@ -48,7 +52,10 @@ function detectTransactionMode(db, profileHints, isSync) {
   if (profileHints.transactionMode !== void 0) {
     return profileHints.transactionMode;
   }
-  if (isD1DatabaseBySessionName(db) || isDurableObjectBySessionName(db)) {
+  if (isDurableObjectBySessionName(db)) {
+    return "do-sqlite";
+  }
+  if (isD1DatabaseBySessionName(db)) {
     return "none";
   }
   if (isSync) return "sql";
@@ -63,7 +70,7 @@ function resolveSqliteClient(db) {
   return sqliteClient;
 }
 function getOrCreatePreparedStatement(cache, sqliteClient, sqlText, cacheMax) {
-  return chunkO2P3KAUT_cjs.getOrCreateLru(
+  return chunkTVUARC7S_cjs.getOrCreateLru(
     cache,
     sqlText,
     cacheMax,
@@ -99,7 +106,7 @@ function createSqliteExecutionAdapter(db, statementCacheMaxOrOptions = {}) {
     supportsCompiledExecution: sqliteClient !== void 0,
     transactionMode
   };
-  const compile = (query) => chunkO2P3KAUT_cjs.compileQueryWithDialect(db, query, "SQLite");
+  const compile = (query) => chunkTVUARC7S_cjs.compileQueryWithDialect(db, query, "SQLite");
   if (sqliteClient !== void 0) {
     let executeCompiled2 = function(compiledQuery) {
       const preparedStatement = getOrCreatePreparedStatement(
@@ -170,10 +177,10 @@ var SQLITE_CHECK_UNIQUE_BATCH_CHUNK_SIZE = Math.max(
   1,
   SQLITE_MAX_BIND_PARAMETERS - CHECK_UNIQUE_BATCH_FIXED_PARAM_COUNT
 );
-var toNodeRow = chunkO2P3KAUT_cjs.createNodeRowMapper(chunkO2P3KAUT_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toEdgeRow = chunkO2P3KAUT_cjs.createEdgeRowMapper(chunkO2P3KAUT_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toUniqueRow = chunkO2P3KAUT_cjs.createUniqueRowMapper(chunkO2P3KAUT_cjs.SQLITE_ROW_MAPPER_CONFIG);
-var toSchemaVersionRow = chunkO2P3KAUT_cjs.createSchemaVersionRowMapper(chunkO2P3KAUT_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toNodeRow = chunkTVUARC7S_cjs.createNodeRowMapper(chunkTVUARC7S_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunkTVUARC7S_cjs.createEdgeRowMapper(chunkTVUARC7S_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunkTVUARC7S_cjs.createUniqueRowMapper(chunkTVUARC7S_cjs.SQLITE_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunkTVUARC7S_cjs.createSchemaVersionRowMapper(chunkTVUARC7S_cjs.SQLITE_ROW_MAPPER_CONFIG);
 var PENDING_FOREVER = new Promise(noop);
 function pendingForever() {
   return PENDING_FOREVER;
@@ -191,7 +198,7 @@ function createSerializedExecutionQueue() {
       disposed = true;
     },
     runExclusive(task) {
-      if (isDisposed()) return Promise.reject(new chunkW5MTHMTE_cjs.BackendDisposedError());
+      if (isDisposed()) return Promise.reject(new chunkYEDQLNVE_cjs.BackendDisposedError());
       const runTask = async () => {
         if (isDisposed()) return pendingForever();
         try {
@@ -217,11 +224,18 @@ function runWithSerializedQueue(queue, task) {
 var SQLITE_VECTOR_METRICS = ["cosine", "l2"];
 var SQLITE_VECTOR_INDEX_TYPES = ["none"];
 var SQLITE_VECTOR_MAX_DIMENSIONS = 8e3;
+function throwSqliteTransactionsDisabled(message) {
+  throw new chunkYEDQLNVE_cjs.ConfigurationError(message, {
+    backend: "sqlite",
+    capability: "transactions",
+    supportsTransactions: false
+  });
+}
 function buildSqliteCapabilities(options) {
-  const base = options.transactionMode === "none" ? { ...chunk7CDXX3QZ_cjs.SQLITE_CAPABILITIES, transactions: false } : chunk7CDXX3QZ_cjs.SQLITE_CAPABILITIES;
+  const base = options.transactionMode === "none" ? { ...chunkDN4RUDF3_cjs.SQLITE_CAPABILITIES, transactions: false } : chunkDN4RUDF3_cjs.SQLITE_CAPABILITIES;
   return {
     ...base,
-    fulltext: chunkJTI5WT4P_cjs.buildFulltextCapabilities(options.fulltextStrategy),
+    fulltext: chunkPN37HVAV_cjs.buildFulltextCapabilities(options.fulltextStrategy),
     ...options.hasVectorEmbeddings ? {
       vector: {
         supported: true,
@@ -258,7 +272,7 @@ function createSqliteOperationBackend(options) {
       await db.run(query);
     });
   }
-  const commonBackend = chunkO2P3KAUT_cjs.createCommonOperationBackend({
+  const commonBackend = chunkTVUARC7S_cjs.createCommonOperationBackend({
     batchConfig: {
       checkUniqueBatchChunkSize: SQLITE_CHECK_UNIQUE_BATCH_CHUNK_SIZE,
       edgeInsertBatchSize: SQLITE_EDGE_INSERT_BATCH_SIZE,
@@ -271,7 +285,7 @@ function createSqliteOperationBackend(options) {
       execGet,
       execRun
     },
-    nowIso: chunkO2P3KAUT_cjs.nowIso,
+    nowIso: chunkTVUARC7S_cjs.nowIso,
     operationStrategy,
     rowMappers: {
       toEdgeRow,
@@ -293,7 +307,7 @@ function createSqliteOperationBackend(options) {
     async upsertEmbedding(params) {
       const query = operationStrategy.buildUpsertEmbedding(
         params,
-        chunkO2P3KAUT_cjs.nowIso()
+        chunkTVUARC7S_cjs.nowIso()
       );
       await execRun(query);
     },
@@ -332,14 +346,14 @@ function createSqliteOperationBackend(options) {
         ...params.indexParams?.efConstruction === void 0 ? {} : { hnswEfConstruction: params.indexParams.efConstruction },
         ...params.indexParams?.lists === void 0 ? {} : { ivfflatLists: params.indexParams.lists }
       };
-      const result = chunkO2P3KAUT_cjs.createSqliteVectorIndex(indexOptions);
+      const result = chunkTVUARC7S_cjs.createSqliteVectorIndex(indexOptions);
       if (!result.success) {
         throw new Error(result.message ?? "Failed to create SQLite vector index");
       }
       return Promise.resolve();
     },
     dropVectorIndex(params) {
-      const result = chunkO2P3KAUT_cjs.dropSqliteVectorIndex(
+      const result = chunkTVUARC7S_cjs.dropSqliteVectorIndex(
         params.graphId,
         params.nodeKind,
         params.fieldPath
@@ -351,7 +365,7 @@ function createSqliteOperationBackend(options) {
     },
     // === Fulltext Operations ===
     async upsertFulltext(params) {
-      const timestamp = chunkO2P3KAUT_cjs.nowIso();
+      const timestamp = chunkTVUARC7S_cjs.nowIso();
       const statements = operationStrategy.buildUpsertFulltext(
         params,
         timestamp
@@ -368,7 +382,7 @@ function createSqliteOperationBackend(options) {
     },
     async upsertFulltextBatch(params) {
       if (params.rows.length === 0) return;
-      const timestamp = chunkO2P3KAUT_cjs.nowIso();
+      const timestamp = chunkTVUARC7S_cjs.nowIso();
       const statements = operationStrategy.buildUpsertFulltextBatch(
         params,
         timestamp
@@ -389,7 +403,7 @@ function createSqliteOperationBackend(options) {
       const rows = await execAll(query);
       return rows.map((row, index) => ({
         nodeId: row.node_id,
-        score: row.score,
+        score: chunkTVUARC7S_cjs.coerceNumericScore(row.score),
         rank: index + 1,
         ...row.snippet === null ? {} : { snippet: row.snippet }
       }));
@@ -408,8 +422,8 @@ function createSqliteOperationBackend(options) {
   return operationBackend;
 }
 function createSqliteBackend(db, options = {}) {
-  const tables2 = options.tables ?? chunkO2P3KAUT_cjs.tables2;
-  const fulltextStrategy = options.fulltext ?? chunkJTI5WT4P_cjs.fts5Strategy;
+  const tables2 = options.tables ?? chunkTVUARC7S_cjs.tables2;
+  const fulltextStrategy = options.fulltext ?? chunkPN37HVAV_cjs.fts5Strategy;
   const profileHints = options.executionProfile ?? {};
   const executionAdapter = createSqliteExecutionAdapter(db, { profileHints });
   const { isSync, transactionMode } = executionAdapter.profile;
@@ -426,7 +440,7 @@ function createSqliteBackend(db, options = {}) {
     fulltext: tables2.fulltextTableName,
     uniques: drizzleOrm.getTableName(tables2.uniques)
   };
-  const operationStrategy = chunkO2P3KAUT_cjs.createSqliteOperationStrategy(
+  const operationStrategy = chunkTVUARC7S_cjs.createSqliteOperationStrategy(
     tables2,
     fulltextStrategy
   );
@@ -441,15 +455,23 @@ function createSqliteBackend(db, options = {}) {
     hasVectorEmbeddings,
     ...serializedQueue === void 0 ? {} : { serializedQueue }
   });
+  function runDoSqliteStorageTransaction(run) {
+    const storage = db.$client;
+    const storageTransaction = storage?.transaction;
+    if (typeof storageTransaction !== "function") {
+      throwSqliteTransactionsDisabled(
+        "transactionMode 'do-sqlite' requires a Drizzle Durable Objects database (drizzle(ctx.storage)) whose `$client` exposes the async storage `transaction(async () => ...)` runner."
+      );
+    }
+    return runWithSerializedQueue(
+      serializedQueue,
+      async () => storageTransaction.call(storage, run)
+    );
+  }
   function runSchemaWriteTransaction(fn) {
     if (transactionMode === "none") {
-      throw new chunkW5MTHMTE_cjs.ConfigurationError(
-        "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.",
-        {
-          backend: "sqlite",
-          capability: "transactions",
-          supportsTransactions: false
-        }
+      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."
       );
     }
     if (transactionMode === "sql") {
@@ -475,6 +497,20 @@ function createSqliteBackend(db, options = {}) {
         }
       });
     }
+    if (transactionMode === "do-sqlite") {
+      return runDoSqliteStorageTransaction(async () => {
+        const txBackend = createTransactionBackend({
+          capabilities,
+          db,
+          operationStrategy,
+          profileHints: { isSync },
+          tableNames,
+          fulltextStrategy,
+          hasVectorEmbeddings
+        });
+        return fn(txBackend);
+      });
+    }
     return runWithSerializedQueue(
       serializedQueue,
       async () => db.transaction(async (tx) => {
@@ -491,20 +527,91 @@ function createSqliteBackend(db, options = {}) {
       }, { behavior: "immediate" })
     );
   }
+  const matTable = tables2.contributionMaterializations;
+  async function ensureContributionMaterializationsTableImpl() {
+    await db.run(drizzleOrm.sql.raw(chunkTVUARC7S_cjs.generateSqliteCreateTableSQL(matTable)));
+  }
+  async function getContributionMaterializationRow(identity) {
+    const rows = await db.select().from(matTable).where(
+      drizzleOrm.and(
+        drizzleOrm.eq(matTable.graphId, identity.graphId),
+        drizzleOrm.eq(matTable.logicalName, identity.logicalName),
+        drizzleOrm.eq(matTable.owner, identity.owner),
+        drizzleOrm.eq(matTable.tableName, identity.tableName)
+      )
+    );
+    const row = rows[0];
+    if (row === void 0) return void 0;
+    return chunkTVUARC7S_cjs.mapContributionMaterializationRow(
+      row,
+      chunkTVUARC7S_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.decode
+    );
+  }
+  async function recordContributionMaterializationRow(params) {
+    await db.insert(matTable).values(
+      chunkTVUARC7S_cjs.buildContributionInsertValues(
+        params,
+        chunkTVUARC7S_cjs.SQLITE_CONTRIBUTION_MAT_TIMESTAMPS.encode
+      )
+    ).onConflictDoUpdate({
+      target: [
+        matTable.graphId,
+        matTable.logicalName,
+        matTable.owner,
+        matTable.tableName
+      ],
+      set: chunkTVUARC7S_cjs.buildContributionOnConflictSet(
+        matTable.materializedAt,
+        params.materializedAt
+      )
+    });
+  }
+  const contributionMaterializer = chunkTVUARC7S_cjs.createContributionMaterializer({
+    dialect: "sqlite",
+    fulltextStrategy,
+    fulltextTableName: tables2.fulltextTableName,
+    execDdl: async (statement) => {
+      await db.run(drizzleOrm.sql.raw(statement));
+    },
+    ensureMarkerTable: ensureContributionMaterializationsTableImpl,
+    getMarker: getContributionMaterializationRow,
+    recordMarker: recordContributionMaterializationRow
+  });
+  function bindTransactionBackend(tx) {
+    const txBackend = createTransactionBackend({
+      capabilities,
+      db: tx,
+      operationStrategy,
+      profileHints: { isSync },
+      tableNames,
+      fulltextStrategy,
+      hasVectorEmbeddings
+    });
+    return chunkTVUARC7S_cjs.gateFulltext(txBackend, contributionMaterializer.assertInitialized);
+  }
   const backend = {
     ...operations,
     async bootstrapTables() {
-      const statements = chunkO2P3KAUT_cjs.generateSqliteDDL(tables2, fulltextStrategy);
+      const statements = chunkTVUARC7S_cjs.generateSqliteDDL(tables2, fulltextStrategy);
       for (const statement of statements) {
         await db.run(drizzleOrm.sql.raw(statement));
       }
     },
+    // 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`.
+    ...chunkTVUARC7S_cjs.gateFulltextMethods(
+      operations,
+      contributionMaterializer.assertInitialized
+    ),
     async executeDdl(ddl) {
       await db.run(drizzleOrm.sql.raw(ddl));
     },
     async ensureIndexMaterializationsTable() {
       await db.run(
-        drizzleOrm.sql.raw(chunkO2P3KAUT_cjs.generateSqliteCreateTableSQL(tables2.indexMaterializations))
+        drizzleOrm.sql.raw(chunkTVUARC7S_cjs.generateSqliteCreateTableSQL(tables2.indexMaterializations))
       );
     },
     async getIndexMaterialization(indexName) {
@@ -512,65 +619,88 @@ 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 chunkO2P3KAUT_cjs.mapMaterializationRow(row, chunkO2P3KAUT_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode);
+      return chunkTVUARC7S_cjs.mapMaterializationRow(row, chunkTVUARC7S_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) => chunkO2P3KAUT_cjs.mapMaterializationRow(row, chunkO2P3KAUT_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode)
+        (row) => chunkTVUARC7S_cjs.mapMaterializationRow(row, chunkTVUARC7S_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.decode)
       );
     },
     async recordIndexMaterialization(params) {
       const t = tables2.indexMaterializations;
       await db.insert(t).values(
-        chunkO2P3KAUT_cjs.buildMaterializationInsertValues(
+        chunkTVUARC7S_cjs.buildMaterializationInsertValues(
           params,
-          chunkO2P3KAUT_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.encode
+          chunkTVUARC7S_cjs.SQLITE_INDEX_MAT_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: t.indexName,
-        set: chunkO2P3KAUT_cjs.buildMaterializationOnConflictSet(
+        set: chunkTVUARC7S_cjs.buildMaterializationOnConflictSet(
           t.materializedAt,
           params.materializedAt
         )
       });
     },
+    async ensureContributionMaterializationsTable() {
+      await ensureContributionMaterializationsTableImpl();
+    },
+    async getContributionMaterialization(identity) {
+      return getContributionMaterializationRow(identity);
+    },
+    async recordContributionMaterialization(params) {
+      await recordContributionMaterializationRow(params);
+    },
+    async assertRuntimeContributionsInitialized(graphId) {
+      await contributionMaterializer.assertInitialized(graphId);
+    },
     async ensureKindRemovalsTable() {
-      await db.run(drizzleOrm.sql.raw(chunkO2P3KAUT_cjs.generateSqliteCreateTableSQL(tables2.kindRemovals)));
+      await db.run(drizzleOrm.sql.raw(chunkTVUARC7S_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) => chunkO2P3KAUT_cjs.mapKindRemovalRow(row, chunkO2P3KAUT_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkTVUARC7S_cjs.mapKindRemovalRow(row, chunkTVUARC7S_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) => chunkO2P3KAUT_cjs.mapKindRemovalRow(row, chunkO2P3KAUT_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkTVUARC7S_cjs.mapKindRemovalRow(row, chunkTVUARC7S_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.decode)
       );
     },
     async recordKindRemoval(params) {
       const t = tables2.kindRemovals;
       await db.insert(t).values(
-        chunkO2P3KAUT_cjs.buildKindRemovalInsertValues(
+        chunkTVUARC7S_cjs.buildKindRemovalInsertValues(
           params,
-          chunkO2P3KAUT_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.encode
+          chunkTVUARC7S_cjs.SQLITE_KIND_REMOVAL_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: [t.graphId, t.kindName, t.entity, t.schemaVersion],
-        set: chunkO2P3KAUT_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
+        set: chunkTVUARC7S_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
       });
     },
     async ensureReconciliationMarkersTable() {
       await db.run(
-        drizzleOrm.sql.raw(chunkO2P3KAUT_cjs.generateSqliteCreateTableSQL(tables2.reconciliationMarkers))
+        drizzleOrm.sql.raw(chunkTVUARC7S_cjs.generateSqliteCreateTableSQL(tables2.reconciliationMarkers))
       );
     },
+    async ensureRuntimeContributions(graphId) {
+      await contributionMaterializer.ensureRuntimeContributions(graphId);
+    },
+    /**
+     * Superseded by `ensureRuntimeContributions(graphId)` (#129).
+     * Retained as a thin back-compat wrapper for callers predating
+     * #129; #135 routed it through the durable-marker writer.
+     */
+    async ensureFulltextTable(graphId) {
+      await contributionMaterializer.ensureRuntimeContributions(graphId);
+    },
     async getReconciliationMarker(graphId) {
       const t = tables2.reconciliationMarkers;
       const rows = await db.select().from(t).where(drizzleOrm.eq(t.graphId, graphId));
@@ -598,13 +728,8 @@ function createSqliteBackend(db, options = {}) {
     },
     async transaction(fn, _options) {
       if (transactionMode === "none") {
-        throw new chunkW5MTHMTE_cjs.ConfigurationError(
-          "This SQLite backend does not support atomic transactions. Operations within a transaction are not rolled back on failure. Use backend.capabilities.transactions to check for transaction support, or use individual operations with manual error handling.",
-          {
-            backend: "sqlite",
-            capability: "transactions",
-            supportsTransactions: false
-          }
+        throwSqliteTransactionsDisabled(
+          "This SQLite backend does not support atomic transactions. Operations within a transaction are not rolled back on failure. Use backend.capabilities.transactions to check for transaction support, or use individual operations with manual error handling."
         );
       }
       if (transactionMode === "sql") {
@@ -621,7 +746,13 @@ function createSqliteBackend(db, options = {}) {
           });
           db.run(drizzleOrm.sql`BEGIN`);
           try {
-            const result = await fn(txBackend);
+            const result = await fn(
+              chunkTVUARC7S_cjs.gateFulltext(
+                txBackend,
+                contributionMaterializer.assertInitialized
+              ),
+              db
+            );
             db.run(drizzleOrm.sql`COMMIT`);
             return result;
           } catch (error) {
@@ -630,21 +761,30 @@ function createSqliteBackend(db, options = {}) {
           }
         });
       }
+      if (transactionMode === "do-sqlite") {
+        return runDoSqliteStorageTransaction(
+          async () => fn(bindTransactionBackend(db), db)
+        );
+      }
       return runWithSerializedQueue(
         serializedQueue,
-        async () => db.transaction(async (tx) => {
-          const txBackend = createTransactionBackend({
-            capabilities,
-            db: tx,
-            operationStrategy,
-            profileHints: { isSync },
-            tableNames,
-            fulltextStrategy,
-            hasVectorEmbeddings
-          });
-          return fn(txBackend);
-        })
+        async () => db.transaction(
+          async (tx) => fn(bindTransactionBackend(tx), tx)
+        )
+      );
+    },
+    adoptTransaction(externalTx) {
+      if (transactionMode === "none") {
+        throwSqliteTransactionsDisabled(
+          "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)."
+        );
+      }
+      chunkTVUARC7S_cjs.assertAdoptedDialect(
+        externalTx,
+        sqliteCore.BaseSQLiteDatabase,
+        "sqlite"
       );
+      return bindTransactionBackend(externalTx);
     },
     close() {
       serializedQueue?.dispose();
@@ -669,5 +809,5 @@ function createTransactionBackend(options) {
 }
 
 exports.createSqliteBackend = createSqliteBackend;
-//# sourceMappingURL=chunk-ZEMNF3QK.cjs.map
-//# sourceMappingURL=chunk-ZEMNF3QK.cjs.map
+//# sourceMappingURL=chunk-RVT2N4RF.cjs.map
+//# sourceMappingURL=chunk-RVT2N4RF.cjs.map