@nicia-ai/typegraph 0.45.0 → 0.46.0

package/dist/{chunk-4GUTQPVO.js → chunk-C23WSN5E.js}

@@ -1,14 +1,13 @@
-import { createSqliteOperationStrategy, createContributionMaterializer, gateFulltextMethods, assertTrustedImportDatabaseEmpty, suspendSqliteSecondaryIndexes, createSqliteTrustedImportSession, restoreSecondaryIndexes, analyzeImportedTables, mapContributionMaterializationRow, SQLITE_CONTRIBUTION_MAT_TIMESTAMPS, buildContributionInsertValues, buildContributionOnConflictSet, tableExistsFromRow, assertAdoptedDialect, buildKindRemovalInsertValues, SQLITE_KIND_REMOVAL_TIMESTAMPS, buildKindRemovalOnConflictSet, mapKindRemovalRow, buildMaterializationInsertValues, SQLITE_INDEX_MAT_TIMESTAMPS, buildMaterializationOnConflictSet, mapMaterializationRow, createCommonOperationBackend, vectorSlotFromParams, buildLiveNodeCandidates, mapVectorWriteError, mapHybridSearchRow, gateFulltext, FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT, EMBEDDING_UPSERT_PARAM_COUNT, vectorSlotFromDropIndexParams, vectorSlotFromCreateIndexParams, assertActiveSchemaVersion, getOrCreateLru, commitSchemaVersionIfKindsEmpty } from './chunk-DXEEHSGN.js';
-import { createNodeRowMapper, SQLITE_ROW_MAPPER_CONFIG, createEdgeRowMapper, createUniqueRowMapper, createSchemaVersionRowMapper, nowIso, coerceNumericScore } from './chunk-YMTXMPV6.js';
-import { tables2, generateSqliteCreateTableSQL, generateSqliteDDL } from './chunk-BGYJW37L.js';
-import { toDrizzleSql, compileQueryWithDialect } from './chunk-EFEOOCJ3.js';
-import { chunk } from './chunk-35S6P5ZU.js';
-import { normalizeGraphAnalyticsCapabilities, INTERNAL_TEMPORARY_WRITES, SQLITE_CAPABILITIES, SQLITE_MAX_BIND_PARAMETERS, MODERN_SQLITE_MAX_BIND_PARAMETERS, DURABLE_OBJECT_MAX_BIND_PARAMETERS, D1_MAX_BIND_PARAMETERS } from './chunk-55ITBQJI.js';
-import { isSqliteNotAuthorizedError, isMissingTableError } from './chunk-V34A6R5V.js';
-import { fts5Strategy, buildVectorCapabilities, buildFulltextCapabilities, assertVectorSearchLimit } from './chunk-PVUI6KGR.js';
-import { sql as sql$1, isSqlFragment } from './chunk-6DCB664D.js';
-import { requireDefined } from './chunk-QMQLUA66.js';
-import { ConfigurationError, BackendDisposedError } from './chunk-4MB3AQAQ.js';
+import { contributionRebuildSupported, createSqliteOperationStrategy, createContributionMaterializer, gateFulltextMethods, assertTrustedImportDatabaseEmpty, suspendSqliteSecondaryIndexes, createSqliteTrustedImportSession, restoreSecondaryIndexes, analyzeImportedTables, mapContributionMaterializationRow, SQLITE_CONTRIBUTION_MAT_TIMESTAMPS, buildContributionInsertValues, buildContributionOnConflictSet, tableExistsFromRow, assertAdoptedDialect, buildKindRemovalInsertValues, SQLITE_KIND_REMOVAL_TIMESTAMPS, buildKindRemovalOnConflictSet, mapKindRemovalRow, buildMaterializationInsertValues, SQLITE_INDEX_MAT_TIMESTAMPS, buildMaterializationOnConflictSet, mapMaterializationRow, createCommonOperationBackend, vectorSlotFromParams, buildLiveNodeCandidates, mapVectorWriteError, mapHybridSearchRow, gateFulltext, FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT, EMBEDDING_UPSERT_PARAM_COUNT, vectorSlotFromDropIndexParams, vectorSlotFromCreateIndexParams, assertActiveSchemaVersion, getOrCreateLru, commitSchemaVersionIfKindsEmpty } from './chunk-7VQXLT5O.js';
+import { createNodeRowMapper, SQLITE_ROW_MAPPER_CONFIG, createEdgeRowMapper, createUniqueRowMapper, createSchemaVersionRowMapper, nowIso, coerceNumericScore } from './chunk-NMWDXFPH.js';
+import { tables2, generateSqliteCreateTableSQL, generateSqliteDDL, createSqliteTables, sqliteContributions } from './chunk-5UVRGXD3.js';
+import { toDrizzleSql, compileQueryWithDialect } from './chunk-UV3SN74I.js';
+import { isSqliteNotAuthorizedError, isMissingTableError, chunk } from './chunk-JZUR7ZWE.js';
+import { normalizeGraphAnalyticsCapabilities, markSerializedTransactionResource, INTERNAL_TEMPORARY_WRITES, SQLITE_CAPABILITIES, SQLITE_MAX_BIND_PARAMETERS, MODERN_SQLITE_MAX_BIND_PARAMETERS, DURABLE_OBJECT_MAX_BIND_PARAMETERS, D1_MAX_BIND_PARAMETERS } from './chunk-AKLS3BYZ.js';
+import { fts5Strategy, buildVectorCapabilities, buildFulltextCapabilities, assertVectorSearchLimit, resolveEfSearchOverride, vectorSearchFrontierTuning } from './chunk-YDFDBE6D.js';
+import { sql as sql$1, isSqlFragment } from './chunk-PQBQG7IM.js';
+import { ConfigurationError, BackendDisposedError } from './chunk-J3WZ3FA2.js';
+import { requireDefined } from './chunk-DYATYRY4.js';
 import { getTableName, sql, eq, and, isNull, inArray } from 'drizzle-orm';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
 
