@nicia-ai/typegraph 0.50.0 → 0.51.0

package/dist/{chunk-TYGGUWMS.cjs → chunk-B3MN7EJR.cjs}

@@ -1,14 +1,13 @@
 'use strict';
 
-var chunkXMY2SXOH_cjs = require('./chunk-XMY2SXOH.cjs');
-var chunkHSEZ7X6Y_cjs = require('./chunk-HSEZ7X6Y.cjs');
-var chunkEH3JZJUM_cjs = require('./chunk-EH3JZJUM.cjs');
-var chunkTP4NJTI3_cjs = require('./chunk-TP4NJTI3.cjs');
-var chunk45YZXI6X_cjs = require('./chunk-45YZXI6X.cjs');
-var chunkZBFZGLZE_cjs = require('./chunk-ZBFZGLZE.cjs');
-var chunkGHZPZNFC_cjs = require('./chunk-GHZPZNFC.cjs');
-var chunkTEC24ZDA_cjs = require('./chunk-TEC24ZDA.cjs');
-var chunkOJHD3LXJ_cjs = require('./chunk-OJHD3LXJ.cjs');
+var chunk5WWEYV4H_cjs = require('./chunk-5WWEYV4H.cjs');
+var chunkLLFPQOBA_cjs = require('./chunk-LLFPQOBA.cjs');
+var chunkTIJUA4I6_cjs = require('./chunk-TIJUA4I6.cjs');
+var chunk36SX6QXP_cjs = require('./chunk-36SX6QXP.cjs');
+var chunkNLX5OWK7_cjs = require('./chunk-NLX5OWK7.cjs');
+var chunkNUQ2YFFH_cjs = require('./chunk-NUQ2YFFH.cjs');
+var chunkH2VWDQWC_cjs = require('./chunk-H2VWDQWC.cjs');
+var chunkH5IJSROF_cjs = require('./chunk-H5IJSROF.cjs');
 var chunkX4GDXBOP_cjs = require('./chunk-X4GDXBOP.cjs');
 var chunkN66HCGCY_cjs = require('./chunk-N66HCGCY.cjs');
 var drizzleOrm = require('drizzle-orm');
