@nicia-ai/typegraph 0.49.0 → 0.51.0

package/dist/{chunk-UMGZDVOA.cjs → chunk-OGL4X4PH.cjs}

@@ -1,27 +1,13 @@
 'use strict';
 
-var chunkHDL2ARHX_cjs = require('./chunk-HDL2ARHX.cjs');
-var chunk3U5ABFDW_cjs = require('./chunk-3U5ABFDW.cjs');
-var chunk5PRKMB24_cjs = require('./chunk-5PRKMB24.cjs');
-var chunk2QGYQBS2_cjs = require('./chunk-2QGYQBS2.cjs');
-var chunkTQHGE7UC_cjs = require('./chunk-TQHGE7UC.cjs');
-var chunkL3LQNR34_cjs = require('./chunk-L3LQNR34.cjs');
-var chunkEDN4Y4ZG_cjs = require('./chunk-EDN4Y4ZG.cjs');
-var chunkMRDBBHIZ_cjs = require('./chunk-MRDBBHIZ.cjs');
-
-// src/backend/table-names.ts
-function definedTableNameOverrides(override) {
-  if (override === void 0) return {};
-  return Object.fromEntries(
-    Object.entries(override).filter(([, tableName]) => tableName !== void 0)
-  );
-}
-function resolvedTableNames(backend, override) {
-  return chunk3U5ABFDW_cjs.createSqlSchema({
-    ...backend.tableNames,
-    ...definedTableNameOverrides(override)
-  }).tables;
-}
+var chunkEKG2UXNX_cjs = require('./chunk-EKG2UXNX.cjs');
+var chunkZGVTNKTX_cjs = require('./chunk-ZGVTNKTX.cjs');
+var chunkNUQ2YFFH_cjs = require('./chunk-NUQ2YFFH.cjs');
+var chunkDWUDZ66O_cjs = require('./chunk-DWUDZ66O.cjs');
+var chunkM5MSP3BI_cjs = require('./chunk-M5MSP3BI.cjs');
+var chunkH2VWDQWC_cjs = require('./chunk-H2VWDQWC.cjs');
+var chunkH5IJSROF_cjs = require('./chunk-H5IJSROF.cjs');
+var chunkX4GDXBOP_cjs = require('./chunk-X4GDXBOP.cjs');
 
 // src/backend/migrate-recorded-time.ts
 var LEGACY_RECORDED_MAX = "9999-12-31T23:59:59.999Z";
