@nicia-ai/typegraph 0.46.2 → 0.48.0

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

@@ -1,11 +1,27 @@
 'use strict';
 
-var chunkA7NMUYEL_cjs = require('./chunk-A7NMUYEL.cjs');
-var chunkQU7QLJA4_cjs = require('./chunk-QU7QLJA4.cjs');
-var chunk5PDSCELM_cjs = require('./chunk-5PDSCELM.cjs');
-var chunkZHOAZD7Q_cjs = require('./chunk-ZHOAZD7Q.cjs');
-var chunk2ZWM2RFH_cjs = require('./chunk-2ZWM2RFH.cjs');
-var chunkKCH7WQA5_cjs = require('./chunk-KCH7WQA5.cjs');
+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;
+}
 
 // src/backend/migrate-recorded-time.ts
 var LEGACY_RECORDED_MAX = "9999-12-31T23:59:59.999Z";
@@ -51,25 +67,22 @@ var RECORDED_EDGE_COLUMNS = [
   "tx_id",
   "meta"
 ];
-function resolvedTableNames(backend, override) {
-  return chunkQU7QLJA4_cjs.createSqlSchema(override ?? backend.tableNames ?? {}).tables;
-}
 function shortenedIdentifier(value) {
   if (value.length <= 63) return value;
-  return `${value.slice(0, 50)}_${chunkZHOAZD7Q_cjs.shortHash(value)}`;
+  return `${value.slice(0, 50)}_${chunkL3LQNR34_cjs.shortHash(value)}`;
 }
 function mappingTableName(tables, override) {
   const candidate = override ?? `${tables.recordedClock}_${MIGRATION_SUFFIX}`;
-  return chunkQU7QLJA4_cjs.createSqlSchema({
+  return chunk3U5ABFDW_cjs.createSqlSchema({
     recordedClock: shortenedIdentifier(candidate)
   }).tables.recordedClock;
 }
 function temporaryTableName(tableName, role) {
-  return shortenedIdentifier(`__tg_${role}_${chunkZHOAZD7Q_cjs.shortHash(tableName)}`);
+  return shortenedIdentifier(`__tg_${role}_${chunkL3LQNR34_cjs.shortHash(tableName)}`);
 }
 function requireStatements(target) {
   if (target.executeStatement === void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "Recorded-time migration requires executeStatement support.",
       { dialect: target.dialect },
       { suggestion: "Use a built-in SQLite or PostgreSQL backend." }
@@ -78,15 +91,15 @@ function requireStatements(target) {
   return target.executeStatement;
 }
 async function executeStatement(target, statement) {
-  await requireStatements(target)(chunk2ZWM2RFH_cjs.asCompiledStatementSql(statement));
+  await requireStatements(target)(chunkEDN4Y4ZG_cjs.asCompiledStatementSql(statement));
 }
 async function executeDdl(target, ddl) {
-  await executeStatement(target, chunk2ZWM2RFH_cjs.sql.raw(ddl));
+  await executeStatement(target, chunkEDN4Y4ZG_cjs.sql.raw(ddl));
 }
 function canonicalLegacyInstant(value) {
-  const canonical = chunk5PDSCELM_cjs.canonicalizeDatabaseTimestamp(value);
+  const canonical = chunkTQHGE7UC_cjs.canonicalizeDatabaseTimestamp(value);
   if (canonical === void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "Legacy recorded-time relation contained an invalid timestamp.",
       { value }
     );
@@ -95,8 +108,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 >= chunk5PDSCELM_cjs.RECORDED_MAX_REVISION) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+  if (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 1 || revision >= chunk2QGYQBS2_cjs.RECORDED_MAX_REVISION) {
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "Recorded anchor mapping contained an invalid revision.",
       { value }
     );
@@ -105,9 +118,9 @@ function safeRevision(value) {
 }
 async function columnNames(target, tableName) {
   const rows = target.dialect === "sqlite" ? await target.execute(
-    chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`PRAGMA table_info(${chunk2ZWM2RFH_cjs.sql.identifier(tableName)})`)
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`PRAGMA table_info(${chunkEDN4Y4ZG_cjs.sql.identifier(tableName)})`)
   ) : await target.execute(
-    chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
           SELECT column_name AS name
           FROM information_schema.columns
           WHERE table_schema = current_schema()
@@ -120,28 +133,28 @@ async function columnNames(target, tableName) {
 }
 async function readLegacyInstants(target, tables) {
   const rows = await target.execute(
-    chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
       SELECT graph_id, recorded_from AS recorded_at
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedNodes)}
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedNodes)}
       UNION
       SELECT graph_id, recorded_to AS recorded_at
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedNodes)}
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedNodes)}
       WHERE recorded_to <> ${LEGACY_RECORDED_MAX}
       UNION
       SELECT graph_id, recorded_from AS recorded_at
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedEdges)}
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedEdges)}
       UNION
       SELECT graph_id, recorded_to AS recorded_at
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedEdges)}
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedEdges)}
       WHERE recorded_to <> ${LEGACY_RECORDED_MAX}
       UNION
       SELECT graph_id, recorded_at
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedClock)}
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedClock)}
     `)
   );
   const instants = rows.map((row) => {
     if (typeof row.graph_id !== "string") {
-      throw new chunkKCH7WQA5_cjs.ConfigurationError(
+      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
         "Legacy recorded-time relation contained an invalid graph id.",
         { graphId: row.graph_id }
       );
@@ -192,38 +205,38 @@ function migrationMapDdl(dialect, table) {
 );`;
 }
 async function writeMappingRows(target, tableName, rows) {
-  await executeStatement(target, chunk2ZWM2RFH_cjs.sql`DELETE FROM ${chunk2ZWM2RFH_cjs.sql.identifier(tableName)}`);
+  await executeStatement(target, chunkEDN4Y4ZG_cjs.sql`DELETE FROM ${chunkEDN4Y4ZG_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) => chunk2ZWM2RFH_cjs.sql`(${row.graphId}, ${row.legacyRecordedAt}, ${row.revision}, ${row.recordedAt})`
+      (row) => chunkEDN4Y4ZG_cjs.sql`(${row.graphId}, ${row.legacyRecordedAt}, ${row.revision}, ${row.recordedAt})`
     );
     await executeStatement(
       target,
-      chunk2ZWM2RFH_cjs.sql`
-        INSERT INTO ${chunk2ZWM2RFH_cjs.sql.identifier(tableName)}
+      chunkEDN4Y4ZG_cjs.sql`
+        INSERT INTO ${chunkEDN4Y4ZG_cjs.sql.identifier(tableName)}
           (graph_id, legacy_recorded_at, revision, recorded_at)
-        VALUES ${chunk2ZWM2RFH_cjs.sql.join(values, chunk2ZWM2RFH_cjs.sql`, `)}
+        VALUES ${chunkEDN4Y4ZG_cjs.sql.join(values, chunkEDN4Y4ZG_cjs.sql`, `)}
       `
     );
   }
 }
 function tableDdl(dialect, tables, temporary) {
   if (dialect === "sqlite") {
-    const temporaryTables2 = chunkA7NMUYEL_cjs.createSqliteTables(temporary);
-    const finalTables2 = chunkA7NMUYEL_cjs.createSqliteTables(tables);
-    const temporaryContributions = chunkA7NMUYEL_cjs.sqliteContributions(temporaryTables2);
-    const finalContributions = chunkA7NMUYEL_cjs.sqliteContributions(finalTables2);
+    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);
   }
