@stacksjs/database 0.70.258 → 0.70.260

package/dist/migration-ledger.js

@@ -1,382 +1 @@
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-import process from "node:process";
-import { join } from "node:path";
-const SAFE_MIGRATION_FILE = /^[\w.-]+\.sql$/, IDENT = String.raw`["\`\[]?([A-Za-z_]\w*)["\`\]]?`;
-export function stripForEffects(sql) {
-  let out = "", i = 0;
-  const blank = (text) => text.replace(/[^\n]/g, " ");
-  while (i < sql.length) {
-    const rest = sql.slice(i), line = rest.match(/^--[^\n]*/);
-    if (line) {
-      out += blank(line[0]);
-      i += line[0].length;
-      continue;
-    }
-    if (rest.startsWith("/*")) {
-      const end = rest.indexOf("*/"), chunk = end === -1 ? rest : rest.slice(0, end + 2);
-      out += blank(chunk);
-      i += chunk.length;
-      continue;
-    }
-    if (rest[0] === "'") {
-      let j = 1;
-      while (j < rest.length && rest[j] !== "'")
-        j++;
-      const chunk = rest.slice(0, Math.min(j + 1, rest.length));
-      out += blank(chunk);
-      i += chunk.length;
-      continue;
-    }
-    out += sql[i];
-    i += 1;
-  }
-  return out;
-}
-function statementsOf(sql) {
-  return stripForEffects(sql).split(";").map((s) => s.trim()).filter((s) => s.length > 0);
-}
-export function logicalName(file) {
-  return file.replace(/^\d+[-_]/, "").replace(/\.sql$/i, "");
-}
-export function migrationEffects(sql) {
-  const effects = [], seen = new Set, renamedAway = new Set, push = (effect) => {
-    const key = effectKey(effect);
-    if (seen.has(key))
-      return;
-    seen.add(key);
-    effects.push(effect);
-  };
-  for (const statement of statementsOf(sql)) {
-    const create = new RegExp(String.raw`^CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`, "i").exec(statement);
-    if (create?.[1]) {
-      push({ kind: "table", name: create[1] });
-      continue;
-    }
-    const rename = new RegExp(String.raw`^ALTER\s+TABLE\s+${IDENT}\s+RENAME\s+TO\s+${IDENT}`, "i").exec(statement);
-    if (rename?.[2]) {
-      if (rename[1])
-        renamedAway.add(rename[1].toLowerCase());
-      push({ kind: "table", name: rename[2] });
-      continue;
-    }
-    const index = new RegExp(String.raw`^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`, "i").exec(statement);
-    if (index?.[1]) {
-      push({ kind: "index", name: index[1] });
-      continue;
-    }
-    const enumType = new RegExp(String.raw`^CREATE\s+TYPE\s+${IDENT}\s+AS\s+ENUM`, "i").exec(statement);
-    if (enumType?.[1]) {
-      push({ kind: "enum", name: enumType[1] });
-      continue;
-    }
-    const alter = new RegExp(String.raw`^ALTER\s+TABLE\s+(?:IF\s+EXISTS\s+)?${IDENT}\s+(.*)$`, "is").exec(statement);
-    if (!alter?.[1] || !alter[2])
-      continue;
-    const table = alter[1], addColumn = new RegExp(String.raw`\bADD\s+COLUMN\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`, "gi");
-    for (const m of alter[2].matchAll(addColumn))
-      if (m[1])
-        push({ kind: "column", table, name: m[1] });
-    const addConstraint = new RegExp(String.raw`\bADD\s+CONSTRAINT\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`, "gi");
-    for (const m of alter[2].matchAll(addConstraint))
-      if (m[1])
-        push({ kind: "constraint", table, name: m[1] });
-    const addBare = new RegExp(String.raw`\bADD\s+(?!COLUMN\b|CONSTRAINT\b|INDEX\b|KEY\b|PRIMARY\b|UNIQUE\b|FOREIGN\b|FULLTEXT\b|SPATIAL\b|CHECK\b)${IDENT}\s+\w`, "gi");
-    for (const m of alter[2].matchAll(addBare))
-      if (m[1])
-        push({ kind: "column", table, name: m[1] });
-  }
-  if (renamedAway.size === 0)
-    return effects;
-  return effects.filter((effect) => {
-    const owner = (effect.kind === "table" ? effect.name : effect.table ?? "").toLowerCase();
-    return !renamedAway.has(owner);
-  });
-}
-function effectKey(effect) {
-  return `${effect.kind}:${(effect.table ?? "").toLowerCase()}.${effect.name.toLowerCase()}`;
-}
-export function verifiableEffects(effects, dialect) {
-  if (dialect === "postgres")
-    return effects;
-  if (dialect === "mysql")
-    return effects.filter((e) => e.kind !== "enum");
-  return effects.filter((e) => e.kind !== "constraint" && e.kind !== "enum");
-}
-function emptySchema() {
-  return { tables: new Set, columns: new Map, indexes: new Set, constraints: new Set, enums: new Set };
-}
-function rowsOf(result) {
-  return Array.isArray(result) ? result : [];
-}
-async function defaultRunner() {
-  const { db } = await import("./utils");
-  return async (sql) => rowsOf(await db.unsafe(sql).execute());
-}
-function pick(row, ...keys) {
-  for (const key of keys) {
-    const value = row?.[key] ?? row?.[key.toLowerCase()] ?? row?.[key.toUpperCase()];
-    if (typeof value === "string" && value.length > 0)
-      return value;
-  }
-  return "";
-}
-export async function readLiveSchema(dialect, runner) {
-  const schema = emptySchema(), run = runner ?? await defaultRunner();
-  if (dialect === "sqlite") {
-    for (const row of await run("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")) {
-      const name = pick(row, "name");
-      if (name)
-        schema.tables.add(name.toLowerCase());
-    }
-    for (const row of await run("SELECT name FROM sqlite_master WHERE type='index' AND name NOT LIKE 'sqlite_%'")) {
-      const name = pick(row, "name");
-      if (name)
-        schema.indexes.add(name.toLowerCase());
-    }
-    for (const table of schema.tables) {
-      if (!/^[a-z_]\w*$/i.test(table))
-        continue;
-      const cols = new Set;
-      for (const row of await run(`PRAGMA table_info("${table}")`)) {
-        const name = pick(row, "name");
-        if (name)
-          cols.add(name.toLowerCase());
-      }
-      schema.columns.set(table, cols);
-    }
-    return schema;
-  }
-  if (dialect === "mysql") {
-    for (const row of await run("SELECT TABLE_NAME AS name FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE()")) {
-      const name = pick(row, "name", "TABLE_NAME");
-      if (name)
-        schema.tables.add(name.toLowerCase());
-    }
-    for (const row of await run("SELECT TABLE_NAME, COLUMN_NAME FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = DATABASE()")) {
-      const table = pick(row, "TABLE_NAME").toLowerCase(), column = pick(row, "COLUMN_NAME").toLowerCase();
-      if (!table || !column)
-        continue;
-      if (!schema.columns.has(table))
-        schema.columns.set(table, new Set);
-      schema.columns.get(table).add(column);
-    }
-    for (const row of await run("SELECT DISTINCT INDEX_NAME AS name FROM information_schema.STATISTICS WHERE TABLE_SCHEMA = DATABASE()")) {
-      const name = pick(row, "name", "INDEX_NAME");
-      if (name)
-        schema.indexes.add(name.toLowerCase());
-    }
-    for (const row of await run("SELECT CONSTRAINT_NAME AS name FROM information_schema.TABLE_CONSTRAINTS WHERE CONSTRAINT_SCHEMA = DATABASE()")) {
-      const name = pick(row, "name", "CONSTRAINT_NAME");
-      if (name)
-        schema.constraints.add(name.toLowerCase());
-    }
-    return schema;
-  }
-  for (const row of await run("SELECT tablename AS name FROM pg_tables WHERE schemaname = 'public'")) {
-    const name = pick(row, "name", "tablename");
-    if (name)
-      schema.tables.add(name.toLowerCase());
-  }
-  for (const row of await run("SELECT table_name, column_name FROM information_schema.columns WHERE table_schema = 'public'")) {
-    const table = pick(row, "table_name").toLowerCase(), column = pick(row, "column_name").toLowerCase();
-    if (!table || !column)
-      continue;
-    if (!schema.columns.has(table))
-      schema.columns.set(table, new Set);
-    schema.columns.get(table).add(column);
-  }
-  for (const row of await run("SELECT indexname AS name FROM pg_indexes WHERE schemaname = 'public'")) {
-    const name = pick(row, "name", "indexname");
-    if (name)
-      schema.indexes.add(name.toLowerCase());
-  }
-  for (const row of await run("SELECT c.conname AS name FROM pg_constraint c JOIN pg_namespace n ON n.oid = c.connamespace WHERE n.nspname = 'public'")) {
-    const name = pick(row, "name", "conname");
-    if (name)
-      schema.constraints.add(name.toLowerCase());
-  }
-  for (const row of await run("SELECT t.typname AS name FROM pg_type t JOIN pg_namespace n ON n.oid = t.typnamespace WHERE t.typtype = 'e' AND n.nspname = 'public'")) {
-    const name = pick(row, "name", "typname");
-    if (name)
-      schema.enums.add(name.toLowerCase());
-  }
-  return schema;
-}
-export function effectPresent(effect, schema) {
-  const name = effect.name.toLowerCase();
-  switch (effect.kind) {
-    case "table":
-      return schema.tables.has(name);
-    case "column":
-      return schema.columns.get((effect.table ?? "").toLowerCase())?.has(name) ?? !1;
-    case "index":
-      return schema.indexes.has(name);
-    case "constraint":
-      return schema.constraints.has(name);
-    case "enum":
-      return schema.enums.has(name);
-  }
-}
-export function classifyMigration(recorded, present, absent) {
-  const verifiable = present.length + absent.length;
-  if (recorded) {
-    if (verifiable === 0 || absent.length === 0)
-      return "applied";
-    return "reverted";
-  }
-  if (verifiable === 0)
-    return "unverifiable";
-  if (absent.length === 0)
-    return "stranded";
-  if (present.length === 0)
-    return "pending";
-  return "partial";
-}
-function migrationsDir(dir) {
-  return dir ?? join(process.cwd(), "database", "migrations");
-}
-function listMigrationFiles(dir) {
-  if (!existsSync(dir))
-    return [];
-  try {
-    return readdirSync(dir).filter((f) => f.toLowerCase().endsWith(".sql")).sort();
-  } catch {
-    return [];
-  }
-}
-async function currentDialect() {
-  const driver = ((await import("@stacksjs/env")).env?.DB_CONNECTION ?? "sqlite").toLowerCase();
-  if (driver === "sqlite" || driver === "mysql" || driver === "postgres")
-    return driver;
-  return "other";
-}
-export async function readLedger(runner) {
-  try {
-    return (await (runner ?? await defaultRunner())("SELECT migration FROM migrations")).map((row) => pick(row, "migration")).filter((name) => name.length > 0).sort();
-  } catch {
-    return [];
-  }
-}
-export function planLedgerRemap(ledger, diskFiles) {
-  const onDisk = new Set(diskFiles), byLogical = new Map;
-  for (const file of diskFiles) {
-    const key = logicalName(file);
-    if (!byLogical.has(key))
-      byLogical.set(key, []);
-    byLogical.get(key).push(file);
-  }
-  const claimed = new Set(ledger.filter((row) => onDisk.has(row))), remap = [], ambiguous = [], dropped = [], targets = new Map;
-  for (const row of ledger) {
-    if (onDisk.has(row))
-      continue;
-    const candidates = (byLogical.get(logicalName(row)) ?? []).filter((f) => !claimed.has(f));
-    if (candidates.length === 0) {
-      dropped.push(row);
-      continue;
-    }
-    if (candidates.length > 1) {
-      ambiguous.push(row);
-      continue;
-    }
-    const to = candidates[0];
-    if (!targets.has(to))
-      targets.set(to, []);
-    targets.get(to).push(row);
-    remap.push({ from: row, to });
-  }
-  const contested = new Set([...targets.entries()].filter(([, rows]) => rows.length > 1).flatMap(([, rows]) => rows));
-  if (contested.size === 0)
-    return { remap, ambiguous, dropped };
-  return {
-    remap: remap.filter((r) => !contested.has(r.from)),
-    ambiguous: [...ambiguous, ...contested].sort(),
-    dropped
-  };
-}
-export async function auditMigrationLedger(options = {}) {
-  const dir = migrationsDir(options.dir), dialect = options.dialect ?? await currentDialect(), files = listMigrationFiles(dir), counts = {
-    applied: 0,
-    stranded: 0,
-    pending: 0,
-    partial: 0,
-    unverifiable: 0,
-    reverted: 0
-  }, emptyPlan = { remap: [], ambiguous: [], dropped: [] };
-  if (dialect === "other")
-    return { supported: !1, dialect, dir, entries: [], orphans: [], counts, recordedCount: 0, remapPlan: emptyPlan, drift: !1 };
-  const run = options.run ?? await defaultRunner(), ledger = await readLedger(run), recorded = new Set(ledger), schema = await readLiveSchema(dialect, run), entries = [];
-  for (const file of files) {
-    let sql = "";
-    try {
-      sql = readFileSync(join(dir, file), "utf8");
-    } catch {
-      continue;
-    }
-    const effects = verifiableEffects(migrationEffects(sql), dialect), present = effects.filter((effect) => effectPresent(effect, schema)), absent = effects.filter((effect) => !effectPresent(effect, schema)), isRecorded = recorded.has(file), status = classifyMigration(isRecorded, present, absent);
-    counts[status] += 1;
-    entries.push({ file, logical: logicalName(file), recorded: isRecorded, status, effects, present, absent });
-  }
-  const readable = entries.map((entry) => entry.file), remapPlan = planLedgerRemap(ledger, readable), renamedTo = new Map(remapPlan.remap.map((r) => [r.from, r.to])), orphans = ledger.filter((row) => !readable.includes(row)).map((row) => ({ migration: row, renamedTo: renamedTo.get(row) })), drift = counts.stranded > 0 || counts.partial > 0 || counts.reverted > 0 || orphans.length > 0;
-  return { supported: !0, dialect, dir, entries, orphans, counts, recordedCount: ledger.length, remapPlan, drift };
-}
-async function ensureLedgerTable(dialect, run) {
-  await run(`CREATE TABLE IF NOT EXISTS migrations (${dialect === "postgres" ? "id SERIAL PRIMARY KEY" : dialect === "mysql" ? "id INT AUTO_INCREMENT PRIMARY KEY" : "id INTEGER PRIMARY KEY AUTOINCREMENT"}, migration VARCHAR(255) NOT NULL UNIQUE, executed_at ${dialect === "postgres" ? "TIMESTAMP" : "DATETIME"} DEFAULT CURRENT_TIMESTAMP)`);
-}
-export async function reconcileMigrationLedger(options = {}) {
-  const run = options.run ?? await defaultRunner(), audit = await auditMigrationLedger({ dir: options.dir, dialect: options.dialect, run }), result = { remapped: [], recorded: [], skipped: [] };
-  if (!audit.supported) {
-    result.skipped.push({ file: "*", reason: `dialect "${audit.dialect}" is not audited` });
-    return result;
-  }
-  const plan = audit.remapPlan;
-  for (const row of plan.ambiguous)
-    result.skipped.push({ file: row, reason: "ledger row matches more than one file by logical name" });
-  for (const row of plan.dropped)
-    result.skipped.push({ file: row, reason: "recorded migration no longer exists on disk" });
-  const toRecord = [];
-  for (const entry of audit.entries) {
-    if (entry.status === "stranded") {
-      toRecord.push(entry.file);
-      continue;
-    }
-    if (entry.status === "partial") {
-      if (options.includePartial) {
-        toRecord.push(entry.file);
-        continue;
-      }
-      result.skipped.push({
-        file: entry.file,
-        reason: `${entry.present.length}/${entry.effects.length} effects present \u2014 resolve by hand, or pass --include-partial`
-      });
-      continue;
-    }
-    if (entry.status === "reverted")
-      result.skipped.push({
-        file: entry.file,
-        reason: `recorded, but ${entry.absent.length} effect(s) are missing from the schema`
-      });
-  }
-  const unsafe = (file) => !SAFE_MIGRATION_FILE.test(file);
-  for (const { from, to } of plan.remap.filter((r) => unsafe(r.from) || unsafe(r.to)))
-    result.skipped.push({ file: unsafe(from) ? from : to, reason: "migration filename is not safe to write to the ledger" });
-  for (const file of toRecord.filter(unsafe))
-    result.skipped.push({ file, reason: "migration filename is not safe to write to the ledger" });
-  const remapped = plan.remap.filter((r) => !unsafe(r.from) && !unsafe(r.to)), recordable = toRecord.filter((file) => !unsafe(file) && !remapped.some((r) => r.to === file));
-  if (options.dryRun) {
-    result.remapped = remapped;
-    result.recorded = recordable;
-    return result;
-  }
-  await ensureLedgerTable(audit.dialect, run);
-  for (const { from, to } of remapped) {
-    await run(`UPDATE migrations SET migration = '${to}' WHERE migration = '${from}'`);
-    result.remapped.push({ from, to });
-  }
-  for (const file of recordable) {
-    if ((await run(`SELECT migration FROM migrations WHERE migration = '${file}'`)).length > 0)
-      continue;
-    await run(`INSERT INTO migrations (migration) VALUES ('${file}')`);
-    result.recorded.push(file);
-  }
-  return result;
-}
+import{existsSync,readdirSync,readFileSync}from"node:fs";import process from"node:process";import{join}from"node:path";const SAFE_MIGRATION_FILE=/^[\w.-]+\.sql$/,IDENT=String.raw`["\`\[]?([A-Za-z_]\w*)["\`\]]?`;export function stripForEffects(sql){let out="",i=0;const blank=(text)=>text.replace(/[^\n]/g," ");while(i<sql.length){const rest=sql.slice(i),line=rest.match(/^--[^\n]*/);if(line){out+=blank(line[0]);i+=line[0].length;continue}if(rest.startsWith("/*")){const end=rest.indexOf("*/"),chunk=end===-1?rest:rest.slice(0,end+2);out+=blank(chunk);i+=chunk.length;continue}if(rest[0]==="'"){let j=1;while(j<rest.length&&rest[j]!=="'")j++;const chunk=rest.slice(0,Math.min(j+1,rest.length));out+=blank(chunk);i+=chunk.length;continue}out+=sql[i];i+=1}return out}function statementsOf(sql){return stripForEffects(sql).split(";").map((s)=>s.trim()).filter((s)=>s.length>0)}export function logicalName(file){return file.replace(/^\d+[-_]/,"").replace(/\.sql$/i,"")}export function migrationEffects(sql){const effects=[],seen=new Set,renamedAway=new Set,push=(effect)=>{const key=effectKey(effect);if(seen.has(key))return;seen.add(key);effects.push(effect)};for(const statement of statementsOf(sql)){const create=new RegExp(String.raw`^CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`,"i").exec(statement);if(create?.[1]){push({kind:"table",name:create[1]});continue}const rename=new RegExp(String.raw`^ALTER\s+TABLE\s+${IDENT}\s+RENAME\s+TO\s+${IDENT}`,"i").exec(statement);if(rename?.[2]){if(rename[1])renamedAway.add(rename[1].toLowerCase());push({kind:"table",name:rename[2]});continue}const index=new RegExp(String.raw`^CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`,"i").exec(statement);if(index?.[1]){push({kind:"index",name:index[1]});continue}const enumType=new RegExp(String.raw`^CREATE\s+TYPE\s+${IDENT}\s+AS\s+ENUM`,"i").exec(statement);if(enumType?.[1]){push({kind:"enum",name:enumType[1]});continue}const alter=new RegExp(String.raw`^ALTER\s+TABLE\s+(?:IF\s+EXISTS\s+)?${IDENT}\s+(.*)$`,"is").exec(statement);if(!alter?.[1]||!alter[2])continue;const table=alter[1],addColumn=new RegExp(String.raw`\bADD\s+COLUMN\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`,"gi");for(const m of alter[2].matchAll(addColumn))if(m[1])push({kind:"column",table,name:m[1]});const addConstraint=new RegExp(String.raw`\bADD\s+CONSTRAINT\s+(?:IF\s+NOT\s+EXISTS\s+)?${IDENT}`,"gi");for(const m of alter[2].matchAll(addConstraint))if(m[1])push({kind:"constraint",table,name:m[1]});const addBare=new RegExp(String.raw`\bADD\s+(?!COLUMN\b|CONSTRAINT\b|INDEX\b|KEY\b|PRIMARY\b|UNIQUE\b|FOREIGN\b|FULLTEXT\b|SPATIAL\b|CHECK\b)${IDENT}\s+\w`,"gi");for(const m of alter[2].matchAll(addBare))if(m[1])push({kind:"column",table,name:m[1]})}if(renamedAway.size===0)return effects;return effects.filter((effect)=>{const owner=(effect.kind==="table"?effect.name:effect.table??"").toLowerCase();return!renamedAway.has(owner)})}function effectKey(effect){return`${effect.kind}:${(effect.table??"").toLowerCase()}.${effect.name.toLowerCase()}`}export function verifiableEffects(effects,dialect){if(dialect==="postgres")return effects;if(dialect==="mysql")return effects.filter((e)=>e.kind!=="enum");return effects.filter((e)=>e.kind!=="constraint"&&e.kind!=="enum")}function emptySchema(){return{tables:new Set,columns:new Map,indexes:new Set,constraints:new Set,enums:new Set}}function rowsOf(result){return Array.isArray(result)?result:[]}async function defaultRunner(){const{db}=await import("./utils");return async(sql)=>rowsOf(await db.unsafe(sql).execute())}function pick(row,...keys){for(const key of keys){const value=row?.[key]??row?.[key.toLowerCase()]??row?.[key.toUpperCase()];if(typeof value==="string"&&value.length>0)return value}return""}export async function readLiveSchema(dialect,runner){const schema=emptySchema(),run=runner??await defaultRunner();if(dialect==="sqlite"){for(const row of await run("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")){const name=pick(row,"name");if(name)schema.tables.add(name.toLowerCase())}for(const row of await run("SELECT name FROM sqlite_master WHERE type='index' AND name NOT LIKE 'sqlite_%'")){const name=pick(row,"name");if(name)schema.indexes.add(name.toLowerCase())}for(const table of schema.tables){if(!/^[a-z_]\w*$/i.test(table))continue;const cols=new Set;for(const row of await run(`PRAGMA table_info("${table}")`)){const name=pick(row,"name");if(name)cols.add(name.toLowerCase())}schema.columns.set(table,cols)}return schema}if(dialect==="mysql"){for(const row of await run("SELECT TABLE_NAME AS name FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE()")){const name=pick(row,"name","TABLE_NAME");if(name)schema.tables.add(name.toLowerCase())}for(const row of await run("SELECT TABLE_NAME, COLUMN_NAME FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = DATABASE()")){const table=pick(row,"TABLE_NAME").toLowerCase(),column=pick(row,"COLUMN_NAME").toLowerCase();if(!table||!column)continue;if(!schema.columns.has(table))schema.columns.set(table,new Set);schema.columns.get(table).add(column)}for(const row of await run("SELECT DISTINCT INDEX_NAME AS name FROM information_schema.STATISTICS WHERE TABLE_SCHEMA = DATABASE()")){const name=pick(row,"name","INDEX_NAME");if(name)schema.indexes.add(name.toLowerCase())}for(const row of await run("SELECT CONSTRAINT_NAME AS name FROM information_schema.TABLE_CONSTRAINTS WHERE CONSTRAINT_SCHEMA = DATABASE()")){const name=pick(row,"name","CONSTRAINT_NAME");if(name)schema.constraints.add(name.toLowerCase())}return schema}for(const row of await run("SELECT tablename AS name FROM pg_tables WHERE schemaname = 'public'")){const name=pick(row,"name","tablename");if(name)schema.tables.add(name.toLowerCase())}for(const row of await run("SELECT table_name, column_name FROM information_schema.columns WHERE table_schema = 'public'")){const table=pick(row,"table_name").toLowerCase(),column=pick(row,"column_name").toLowerCase();if(!table||!column)continue;if(!schema.columns.has(table))schema.columns.set(table,new Set);schema.columns.get(table).add(column)}for(const row of await run("SELECT indexname AS name FROM pg_indexes WHERE schemaname = 'public'")){const name=pick(row,"name","indexname");if(name)schema.indexes.add(name.toLowerCase())}for(const row of await run("SELECT c.conname AS name FROM pg_constraint c JOIN pg_namespace n ON n.oid = c.connamespace WHERE n.nspname = 'public'")){const name=pick(row,"name","conname");if(name)schema.constraints.add(name.toLowerCase())}for(const row of await run("SELECT t.typname AS name FROM pg_type t JOIN pg_namespace n ON n.oid = t.typnamespace WHERE t.typtype = 'e' AND n.nspname = 'public'")){const name=pick(row,"name","typname");if(name)schema.enums.add(name.toLowerCase())}return schema}export function effectPresent(effect,schema){const name=effect.name.toLowerCase();switch(effect.kind){case"table":return schema.tables.has(name);case"column":return schema.columns.get((effect.table??"").toLowerCase())?.has(name)??!1;case"index":return schema.indexes.has(name);case"constraint":return schema.constraints.has(name);case"enum":return schema.enums.has(name)}}export function classifyMigration(recorded,present,absent){const verifiable=present.length+absent.length;if(recorded){if(verifiable===0||absent.length===0)return"applied";return"reverted"}if(verifiable===0)return"unverifiable";if(absent.length===0)return"stranded";if(present.length===0)return"pending";return"partial"}function migrationsDir(dir){return dir??join(process.cwd(),"database","migrations")}function listMigrationFiles(dir){if(!existsSync(dir))return[];try{return readdirSync(dir).filter((f)=>f.toLowerCase().endsWith(".sql")).sort()}catch{return[]}}async function currentDialect(){const driver=((await import("@stacksjs/env")).env?.DB_CONNECTION??"sqlite").toLowerCase();if(driver==="sqlite"||driver==="mysql"||driver==="postgres")return driver;return"other"}export async function readLedger(runner){try{return(await(runner??await defaultRunner())("SELECT migration FROM migrations")).map((row)=>pick(row,"migration")).filter((name)=>name.length>0).sort()}catch{return[]}}export function planLedgerRemap(ledger,diskFiles){const onDisk=new Set(diskFiles),byLogical=new Map;for(const file of diskFiles){const key=logicalName(file);if(!byLogical.has(key))byLogical.set(key,[]);byLogical.get(key).push(file)}const claimed=new Set(ledger.filter((row)=>onDisk.has(row))),remap=[],ambiguous=[],dropped=[],targets=new Map;for(const row of ledger){if(onDisk.has(row))continue;const candidates=(byLogical.get(logicalName(row))??[]).filter((f)=>!claimed.has(f));if(candidates.length===0){dropped.push(row);continue}if(candidates.length>1){ambiguous.push(row);continue}const to=candidates[0];if(!targets.has(to))targets.set(to,[]);targets.get(to).push(row);remap.push({from:row,to})}const contested=new Set([...targets.entries()].filter(([,rows])=>rows.length>1).flatMap(([,rows])=>rows));if(contested.size===0)return{remap,ambiguous,dropped};return{remap:remap.filter((r)=>!contested.has(r.from)),ambiguous:[...ambiguous,...contested].sort(),dropped}}export async function auditMigrationLedger(options={}){const dir=migrationsDir(options.dir),dialect=options.dialect??await currentDialect(),files=listMigrationFiles(dir),counts={applied:0,stranded:0,pending:0,partial:0,unverifiable:0,reverted:0},emptyPlan={remap:[],ambiguous:[],dropped:[]};if(dialect==="other")return{supported:!1,dialect,dir,entries:[],orphans:[],counts,recordedCount:0,remapPlan:emptyPlan,drift:!1};const run=options.run??await defaultRunner(),ledger=await readLedger(run),recorded=new Set(ledger),schema=await readLiveSchema(dialect,run),entries=[];for(const file of files){let sql="";try{sql=readFileSync(join(dir,file),"utf8")}catch{continue}const effects=verifiableEffects(migrationEffects(sql),dialect),present=effects.filter((effect)=>effectPresent(effect,schema)),absent=effects.filter((effect)=>!effectPresent(effect,schema)),isRecorded=recorded.has(file),status=classifyMigration(isRecorded,present,absent);counts[status]+=1;entries.push({file,logical:logicalName(file),recorded:isRecorded,status,effects,present,absent})}const readable=entries.map((entry)=>entry.file),remapPlan=planLedgerRemap(ledger,readable),renamedTo=new Map(remapPlan.remap.map((r)=>[r.from,r.to])),orphans=ledger.filter((row)=>!readable.includes(row)).map((row)=>({migration:row,renamedTo:renamedTo.get(row)})),drift=counts.stranded>0||counts.partial>0||counts.reverted>0||orphans.length>0;return{supported:!0,dialect,dir,entries,orphans,counts,recordedCount:ledger.length,remapPlan,drift}}async function ensureLedgerTable(dialect,run){await run(`CREATE TABLE IF NOT EXISTS migrations (${dialect==="postgres"?"id SERIAL PRIMARY KEY":dialect==="mysql"?"id INT AUTO_INCREMENT PRIMARY KEY":"id INTEGER PRIMARY KEY AUTOINCREMENT"}, migration VARCHAR(255) NOT NULL UNIQUE, executed_at ${dialect==="postgres"?"TIMESTAMP":"DATETIME"} DEFAULT CURRENT_TIMESTAMP)`)}export async function reconcileMigrationLedger(options={}){const run=options.run??await defaultRunner(),audit=await auditMigrationLedger({dir:options.dir,dialect:options.dialect,run}),result={remapped:[],recorded:[],skipped:[]};if(!audit.supported){result.skipped.push({file:"*",reason:`dialect "${audit.dialect}" is not audited`});return result}const plan=audit.remapPlan;for(const row of plan.ambiguous)result.skipped.push({file:row,reason:"ledger row matches more than one file by logical name"});for(const row of plan.dropped)result.skipped.push({file:row,reason:"recorded migration no longer exists on disk"});const toRecord=[];for(const entry of audit.entries){if(entry.status==="stranded"){toRecord.push(entry.file);continue}if(entry.status==="partial"){if(options.includePartial){toRecord.push(entry.file);continue}result.skipped.push({file:entry.file,reason:`${entry.present.length}/${entry.effects.length} effects present \u2014 resolve by hand, or pass --include-partial`});continue}if(entry.status==="reverted")result.skipped.push({file:entry.file,reason:`recorded, but ${entry.absent.length} effect(s) are missing from the schema`})}const unsafe=(file)=>!SAFE_MIGRATION_FILE.test(file);for(const{from,to}of plan.remap.filter((r)=>unsafe(r.from)||unsafe(r.to)))result.skipped.push({file:unsafe(from)?from:to,reason:"migration filename is not safe to write to the ledger"});for(const file of toRecord.filter(unsafe))result.skipped.push({file,reason:"migration filename is not safe to write to the ledger"});const remapped=plan.remap.filter((r)=>!unsafe(r.from)&&!unsafe(r.to)),recordable=toRecord.filter((file)=>!unsafe(file)&&!remapped.some((r)=>r.to===file));if(options.dryRun){result.remapped=remapped;result.recorded=recordable;return result}await ensureLedgerTable(audit.dialect,run);for(const{from,to}of remapped){await run(`UPDATE migrations SET migration = '${to}' WHERE migration = '${from}'`);result.remapped.push({from,to})}for(const file of recordable){if((await run(`SELECT migration FROM migrations WHERE migration = '${file}'`)).length>0)continue;await run(`INSERT INTO migrations (migration) VALUES ('${file}')`);result.recorded.push(file)}return result}