@@ -69,20 +55,20 @@ var RECORDED_EDGE_COLUMNS = [
 ];
 function shortenedIdentifier(value) {
   if (value.length <= 63) return value;
-  return `${value.slice(0, 50)}_${chunkL3LQNR34_cjs.shortHash(value)}`;
+  return `${value.slice(0, 50)}_${chunkH2VWDQWC_cjs.shortHash(value)}`;
 }
 function mappingTableName(tables, override) {
   const candidate = override ?? `${tables.recordedClock}_${MIGRATION_SUFFIX}`;
-  return chunk3U5ABFDW_cjs.createSqlSchema({
+  return chunkNUQ2YFFH_cjs.createSqlSchema({
     recordedClock: shortenedIdentifier(candidate)
   }).tables.recordedClock;
 }
 function temporaryTableName(tableName, role) {
-  return shortenedIdentifier(`__tg_${role}_${chunkL3LQNR34_cjs.shortHash(tableName)}`);
+  return shortenedIdentifier(`__tg_${role}_${chunkH2VWDQWC_cjs.shortHash(tableName)}`);
 }
 function requireStatements(target) {
   if (target.executeStatement === void 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    throw new chunkX4GDXBOP_cjs.ConfigurationError(
       "Recorded-time migration requires executeStatement support.",
       { dialect: target.dialect },
       { suggestion: "Use a built-in SQLite or PostgreSQL backend." }
@@ -91,15 +77,15 @@ function requireStatements(target) {
   return target.executeStatement;
 }
 async function executeStatement(target, statement) {
-  await requireStatements(target)(chunkEDN4Y4ZG_cjs.asCompiledStatementSql(statement));
+  await requireStatements(target)(chunkH5IJSROF_cjs.asCompiledStatementSql(statement));
 }
 async function executeDdl(target, ddl) {
-  await executeStatement(target, chunkEDN4Y4ZG_cjs.sql.raw(ddl));
+  await executeStatement(target, chunkH5IJSROF_cjs.sql.raw(ddl));
 }
 function canonicalLegacyInstant(value) {
-  const canonical = chunkTQHGE7UC_cjs.canonicalizeDatabaseTimestamp(value);
+  const canonical = chunkM5MSP3BI_cjs.canonicalizeDatabaseTimestamp(value);
   if (canonical === void 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    throw new chunkX4GDXBOP_cjs.ConfigurationError(
       "Legacy recorded-time relation contained an invalid timestamp.",
       { value }
     );
@@ -108,8 +94,8 @@ function canonicalLegacyInstant(value) {
 }
 function safeRevision(value) {
   const revision = typeof value === "bigint" ? Number(value) : typeof value === "string" && /^\d+$/.test(value) ? Number(value) : value;
-  if (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 1 || revision >= chunk2QGYQBS2_cjs.RECORDED_MAX_REVISION) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+  if (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 1 || revision >= chunkDWUDZ66O_cjs.RECORDED_MAX_REVISION) {
+    throw new chunkX4GDXBOP_cjs.ConfigurationError(
       "Recorded anchor mapping contained an invalid revision.",
       { value }
     );
@@ -118,9 +104,9 @@ function safeRevision(value) {
 }
 async function columnNames(target, tableName) {
   const rows = target.dialect === "sqlite" ? await target.execute(
-    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`PRAGMA table_info(${chunkEDN4Y4ZG_cjs.sql.identifier(tableName)})`)
+    chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`PRAGMA table_info(${chunkH5IJSROF_cjs.sql.identifier(tableName)})`)
   ) : await target.execute(
-    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+    chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
           SELECT column_name AS name
           FROM information_schema.columns
           WHERE table_schema = current_schema()
@@ -133,28 +119,28 @@ async function columnNames(target, tableName) {
 }
 async function readLegacyInstants(target, tables) {
   const rows = await target.execute(
-    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+    chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
       SELECT graph_id, recorded_from AS recorded_at
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedNodes)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedNodes)}
       UNION
       SELECT graph_id, recorded_to AS recorded_at
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedNodes)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedNodes)}
       WHERE recorded_to <> ${LEGACY_RECORDED_MAX}
       UNION
       SELECT graph_id, recorded_from AS recorded_at
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedEdges)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedEdges)}
       UNION
       SELECT graph_id, recorded_to AS recorded_at
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedEdges)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedEdges)}
       WHERE recorded_to <> ${LEGACY_RECORDED_MAX}
       UNION
       SELECT graph_id, recorded_at
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedClock)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedClock)}
     `)
   );
   const instants = rows.map((row) => {
     if (typeof row.graph_id !== "string") {
-      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+      throw new chunkX4GDXBOP_cjs.ConfigurationError(
         "Legacy recorded-time relation contained an invalid graph id.",
         { graphId: row.graph_id }
       );
@@ -205,89 +191,91 @@ function migrationMapDdl(dialect, table) {
 );`;
 }
 async function writeMappingRows(target, tableName, rows) {
-  await executeStatement(target, chunkEDN4Y4ZG_cjs.sql`DELETE FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tableName)}`);
+  await executeStatement(target, chunkH5IJSROF_cjs.sql`DELETE FROM ${chunkH5IJSROF_cjs.sql.identifier(tableName)}`);
   const rowsPerStatement = Math.max(
     1,
     Math.floor((target.capabilities.maxBindParameters ?? 900) / 4)
   );
   for (let start = 0; start < rows.length; start += rowsPerStatement) {
     const values = rows.slice(start, start + rowsPerStatement).map(
-      (row) => chunkEDN4Y4ZG_cjs.sql`(${row.graphId}, ${row.legacyRecordedAt}, ${row.revision}, ${row.recordedAt})`
+      (row) => chunkH5IJSROF_cjs.sql`(${row.graphId}, ${row.legacyRecordedAt}, ${row.revision}, ${row.recordedAt})`
     );
     await executeStatement(
       target,
-      chunkEDN4Y4ZG_cjs.sql`
-        INSERT INTO ${chunkEDN4Y4ZG_cjs.sql.identifier(tableName)}
+      chunkH5IJSROF_cjs.sql`
+        INSERT INTO ${chunkH5IJSROF_cjs.sql.identifier(tableName)}
           (graph_id, legacy_recorded_at, revision, recorded_at)
-        VALUES ${chunkEDN4Y4ZG_cjs.sql.join(values, chunkEDN4Y4ZG_cjs.sql`, `)}
+        VALUES ${chunkH5IJSROF_cjs.sql.join(values, chunkH5IJSROF_cjs.sql`, `)}
       `
     );
   }
 }
-function tableDdl(dialect, tables, temporary) {
-  if (dialect === "sqlite") {
-    const temporaryTables2 = chunkHDL2ARHX_cjs.createSqliteTables(temporary);
-    const finalTables2 = chunkHDL2ARHX_cjs.createSqliteTables(tables);
-    const temporaryContributions = chunkHDL2ARHX_cjs.sqliteContributions(temporaryTables2);
-    const finalContributions = chunkHDL2ARHX_cjs.sqliteContributions(finalTables2);
-    return ddlForRecordedTables(temporaryContributions, finalContributions);
+function recordedMigrationDdl(recordedTableDdl, finalNames, temporaryNames) {
+  const temporaryDdl = recordedTableDdl(temporaryNames);
+  const finalDdl = recordedTableDdl(finalNames);
+  function composed(key) {
+    return {
+      createTable: temporaryDdl[key].createTable,
+      indexes: finalDdl[key].indexes
+    };
   }
-  const temporaryTables = chunkHDL2ARHX_cjs.createPostgresTables(temporary);
-  const finalTables = chunkHDL2ARHX_cjs.createPostgresTables(tables);
-  return ddlForRecordedTables(
-    chunkHDL2ARHX_cjs.postgresContributions(temporaryTables),
-    chunkHDL2ARHX_cjs.postgresContributions(finalTables)
-  );
-}
-function ddlForRecordedTables(temporary, final) {
-  function statements(logicalName) {
-    const temporaryDdl = temporary.find(
-      (entry) => entry.logicalName === logicalName
-    )?.createDdl;
-    const finalDdl = final.find(
-      (entry) => entry.logicalName === logicalName
-    )?.createDdl;
-    if (temporaryDdl === void 0 || finalDdl === void 0) {
-      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
-        `Could not generate migration DDL for ${logicalName}.`
-      );
-    }
-    const createTable = temporaryDdl[0];
-    if (createTable === void 0) {
-      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
-        `Could not generate migration table DDL for ${logicalName}.`
+  function primaryKeyConstraintRename(key) {
+    const temporaryConstraintName = temporaryDdl[key].primaryKeyConstraintName;
+    const finalConstraintName = finalDdl[key].primaryKeyConstraintName;
+    if (temporaryConstraintName === void 0 && finalConstraintName === void 0)
+      return { status: "none" };
+    if (temporaryConstraintName === void 0 || finalConstraintName === void 0)
+      throw new chunkX4GDXBOP_cjs.ConfigurationError(
+        "Recorded relation DDL must name both primary-key constraints or neither.",
+        {
+          code: "RECORDED_DDL_CONSTRAINT_NAME_MISMATCH",
+          relation: key,
+          finalTable: finalNames[key],
+          temporaryConstraintName,
+          finalConstraintName
+        }
       );
-    }
-    return [createTable, ...finalDdl.slice(1)];
+    return {
+      status: "rename",
+      from: temporaryConstraintName,
+      to: finalConstraintName
+    };
   }
   return {
-    clock: statements("recordedClock"),
-    edges: statements("recordedEdges"),
-    nodes: statements("recordedNodes")
+    ddl: {
+      recordedClock: composed("recordedClock"),
+      recordedEdges: composed("recordedEdges"),
+      recordedNodes: composed("recordedNodes")
+    },
+    primaryKeyConstraintRenames: {
+      recordedClock: primaryKeyConstraintRename("recordedClock"),
+      recordedEdges: primaryKeyConstraintRename("recordedEdges"),
+      recordedNodes: primaryKeyConstraintRename("recordedNodes")
+    }
   };
 }
 function migratedColumn(column, legacyAlias) {
-  if (column === "recorded_from") return chunkEDN4Y4ZG_cjs.sql`from_map.revision`;
+  if (column === "recorded_from") return chunkH5IJSROF_cjs.sql`from_map.revision`;
   if (column === "recorded_to") {
-    return chunkEDN4Y4ZG_cjs.sql`
+    return chunkH5IJSROF_cjs.sql`
       CASE
-            WHEN ${chunkEDN4Y4ZG_cjs.sql.raw(legacyAlias)}.recorded_to = ${LEGACY_RECORDED_MAX}
-            THEN ${chunk2QGYQBS2_cjs.RECORDED_MAX_REVISION}
+            WHEN ${chunkH5IJSROF_cjs.sql.raw(legacyAlias)}.recorded_to = ${LEGACY_RECORDED_MAX}
+            THEN ${chunkDWUDZ66O_cjs.RECORDED_MAX_REVISION}
             ELSE to_map.revision
           END
     `;
   }
-  return chunkEDN4Y4ZG_cjs.sql`${chunkEDN4Y4ZG_cjs.sql.raw(legacyAlias)}.${chunkEDN4Y4ZG_cjs.sql.identifier(column)}`;
+  return chunkH5IJSROF_cjs.sql`${chunkH5IJSROF_cjs.sql.raw(legacyAlias)}.${chunkH5IJSROF_cjs.sql.identifier(column)}`;
 }
 function mappingMatch(dialect, mappingAlias, legacyColumn) {
-  const mapping = chunkEDN4Y4ZG_cjs.sql.raw(mappingAlias);
-  const legacy = chunkEDN4Y4ZG_cjs.sql.raw(`legacy.${legacyColumn}`);
-  return dialect === "postgres" ? chunkEDN4Y4ZG_cjs.sql`${mapping}.recorded_at = ${legacy}` : chunkEDN4Y4ZG_cjs.sql`${mapping}.legacy_recorded_at = ${legacy}`;
+  const mapping = chunkH5IJSROF_cjs.sql.raw(mappingAlias);
+  const legacy = chunkH5IJSROF_cjs.sql.raw(`legacy.${legacyColumn}`);
+  return dialect === "postgres" ? chunkH5IJSROF_cjs.sql`${mapping}.recorded_at = ${legacy}` : chunkH5IJSROF_cjs.sql`${mapping}.legacy_recorded_at = ${legacy}`;
 }
 function missingMappingCount(value, legacyTable) {
   const count = Number(value);
   if (!Number.isSafeInteger(count) || count < 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    throw new chunkX4GDXBOP_cjs.ConfigurationError(
       "Recorded-time migration returned an invalid integrity-check count.",
       { legacyTable, value }
     );
@@ -298,12 +286,12 @@ async function assertRecordedRelationMappings(target, options) {
   const fromMatch = mappingMatch(target.dialect, "from_map", "recorded_from");
   const toMatch = mappingMatch(target.dialect, "to_map", "recorded_to");
   const rows = await target.execute(
-    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+    chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
       SELECT COUNT(*) AS missing
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(options.legacyTable)} AS legacy
-      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS from_map
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(options.legacyTable)} AS legacy
+      LEFT JOIN ${chunkH5IJSROF_cjs.sql.identifier(options.mappingTable)} AS from_map
         ON from_map.graph_id = legacy.graph_id AND ${fromMatch}
-      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS to_map
+      LEFT JOIN ${chunkH5IJSROF_cjs.sql.identifier(options.mappingTable)} AS to_map
         ON to_map.graph_id = legacy.graph_id AND ${toMatch}
       WHERE from_map.revision IS NULL
          OR (
@@ -314,7 +302,7 @@ async function assertRecordedRelationMappings(target, options) {
   );
   const missing = missingMappingCount(rows[0]?.missing, options.legacyTable);
   if (missing === 0) return;
-  throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+  throw new chunkX4GDXBOP_cjs.ConfigurationError(
     "Legacy recorded-time boundaries could not be mapped exactly.",
     { legacyTable: options.legacyTable, missingRows: missing },
     {
@@ -325,17 +313,17 @@ async function assertRecordedRelationMappings(target, options) {
 async function assertRecordedClockMappings(target, options) {
   const match = mappingMatch(target.dialect, "anchor_map", "recorded_at");
   const rows = await target.execute(
-    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+    chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
       SELECT COUNT(*) AS missing
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(options.legacyTable)} AS legacy
-      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS anchor_map
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(options.legacyTable)} AS legacy
+      LEFT JOIN ${chunkH5IJSROF_cjs.sql.identifier(options.mappingTable)} AS anchor_map
         ON anchor_map.graph_id = legacy.graph_id AND ${match}
       WHERE anchor_map.revision IS NULL
     `)
   );
   const missing = missingMappingCount(rows[0]?.missing, options.legacyTable);
   if (missing === 0) return;
-  throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+  throw new chunkX4GDXBOP_cjs.ConfigurationError(
     "Legacy recorded clock values could not be mapped exactly.",
     { legacyTable: options.legacyTable, missingRows: missing },
     {
@@ -344,7 +332,7 @@ async function assertRecordedClockMappings(target, options) {
   );
 }
 async function copyRecordedRelation(target, options) {
-  const columnList = options.columns.map((column) => chunkEDN4Y4ZG_cjs.sql.identifier(column));
+  const columnList = options.columns.map((column) => chunkH5IJSROF_cjs.sql.identifier(column));
   const values = options.columns.map(
     (column) => migratedColumn(column, "legacy")
   );
@@ -353,16 +341,16 @@ async function copyRecordedRelation(target, options) {
   const toMatch = mappingMatch(target.dialect, "to_map", "recorded_to");
   await executeStatement(
     target,
-    chunkEDN4Y4ZG_cjs.sql`
-      INSERT INTO ${chunkEDN4Y4ZG_cjs.sql.identifier(options.temporaryTable)}
-        (${chunkEDN4Y4ZG_cjs.sql.join(columnList, chunkEDN4Y4ZG_cjs.sql`, `)})
-      SELECT ${chunkEDN4Y4ZG_cjs.sql.join(values, chunkEDN4Y4ZG_cjs.sql`, `)}
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(options.legacyTable)} AS legacy
+    chunkH5IJSROF_cjs.sql`
+      INSERT INTO ${chunkH5IJSROF_cjs.sql.identifier(options.temporaryTable)}
+        (${chunkH5IJSROF_cjs.sql.join(columnList, chunkH5IJSROF_cjs.sql`, `)})
+      SELECT ${chunkH5IJSROF_cjs.sql.join(values, chunkH5IJSROF_cjs.sql`, `)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(options.legacyTable)} AS legacy
       -- LEFT JOIN is deliberate: a missing mapping reaches the NOT NULL
       -- revision columns and fails loud instead of silently dropping history.
-      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS from_map
+      LEFT JOIN ${chunkH5IJSROF_cjs.sql.identifier(options.mappingTable)} AS from_map
         ON from_map.graph_id = legacy.graph_id AND ${fromMatch}
-      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS to_map
+      LEFT JOIN ${chunkH5IJSROF_cjs.sql.identifier(options.mappingTable)} AS to_map
         ON to_map.graph_id = legacy.graph_id AND ${toMatch}
     `
   );
@@ -372,33 +360,42 @@ async function copyRecordedClock(target, options) {
   const match = mappingMatch(target.dialect, "anchor_map", "recorded_at");
   await executeStatement(
     target,
-    chunkEDN4Y4ZG_cjs.sql`
-      INSERT INTO ${chunkEDN4Y4ZG_cjs.sql.identifier(options.temporaryTable)}
+    chunkH5IJSROF_cjs.sql`
+      INSERT INTO ${chunkH5IJSROF_cjs.sql.identifier(options.temporaryTable)}
         (graph_id, revision, recorded_at)
       SELECT legacy.graph_id, anchor_map.revision, legacy.recorded_at
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(options.legacyTable)} AS legacy
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(options.legacyTable)} AS legacy
       -- Preserve fail-loud behavior if the preflight invariant changes later.
-      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS anchor_map
+      LEFT JOIN ${chunkH5IJSROF_cjs.sql.identifier(options.mappingTable)} AS anchor_map
         ON anchor_map.graph_id = legacy.graph_id AND ${match}
     `
   );
 }
-async function replaceLegacyTables(target, tables, mappingTable) {
+async function replaceLegacyTables(target, tables, mappingTable, recordedTableDdl) {
   const temporary = {
     recordedNodes: temporaryTableName(tables.recordedNodes, "rn"),
     recordedEdges: temporaryTableName(tables.recordedEdges, "re"),
     recordedClock: temporaryTableName(tables.recordedClock, "rc")
   };
-  const ddl = tableDdl(target.dialect, tables, temporary);
+  const finalNames = {
+    recordedNodes: tables.recordedNodes,
+    recordedEdges: tables.recordedEdges,
+    recordedClock: tables.recordedClock
+  };
+  const { ddl, primaryKeyConstraintRenames } = recordedMigrationDdl(
+    recordedTableDdl,
+    finalNames,
+    temporary
+  );
   for (const table of Object.values(temporary)) {
     await executeStatement(
       target,
-      chunkEDN4Y4ZG_cjs.sql`DROP TABLE IF EXISTS ${chunkEDN4Y4ZG_cjs.sql.identifier(table)}`
+      chunkH5IJSROF_cjs.sql`DROP TABLE IF EXISTS ${chunkH5IJSROF_cjs.sql.identifier(table)}`
     );
   }
-  await executeDdl(target, requireCreateTable(ddl.nodes));
-  await executeDdl(target, requireCreateTable(ddl.edges));
-  await executeDdl(target, requireCreateTable(ddl.clock));
+  await executeDdl(target, ddl.recordedNodes.createTable);
+  await executeDdl(target, ddl.recordedEdges.createTable);
+  await executeDdl(target, ddl.recordedClock.createTable);
   await copyRecordedRelation(target, {
     columns: RECORDED_NODE_COLUMNS,
     legacyTable: tables.recordedNodes,
@@ -418,68 +415,61 @@ async function replaceLegacyTables(target, tables, mappingTable) {
   });
   await executeStatement(
     target,
-    chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedNodes)}`
+    chunkH5IJSROF_cjs.sql`DROP TABLE ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedNodes)}`
   );
   await executeStatement(
     target,
-    chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedEdges)}`
+    chunkH5IJSROF_cjs.sql`DROP TABLE ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedEdges)}`
   );
   await executeStatement(
     target,
-    chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedClock)}`
+    chunkH5IJSROF_cjs.sql`DROP TABLE ${chunkH5IJSROF_cjs.sql.identifier(tables.recordedClock)}`
   );
   await renameTable(target, temporary.recordedNodes, tables.recordedNodes);
   await renameTable(target, temporary.recordedEdges, tables.recordedEdges);
   await renameTable(target, temporary.recordedClock, tables.recordedClock);
   await renamePrimaryKeyConstraint(
     target,
-    temporary.recordedNodes,
-    tables.recordedNodes
+    tables.recordedNodes,
+    primaryKeyConstraintRenames.recordedNodes
   );
   await renamePrimaryKeyConstraint(
     target,
-    temporary.recordedEdges,
-    tables.recordedEdges
+    tables.recordedEdges,
+    primaryKeyConstraintRenames.recordedEdges
   );
   await renamePrimaryKeyConstraint(
     target,
-    temporary.recordedClock,
-    tables.recordedClock
+    tables.recordedClock,
+    primaryKeyConstraintRenames.recordedClock
   );
   for (const statement of [
-    ...ddl.nodes.slice(1),
-    ...ddl.edges.slice(1),
-    ...ddl.clock.slice(1)
+    ...ddl.recordedNodes.indexes,
+    ...ddl.recordedEdges.indexes,
+    ...ddl.recordedClock.indexes
   ]) {
     await executeDdl(target, statement);
   }
 }
