@akal/supaforge 0.0.0-stage → 0.0.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/README.md +350 -2
  2. package/bin/dev.js +10 -0
  3. package/bin/run.js +18 -0
  4. package/dist/base-command.d.ts +134 -0
  5. package/dist/base-command.js +9 -0
  6. package/dist/base-command.js.map +1 -0
  7. package/dist/branch-C4ndfoj5.d.ts +58 -0
  8. package/dist/chunk-4OU7KO5Y.js +13 -0
  9. package/dist/chunk-4OU7KO5Y.js.map +1 -0
  10. package/dist/chunk-5QQBTLWO.js +642 -0
  11. package/dist/chunk-5QQBTLWO.js.map +1 -0
  12. package/dist/chunk-5Z3SAIQS.js +2807 -0
  13. package/dist/chunk-5Z3SAIQS.js.map +1 -0
  14. package/dist/chunk-6WAMNZLO.js +336 -0
  15. package/dist/chunk-6WAMNZLO.js.map +1 -0
  16. package/dist/chunk-BHYLBKYD.js +156 -0
  17. package/dist/chunk-BHYLBKYD.js.map +1 -0
  18. package/dist/chunk-BLKJWDTL.js +153 -0
  19. package/dist/chunk-BLKJWDTL.js.map +1 -0
  20. package/dist/chunk-DQQ5E563.js +64 -0
  21. package/dist/chunk-DQQ5E563.js.map +1 -0
  22. package/dist/chunk-G2DIPIYU.js +94 -0
  23. package/dist/chunk-G2DIPIYU.js.map +1 -0
  24. package/dist/chunk-H5MJ5DFX.js +16 -0
  25. package/dist/chunk-H5MJ5DFX.js.map +1 -0
  26. package/dist/chunk-KIFJGON5.js +248 -0
  27. package/dist/chunk-KIFJGON5.js.map +1 -0
  28. package/dist/chunk-LQXF65MC.js +240 -0
  29. package/dist/chunk-LQXF65MC.js.map +1 -0
  30. package/dist/chunk-NXRSAVRU.js +478 -0
  31. package/dist/chunk-NXRSAVRU.js.map +1 -0
  32. package/dist/chunk-PARSNTBD.js +837 -0
  33. package/dist/chunk-PARSNTBD.js.map +1 -0
  34. package/dist/chunk-RRMI5CZD.js +376 -0
  35. package/dist/chunk-RRMI5CZD.js.map +1 -0
  36. package/dist/chunk-SF3YA42C.js +506 -0
  37. package/dist/chunk-SF3YA42C.js.map +1 -0
  38. package/dist/chunk-TQJSQLWA.js +574 -0
  39. package/dist/chunk-TQJSQLWA.js.map +1 -0
  40. package/dist/chunk-VMTBLHN2.js +122 -0
  41. package/dist/chunk-VMTBLHN2.js.map +1 -0
  42. package/dist/chunk-VOXZWQ3N.js +948 -0
  43. package/dist/chunk-VOXZWQ3N.js.map +1 -0
  44. package/dist/chunk-X6V2GGDZ.js +333 -0
  45. package/dist/chunk-X6V2GGDZ.js.map +1 -0
  46. package/dist/chunk-XMYMIURR.js +552 -0
  47. package/dist/chunk-XMYMIURR.js.map +1 -0
  48. package/dist/chunk-YVDSR4GM.js +1264 -0
  49. package/dist/chunk-YVDSR4GM.js.map +1 -0
  50. package/dist/commands/clone.d.ts +66 -0
  51. package/dist/commands/clone.js +416 -0
  52. package/dist/commands/clone.js.map +1 -0
  53. package/dist/commands/diff.d.ts +65 -0
  54. package/dist/commands/diff.js +24 -0
  55. package/dist/commands/diff.js.map +1 -0
  56. package/dist/commands/help.d.ts +32 -0
  57. package/dist/commands/help.js +36 -0
  58. package/dist/commands/help.js.map +1 -0
  59. package/dist/commands/hukam.d.ts +13 -0
  60. package/dist/commands/hukam.js +29 -0
  61. package/dist/commands/hukam.js.map +1 -0
  62. package/dist/commands/init.d.ts +47 -0
  63. package/dist/commands/init.js +388 -0
  64. package/dist/commands/init.js.map +1 -0
  65. package/dist/commands/mcp.d.ts +13 -0
  66. package/dist/commands/mcp.js +44 -0
  67. package/dist/commands/mcp.js.map +1 -0
  68. package/dist/commands/migrate/baseline.d.ts +24 -0
  69. package/dist/commands/migrate/baseline.js +69 -0
  70. package/dist/commands/migrate/baseline.js.map +1 -0
  71. package/dist/commands/migrate/create.d.ts +36 -0
  72. package/dist/commands/migrate/create.js +128 -0
  73. package/dist/commands/migrate/create.js.map +1 -0
  74. package/dist/commands/migrate/list.d.ts +23 -0
  75. package/dist/commands/migrate/list.js +110 -0
  76. package/dist/commands/migrate/list.js.map +1 -0
  77. package/dist/commands/migrate/run.d.ts +61 -0
  78. package/dist/commands/migrate/run.js +19 -0
  79. package/dist/commands/migrate/run.js.map +1 -0
  80. package/dist/commands/report.d.ts +27 -0
  81. package/dist/commands/report.js +210 -0
  82. package/dist/commands/report.js.map +1 -0
  83. package/dist/commands/restore.d.ts +26 -0
  84. package/dist/commands/restore.js +268 -0
  85. package/dist/commands/restore.js.map +1 -0
  86. package/dist/commands/snapshot.d.ts +33 -0
  87. package/dist/commands/snapshot.js +251 -0
  88. package/dist/commands/snapshot.js.map +1 -0
  89. package/dist/commands/sync.d.ts +16 -0
  90. package/dist/commands/sync.js +39 -0
  91. package/dist/commands/sync.js.map +1 -0
  92. package/dist/config-CTbeRlJk.d.ts +134 -0
  93. package/dist/help.d.ts +28 -0
  94. package/dist/help.js +64 -0
  95. package/dist/help.js.map +1 -0
  96. package/dist/index.d.ts +493 -0
  97. package/dist/index.js +147 -0
  98. package/dist/index.js.map +1 -0
  99. package/package.json +74 -4
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/base-command.ts","../src/preflight.ts","../src/local-pg.ts","../src/run-log.ts"],"sourcesContent":["import { formatWithOptions } from 'node:util'\nimport { Command } from '@oclif/core'\nimport { loadConfig, validateConfig, validateSingleEnvConfig } from './config.js'\nimport { Preflight } from './preflight.js'\nimport { DEFAULT_MIGRATIONS_DIR } from './checks/migrations.js'\nimport type { SupaForgeConfig, EnvironmentConfig } from './types/config.js'\nimport type { PreflightReport } from './preflight.js'\nimport { appendRunLog, redactArgs, type RunLogCheckSummary } from './run-log.js'\n\n/**\n * Shared base for all supaforge commands.\n * Extracts config loading, env resolution, URL redaction, and run logging.\n */\nexport abstract class BaseCommand extends Command {\n\n private _startTime = 0\n private _logWritten = false\n private _checkSummaries?: RunLogCheckSummary[]\n\n /**\n * Under --json, stdout carries the JSON and nothing else: every other line a\n * command prints — preflight checks, progress — goes to stderr. Before, the\n * text came first and the output did not parse.\n */\n override log(message = '', ...args: unknown[]): void {\n if (this.argv.includes('--json')) {\n process.stderr.write(formatWithOptions({ colors: false }, message, ...args) + '\\n')\n return\n }\n super.log(message, ...args)\n }\n\n /** The command's result as JSON, on stdout. */\n protected json(value: unknown): void {\n process.stdout.write(JSON.stringify(value, null, 2) + '\\n')\n }\n\n /** Call after scan() to attach per-check metadata to the run log entry. */\n protected setCheckSummaries(summaries: RunLogCheckSummary[]): void {\n this._checkSummaries = summaries\n }\n\n override async init(): Promise<void> {\n await super.init()\n this._startTime = Date.now()\n }\n\n override async catch(err: Error): Promise<void> {\n this._logWritten = true\n await this._writeRunLog('error', err.message)\n return super.catch(err)\n }\n\n override async finally(err: Error | undefined): Promise<void> {\n if (!this._logWritten) {\n await this._writeRunLog(err ? 'error' : 'success', err?.message)\n }\n return super.finally(err)\n }\n\n private async _writeRunLog(exitStatus: 'success' | 'error', error?: string): Promise<void> {\n try {\n const version = this.config?.version\n const argv = this.argv ?? []\n await appendRunLog({\n timestamp: new Date().toISOString(),\n command: this.id ?? 'unknown',\n args: redactArgs(argv),\n durationMs: Date.now() - this._startTime,\n exitStatus,\n error,\n version,\n checkSummaries: this._checkSummaries,\n })\n } catch {\n // Never let logging failures surface to users\n }\n }\n\n /** Load config or exit with a helpful error. */\n protected async loadConfigOrFail(): Promise<SupaForgeConfig> {\n try {\n return await loadConfig()\n } catch {\n this.error(\n 'Could not load supaforge.config.json. Run \"supaforge init\" first.',\n )\n }\n }\n\n /**\n * Resolve a single environment by name.\n * Accepts an explicit flag value or falls back to config.source.\n */\n protected resolveEnv(\n config: SupaForgeConfig,\n envFlag?: string,\n ): { envName: string; env: EnvironmentConfig } {\n const envName = envFlag ?? config.source\n if (!envName) {\n this.error('No environment specified. Use --env=<name> or set \"source\" in your config.')\n }\n\n const errors = validateSingleEnvConfig(config, envName)\n if (errors.length > 0) {\n this.error(`Invalid configuration:\\n ${errors.join('\\n ')}`)\n }\n\n return { envName, env: config.environments[envName] }\n }\n\n /**\n * Validate a two-env (source + target) config.\n * Applies flag overrides before validation.\n */\n protected validateDualEnvConfig(\n config: SupaForgeConfig,\n sourceFlag?: string,\n targetFlag?: string,\n ): void {\n if (sourceFlag) config.source = sourceFlag\n if (targetFlag) config.target = targetFlag\n\n const errors = validateConfig(config)\n if (errors.length > 0) {\n this.error(`Invalid configuration:\\n ${errors.join('\\n ')}`)\n }\n }\n\n /** Redact password from a database URL for display. */\n protected redactUrl(url: string): string {\n return url.replace(/:([^@/]{1,})@/, ':***@')\n }\n\n /** Resolve the migrations directory from config (with default fallback). */\n protected resolveMigrationsDir(config: SupaForgeConfig): string {\n return config.checks?.migrations?.dir ?? DEFAULT_MIGRATIONS_DIR\n }\n\n /**\n * Create, run, and enforce a preflight check.\n * Returns the Preflight instance for commands that need to add custom checks.\n * When `abortMessage` is provided, exits with an error if checks fail.\n */\n protected createPreflight(title: string): Preflight {\n return new Preflight(title, (m) => this.log(m))\n }\n\n /**\n * Run a preflight and abort with a user-friendly message if it fails.\n * Returns the report for commands that inspect individual check results.\n */\n protected async runPreflight(preflight: Preflight, commandName: string): Promise<PreflightReport> {\n const report = await preflight.run()\n if (!report.passed) {\n this.error(`${commandName} aborted — fix the issues above first.`, { exit: 1 })\n }\n return report\n }\n}\n","import pg from 'pg'\nimport { detectRuntime } from './local-pg.js'\nimport { pgClientConfig, resolveConnectTimeoutMs } from './db.js'\nimport { DB_PROBE_TIMEOUT_MS } from './constants.js'\nimport { ok, warn, dim, cmd, bold } from './ui.js'\nimport { redactUrls, describeFailure } from './utils/error.js'\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Result of a single connectivity check. */\nexport interface ConnCheckResult {\n reachable: boolean\n version?: string\n error?: string\n}\n\n/** Outcome of a single preflight check (DB connectivity or custom). */\nexport interface CheckEntry {\n label: string\n passed: boolean\n detail?: string\n error?: string\n hints?: string[]\n}\n\n/** Full report returned by Preflight.run(). */\nexport interface PreflightReport {\n passed: boolean\n checks: CheckEntry[]\n}\n\n/** Supabase CLI default PostgreSQL port. */\nconst SUPABASE_LOCAL_PORT = '54322'\n\n/** Standard PostgreSQL port. */\nconst DEFAULT_PG_PORT = '5432'\n\n// ─── Standalone helpers (remain exported for direct use / tests) ─────────────\n\n/**\n * `pg`'s messages for the two bounds this module sets. Neither says what was\n * being waited for, and \"timeout expired\" in particular reads like a bug\n * rather than a diagnosis.\n */\nconst CONNECT_TIMEOUT_RE = /timeout expired|connection timeout/i\nconst QUERY_TIMEOUT_RE = /query read timeout/i\n\n/**\n * Replace a bare driver timeout with something that says which wait elapsed.\n *\n * Left untouched when it is not one of ours: a server-side `statement_timeout`\n * or an OS-level ETIMEDOUT is a different failure and already reads clearly.\n */\nexport function describeTimeout(message: string, connectTimeoutMs: number, probeTimeoutMs: number): string {\n if (CONNECT_TIMEOUT_RE.test(message)) {\n return `timed out after ${Math.round(connectTimeoutMs / 1000)}s connecting — the host accepted the connection but never completed the handshake`\n }\n if (QUERY_TIMEOUT_RE.test(message)) {\n return `timed out after ${Math.round(probeTimeoutMs / 1000)}s waiting for server response — connected, but the server did not answer`\n }\n return message\n}\n\n/**\n * Test that a PostgreSQL database is reachable and return the server version.\n *\n * Both waits are bounded. Without that, a host that accepts the connection and\n * then goes silent blocks here forever, and the command produces no output at\n * all past the `Checks:` header (issue #44).\n */\nexport async function checkConnection(dbUrl: string): Promise<ConnCheckResult> {\n const connectTimeoutMs = resolveConnectTimeoutMs()\n let client: pg.Client | undefined\n try {\n client = new pg.Client(pgClientConfig(dbUrl, DB_PROBE_TIMEOUT_MS))\n await client.connect()\n const { rows } = await client.query('SHOW server_version')\n const version = (rows[0] as Record<string, string>).server_version\n return { reachable: true, version }\n } catch (err) {\n return {\n reachable: false,\n error: describeTimeout(describeFailure(err), connectTimeoutMs, DB_PROBE_TIMEOUT_MS),\n }\n } finally {\n // A client that timed out mid-handshake still holds an open socket, which\n // keeps the event loop alive and hangs the process after the report has\n // already printed. end() on a never-connected client is a no-op, and a\n // failure closing it must not mask the real error above.\n try {\n await client?.end()\n } catch {\n // ignore\n }\n }\n}\n\n/** Errors that indicate the server IS running but rejecting the connection. */\nconst SERVER_REACHABLE_RE = /password authentication failed|does not exist|database .* does not exist|SSL.*required|no pg_hba\\.conf entry/i\n\n/**\n * Build context-aware hints when a local PostgreSQL is not reachable.\n * Detects Supabase CLI port, available container runtimes, etc.\n *\n * When `error` is provided and indicates the server IS running (auth failure,\n * missing database, SSL rejection), startup hints are suppressed in favour of\n * configuration hints.\n */\nexport async function buildLocalHints(dbUrl: string, error?: string): Promise<string[]> {\n const hints: string[] = []\n try {\n const urlObj = new URL(dbUrl)\n const isSupabasePort = urlObj.port === SUPABASE_LOCAL_PORT\n const isLocal = ['localhost', '127.0.0.1', '::1', ''].includes(urlObj.hostname)\n\n if (!isLocal) return hints\n\n // Server is reachable but rejecting — suggest config fixes, not startup.\n if (error && SERVER_REACHABLE_RE.test(error)) {\n hints.push(`Check the username and password in your database URL.`)\n if (isSupabasePort) {\n hints.push(`Port ${SUPABASE_LOCAL_PORT} is the Supabase CLI default. The default password is \"postgres\".`)\n }\n return hints\n }\n\n if (isSupabasePort) {\n hints.push(`Port ${SUPABASE_LOCAL_PORT} is the Supabase CLI default. Run ${cmd('\"supabase start\"')} to start your local Supabase instance.`)\n }\n\n const runtime = await detectRuntime()\n if (runtime) {\n hints.push(`${bold(runtime)} detected — you can start a PostgreSQL container manually.`)\n }\n\n if (!isSupabasePort) {\n hints.push(`Start PostgreSQL manually on port ${urlObj.port || DEFAULT_PG_PORT}.`)\n }\n } catch {\n // Invalid URL — no hints\n }\n return hints\n}\n\n/**\n * Hints for a connection that was bounded rather than refused.\n *\n * These apply to any host, unlike the local-startup hints — a stalled server\n * is just as likely to be a remote one behind a dropped tunnel, which is the\n * case that motivated bounding the wait at all (issue #44).\n */\nexport function buildTimeoutHints(): string[] {\n return [\n 'The host is listening but the database did not answer.',\n 'Check the database process is running and not paused, restarting, or overloaded.',\n 'Over a VPN or tunnel, check the connection is still up.',\n `Raise the bound with ${cmd('SUPAFORGE_CONNECT_TIMEOUT')} (in seconds) if the link is simply slow.`,\n ]\n}\n\n/**\n * Pick the right hints for a failed connection.\n *\n * A timeout and a refusal need different advice, and the local-startup hints\n * are actively misleading for a remote host that stalled.\n */\nexport async function buildConnectionHints(dbUrl: string, error?: string): Promise<string[]> {\n if (error && /timed out after \\d+s/.test(error)) return buildTimeoutHints()\n return buildLocalHints(dbUrl, error)\n}\n\n// ─── Preflight class ─────────────────────────────────────────────────────────\n\ntype LogFn = (msg: string) => void\n\n/**\n * Render a transient \"in progress\" line, or clear it when passed null.\n *\n * Separate from LogFn because these lines are overwritten rather than kept:\n * on a TTY the finished result replaces them, and off a TTY they are dropped\n * entirely so piped output and CI logs stay one line per check.\n */\nexport type PendingFn = (msg: string | null) => void\n\nconst defaultPending: PendingFn = (msg) => {\n if (!process.stdout.isTTY) return\n process.stdout.write(msg === null ? '\\r\\u001b[2K' : `\\r\\u001b[2K${msg}`)\n}\n\n/** Queued database to check during run(). */\ninterface DbEntry {\n label: string\n envName: string\n dbUrl: string\n}\n\n/** Custom check callback. Return null on success, or an error string on failure. */\nexport type CustomCheckFn = () => Promise<{ error?: string; detail?: string; hints?: string[] }>\n\n/** Queued custom check. */\ninterface CustomEntry {\n label: string\n fn: CustomCheckFn\n}\n\n/**\n * Composable preflight check runner.\n *\n * Usage:\n * ```ts\n * const pre = new Preflight('Diff preflight checks', (m) => this.log(m))\n * pre.addDatabase('Source', 'local', sourceUrl)\n * pre.addDatabase('Target', 'prod', targetUrl)\n * const report = await pre.run()\n * if (!report.passed) this.error('Aborted.', { exit: 1 })\n * ```\n *\n * For commands with extra checks (e.g. clone's pg_dump compat):\n * ```ts\n * pre.addCheck('pg_dump compatibility', async () => { ... })\n * ```\n */\nexport class Preflight {\n private readonly title: string\n private readonly log: LogFn\n private readonly pending: PendingFn\n private readonly databases: DbEntry[] = []\n private readonly customs: CustomEntry[] = []\n private readonly infoLines: Array<{ label: string; value: string }> = []\n\n constructor(title: string, log: LogFn, pending: PendingFn = defaultPending) {\n this.title = title\n this.log = log\n this.pending = pending\n }\n\n /** Register a database connectivity check. */\n addDatabase(label: string, envName: string, dbUrl: string): this {\n this.databases.push({ label, envName, dbUrl })\n return this\n }\n\n /** Add an informational line to the header (displayed after database lines). */\n addInfo(label: string, value: string): this {\n this.infoLines.push({ label, value })\n return this\n }\n\n /** Register a custom check (runs after all DB connectivity checks). */\n addCheck(label: string, fn: CustomCheckFn): this {\n this.customs.push({ label, fn })\n return this\n }\n\n /** Execute all registered checks, render results, and return the report. */\n async run(): Promise<PreflightReport> {\n const entries: CheckEntry[] = []\n const log = this.log\n\n // Header\n log(`\\n ${bold(this.title)}\\n`)\n for (const db of this.databases) {\n log(` ${db.label}: ${db.envName} ${dim(`(${redactUrls(db.dbUrl)})`)}`)\n }\n for (const info of this.infoLines) {\n log(` ${info.label}: ${info.value}`)\n }\n log('')\n log(' Checks:')\n\n // Database connectivity checks\n for (const db of this.databases) {\n // Named before the wait, not after: a connection that is merely slow\n // otherwise leaves the header on screen with no clue which of the two\n // environments is holding things up (issue #44).\n // The label is already the noun — \"Database\", \"Target\", \"Source\" — so\n // appending \"database\" gave \"Database database reachable\" (issue #97).\n this.pending(` ${dim(`… connecting to ${db.label.toLowerCase()}`)}`)\n const result = await checkConnection(db.dbUrl)\n this.pending(null)\n if (result.reachable) {\n log(` ${ok('✓')} ${db.label} reachable ${dim(`(PostgreSQL ${result.version})`)}`)\n entries.push({ label: db.label, passed: true, detail: `PostgreSQL ${result.version}` })\n } else {\n log(` ${warn('✗')} ${db.label} not reachable: ${redactUrls(describeFailure(result.error))}`)\n const hints = await buildConnectionHints(db.dbUrl, result.error)\n if (hints.length > 0) {\n log(`\\n ${dim('Hints:')}`)\n for (const h of hints) log(` ${dim('•')} ${h}`)\n }\n entries.push({ label: db.label, passed: false, error: result.error, hints })\n }\n }\n\n // Custom checks\n for (const custom of this.customs) {\n this.pending(` ${dim(`… ${custom.label}`)}`)\n const result = await custom.fn()\n this.pending(null)\n if (!result.error) {\n const suffix = result.detail ? ` ${dim(result.detail)}` : ''\n log(` ${ok('✓')} ${custom.label}${suffix}`)\n entries.push({ label: custom.label, passed: true, detail: result.detail })\n } else {\n log(` ${warn('✗')} ${custom.label}: ${redactUrls(describeFailure(result.error))}`)\n if (result.hints?.length) {\n log(`\\n ${dim('Hints:')}`)\n for (const h of result.hints) log(` ${dim('•')} ${h}`)\n }\n entries.push({ label: custom.label, passed: false, error: result.error, hints: result.hints })\n }\n }\n\n const passed = entries.every(e => e.passed)\n log('')\n if (!passed) {\n log(` ${warn('Some checks failed.')} Fix the issues above first.\\n`)\n } else {\n log(` ${ok('All checks passed.')}\\n`)\n }\n\n return { passed, checks: entries }\n }\n}\n","import { execFile } from 'node:child_process'\nimport { promisify } from 'node:util'\nimport pg from 'pg'\nimport { pgClientConfig } from './db.js'\nimport { RUNTIME_DETECT_TIMEOUT_MS, CONTAINER_RM_TIMEOUT_MS, CONTAINER_START_TIMEOUT_MS } from './constants'\n\nconst defaultExecFile = promisify(execFile)\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Injected exec function for testability. */\nexport type ExecFn = (\n cmd: string,\n args: string[],\n opts?: { timeout?: number },\n) => Promise<{ stdout: string; stderr: string }>\n\n/** Injected PostgreSQL connect function for readiness polling. */\nexport type ConnectFn = (url: string) => Promise<void>\n\n// ─── Constants ───────────────────────────────────────────────────────────────\n\n/** Default PostgreSQL image used for local containers. */\nexport const PG_IMAGE = 'docker.io/library/postgres:17'\n\n/** Default host port for the local PostgreSQL container. */\nexport const DEFAULT_LOCAL_PORT = 5432\n\n/** Default container name. */\nexport const CONTAINER_NAME = 'supaforge-local-pg'\n\n/** Default credentials for the local container. */\nexport const LOCAL_PG_USER = 'postgres'\nexport const LOCAL_PG_PASSWORD = 'postgres'\n\n/** Maximum retries when waiting for PostgreSQL readiness. */\nexport const READINESS_RETRIES = 30\n\n/** Delay between readiness checks (ms). */\nexport const READINESS_INTERVAL_MS = 2000\n\n// ─── Default implementations ────────────────────────────────────────────────\n\nasync function defaultConnectFn(url: string): Promise<void> {\n const client = new pg.Client(pgClientConfig(url))\n await client.connect()\n await client.end()\n}\n\n// ─── Container Runtime Detection ─────────────────────────────────────────────\n\nexport type ContainerRuntime = 'podman' | 'docker'\n\n/**\n * Detect the available container runtime.\n * Prefers podman (rootless, daemonless) over docker.\n * Returns null if neither is available.\n */\nexport async function detectRuntime(execFn: ExecFn = defaultExecFile): Promise<ContainerRuntime | null> {\n for (const rt of ['podman', 'docker'] as const) {\n try {\n await execFn(rt, ['--version'], { timeout: RUNTIME_DETECT_TIMEOUT_MS })\n return rt\n } catch {\n continue\n }\n }\n return null\n}\n\n// ─── Container Lifecycle ─────────────────────────────────────────────────────\n\nexport interface StartLocalPgOptions {\n /** Container runtime to use. Auto-detected if not provided. */\n runtime?: ContainerRuntime\n /** Host port to bind (default: 5432). */\n port?: number\n /** PostgreSQL password (default: 'postgres'). */\n password?: string\n /** Container name (default: 'supaforge-local-pg'). */\n name?: string\n /** PostgreSQL image (default: PG_IMAGE). */\n image?: string\n /** Injected exec function for testability. */\n execFn?: ExecFn\n /** Injected connect function for testability. */\n connectFn?: ConnectFn\n}\n\nexport interface LocalPgInfo {\n runtime: ContainerRuntime\n containerName: string\n port: number\n url: string\n}\n\n/**\n * Start a local PostgreSQL container using the detected runtime.\n *\n * Uses tmpfs for ephemeral storage (fast, no disk writes).\n * Waits for PostgreSQL to accept connections before returning.\n */\nexport async function startLocalPg(options: StartLocalPgOptions = {}): Promise<LocalPgInfo> {\n const exec = options.execFn ?? defaultExecFile\n const connect = options.connectFn ?? defaultConnectFn\n const runtime = options.runtime ?? await detectRuntime(exec)\n if (!runtime) {\n throw new Error(\n 'No container runtime found. Install Podman (recommended) or Docker.\\n' +\n ' Podman: https://podman.io/docs/installation\\n' +\n ' Docker: https://docs.docker.com/engine/install/',\n )\n }\n\n const port = options.port ?? DEFAULT_LOCAL_PORT\n const password = options.password ?? LOCAL_PG_PASSWORD\n const name = options.name ?? CONTAINER_NAME\n const image = options.image ?? PG_IMAGE\n\n // Check if container already exists and is running\n const existing = await getContainerStatus(runtime, name, exec)\n if (existing === 'running') {\n return {\n runtime,\n containerName: name,\n port,\n url: buildLocalUrl(port, password),\n }\n }\n\n // Remove stopped container with same name\n if (existing === 'stopped') {\n await exec(runtime, ['rm', '-f', name], { timeout: CONTAINER_RM_TIMEOUT_MS })\n }\n\n // Start the container\n const args = [\n 'run', '-d',\n '--name', name,\n '-p', `${port}:5432`,\n '-e', `POSTGRES_PASSWORD=${password}`,\n '-e', `POSTGRES_USER=${LOCAL_PG_USER}`,\n '--tmpfs', '/var/lib/postgresql/data',\n '--health-cmd', `pg_isready -U ${LOCAL_PG_USER}`,\n '--health-interval', '5s',\n '--health-timeout', '5s',\n '--health-retries', '20',\n '--health-start-period', '10s',\n image,\n ]\n\n try {\n await exec(runtime, args, { timeout: CONTAINER_START_TIMEOUT_MS })\n } catch (err) {\n throw new Error(\n `Failed to start PostgreSQL container via ${runtime}: ${(err as Error).message}`,\n )\n }\n\n // Wait for readiness using actual pg connection\n const url = buildLocalUrl(port, password)\n await waitForPg(url, connect)\n\n return { runtime, containerName: name, port, url }\n}\n\n/**\n * Stop and remove the local PostgreSQL container.\n */\nexport async function stopLocalPg(\n runtime?: ContainerRuntime,\n name: string = CONTAINER_NAME,\n execFn: ExecFn = defaultExecFile,\n): Promise<void> {\n const rt = runtime ?? await detectRuntime(execFn)\n if (!rt) return\n\n try {\n await execFn(rt, ['rm', '-f', name], { timeout: CONTAINER_RM_TIMEOUT_MS })\n } catch {\n // Container may not exist — ignore\n }\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nasync function getContainerStatus(\n runtime: ContainerRuntime,\n name: string,\n execFn: ExecFn,\n): Promise<'running' | 'stopped' | 'none'> {\n try {\n const { stdout } = await execFn(\n runtime,\n ['inspect', '--format', '{{.State.Running}}', name],\n { timeout: RUNTIME_DETECT_TIMEOUT_MS },\n )\n return stdout.trim() === 'true' ? 'running' : 'stopped'\n } catch {\n return 'none'\n }\n}\n\nfunction buildLocalUrl(port: number, password: string): string {\n return `postgres://${LOCAL_PG_USER}:${password}@localhost:${port}/postgres`\n}\n\n/**\n * Poll PostgreSQL until it accepts connections.\n * Uses actual pg.Client connection rather than relying on container health checks\n * (which may not work on all runtimes).\n */\nasync function waitForPg(url: string, connectFn: ConnectFn): Promise<void> {\n for (let i = 0; i < READINESS_RETRIES; i++) {\n try {\n await connectFn(url)\n return\n } catch {\n await sleep(READINESS_INTERVAL_MS)\n }\n }\n throw new Error(\n `PostgreSQL at ${url} did not become ready within ${READINESS_RETRIES * READINESS_INTERVAL_MS / 1000}s`,\n )\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise(resolve => setTimeout(resolve, ms))\n}\n","/**\n * Persistent command run log stored at ~/.supaforge/run-log.jsonl.\n *\n * Each entry is one JSON object per line (JSONL format) recording:\n * timestamp, command, args (with URLs redacted), duration, exitStatus, error.\n *\n * Used by `supaforge report` to show recent command history.\n * Entries older than RUN_LOG_MAX_ENTRIES are pruned automatically on append.\n */\nimport { readFile, writeFile, mkdir, appendFile } from 'node:fs/promises'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport { redactUrls } from './utils/error.js'\nimport { RUN_LOG_MAX_ENTRIES, RUN_LOG_DIR, RUN_LOG_FILE } from './constants.js'\n\n/**\n * Per-check summary attached to diff/apply run log entries.\n * Contains only operational metadata — never SQL, table names, or data values.\n * Error strings are sanitized (URLs and file paths stripped) before storage.\n */\nexport interface RunLogCheckSummary {\n check: string\n status: string\n issueCount: number\n durationMs: number\n error?: string\n}\n\nexport interface RunLogEntry {\n timestamp: string\n command: string\n args: string[]\n durationMs: number\n exitStatus: 'success' | 'error'\n error?: string\n /** supaforge version that produced this entry */\n version?: string\n /** Populated by diff/apply: per-check status and counts, no SQL content. */\n checkSummaries?: RunLogCheckSummary[]\n}\n\n/** Full path to the run log file. */\nexport function runLogPath(): string {\n return join(homedir(), RUN_LOG_DIR, RUN_LOG_FILE)\n}\n\n/** Full path to the run log directory. */\nexport function runLogDir(): string {\n return join(homedir(), RUN_LOG_DIR)\n}\n\n/** Append a single run entry to the log. Prunes old entries if needed. */\nexport async function appendRunLog(entry: RunLogEntry): Promise<void> {\n const dir = runLogDir()\n await mkdir(dir, { recursive: true })\n const path = runLogPath()\n const line = JSON.stringify(entry) + '\\n'\n await appendFile(path, line, 'utf8')\n // Prune asynchronously — don't block command output\n pruneRunLog(path).catch(() => {})\n}\n\n/** Read all run log entries (most recent last). Returns [] if file doesn't exist. */\nexport async function readRunLog(): Promise<RunLogEntry[]> {\n try {\n const raw = await readFile(runLogPath(), 'utf8')\n return raw\n .split('\\n')\n .filter(Boolean)\n .map(line => {\n try { return JSON.parse(line) as RunLogEntry }\n catch { return null }\n })\n .filter((e): e is RunLogEntry => e !== null)\n } catch {\n return []\n }\n}\n\n/** Remove oldest entries, keeping at most RUN_LOG_MAX_ENTRIES. */\nasync function pruneRunLog(path: string): Promise<void> {\n try {\n const raw = await readFile(path, 'utf8')\n const lines = raw.split('\\n').filter(Boolean)\n if (lines.length <= RUN_LOG_MAX_ENTRIES) return\n const trimmed = lines.slice(lines.length - RUN_LOG_MAX_ENTRIES)\n await writeFile(path, trimmed.join('\\n') + '\\n', 'utf8')\n } catch {\n // Non-fatal\n }\n}\n\n/** Build a redacted args list safe for logging. Strips passwords from URLs. */\nexport function redactArgs(argv: string[]): string[] {\n return argv.map(redactUrls)\n}\n"],"mappings":"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","names":["pg","pg"]}
@@ -0,0 +1,574 @@
1
+ import {
2
+ rolesNamedBy,
3
+ sqlSkeleton
4
+ } from "./chunk-RRMI5CZD.js";
5
+ import {
6
+ isCommentOnly,
7
+ splitSqlStatements
8
+ } from "./chunk-G2DIPIYU.js";
9
+ import {
10
+ getServerMajorVersion,
11
+ resolvePgDumpPath
12
+ } from "./chunk-YVDSR4GM.js";
13
+ import {
14
+ globToRegExp
15
+ } from "./chunk-DQQ5E563.js";
16
+ import {
17
+ pgQuery,
18
+ quoteName
19
+ } from "./chunk-X6V2GGDZ.js";
20
+
21
+ // src/prove.ts
22
+ import { randomBytes } from "crypto";
23
+ import { execFile, spawn } from "child_process";
24
+ import { promisify } from "util";
25
+ import { fingerprintSql, stateSql } from "@akal/pg-conformance";
26
+
27
+ // src/state-diff.ts
28
+ var show = (v) => {
29
+ if (v === null || v === void 0) return "none";
30
+ if (typeof v === "boolean") return v ? "yes" : "no";
31
+ if (Array.isArray(v)) return v.length ? v.join(", ") : "none";
32
+ if (typeof v === "object") return JSON.stringify(v);
33
+ return String(v);
34
+ };
35
+ var qualify = (schema, name) => `${schema}.${name}`;
36
+ function compareField(out, subject, label, before, after) {
37
+ const a = show(before), b = show(after);
38
+ if (a !== b) out.push(`${subject}: ${label} ${a} \u2192 ${b}`);
39
+ }
40
+ function compareKeyed(out, kind, before, after, keyOf, compare) {
41
+ const a = new Map((before ?? []).map((x) => [keyOf(x), x]));
42
+ const b = new Map((after ?? []).map((x) => [keyOf(x), x]));
43
+ for (const [key, item] of a) {
44
+ if (!b.has(key)) out.push(`${kind} ${key}: missing`);
45
+ else compare(out, `${kind} ${key}`, item, b.get(key));
46
+ }
47
+ for (const key of b.keys()) {
48
+ if (!a.has(key)) out.push(`${kind} ${key}: unexpected`);
49
+ }
50
+ }
51
+ function compareColumn(out, subject, a, b) {
52
+ compareField(out, subject, "type", a.type, b.type);
53
+ compareField(out, subject, "not null", a.not_null, b.not_null);
54
+ compareField(out, subject, "default", a.default, b.default);
55
+ compareField(out, subject, "identity", a.identity, b.identity);
56
+ compareField(out, subject, "identity options", a.identity_options, b.identity_options);
57
+ compareField(out, subject, "generated", a.generated, b.generated);
58
+ compareField(out, subject, "storage", a.storage, b.storage);
59
+ compareField(out, subject, "compression", a.compression, b.compression);
60
+ compareField(out, subject, "collation", a.collation, b.collation);
61
+ compareField(out, subject, "comment", a.comment, b.comment);
62
+ }
63
+ function compareTable(out, subject, a, b) {
64
+ compareField(out, subject, "kind", a.kind, b.kind);
65
+ compareField(out, subject, "unlogged", a.unlogged, b.unlogged);
66
+ compareField(out, subject, "partition of", a.partition_of, b.partition_of);
67
+ compareField(out, subject, "partition bound", a.partition_bound, b.partition_bound);
68
+ compareField(out, subject, "partition by", a.partition_by, b.partition_by);
69
+ compareField(out, subject, "inherits", a.inherits, b.inherits);
70
+ compareField(out, subject, "options", a.options, b.options);
71
+ compareField(out, subject, "RLS enabled", a.rls_enabled, b.rls_enabled);
72
+ compareField(out, subject, "RLS forced", a.rls_forced, b.rls_forced);
73
+ compareField(out, subject, "comment", a.comment, b.comment);
74
+ const prefix = subject.replace(/^table /, "");
75
+ compareKeyed(
76
+ out,
77
+ "column",
78
+ a.columns,
79
+ b.columns,
80
+ (c) => `${prefix}.${c.name}`,
81
+ (o, s, x, y) => compareColumn(o, s, x, y)
82
+ );
83
+ compareKeyed(
84
+ out,
85
+ `constraint on ${prefix}`,
86
+ a.constraints,
87
+ b.constraints,
88
+ (c) => c.name,
89
+ (o, s, x, y) => {
90
+ compareField(o, s, "definition", x.definition, y.definition);
91
+ compareField(o, s, "validated", x.validated, y.validated);
92
+ compareField(o, s, "deferrable", x.deferrable, y.deferrable);
93
+ compareField(o, s, "deferred", x.deferred, y.deferred);
94
+ }
95
+ );
96
+ compareKeyed(
97
+ out,
98
+ `index on ${prefix}`,
99
+ a.indexes,
100
+ b.indexes,
101
+ (i) => i.name,
102
+ (o, s, x, y) => compareField(o, s, "definition", x.definition, y.definition)
103
+ );
104
+ compareKeyed(
105
+ out,
106
+ `policy on ${prefix}`,
107
+ a.policies,
108
+ b.policies,
109
+ (p) => p.name,
110
+ (o, s, x, y) => {
111
+ compareField(o, s, "command", x.command, y.command);
112
+ compareField(o, s, "permissive", x.permissive, y.permissive);
113
+ compareField(o, s, "roles", x.roles, y.roles);
114
+ compareField(o, s, "using", x.using, y.using);
115
+ compareField(o, s, "with check", x.with_check, y.with_check);
116
+ }
117
+ );
118
+ compareKeyed(
119
+ out,
120
+ `trigger on ${prefix}`,
121
+ a.triggers,
122
+ b.triggers,
123
+ (t) => t.name,
124
+ (o, s, x, y) => compareField(o, s, "definition", x.definition, y.definition)
125
+ );
126
+ }
127
+ function diffState(before, after) {
128
+ const out = [];
129
+ compareKeyed(
130
+ out,
131
+ "table",
132
+ before.tables,
133
+ after.tables,
134
+ (t) => qualify(t.schema, t.name),
135
+ (o, s, a, b) => compareTable(o, s, a, b)
136
+ );
137
+ compareKeyed(
138
+ out,
139
+ "view",
140
+ before.views,
141
+ after.views,
142
+ (v) => qualify(v.schema, v.name),
143
+ (o, s, a, b) => {
144
+ compareField(o, s, "materialized", a.materialized, b.materialized);
145
+ compareField(o, s, "definition", a.definition, b.definition);
146
+ compareField(o, s, "options", a.options, b.options);
147
+ }
148
+ );
149
+ compareKeyed(
150
+ out,
151
+ "sequence",
152
+ before.sequences,
153
+ after.sequences,
154
+ (q) => qualify(q.schema, q.name),
155
+ (o, s, a, b) => {
156
+ for (const k of ["type", "start", "increment", "min", "max", "cache", "cycle", "owned_by"]) {
157
+ compareField(o, s, k.replace("_", " "), a[k], b[k]);
158
+ }
159
+ }
160
+ );
161
+ compareKeyed(
162
+ out,
163
+ "routine",
164
+ before.routines,
165
+ after.routines,
166
+ (r) => `${qualify(r.schema, r.name)}(${r.arguments})`,
167
+ (o, s, a, b) => {
168
+ compareField(o, s, "kind", a.kind, b.kind);
169
+ compareField(o, s, "definition", a.definition, b.definition);
170
+ }
171
+ );
172
+ compareKeyed(
173
+ out,
174
+ "type",
175
+ before.types,
176
+ after.types,
177
+ (t) => qualify(t.schema, t.name),
178
+ (o, s, a, b) => {
179
+ compareField(o, s, "kind", a.kind, b.kind);
180
+ compareField(o, s, "labels", a.labels, b.labels);
181
+ compareField(o, s, "base type", a.base_type, b.base_type);
182
+ compareField(o, s, "not null", a.not_null, b.not_null);
183
+ compareField(o, s, "default", a.default, b.default);
184
+ compareField(o, s, "constraints", a.constraints, b.constraints);
185
+ compareField(o, s, "attributes", a.attributes, b.attributes);
186
+ }
187
+ );
188
+ compareKeyed(
189
+ out,
190
+ "extension",
191
+ before.extensions,
192
+ after.extensions,
193
+ (e) => e.name,
194
+ (o, s, a, b) => compareField(o, s, "version", a.version, b.version)
195
+ );
196
+ return out;
197
+ }
198
+
199
+ // src/prove.ts
200
+ import { join, dirname } from "path";
201
+ var exec = promisify(execFile);
202
+ var TARGET_EXTENSIONS_SQL = `
203
+ SELECT e.extname AS name, n.nspname AS schema
204
+ FROM pg_extension e
205
+ JOIN pg_namespace n ON n.oid = e.extnamespace
206
+ WHERE n.nspname NOT IN ('pg_catalog', 'information_schema')
207
+ AND n.nspname NOT LIKE 'pg\\_%'
208
+ ORDER BY e.extname
209
+ `;
210
+ function withDatabase(dbUrl, database) {
211
+ const url = new URL(dbUrl);
212
+ url.pathname = `/${database}`;
213
+ return url.toString();
214
+ }
215
+ async function fingerprint(dbUrl, schemas) {
216
+ const rows = await pgQuery(dbUrl, fingerprintSql(schemas));
217
+ const value = rows[0]?.fingerprint;
218
+ if (value === void 0) {
219
+ throw new Error('fingerprint query returned no "fingerprint" column');
220
+ }
221
+ return value ?? "";
222
+ }
223
+ async function describeDifference(sourceUrl, cloneUrl, schemas, want, got) {
224
+ try {
225
+ const [before, after] = await Promise.all([
226
+ schemaState(sourceUrl, schemas),
227
+ schemaState(cloneUrl, schemas)
228
+ ]);
229
+ const findings = diffState(before, after);
230
+ if (findings.length > 0) return findings;
231
+ } catch {
232
+ }
233
+ const wanted = new Set(want.split("\n").filter(Boolean));
234
+ const actual = new Set(got.split("\n").filter(Boolean));
235
+ return [
236
+ ...[...wanted].filter((l) => !actual.has(l)).map((l) => `missing: ${l}`),
237
+ ...[...actual].filter((l) => !wanted.has(l)).map((l) => `unexpected: ${l}`)
238
+ ];
239
+ }
240
+ async function schemaState(dbUrl, schemas) {
241
+ const rows = await pgQuery(dbUrl, stateSql(schemas));
242
+ const value = rows[0]?.state;
243
+ if (!value) throw new Error('state query returned no "state" column');
244
+ return JSON.parse(value);
245
+ }
246
+ async function comparedSchemas(sourceUrl, targetUrl, ignore, query = pgQuery) {
247
+ const sql = `SELECT n.nspname AS name FROM pg_namespace n
248
+ WHERE n.nspname NOT IN ('pg_catalog', 'information_schema')
249
+ AND n.nspname NOT LIKE 'pg\\_toast%' AND n.nspname NOT LIKE 'pg\\_temp\\_%'
250
+ AND NOT EXISTS (SELECT 1 FROM pg_depend d WHERE d.classid = 'pg_namespace'::regclass
251
+ AND d.objid = n.oid AND d.deptype = 'e')`;
252
+ const ignored = ignore.map(globToRegExp);
253
+ const names = (await Promise.all([sourceUrl, targetUrl].map((url) => query(url, sql)))).flat().map((r) => String(r.name));
254
+ return [...new Set(names)].filter((n) => !ignored.some((g) => g.test(n))).sort();
255
+ }
256
+ async function proveConvergence(opts) {
257
+ const schemas = opts.schemas ?? ["public"];
258
+ const suffix = randomBytes(4).toString("hex");
259
+ const cloneName = `supaforge_prove_${suffix}`;
260
+ const adminUrl = withDatabase(opts.targetUrl, "postgres");
261
+ const cloneUrl = withDatabase(opts.targetUrl, cloneName);
262
+ let pgDump;
263
+ let psql;
264
+ let serverMajor;
265
+ let clientMajor;
266
+ let sourceMajor;
267
+ try {
268
+ serverMajor = await getServerMajorVersion(opts.targetUrl);
269
+ sourceMajor = await getServerMajorVersion(opts.sourceUrl).catch(() => serverMajor);
270
+ const resolved = await resolvePgDumpPath(Math.max(serverMajor, sourceMajor)) ?? await resolvePgDumpPath(serverMajor);
271
+ if (!resolved) {
272
+ return { converged: false, residual: [], cloneName, skipped: "pg_dump not available" };
273
+ }
274
+ pgDump = resolved.path;
275
+ clientMajor = resolved.major;
276
+ psql = psqlBeside(pgDump);
277
+ } catch (err) {
278
+ return {
279
+ converged: false,
280
+ residual: [],
281
+ cloneName,
282
+ skipped: `could not resolve pg_dump: ${err.message}`
283
+ };
284
+ }
285
+ const absent = await absentRoles(opts.targetUrl, opts.migrationSql);
286
+ if (absent.length > 0) {
287
+ return {
288
+ converged: false,
289
+ residual: [],
290
+ cloneName,
291
+ skipped: `the migration needs role(s) this server does not have yet (${absent.join(", ")}), and creating a role is server-wide, so it cannot be done in a throwaway database`
292
+ };
293
+ }
294
+ let created = false;
295
+ let sourceCopyCreated = false;
296
+ let roundTripName;
297
+ try {
298
+ try {
299
+ await pgQuery(adminUrl, `CREATE DATABASE ${quoteName(cloneName)}`);
300
+ created = true;
301
+ } catch (err) {
302
+ return {
303
+ converged: false,
304
+ residual: [],
305
+ cloneName,
306
+ skipped: `could not create a throwaway database: ${err.message}`
307
+ };
308
+ }
309
+ const tools = { pgDump, psql, clientMajor, serverMajor };
310
+ await copyStructure(opts.targetUrl, cloneUrl, schemas, tools, opts.sourceUrl);
311
+ const scoped = opts.checks !== void 0 && !opts.checks.includes("schema");
312
+ const before = scoped ? await schemaState(cloneUrl, schemas) : void 0;
313
+ await runSql(psql, cloneUrl, opts.migrationSql);
314
+ const [want, got] = await Promise.all([
315
+ fingerprint(opts.sourceUrl, schemas),
316
+ fingerprint(cloneUrl, schemas)
317
+ ]);
318
+ if (want === got) return { converged: true, residual: [], cloneName };
319
+ roundTripName = `${cloneName}_src`;
320
+ const roundTripUrl = withDatabase(opts.targetUrl, roundTripName);
321
+ const roundTrip = await copyOfSource(adminUrl, opts.sourceUrl, roundTripUrl, roundTripName, schemas, tools);
322
+ if (roundTrip !== null) {
323
+ sourceCopyCreated = true;
324
+ if (roundTrip.ok) {
325
+ const wantRoundTripped = await fingerprint(roundTripUrl, schemas);
326
+ if (wantRoundTripped === got) return { converged: true, residual: [], cloneName };
327
+ const residual2 = await describeDifference(roundTripUrl, cloneUrl, schemas, wantRoundTripped, got);
328
+ return withinScope(residual2, before && diffState(await schemaState(roundTripUrl, schemas), before), opts.checks, cloneName);
329
+ }
330
+ }
331
+ if (sourceMajor !== serverMajor) {
332
+ return {
333
+ converged: false,
334
+ residual: [],
335
+ cloneName,
336
+ skipped: `no pg_dump ${sourceMajor} or later to copy the PostgreSQL ${sourceMajor} source onto the PostgreSQL ${serverMajor} target's server, which comparing across the two versions needs`
337
+ };
338
+ }
339
+ const residual = await describeDifference(opts.sourceUrl, cloneUrl, schemas, want, got);
340
+ return withinScope(residual, before && diffState(await schemaState(opts.sourceUrl, schemas), before), opts.checks, cloneName);
341
+ } finally {
342
+ if (sourceCopyCreated && roundTripName) {
343
+ await dropDatabase(adminUrl, roundTripName);
344
+ }
345
+ if (created) {
346
+ await dropDatabase(adminUrl, cloneName);
347
+ }
348
+ }
349
+ }
350
+ async function copyStructure(fromUrl, intoUrl, schemas, tools, migratingFrom) {
351
+ await prepareClone(intoUrl, fromUrl, schemas);
352
+ const supporting = await supportingSchemas(fromUrl, schemas);
353
+ const present = new Set((await pgQuery(fromUrl, "SELECT nspname FROM pg_namespace")).map((r) => r.nspname));
354
+ if (migratingFrom) {
355
+ for (const name of await supportingSchemas(migratingFrom, schemas)) {
356
+ if (present.has(name) && !supporting.includes(name)) supporting.push(name);
357
+ }
358
+ }
359
+ const dumpArgs = [
360
+ fromUrl,
361
+ "--schema-only",
362
+ "--no-owner",
363
+ "--no-privileges",
364
+ ...[...schemas.filter((s) => present.has(s)), ...supporting].map((s) => `--schema=${quoteName(s)}`)
365
+ ];
366
+ const { stdout: structure } = await exec(tools.pgDump, dumpArgs, {
367
+ maxBuffer: 256 * 1024 * 1024,
368
+ timeout: 3e5
369
+ });
370
+ const { sql: replayable } = dropUnsupportedSetStatements(
371
+ tolerateExistingSchemas(structure),
372
+ await knownParameters(intoUrl)
373
+ );
374
+ try {
375
+ await runSql(tools.psql, intoUrl, replayable);
376
+ } catch (err) {
377
+ throw new Error(explainStructureFailure(err.message, tools.clientMajor, tools.serverMajor));
378
+ }
379
+ }
380
+ async function supportingSchemas(dbUrl, schemas, queryFn = pgQuery) {
381
+ const known = new Set(schemas);
382
+ const found = [];
383
+ for (let from = [...schemas]; from.length > 0; ) {
384
+ const rows = await queryFn(dbUrl, SUPPORTING_SCHEMAS_SQL(from));
385
+ from = rows.map((r) => r.schema).filter((s) => !known.has(s));
386
+ for (const schema of from) {
387
+ known.add(schema);
388
+ found.push(schema);
389
+ }
390
+ }
391
+ return found;
392
+ }
393
+ var NAMESPACE_OF = (cls, oid) => `CASE ${cls}
394
+ WHEN 'pg_class'::regclass THEN (SELECT relnamespace FROM pg_class WHERE oid = ${oid})
395
+ WHEN 'pg_proc'::regclass THEN (SELECT pronamespace FROM pg_proc WHERE oid = ${oid})
396
+ WHEN 'pg_type'::regclass THEN (SELECT typnamespace FROM pg_type WHERE oid = ${oid})
397
+ WHEN 'pg_constraint'::regclass THEN (SELECT connamespace FROM pg_constraint WHERE oid = ${oid})
398
+ WHEN 'pg_attrdef'::regclass THEN (SELECT x_c.relnamespace FROM pg_attrdef x_d JOIN pg_class x_c ON x_c.oid = x_d.adrelid WHERE x_d.oid = ${oid})
399
+ WHEN 'pg_policy'::regclass THEN (SELECT x_c.relnamespace FROM pg_policy x_p JOIN pg_class x_c ON x_c.oid = x_p.polrelid WHERE x_p.oid = ${oid})
400
+ WHEN 'pg_trigger'::regclass THEN (SELECT x_c.relnamespace FROM pg_trigger x_t JOIN pg_class x_c ON x_c.oid = x_t.tgrelid WHERE x_t.oid = ${oid})
401
+ WHEN 'pg_rewrite'::regclass THEN (SELECT x_c.relnamespace FROM pg_rewrite x_r JOIN pg_class x_c ON x_c.oid = x_r.ev_class WHERE x_r.oid = ${oid})
402
+ END`;
403
+ var SUPPORTING_SCHEMAS_SQL = (from) => `
404
+ SELECT DISTINCT rn.nspname AS schema
405
+ FROM pg_depend d
406
+ JOIN pg_namespace n ON n.oid = ${NAMESPACE_OF("d.classid", "d.objid")}
407
+ JOIN pg_namespace rn ON rn.oid = ${NAMESPACE_OF("d.refclassid", "d.refobjid")}
408
+ WHERE n.nspname IN (${from.map(quoteLiteral).join(", ")})
409
+ AND rn.nspname <> n.nspname
410
+ AND rn.nspname NOT IN ('pg_catalog', 'information_schema')
411
+ AND rn.nspname NOT LIKE 'pg\\_%'
412
+ AND d.deptype IN ('n', 'a')
413
+ AND NOT EXISTS (SELECT 1 FROM pg_depend e
414
+ WHERE e.classid = d.refclassid AND e.objid = d.refobjid AND e.deptype = 'e')
415
+ ORDER BY 1`;
416
+ function quoteLiteral(value) {
417
+ return `'${value.replace(/'/g, "''")}'`;
418
+ }
419
+ function tolerateExistingSchemas(sql) {
420
+ return sql.replace(/^CREATE SCHEMA (?!IF NOT EXISTS )/gm, "CREATE SCHEMA IF NOT EXISTS ");
421
+ }
422
+ async function copyOfSource(adminUrl, sourceUrl, intoUrl, name, schemas, tools) {
423
+ try {
424
+ await pgQuery(adminUrl, `CREATE DATABASE ${quoteName(name)}`);
425
+ } catch {
426
+ return null;
427
+ }
428
+ try {
429
+ await copyStructure(sourceUrl, intoUrl, schemas, tools);
430
+ return { ok: true };
431
+ } catch {
432
+ return { ok: false };
433
+ }
434
+ }
435
+ async function dropDatabase(adminUrl, name) {
436
+ await pgQuery(
437
+ adminUrl,
438
+ `SELECT pg_terminate_backend(pid) FROM pg_stat_activity
439
+ WHERE datname = '${name}' AND pid <> pg_backend_pid()`
440
+ ).catch(() => void 0);
441
+ await pgQuery(adminUrl, `DROP DATABASE IF EXISTS ${quoteName(name)}`).catch(() => void 0);
442
+ }
443
+ function runSql(psqlPath, dbUrl, sql) {
444
+ const trimmed = sql.trim();
445
+ if (!trimmed) return Promise.resolve();
446
+ return new Promise((resolve, reject) => {
447
+ const child = spawn(psqlPath, [dbUrl, "-v", "ON_ERROR_STOP=1", "-q", "-f", "-"], {
448
+ stdio: ["pipe", "pipe", "pipe"]
449
+ });
450
+ let stderr = "";
451
+ child.stderr.on("data", (d) => {
452
+ stderr += d.toString();
453
+ });
454
+ child.on("error", reject);
455
+ child.on("close", (code) => {
456
+ if (code === 0) resolve();
457
+ else reject(new Error(stderr.trim() || `psql exited ${code}`));
458
+ });
459
+ child.stdin.write(trimmed);
460
+ child.stdin.end();
461
+ });
462
+ }
463
+ function psqlBeside(pgDumpPath) {
464
+ return pgDumpPath === "pg_dump" ? "psql" : join(dirname(pgDumpPath), "psql");
465
+ }
466
+ var PREAMBLE_LINE = /^\s*(?:--|$|\\(?:un)?restrict\b|SET\s+[\w.]+\s*=|SELECT\s+pg_catalog\.set_config\s*\()/i;
467
+ var SET_STATEMENT = /^\s*SET\s+([\w.]+)\s*=/i;
468
+ function dropUnsupportedSetStatements(sql, knownParameters2) {
469
+ const lines = sql.split("\n");
470
+ const dropped = [];
471
+ const kept = [];
472
+ let inPreamble = true;
473
+ for (const line of lines) {
474
+ if (inPreamble && !PREAMBLE_LINE.test(line)) inPreamble = false;
475
+ if (inPreamble) {
476
+ const name = SET_STATEMENT.exec(line)?.[1];
477
+ if (name && !knownParameters2.has(name.toLowerCase())) {
478
+ dropped.push(name.toLowerCase());
479
+ continue;
480
+ }
481
+ }
482
+ kept.push(line);
483
+ }
484
+ return { sql: kept.join("\n"), dropped };
485
+ }
486
+ async function prepareClone(cloneUrl, targetUrl, schemas, queryFn = pgQuery) {
487
+ for (const schema of schemas) {
488
+ await queryFn(cloneUrl, `DROP SCHEMA IF EXISTS ${quoteName(schema)} CASCADE`);
489
+ }
490
+ const extensions = await queryFn(targetUrl, TARGET_EXTENSIONS_SQL);
491
+ for (const ext of extensions) {
492
+ await queryFn(cloneUrl, `CREATE SCHEMA IF NOT EXISTS ${quoteName(ext.schema)}`).catch(() => void 0);
493
+ await queryFn(
494
+ cloneUrl,
495
+ `CREATE EXTENSION IF NOT EXISTS ${quoteName(ext.name)} WITH SCHEMA ${quoteName(ext.schema)}`
496
+ ).catch(() => void 0);
497
+ }
498
+ }
499
+ async function knownParameters(dbUrl) {
500
+ const rows = await pgQuery(dbUrl, "SELECT name FROM pg_settings");
501
+ return new Set(rows.map((r) => r.name.toLowerCase()));
502
+ }
503
+ function explainStructureFailure(message, clientMajor, serverMajor) {
504
+ const looksLikeVersionGap = /unrecognized configuration parameter|syntax error/i.test(message);
505
+ const versionGap = clientMajor > serverMajor && looksLikeVersionGap ? ` The local client is PostgreSQL ${clientMajor} and the target server is ${serverMajor}; pg_dump ${clientMajor} can emit SQL that a ${serverMajor} server rejects. Installing postgresql-client-${serverMajor} removes the gap.` : "";
506
+ return `could not replay the target's structure onto the clone: ${message}${versionGap}`;
507
+ }
508
+ var DROPPED_NAME = /\bDROP\s+(?:TABLE|VIEW|MATERIALIZED\s+VIEW|TYPE|DOMAIN|SEQUENCE|FUNCTION|PROCEDURE|INDEX|COLUMN|CONSTRAINT|POLICY|TRIGGER)\s+(?:IF\s+EXISTS\s+)?(?:(?:"[^"]+"|[\w$]+)\s*\.\s*)?("[^"]+"|[\w$]+)/gi;
509
+ function residualHeldBack(residual, heldBackSql) {
510
+ const dropped = /* @__PURE__ */ new Set();
511
+ for (const sql of heldBackSql) {
512
+ for (const m of sql.matchAll(DROPPED_NAME)) dropped.add(m[1].replace(/^"|"$/g, "").toLowerCase());
513
+ }
514
+ const heldBack = [];
515
+ const unexplained = [];
516
+ for (const line of residual) {
517
+ const subject = /^[a-z ]+?\s([^\s:]+(?:\s[^\s:]+)?):\s*unexpected$/i.exec(line)?.[1];
518
+ const name = subject?.split(/[.\s]/).pop()?.replace(/^"|"$/g, "").toLowerCase();
519
+ if (name && dropped.has(name)) heldBack.push(line);
520
+ else unexplained.push(line);
521
+ }
522
+ return { heldBack, unexplained };
523
+ }
524
+ var PROVED_CHECKS = /* @__PURE__ */ new Set(["schema", "rls", "rls-coverage", "extensions", "webhooks"]);
525
+ var SERVER_WIDE = [
526
+ /^\s*(?:CREATE|ALTER|DROP)\s+(?:ROLE|USER|GROUP|DATABASE|TABLESPACE)\b/i,
527
+ /^\s*ALTER\s+SYSTEM\b/i,
528
+ // Role membership: a GRANT or REVOKE with no ON names roles, not objects.
529
+ /^\s*(?:GRANT|REVOKE)\b(?![\s\S]*\bON\b)/i
530
+ ];
531
+ function proofScope(statements) {
532
+ const replay = [];
533
+ const unproved = [];
534
+ for (const stmt of statements) {
535
+ const serverWide = splitSqlStatements(stmt.sql).filter((s) => !isCommentOnly(s)).some((s) => SERVER_WIDE.some((re) => re.test(sqlSkeleton(s))));
536
+ if (PROVED_CHECKS.has(stmt.check) && !serverWide) replay.push(stmt);
537
+ else unproved.push(stmt);
538
+ }
539
+ return { replay, unproved };
540
+ }
541
+ async function absentRoles(dbUrl, sql) {
542
+ const named = [...new Set(splitSqlStatements(sql).flatMap((s) => rolesNamedBy(s)))];
543
+ if (named.length === 0) return [];
544
+ const rows = await pgQuery(dbUrl, "SELECT rolname FROM pg_roles WHERE rolname = ANY($1::text[])", [named]);
545
+ const present = new Set(rows.map((r) => r.rolname));
546
+ return named.filter((r) => !present.has(r));
547
+ }
548
+ function withinScope(residual, baseline, checks, cloneName) {
549
+ if (!baseline || !checks) return { converged: residual.length === 0, residual, cloneName };
550
+ const had = new Set(baseline);
551
+ const outOfScope = residual.filter((l) => had.has(l) && outsideTheRun(l, checks));
552
+ const remaining = residual.filter((l) => !outOfScope.includes(l));
553
+ return { converged: remaining.length === 0, residual: remaining, outOfScope, cloneName };
554
+ }
555
+ var GOVERNED = {
556
+ "rls": /^policy on |: RLS (?:enabled|forced) /,
557
+ "rls-coverage": /: RLS enabled /,
558
+ "extensions": /^extension /,
559
+ "webhooks": /^trigger on /
560
+ };
561
+ function outsideTheRun(line, checks) {
562
+ if (checks.includes("schema")) return false;
563
+ return !checks.some((c) => GOVERNED[c]?.test(line));
564
+ }
565
+
566
+ export {
567
+ comparedSchemas,
568
+ proveConvergence,
569
+ dropUnsupportedSetStatements,
570
+ knownParameters,
571
+ residualHeldBack,
572
+ proofScope
573
+ };
574
+ //# sourceMappingURL=chunk-TQJSQLWA.js.map