-  const temporaryTables = chunkA7NMUYEL_cjs.createPostgresTables(temporary);
-  const finalTables = chunkA7NMUYEL_cjs.createPostgresTables(tables);
+  const temporaryTables = chunkHDL2ARHX_cjs.createPostgresTables(temporary);
+  const finalTables = chunkHDL2ARHX_cjs.createPostgresTables(tables);
   return ddlForRecordedTables(
-    chunkA7NMUYEL_cjs.postgresContributions(temporaryTables),
-    chunkA7NMUYEL_cjs.postgresContributions(finalTables)
+    chunkHDL2ARHX_cjs.postgresContributions(temporaryTables),
+    chunkHDL2ARHX_cjs.postgresContributions(finalTables)
   );
 }
 function ddlForRecordedTables(temporary, final) {
@@ -235,13 +248,13 @@ function ddlForRecordedTables(temporary, final) {
       (entry) => entry.logicalName === logicalName
     )?.createDdl;
     if (temporaryDdl === void 0 || finalDdl === void 0) {
-      throw new chunkKCH7WQA5_cjs.ConfigurationError(
+      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
         `Could not generate migration DDL for ${logicalName}.`
       );
     }
     const createTable = temporaryDdl[0];
     if (createTable === void 0) {
-      throw new chunkKCH7WQA5_cjs.ConfigurationError(
+      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
         `Could not generate migration table DDL for ${logicalName}.`
       );
     }
@@ -254,27 +267,27 @@ function ddlForRecordedTables(temporary, final) {
   };
 }
 function migratedColumn(column, legacyAlias) {
-  if (column === "recorded_from") return chunk2ZWM2RFH_cjs.sql`from_map.revision`;
+  if (column === "recorded_from") return chunkEDN4Y4ZG_cjs.sql`from_map.revision`;
   if (column === "recorded_to") {
-    return chunk2ZWM2RFH_cjs.sql`
+    return chunkEDN4Y4ZG_cjs.sql`
       CASE
-            WHEN ${chunk2ZWM2RFH_cjs.sql.raw(legacyAlias)}.recorded_to = ${LEGACY_RECORDED_MAX}
-            THEN ${chunk5PDSCELM_cjs.RECORDED_MAX_REVISION}
+            WHEN ${chunkEDN4Y4ZG_cjs.sql.raw(legacyAlias)}.recorded_to = ${LEGACY_RECORDED_MAX}
+            THEN ${chunk2QGYQBS2_cjs.RECORDED_MAX_REVISION}
             ELSE to_map.revision
           END
     `;
   }
-  return chunk2ZWM2RFH_cjs.sql`${chunk2ZWM2RFH_cjs.sql.raw(legacyAlias)}.${chunk2ZWM2RFH_cjs.sql.identifier(column)}`;
+  return chunkEDN4Y4ZG_cjs.sql`${chunkEDN4Y4ZG_cjs.sql.raw(legacyAlias)}.${chunkEDN4Y4ZG_cjs.sql.identifier(column)}`;
 }
 function mappingMatch(dialect, mappingAlias, legacyColumn) {
-  const mapping = chunk2ZWM2RFH_cjs.sql.raw(mappingAlias);
-  const legacy = chunk2ZWM2RFH_cjs.sql.raw(`legacy.${legacyColumn}`);
-  return dialect === "postgres" ? chunk2ZWM2RFH_cjs.sql`${mapping}.recorded_at = ${legacy}` : chunk2ZWM2RFH_cjs.sql`${mapping}.legacy_recorded_at = ${legacy}`;
+  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}`;
 }
 function missingMappingCount(value, legacyTable) {
   const count = Number(value);
   if (!Number.isSafeInteger(count) || count < 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "Recorded-time migration returned an invalid integrity-check count.",
       { legacyTable, value }
     );
@@ -285,12 +298,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(
-    chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
       SELECT COUNT(*) AS missing
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(options.legacyTable)} AS legacy
-      LEFT JOIN ${chunk2ZWM2RFH_cjs.sql.identifier(options.mappingTable)} AS from_map
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(options.legacyTable)} AS legacy
+      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS from_map
         ON from_map.graph_id = legacy.graph_id AND ${fromMatch}
-      LEFT JOIN ${chunk2ZWM2RFH_cjs.sql.identifier(options.mappingTable)} AS to_map
+      LEFT JOIN ${chunkEDN4Y4ZG_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 (
@@ -301,7 +314,7 @@ async function assertRecordedRelationMappings(target, options) {
   );
   const missing = missingMappingCount(rows[0]?.missing, options.legacyTable);
   if (missing === 0) return;
-  throw new chunkKCH7WQA5_cjs.ConfigurationError(
+  throw new chunkMRDBBHIZ_cjs.ConfigurationError(
     "Legacy recorded-time boundaries could not be mapped exactly.",
     { legacyTable: options.legacyTable, missingRows: missing },
     {
@@ -312,17 +325,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(
-    chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
       SELECT COUNT(*) AS missing
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(options.legacyTable)} AS legacy
-      LEFT JOIN ${chunk2ZWM2RFH_cjs.sql.identifier(options.mappingTable)} AS anchor_map
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(options.legacyTable)} AS legacy
+      LEFT JOIN ${chunkEDN4Y4ZG_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 chunkKCH7WQA5_cjs.ConfigurationError(
+  throw new chunkMRDBBHIZ_cjs.ConfigurationError(
     "Legacy recorded clock values could not be mapped exactly.",
     { legacyTable: options.legacyTable, missingRows: missing },
     {
@@ -331,7 +344,7 @@ async function assertRecordedClockMappings(target, options) {
   );
 }
 async function copyRecordedRelation(target, options) {
-  const columnList = options.columns.map((column) => chunk2ZWM2RFH_cjs.sql.identifier(column));
+  const columnList = options.columns.map((column) => chunkEDN4Y4ZG_cjs.sql.identifier(column));
   const values = options.columns.map(
     (column) => migratedColumn(column, "legacy")
   );
@@ -340,16 +353,16 @@ async function copyRecordedRelation(target, options) {
   const toMatch = mappingMatch(target.dialect, "to_map", "recorded_to");
   await executeStatement(
     target,
-    chunk2ZWM2RFH_cjs.sql`
-      INSERT INTO ${chunk2ZWM2RFH_cjs.sql.identifier(options.temporaryTable)}
-        (${chunk2ZWM2RFH_cjs.sql.join(columnList, chunk2ZWM2RFH_cjs.sql`, `)})
-      SELECT ${chunk2ZWM2RFH_cjs.sql.join(values, chunk2ZWM2RFH_cjs.sql`, `)}
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(options.legacyTable)} AS legacy
+    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
       -- LEFT JOIN is deliberate: a missing mapping reaches the NOT NULL
       -- revision columns and fails loud instead of silently dropping history.
-      LEFT JOIN ${chunk2ZWM2RFH_cjs.sql.identifier(options.mappingTable)} AS from_map
+      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS from_map
         ON from_map.graph_id = legacy.graph_id AND ${fromMatch}
-      LEFT JOIN ${chunk2ZWM2RFH_cjs.sql.identifier(options.mappingTable)} AS to_map
+      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS to_map
         ON to_map.graph_id = legacy.graph_id AND ${toMatch}
     `
   );
@@ -359,13 +372,13 @@ async function copyRecordedClock(target, options) {
   const match = mappingMatch(target.dialect, "anchor_map", "recorded_at");
   await executeStatement(
     target,
-    chunk2ZWM2RFH_cjs.sql`
-      INSERT INTO ${chunk2ZWM2RFH_cjs.sql.identifier(options.temporaryTable)}
+    chunkEDN4Y4ZG_cjs.sql`
+      INSERT INTO ${chunkEDN4Y4ZG_cjs.sql.identifier(options.temporaryTable)}
         (graph_id, revision, recorded_at)
       SELECT legacy.graph_id, anchor_map.revision, legacy.recorded_at
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(options.legacyTable)} AS legacy
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(options.legacyTable)} AS legacy
       -- Preserve fail-loud behavior if the preflight invariant changes later.
-      LEFT JOIN ${chunk2ZWM2RFH_cjs.sql.identifier(options.mappingTable)} AS anchor_map
+      LEFT JOIN ${chunkEDN4Y4ZG_cjs.sql.identifier(options.mappingTable)} AS anchor_map
         ON anchor_map.graph_id = legacy.graph_id AND ${match}
     `
   );
@@ -380,7 +393,7 @@ async function replaceLegacyTables(target, tables, mappingTable) {
   for (const table of Object.values(temporary)) {
     await executeStatement(
       target,
-      chunk2ZWM2RFH_cjs.sql`DROP TABLE IF EXISTS ${chunk2ZWM2RFH_cjs.sql.identifier(table)}`
+      chunkEDN4Y4ZG_cjs.sql`DROP TABLE IF EXISTS ${chunkEDN4Y4ZG_cjs.sql.identifier(table)}`
     );
   }
   await executeDdl(target, requireCreateTable(ddl.nodes));
@@ -405,15 +418,15 @@ async function replaceLegacyTables(target, tables, mappingTable) {
   });
   await executeStatement(
     target,
-    chunk2ZWM2RFH_cjs.sql`DROP TABLE ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedNodes)}`
+    chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedNodes)}`
   );
   await executeStatement(
     target,
-    chunk2ZWM2RFH_cjs.sql`DROP TABLE ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedEdges)}`
+    chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedEdges)}`
   );
   await executeStatement(
     target,
-    chunk2ZWM2RFH_cjs.sql`DROP TABLE ${chunk2ZWM2RFH_cjs.sql.identifier(tables.recordedClock)}`
+    chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(tables.recordedClock)}`
   );
   await renameTable(target, temporary.recordedNodes, tables.recordedNodes);
   await renameTable(target, temporary.recordedEdges, tables.recordedEdges);
@@ -445,17 +458,17 @@ async function renamePrimaryKeyConstraint(target, temporaryTable, finalTable) {
   if (target.dialect !== "postgres") return;
   await executeStatement(
     target,
-    chunk2ZWM2RFH_cjs.sql`
-      ALTER TABLE ${chunk2ZWM2RFH_cjs.sql.identifier(finalTable)}
-      RENAME CONSTRAINT ${chunk2ZWM2RFH_cjs.sql.identifier(`${temporaryTable}_pkey`)}
-      TO ${chunk2ZWM2RFH_cjs.sql.identifier(shortenedIdentifier(`${finalTable}_pkey`))}
+    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`))}
     `
   );
 }
 function requireCreateTable(statements) {
   const statement = statements[0];
   if (statement === void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError("Recorded migration table DDL was empty.");
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError("Recorded migration table DDL was empty.");
   }
   return statement;
 }
@@ -463,10 +476,10 @@ async function renameTable(target, from, to) {
   try {
     await executeStatement(
       target,
-      chunk2ZWM2RFH_cjs.sql`ALTER TABLE ${chunk2ZWM2RFH_cjs.sql.identifier(from)} RENAME TO ${chunk2ZWM2RFH_cjs.sql.identifier(to)}`
+      chunkEDN4Y4ZG_cjs.sql`ALTER TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(from)} RENAME TO ${chunkEDN4Y4ZG_cjs.sql.identifier(to)}`
     );
   } catch (error) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "Could not rename a migrated recorded-time table.",
       { from, to },
       { cause: error }
@@ -497,9 +510,9 @@ async function migrateLegacyRecordedTime(options) {
         };
       }
       const rows = await target.execute(
-        chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`
+        chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
           SELECT COUNT(*) AS anchors, COUNT(DISTINCT graph_id) AS graphs
-          FROM ${chunk2ZWM2RFH_cjs.sql.identifier(mapTable)}
+          FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
         `)
       );
       const anchors = Number(rows[0]?.anchors ?? 0);
@@ -514,7 +527,7 @@ 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 chunkKCH7WQA5_cjs.ConfigurationError(
+      throw new chunkMRDBBHIZ_cjs.ConfigurationError(
         "Legacy recorded-time schema is incomplete.",
         { tables }
       );
@@ -533,24 +546,24 @@ async function migrateLegacyRecordedTime(options) {
 }
 async function migrateRecordedAnchor(options) {
   try {
-    return chunk5PDSCELM_cjs.asRecordedInstant(options.anchor);
+    return chunk2QGYQBS2_cjs.asRecordedInstant(options.anchor);
   } catch (error) {
-    if (!(error instanceof chunkKCH7WQA5_cjs.ValidationError)) throw error;
+    if (!(error instanceof chunkMRDBBHIZ_cjs.ValidationError)) throw error;
   }
   const legacyRecordedAt = canonicalLegacyInstant(options.anchor);
   const tables = resolvedTableNames(options.backend, options.tableNames);
   const mapTable = mappingTableName(tables, options.mappingTableName);
   const rows = await options.backend.execute(
-    chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
       SELECT revision, recorded_at
-      FROM ${chunk2ZWM2RFH_cjs.sql.identifier(mapTable)}
+      FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
       WHERE graph_id = ${options.graphId}
         AND legacy_recorded_at = ${legacyRecordedAt}
     `)
   );
   const row = rows[0];
   if (row === void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "No migrated recorded anchor matches this graph and legacy timestamp.",
       { anchor: options.anchor, graphId: options.graphId },
       {
@@ -558,14 +571,14 @@ async function migrateRecordedAnchor(options) {
       }
     );
   }
-  return chunk5PDSCELM_cjs.createRecordedInstant(
+  return chunk2QGYQBS2_cjs.createRecordedInstant(
     safeRevision(row.revision),
     canonicalLegacyInstant(row.recorded_at)
   );
 }
 async function deleteLegacyRecordedAnchorMap(options) {
   if (options.backend.executeStatement === void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "Deleting a recorded anchor migration map requires executeStatement support.",
       { dialect: options.backend.dialect }
     );
@@ -575,30 +588,219 @@ async function deleteLegacyRecordedAnchorMap(options) {
   await options.backend.transaction(async (target) => {
     await executeStatement(
       target,
-      chunk2ZWM2RFH_cjs.sql`
-        DELETE FROM ${chunk2ZWM2RFH_cjs.sql.identifier(mapTable)}
+      chunkEDN4Y4ZG_cjs.sql`
+        DELETE FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
         WHERE graph_id = ${options.graphId}
       `
     );
     if (options.dropWhenEmpty !== true) return;
     const rows = await target.execute(
-      chunk2ZWM2RFH_cjs.asCompiledRowsSql(chunk2ZWM2RFH_cjs.sql`
+      chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
         SELECT COUNT(*) AS anchors, COUNT(DISTINCT graph_id) AS graphs
-        FROM ${chunk2ZWM2RFH_cjs.sql.identifier(mapTable)}
+        FROM ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}
       `)
     );
     const remaining = missingMappingCount(rows[0]?.anchors, mapTable);
     if (remaining === 0) {
       await executeStatement(
         target,
-        chunk2ZWM2RFH_cjs.sql`DROP TABLE ${chunk2ZWM2RFH_cjs.sql.identifier(mapTable)}`
+        chunkEDN4Y4ZG_cjs.sql`DROP TABLE ${chunkEDN4Y4ZG_cjs.sql.identifier(mapTable)}`
       );
     }
   });
 }
 
+// src/backend/repair-validity-windows.ts
+var LIVE_RELATIONS = [
+  "nodes",
+  "edges"
+];
+var RECORDED_RELATIONS = [
+  "recordedNodes",
+  "recordedEdges"
+];
+var CANONICAL_INSTANT_GLOB = "[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]T[0-9][0-9]:[0-9][0-9]:[0-9][0-9].[0-9][0-9][0-9]Z";
+function scopedRelations(scope) {
+  return scope === "live" ? LIVE_RELATIONS : [...LIVE_RELATIONS, ...RECORDED_RELATIONS];
+}
+function relationTable(tables, relation) {
+  switch (relation) {
+    case "nodes": {
+      return tables.nodes;
+    }
+    case "edges": {
+      return tables.edges;
+    }
+    case "recordedNodes": {
+      return tables.recordedNodes;
+    }
+    case "recordedEdges": {
+      return tables.recordedEdges;
+    }
+  }
+}
+function graphScopeClauses(graphId) {
+  return graphId === void 0 ? [] : [chunkEDN4Y4ZG_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}`
+  ];
+}
+function invertedValidityWindowPredicate(options) {
+  return chunkEDN4Y4ZG_cjs.sql.join(
+    [
+      chunkEDN4Y4ZG_cjs.sql`valid_from IS NOT NULL`,
+      chunkEDN4Y4ZG_cjs.sql`valid_to IS NOT NULL`,
+      ...canonicalBoundsClauses(options.dialect),
+      chunkEDN4Y4ZG_cjs.sql`valid_from > valid_to`,
+      ...graphScopeClauses(options.graphId)
+    ],
+    chunkEDN4Y4ZG_cjs.sql` AND `
+  );
+}
+function nonCanonicalWindowPredicate(graphId) {
+  return chunkEDN4Y4ZG_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})`,
+      ...graphScopeClauses(graphId)
+    ],
+    chunkEDN4Y4ZG_cjs.sql` AND `
+  );
+}
+function safeCount(value, table) {
+  const count = Number(value);
+  if (!Number.isSafeInteger(count) || count < 0) {
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+      "Validity-window repair returned an invalid row count.",
+      { table, value }
+    );
+  }
+  return count;
+}
+async function countMatching(target, table, predicate) {
+  const rows = await target.execute(
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(chunkEDN4Y4ZG_cjs.sql`
+      SELECT COUNT(*) AS matches
+      FROM ${chunkEDN4Y4ZG_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 translatedCaptureRefusal(error) {
+  if (!(error instanceof chunkMRDBBHIZ_cjs.ConfigurationError) || error.details["code"] !== "RECORDED_CAPTURE_RAW_SQL_DISABLED") {
+    return error;
+  }
+  return new chunkMRDBBHIZ_cjs.ConfigurationError(
+    "Repairing inverted validity windows cannot run against a history-capturing backend.",
+    { code: "RECORDED_CAPTURE_RAW_SQL_DISABLED", mode: "apply" },
+    {
+      cause: error,
+      suggestion: 'Pass the raw backend you constructed the history store from. The repair deliberately mints no revision \u2014 it normalizes storage for rows that were never visible at any coordinate \u2014 so bypassing recorded-time capture is the intended behavior, not a workaround. mode: "report" needs no such care: it runs against the capture-wrapped backend.'
+    }
+  );
+}
+async function repairRelation(target, table, predicate) {
+  try {
+    await requireStatements2(target)(
+      chunkEDN4Y4ZG_cjs.asCompiledStatementSql(chunkEDN4Y4ZG_cjs.sql`
+        UPDATE ${chunkEDN4Y4ZG_cjs.sql.identifier(table)}
+        SET valid_from = NULL
+        WHERE ${predicate}
+      `)
+    );
+  } catch (error) {
+    throw translatedCaptureRefusal(error);
+  }
+}
+function assertClassifiableBounds(nonCanonical) {
+  const unclassified = [...nonCanonical].filter(([, count]) => count > 0);
+  if (unclassified.length === 0) return;
+  throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    "Refusing to repair validity windows: some scanned rows store non-canonical bounds.",
+    { nonCanonical: Object.fromEntries(unclassified) },
+    {
+      suggestion: 'Normalize those bounds to canonical UTC ISO 8601 (YYYY-MM-DDTHH:MM:SS.mmmZ) and re-run, or narrow the call with graphId. Classifying them here would need a timestamp semantics this repair does not own, and skipping them silently would report a repair it did not make. mode: "report" still counts them.'
+    }
+  );
+}
+function transactionOptionsFor(mode) {
+  return mode === "report" ? { transaction: { accessMode: "read_only" } } : void 0;
+}
+function relationRecord(counts) {
+  return {
+    nodes: counts.get("nodes"),
+    edges: counts.get("edges"),
+    recordedNodes: counts.get("recordedNodes"),
+    recordedEdges: counts.get("recordedEdges")
+  };
+}
+async function repairInvertedValidityWindows(options) {
+  const tables = resolvedTableNames(options.backend, options.tableNames);
+  const relations = scopedRelations(options.relations);
+  if (options.mode === "apply") requireStatements2(options.backend);
+  return chunk5PRKMB24_cjs.runOptionallyInTransaction(
+    options.backend,
+    async (target, execution) => {
+      const predicate = invertedValidityWindowPredicate({
+        dialect: target.dialect,
+        graphId: options.graphId
+      });
+      const inverted = /* @__PURE__ */ new Map();
+      const nonCanonical = /* @__PURE__ */ new Map();
+      for (const relation of relations) {
+        const table = relationTable(tables, relation);
+        nonCanonical.set(
+          relation,
+          target.dialect === "sqlite" ? await countMatching(
+            target,
+            table,
+            nonCanonicalWindowPredicate(options.graphId)
+          ) : 0
+        );
+        inverted.set(relation, await countMatching(target, table, predicate));
+      }
+      if (options.mode === "apply") {
+        assertClassifiableBounds(nonCanonical);
+        for (const relation of relations) {
+          await repairRelation(
+            target,
+            relationTable(tables, relation),
+            predicate
+          );
+        }
+      }
+      return {
+        relations: options.relations,
+        counts: relationRecord(inverted),
+        nonCanonical: relationRecord(nonCanonical),
+        atomic: execution.atomic
+      };
+    },
+    transactionOptionsFor(options.mode)
+  );
+}
+
 exports.deleteLegacyRecordedAnchorMap = deleteLegacyRecordedAnchorMap;
 exports.migrateLegacyRecordedTime = migrateLegacyRecordedTime;
 exports.migrateRecordedAnchor = migrateRecordedAnchor;
-//# sourceMappingURL=chunk-N3QTGPC7.cjs.map
-//# sourceMappingURL=chunk-N3QTGPC7.cjs.map
+exports.repairInvertedValidityWindows = repairInvertedValidityWindows;
+//# sourceMappingURL=chunk-UMGZDVOA.cjs.map
+//# sourceMappingURL=chunk-UMGZDVOA.cjs.map