-async function renamePrimaryKeyConstraint(target, temporaryTable, finalTable) {
-  if (target.dialect !== "postgres") return;
+async function renamePrimaryKeyConstraint(target, finalTable, rename) {
+  if (rename.status === "none") return;
   await executeStatement(
     target,
-    chunkEDN4Y4ZG_cjs.sql`
-      ALTER TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(finalTable)}
-      RENAME CONSTRAINT ${chunkEDN4Y4ZG_cjs.sql.identifier(`${temporaryTable}_pkey`)}
-      TO ${chunkEDN4Y4ZG_cjs.sql.identifier(shortenedIdentifier(`${finalTable}_pkey`))}
+    chunkH5IJSROF_cjs.sql`
+      ALTER TABLE ${chunkH5IJSROF_cjs.sql.identifier(finalTable)}
+      RENAME CONSTRAINT ${chunkH5IJSROF_cjs.sql.identifier(rename.from)}
+      TO ${chunkH5IJSROF_cjs.sql.identifier(shortenedIdentifier(rename.to))}
     `
   );
 }
-function requireCreateTable(statements) {
-  const statement = statements[0];
-  if (statement === void 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError("Recorded migration table DDL was empty.");
-  }
-  return statement;
-}
 async function renameTable(target, from, to) {
   try {
     await executeStatement(
       target,
-      chunkEDN4Y4ZG_cjs.sql`ALTER TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(from)} RENAME TO ${chunkEDN4Y4ZG_cjs.sql.identifier(to)}`
+      chunkH5IJSROF_cjs.sql`ALTER TABLE ${chunkH5IJSROF_cjs.sql.identifier(from)} RENAME TO ${chunkH5IJSROF_cjs.sql.identifier(to)}`
     );
   } catch (error) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    throw new chunkX4GDXBOP_cjs.ConfigurationError(
       "Could not rename a migrated recorded-time table.",
       { from, to },
       { cause: error }
@@ -487,8 +477,9 @@ async function renameTable(target, from, to) {
   }
 }
 async function migrateLegacyRecordedTime(options) {
-  const tables = resolvedTableNames(options.backend, options.tableNames);
+  const tables = chunkEKG2UXNX_cjs.resolvedTableNames(options.backend, options.tableNames);
   const mapTable = mappingTableName(tables, options.mappingTableName);
+  const recordedTableDdl = options.backend.recordedTableDdl;
   return options.backend.transaction(async (target) => {
     const clockColumns = await columnNames(target, tables.recordedClock);
     if (clockColumns.size === 0) {
@@ -510,9 +501,9 @@ async function migrateLegacyRecordedTime(options) {
         };
       }
       const rows = await target.execute(
-        chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+        chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
           SELECT COUNT(*) AS anchors, COUNT(DISTINCT graph_id) AS graphs
-          FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
+          FROM ${chunkH5IJSROF_cjs.sql.identifier(mapTable)}
         `)
       );
       const anchors = Number(rows[0]?.anchors ?? 0);