package/dist/migration-lock.js

@@ -1,143 +1 @@
-import { Buffer } from "node:buffer";
-import { createHash } from "node:crypto";
-import { closeSync, openSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
-import process from "node:process";
-import { userDatabasePath } from "@stacksjs/path";
-const DEFAULT_TIMEOUT_MS = 30000, INITIAL_BACKOFF_MS = 100, MAX_BACKOFF_MS = 2000, STALE_LOCK_MS = 60000, LOCK_NAME = "stacks_migrations";
-export async function acquireMigrationLock(dialect, adminDb, opts = {}) {
-  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  if (dialect !== "sqlite" && dialect !== "postgres" && dialect !== "mysql")
-    throw Error(`[migration-lock] unknown dialect: ${String(dialect)}`);
-  if (dialect === "sqlite")
-    return acquireSqliteLock(opts.sqliteLockPath, timeoutMs);
-  if (!adminDb)
-    throw Error(`[migration-lock] ${dialect} requires a database connection to acquire the lock`);
-  if (dialect === "postgres")
-    return acquirePostgresLock(adminDb, timeoutMs);
-  return acquireMySqlLock(adminDb, timeoutMs);
-}
-function lockKeysForPostgres() {
-  const hash = createHash("sha256").update(LOCK_NAME).digest(), key1 = hash.readInt32BE(0), key2 = hash.readInt32BE(4);
-  return { key1, key2 };
-}
-async function acquirePostgresLock(adminDb, timeoutMs) {
-  const { key1, key2 } = lockKeysForPostgres(), start = Date.now();
-  let backoff = INITIAL_BACKOFF_MS;
-  while (!0) {
-    const result = await adminDb.unsafe(`SELECT pg_try_advisory_lock(${key1}, ${key2}) AS acquired`);
-    if (extractFirstBool(result, "acquired"))
-      return {
-        release: async () => {
-          try {
-            await adminDb.unsafe(`SELECT pg_advisory_unlock(${key1}, ${key2})`);
-          } catch {}
-        }
-      };
-    if (Date.now() - start >= timeoutMs)
-      throw Error("[migration-lock] another migration is in progress \u2014 could not acquire postgres advisory lock within timeout");
-    await sleepWithJitter(backoff);
-    backoff = Math.min(backoff * 2, MAX_BACKOFF_MS);
-  }
-}
-async function acquireMySqlLock(adminDb, timeoutMs) {
-  const start = Date.now();
-  let backoff = INITIAL_BACKOFF_MS;
-  while (!0) {
-    const result = await adminDb.unsafe(`SELECT GET_LOCK('${LOCK_NAME}', 0) AS acquired`);
-    if (extractFirstInt(result, "acquired") === 1)
-      return {
-        release: async () => {
-          try {
-            await adminDb.unsafe(`SELECT RELEASE_LOCK('${LOCK_NAME}')`);
-          } catch {}
-        }
-      };
-    if (Date.now() - start >= timeoutMs)
-      throw Error("[migration-lock] another migration is in progress \u2014 could not acquire MySQL named lock within timeout");
-    await sleepWithJitter(backoff);
-    backoff = Math.min(backoff * 2, MAX_BACKOFF_MS);
-  }
-}
-function defaultSqliteLockPath() {
-  return userDatabasePath(".migration.lock");
-}
-async function acquireSqliteLock(lockPath, timeoutMs) {
-  const path = lockPath ?? defaultSqliteLockPath(), start = Date.now();
-  let backoff = INITIAL_BACKOFF_MS;
-  while (!0) {
-    if (tryCreateLockFile(path)) {
-      let released = !1;
-      return {
-        release: async () => {
-          if (released)
-            return;
-          released = !0;
-          try {
-            unlinkSync(path);
-          } catch {}
-        }
-      };
-    }
-    reclaimIfStale(path);
-    if (Date.now() - start >= timeoutMs)
-      throw Error(`[migration-lock] another migration is in progress \u2014 lock file ${path} held within timeout`);
-    await sleepWithJitter(backoff);
-    backoff = Math.min(backoff * 2, MAX_BACKOFF_MS);
-  }
-}
-function tryCreateLockFile(path) {
-  try {
-    const fd = openSync(path, "wx");
-    try {
-      const payload = JSON.stringify({ pid: process.pid, startedAt: new Date().toISOString() });
-      writeFileSync(fd, Buffer.from(payload, "utf8"));
-    } finally {
-      closeSync(fd);
-    }
-    return !0;
-  } catch (e) {
-    if (e.code === "EEXIST")
-      return !1;
-    throw e;
-  }
-}
-function reclaimIfStale(path) {
-  try {
-    const st = statSync(path);
-    if (Date.now() - st.mtimeMs > STALE_LOCK_MS)
-      try {
-        unlinkSync(path);
-      } catch {}
-  } catch {}
-}
-function sleepWithJitter(ms) {
-  const jittered = ms * (1 + Math.random() * 0.25);
-  return new Promise((resolve) => setTimeout(resolve, jittered));
-}
-function extractFirstBool(result, column) {
-  const row = pluckFirstRow(result);
-  if (!row)
-    return !1;
-  const value = row[column];
-  return value === !0 || value === 1 || value === "1" || value === "t";
-}
-function extractFirstInt(result, column) {
-  const row = pluckFirstRow(result);
-  if (!row)
-    return null;
-  const value = row[column];
-  if (typeof value === "number")
-    return value;
-  if (typeof value === "string" && /^-?\d+$/.test(value))
-    return Number.parseInt(value, 10);
-  return null;
-}
-function pluckFirstRow(result) {
-  if (!result)
-    return null;
-  if (Array.isArray(result))
-    return result[0];
-  if (typeof result === "object" && "rows" in result && Array.isArray(result.rows))
-    return result.rows[0];
-  return null;
-}
+import{Buffer}from"node:buffer";import{createHash}from"node:crypto";import{closeSync,openSync,readFileSync,statSync,unlinkSync,writeFileSync}from"node:fs";import process from"node:process";import{userDatabasePath}from"@stacksjs/path";const DEFAULT_TIMEOUT_MS=30000,INITIAL_BACKOFF_MS=100,MAX_BACKOFF_MS=2000,STALE_LOCK_MS=60000,LOCK_NAME="stacks_migrations";export async function acquireMigrationLock(dialect,adminDb,opts={}){const timeoutMs=opts.timeoutMs??DEFAULT_TIMEOUT_MS;if(dialect!=="sqlite"&&dialect!=="postgres"&&dialect!=="mysql")throw Error(`[migration-lock] unknown dialect: ${String(dialect)}`);if(dialect==="sqlite")return acquireSqliteLock(opts.sqliteLockPath,timeoutMs);if(!adminDb)throw Error(`[migration-lock] ${dialect} requires a database connection to acquire the lock`);if(dialect==="postgres")return acquirePostgresLock(adminDb,timeoutMs);return acquireMySqlLock(adminDb,timeoutMs)}function lockKeysForPostgres(){const hash=createHash("sha256").update(LOCK_NAME).digest(),key1=hash.readInt32BE(0),key2=hash.readInt32BE(4);return{key1,key2}}async function acquirePostgresLock(adminDb,timeoutMs){const{key1,key2}=lockKeysForPostgres(),start=Date.now();let backoff=INITIAL_BACKOFF_MS;while(!0){const result=await adminDb.unsafe(`SELECT pg_try_advisory_lock(${key1}, ${key2}) AS acquired`);if(extractFirstBool(result,"acquired"))return{release:async()=>{try{await adminDb.unsafe(`SELECT pg_advisory_unlock(${key1}, ${key2})`)}catch{}}};if(Date.now()-start>=timeoutMs)throw Error("[migration-lock] another migration is in progress \u2014 could not acquire postgres advisory lock within timeout");await sleepWithJitter(backoff);backoff=Math.min(backoff*2,MAX_BACKOFF_MS)}}async function acquireMySqlLock(adminDb,timeoutMs){const start=Date.now();let backoff=INITIAL_BACKOFF_MS;while(!0){const result=await adminDb.unsafe(`SELECT GET_LOCK('${LOCK_NAME}', 0) AS acquired`);if(extractFirstInt(result,"acquired")===1)return{release:async()=>{try{await adminDb.unsafe(`SELECT RELEASE_LOCK('${LOCK_NAME}')`)}catch{}}};if(Date.now()-start>=timeoutMs)throw Error("[migration-lock] another migration is in progress \u2014 could not acquire MySQL named lock within timeout");await sleepWithJitter(backoff);backoff=Math.min(backoff*2,MAX_BACKOFF_MS)}}function defaultSqliteLockPath(){return userDatabasePath(".migration.lock")}async function acquireSqliteLock(lockPath,timeoutMs){const path=lockPath??defaultSqliteLockPath(),start=Date.now();let backoff=INITIAL_BACKOFF_MS;while(!0){if(tryCreateLockFile(path)){let released=!1;return{release:async()=>{if(released)return;released=!0;try{unlinkSync(path)}catch{}}}}reclaimIfStale(path);if(Date.now()-start>=timeoutMs)throw Error(`[migration-lock] another migration is in progress \u2014 lock file ${path} held within timeout`);await sleepWithJitter(backoff);backoff=Math.min(backoff*2,MAX_BACKOFF_MS)}}function tryCreateLockFile(path){try{const fd=openSync(path,"wx");try{const payload=JSON.stringify({pid:process.pid,startedAt:new Date().toISOString()});writeFileSync(fd,Buffer.from(payload,"utf8"))}finally{closeSync(fd)}return!0}catch(e){if(e.code==="EEXIST")return!1;throw e}}function reclaimIfStale(path){try{const st=statSync(path);if(Date.now()-st.mtimeMs>STALE_LOCK_MS)try{unlinkSync(path)}catch{}}catch{}}function sleepWithJitter(ms){const jittered=ms*(1+Math.random()*0.25);return new Promise((resolve)=>setTimeout(resolve,jittered))}function extractFirstBool(result,column){const row=pluckFirstRow(result);if(!row)return!1;const value=row[column];return value===!0||value===1||value==="1"||value==="t"}function extractFirstInt(result,column){const row=pluckFirstRow(result);if(!row)return null;const value=row[column];if(typeof value==="number")return value;if(typeof value==="string"&&/^-?\d+$/.test(value))return Number.parseInt(value,10);return null}function pluckFirstRow(result){if(!result)return null;if(Array.isArray(result))return result[0];if(typeof result==="object"&&"rows"in result&&Array.isArray(result.rows))return result.rows[0];return null}