@@ -120,11 +119,30 @@ function detectMaxBindParameters(sqliteClient, hardMaxBindParameters) {
     return SQLITE_MAX_BIND_PARAMETERS;
   }
 }
+function preparingClient(client) {
+  if (typeof client !== "object" || client === null) return void 0;
+  const candidate = client;
+  return typeof candidate["prepare"] === "function" ? candidate : void 0;
+}
+function hasMethods(client, methods) {
+  return methods.every((method) => typeof client[method] === "function");
+}
+function isBetterSqlite3Client(client) {
+  const candidate = preparingClient(client);
+  return candidate !== void 0 && hasMethods(candidate, ["pragma"]);
+}
+function isBunSqliteClient(client) {
+  const candidate = preparingClient(client);
+  return candidate !== void 0 && hasMethods(candidate, ["query", "run", "exec", "serialize"]) && typeof candidate["filename"] === "string";
+}
+function isSqlJsClient(client) {
+  const candidate = preparingClient(client);
+  return candidate !== void 0 && hasMethods(candidate, ["exec", "run", "export", "getRowsModified"]);
+}
 function resolveSqliteClient(db) {
   const sqliteClient = db.$client;
-  if (typeof sqliteClient !== "object" || sqliteClient === null) return;
-  const candidate = sqliteClient;
-  if (typeof candidate["prepare"] !== "function") return;
+  if (preparingClient(sqliteClient) === void 0) return;
+  if (isSqlJsClient(sqliteClient)) return;
   return sqliteClient;
 }
 function getOrCreatePreparedStatement(cache, sqliteClient, sqlText, cacheMax) {
@@ -271,6 +289,12 @@ 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;
+var IDENTITY_TABLE_LOGICAL_NAMES = /* @__PURE__ */ new Set([
+  "identityAssertions",
+  "recordedIdentityAssertions",
+  "identityClosure",
+  "identitySeparation"
+]);
 function computeSqliteBatchChunkSizes(maxBindParameters) {
   return {
     checkUniqueBatchChunkSize: Math.max(
@@ -582,6 +606,14 @@ function createSqliteOperationBackend(options) {
     },
     async vectorSearch(params) {
       assertVectorSearchLimit(params.limit);
+      resolveEfSearchOverride({
+        efSearch: params.efSearch,
+        indexType: params.indexType,
+        tuning: vectorSearchFrontierTuning(vectorStrategy),
+        transactions: capabilities.transactions,
+        dialect: "SQLite",
+        engine: vectorStrategy.name
+      });
       const slot = vectorSlotFromParams(params);
       const query = vectorStrategy.buildSearch(
         slot,
@@ -613,6 +645,14 @@ function createSqliteOperationBackend(options) {
       async hybridSearch(params) {
         assertVectorSearchLimit(params.limit);
         assertVectorSearchLimit(params.vector.k);
+        resolveEfSearchOverride({
+          efSearch: params.vector.efSearch,
+          indexType: params.vector.indexType,
+          tuning: vectorSearchFrontierTuning(vectorStrategy),
+          transactions: capabilities.transactions,
+          dialect: "SQLite",
+          engine: vectorStrategy.name
+        });
         const slot = vectorSlotFromParams({
           graphId: params.graphId,
           nodeKind: params.nodeKind,
@@ -662,6 +702,22 @@ function createSqliteOperationBackend(options) {
     ...commonBackend,
     ...executeRawMethod,
     ...vectorEmbeddingMethods,
+    /**
+     * Transaction-scoped contribution marker stamp. Present so the
+     * destructive rebuild can commit its marker with the DDL that
+     * produced it; without it the stamp would land outside the
+     * transaction and could survive a rolled-back drop.
+     *
+     * States the row outright rather than reusing the top-level upsert,
+     * whose `materialized_at` COALESCE preserves an earlier success so a
+     * failed re-attempt cannot erase it. A completed rebuild replaced the
+     * storage, so the recorded timestamp must be the rebuild's.
+     */
+    async recordContributionMaterialization(params) {
+      await execRun(
+        operationStrategy.buildInsertContributionMaterialization(params)
+      );
+    },
     async deleteSchemaVectorSlotContribution(slot) {
       if (vectorStrategy === void 0) return;
       for (const contribution of vectorStrategy.ownedTables(slot)) {
@@ -789,7 +845,22 @@ function createSqliteOperationBackend(options) {
   };
   return operationBackend;
 }
+function isLocalLibsqlClient(client) {
+  if (typeof client !== "object" || client === null) return false;
+  const candidate = client;
+  return candidate["protocol"] === "file" && typeof candidate["execute"] === "function" && typeof candidate["batch"] === "function" && typeof candidate["executeMultiple"] === "function";
+}
+function getSerializedSqliteConnection(db) {
+  const client = db.$client;
+  if (isBetterSqlite3Client(client) || isBunSqliteClient(client) || isSqlJsClient(client)) {
+    return client;
+  }
+  const storageClient = getDurableObjectStorageClient(db);
+  if (storageClient !== void 0) return storageClient;
+  return isLocalLibsqlClient(client) ? client : void 0;
+}
 function createSqliteBackend(db, options = {}) {
+  const serializedConnection = getSerializedSqliteConnection(db);
   const tables2$1 = options.tables ?? tables2;
   const fulltextStrategy = options.fulltext ?? fts5Strategy;
   const profileHints = options.executionProfile ?? {};
@@ -797,7 +868,7 @@ function createSqliteBackend(db, options = {}) {
   const { isSync, transactionMode } = executionAdapter.profile;
   const vectorStrategy = options.vector;
   const capabilityOverrides = options.capabilities ?? {};
-  const capabilities = normalizeGraphAnalyticsCapabilities({
+  const declaredCapabilities = normalizeGraphAnalyticsCapabilities({
     ...buildSqliteCapabilities({
       fulltextStrategy,
       vectorStrategy,
@@ -814,6 +885,18 @@ function createSqliteBackend(db, options = {}) {
       capabilityOverrides.graphAnalytics
     )
   });
+  const capabilities = {
+    ...declaredCapabilities,
+    contributions: {
+      supported: true,
+      probe: true,
+      rebuild: contributionRebuildSupported(
+        fulltextStrategy,
+        tables2$1.fulltextTableName,
+        declaredCapabilities.transactions
+      )
+    }
+  };
   const tableNames = {
     nodes: getTableName(tables2$1.nodes),
     edges: getTableName(tables2$1.edges),
@@ -821,6 +904,10 @@ function createSqliteBackend(db, options = {}) {
     recordedEdges: getTableName(tables2$1.recordedEdges),
     recordedClock: getTableName(tables2$1.recordedClock),
     revisionOrigins: getTableName(tables2$1.revisionOrigins),
+    identityAssertions: getTableName(tables2$1.identityAssertions),
+    recordedIdentityAssertions: getTableName(tables2$1.recordedIdentityAssertions),
+    identityClosure: getTableName(tables2$1.identityClosure),
+    identitySeparation: getTableName(tables2$1.identitySeparation),
     fulltext: tables2$1.fulltextTableName,
     uniques: getTableName(tables2$1.uniques)
   };
@@ -830,10 +917,14 @@ function createSqliteBackend(db, options = {}) {
     tableNames.uniques,
     tableNames.fulltext
   ];
-  const recordedAnalyzeTables = [
+  const guardedAnalyzeTables = [
     tableNames.recordedNodes,
     tableNames.recordedEdges,
-    tableNames.recordedClock
+    tableNames.recordedClock,
+    tableNames.recordedIdentityAssertions,
+    tableNames.identityAssertions,
+    tableNames.identityClosure,
+    tableNames.identitySeparation
   ];
   const operationStrategy = createSqliteOperationStrategy(
     tables2$1,
@@ -904,6 +995,17 @@ function createSqliteBackend(db, options = {}) {
     );
     return tableExistsFromRow(rows[0]);
   }
+  function identityContributionsFor(identityTableNames) {
+    const identityTables = createSqliteTables({
+      identityAssertions: identityTableNames.identityAssertions,
+      recordedIdentityAssertions: identityTableNames.recordedIdentityAssertions,
+      identityClosure: identityTableNames.identityClosure,
+      identitySeparation: identityTableNames.identitySeparation
+    });
+    return sqliteContributions(identityTables, fulltextStrategy).filter(
+      (contribution) => IDENTITY_TABLE_LOGICAL_NAMES.has(contribution.logicalName)
+    );
+  }
   const contributionMaterializer = createContributionMaterializer({
     dialect: "sqlite",
     fulltextStrategy,
@@ -916,7 +1018,15 @@ function createSqliteBackend(db, options = {}) {
     getMarkers: getContributionMaterializationRows,
     recordMarker: recordContributionMaterializationRow,
     deleteMarker: deleteContributionMaterializationRow,
-    tableExists: contributionTableExists
+    tableExists: contributionTableExists,
+    // Withheld rather than wired-and-throwing when transactions are
+    // disabled: the rebuild must refuse with its own typed error naming
+    // the absent fence, matching `capabilities.contributions.rebuild`.
+    // The graph id the materializer passes is unused — this backend's
+    // schema lock is per connection, not per graph.
+    ...capabilities.transactions ? {
+      schemaWriteTransaction: (_graphId, fn) => runSchemaWriteTransaction((target) => fn(target))
+    } : {}
   });
   const operations = createSqliteOperationBackend({
     capabilities,
@@ -950,6 +1060,16 @@ function createSqliteBackend(db, options = {}) {
     }
     await compiledRun(executionAdapter.compile(query));
   }
+  async function rollbackFrameQuietly() {
+    try {
+      await runFrameStatement(sql`ROLLBACK`);
+    } catch (rollbackError) {
+      console.warn(
+        "typegraph: ROLLBACK failed while unwinding a failed SQLite transaction; the original failure is the one thrown. Either the frame was already closed (SQLite auto-rolls-back on SQLITE_FULL / SQLITE_IOERR / SQLITE_NOMEM) and nothing is leaked, or it is still open on this connection, in which case the next BEGIN here fails.",
+        rollbackError
+      );
+    }
+  }
   function runSchemaWriteTransaction(fn) {
     if (transactionMode === "none") {
       throwSqliteTransactionsDisabled(
@@ -975,7 +1095,7 @@ function createSqliteBackend(db, options = {}) {
           await runFrameStatement(sql`COMMIT`);
           return result;
         } catch (error) {
-          await runFrameStatement(sql`ROLLBACK`);
+          await rollbackFrameQuietly();
           throw error;
         }
       });
@@ -1063,6 +1183,28 @@ function createSqliteBackend(db, options = {}) {
         sql.raw(generateSqliteCreateTableSQL(tables2$1.revisionOrigins))
       );
     },
+    async ensureIdentityTables(identityTableNames, options2) {
+      const identityContributions = identityContributionsFor(identityTableNames);
+      const missing = [];
+      for (const contribution of identityContributions) {
+        if (!await contributionTableExists(contribution.tableName)) {
+          missing.push(contribution.logicalName);
+        }
+      }
+      if (missing.length === 0 || options2.provisionMissing) {
+        for (const contribution of identityContributions) {
+          for (const ddl of contribution.createDdl) {
+            await db.run(sql.raw(ddl));
+          }
+        }
+      }
+      return missing;
+    },
+    identityTableDdl(identityTableNames) {
+      return identityContributionsFor(identityTableNames).flatMap(
+        (contribution) => [...contribution.createDdl]
+      );
+    },
     // Every fulltext-touching method asserts the durable marker instead
     // of lazily emitting DDL. Steady state performs zero ensure; an
     // uninitialized database throws `StoreNotInitializedError` rather
@@ -1170,6 +1312,16 @@ function createSqliteBackend(db, options = {}) {
     async repairContributions(graphId, vectorSlots) {
       return contributionMaterializer.repairContributions(graphId, vectorSlots);
     },
+    async probeContributions(graphId, vectorSlots) {
+      return contributionMaterializer.probeContributions(graphId, vectorSlots);
+    },
+    async rebuildContribution(graphId, scope, repopulate) {
+      return contributionMaterializer.rebuildContribution(
+        graphId,
+        scope,
+        repopulate
+      );
+    },
     // 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/
@@ -1222,7 +1374,7 @@ function createSqliteBackend(db, options = {}) {
           )
         );
       }
-      for (const tableName of recordedAnalyzeTables) {
+      for (const tableName of guardedAnalyzeTables) {
         try {
           await db.run(
             toDrizzleSql(
@@ -1245,6 +1397,12 @@ function createSqliteBackend(db, options = {}) {
         (target) => commitSchemaVersionIfKindsEmpty(target, params, probes)
       );
     },
+    async commitSchemaVersionWithPreflight(params, preflight) {
+      return runSchemaWriteTransaction(async (target) => {
+        await preflight(target);
+        return target.commitSchemaVersion(params);
+      });
+    },
     async setActiveVersion(params) {
       await runSchemaWriteTransaction(
         (target) => target.setActiveVersion(params)
@@ -1296,7 +1454,7 @@ function createSqliteBackend(db, options = {}) {
             await runFrameStatement(sql`COMMIT`);
             return result;
           } catch (error) {
-            await runFrameStatement(sql`ROLLBACK`);
+            await rollbackFrameQuietly();
             throw error;
           }
         });
@@ -1331,6 +1489,9 @@ function createSqliteBackend(db, options = {}) {
       return Promise.resolve();
     }
   };
+  if (serializedConnection !== void 0) {
+    markSerializedTransactionResource(backend, serializedConnection);
+  }
   return backend;
 }
 function createTransactionBackend(options) {
@@ -1350,6 +1511,6 @@ function createTransactionBackend(options) {
   });
 }
 
-export { createSqliteBackend };
-//# sourceMappingURL=chunk-4GUTQPVO.js.map
-//# sourceMappingURL=chunk-4GUTQPVO.js.map
+export { createSqliteBackend, isLocalLibsqlClient };
+//# sourceMappingURL=chunk-C23WSN5E.js.map
+//# sourceMappingURL=chunk-C23WSN5E.js.map