@@ -527,15 +518,23 @@ async function migrateLegacyRecordedTime(options) {
     const nodeColumns = await columnNames(target, tables.recordedNodes);
     const edgeColumns = await columnNames(target, tables.recordedEdges);
     if (!nodeColumns.has("recorded_from") || !edgeColumns.has("recorded_from")) {
-      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+      throw new chunkX4GDXBOP_cjs.ConfigurationError(
         "Legacy recorded-time schema is incomplete.",
         { tables }
       );
     }
+    if (recordedTableDdl === void 0) {
+      throw new chunkX4GDXBOP_cjs.UnsupportedBackendCapabilityError(
+        "migrateLegacyRecordedTime",
+        "recordedTableDdl",
+        { dialect: target.dialect, tables },
+        "Migrating the timestamp-only preview recorded schema needs the backend to author its own recorded-relation DDL. Only the bundled SQLite and PostgreSQL backends created that schema."
+      );
+    }
     await executeDdl(target, migrationMapDdl(target.dialect, mapTable));
     const mapping = await readLegacyInstants(target, tables);
     await writeMappingRows(target, mapTable, mapping);
-    await replaceLegacyTables(target, tables, mapTable);
+    await replaceLegacyTables(target, tables, mapTable, recordedTableDdl);
     return {
       migrated: true,
       graphs: new Set(mapping.map((row) => row.graphId)).size,
@@ -546,24 +545,24 @@ async function migrateLegacyRecordedTime(options) {
 }
 async function migrateRecordedAnchor(options) {
   try {
-    return chunk2QGYQBS2_cjs.asRecordedInstant(options.anchor);
+    return chunkDWUDZ66O_cjs.asRecordedInstant(options.anchor);
   } catch (error) {
-    if (!(error instanceof chunkMRDBBHIZ_cjs.ValidationError)) throw error;
+    if (!(error instanceof chunkX4GDXBOP_cjs.ValidationError)) throw error;
   }
   const legacyRecordedAt = canonicalLegacyInstant(options.anchor);
-  const tables = resolvedTableNames(options.backend, options.tableNames);
+  const tables = chunkEKG2UXNX_cjs.resolvedTableNames(options.backend, options.tableNames);
   const mapTable = mappingTableName(tables, options.mappingTableName);
   const rows = await options.backend.execute(
-    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+    chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
       SELECT revision, recorded_at
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(mapTable)}
       WHERE graph_id = ${options.graphId}
         AND legacy_recorded_at = ${legacyRecordedAt}
     `)
   );
   const row = rows[0];
   if (row === void 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    throw new chunkX4GDXBOP_cjs.ConfigurationError(
       "No migrated recorded anchor matches this graph and legacy timestamp.",
       { anchor: options.anchor, graphId: options.graphId },
       {
@@ -571,40 +570,35 @@ async function migrateRecordedAnchor(options) {
       }
     );
   }
-  return chunk2QGYQBS2_cjs.createRecordedInstant(
+  return chunkDWUDZ66O_cjs.createRecordedInstant(
     safeRevision(row.revision),
     canonicalLegacyInstant(row.recorded_at)
   );
 }
 async function deleteLegacyRecordedAnchorMap(options) {
-  if (options.backend.executeStatement === void 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
-      "Deleting a recorded anchor migration map requires executeStatement support.",
-      { dialect: options.backend.dialect }
-    );
-  }
-  const tables = resolvedTableNames(options.backend, options.tableNames);
+  requireStatements(options.backend);
+  const tables = chunkEKG2UXNX_cjs.resolvedTableNames(options.backend, options.tableNames);
   const mapTable = mappingTableName(tables, options.mappingTableName);
   await options.backend.transaction(async (target) => {
     await executeStatement(
       target,
-      chunkEDN4Y4ZG_cjs.sql`
-        DELETE FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
+      chunkH5IJSROF_cjs.sql`
+        DELETE FROM ${chunkH5IJSROF_cjs.sql.identifier(mapTable)}
         WHERE graph_id = ${options.graphId}
       `
     );
     if (options.dropWhenEmpty !== true) return;
     const rows = await target.execute(
-      chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+      chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
         SELECT COUNT(*) AS anchors, COUNT(DISTINCT graph_id) AS graphs
-        FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
+        FROM ${chunkH5IJSROF_cjs.sql.identifier(mapTable)}
       `)
     );
     const remaining = missingMappingCount(rows[0]?.anchors, mapTable);
     if (remaining === 0) {
       await executeStatement(
         target,
-        chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}`
+        chunkH5IJSROF_cjs.sql`DROP TABLE ${chunkH5IJSROF_cjs.sql.identifier(mapTable)}`
       );
     }
   });