@@ -53,7 +52,7 @@ var DEFAULT_POSTGRES_STATEMENT_CACHE_MAX = 256;
 var STATEMENT_NAME_CACHE = /* @__PURE__ */ new Map();
 var nextStatementId = 0;
 function statementNameFor(sqlText, cacheMax) {
-  return chunkXMY2SXOH_cjs.getOrCreateLru(STATEMENT_NAME_CACHE, sqlText, cacheMax, () => {
+  return chunk5WWEYV4H_cjs.getOrCreateLru(STATEMENT_NAME_CACHE, sqlText, cacheMax, () => {
     const name = `tg_${nextStatementId}`;
     nextStatementId += 1;
     return name;
@@ -167,7 +166,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
     options.useTransactionClient ?? false
   );
   function compile(query) {
-    return chunk45YZXI6X_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
+    return chunkLLFPQOBA_cjs.compileQueryWithDialect(db, query, "PostgreSQL");
   }
   function assertCompiledWithinBindParameterLimit(compiledQuery) {
     assertWithinBindParameterLimit(
@@ -182,7 +181,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
         assertCompiledWithinBindParameterLimit(compile(query));
         return executeDrizzleQuery(
           db,
-          chunkOJHD3LXJ_cjs.isSqlFragment(query) ? chunk45YZXI6X_cjs.toDrizzleSql(query, "postgres") : query
+          chunkH5IJSROF_cjs.isSqlFragment(query) ? chunkLLFPQOBA_cjs.toDrizzleSql(query, "postgres") : query
         );
       }
     };
@@ -201,7 +200,7 @@ function createPostgresExecutionAdapter(db, options = {}) {
     async execute(query) {
       const compiled = compile(query);
       assertCompiledWithinBindParameterLimit(compiled);
-      if (chunkOJHD3LXJ_cjs.isSqlFragment(query) && chunkOJHD3LXJ_cjs.shouldForceCustomPlan(query)) {
+      if (chunkH5IJSROF_cjs.isSqlFragment(query) && chunkH5IJSROF_cjs.shouldForceCustomPlan(query)) {
         const result = await pgQueryClient.queryUnnamed(
           compiled.sql,
           compiled.params
@@ -310,11 +309,11 @@ function computePostgresBatchChunkSizes(maxBindParameters) {
     ),
     embeddingUpsertBatchSize: Math.max(
       1,
-      Math.floor(maxBindParameters / chunkXMY2SXOH_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
+      Math.floor(maxBindParameters / chunk5WWEYV4H_cjs.EMBEDDING_UPSERT_PARAM_COUNT)
     ),
     findEdgesEndpointChunkSize: Math.max(
       1,
-      maxBindParameters - chunkXMY2SXOH_cjs.FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT
+      maxBindParameters - chunk5WWEYV4H_cjs.FIND_EDGES_ENDPOINT_FIXED_PARAM_COUNT
     ),
     fulltextDeleteChunkSize: Math.max(
       1,
@@ -352,11 +351,16 @@ var IDENTITY_TABLE_LOGICAL_NAMES = /* @__PURE__ */ new Set([
   "identityClosure",
   "identitySeparation"
 ]);
+var RECORDED_TABLE_LOGICAL_NAMES = /* @__PURE__ */ new Set([
+  "recordedNodes",
+  "recordedEdges",
+  "recordedClock"
+]);
 async function withConcurrentCreateRetry(run) {
   try {
     return await run();
   } catch (error) {
-    if (!chunkZBFZGLZE_cjs.isPostgresConcurrentDdlRaceError(error)) throw error;
+    if (!chunkNLX5OWK7_cjs.isPostgresConcurrentDdlRaceError(error)) throw error;
     return await run();
   }
 }
@@ -397,7 +401,7 @@ function reportParallelWorkerResetFailure(tableName, resetError) {
 async function resetVectorParallelWorkers(execute, tableName) {
   try {
     await execute(
-      chunkOJHD3LXJ_cjs.sql`ALTER TABLE ${chunkOJHD3LXJ_cjs.sql.identifier(tableName)} RESET (parallel_workers)`
+      chunkH5IJSROF_cjs.sql`ALTER TABLE ${chunkH5IJSROF_cjs.sql.identifier(tableName)} RESET (parallel_workers)`
     );
   } catch (resetError) {
     throw parallelWorkerResetError(tableName, resetError);
@@ -408,7 +412,7 @@ async function runVectorIndexBuildWithSerialFallback(execute, tableName, indexSt
   try {
     await execute(indexStatement);
   } catch (error) {
-    if (!chunkZBFZGLZE_cjs.isInsufficientResourcesError(error)) throw error;
+    if (!chunkNLX5OWK7_cjs.isInsufficientResourcesError(error)) throw error;
     if (dropStatement !== void 0) {
       try {
         await execute(dropStatement);
@@ -429,7 +433,7 @@ async function runVectorIndexBuildWithSerialFallback(execute, tableName, indexSt
   }
 }
 async function runPostgresVectorIndexBuild(vectorStrategy, execute, tableName, indexStatement, dropStatement) {
-  if (vectorStrategy !== chunkHSEZ7X6Y_cjs.pgvectorStrategy) {
+  if (vectorStrategy !== chunkTIJUA4I6_cjs.pgvectorStrategy) {
     await execute(indexStatement);
     return;
   }
@@ -441,9 +445,9 @@ async function runPostgresVectorIndexBuild(vectorStrategy, execute, tableName, i
   );
 }
 async function runSerialVectorIndexBuild(execute, tableName, indexStatement, parallelBuildError) {
-  const table = chunkOJHD3LXJ_cjs.sql.identifier(tableName);
+  const table = chunkH5IJSROF_cjs.sql.identifier(tableName);
   try {
-    await execute(chunkOJHD3LXJ_cjs.sql`ALTER TABLE ${table} SET (parallel_workers = 0)`);
+    await execute(chunkH5IJSROF_cjs.sql`ALTER TABLE ${table} SET (parallel_workers = 0)`);
   } catch (setError) {
     if (parallelBuildError === void 0) throw setError;
     throw vectorSerialFallbackPreparationError(
@@ -459,7 +463,7 @@ async function runSerialVectorIndexBuild(execute, tableName, indexStatement, par
     buildFailure = { error };
   }
   try {
-    await execute(chunkOJHD3LXJ_cjs.sql`ALTER TABLE ${table} RESET (parallel_workers)`);
+    await execute(chunkH5IJSROF_cjs.sql`ALTER TABLE ${table} RESET (parallel_workers)`);
   } catch (resetError) {
     if (buildFailure === void 0) {
       throw parallelWorkerResetError(tableName, resetError);
@@ -468,27 +472,27 @@ async function runSerialVectorIndexBuild(execute, tableName, indexStatement, par
   }
   if (buildFailure !== void 0) throw buildFailure.error;
 }
-var toNodeRow = chunkEH3JZJUM_cjs.createNodeRowMapper(chunkEH3JZJUM_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toEdgeRow = chunkEH3JZJUM_cjs.createEdgeRowMapper(chunkEH3JZJUM_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toUniqueRow = chunkEH3JZJUM_cjs.createUniqueRowMapper(chunkEH3JZJUM_cjs.POSTGRES_ROW_MAPPER_CONFIG);
-var toSchemaVersionRow = chunkEH3JZJUM_cjs.createSchemaVersionRowMapper(
-  chunkEH3JZJUM_cjs.POSTGRES_ROW_MAPPER_CONFIG
+var toNodeRow = chunk36SX6QXP_cjs.createNodeRowMapper(chunk36SX6QXP_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toEdgeRow = chunk36SX6QXP_cjs.createEdgeRowMapper(chunk36SX6QXP_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toUniqueRow = chunk36SX6QXP_cjs.createUniqueRowMapper(chunk36SX6QXP_cjs.POSTGRES_ROW_MAPPER_CONFIG);
+var toSchemaVersionRow = chunk36SX6QXP_cjs.createSchemaVersionRowMapper(
+  chunk36SX6QXP_cjs.POSTGRES_ROW_MAPPER_CONFIG
 );
 function buildPostgresCapabilities(fulltextStrategy, vectorStrategy) {
   return {
-    ...chunkGHZPZNFC_cjs.POSTGRES_CAPABILITIES,
-    ...vectorStrategy === void 0 ? {} : { vector: chunkTEC24ZDA_cjs.buildVectorCapabilities(vectorStrategy) },
-    fulltext: chunkTEC24ZDA_cjs.buildFulltextCapabilities(fulltextStrategy)
+    ...chunkNUQ2YFFH_cjs.POSTGRES_CAPABILITIES,
+    ...vectorStrategy === void 0 ? {} : { vector: chunkH2VWDQWC_cjs.buildVectorCapabilities(vectorStrategy) },
+    fulltext: chunkH2VWDQWC_cjs.buildFulltextCapabilities(fulltextStrategy)
   };
 }
 function createPostgresBackend(db, options = {}) {
-  const resourceAudit = chunkZBFZGLZE_cjs.resolveDeclaredBackendResource(
+  const resourceAudit = chunkNLX5OWK7_cjs.resolveDeclaredBackendResource(
     getSerializedPostgresClient(db),
     options.serializedResource
   );
-  const tables2 = options.tables ?? chunkTP4NJTI3_cjs.tables;
-  const fulltextStrategy = options.fulltext ?? chunkTEC24ZDA_cjs.tsvectorStrategy;
-  const vectorStrategy = options.vector === false ? void 0 : options.vector ?? chunkHSEZ7X6Y_cjs.pgvectorStrategy;
+  const tables2 = options.tables ?? chunk5WWEYV4H_cjs.tables;
+  const fulltextStrategy = options.fulltext ?? chunkH2VWDQWC_cjs.tsvectorStrategy;
+  const vectorStrategy = options.vector === false ? void 0 : options.vector ?? chunkTIJUA4I6_cjs.pgvectorStrategy;
   const iterativeScanProbe = createIterativeScanProbe();
   const baseCapabilities = buildPostgresCapabilities(
     fulltextStrategy,
@@ -501,35 +505,37 @@ function createPostgresBackend(db, options = {}) {
       supported: false
     }
   } : {};
-  const configuredMaxBindParameters = options.capabilities?.maxBindParameters ?? chunkGHZPZNFC_cjs.POSTGRES_MAX_BIND_PARAMETERS;
+  const configuredMaxBindParameters = options.capabilities?.maxBindParameters ?? chunkNUQ2YFFH_cjs.POSTGRES_MAX_BIND_PARAMETERS;
   const driverBindParameterOverrides = isPgliteDatabase(db) ? {
     maxBindParameters: Math.min(
       configuredMaxBindParameters,
       PGLITE_MAX_BIND_PARAMETERS
     )
   } : {};
-  const declaredCapabilities = chunkGHZPZNFC_cjs.normalizeGraphAnalyticsCapabilities({
+  const declaredCapabilities = chunkNUQ2YFFH_cjs.normalizeGraphAnalyticsCapabilities({
     ...baseCapabilities,
     ...httpOnlyOverrides,
     ...options.capabilities,
     ...driverBindParameterOverrides
   });
-  const capabilities = {
-    ...declaredCapabilities,
-    contributions: {
-      supported: true,
-      probe: true,
-      rebuild: chunkXMY2SXOH_cjs.contributionRebuildSupported(
-        fulltextStrategy,
-        tables2.fulltextTableName,
-        declaredCapabilities.transactions
-      )
+  const capabilities = chunk5WWEYV4H_cjs.assertBundledCapabilityDeclarations(
+    {
+      ...declaredCapabilities,
+      contributions: {
+        supported: true,
+        probe: true,
+        rebuild: chunk5WWEYV4H_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 ?? chunkGHZPZNFC_cjs.POSTGRES_MAX_BIND_PARAMETERS
+    maxBindParameters: capabilities.maxBindParameters ?? chunkNUQ2YFFH_cjs.POSTGRES_MAX_BIND_PARAMETERS
   };
   const executionAdapter = createPostgresExecutionAdapter(db, adapterOptions);
   const tableNames = {
@@ -553,8 +559,8 @@ function createPostgresBackend(db, options = {}) {
     drizzleOrm.getTableName(tables2.uniques),
     tableNames.fulltext
   ].map(
-    (name) => chunk45YZXI6X_cjs.toDrizzleSql(
-      chunkOJHD3LXJ_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkOJHD3LXJ_cjs.sql.identifier(name)}`,
+    (name) => chunkLLFPQOBA_cjs.toDrizzleSql(
+      chunkH5IJSROF_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkH5IJSROF_cjs.sql.identifier(name)}`,
       "postgres"
     )
   );
@@ -567,11 +573,11 @@ function createPostgresBackend(db, options = {}) {
     tableNames.identityClosure,
     tableNames.identitySeparation
   ];
-  const operationStrategy = chunkXMY2SXOH_cjs.createPostgresOperationStrategy(
+  const operationStrategy = chunk5WWEYV4H_cjs.createPostgresOperationStrategy(
     tables2,
     fulltextStrategy
   );
-  const guardedTableExists = chunkXMY2SXOH_cjs.createCachedTableExistence(
+  const guardedTableExists = chunk5WWEYV4H_cjs.createCachedTableExistence(
     async (tableName) => {
       const rows = await executionAdapter.execute(
         operationStrategy.buildTableExists(tableName)
@@ -588,18 +594,18 @@ function createPostgresBackend(db, options = {}) {
     });
   }
   async function ensureTableWithConcurrentCreateRetry(table) {
-    await executeConcurrentCreateDdl(chunkTP4NJTI3_cjs.generatePgCreateTableSQL(table));
+    await executeConcurrentCreateDdl(chunk5WWEYV4H_cjs.generatePgCreateTableSQL(table));
   }
   async function ensureDatabaseExtension(name) {
-    const validated = chunkGHZPZNFC_cjs.DATABASE_EXTENSION_NAMES.find(
+    const validated = chunkNUQ2YFFH_cjs.DATABASE_EXTENSION_NAMES.find(
       (candidate) => candidate === name
     );
     if (validated === void 0) {
       throw new chunkX4GDXBOP_cjs.ConfigurationError(
         `Unsupported database extension "${name}".`,
-        { extension: name, supported: chunkGHZPZNFC_cjs.DATABASE_EXTENSION_NAMES },
+        { extension: name, supported: chunkNUQ2YFFH_cjs.DATABASE_EXTENSION_NAMES },
         {
-          suggestion: `Request one of: ${chunkGHZPZNFC_cjs.DATABASE_EXTENSION_NAMES.join(", ")}.`
+          suggestion: `Request one of: ${chunkNUQ2YFFH_cjs.DATABASE_EXTENSION_NAMES.join(", ")}.`
         }
       );
     }
@@ -621,16 +627,26 @@ function createPostgresBackend(db, options = {}) {
     await ensureTableWithConcurrentCreateRetry(matTable);
   }
   function identityContributionsFor(identityTableNames) {
-    const identityTables = chunkTP4NJTI3_cjs.createPostgresTables({
+    const identityTables = chunk5WWEYV4H_cjs.createPostgresTables({
       identityAssertions: identityTableNames.identityAssertions,
       recordedIdentityAssertions: identityTableNames.recordedIdentityAssertions,
       identityClosure: identityTableNames.identityClosure,
       identitySeparation: identityTableNames.identitySeparation
     });
-    return chunkTP4NJTI3_cjs.postgresContributions(identityTables, fulltextStrategy).filter(
+    return chunk5WWEYV4H_cjs.postgresContributions(identityTables, fulltextStrategy).filter(
       (contribution) => IDENTITY_TABLE_LOGICAL_NAMES.has(contribution.logicalName)
     );
   }
+  function recordedContributionsFor(recordedTableNames) {
+    const recordedTables = chunk5WWEYV4H_cjs.createPostgresTables({
+      recordedNodes: recordedTableNames.recordedNodes,
+      recordedEdges: recordedTableNames.recordedEdges,
+      recordedClock: recordedTableNames.recordedClock
+    });
+    return chunk5WWEYV4H_cjs.postgresContributions(recordedTables, fulltextStrategy).filter(
+      (contribution) => RECORDED_TABLE_LOGICAL_NAMES.has(contribution.logicalName)
+    );
+  }
   async function getContributionMaterializationRow(identity) {
     const rows = await db.select().from(matTable).where(
       drizzleOrm.and(
@@ -642,25 +658,25 @@ function createPostgresBackend(db, options = {}) {
     );
     const row = rows[0];
     if (row === void 0) return void 0;
-    return chunkXMY2SXOH_cjs.mapContributionMaterializationRow(
+    return chunk5WWEYV4H_cjs.mapContributionMaterializationRow(
       row,
-      chunkXMY2SXOH_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
+      chunk5WWEYV4H_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) => chunkXMY2SXOH_cjs.mapContributionMaterializationRow(
+      (row) => chunk5WWEYV4H_cjs.mapContributionMaterializationRow(
         row,
-        chunkXMY2SXOH_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
+        chunk5WWEYV4H_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.decode
       )
     );
   }
   async function recordContributionMaterializationRow(params) {
     await db.insert(matTable).values(
-      chunkXMY2SXOH_cjs.buildContributionInsertValues(
+      chunk5WWEYV4H_cjs.buildContributionInsertValues(
         params,
-        chunkXMY2SXOH_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.encode
+        chunk5WWEYV4H_cjs.POSTGRES_CONTRIBUTION_MAT_TIMESTAMPS.encode
       )
     ).onConflictDoUpdate({
       target: [
@@ -669,7 +685,7 @@ function createPostgresBackend(db, options = {}) {
         matTable.owner,
         matTable.tableName
       ],
-      set: chunkXMY2SXOH_cjs.buildContributionOnConflictSet(
+      set: chunk5WWEYV4H_cjs.buildContributionOnConflictSet(
         matTable.materializedAt,
         params.materializedAt
       )
@@ -689,10 +705,11 @@ function createPostgresBackend(db, options = {}) {
     const rows = await executionAdapter.execute(
       operationStrategy.buildTableExists(tableName)
     );
-    return chunkXMY2SXOH_cjs.tableExistsFromRow(rows[0]);
+    return chunk5WWEYV4H_cjs.tableExistsFromRow(rows[0]);
   }
-  const contributionMaterializer = chunkXMY2SXOH_cjs.createContributionMaterializer({
+  const contributionMaterializer = chunk5WWEYV4H_cjs.createContributionMaterializer({
     dialect: "postgres",
+    fenceTarget: chunkNUQ2YFFH_cjs.markFirstPartyFactory({ dialect: "postgres", capabilities }),
     fulltextStrategy,
     fulltextTableName: tables2.fulltextTableName,
     vectorStrategy,
@@ -783,7 +800,7 @@ function createPostgresBackend(db, options = {}) {
       schemaVersionsTable: tables2.schemaVersions
     });
     return {
-      backend: chunkXMY2SXOH_cjs.gateFulltext(
+      backend: chunk5WWEYV4H_cjs.gateFulltext(
         backend2,
         contributionMaterializer.assertInitialized,
         contributionMaterializer.refuseUnavailableFulltext
@@ -812,28 +829,28 @@ function createPostgresBackend(db, options = {}) {
               { capability: "trustedImport", dialect: "postgres" }
             );
           }
-          const trustedTx = chunkZBFZGLZE_cjs.deriveBackend(tx, {
+          const trustedTx = chunkNLX5OWK7_cjs.deriveBackend(tx, {
             executeRaw(sqlText, params) {
               return executeCompiled({ params, sql: sqlText });
             }
           });
-          await chunkXMY2SXOH_cjs.lockPostgresTrustedImportTables(trustedTx, tableNames);
-          await chunkXMY2SXOH_cjs.assertTrustedImportDatabaseEmpty(trustedTx, tableNames);
-          const indexDefinitions = await chunkXMY2SXOH_cjs.suspendPostgresSecondaryIndexes(
+          await chunk5WWEYV4H_cjs.lockPostgresTrustedImportTables(trustedTx, tableNames);
+          await chunk5WWEYV4H_cjs.assertTrustedImportDatabaseEmpty(trustedTx, tableNames);
+          const indexDefinitions = await chunk5WWEYV4H_cjs.suspendPostgresSecondaryIndexes(
             trustedTx,
             tableNames
           );
           const result = await fn(
-            chunkXMY2SXOH_cjs.createPostgresTrustedImportSession(trustedTx, tableNames)
+            chunk5WWEYV4H_cjs.createPostgresTrustedImportSession(trustedTx, tableNames)
           );
-          await chunkXMY2SXOH_cjs.restoreSecondaryIndexes(trustedTx, indexDefinitions);
-          await chunkXMY2SXOH_cjs.analyzeImportedTables(trustedTx, tableNames);
+          await chunk5WWEYV4H_cjs.restoreSecondaryIndexes(trustedTx, indexDefinitions);
+          await chunk5WWEYV4H_cjs.analyzeImportedTables(trustedTx, tableNames);
           return result;
         });
       }
     } : {},
     async bootstrapTables() {
-      const statements = chunkTP4NJTI3_cjs.generatePostgresDDL(tables2, fulltextStrategy);
+      const statements = chunk5WWEYV4H_cjs.generatePostgresDDL(tables2, fulltextStrategy);
       for (const statement of statements) {
         await executeConcurrentCreateDdl(statement);
       }
@@ -863,12 +880,34 @@ function createPostgresBackend(db, options = {}) {
         (contribution) => [...contribution.createDdl]
       );
     },
+    recordedTableDdl(recordedTableNames) {
+      const contributions = recordedContributionsFor(recordedTableNames);
+      function ddlFor(logicalName) {
+        const contribution = chunkN66HCGCY_cjs.requireDefined(
+          contributions.find((entry) => entry.logicalName === logicalName),
+          `recordedTableDdl: no contribution for ${logicalName}.`
+        );
+        return {
+          createTable: chunkN66HCGCY_cjs.requireDefined(
+            contribution.createDdl[0],
+            `recordedTableDdl: empty DDL for ${logicalName}.`
+          ),
+          indexes: contribution.createDdl.slice(1),
+          primaryKeyConstraintName: `${contribution.tableName}_pkey`
+        };
+      }
+      return {
+        recordedClock: ddlFor("recordedClock"),
+        recordedEdges: ddlFor("recordedEdges"),
+        recordedNodes: ddlFor("recordedNodes")
+      };
+    },
     // 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`.
-    ...chunkXMY2SXOH_cjs.gateFulltextMethods(
+    ...chunk5WWEYV4H_cjs.gateFulltextMethods(
       operations,
       contributionMaterializer.assertInitialized,
       contributionMaterializer.refuseUnavailableFulltext
@@ -928,26 +967,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 chunkXMY2SXOH_cjs.mapMaterializationRow(row, chunkXMY2SXOH_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode);
+      return chunk5WWEYV4H_cjs.mapMaterializationRow(row, chunk5WWEYV4H_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) => chunkXMY2SXOH_cjs.mapMaterializationRow(row, chunkXMY2SXOH_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode)
+        (row) => chunk5WWEYV4H_cjs.mapMaterializationRow(row, chunk5WWEYV4H_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.decode)
       );
     },
     async recordIndexMaterialization(params) {
       const t = tables2.indexMaterializations;
       await db.insert(t).values(
-        chunkXMY2SXOH_cjs.buildMaterializationInsertValues(
+        chunk5WWEYV4H_cjs.buildMaterializationInsertValues(
           params,
-          chunkXMY2SXOH_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.encode
+          chunk5WWEYV4H_cjs.POSTGRES_INDEX_MAT_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: t.indexName,
-        set: chunkXMY2SXOH_cjs.buildMaterializationOnConflictSet(params.materializedAt)
+        set: chunk5WWEYV4H_cjs.buildMaterializationOnConflictSet(params.materializedAt)
       });
     },
     async ensureContributionMaterializationsTable() {
@@ -969,26 +1008,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) => chunkXMY2SXOH_cjs.mapKindRemovalRow(row, chunkXMY2SXOH_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunk5WWEYV4H_cjs.mapKindRemovalRow(row, chunk5WWEYV4H_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) => chunkXMY2SXOH_cjs.mapKindRemovalRow(row, chunkXMY2SXOH_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
+        (row) => chunk5WWEYV4H_cjs.mapKindRemovalRow(row, chunk5WWEYV4H_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.decode)
       );
     },
     async recordKindRemoval(params) {
       const t = tables2.kindRemovals;
       await db.insert(t).values(
-        chunkXMY2SXOH_cjs.buildKindRemovalInsertValues(
+        chunk5WWEYV4H_cjs.buildKindRemovalInsertValues(
           params,
-          chunkXMY2SXOH_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.encode
+          chunk5WWEYV4H_cjs.POSTGRES_KIND_REMOVAL_TIMESTAMPS.encode
         )
       ).onConflictDoUpdate({
         target: [t.graphId, t.kindName, t.entity, t.schemaVersion],
-        set: chunkXMY2SXOH_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
+        set: chunk5WWEYV4H_cjs.buildKindRemovalOnConflictSet(t.removedAt, params.removedAt)
       });
     },
     async ensureReconciliationMarkersTable() {
@@ -1067,8 +1106,8 @@ function createPostgresBackend(db, options = {}) {
       const presentGuardedTables = tablePresence.filter((entry) => entry.exists).map((entry) => entry.tableName);
       for (const tableName of presentGuardedTables) {
         await db.execute(
-          chunk45YZXI6X_cjs.toDrizzleSql(
-            chunkOJHD3LXJ_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkOJHD3LXJ_cjs.sql.identifier(tableName)}`,
+          chunkLLFPQOBA_cjs.toDrizzleSql(
+            chunkH5IJSROF_cjs.sql`ANALYZE (SKIP_LOCKED) ${chunkH5IJSROF_cjs.sql.identifier(tableName)}`,
             "postgres"
           )
         );
@@ -1083,7 +1122,7 @@ function createPostgresBackend(db, options = {}) {
     async commitSchemaVersionIfKindsEmpty(params, probes) {
       return runSchemaWriteTransaction(
         params.graphId,
-        (target) => chunkXMY2SXOH_cjs.commitSchemaVersionIfKindsEmpty(target, params, probes)
+        (target) => chunk5WWEYV4H_cjs.commitSchemaVersionIfKindsEmpty(target, params, probes)
       );
     },
     async commitSchemaVersionWithPreflight(params, preflight) {
@@ -1105,7 +1144,7 @@ function createPostgresBackend(db, options = {}) {
       return backend.transactionWithNative((tx) => fn(tx), options2);
     },
     async transactionWithNative(fn, options2) {
-      const temporaryWrites = options2?.temporaryWrites === chunkGHZPZNFC_cjs.INTERNAL_TEMPORARY_WRITES;
+      const temporaryWrites = options2?.temporaryWrites === chunkNUQ2YFFH_cjs.INTERNAL_TEMPORARY_WRITES;
       if (temporaryWrites && options2.accessMode !== "read_only") {
         throw new chunkX4GDXBOP_cjs.ConfigurationError(
           "Temporary-write transactions must be semantically read-only.",
@@ -1140,7 +1179,7 @@ function createPostgresBackend(db, options = {}) {
           }
         );
       }
-      chunkXMY2SXOH_cjs.assertAdoptedDialect(
+      chunk5WWEYV4H_cjs.assertAdoptedDialect(
         externalTx,
         pgCore.PgTransaction,
         "postgres"
@@ -1150,7 +1189,8 @@ function createPostgresBackend(db, options = {}) {
     async close() {
     }
   };
-  chunkZBFZGLZE_cjs.auditBackendResource(backend, resourceAudit);
+  chunkNLX5OWK7_cjs.auditBackendResource(backend, resourceAudit);
+  chunkNUQ2YFFH_cjs.markFirstPartyFactory(backend);
   return backend;
 }
 function getSerializedPostgresClient(db) {
@@ -1257,10 +1297,10 @@ function createPostgresOperationBackend(options) {
   }
   async function vectorSearchGucOverrides(params) {
     const overrides = [];
-    const efSearchParameter = chunkTEC24ZDA_cjs.resolveEfSearchOverride({
+    const efSearchParameter = chunkH2VWDQWC_cjs.resolveEfSearchOverride({
       efSearch: params.efSearch,
       indexType: params.indexType,
-      tuning: chunkTEC24ZDA_cjs.vectorSearchFrontierTuning(vectorStrategy),
+      tuning: chunkH2VWDQWC_cjs.vectorSearchFrontierTuning(vectorStrategy),
       transactions: capabilities.transactions,
       dialect: "PostgreSQL",
       engine: vectorStrategy?.name ?? "this backend"
@@ -1329,17 +1369,17 @@ function createPostgresOperationBackend(options) {
     });
   }
   const batchConfig = computePostgresBatchChunkSizes(
-    capabilities.maxBindParameters ?? chunkGHZPZNFC_cjs.POSTGRES_MAX_BIND_PARAMETERS
+    capabilities.maxBindParameters ?? chunkNUQ2YFFH_cjs.POSTGRES_MAX_BIND_PARAMETERS
   );
-  const commonOperationMembers = chunkXMY2SXOH_cjs.createCommonOperationBackend({
+  const commonOperationMembers = chunk5WWEYV4H_cjs.createCommonOperationBackend({
     batchConfig,
     execution: {
       execAll,
       execGet,
       execRun
     },
-    nowIso: chunkEH3JZJUM_cjs.nowIso,
-    maxBindParameters: capabilities.maxBindParameters ?? chunkGHZPZNFC_cjs.POSTGRES_MAX_BIND_PARAMETERS,
+    nowIso: chunk36SX6QXP_cjs.nowIso,
+    maxBindParameters: capabilities.maxBindParameters ?? chunkNUQ2YFFH_cjs.POSTGRES_MAX_BIND_PARAMETERS,
     operationStrategy,
     rowMappers: {
       toEdgeRow,
@@ -1357,28 +1397,28 @@ function createPostgresOperationBackend(options) {
   };
   const vectorEmbeddingMethods = vectorStrategy === void 0 ? {} : {
     async upsertEmbedding(params) {
-      const slot = chunkXMY2SXOH_cjs.vectorSlotFromParams(params);
+      const slot = chunk5WWEYV4H_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
-      const statements = vectorStrategy.buildUpsert(slot, params, chunkEH3JZJUM_cjs.nowIso());
+      const statements = vectorStrategy.buildUpsert(slot, params, chunk36SX6QXP_cjs.nowIso());
       try {
         for (const statement of statements) {
           await execRun(statement);
         }
       } catch (error) {
-        throw chunkXMY2SXOH_cjs.mapVectorWriteError(error, params);
+        throw chunk5WWEYV4H_cjs.mapVectorWriteError(error, params);
       }
     },
     async upsertEmbeddingBatch(params) {
       if (params.rows.length === 0) return;
-      const slot = chunkXMY2SXOH_cjs.vectorSlotFromParams(params);
+      const slot = chunk5WWEYV4H_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const rowsById = new Map(
         params.rows.map((row) => [row.nodeId, row])
       );
       const rows = [...rowsById.values()];
-      const timestamp = chunkEH3JZJUM_cjs.nowIso();
+      const timestamp = chunk36SX6QXP_cjs.nowIso();
       try {
-        for (const chunk2 of chunkZBFZGLZE_cjs.chunk(
+        for (const chunk2 of chunkNLX5OWK7_cjs.chunk(
           rows,
           batchConfig.embeddingUpsertBatchSize
         )) {
@@ -1407,11 +1447,11 @@ function createPostgresOperationBackend(options) {
           }
         }
       } catch (error) {
-        throw chunkXMY2SXOH_cjs.mapVectorWriteError(error, params);
+        throw chunk5WWEYV4H_cjs.mapVectorWriteError(error, params);
       }
     },
     async deleteEmbedding(params) {
-      const slot = chunkXMY2SXOH_cjs.vectorSlotFromParams(params);
+      const slot = chunk5WWEYV4H_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
       const statements = vectorStrategy.buildDelete(slot, params);
       for (const statement of statements) {
@@ -1420,9 +1460,9 @@ function createPostgresOperationBackend(options) {
     },
     async deleteEmbeddingBatch(params) {
       if (params.nodeIds.length === 0) return;
-      const slot = chunkXMY2SXOH_cjs.vectorSlotFromParams(params);
+      const slot = chunk5WWEYV4H_cjs.vectorSlotFromParams(params);
       await contributionMaterializer.assertVectorSlot(slot);
-      for (const nodeIds of chunkZBFZGLZE_cjs.chunk(
+      for (const nodeIds of chunkNLX5OWK7_cjs.chunk(
         [...new Set(params.nodeIds)],
         batchConfig.embeddingUpsertBatchSize
       )) {
@@ -1434,19 +1474,19 @@ function createPostgresOperationBackend(options) {
       }
     },
     async vectorSearch(params) {
-      chunkTEC24ZDA_cjs.assertVectorSearchLimit(params.limit);
-      chunkHSEZ7X6Y_cjs.assertPgvectorEfSearch(params.efSearch);
-      const slot = chunkXMY2SXOH_cjs.vectorSlotFromParams(params);
+      chunkH2VWDQWC_cjs.assertVectorSearchLimit(params.limit);
+      chunkTIJUA4I6_cjs.assertPgvectorEfSearch(params.efSearch);
+      const slot = chunk5WWEYV4H_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 ?? chunkXMY2SXOH_cjs.buildLiveNodeCandidates(
+        params.candidates ?? chunk5WWEYV4H_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkEH3JZJUM_cjs.nowIso()
+          chunk36SX6QXP_cjs.nowIso()
         )
       );
       const gucOverrides = await vectorSearchGucOverrides(params);
@@ -1454,7 +1494,7 @@ function createPostgresOperationBackend(options) {
       try {
         rows = await runVectorSearch(gucOverrides, query);
       } catch (error) {
-        throw chunkXMY2SXOH_cjs.mapVectorWriteError(error, params);
+        throw chunk5WWEYV4H_cjs.mapVectorWriteError(error, params);
       }
       return rows.map((row) => ({
         nodeId: row.node_id,
@@ -1466,10 +1506,10 @@ function createPostgresOperationBackend(options) {
     // multi-statement fallback by simply not exposing the member.
     ...capabilities.windowFunctions ? {
       async hybridSearch(params) {
-        chunkTEC24ZDA_cjs.assertVectorSearchLimit(params.limit);
-        chunkTEC24ZDA_cjs.assertVectorSearchLimit(params.vector.k);
-        chunkHSEZ7X6Y_cjs.assertPgvectorEfSearch(params.vector.efSearch);
-        const slot = chunkXMY2SXOH_cjs.vectorSlotFromParams({
+        chunkH2VWDQWC_cjs.assertVectorSearchLimit(params.limit);
+        chunkH2VWDQWC_cjs.assertVectorSearchLimit(params.vector.k);
+        chunkTIJUA4I6_cjs.assertPgvectorEfSearch(params.vector.efSearch);
+        const slot = chunk5WWEYV4H_cjs.vectorSlotFromParams({
           graphId: params.graphId,
           nodeKind: params.nodeKind,
           fieldPath: params.vector.fieldPath,
@@ -1477,11 +1517,11 @@ function createPostgresOperationBackend(options) {
           metric: params.vector.metric,
           indexType: params.vector.indexType
         });
-        const candidates = params.candidates ?? chunkXMY2SXOH_cjs.buildLiveNodeCandidates(
+        const candidates = params.candidates ?? chunk5WWEYV4H_cjs.buildLiveNodeCandidates(
           tableNames.nodes,
           params.graphId,
           params.nodeKind,
-          chunkEH3JZJUM_cjs.nowIso()
+          chunk36SX6QXP_cjs.nowIso()
         );
         const vectorParams = {
           graphId: params.graphId,
@@ -1497,11 +1537,11 @@ function createPostgresOperationBackend(options) {
         const vectorSql = vectorStrategy.buildSearch(
           slot,
           vectorParams,
-          chunkOJHD3LXJ_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
+          chunkH5IJSROF_cjs.sql.raw("SELECT node_id FROM tg_hybrid_cand")
         );
         const statement = operationStrategy.buildHybridSearch(
           { ...params, candidates },
-          chunk45YZXI6X_cjs.toDrizzleSql(vectorSql, "postgres"),
+          chunkLLFPQOBA_cjs.toDrizzleSql(vectorSql, "postgres"),
           params.vector.metric === "cosine"
         );
         const gucOverrides = await vectorSearchGucOverrides({
@@ -1515,9 +1555,9 @@ function createPostgresOperationBackend(options) {
             statement
           );
         } catch (error) {
-          throw chunkXMY2SXOH_cjs.mapVectorWriteError(error, vectorParams);
+          throw chunk5WWEYV4H_cjs.mapVectorWriteError(error, vectorParams);
         }
-        return raw.map((row) => chunkXMY2SXOH_cjs.mapHybridSearchRow(row, toNodeRow));
+        return raw.map((row) => chunk5WWEYV4H_cjs.mapHybridSearchRow(row, toNodeRow));
       }
     } : {}
   };
@@ -1582,7 +1622,7 @@ function createPostgresOperationBackend(options) {
       }
       const locked = await lockActiveSchemaVersion(params.graphId);
       if (locked !== void 0) {
-        chunkXMY2SXOH_cjs.assertActiveSchemaVersion(
+        chunk5WWEYV4H_cjs.assertActiveSchemaVersion(
           params.graphId,
           params.expectedVersion,
           locked
@@ -1601,7 +1641,7 @@ function createPostgresOperationBackend(options) {
     // === Vector Index Operations ===
     async createVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkXMY2SXOH_cjs.vectorSlotFromCreateIndexParams(params);
+      const slot = chunk5WWEYV4H_cjs.vectorSlotFromCreateIndexParams(params);
       await contributionMaterializer.ensureVectorSlot(slot);
       const indexStatement = vectorStrategy.buildCreateIndex?.(slot, {
         concurrent: params.concurrent === true
@@ -1623,7 +1663,7 @@ function createPostgresOperationBackend(options) {
     },
     // === Fulltext Operations ===
     async upsertFulltext(params) {
-      const timestamp = chunkEH3JZJUM_cjs.nowIso();
+      const timestamp = chunk36SX6QXP_cjs.nowIso();
       const statements = operationStrategy.buildUpsertFulltext(
         params,
         timestamp
@@ -1640,8 +1680,8 @@ function createPostgresOperationBackend(options) {
     },
     async upsertFulltextBatch(params) {
       if (params.rows.length === 0) return;
-      const timestamp = chunkEH3JZJUM_cjs.nowIso();
-      for (const rows of chunkZBFZGLZE_cjs.chunk(
+      const timestamp = chunk36SX6QXP_cjs.nowIso();
+      for (const rows of chunkNLX5OWK7_cjs.chunk(
         params.rows,
         batchConfig.fulltextUpsertBatchSize
       )) {
@@ -1656,7 +1696,7 @@ function createPostgresOperationBackend(options) {
     },
     async deleteFulltextBatch(params) {
       if (params.nodeIds.length === 0) return;
-      for (const nodeIds of chunkZBFZGLZE_cjs.chunk(
+      for (const nodeIds of chunkNLX5OWK7_cjs.chunk(
         params.nodeIds,
         batchConfig.fulltextDeleteChunkSize
       )) {
@@ -1674,25 +1714,25 @@ function createPostgresOperationBackend(options) {
       const rows = await execAll(query);
       return rows.map((row, index) => ({
         nodeId: row.node_id,
-        score: chunkEH3JZJUM_cjs.coerceNumericScore(row.score),
+        score: chunk36SX6QXP_cjs.coerceNumericScore(row.score),
         rank: index + 1,
         ...row.snippet === null ? {} : { snippet: row.snippet }
       }));
     },
     async dropVectorIndex(params) {
       if (vectorStrategy === void 0) return;
-      const slot = chunkXMY2SXOH_cjs.vectorSlotFromDropIndexParams(params);
+      const slot = chunk5WWEYV4H_cjs.vectorSlotFromDropIndexParams(params);
       const dropStatement = vectorStrategy.buildDropIndex?.(slot);
       if (dropStatement === void 0) return;
       try {
         await execRun(dropStatement);
       } catch (error) {
-        if (!chunkZBFZGLZE_cjs.isMissingTableError(error)) throw error;
+        if (!chunkNLX5OWK7_cjs.isMissingTableError(error)) throw error;
       }
     },
     // === Query Execution ===
     async execute(query) {
-      const annTypes = chunkOJHD3LXJ_cjs.isSqlFragment(query) ? chunkOJHD3LXJ_cjs.annIndexScanTypes(query) : void 0;
+      const annTypes = chunkH5IJSROF_cjs.isSqlFragment(query) ? chunkH5IJSROF_cjs.annIndexScanTypes(query) : void 0;
       if (annTypes !== void 0 && vectorStrategy !== void 0) {
         const overrides = [];
         for (const indexType of annTypes) {
@@ -1733,5 +1773,5 @@ function createTransactionBackend(options) {
 }
 
 exports.createPostgresBackend = createPostgresBackend;
-//# sourceMappingURL=chunk-TYGGUWMS.cjs.map
-//# sourceMappingURL=chunk-TYGGUWMS.cjs.map
+//# sourceMappingURL=chunk-B3MN7EJR.cjs.map
+//# sourceMappingURL=chunk-B3MN7EJR.cjs.map