@nicia-ai/typegraph 0.42.1 → 0.44.0

package/dist/{chunk-5ZPRE4CV.cjs → chunk-PDGEXGS6.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var chunkO7XVCLXW_cjs = require('./chunk-O7XVCLXW.cjs');
-var chunk33PAKPED_cjs = require('./chunk-33PAKPED.cjs');
-var chunkAQR6BHB3_cjs = require('./chunk-AQR6BHB3.cjs');
-var chunkOMQ2NBOR_cjs = require('./chunk-OMQ2NBOR.cjs');
-var chunk6TJ6PKPS_cjs = require('./chunk-6TJ6PKPS.cjs');
+var chunkST3LPB2V_cjs = require('./chunk-ST3LPB2V.cjs');
+var chunkMCHP7RHZ_cjs = require('./chunk-MCHP7RHZ.cjs');
+var chunkHJH3RMXG_cjs = require('./chunk-HJH3RMXG.cjs');
+var chunk6JZUSDY2_cjs = require('./chunk-6JZUSDY2.cjs');
+var chunkNN3QSOVS_cjs = require('./chunk-NN3QSOVS.cjs');
 var chunkZDH3DX3C_cjs = require('./chunk-ZDH3DX3C.cjs');
-var chunkECU53PMN_cjs = require('./chunk-ECU53PMN.cjs');
-var chunkAO2WPYFZ_cjs = require('./chunk-AO2WPYFZ.cjs');
-var chunkUTTW2Q3M_cjs = require('./chunk-UTTW2Q3M.cjs');
-var chunkX2XOQZT3_cjs = require('./chunk-X2XOQZT3.cjs');
+var chunk3PRKZW6D_cjs = require('./chunk-3PRKZW6D.cjs');
+var chunkWBUFJ7BS_cjs = require('./chunk-WBUFJ7BS.cjs');
+var chunkOVUUTCPJ_cjs = require('./chunk-OVUUTCPJ.cjs');
+var chunkU5W4LKZV_cjs = require('./chunk-U5W4LKZV.cjs');
 var chunk764JHTLT_cjs = require('./chunk-764JHTLT.cjs');
-var chunkKTBTSHU6_cjs = require('./chunk-KTBTSHU6.cjs');
+var chunkC4F7VJ5D_cjs = require('./chunk-C4F7VJ5D.cjs');
 var drizzleOrm = require('drizzle-orm');
 var pgCore = require('drizzle-orm/pg-core');
 
@@ -50,7 +50,7 @@ var DEFAULT_POSTGRES_STATEMENT_CACHE_MAX = 256;
 var STATEMENT_NAME_CACHE = /* @__PURE__ */ new Map();
 var nextStatementId = 0;
 function statementNameFor(sqlText, cacheMax) {
-  return chunkO7XVCLXW_cjs.getOrCreateLru(STATEMENT_NAME_CACHE, sqlText, cacheMax, () => {
+  return chunkST3LPB2V_cjs.getOrCreateLru(STATEMENT_NAME_CACHE, sqlText, cacheMax, () => {
     const name = `tg_${nextStatementId}`;
     nextStatementId += 1;
     return name;
@@ -164,7 +164,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
     options.useTransactionClient ?? false
   );
   function compile(query) {
-    return chunk6TJ6PKPS_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
+    return chunkNN3QSOVS_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
   }
   function assertCompiledWithinBindParameterLimit(compiledQuery) {
     assertWithinBindParameterLimit(
@@ -179,7 +179,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
         assertCompiledWithinBindParameterLimit(compile(query));
         return executeDrizzleQuery(
           db,
-          chunkX2XOQZT3_cjs.isSqlFragment(query) ? chunk6TJ6PKPS_cjs.toDrizzleSql(query, "postgres") : query
+          chunkU5W4LKZV_cjs.isSqlFragment(query) ? chunkNN3QSOVS_cjs.toDrizzleSql(query, "postgres") : query
         );
       }
     };
@@ -198,7 +198,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
     async execute(query) {
       const compiled = compile(query);
       assertCompiledWithinBindParameterLimit(compiled);
-      if (chunkX2XOQZT3_cjs.isSqlFragment(query) && chunkX2XOQZT3_cjs.shouldForceCustomPlan(query)) {
+      if (chunkU5W4LKZV_cjs.isSqlFragment(query) && chunkU5W4LKZV_cjs.shouldForceCustomPlan(query)) {
         const result = await pgQueryClient.queryUnnamed(
           compiled.sql,
           compiled.params
@@ -221,7 +221,7 @@ function assertWithinBindParameterLimit(parameterCount, maxBindParameters) {
   if (maxBindParameters === void 0 || parameterCount <= maxBindParameters) {
     return;
   }
-  throw new chunkKTBTSHU6_cjs.ConfigurationError(
+  throw new chunkC4F7VJ5D_cjs.ConfigurationError(
     `PostgreSQL statement uses ${parameterCount} bound parameters, exceeding this backend's limit of ${maxBindParameters}.`,
     {
       capability: "maxBindParameters",
@@ -242,7 +242,7 @@ function createStatementQueue() {
   let closed = false;
   return {
     enqueue(task) {
-      if (closed) return Promise.reject(new chunkKTBTSHU6_cjs.TransactionClosedError());
+      if (closed) return Promise.reject(new chunkC4F7VJ5D_cjs.TransactionClosedError());
       const result = tail.then(() => task());
       tail = result.then(ignoreOutcome, ignoreOutcome);
       return result;
@@ -306,7 +306,11 @@ function computePostgresBatchChunkSizes(maxBindParameters) {
     ),
     embeddingUpsertBatchSize: Math.max(
       1,
-      Math.floor(maxBindParameters / chunkO7XVCLXW_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
+      Math.floor(maxBindParameters / chunkST3LPB2V_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
+    ),
+    findEdgesEndpointChunkSize: Math.max(
+      1,
+      maxBindParameters - chunkST3LPB2V_cjs.FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT
     ),
     fulltextDeleteChunkSize: Math.max(
       1,
@@ -334,23 +338,23 @@ function computePostgresBatchChunkSizes(maxBindParameters) {
     )
   };
 }
-var toNodeRow = chunkAQR6BHB3_cjs.createNodeRowMapper(chunkAQR6BHB3_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toEdgeRow = chunkAQR6BHB3_cjs.createEdgeRowMapper(chunkAQR6BHB3_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toUniqueRow = chunkAQR6BHB3_cjs.createUniqueRowMapper(chunkAQR6BHB3_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toSchemaVersionRow = chunkAQR6BHB3_cjs.createSchemaVersionRowMapper(
-  chunkAQR6BHB3_cjs.POSTGRES_ROW_MAPPER_CONFIG
+var toNodeRow = chunkHJH3RMXG_cjs.createNodeRowMapper(chunkHJH3RMXG_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunkHJH3RMXG_cjs.createEdgeRowMapper(chunkHJH3RMXG_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunkHJH3RMXG_cjs.createUniqueRowMapper(chunkHJH3RMXG_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunkHJH3RMXG_cjs.createSchemaVersionRowMapper(
+  chunkHJH3RMXG_cjs.POSTGRES_ROW_MAPPER_CONFIG
 );
 function buildPostgresCapabilities(fulltextStrategy, vectorStrategy) {
   return {
-    ...chunkECU53PMN_cjs.POSTGRES_CAPABILITIES,
-    ...vectorStrategy === void 0 ? {} : { vector: chunkUTTW2Q3M_cjs.buildVectorCapabilities(vectorStrategy) },
-    fulltext: chunkUTTW2Q3M_cjs.buildFulltextCapabilities(fulltextStrategy)
+    ...chunk3PRKZW6D_cjs.POSTGRES_CAPABILITIES,
+    ...vectorStrategy === void 0 ? {} : { vector: chunkOVUUTCPJ_cjs.buildVectorCapabilities(vectorStrategy) },
+    fulltext: chunkOVUUTCPJ_cjs.buildFulltextCapabilities(fulltextStrategy)
   };
 }
 function createPostgresBackend(db, options = {}) {
-  const tables2 = options.tables ?? chunkOMQ2NBOR_cjs.tables;
-  const fulltextStrategy = options.fulltext ?? chunkUTTW2Q3M_cjs.tsvectorStrategy;
-  const vectorStrategy = options.vector === false ? void 0 : options.vector ?? chunk33PAKPED_cjs.pgvectorStrategy;
+  const tables2 = options.tables ?? chunk6JZUSDY2_cjs.tables;
+  const fulltextStrategy = options.fulltext ?? chunkOVUUTCPJ_cjs.tsvectorStrategy;
+  const vectorStrategy = options.vector === false ? void 0 : options.vector ?? chunkMCHP7RHZ_cjs.pgvectorStrategy;
   const iterativeScanProbe = createIterativeScanProbe();
   const baseCapabilities = buildPostgresCapabilities(
     fulltextStrategy,
@@ -363,14 +367,14 @@ function createPostgresBackend(db, options = {}) {
       supported: false
     }
   } : {};
-  const configuredMaxBindParameters = options.capabilities?.maxBindParameters ?? chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS;
+  const configuredMaxBindParameters = options.capabilities?.maxBindParameters ?? chunk3PRKZW6D_cjs.POSTGRES_MAX_BIND_PARAMETERS;
   const driverBindParameterOverrides = isPgliteDatabase(db) ? {
     maxBindParameters: Math.min(
       configuredMaxBindParameters,
       PGLITE_MAX_BIND_PARAMETERS
     )
   } : {};
-  const capabilities = chunkECU53PMN_cjs.normalizeGraphAnalyticsCapabilities({
+  const capabilities = chunk3PRKZW6D_cjs.normalizeGraphAnalyticsCapabilities({
     ...baseCapabilities,
     ...httpOnlyOverrides,
     ...options.capabilities,
@@ -379,7 +383,7 @@ function createPostgresBackend(db, options = {}) {
   const adapterOptions = {
     ...options.prepareStatements === void 0 ? {} : { prepareStatements: options.prepareStatements },
     ...options.preparedStatementCacheMax === void 0 ? {} : { preparedStatementCacheMax: options.preparedStatementCacheMax },
-    maxBindParameters: capabilities.maxBindParameters ?? chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS
+    maxBindParameters: capabilities.maxBindParameters ?? chunk3PRKZW6D_cjs.POSTGRES_MAX_BIND_PARAMETERS
   };
   const executionAdapter = createPostgresExecutionAdapter(db, adapterOptions);
   const tableNames = {
@@ -398,8 +402,8 @@ function createPostgresBackend(db, options = {}) {
     drizzleOrm.getTableName(tables2.uniques),
     tableNames.fulltext
   ].map(
-    (name) => chunk6TJ6PKPS_cjs.toDrizzleSql(
-      chunkX2XOQZT3_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkX2XOQZT3_cjs.sql.identifier(name)}`,
+    (name) => chunkNN3QSOVS_cjs.toDrizzleSql(
+      chunkU5W4LKZV_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkU5W4LKZV_cjs.sql.identifier(name)}`,
       "postgres"
     )
   );
@@ -408,11 +412,11 @@ function createPostgresBackend(db, options = {}) {
     tableNames.recordedEdges,
     tableNames.recordedClock
   ];
-  const operationStrategy = chunkO7XVCLXW_cjs.createPostgresOperationStrategy(
+  const operationStrategy = chunkST3LPB2V_cjs.createPostgresOperationStrategy(
     tables2,
     fulltextStrategy
   );
-  const recordedTableExists = chunkO7XVCLXW_cjs.createCachedTableExistence(
+  const recordedTableExists = chunkST3LPB2V_cjs.createCachedTableExistence(
     async (tableName) => {
       const rows = await executionAdapter.execute(
         operationStrategy.buildTableExists(tableName)
@@ -423,7 +427,7 @@ function createPostgresBackend(db, options = {}) {
   );
   const matTable = tables2.contributionMaterializations;
   async function ensureContributionMaterializationsTableImpl() {
-    await db.execute(drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generatePgCreateTableSQL(matTable)));
+    await db.execute(drizzleOrm.sql.raw(chunk6JZUSDY2_cjs.generatePgCreateTableSQL(matTable)));
   }
   async function getContributionMaterializationRow(identity) {
     const rows = await db.select().from(matTable).where(
@@ -436,25 +440,25 @@ function createPostgresBackend(db, options = {}) {
     );
     const row = rows[0];
     if (row === void 0) return void 0;
-    return chunkO7XVCLXW_cjs.mapContributionMaterializationRow(
+    return chunkST3LPB2V_cjs.mapContributionMaterializationRow(
       row,
-      chunkO7XVCLXW_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
+      chunkST3LPB2V_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) => chunkO7XVCLXW_cjs.mapContributionMaterializationRow(
+      (row) => chunkST3LPB2V_cjs.mapContributionMaterializationRow(
         row,
-        chunkO7XVCLXW_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
+        chunkST3LPB2V_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
       )
     );
   }
   async function recordContributionMaterializationRow(params) {
     await db.insert(matTable).values(
-      chunkO7XVCLXW_cjs.buildContributionInsertValues(
+      chunkST3LPB2V_cjs.buildContributionInsertValues(
         params,
-        chunkO7XVCLXW_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.encode
+        chunkST3LPB2V_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.encode
       )
     ).onConflictDoUpdate({
       target: [
@@ -463,7 +467,7 @@ function createPostgresBackend(db, options = {}) {
         matTable.owner,
         matTable.tableName
       ],
-      set: chunkO7XVCLXW_cjs.buildContributionOnConflictSet(
+      set: chunkST3LPB2V_cjs.buildContributionOnConflictSet(
         matTable.materializedAt,
         params.materializedAt
       )
@@ -479,7 +483,13 @@ function createPostgresBackend(db, options = {}) {
       )
     );
   }
-  const contributionMaterializer = chunkO7XVCLXW_cjs.createContributionMaterializer({
+  async function contributionTableExists(tableName) {
+    const rows = await executionAdapter.execute(
+      operationStrategy.buildTableExists(tableName)
+    );
+    return chunkST3LPB2V_cjs.tableExistsFromRow(rows[0]);
+  }
+  const contributionMaterializer = chunkST3LPB2V_cjs.createContributionMaterializer({
     dialect: "postgres",
     fulltextStrategy,
     fulltextTableName: tables2.fulltextTableName,
@@ -490,7 +500,8 @@ function createPostgresBackend(db, options = {}) {
     ensureMarkerTable: ensureContributionMaterializationsTableImpl,
     getMarkers: getContributionMaterializationRows,
     recordMarker: recordContributionMaterializationRow,
-    deleteMarker: deleteContributionMaterializationRow
+    deleteMarker: deleteContributionMaterializationRow,
+    tableExists: contributionTableExists
   });
   const operations = createPostgresOperationBackend({
     db,
@@ -502,12 +513,14 @@ function createPostgresBackend(db, options = {}) {
     fulltextStrategy,
     vectorStrategy,
     contributionMaterializer,
-    iterativeScanProbe
+    iterativeScanProbe,
+    schemaVersionsTable: tables2.schemaVersions,
+    transactionScoped: false
   });
   function runSchemaWriteTransaction(graphId, fn) {
     if (!capabilities.transactions) {
-      throw new chunkKTBTSHU6_cjs.ConfigurationError(
-        "commitSchemaVersion and setActiveVersion 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.",
+      throw new chunkC4F7VJ5D_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",
           capability: "transactions",
@@ -517,6 +530,13 @@ function createPostgresBackend(db, options = {}) {
     }
     return db.transaction(async (tx) => {
       await tx.execute(drizzleOrm.sql`SELECT pg_advisory_xact_lock(hashtext(${graphId}))`);
+      await tx.execute(drizzleOrm.sql`
+        SELECT ${tables2.schemaVersions.version}
+        FROM ${tables2.schemaVersions}
+        WHERE ${tables2.schemaVersions.graphId} = ${graphId}
+          AND ${tables2.schemaVersions.isActive} = TRUE
+        FOR UPDATE
+      `);
       const { backend: txBackend, drainAndClose } = createTransactionBackend({
         db: tx,
         adapterOptions,
@@ -526,7 +546,8 @@ function createPostgresBackend(db, options = {}) {
         fulltextStrategy,
         vectorStrategy,
         contributionMaterializer,
-        iterativeScanProbe
+        iterativeScanProbe,
+        schemaVersionsTable: tables2.schemaVersions
       });
       try {
         return await fn(txBackend);
@@ -545,10 +566,11 @@ function createPostgresBackend(db, options = {}) {
       fulltextStrategy,
       vectorStrategy,
       contributionMaterializer,
-      iterativeScanProbe
+      iterativeScanProbe,
+      schemaVersionsTable: tables2.schemaVersions
     });
     return {
-      backend: chunkO7XVCLXW_cjs.gateFulltext(
+      backend: chunkST3LPB2V_cjs.gateFulltext(
         backend2,
         contributionMaterializer.assertInitialized
       ),
@@ -558,48 +580,53 @@ function createPostgresBackend(db, options = {}) {
   const backend = {
     ...operations,
     ...capabilities.transactions && executionAdapter.executeCompiled !== void 0 ? {
-      async trustedImport(fn) {
+      async trustedImport(fn, options_) {
         return backend.transactionWithNative(async (tx, rawSql) => {
+          if (options_?.schemaWrite !== void 0) {
+            await chunk764JHTLT_cjs.requireDefined(tx.lockSchemaVersionForWrite)({
+              ...options_.schemaWrite
+            });
+          }
           const trustedExecutionAdapter = createPostgresExecutionAdapter(
             rawSql,
             { ...adapterOptions, useTransactionClient: true }
           );
           const executeCompiled = trustedExecutionAdapter.executeCompiled;
           if (executeCompiled === void 0) {
-            throw new chunkKTBTSHU6_cjs.ConfigurationError(
+            throw new chunkC4F7VJ5D_cjs.ConfigurationError(
               "Trusted import could not bind raw execution to the PostgreSQL transaction.",
               { capability: "trustedImport", dialect: "postgres" }
             );
           }
-          const trustedTx = chunkECU53PMN_cjs.createBackendOverlay(tx, {
+          const trustedTx = chunk3PRKZW6D_cjs.createBackendOverlay(tx, {
             executeRaw(sqlText, params) {
               return executeCompiled({ params, sql: sqlText });
             }
           });
-          await chunkO7XVCLXW_cjs.lockPostgresTrustedImportTables(trustedTx, tableNames);
-          await chunkO7XVCLXW_cjs.assertTrustedImportDatabaseEmpty(trustedTx, tableNames);
-          const indexDefinitions = await chunkO7XVCLXW_cjs.suspendPostgresSecondaryIndexes(
+          await chunkST3LPB2V_cjs.lockPostgresTrustedImportTables(trustedTx, tableNames);
+          await chunkST3LPB2V_cjs.assertTrustedImportDatabaseEmpty(trustedTx, tableNames);
+          const indexDefinitions = await chunkST3LPB2V_cjs.suspendPostgresSecondaryIndexes(
             trustedTx,
             tableNames
           );
           const result = await fn(
-            chunkO7XVCLXW_cjs.createPostgresTrustedImportSession(trustedTx, tableNames)
+            chunkST3LPB2V_cjs.createPostgresTrustedImportSession(trustedTx, tableNames)
           );
-          await chunkO7XVCLXW_cjs.restoreSecondaryIndexes(trustedTx, indexDefinitions);
-          await chunkO7XVCLXW_cjs.analyzeImportedTables(trustedTx, tableNames);
+          await chunkST3LPB2V_cjs.restoreSecondaryIndexes(trustedTx, indexDefinitions);
+          await chunkST3LPB2V_cjs.analyzeImportedTables(trustedTx, tableNames);
           return result;
         });
       }
     } : {},
     async bootstrapTables() {
-      const statements = chunkOMQ2NBOR_cjs.generatePostgresDDL(tables2, fulltextStrategy);
+      const statements = chunk6JZUSDY2_cjs.generatePostgresDDL(tables2, fulltextStrategy);
       for (const statement of statements) {
         await db.execute(drizzleOrm.sql.raw(statement));
       }
     },
     async ensureRevisionOriginsTable() {
       await db.execute(
-        drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generatePgCreateTableSQL(tables2.revisionOrigins))
+        drizzleOrm.sql.raw(chunk6JZUSDY2_cjs.generatePgCreateTableSQL(tables2.revisionOrigins))
       );
     },
     // Every fulltext-touching method asserts the durable marker instead
@@ -607,7 +634,7 @@ function createPostgresBackend(db, options = {}) {
     // uninitialized database throws `StoreNotInitializedError` loudly
     // rather than self-healing on a read/write path (#135). Shared
     // verbatim with the tx-scoped gate via `gateFulltextMethods`.
-    ...chunkO7XVCLXW_cjs.gateFulltextMethods(
+    ...chunkST3LPB2V_cjs.gateFulltextMethods(
       operations,
       contributionMaterializer.assertInitialized
     ),
@@ -616,7 +643,7 @@ function createPostgresBackend(db, options = {}) {
     },
     async ensureIndexMaterializationsTable() {
       await db.execute(
-        drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generatePgCreateTableSQL(tables2.indexMaterializations))
+        drizzleOrm.sql.raw(chunk6JZUSDY2_cjs.generatePgCreateTableSQL(tables2.indexMaterializations))
       );
       const tableName = drizzleOrm.getTableName(tables2.indexMaterializations);
       await db.execute(
@@ -668,26 +695,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 chunkO7XVCLXW_cjs.mapMaterializationRow(row, chunkO7XVCLXW_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode);
+      return chunkST3LPB2V_cjs.mapMaterializationRow(row, chunkST3LPB2V_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) => chunkO7XVCLXW_cjs.mapMaterializationRow(row, chunkO7XVCLXW_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode)
+        (row) => chunkST3LPB2V_cjs.mapMaterializationRow(row, chunkST3LPB2V_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode)
       );
     },
     async recordIndexMaterialization(params) {
       const t = tables2.indexMaterializations;
       await db.insert(t).values(
-        chunkO7XVCLXW_cjs.buildMaterializationInsertValues(
+        chunkST3LPB2V_cjs.buildMaterializationInsertValues(
           params,
-          chunkO7XVCLXW_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.encode
+          chunkST3LPB2V_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: t.indexName,
-        set: chunkO7XVCLXW_cjs.buildMaterializationOnConflictSet(params.materializedAt)
+        set: chunkST3LPB2V_cjs.buildMaterializationOnConflictSet(params.materializedAt)
       });
     },
     async ensureContributionMaterializationsTable() {
@@ -703,37 +730,37 @@ function createPostgresBackend(db, options = {}) {
       await contributionMaterializer.assertInitialized(graphId);
     },
     async ensureKindRemovalsTable() {
-      await db.execute(drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generatePgCreateTableSQL(tables2.kindRemovals)));
+      await db.execute(drizzleOrm.sql.raw(chunk6JZUSDY2_cjs.generatePgCreateTableSQL(tables2.kindRemovals)));
     },
     async getPendingKindRemovals(graphId) {
       const t = tables2.kindRemovals;
       const rows = await db.select().from(t).where(drizzleOrm.and(drizzleOrm.eq(t.graphId, graphId), drizzleOrm.isNull(t.removedAt)));
       return rows.map(
-        (row) => chunkO7XVCLXW_cjs.mapKindRemovalRow(row, chunkO7XVCLXW_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkST3LPB2V_cjs.mapKindRemovalRow(row, chunkST3LPB2V_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) => chunkO7XVCLXW_cjs.mapKindRemovalRow(row, chunkO7XVCLXW_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunkST3LPB2V_cjs.mapKindRemovalRow(row, chunkST3LPB2V_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
       );
     },
     async recordKindRemoval(params) {
       const t = tables2.kindRemovals;
       await db.insert(t).values(
-        chunkO7XVCLXW_cjs.buildKindRemovalInsertValues(
+        chunkST3LPB2V_cjs.buildKindRemovalInsertValues(
           params,
-          chunkO7XVCLXW_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.encode
+          chunkST3LPB2V_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: [t.graphId, t.kindName, t.entity, t.schemaVersion],
-        set: chunkO7XVCLXW_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
+        set: chunkST3LPB2V_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
       });
     },
     async ensureReconciliationMarkersTable() {
       await db.execute(
-        drizzleOrm.sql.raw(chunkOMQ2NBOR_cjs.generatePgCreateTableSQL(tables2.reconciliationMarkers))
+        drizzleOrm.sql.raw(chunk6JZUSDY2_cjs.generatePgCreateTableSQL(tables2.reconciliationMarkers))
       );
     },
     async ensureRuntimeContributions(graphId) {
@@ -747,6 +774,9 @@ function createPostgresBackend(db, options = {}) {
     async ensureFulltextTable(graphId) {
       await contributionMaterializer.ensureRuntimeContributions(graphId);
     },
+    async verifyContributions(graphId, vectorSlots) {
+      return contributionMaterializer.verifyContributions(graphId, vectorSlots);
+    },
     // 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
@@ -793,8 +823,8 @@ function createPostgresBackend(db, options = {}) {
       const presentRecordedTables = tablePresence.filter((entry) => entry.exists).map((entry) => entry.tableName);
       for (const tableName of presentRecordedTables) {
         await db.execute(
-          chunk6TJ6PKPS_cjs.toDrizzleSql(
-            chunkX2XOQZT3_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkX2XOQZT3_cjs.sql.identifier(tableName)}`,
+          chunkNN3QSOVS_cjs.toDrizzleSql(
+            chunkU5W4LKZV_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkU5W4LKZV_cjs.sql.identifier(tableName)}`,
             "postgres"
           )
         );
@@ -806,19 +836,28 @@ function createPostgresBackend(db, options = {}) {
         (target) => target.commitSchemaVersion(params)
       );
     },
+    async commitSchemaVersionIfKindsEmpty(params, probes) {
+      return runSchemaWriteTransaction(
+        params.graphId,
+        (target) => chunkST3LPB2V_cjs.commitSchemaVersionIfKindsEmpty(target, params, probes)
+      );
+    },
     async setActiveVersion(params) {
       await runSchemaWriteTransaction(
         params.graphId,
         (target) => target.setActiveVersion(params)
       );
     },
+    async schemaWriteTransaction(graphId, fn) {
+      return runSchemaWriteTransaction(graphId, (target) => fn(target));
+    },
     async transaction(fn, options2) {
       return backend.transactionWithNative((tx) => fn(tx), options2);
     },
     async transactionWithNative(fn, options2) {
-      const temporaryWrites = options2?.temporaryWrites === chunkECU53PMN_cjs.INTERNAL_TEMPORARY_WRITES;
+      const temporaryWrites = options2?.temporaryWrites === chunk3PRKZW6D_cjs.INTERNAL_TEMPORARY_WRITES;
       if (temporaryWrites && options2.accessMode !== "read_only") {
-        throw new chunkKTBTSHU6_cjs.ConfigurationError(
+        throw new chunkC4F7VJ5D_cjs.ConfigurationError(
           "Temporary-write transactions must be semantically read-only.",
           { dialect: "postgres" }
         );
@@ -842,7 +881,7 @@ function createPostgresBackend(db, options = {}) {
     },
     adoptTransaction(externalTx) {
       if (!capabilities.transactions) {
-        throw new chunkKTBTSHU6_cjs.ConfigurationError(
+        throw new chunkC4F7VJ5D_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",
@@ -851,7 +890,7 @@ function createPostgresBackend(db, options = {}) {
           }
         );
       }
-      chunkO7XVCLXW_cjs.assertAdoptedDialect(
+      chunkST3LPB2V_cjs.assertAdoptedDialect(
         externalTx,
         pgCore.PgTransaction,
         "postgres"
@@ -907,7 +946,9 @@ function createPostgresOperationBackend(options) {
     fulltextStrategy,
     vectorStrategy,
     contributionMaterializer,
-    iterativeScanProbe
+    iterativeScanProbe,
+    schemaVersionsTable,
+    transactionScoped
   } = options;
   async function execAll(query) {
     return executionAdapter.execute(query);
@@ -959,7 +1000,7 @@ function createPostgresOperationBackend(options) {
   async function runVectorSearchGucGroup(overrides, query) {
     const runExclusive = executionAdapter.runExclusive;
     if (runExclusive === void 0) {
-      throw new chunkKTBTSHU6_cjs.CompilerInvariantError(
+      throw new chunkC4F7VJ5D_cjs.CompilerInvariantError(
         "A transaction-scoped Postgres backend must expose runExclusive; its execution adapter was not wrapped by createSerialExecutionAdapter."
       );
     }
@@ -1003,16 +1044,16 @@ function createPostgresOperationBackend(options) {
     });
   }
   const batchConfig = computePostgresBatchChunkSizes(
-    capabilities.maxBindParameters ?? chunkECU53PMN_cjs.POSTGRES_MAX_BIND_PARAMETERS
+    capabilities.maxBindParameters ?? chunk3PRKZW6D_cjs.POSTGRES_MAX_BIND_PARAMETERS
   );
-  const commonBackend = chunkO7XVCLXW_cjs.createCommonOperationBackend({
+  const commonBackend = chunkST3LPB2V_cjs.createCommonOperationBackend({
     batchConfig,
     execution: {
       execAll,
       execGet,
       execRun
     },
-    nowIso: chunkAQR6BHB3_cjs.nowIso,
+    nowIso: chunkHJH3RMXG_cjs.nowIso,
     operationStrategy,
     rowMappers: {
       toEdgeRow,
@@ -1030,26 +1071,26 @@ function createPostgresOperationBackend(options) {
   };
   const vectorEmbeddingMethods = vectorStrategy === void 0 ? {} : {
     async upsertEmbedding(params) {
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      const slot = chunkST3LPB2V_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
-      const statements = vectorStrategy.buildUpsert(slot, params, chunkAQR6BHB3_cjs.nowIso());
+      const statements = vectorStrategy.buildUpsert(slot, params, chunkHJH3RMXG_cjs.nowIso());
       try {
         for (const statement of statements) {
           await execRun(statement);
         }
       } catch (error) {
-        throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, params);
+        throw chunkST3LPB2V_cjs.mapVectorWriteError(error, params);
       }
     },
     async upsertEmbeddingBatch(params) {
       if (params.rows.length === 0) return;
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      const slot = chunkST3LPB2V_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const rowsById = new Map(
         params.rows.map((row) => [row.nodeId, row])
       );
       const rows = [...rowsById.values()];
-      const timestamp = chunkAQR6BHB3_cjs.nowIso();
+      const timestamp = chunkHJH3RMXG_cjs.nowIso();
       try {
         for (const chunk2 of chunkZDH3DX3C_cjs.chunk(
           rows,
@@ -1080,11 +1121,11 @@ function createPostgresOperationBackend(options) {
           }
         }
       } catch (error) {
-        throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, params);
+        throw chunkST3LPB2V_cjs.mapVectorWriteError(error, params);
       }
     },
     async deleteEmbedding(params) {
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      const slot = chunkST3LPB2V_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const statements = vectorStrategy.buildDelete(slot, params);
       for (const statement of statements) {
@@ -1092,19 +1133,19 @@ function createPostgresOperationBackend(options) {
       }
     },
     async vectorSearch(params) {
-      chunkUTTW2Q3M_cjs.assertVectorSearchLimit(params.limit);
-      chunk33PAKPED_cjs.assertPgvectorEfSearch(params.efSearch);
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams(params);
+      chunkOVUUTCPJ_cjs.assertVectorSearchLimit(params.limit);
+      chunkMCHP7RHZ_cjs.assertPgvectorEfSearch(params.efSearch);
+      const slot = chunkST3LPB2V_cjs.vectorSlotFromParams(params);
       const query = vectorStrategy.buildSearch(
         slot,
         params,
         // Store-compiled candidates (predicates + subclass + currency)
         // take precedence; the live-node default covers direct backend use.
-        params.candidates ?? chunkO7XVCLXW_cjs.buildLiveNodeCandidates(
+        params.candidates ?? chunkST3LPB2V_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkAQR6BHB3_cjs.nowIso()
+          chunkHJH3RMXG_cjs.nowIso()
         )
       );
       const gucOverrides = await vectorSearchGucOverrides(params);
@@ -1112,7 +1153,7 @@ function createPostgresOperationBackend(options) {
       try {
         rows = await runVectorSearch(gucOverrides, query);
       } catch (error) {
-        throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, params);
+        throw chunkST3LPB2V_cjs.mapVectorWriteError(error, params);
       }
       return rows.map((row) => ({
         nodeId: row.node_id,
@@ -1124,10 +1165,10 @@ function createPostgresOperationBackend(options) {
     // multi-statement fallback by simply not exposing the member.
     ...capabilities.windowFunctions ? {
       async hybridSearch(params) {
-        chunkUTTW2Q3M_cjs.assertVectorSearchLimit(params.limit);
-        chunkUTTW2Q3M_cjs.assertVectorSearchLimit(params.vector.k);
-        chunk33PAKPED_cjs.assertPgvectorEfSearch(params.vector.efSearch);
-        const slot = chunkO7XVCLXW_cjs.vectorSlotFromParams({
+        chunkOVUUTCPJ_cjs.assertVectorSearchLimit(params.limit);
+        chunkOVUUTCPJ_cjs.assertVectorSearchLimit(params.vector.k);
+        chunkMCHP7RHZ_cjs.assertPgvectorEfSearch(params.vector.efSearch);
+        const slot = chunkST3LPB2V_cjs.vectorSlotFromParams({
           graphId: params.graphId,
           nodeKind: params.nodeKind,
           fieldPath: params.vector.fieldPath,
@@ -1135,11 +1176,11 @@ function createPostgresOperationBackend(options) {
           metric: params.vector.metric,
           indexType: params.vector.indexType
         });
-        const candidates = params.candidates ?? chunkO7XVCLXW_cjs.buildLiveNodeCandidates(
+        const candidates = params.candidates ?? chunkST3LPB2V_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkAQR6BHB3_cjs.nowIso()
+          chunkHJH3RMXG_cjs.nowIso()
         );
         const vectorParams = {
           graphId: params.graphId,
@@ -1155,11 +1196,11 @@ function createPostgresOperationBackend(options) {
         const vectorSql = vectorStrategy.buildSearch(
           slot,
           vectorParams,
-          chunkX2XOQZT3_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
+          chunkU5W4LKZV_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
         );
         const statement = operationStrategy.buildHybridSearch(
           { ...params, candidates },
-          chunk6TJ6PKPS_cjs.toDrizzleSql(vectorSql, "postgres"),
+          chunkNN3QSOVS_cjs.toDrizzleSql(vectorSql, "postgres"),
           params.vector.metric === "cosine"
         );
         const gucOverrides = await vectorSearchGucOverrides({
@@ -1173,9 +1214,9 @@ function createPostgresOperationBackend(options) {
             statement
           );
         } catch (error) {
-          throw chunkO7XVCLXW_cjs.mapVectorWriteError(error, vectorParams);
+          throw chunkST3LPB2V_cjs.mapVectorWriteError(error, vectorParams);
         }
-        return raw.map((row) => chunkO7XVCLXW_cjs.mapHybridSearchRow(row, toNodeRow));
+        return raw.map((row) => chunkST3LPB2V_cjs.mapHybridSearchRow(row, toNodeRow));
       }
     } : {}
   };
@@ -1183,15 +1224,52 @@ function createPostgresOperationBackend(options) {
     ...commonBackend,
     ...executeRawMethod,
     ...vectorEmbeddingMethods,
+    async deleteSchemaVectorSlotContribution(slot) {
+      if (vectorStrategy === void 0) return;
+      for (const contribution of vectorStrategy.ownedTables(slot)) {
+        await execRun(
+          operationStrategy.buildDeleteContributionMaterialization({
+            graphId: slot.graphId,
+            logicalName: contribution.logicalName,
+            owner: contribution.owner,
+            tableName: contribution.tableName
+          })
+        );
+      }
+      contributionMaterializer.evictVectorSlot(slot);
+    },
     capabilities,
     fulltextStrategy,
     ...vectorStrategy === void 0 ? {} : { vectorStrategy },
     dialect: "postgres",
     tableNames,
+    async lockSchemaVersionForWrite(params) {
+      if (!transactionScoped) {
+        throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+          "The schema write fence requires an explicit PostgreSQL transaction.",
+          {
+            code: "SCHEMA_WRITE_FENCE_TRANSACTION_REQUIRED",
+            graphId: params.graphId
+          }
+        );
+      }
+      const active = await execGet(drizzleOrm.sql`
+        SELECT ${schemaVersionsTable.version} AS version
+        FROM ${schemaVersionsTable}
+        WHERE ${schemaVersionsTable.graphId} = ${params.graphId}
+          AND ${schemaVersionsTable.isActive} = TRUE
+        FOR SHARE
+      `);
+      chunkST3LPB2V_cjs.assertActiveSchemaVersion(
+        params.graphId,
+        params.expectedVersion,
+        active?.version ?? 0
+      );
+    },
     // === Vector Index Operations ===
     async createVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromCreateIndexParams(params);
+      const slot = chunkST3LPB2V_cjs.vectorSlotFromCreateIndexParams(params);
       await contributionMaterializer.ensureVectorSlot(slot);
       const indexStatement = vectorStrategy.buildCreateIndex?.(slot, {
         concurrent: params.concurrent === true
@@ -1200,12 +1278,12 @@ function createPostgresOperationBackend(options) {
         try {
           await execRun(indexStatement);
         } catch (error) {
-          if (!chunkAO2WPYFZ_cjs.isInsufficientResourcesError(error)) throw error;
+          if (!chunkWBUFJ7BS_cjs.isInsufficientResourcesError(error)) throw error;
           const dropStatement = vectorStrategy.buildDropIndex?.(slot);
           if (dropStatement !== void 0) {
             await execRun(dropStatement);
           }
-          const table = chunkX2XOQZT3_cjs.sql.identifier(
+          const table = chunkU5W4LKZV_cjs.sql.identifier(
             vectorStrategy.tableName(
               slot.graphId,
               slot.nodeKind,
@@ -1213,13 +1291,13 @@ function createPostgresOperationBackend(options) {
             )
           );
           await execRun(
-            chunkX2XOQZT3_cjs.sql`ALTER TABLE ${table} SET (parallel_workers = 0)`
+            chunkU5W4LKZV_cjs.sql`ALTER TABLE ${table} SET (parallel_workers = 0)`
           );
           try {
             await execRun(indexStatement);
           } finally {
             await execRun(
-              chunkX2XOQZT3_cjs.sql`ALTER TABLE ${table} RESET (parallel_workers)`
+              chunkU5W4LKZV_cjs.sql`ALTER TABLE ${table} RESET (parallel_workers)`
             );
           }
         }
@@ -1227,7 +1305,7 @@ function createPostgresOperationBackend(options) {
     },
     // === Fulltext Operations ===
     async upsertFulltext(params) {
-      const timestamp = chunkAQR6BHB3_cjs.nowIso();
+      const timestamp = chunkHJH3RMXG_cjs.nowIso();
       const statements = operationStrategy.buildUpsertFulltext(
         params,
         timestamp
@@ -1244,7 +1322,7 @@ function createPostgresOperationBackend(options) {
     },
     async upsertFulltextBatch(params) {
       if (params.rows.length === 0) return;
-      const timestamp = chunkAQR6BHB3_cjs.nowIso();
+      const timestamp = chunkHJH3RMXG_cjs.nowIso();
       for (const rows of chunkZDH3DX3C_cjs.chunk(
         params.rows,
         batchConfig.fulltextUpsertBatchSize
@@ -1278,25 +1356,25 @@ function createPostgresOperationBackend(options) {
       const rows = await execAll(query);
       return rows.map((row, index) => ({
         nodeId: row.node_id,
-        score: chunkAQR6BHB3_cjs.coerceNumericScore(row.score),
+        score: chunkHJH3RMXG_cjs.coerceNumericScore(row.score),
         rank: index + 1,
         ...row.snippet === null ? {} : { snippet: row.snippet }
       }));
     },
     async dropVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkO7XVCLXW_cjs.vectorSlotFromDropIndexParams(params);
+      const slot = chunkST3LPB2V_cjs.vectorSlotFromDropIndexParams(params);
       const dropStatement = vectorStrategy.buildDropIndex?.(slot);
       if (dropStatement === void 0) return;
       try {
         await execRun(dropStatement);
       } catch (error) {
-        if (!chunkAO2WPYFZ_cjs.isMissingTableError(error)) throw error;
+        if (!chunkWBUFJ7BS_cjs.isMissingTableError(error)) throw error;
       }
     },
     // === Query Execution ===
     async execute(query) {
-      const annTypes = chunkX2XOQZT3_cjs.isSqlFragment(query) ? chunkX2XOQZT3_cjs.annIndexScanTypes(query) : void 0;
+      const annTypes = chunkU5W4LKZV_cjs.isSqlFragment(query) ? chunkU5W4LKZV_cjs.annIndexScanTypes(query) : void 0;
       if (annTypes !== void 0 && vectorStrategy !== void 0) {
         const overrides = [];
         for (const indexType of annTypes) {
@@ -1329,11 +1407,13 @@ function createTransactionBackend(options) {
     contributionMaterializer: options.contributionMaterializer,
     // The probe is process-wide truth, so the outer instance's is reused
     // rather than a fresh one per transaction.
-    iterativeScanProbe: options.iterativeScanProbe
+    iterativeScanProbe: options.iterativeScanProbe,
+    schemaVersionsTable: options.schemaVersionsTable,
+    transactionScoped: true
   });
   return { backend, drainAndClose: txExecutionAdapter.drainAndClose };
 }
 
 exports.createPostgresBackend = createPostgresBackend;
-//# sourceMappingURL=chunk-5ZPRE4CV.cjs.map
-//# sourceMappingURL=chunk-5ZPRE4CV.cjs.map
+//# sourceMappingURL=chunk-PDGEXGS6.cjs.map
+//# sourceMappingURL=chunk-PDGEXGS6.cjs.map