@@ -640,42 +634,42 @@ function relationTable(tables, relation) {
   }
 }
 function graphScopeClauses(graphId) {
-  return graphId === void 0 ? [] : [chunkEDN4Y4ZG_cjs.sql`graph_id = ${graphId}`];
+  return graphId === void 0 ? [] : [chunkH5IJSROF_cjs.sql`graph_id = ${graphId}`];
 }
 function canonicalBoundsClauses(dialect) {
   if (dialect !== "sqlite") return [];
   return [
-    chunkEDN4Y4ZG_cjs.sql`valid_from GLOB ${CANONICAL_INSTANT_GLOB}`,
-    chunkEDN4Y4ZG_cjs.sql`valid_to GLOB ${CANONICAL_INSTANT_GLOB}`
+    chunkH5IJSROF_cjs.sql`valid_from GLOB ${CANONICAL_INSTANT_GLOB}`,
+    chunkH5IJSROF_cjs.sql`valid_to GLOB ${CANONICAL_INSTANT_GLOB}`
   ];
 }
 function invertedValidityWindowPredicate(options) {
-  return chunkEDN4Y4ZG_cjs.sql.join(
+  return chunkH5IJSROF_cjs.sql.join(
     [
-      chunkEDN4Y4ZG_cjs.sql`valid_from IS NOT NULL`,
-      chunkEDN4Y4ZG_cjs.sql`valid_to IS NOT NULL`,
+      chunkH5IJSROF_cjs.sql`valid_from IS NOT NULL`,
+      chunkH5IJSROF_cjs.sql`valid_to IS NOT NULL`,
       ...canonicalBoundsClauses(options.dialect),
-      chunkEDN4Y4ZG_cjs.sql`valid_from > valid_to`,
+      chunkH5IJSROF_cjs.sql`valid_from > valid_to`,
       ...graphScopeClauses(options.graphId)
     ],
-    chunkEDN4Y4ZG_cjs.sql` AND `
+    chunkH5IJSROF_cjs.sql` AND `
   );
 }
 function nonCanonicalWindowPredicate(graphId) {
-  return chunkEDN4Y4ZG_cjs.sql.join(
+  return chunkH5IJSROF_cjs.sql.join(
     [
-      chunkEDN4Y4ZG_cjs.sql`valid_from IS NOT NULL`,
-      chunkEDN4Y4ZG_cjs.sql`valid_to IS NOT NULL`,
-      chunkEDN4Y4ZG_cjs.sql`(valid_from NOT GLOB ${CANONICAL_INSTANT_GLOB} OR valid_to NOT GLOB ${CANONICAL_INSTANT_GLOB})`,
+      chunkH5IJSROF_cjs.sql`valid_from IS NOT NULL`,
+      chunkH5IJSROF_cjs.sql`valid_to IS NOT NULL`,
+      chunkH5IJSROF_cjs.sql`(valid_from NOT GLOB ${CANONICAL_INSTANT_GLOB} OR valid_to NOT GLOB ${CANONICAL_INSTANT_GLOB})`,
       ...graphScopeClauses(graphId)
     ],
-    chunkEDN4Y4ZG_cjs.sql` AND `
+    chunkH5IJSROF_cjs.sql` AND `
   );
 }
 function safeCount(value, table) {
   const count = Number(value);
   if (!Number.isSafeInteger(count) || count < 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    throw new chunkX4GDXBOP_cjs.ConfigurationError(
       "Validity-window repair returned an invalid row count.",
       { table, value }
     );
@@ -684,31 +678,28 @@ function safeCount(value, table) {
 }
 async function countMatching(target, table, predicate) {
   const rows = await target.execute(
-    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+    chunkH5IJSROF_cjs.asCompiledRowsSql(chunkH5IJSROF_cjs.sql`
       SELECT COUNT(*) AS matches
-      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(table)}
+      FROM ${chunkH5IJSROF_cjs.sql.identifier(table)}
       WHERE ${predicate}
     `)
   );
   return safeCount(rows[0]?.matches, table);
 }
-function requireStatements2(target) {
-  if (target.executeStatement === void 0) {
-    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
-      "Repairing inverted validity windows requires executeStatement support.",
-      { dialect: target.dialect, mode: "apply" },
-      {
-        suggestion: 'Use a built-in SQLite or PostgreSQL backend to apply the repair. Detection needs no such support: call this with mode: "report" to count the affected rows on any backend.'
-      }
-    );
-  }
-  return target.executeStatement;
+function statementExecutionRequiredError(dialect) {
+  return new chunkX4GDXBOP_cjs.ConfigurationError(
+    "Repairing inverted validity windows requires executeStatement support.",
+    { dialect, mode: "apply" },
+    {
+      suggestion: 'Use a built-in SQLite or PostgreSQL backend to apply the repair. Detection needs no such support: call this with mode: "report" to count the affected rows on any backend.'
+    }
+  );
 }
 function translatedCaptureRefusal(error) {
-  if (!(error instanceof chunkMRDBBHIZ_cjs.ConfigurationError) || error.details["code"] !== "RECORDED_CAPTURE_RAW_SQL_DISABLED") {
+  if (!(error instanceof chunkX4GDXBOP_cjs.ConfigurationError) || error.details["code"] !== "RECORDED_CAPTURE_RAW_SQL_DISABLED") {
     return error;
   }
-  return new chunkMRDBBHIZ_cjs.ConfigurationError(
+  return new chunkX4GDXBOP_cjs.ConfigurationError(
     "Repairing inverted validity windows cannot run against a history-capturing backend.",
     { code: "RECORDED_CAPTURE_RAW_SQL_DISABLED", mode: "apply" },
     {
@@ -717,11 +708,14 @@ function translatedCaptureRefusal(error) {
     }
   );
 }
-async function repairRelation(target, table, predicate) {
+async function repairRelation(target, verdict, table, predicate) {
+  if (!verdict.supported) {
+    throw statementExecutionRequiredError(target.dialect);
+  }
   try {
-    await requireStatements2(target)(
-      chunkEDN4Y4ZG_cjs.asCompiledStatementSql(chunkEDN4Y4ZG_cjs.sql`
-        UPDATE ${chunkEDN4Y4ZG_cjs.sql.identifier(table)}
+    await chunkNUQ2YFFH_cjs.statementExecutionMembers(target, verdict).executeStatement(
+      chunkH5IJSROF_cjs.asCompiledStatementSql(chunkH5IJSROF_cjs.sql`
+        UPDATE ${chunkH5IJSROF_cjs.sql.identifier(table)}
         SET valid_from = NULL
         WHERE ${predicate}
       `)
@@ -733,7 +727,7 @@ async function repairRelation(target, table, predicate) {
 function assertClassifiableBounds(nonCanonical) {
   const unclassified = [...nonCanonical].filter(([, count]) => count > 0);
   if (unclassified.length === 0) return;
-  throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+  throw new chunkX4GDXBOP_cjs.ConfigurationError(
     "Refusing to repair validity windows: some scanned rows store non-canonical bounds.",
     { nonCanonical: Object.fromEntries(unclassified) },
     {
@@ -753,10 +747,13 @@ function relationRecord(counts) {
   };
 }
 async function repairInvertedValidityWindows(options) {
-  const tables = resolvedTableNames(options.backend, options.tableNames);
+  const tables = chunkEKG2UXNX_cjs.resolvedTableNames(options.backend, options.tableNames);
   const relations = scopedRelations(options.relations);
-  if (options.mode === "apply") requireStatements2(options.backend);
-  return chunk5PRKMB24_cjs.runOptionallyInTransaction(
+  const verdict = chunkZGVTNKTX_cjs.statementExecutionVerdict(options.backend);
+  if (options.mode === "apply" && !verdict.supported) {
+    throw statementExecutionRequiredError(options.backend.dialect);
+  }
+  return chunkNUQ2YFFH_cjs.runOptionallyInTransaction(
     options.backend,
     async (target, execution) => {
       const predicate = invertedValidityWindowPredicate({
@@ -782,6 +779,7 @@ async function repairInvertedValidityWindows(options) {
         for (const relation of relations) {
           await repairRelation(
             target,
+            verdict,
             relationTable(tables, relation),
             predicate
           );
@@ -802,5 +800,5 @@ exports.deleteLegacyRecordedAnchorMap = deleteLegacyRecordedAnchorMap;
 exports.migrateLegacyRecordedTime = migrateLegacyRecordedTime;
 exports.migrateRecordedAnchor = migrateRecordedAnchor;
 exports.repairInvertedValidityWindows = repairInvertedValidityWindows;
-//# sourceMappingURL=chunk-UMGZDVOA.cjs.map
-//# sourceMappingURL=chunk-UMGZDVOA.cjs.map
+//# sourceMappingURL=chunk-OGL4X4PH.cjs.map
+//# sourceMappingURL=chunk-OGL4X4PH.cjs.map