@nicia-ai/typegraph 0.45.0 → 0.46.0

package/dist/{chunk-YDWLUT5V.cjs → chunk-TQR4KBY2.cjs}

@@ -1,17 +1,16 @@
 'use strict';
 
-var chunkH7VE3FL4_cjs = require('./chunk-H7VE3FL4.cjs');
-var chunkD56XG4EI_cjs = require('./chunk-D56XG4EI.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 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 chunkMUK4BU7K_cjs = require('./chunk-MUK4BU7K.cjs');
+var chunkMXJDTH5B_cjs = require('./chunk-MXJDTH5B.cjs');
+var chunkYAAM3M2S_cjs = require('./chunk-YAAM3M2S.cjs');
+var chunkRMQLSPA2_cjs = require('./chunk-RMQLSPA2.cjs');
+var chunkU5SON7R2_cjs = require('./chunk-U5SON7R2.cjs');
+var chunkBSFJMMV3_cjs = require('./chunk-BSFJMMV3.cjs');
+var chunkXBYVV3MP_cjs = require('./chunk-XBYVV3MP.cjs');
+var chunk4UGOKMI5_cjs = require('./chunk-4UGOKMI5.cjs');
+var chunkVCRRKBLN_cjs = require('./chunk-VCRRKBLN.cjs');
+var chunkNI72YOJB_cjs = require('./chunk-NI72YOJB.cjs');
+var chunkN66HCGCY_cjs = require('./chunk-N66HCGCY.cjs');
 var drizzleOrm = require('drizzle-orm');
 var pgCore = require('drizzle-orm/pg-core');
 
@@ -30,8 +29,12 @@ function isPgliteClient(candidate) {
   return typeof candidate === "object" && hasFunctionProperty(candidate, "query") && hasFunctionProperty(candidate, "dumpDataDir");
 }
 var PGLITE_MAX_BIND_PARAMETERS = 32767;
+function getPgliteClient(db) {
+  const client = db.$client;
+  return isPgliteClient(client) ? client : void 0;
+}
 function isPgliteDatabase(db) {
-  return isPgliteClient(db.$client);
+  return getPgliteClient(db) !== void 0;
 }
 function transactionSession(carrier) {
   return carrier.session ?? carrier._?.session;
@@ -50,7 +53,7 @@ var DEFAULT_POSTGRES_STATEMENT_CACHE_MAX = 256;
 var STATEMENT_NAME_CACHE = /* @__PURE__ */ new Map();
 var nextStatementId = 0;
 function statementNameFor(sqlText, cacheMax) {
-  return chunkH7VE3FL4_cjs.getOrCreateLru(STATEMENT_NAME_CACHE, sqlText, cacheMax, () => {
+  return chunkMUK4BU7K_cjs.getOrCreateLru(STATEMENT_NAME_CACHE, sqlText, cacheMax, () => {
     const name = `tg_${nextStatementId}`;
     nextStatementId += 1;
     return name;
@@ -164,7 +167,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
     options.useTransactionClient ?? false
   );
   function compile(query) {
-    return chunkOOA273IJ_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
+    return chunkU5SON7R2_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
   }
   function assertCompiledWithinBindParameterLimit(compiledQuery) {
     assertWithinBindParameterLimit(
@@ -179,7 +182,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
         assertCompiledWithinBindParameterLimit(compile(query));
         return executeDrizzleQuery(
           db,
-          chunkU5W4LKZV_cjs.isSqlFragment(query) ? chunkOOA273IJ_cjs.toDrizzleSql(query, "postgres") : query
+          chunkVCRRKBLN_cjs.isSqlFragment(query) ? chunkU5SON7R2_cjs.toDrizzleSql(query, "postgres") : query
         );
       }
     };
@@ -198,7 +201,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
     async execute(query) {
       const compiled = compile(query);
       assertCompiledWithinBindParameterLimit(compiled);
-      if (chunkU5W4LKZV_cjs.isSqlFragment(query) && chunkU5W4LKZV_cjs.shouldForceCustomPlan(query)) {
+      if (chunkVCRRKBLN_cjs.isSqlFragment(query) && chunkVCRRKBLN_cjs.shouldForceCustomPlan(query)) {
         const result = await pgQueryClient.queryUnnamed(
           compiled.sql,
           compiled.params
@@ -221,7 +224,7 @@ function assertWithinBindParameterLimit(parameterCount, maxBindParameters) {
   if (maxBindParameters === void 0 || parameterCount <= maxBindParameters) {
     return;
   }
-  throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+  throw new chunkNI72YOJB_cjs.ConfigurationError(
     `PostgreSQL statement uses ${parameterCount} bound parameters, exceeding this backend's limit of ${maxBindParameters}.`,
     {
       capability: "maxBindParameters",
@@ -242,7 +245,7 @@ function createStatementQueue() {
   let closed = false;
   return {
     enqueue(task) {
-      if (closed) return Promise.reject(new chunkC4F7VJ5D_cjs.TransactionClosedError());
+      if (closed) return Promise.reject(new chunkNI72YOJB_cjs.TransactionClosedError());
       const result = tail.then(() => task());
       tail = result.then(ignoreOutcome, ignoreOutcome);
       return result;
@@ -307,11 +310,11 @@ function computePostgresBatchChunkSizes(maxBindParameters) {
     ),
     embeddingUpsertBatchSize: Math.max(
       1,
-      Math.floor(maxBindParameters / chunkH7VE3FL4_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
+      Math.floor(maxBindParameters / chunkMUK4BU7K_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
     ),
     findEdgesEndpointChunkSize: Math.max(
       1,
-      maxBindParameters - chunkH7VE3FL4_cjs.FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT
+      maxBindParameters - chunkMUK4BU7K_cjs.FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT
     ),
     fulltextDeleteChunkSize: Math.max(
       1,
@@ -343,23 +346,30 @@ function computePostgresBatchChunkSizes(maxBindParameters) {
     )
   };
 }
-var toNodeRow = chunkF4NHQHEZ_cjs.createNodeRowMapper(chunkF4NHQHEZ_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toEdgeRow = chunkF4NHQHEZ_cjs.createEdgeRowMapper(chunkF4NHQHEZ_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toUniqueRow = chunkF4NHQHEZ_cjs.createUniqueRowMapper(chunkF4NHQHEZ_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toSchemaVersionRow = chunkF4NHQHEZ_cjs.createSchemaVersionRowMapper(
-  chunkF4NHQHEZ_cjs.POSTGRES_ROW_MAPPER_CONFIG
+var IDENTITY_TABLE_LOGICAL_NAMES = /* @__PURE__ */ new Set([
+  "identityAssertions",
+  "recordedIdentityAssertions",
+  "identityClosure",
+  "identitySeparation"
+]);
+var toNodeRow = chunkYAAM3M2S_cjs.createNodeRowMapper(chunkYAAM3M2S_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunkYAAM3M2S_cjs.createEdgeRowMapper(chunkYAAM3M2S_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunkYAAM3M2S_cjs.createUniqueRowMapper(chunkYAAM3M2S_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunkYAAM3M2S_cjs.createSchemaVersionRowMapper(
+  chunkYAAM3M2S_cjs.POSTGRES_ROW_MAPPER_CONFIG
 );
 function buildPostgresCapabilities(fulltextStrategy, vectorStrategy) {
   return {
-    ...chunkEKFUG4G7_cjs.POSTGRES_CAPABILITIES,
-    ...vectorStrategy === void 0 ? {} : { vector: chunkJXUTCSXX_cjs.buildVectorCapabilities(vectorStrategy) },
-    fulltext: chunkJXUTCSXX_cjs.buildFulltextCapabilities(fulltextStrategy)
+    ...chunkXBYVV3MP_cjs.POSTGRES_CAPABILITIES,
+    ...vectorStrategy === void 0 ? {} : { vector: chunk4UGOKMI5_cjs.buildVectorCapabilities(vectorStrategy) },
+    fulltext: chunk4UGOKMI5_cjs.buildFulltextCapabilities(fulltextStrategy)
   };
 }
 function createPostgresBackend(db, options = {}) {
-  const tables2 = options.tables ?? chunkZ3WO6MND_cjs.tables;
-  const fulltextStrategy = options.fulltext ?? chunkJXUTCSXX_cjs.tsvectorStrategy;
-  const vectorStrategy = options.vector === false ? void 0 : options.vector ?? chunkD56XG4EI_cjs.pgvectorStrategy;
+  const serializedClient = getSerializedPostgresClient(db);
+  const tables2 = options.tables ?? chunkRMQLSPA2_cjs.tables;
+  const fulltextStrategy = options.fulltext ?? chunk4UGOKMI5_cjs.tsvectorStrategy;
+  const vectorStrategy = options.vector === false ? void 0 : options.vector ?? chunkMXJDTH5B_cjs.pgvectorStrategy;
   const iterativeScanProbe = createIterativeScanProbe();
   const baseCapabilities = buildPostgresCapabilities(
     fulltextStrategy,
@@ -372,23 +382,35 @@ function createPostgresBackend(db, options = {}) {
       supported: false
     }
   } : {};
-  const configuredMaxBindParameters = options.capabilities?.maxBindParameters ?? chunkEKFUG4G7_cjs.POSTGRES_MAX_BIND_PARAMETERS;
+  const configuredMaxBindParameters = options.capabilities?.maxBindParameters ?? chunkXBYVV3MP_cjs.POSTGRES_MAX_BIND_PARAMETERS;
   const driverBindParameterOverrides = isPgliteDatabase(db) ? {
     maxBindParameters: Math.min(
       configuredMaxBindParameters,
       PGLITE_MAX_BIND_PARAMETERS
     )
   } : {};
-  const capabilities = chunkEKFUG4G7_cjs.normalizeGraphAnalyticsCapabilities({
+  const declaredCapabilities = chunkXBYVV3MP_cjs.normalizeGraphAnalyticsCapabilities({
     ...baseCapabilities,
     ...httpOnlyOverrides,
     ...options.capabilities,
     ...driverBindParameterOverrides
   });
+  const capabilities = {
+    ...declaredCapabilities,
+    contributions: {
+      supported: true,
+      probe: true,
+      rebuild: chunkMUK4BU7K_cjs.contributionRebuildSupported(
+        fulltextStrategy,
+        tables2.fulltextTableName,
+        declaredCapabilities.transactions
+      )
+    }
+  };
   const adapterOptions = {
     ...options.prepareStatements === void 0 ? {} : { prepareStatements: options.prepareStatements },
     ...options.preparedStatementCacheMax === void 0 ? {} : { preparedStatementCacheMax: options.preparedStatementCacheMax },
-    maxBindParameters: capabilities.maxBindParameters ?? chunkEKFUG4G7_cjs.POSTGRES_MAX_BIND_PARAMETERS
+    maxBindParameters: capabilities.maxBindParameters ?? chunkXBYVV3MP_cjs.POSTGRES_MAX_BIND_PARAMETERS
   };
   const executionAdapter = createPostgresExecutionAdapter(db, adapterOptions);
   const tableNames = {
@@ -398,6 +420,10 @@ function createPostgresBackend(db, options = {}) {
     recordedEdges: drizzleOrm.getTableName(tables2.recordedEdges),
     recordedClock: drizzleOrm.getTableName(tables2.recordedClock),
     revisionOrigins: drizzleOrm.getTableName(tables2.revisionOrigins),
+    identityAssertions: drizzleOrm.getTableName(tables2.identityAssertions),
+    recordedIdentityAssertions: drizzleOrm.getTableName(tables2.recordedIdentityAssertions),
+    identityClosure: drizzleOrm.getTableName(tables2.identityClosure),
+    identitySeparation: drizzleOrm.getTableName(tables2.identitySeparation),
     fulltext: tables2.fulltextTableName,
     uniques: drizzleOrm.getTableName(tables2.uniques)
   };
@@ -407,21 +433,25 @@ function createPostgresBackend(db, options = {}) {
     drizzleOrm.getTableName(tables2.uniques),
     tableNames.fulltext
   ].map(
-    (name) => chunkOOA273IJ_cjs.toDrizzleSql(
-      chunkU5W4LKZV_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkU5W4LKZV_cjs.sql.identifier(name)}`,
+    (name) => chunkU5SON7R2_cjs.toDrizzleSql(
+      chunkVCRRKBLN_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkVCRRKBLN_cjs.sql.identifier(name)}`,
       "postgres"
     )
   );
-  const recordedAnalyzeTables = [
+  const guardedAnalyzeTables = [
     tableNames.recordedNodes,
     tableNames.recordedEdges,
-    tableNames.recordedClock
+    tableNames.recordedClock,
+    tableNames.recordedIdentityAssertions,
+    tableNames.identityAssertions,
+    tableNames.identityClosure,
+    tableNames.identitySeparation
   ];
-  const operationStrategy = chunkH7VE3FL4_cjs.createPostgresOperationStrategy(
+  const operationStrategy = chunkMUK4BU7K_cjs.createPostgresOperationStrategy(
     tables2,
     fulltextStrategy
   );
-  const recordedTableExists = chunkH7VE3FL4_cjs.createCachedTableExistence(
+  const guardedTableExists = chunkMUK4BU7K_cjs.createCachedTableExistence(
     async (tableName) => {
       const rows = await executionAdapter.execute(
         operationStrategy.buildTableExists(tableName)
@@ -431,18 +461,32 @@ function createPostgresBackend(db, options = {}) {
     { cacheExisting: false }
   );
   const matTable = tables2.contributionMaterializations;
-  async function ensureTableWithConcurrentCreateRetry(table) {
-    const statement = drizzleOrm.sql.raw(chunkZ3WO6MND_cjs.generatePgCreateTableSQL(table));
+  async function executeConcurrentCreateDdl(ddl) {
+    const statement = drizzleOrm.sql.raw(ddl);
     try {
       await db.execute(statement);
     } catch (error) {
-      if (!chunkJQXSZHF2_cjs.isPostgresUniqueViolationError(error)) throw error;
+      if (!chunkBSFJMMV3_cjs.isPostgresConcurrentDdlRaceError(error)) throw error;
       await db.execute(statement);
     }
   }
+  async function ensureTableWithConcurrentCreateRetry(table) {
+    await executeConcurrentCreateDdl(chunkRMQLSPA2_cjs.generatePgCreateTableSQL(table));
+  }
   async function ensureContributionMaterializationsTableImpl() {
     await ensureTableWithConcurrentCreateRetry(matTable);
   }
+  function identityContributionsFor(identityTableNames) {
+    const identityTables = chunkRMQLSPA2_cjs.createPostgresTables({
+      identityAssertions: identityTableNames.identityAssertions,
+      recordedIdentityAssertions: identityTableNames.recordedIdentityAssertions,
+      identityClosure: identityTableNames.identityClosure,
+      identitySeparation: identityTableNames.identitySeparation
+    });
+    return chunkRMQLSPA2_cjs.postgresContributions(identityTables, fulltextStrategy).filter(
+      (contribution) => IDENTITY_TABLE_LOGICAL_NAMES.has(contribution.logicalName)
+    );
+  }
   async function getContributionMaterializationRow(identity) {
     const rows = await db.select().from(matTable).where(
       drizzleOrm.and(
@@ -454,25 +498,25 @@ function createPostgresBackend(db, options = {}) {
     );
     const row = rows[0];
     if (row === void 0) return void 0;
-    return chunkH7VE3FL4_cjs.mapContributionMaterializationRow(
+    return chunkMUK4BU7K_cjs.mapContributionMaterializationRow(
       row,
-      chunkH7VE3FL4_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
+      chunkMUK4BU7K_cjs.POSTGRES_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) => chunkH7VE3FL4_cjs.mapContributionMaterializationRow(
+      (row) => chunkMUK4BU7K_cjs.mapContributionMaterializationRow(
         row,
-        chunkH7VE3FL4_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
+        chunkMUK4BU7K_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
       )
     );
   }
   async function recordContributionMaterializationRow(params) {
     await db.insert(matTable).values(
-      chunkH7VE3FL4_cjs.buildContributionInsertValues(
+      chunkMUK4BU7K_cjs.buildContributionInsertValues(
         params,
-        chunkH7VE3FL4_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.encode
+        chunkMUK4BU7K_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.encode
       )
     ).onConflictDoUpdate({
       target: [
@@ -481,7 +525,7 @@ function createPostgresBackend(db, options = {}) {
         matTable.owner,
         matTable.tableName
       ],
-      set: chunkH7VE3FL4_cjs.buildContributionOnConflictSet(
+      set: chunkMUK4BU7K_cjs.buildContributionOnConflictSet(
         matTable.materializedAt,
         params.materializedAt
       )
@@ -501,21 +545,32 @@ function createPostgresBackend(db, options = {}) {
     const rows = await executionAdapter.execute(
       operationStrategy.buildTableExists(tableName)
     );
-    return chunkH7VE3FL4_cjs.tableExistsFromRow(rows[0]);
+    return chunkMUK4BU7K_cjs.tableExistsFromRow(rows[0]);
   }
-  const contributionMaterializer = chunkH7VE3FL4_cjs.createContributionMaterializer({
+  const contributionMaterializer = chunkMUK4BU7K_cjs.createContributionMaterializer({
     dialect: "postgres",
     fulltextStrategy,
     fulltextTableName: tables2.fulltextTableName,
     vectorStrategy,
+    // Contribution DDL is `CREATE ... IF NOT EXISTS` reached from every
+    // booting replica, so it carries the same concurrent-create retry the
+    // other create sites use. Without it the loser's 23505 is recorded as
+    // `lastError` on the marker row and reported as a failed materialization,
+    // when the table it wanted is in fact present.
     execDdl: async (statement) => {
-      await db.execute(drizzleOrm.sql.raw(statement));
+      await executeConcurrentCreateDdl(statement);
     },
     ensureMarkerTable: ensureContributionMaterializationsTableImpl,
     getMarkers: getContributionMaterializationRows,
     recordMarker: recordContributionMaterializationRow,
     deleteMarker: deleteContributionMaterializationRow,
-    tableExists: contributionTableExists
+    tableExists: contributionTableExists,
+    // Withheld rather than wired-and-throwing when the driver cannot hold
+    // a session: the rebuild must refuse with its own typed error naming
+    // the absent fence, matching `capabilities.contributions.rebuild`.
+    ...capabilities.transactions ? {
+      schemaWriteTransaction: (graphId, fn) => runSchemaWriteTransaction(graphId, (target) => fn(target))
+    } : {}
   });
   const operations = createPostgresOperationBackend({
     db,
@@ -533,7 +588,7 @@ function createPostgresBackend(db, options = {}) {
   });
   function runSchemaWriteTransaction(graphId, fn) {
     if (!capabilities.transactions) {
-      throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+      throw new chunkNI72YOJB_cjs.ConfigurationError(
         "Schema writes and removal cleanup require atomic transactions, but this Postgres backend does not provide them. The drizzle-orm/neon-http driver communicates over HTTP and cannot hold a session across statements; use drizzle-orm/neon-serverless (websocket) for transactional writes.",
         {
           backend: "postgres",
@@ -584,7 +639,7 @@ function createPostgresBackend(db, options = {}) {
       schemaVersionsTable: tables2.schemaVersions
     });
     return {
-      backend: chunkH7VE3FL4_cjs.gateFulltext(
+      backend: chunkMUK4BU7K_cjs.gateFulltext(
         backend2,
         contributionMaterializer.assertInitialized
       ),
@@ -597,7 +652,7 @@ function createPostgresBackend(db, options = {}) {
       async trustedImport(fn, options_) {
         return backend.transactionWithNative(async (tx, rawSql) => {
           if (options_?.schemaWrite !== void 0) {
-            await chunk764JHTLT_cjs.requireDefined(tx.lockSchemaVersionForWrite)({
+            await chunkN66HCGCY_cjs.requireDefined(tx.lockSchemaVersionForWrite)({
               ...options_.schemaWrite
             });
           }
@@ -607,46 +662,68 @@ function createPostgresBackend(db, options = {}) {
           );
           const executeCompiled = trustedExecutionAdapter.executeCompiled;
           if (executeCompiled === void 0) {
-            throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+            throw new chunkNI72YOJB_cjs.ConfigurationError(
               "Trusted import could not bind raw execution to the PostgreSQL transaction.",
               { capability: "trustedImport", dialect: "postgres" }
             );
           }
-          const trustedTx = chunkEKFUG4G7_cjs.createBackendOverlay(tx, {
+          const trustedTx = chunkXBYVV3MP_cjs.createBackendOverlay(tx, {
             executeRaw(sqlText, params) {
               return executeCompiled({ params, sql: sqlText });
             }
           });
-          await chunkH7VE3FL4_cjs.lockPostgresTrustedImportTables(trustedTx, tableNames);
-          await chunkH7VE3FL4_cjs.assertTrustedImportDatabaseEmpty(trustedTx, tableNames);
-          const indexDefinitions = await chunkH7VE3FL4_cjs.suspendPostgresSecondaryIndexes(
+          await chunkMUK4BU7K_cjs.lockPostgresTrustedImportTables(trustedTx, tableNames);
+          await chunkMUK4BU7K_cjs.assertTrustedImportDatabaseEmpty(trustedTx, tableNames);
+          const indexDefinitions = await chunkMUK4BU7K_cjs.suspendPostgresSecondaryIndexes(
             trustedTx,
             tableNames
           );
           const result = await fn(
-            chunkH7VE3FL4_cjs.createPostgresTrustedImportSession(trustedTx, tableNames)
+            chunkMUK4BU7K_cjs.createPostgresTrustedImportSession(trustedTx, tableNames)
           );
-          await chunkH7VE3FL4_cjs.restoreSecondaryIndexes(trustedTx, indexDefinitions);
-          await chunkH7VE3FL4_cjs.analyzeImportedTables(trustedTx, tableNames);
+          await chunkMUK4BU7K_cjs.restoreSecondaryIndexes(trustedTx, indexDefinitions);
+          await chunkMUK4BU7K_cjs.analyzeImportedTables(trustedTx, tableNames);
           return result;
         });
       }
     } : {},
     async bootstrapTables() {
-      const statements = chunkZ3WO6MND_cjs.generatePostgresDDL(tables2, fulltextStrategy);
+      const statements = chunkRMQLSPA2_cjs.generatePostgresDDL(tables2, fulltextStrategy);
       for (const statement of statements) {
-        await db.execute(drizzleOrm.sql.raw(statement));
+        await executeConcurrentCreateDdl(statement);
       }
     },
     async ensureRevisionOriginsTable() {
       await ensureTableWithConcurrentCreateRetry(tables2.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 executeConcurrentCreateDdl(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` loudly
     // rather than self-healing on a read/write path (#135). Shared
     // verbatim with the tx-scoped gate via `gateFulltextMethods`.
-    ...chunkH7VE3FL4_cjs.gateFulltextMethods(
+    ...chunkMUK4BU7K_cjs.gateFulltextMethods(
       operations,
       contributionMaterializer.assertInitialized
     ),
@@ -656,15 +733,11 @@ function createPostgresBackend(db, options = {}) {
     async ensureIndexMaterializationsTable() {
       await ensureTableWithConcurrentCreateRetry(tables2.indexMaterializations);
       const tableName = drizzleOrm.getTableName(tables2.indexMaterializations);
-      await db.execute(
-        drizzleOrm.sql.raw(
-          `ALTER TABLE "${tableName}" ADD COLUMN IF NOT EXISTS "building_since" timestamptz;`
-        )
+      await executeConcurrentCreateDdl(
+        `ALTER TABLE "${tableName}" ADD COLUMN IF NOT EXISTS "building_since" timestamptz;`
       );
-      await db.execute(
-        drizzleOrm.sql.raw(
-          `ALTER TABLE "${tableName}" ADD COLUMN IF NOT EXISTS "claim_token" text;`
-        )
+      await executeConcurrentCreateDdl(
+        `ALTER TABLE "${tableName}" ADD COLUMN IF NOT EXISTS "claim_token" text;`
       );
     },
     async claimIndexMaterialization(params) {
@@ -705,26 +778,26 @@ function createPostgresBackend(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 chunkH7VE3FL4_cjs.mapMaterializationRow(row, chunkH7VE3FL4_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode);
+      return chunkMUK4BU7K_cjs.mapMaterializationRow(row, chunkMUK4BU7K_cjs.POSTGRES_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) => chunkH7VE3FL4_cjs.mapMaterializationRow(row, chunkH7VE3FL4_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode)
+        (row) => chunkMUK4BU7K_cjs.mapMaterializationRow(row, chunkMUK4BU7K_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode)
       );
     },
     async recordIndexMaterialization(params) {
       const t = tables2.indexMaterializations;
       await db.insert(t).values(
-        chunkH7VE3FL4_cjs.buildMaterializationInsertValues(
+        chunkMUK4BU7K_cjs.buildMaterializationInsertValues(
           params,
-          chunkH7VE3FL4_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.encode
+          chunkMUK4BU7K_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: t.indexName,
-        set: chunkH7VE3FL4_cjs.buildMaterializationOnConflictSet(params.materializedAt)
+        set: chunkMUK4BU7K_cjs.buildMaterializationOnConflictSet(params.materializedAt)
       });
     },
     async ensureContributionMaterializationsTable() {
@@ -746,26 +819,26 @@ function createPostgresBackend(db, options = {}) {
       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) => chunkH7VE3FL4_cjs.mapKindRemovalRow(row, chunkH7VE3FL4_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkMUK4BU7K_cjs.mapKindRemovalRow(row, chunkMUK4BU7K_cjs.POSTGRES_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) => chunkH7VE3FL4_cjs.mapKindRemovalRow(row, chunkH7VE3FL4_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkMUK4BU7K_cjs.mapKindRemovalRow(row, chunkMUK4BU7K_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
       );
     },
     async recordKindRemoval(params) {
       const t = tables2.kindRemovals;
       await db.insert(t).values(
-        chunkH7VE3FL4_cjs.buildKindRemovalInsertValues(
+        chunkMUK4BU7K_cjs.buildKindRemovalInsertValues(
           params,
-          chunkH7VE3FL4_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.encode
+          chunkMUK4BU7K_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: [t.graphId, t.kindName, t.entity, t.schemaVersion],
-        set: chunkH7VE3FL4_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
+        set: chunkMUK4BU7K_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
       });
     },
     async ensureReconciliationMarkersTable() {
@@ -788,6 +861,16 @@ function createPostgresBackend(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 under `vector: false`,
     // mirroring the embedding/search methods), so a no-vector backend
@@ -826,16 +909,16 @@ function createPostgresBackend(db, options = {}) {
         await db.execute(statement);
       }
       const tablePresence = await Promise.all(
-        recordedAnalyzeTables.map(async (tableName) => ({
+        guardedAnalyzeTables.map(async (tableName) => ({
           tableName,
-          exists: await recordedTableExists(tableName)
+          exists: await guardedTableExists(tableName)
         }))
       );
-      const presentRecordedTables = tablePresence.filter((entry) => entry.exists).map((entry) => entry.tableName);
-      for (const tableName of presentRecordedTables) {
+      const presentGuardedTables = tablePresence.filter((entry) => entry.exists).map((entry) => entry.tableName);
+      for (const tableName of presentGuardedTables) {
         await db.execute(
-          chunkOOA273IJ_cjs.toDrizzleSql(
-            chunkU5W4LKZV_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkU5W4LKZV_cjs.sql.identifier(tableName)}`,
+          chunkU5SON7R2_cjs.toDrizzleSql(
+            chunkVCRRKBLN_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkVCRRKBLN_cjs.sql.identifier(tableName)}`,
             "postgres"
           )
         );
@@ -850,9 +933,15 @@ function createPostgresBackend(db, options = {}) {
     async commitSchemaVersionIfKindsEmpty(params, probes) {
       return runSchemaWriteTransaction(
         params.graphId,
-        (target) => chunkH7VE3FL4_cjs.commitSchemaVersionIfKindsEmpty(target, params, probes)
+        (target) => chunkMUK4BU7K_cjs.commitSchemaVersionIfKindsEmpty(target, params, probes)
       );
     },
+    async commitSchemaVersionWithPreflight(params, preflight) {
+      return runSchemaWriteTransaction(params.graphId, async (target) => {
+        await preflight(target);
+        return target.commitSchemaVersion(params);
+      });
+    },
     async setActiveVersion(params) {
       await runSchemaWriteTransaction(
         params.graphId,
@@ -866,9 +955,9 @@ function createPostgresBackend(db, options = {}) {
       return backend.transactionWithNative((tx) => fn(tx), options2);
     },
     async transactionWithNative(fn, options2) {
-      const temporaryWrites = options2?.temporaryWrites === chunkEKFUG4G7_cjs.INTERNAL_TEMPORARY_WRITES;
+      const temporaryWrites = options2?.temporaryWrites === chunkXBYVV3MP_cjs.INTERNAL_TEMPORARY_WRITES;
       if (temporaryWrites && options2.accessMode !== "read_only") {
-        throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+        throw new chunkNI72YOJB_cjs.ConfigurationError(
           "Temporary-write transactions must be semantically read-only.",
           { dialect: "postgres" }
         );
@@ -878,7 +967,7 @@ function createPostgresBackend(db, options = {}) {
           isolationLevel: options2.isolationLevel.replace("_", " ")
         },
         ...options2.accessMode === void 0 && !temporaryWrites ? {} : {
-          accessMode: temporaryWrites ? "read write" : chunk764JHTLT_cjs.requireDefined(options2.accessMode).replace("_", " ")
+          accessMode: temporaryWrites ? "read write" : chunkN66HCGCY_cjs.requireDefined(options2.accessMode).replace("_", " ")
         }
       } : void 0;
       return db.transaction(async (tx) => {
@@ -892,7 +981,7 @@ function createPostgresBackend(db, options = {}) {
     },
     adoptTransaction(externalTx) {
       if (!capabilities.transactions) {
-        throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+        throw new chunkNI72YOJB_cjs.ConfigurationError(
           "Cross-store atomicity is unavailable on this Postgres backend: its driver does not support transactions (drizzle-orm/neon-http, Cloudflare D1). Adopting an external transaction here would let the caller's relational write commit with no way to roll back the graph write. Use a node-postgres or neon-serverless (Pool/WebSocket) connection for cross-store transactions.",
           {
             backend: "postgres",
@@ -901,7 +990,7 @@ function createPostgresBackend(db, options = {}) {
           }
         );
       }
-      chunkH7VE3FL4_cjs.assertAdoptedDialect(
+      chunkMUK4BU7K_cjs.assertAdoptedDialect(
         externalTx,
         pgCore.PgTransaction,
         "postgres"
@@ -911,8 +1000,42 @@ function createPostgresBackend(db, options = {}) {
     async close() {
     }
   };
+  if (serializedClient !== void 0) {
+    chunkXBYVV3MP_cjs.markSerializedTransactionResource(backend, serializedClient);
+  }
   return backend;
 }
+function getSerializedPostgresClient(db) {
+  const pgliteClient = getPgliteClient(db);
+  if (pgliteClient !== void 0) return pgliteClient;
+  const client = db.$client;
+  if (typeof client === "function") {
+    return isSingleConnectionCallablePgClient(client) ? client : void 0;
+  }
+  if (typeof client !== "object" || client === null) return void 0;
+  const candidate = client;
+  if (!hasFunctionProperty(candidate, "query")) return void 0;
+  if (isSingleConnectionPgPool(candidate)) return client;
+  return isBarePgClient(candidate) ? client : void 0;
+}
+function isSingleConnectionPgPool(candidate) {
+  const options = candidate["options"];
+  if (typeof options !== "object" || options === null) return false;
+  return options["max"] === 1;
+}
+function isSingleConnectionCallablePgClient(client) {
+  if (client === void 0 || client === null) return false;
+  const options = client["options"];
+  if (!isPostgresJsClient(client)) return false;
+  if (typeof options !== "object" || options === null) return false;
+  return options["max"] === 1;
+}
+function isBarePgClient(candidate) {
+  if (candidate["options"] !== void 0 || candidate["totalCount"] !== void 0 || candidate["idleCount"] !== void 0 || candidate["waitingCount"] !== void 0) {
+    return false;
+  }
+  return hasFunctionProperty(candidate, "connect") && hasFunctionProperty(candidate, "end") && hasFunctionProperty(candidate, "escapeIdentifier");
+}
 function createIterativeScanProbe() {
   let probe;
   let warned = false;
@@ -971,31 +1094,24 @@ function createPostgresOperationBackend(options) {
   async function execRun(query) {
     await executionAdapter.execute(query);
   }
-  let efSearchUnsupportedWarned = false;
-  function warnEfSearchUnsupported() {
-    if (efSearchUnsupportedWarned) return;
-    efSearchUnsupportedWarned = true;
-    if (typeof console === "undefined" || typeof console.warn !== "function") {
-      return;
-    }
-    console.warn(
-      "[typegraph] efSearch (hnsw.ef_search override) was ignored: this Postgres backend has transactions disabled (e.g. drizzle-orm/neon-http), and SET LOCAL needs a transaction to scope the override. Use a transactional driver (node-postgres / neon-serverless / postgres-js) to apply efSearch."
-    );
-  }
   function pgvectorIterativeScanSupported() {
     return iterativeScanProbe.isSupported(execAll);
   }
   async function vectorSearchGucOverrides(params) {
     const overrides = [];
-    if (params.efSearch !== void 0) {
-      if (capabilities.transactions) {
-        overrides.push({
-          name: "hnsw.ef_search",
-          value: String(params.efSearch)
-        });
-      } else {
-        warnEfSearchUnsupported();
-      }
+    const efSearchParameter = chunk4UGOKMI5_cjs.resolveEfSearchOverride({
+      efSearch: params.efSearch,
+      indexType: params.indexType,
+      tuning: chunk4UGOKMI5_cjs.vectorSearchFrontierTuning(vectorStrategy),
+      transactions: capabilities.transactions,
+      dialect: "PostgreSQL",
+      engine: vectorStrategy?.name ?? "this backend"
+    });
+    if (efSearchParameter !== void 0) {
+      overrides.push({
+        name: efSearchParameter,
+        value: String(params.efSearch)
+      });
     }
     if (params.indexType === "hnsw" && capabilities.transactions && await pgvectorIterativeScanSupported()) {
       overrides.push({ name: "hnsw.iterative_scan", value: "strict_order" });
@@ -1011,7 +1127,7 @@ function createPostgresOperationBackend(options) {
   async function runVectorSearchGucGroup(overrides, query) {
     const runExclusive = executionAdapter.runExclusive;
     if (runExclusive === void 0) {
-      throw new chunkC4F7VJ5D_cjs.CompilerInvariantError(
+      throw new chunkNI72YOJB_cjs.CompilerInvariantError(
         "A transaction-scoped Postgres backend must expose runExclusive; its execution adapter was not wrapped by createSerialExecutionAdapter."
       );
     }
@@ -1055,17 +1171,17 @@ function createPostgresOperationBackend(options) {
     });
   }
   const batchConfig = computePostgresBatchChunkSizes(
-    capabilities.maxBindParameters ?? chunkEKFUG4G7_cjs.POSTGRES_MAX_BIND_PARAMETERS
+    capabilities.maxBindParameters ?? chunkXBYVV3MP_cjs.POSTGRES_MAX_BIND_PARAMETERS
   );
-  const commonBackend = chunkH7VE3FL4_cjs.createCommonOperationBackend({
+  const commonBackend = chunkMUK4BU7K_cjs.createCommonOperationBackend({
     batchConfig,
     execution: {
       execAll,
       execGet,
       execRun
     },
-    nowIso: chunkF4NHQHEZ_cjs.nowIso,
-    maxBindParameters: capabilities.maxBindParameters ?? chunkEKFUG4G7_cjs.POSTGRES_MAX_BIND_PARAMETERS,
+    nowIso: chunkYAAM3M2S_cjs.nowIso,
+    maxBindParameters: capabilities.maxBindParameters ?? chunkXBYVV3MP_cjs.POSTGRES_MAX_BIND_PARAMETERS,
     operationStrategy,
     rowMappers: {
       toEdgeRow,
@@ -1083,28 +1199,28 @@ function createPostgresOperationBackend(options) {
   };
   const vectorEmbeddingMethods = vectorStrategy === void 0 ? {} : {
     async upsertEmbedding(params) {
-      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
+      const slot = chunkMUK4BU7K_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
-      const statements = vectorStrategy.buildUpsert(slot, params, chunkF4NHQHEZ_cjs.nowIso());
+      const statements = vectorStrategy.buildUpsert(slot, params, chunkYAAM3M2S_cjs.nowIso());
       try {
         for (const statement of statements) {
           await execRun(statement);
         }
       } catch (error) {
-        throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, params);
+        throw chunkMUK4BU7K_cjs.mapVectorWriteError(error, params);
       }
     },
     async upsertEmbeddingBatch(params) {
       if (params.rows.length === 0) return;
-      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
+      const slot = chunkMUK4BU7K_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const rowsById = new Map(
         params.rows.map((row) => [row.nodeId, row])
       );
       const rows = [...rowsById.values()];
-      const timestamp = chunkF4NHQHEZ_cjs.nowIso();
+      const timestamp = chunkYAAM3M2S_cjs.nowIso();
       try {
-        for (const chunk2 of chunkZDH3DX3C_cjs.chunk(
+        for (const chunk2 of chunkBSFJMMV3_cjs.chunk(
           rows,
           batchConfig.embeddingUpsertBatchSize
         )) {
@@ -1133,11 +1249,11 @@ function createPostgresOperationBackend(options) {
           }
         }
       } catch (error) {
-        throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, params);
+        throw chunkMUK4BU7K_cjs.mapVectorWriteError(error, params);
       }
     },
     async deleteEmbedding(params) {
-      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
+      const slot = chunkMUK4BU7K_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const statements = vectorStrategy.buildDelete(slot, params);
       for (const statement of statements) {
@@ -1146,9 +1262,9 @@ function createPostgresOperationBackend(options) {
     },
     async deleteEmbeddingBatch(params) {
       if (params.nodeIds.length === 0) return;
-      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
+      const slot = chunkMUK4BU7K_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
-      for (const nodeIds of chunkZDH3DX3C_cjs.chunk(
+      for (const nodeIds of chunkBSFJMMV3_cjs.chunk(
         [...new Set(params.nodeIds)],
         batchConfig.embeddingUpsertBatchSize
       )) {
@@ -1160,19 +1276,19 @@ function createPostgresOperationBackend(options) {
       }
     },
     async vectorSearch(params) {
-      chunkJXUTCSXX_cjs.assertVectorSearchLimit(params.limit);
-      chunkD56XG4EI_cjs.assertPgvectorEfSearch(params.efSearch);
-      const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams(params);
+      chunk4UGOKMI5_cjs.assertVectorSearchLimit(params.limit);
+      chunkMXJDTH5B_cjs.assertPgvectorEfSearch(params.efSearch);
+      const slot = chunkMUK4BU7K_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 ?? chunkH7VE3FL4_cjs.buildLiveNodeCandidates(
+        params.candidates ?? chunkMUK4BU7K_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkF4NHQHEZ_cjs.nowIso()
+          chunkYAAM3M2S_cjs.nowIso()
         )
       );
       const gucOverrides = await vectorSearchGucOverrides(params);
@@ -1180,7 +1296,7 @@ function createPostgresOperationBackend(options) {
       try {
         rows = await runVectorSearch(gucOverrides, query);
       } catch (error) {
-        throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, params);
+        throw chunkMUK4BU7K_cjs.mapVectorWriteError(error, params);
       }
       return rows.map((row) => ({
         nodeId: row.node_id,
@@ -1192,10 +1308,10 @@ function createPostgresOperationBackend(options) {
     // multi-statement fallback by simply not exposing the member.
     ...capabilities.windowFunctions ? {
       async hybridSearch(params) {
-        chunkJXUTCSXX_cjs.assertVectorSearchLimit(params.limit);
-        chunkJXUTCSXX_cjs.assertVectorSearchLimit(params.vector.k);
-        chunkD56XG4EI_cjs.assertPgvectorEfSearch(params.vector.efSearch);
-        const slot = chunkH7VE3FL4_cjs.vectorSlotFromParams({
+        chunk4UGOKMI5_cjs.assertVectorSearchLimit(params.limit);
+        chunk4UGOKMI5_cjs.assertVectorSearchLimit(params.vector.k);
+        chunkMXJDTH5B_cjs.assertPgvectorEfSearch(params.vector.efSearch);
+        const slot = chunkMUK4BU7K_cjs.vectorSlotFromParams({
           graphId: params.graphId,
           nodeKind: params.nodeKind,
           fieldPath: params.vector.fieldPath,
@@ -1203,11 +1319,11 @@ function createPostgresOperationBackend(options) {
           metric: params.vector.metric,
           indexType: params.vector.indexType
         });
-        const candidates = params.candidates ?? chunkH7VE3FL4_cjs.buildLiveNodeCandidates(
+        const candidates = params.candidates ?? chunkMUK4BU7K_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkF4NHQHEZ_cjs.nowIso()
+          chunkYAAM3M2S_cjs.nowIso()
         );
         const vectorParams = {
           graphId: params.graphId,
@@ -1223,11 +1339,11 @@ function createPostgresOperationBackend(options) {
         const vectorSql = vectorStrategy.buildSearch(
           slot,
           vectorParams,
-          chunkU5W4LKZV_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
+          chunkVCRRKBLN_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
         );
         const statement = operationStrategy.buildHybridSearch(
           { ...params, candidates },
-          chunkOOA273IJ_cjs.toDrizzleSql(vectorSql, "postgres"),
+          chunkU5SON7R2_cjs.toDrizzleSql(vectorSql, "postgres"),
           params.vector.metric === "cosine"
         );
         const gucOverrides = await vectorSearchGucOverrides({
@@ -1241,16 +1357,42 @@ function createPostgresOperationBackend(options) {
             statement
           );
         } catch (error) {
-          throw chunkH7VE3FL4_cjs.mapVectorWriteError(error, vectorParams);
+          throw chunkMUK4BU7K_cjs.mapVectorWriteError(error, vectorParams);
         }
-        return raw.map((row) => chunkH7VE3FL4_cjs.mapHybridSearchRow(row, toNodeRow));
+        return raw.map((row) => chunkMUK4BU7K_cjs.mapHybridSearchRow(row, toNodeRow));
       }
     } : {}
   };
+  async function lockActiveSchemaVersion(graphId) {
+    const active = await execGet(drizzleOrm.sql`
+      SELECT ${schemaVersionsTable.version} AS version
+      FROM ${schemaVersionsTable}
+      WHERE ${schemaVersionsTable.graphId} = ${graphId}
+        AND ${schemaVersionsTable.isActive} = TRUE
+      FOR SHARE
+    `);
+    return active?.version;
+  }
   const operationBackend = {
     ...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)) {
@@ -1272,7 +1414,7 @@ function createPostgresOperationBackend(options) {
     tableNames,
     async lockSchemaVersionForWrite(params) {
       if (!transactionScoped) {
-        throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+        throw new chunkNI72YOJB_cjs.ConfigurationError(
           "The schema write fence requires an explicit PostgreSQL transaction.",
           {
             code: "SCHEMA_WRITE_FENCE_TRANSACTION_REQUIRED",
@@ -1280,23 +1422,26 @@ function createPostgresOperationBackend(options) {
           }
         );
       }
-      const active = await execGet(drizzleOrm.sql`
-        SELECT ${schemaVersionsTable.version} AS version
-        FROM ${schemaVersionsTable}
-        WHERE ${schemaVersionsTable.graphId} = ${params.graphId}
-          AND ${schemaVersionsTable.isActive} = TRUE
-        FOR SHARE
-      `);
-      chunkH7VE3FL4_cjs.assertActiveSchemaVersion(
-        params.graphId,
-        params.expectedVersion,
-        active?.version ?? 0
-      );
+      const locked = await lockActiveSchemaVersion(params.graphId);
+      if (locked !== void 0) {
+        chunkMUK4BU7K_cjs.assertActiveSchemaVersion(
+          params.graphId,
+          params.expectedVersion,
+          locked
+        );
+        return;
+      }
+      const settled = await commonBackend.getActiveSchema(params.graphId);
+      throw new chunkNI72YOJB_cjs.StaleVersionError({
+        graphId: params.graphId,
+        expected: params.expectedVersion,
+        actual: settled?.version ?? 0
+      });
     },
     // === Vector Index Operations ===
     async createVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkH7VE3FL4_cjs.vectorSlotFromCreateIndexParams(params);
+      const slot = chunkMUK4BU7K_cjs.vectorSlotFromCreateIndexParams(params);
       await contributionMaterializer.ensureVectorSlot(slot);
       const indexStatement = vectorStrategy.buildCreateIndex?.(slot, {
         concurrent: params.concurrent === true
@@ -1305,12 +1450,12 @@ function createPostgresOperationBackend(options) {
         try {
           await execRun(indexStatement);
         } catch (error) {
-          if (!chunkJQXSZHF2_cjs.isInsufficientResourcesError(error)) throw error;
+          if (!chunkBSFJMMV3_cjs.isInsufficientResourcesError(error)) throw error;
           const dropStatement = vectorStrategy.buildDropIndex?.(slot);
           if (dropStatement !== void 0) {
             await execRun(dropStatement);
           }
-          const table = chunkU5W4LKZV_cjs.sql.identifier(
+          const table = chunkVCRRKBLN_cjs.sql.identifier(
             vectorStrategy.tableName(
               slot.graphId,
               slot.nodeKind,
@@ -1318,13 +1463,13 @@ function createPostgresOperationBackend(options) {
             )
           );
           await execRun(
-            chunkU5W4LKZV_cjs.sql`ALTER TABLE ${table} SET (parallel_workers = 0)`
+            chunkVCRRKBLN_cjs.sql`ALTER TABLE ${table} SET (parallel_workers = 0)`
           );
           try {
             await execRun(indexStatement);
           } finally {
             await execRun(
-              chunkU5W4LKZV_cjs.sql`ALTER TABLE ${table} RESET (parallel_workers)`
+              chunkVCRRKBLN_cjs.sql`ALTER TABLE ${table} RESET (parallel_workers)`
             );
           }
         }
@@ -1332,7 +1477,7 @@ function createPostgresOperationBackend(options) {
     },
     // === Fulltext Operations ===
     async upsertFulltext(params) {
-      const timestamp = chunkF4NHQHEZ_cjs.nowIso();
+      const timestamp = chunkYAAM3M2S_cjs.nowIso();
       const statements = operationStrategy.buildUpsertFulltext(
         params,
         timestamp
@@ -1349,8 +1494,8 @@ function createPostgresOperationBackend(options) {
     },
     async upsertFulltextBatch(params) {
       if (params.rows.length === 0) return;
-      const timestamp = chunkF4NHQHEZ_cjs.nowIso();
-      for (const rows of chunkZDH3DX3C_cjs.chunk(
+      const timestamp = chunkYAAM3M2S_cjs.nowIso();
+      for (const rows of chunkBSFJMMV3_cjs.chunk(
         params.rows,
         batchConfig.fulltextUpsertBatchSize
       )) {
@@ -1365,7 +1510,7 @@ function createPostgresOperationBackend(options) {
     },
     async deleteFulltextBatch(params) {
       if (params.nodeIds.length === 0) return;
-      for (const nodeIds of chunkZDH3DX3C_cjs.chunk(
+      for (const nodeIds of chunkBSFJMMV3_cjs.chunk(
         params.nodeIds,
         batchConfig.fulltextDeleteChunkSize
       )) {
@@ -1383,25 +1528,25 @@ function createPostgresOperationBackend(options) {
       const rows = await execAll(query);
       return rows.map((row, index) => ({
         nodeId: row.node_id,
-        score: chunkF4NHQHEZ_cjs.coerceNumericScore(row.score),
+        score: chunkYAAM3M2S_cjs.coerceNumericScore(row.score),
         rank: index + 1,
         ...row.snippet === null ? {} : { snippet: row.snippet }
       }));
     },
     async dropVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkH7VE3FL4_cjs.vectorSlotFromDropIndexParams(params);
+      const slot = chunkMUK4BU7K_cjs.vectorSlotFromDropIndexParams(params);
       const dropStatement = vectorStrategy.buildDropIndex?.(slot);
       if (dropStatement === void 0) return;
       try {
         await execRun(dropStatement);
       } catch (error) {
-        if (!chunkJQXSZHF2_cjs.isMissingTableError(error)) throw error;
+        if (!chunkBSFJMMV3_cjs.isMissingTableError(error)) throw error;
       }
     },
     // === Query Execution ===
     async execute(query) {
-      const annTypes = chunkU5W4LKZV_cjs.isSqlFragment(query) ? chunkU5W4LKZV_cjs.annIndexScanTypes(query) : void 0;
+      const annTypes = chunkVCRRKBLN_cjs.isSqlFragment(query) ? chunkVCRRKBLN_cjs.annIndexScanTypes(query) : void 0;
       if (annTypes !== void 0 && vectorStrategy !== void 0) {
         const overrides = [];
         for (const indexType of annTypes) {
@@ -1442,5 +1587,5 @@ function createTransactionBackend(options) {
 }
 
 exports.createPostgresBackend = createPostgresBackend;
-//# sourceMappingURL=chunk-YDWLUT5V.cjs.map
-//# sourceMappingURL=chunk-YDWLUT5V.cjs.map
+//# sourceMappingURL=chunk-TQR4KBY2.cjs.map
+//# sourceMappingURL=chunk-TQR4KBY2.cjs.map