@akal/supaforge 0.0.32 → 0.0.33
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.
- package/LICENSE +21 -0
- package/README.md +28 -10
- package/dist/commands/mcp.d.ts +1 -0
- package/dist/commands/mcp.js +11 -1
- package/package.json +10 -8
- package/bin/dev.js +0 -10
- package/dist/base-command.js.map +0 -1
- package/dist/chunk-2SELREHW.js.map +0 -1
- package/dist/chunk-3HGAV5CC.js.map +0 -1
- package/dist/chunk-4IVN7QVY.js.map +0 -1
- package/dist/chunk-6LJERPUN.js.map +0 -1
- package/dist/chunk-6Q7MHFBM.js.map +0 -1
- package/dist/chunk-6WAMNZLO.js.map +0 -1
- package/dist/chunk-7NAZGZPV.js.map +0 -1
- package/dist/chunk-BLKJWDTL.js.map +0 -1
- package/dist/chunk-BUOWHE36.js.map +0 -1
- package/dist/chunk-DMIWAJRB.js.map +0 -1
- package/dist/chunk-DQQ5E563.js.map +0 -1
- package/dist/chunk-G2DIPIYU.js.map +0 -1
- package/dist/chunk-GEHPTPNZ.js.map +0 -1
- package/dist/chunk-GZREXCQZ.js.map +0 -1
- package/dist/chunk-MIRLB5JM.js.map +0 -1
- package/dist/chunk-NTUASFQ3.js.map +0 -1
- package/dist/chunk-ORQJVE57.js.map +0 -1
- package/dist/chunk-SC2XHGIS.js.map +0 -1
- package/dist/chunk-SQPCWGQO.js.map +0 -1
- package/dist/chunk-UWAVXC57.js.map +0 -1
- package/dist/commands/clone.js.map +0 -1
- package/dist/commands/diff.js.map +0 -1
- package/dist/commands/help.js.map +0 -1
- package/dist/commands/hukam.js.map +0 -1
- package/dist/commands/init.js.map +0 -1
- package/dist/commands/mcp.js.map +0 -1
- package/dist/commands/migrate/baseline.js.map +0 -1
- package/dist/commands/migrate/create.js.map +0 -1
- package/dist/commands/migrate/list.js.map +0 -1
- package/dist/commands/migrate/run.js.map +0 -1
- package/dist/commands/report.js.map +0 -1
- package/dist/commands/restore.js.map +0 -1
- package/dist/commands/snapshot.js.map +0 -1
- package/dist/commands/sync.js.map +0 -1
- package/dist/help.js.map +0 -1
- package/dist/index.js.map +0 -1
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../src/commands/migrate/create.ts"],"sourcesContent":["import { writeFile, mkdir } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport { Flags } from '@oclif/core'\nimport { BaseCommand } from '../../base-command.js'\nimport { runDbDiff, isDestructiveSql } from '../../dbdiff.js'\nimport { DEFAULT_IGNORE_SCHEMAS } from '../../defaults.js'\nimport { ok, warn, dim, bold, cmd } from '../../ui.js'\nimport { splitSqlStatements } from '../../utils/sql-split.js'\nimport { truncateSql } from './run.js'\nimport { slugify } from '../../utils/strings.js'\n\n/**\n * Generate a new migration file from the current schema drift.\n *\n * Runs a schema diff between source and target, then writes the UP SQL\n * into a timestamped migration file in supabase/migrations/.\n *\n * Replaces `supabase db diff` for self-hosted Supabase instances.\n */\nexport default class MigrateCreate extends BaseCommand {\n static override description = 'Generate a new migration file from schema drift between environments'\n\n static override examples = [\n '<%= config.bin %> migrate create --name=\"add_user_roles\"',\n '<%= config.bin %> migrate create --name=\"update_rls\" --source=staging --target=production',\n ]\n\n static override flags = {\n name: Flags.string({\n char: 'n',\n description: 'Name for the migration (used in filename)',\n required: true,\n }),\n source: Flags.string({ char: 's', description: 'Source environment name' }),\n target: Flags.string({ char: 't', description: 'Target environment name' }),\n }\n\n async run(): Promise<void> {\n const { flags } = await this.parse(MigrateCreate)\n\n const config = await this.loadConfigOrFail()\n this.validateDualEnvConfig(config, flags.source, flags.target)\n\n const sourceEnv = config.environments[config.source!]\n const targetEnv = config.environments[config.target!]\n const dir = this.resolveMigrationsDir(config)\n const ignoreSchemas = config.ignoreSchemas ?? DEFAULT_IGNORE_SCHEMAS\n\n // Preflight: verify both databases are reachable\n const pre = this.createPreflight('Migrate create preflight checks')\n .addDatabase('Source', config.source!, sourceEnv.dbUrl)\n .addDatabase('Target', config.target!, targetEnv.dbUrl)\n await this.runPreflight(pre, 'Migrate create')\n\n this.log(`${bold('migrate create')} — diffing ${dim(config.source!)} → ${dim(config.target!)}\\n`)\n\n const result = await runDbDiff({\n sourceUrl: sourceEnv.dbUrl,\n targetUrl: targetEnv.dbUrl,\n type: 'schema',\n include: 'both',\n ignoreSchemas,\n })\n\n if (!result.up.trim()) {\n this.log(`${ok('No schema drift detected.')} Nothing to write. ✓`)\n return\n }\n\n // Generate timestamped filename\n const timestamp = generateTimestamp()\n const slug = slugify(flags.name)\n const filename = `${timestamp}_${slug}.sql`\n\n // Said when the file is written, not first when `migrate run` refuses it:\n // a diff in which the target has a table the source lacks becomes a\n // DROP TABLE here, and the file looks like any other.\n const destructive = splitSqlStatements(result.up).filter(isDestructiveSql)\n\n // Build file content with UP and optional DOWN\n const lines: string[] = [\n `-- Migration: ${flags.name}`,\n `-- Generated by supaforge migrate create`,\n `-- Source: ${config.source!} → Target: ${config.target!}`,\n ...(destructive.length > 0\n ? [`-- WARNING: ${destructive.length} destructive statement(s) — drops or deletes data. Review before running.`]\n : []),\n '',\n result.up,\n ]\n\n if (result.down.trim()) {\n lines.push(\n '',\n '-- ==================== DOWN ====================',\n '-- To revert this migration, run the SQL below manually:',\n '--',\n ...result.down.split('\\n').map(l => `-- ${l}`),\n )\n }\n\n const content = lines.join('\\n') + '\\n'\n\n // Write file\n await mkdir(dir, { recursive: true })\n const filePath = join(dir, filename)\n await writeFile(filePath, content, 'utf8')\n\n this.log(`${ok('Created migration:')} ${cmd(filePath)}`)\n if (destructive.length > 0) {\n this.log(`\\n${warn(`${destructive.length} destructive statement(s) in it`)} ${dim('— they drop or delete data:')}`)\n for (const sql of destructive) this.log(` ${warn('✗')} ${dim(truncateSql(sql))}`)\n this.log(` ${dim('Review them; migrate run applies them only with --allow-destructive.')}`)\n }\n this.log(`\\n ${dim('To preview:')} ${cmd(`supaforge migrate run --env=${config.target!}`)}`)\n this.log(` ${dim('To apply:')} ${cmd(`supaforge migrate run --env=${config.target!} --apply`)}`)\n this.log(` ${dim('To baseline:')} ${cmd(`supaforge migrate baseline --env=${config.target!}`)}`)\n }\n}\n\n/** Generate a UTC timestamp in Supabase migration format: YYYYMMDDHHmmss */\nexport function generateTimestamp(): string {\n const now = new Date()\n return [\n now.getUTCFullYear(),\n pad(now.getUTCMonth() + 1),\n pad(now.getUTCDate()),\n pad(now.getUTCHours()),\n pad(now.getUTCMinutes()),\n pad(now.getUTCSeconds()),\n ].join('')\n}\n\nfunction pad(n: number): string {\n return String(n).padStart(2, '0')\n}\n\n/** Re-export for backward-compat — uses shared slugify with underscore separator. */\nexport { slugify } from '../../utils/strings.js'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,WAAW,aAAa;AACjC,SAAS,YAAY;AACrB,SAAS,aAAa;AAiBtB,IAAqB,gBAArB,MAAqB,uBAAsB,YAAY;AAAA,EACrD,OAAgB,cAAc;AAAA,EAE9B,OAAgB,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AAAA,EAEA,OAAgB,QAAQ;AAAA,IACtB,MAAM,MAAM,OAAO;AAAA,MACjB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ,CAAC;AAAA,IACD,QAAQ,MAAM,OAAO,EAAE,MAAM,KAAK,aAAa,0BAA0B,CAAC;AAAA,IAC1E,QAAQ,MAAM,OAAO,EAAE,MAAM,KAAK,aAAa,0BAA0B,CAAC;AAAA,EAC5E;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,MAAM,cAAa;AAEhD,UAAM,SAAS,MAAM,KAAK,iBAAiB;AAC3C,SAAK,sBAAsB,QAAQ,MAAM,QAAQ,MAAM,MAAM;AAE7D,UAAM,YAAY,OAAO,aAAa,OAAO,MAAO;AACpD,UAAM,YAAY,OAAO,aAAa,OAAO,MAAO;AACpD,UAAM,MAAM,KAAK,qBAAqB,MAAM;AAC5C,UAAM,gBAAgB,OAAO,iBAAiB;AAG9C,UAAM,MAAM,KAAK,gBAAgB,iCAAiC,EAC/D,YAAY,UAAU,OAAO,QAAS,UAAU,KAAK,EACrD,YAAY,UAAU,OAAO,QAAS,UAAU,KAAK;AACxD,UAAM,KAAK,aAAa,KAAK,gBAAgB;AAE7C,SAAK,IAAI,GAAG,KAAK,gBAAgB,CAAC,mBAAc,IAAI,OAAO,MAAO,CAAC,WAAM,IAAI,OAAO,MAAO,CAAC;AAAA,CAAI;AAEhG,UAAM,SAAS,MAAM,UAAU;AAAA,MAC7B,WAAW,UAAU;AAAA,MACrB,WAAW,UAAU;AAAA,MACrB,MAAM;AAAA,MACN,SAAS;AAAA,MACT;AAAA,IACF,CAAC;AAED,QAAI,CAAC,OAAO,GAAG,KAAK,GAAG;AACrB,WAAK,IAAI,GAAG,GAAG,2BAA2B,CAAC,2BAAsB;AACjE;AAAA,IACF;AAGA,UAAM,YAAY,kBAAkB;AACpC,UAAM,OAAO,QAAQ,MAAM,IAAI;AAC/B,UAAM,WAAW,GAAG,SAAS,IAAI,IAAI;AAKrC,UAAM,cAAc,mBAAmB,OAAO,EAAE,EAAE,OAAO,gBAAgB;AAGzE,UAAM,QAAkB;AAAA,MACtB,iBAAiB,MAAM,IAAI;AAAA,MAC3B;AAAA,MACA,cAAc,OAAO,MAAO,mBAAc,OAAO,MAAO;AAAA,MACxD,GAAI,YAAY,SAAS,IACrB,CAAC,eAAe,YAAY,MAAM,gFAA2E,IAC7G,CAAC;AAAA,MACL;AAAA,MACA,OAAO;AAAA,IACT;AAEA,QAAI,OAAO,KAAK,KAAK,GAAG;AACtB,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,GAAG,OAAO,KAAK,MAAM,IAAI,EAAE,IAAI,OAAK,MAAM,CAAC,EAAE;AAAA,MAC/C;AAAA,IACF;AAEA,UAAM,UAAU,MAAM,KAAK,IAAI,IAAI;AAGnC,UAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC,UAAM,WAAW,KAAK,KAAK,QAAQ;AACnC,UAAM,UAAU,UAAU,SAAS,MAAM;AAEzC,SAAK,IAAI,GAAG,GAAG,oBAAoB,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE;AACvD,QAAI,YAAY,SAAS,GAAG;AAC1B,WAAK,IAAI;AAAA,EAAK,KAAK,GAAG,YAAY,MAAM,iCAAiC,CAAC,IAAI,IAAI,kCAA6B,CAAC,EAAE;AAClH,iBAAW,OAAO,YAAa,MAAK,IAAI,KAAK,KAAK,QAAG,CAAC,IAAI,IAAI,YAAY,GAAG,CAAC,CAAC,EAAE;AACjF,WAAK,IAAI,KAAK,IAAI,sEAAsE,CAAC,EAAE;AAAA,IAC7F;AACA,SAAK,IAAI;AAAA,IAAO,IAAI,aAAa,CAAC,IAAI,IAAI,+BAA+B,OAAO,MAAO,EAAE,CAAC,EAAE;AAC5F,SAAK,IAAI,KAAK,IAAI,WAAW,CAAC,IAAI,IAAI,+BAA+B,OAAO,MAAO,UAAU,CAAC,EAAE;AAChG,SAAK,IAAI,KAAK,IAAI,cAAc,CAAC,IAAI,IAAI,oCAAoC,OAAO,MAAO,EAAE,CAAC,EAAE;AAAA,EAClG;AACF;AAGO,SAAS,oBAA4B;AAC1C,QAAM,MAAM,oBAAI,KAAK;AACrB,SAAO;AAAA,IACL,IAAI,eAAe;AAAA,IACnB,IAAI,IAAI,YAAY,IAAI,CAAC;AAAA,IACzB,IAAI,IAAI,WAAW,CAAC;AAAA,IACpB,IAAI,IAAI,YAAY,CAAC;AAAA,IACrB,IAAI,IAAI,cAAc,CAAC;AAAA,IACvB,IAAI,IAAI,cAAc,CAAC;AAAA,EACzB,EAAE,KAAK,EAAE;AACX;AAEA,SAAS,IAAI,GAAmB;AAC9B,SAAO,OAAO,CAAC,EAAE,SAAS,GAAG,GAAG;AAClC;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../src/commands/migrate/list.ts"],"sourcesContent":["import { Flags } from '@oclif/core'\nimport { BaseCommand } from '../../base-command.js'\nimport { readLocalMigrations } from '../../checks/migrations.js'\nimport { getAppliedVersions } from '../../migrate.js'\nimport { errMsg } from '../../utils/error.js'\nimport { ok, warn, dim, bold } from '../../ui.js'\nimport { pgQuery } from '../../db.js'\n\n/**\n * List local migration files and their applied status.\n *\n * Without --offline, connects to the target database to show which\n * migrations are applied (✓) vs pending (○).\n */\nexport default class MigrateList extends BaseCommand {\n static override description = 'List local migration files and their applied/pending status'\n\n static override examples = [\n '<%= config.bin %> migrate list',\n '<%= config.bin %> migrate list --env=production',\n '<%= config.bin %> migrate list --offline',\n '<%= config.bin %> migrate list --json',\n ]\n\n static override flags = {\n env: Flags.string({\n char: 'e',\n description: 'Environment to check applied status against',\n }),\n offline: Flags.boolean({\n description: 'List local files only without connecting to the database',\n default: false,\n }),\n json: Flags.boolean({ description: 'Output results as JSON' }),\n }\n\n async run(): Promise<void> {\n const { flags } = await this.parse(MigrateList)\n\n const config = await this.loadConfigOrFail()\n const dir = this.resolveMigrationsDir(config)\n\n const migrations = await readLocalMigrations(dir).catch(() => [])\n\n // Offline when asked, or when there is nothing to connect to. Naming an\n // environment is asking for its status: it used to be ignored whenever the\n // config had no `source`, and the files were listed as if offline.\n if (flags.offline || (!config.source && !flags.env)) {\n // Offline: list files only\n if (flags.json) {\n this.json(migrations)\n return\n }\n if (migrations.length === 0) {\n this.log(`\\n ${dim('No local migration files found in')} ${dim(dir)}\\n`)\n return\n }\n this.log(`\\n ${bold(`${migrations.length} local migration(s)`)} ${dim(`in ${dir}`)}\\n`)\n for (const m of migrations) {\n this.log(` ${dim('○')} ${m.filename}`)\n }\n this.log('')\n return\n }\n\n // Online: connect to DB and check applied status\n const { envName, env } = this.resolveEnv(config, flags.env)\n\n const pre = this.createPreflight('Migrate list preflight checks')\n .addDatabase('Target', envName, env.dbUrl)\n await this.runPreflight(pre, 'Migrate list')\n\n // Read only: a listing creates nothing. A history it cannot read leaves\n // every status unknown: listing them as pending read as \"nothing has been\n // applied\", and exited 0.\n let applied: Set<string> | undefined\n try {\n applied = await getAppliedVersions(env.dbUrl, pgQuery)\n } catch (err) {\n this.warn(`Could not read which migrations are applied: ${errMsg(err)}`)\n process.exitCode = 1\n }\n\n if (flags.json) {\n this.json(migrations.map(m => ({ ...m, applied: applied ? applied.has(m.version) : null })))\n return\n }\n\n if (!applied) {\n this.log(`\\n ${bold(`${migrations.length} migration(s)`)} ${dim(`→ ${envName}`)} · ${warn('status unknown')}\\n`)\n for (const m of migrations) this.log(` ${warn('?')} ${m.filename}`)\n this.log('')\n return\n }\n\n if (migrations.length === 0) {\n this.log(`\\n ${dim('No local migration files found in')} ${dim(dir)}\\n`)\n return\n }\n\n const pendingCount = migrations.filter(m => !applied.has(m.version)).length\n const appliedCount = migrations.length - pendingCount\n\n this.log(`\\n ${bold(`${migrations.length} migration(s)`)} ${dim(`→ ${envName}`)} · ${ok(`${appliedCount} applied`)} · ${pendingCount > 0 ? warn(`${pendingCount} pending`) : dim('0 pending')}\\n`)\n\n for (const m of migrations) {\n const isApplied = applied.has(m.version)\n const icon = isApplied ? ok('✓') : dim('○')\n const label = isApplied ? dim(m.filename) : m.filename\n this.log(` ${icon} ${label}`)\n }\n this.log('')\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,SAAS,aAAa;AActB,IAAqB,cAArB,MAAqB,qBAAoB,YAAY;AAAA,EACnD,OAAgB,cAAc;AAAA,EAE9B,OAAgB,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EAEA,OAAgB,QAAQ;AAAA,IACtB,KAAK,MAAM,OAAO;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,IACf,CAAC;AAAA,IACD,SAAS,MAAM,QAAQ;AAAA,MACrB,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,IACD,MAAM,MAAM,QAAQ,EAAE,aAAa,yBAAyB,CAAC;AAAA,EAC/D;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,MAAM,YAAW;AAE9C,UAAM,SAAS,MAAM,KAAK,iBAAiB;AAC3C,UAAM,MAAM,KAAK,qBAAqB,MAAM;AAE5C,UAAM,aAAa,MAAM,oBAAoB,GAAG,EAAE,MAAM,MAAM,CAAC,CAAC;AAKhE,QAAI,MAAM,WAAY,CAAC,OAAO,UAAU,CAAC,MAAM,KAAM;AAEnD,UAAI,MAAM,MAAM;AACd,aAAK,KAAK,UAAU;AACpB;AAAA,MACF;AACA,UAAI,WAAW,WAAW,GAAG;AAC3B,aAAK,IAAI;AAAA,IAAO,IAAI,mCAAmC,CAAC,IAAI,IAAI,GAAG,CAAC;AAAA,CAAI;AACxE;AAAA,MACF;AACA,WAAK,IAAI;AAAA,IAAO,KAAK,GAAG,WAAW,MAAM,qBAAqB,CAAC,IAAI,IAAI,MAAM,GAAG,EAAE,CAAC;AAAA,CAAI;AACvF,iBAAW,KAAK,YAAY;AAC1B,aAAK,IAAI,KAAK,IAAI,QAAG,CAAC,IAAI,EAAE,QAAQ,EAAE;AAAA,MACxC;AACA,WAAK,IAAI,EAAE;AACX;AAAA,IACF;AAGA,UAAM,EAAE,SAAS,IAAI,IAAI,KAAK,WAAW,QAAQ,MAAM,GAAG;AAE1D,UAAM,MAAM,KAAK,gBAAgB,+BAA+B,EAC7D,YAAY,UAAU,SAAS,IAAI,KAAK;AAC3C,UAAM,KAAK,aAAa,KAAK,cAAc;AAK3C,QAAI;AACJ,QAAI;AACF,gBAAU,MAAM,mBAAmB,IAAI,OAAO,OAAO;AAAA,IACvD,SAAS,KAAK;AACZ,WAAK,KAAK,gDAAgD,OAAO,GAAG,CAAC,EAAE;AACvE,cAAQ,WAAW;AAAA,IACrB;AAEA,QAAI,MAAM,MAAM;AACd,WAAK,KAAK,WAAW,IAAI,QAAM,EAAE,GAAG,GAAG,SAAS,UAAU,QAAQ,IAAI,EAAE,OAAO,IAAI,KAAK,EAAE,CAAC;AAC3F;AAAA,IACF;AAEA,QAAI,CAAC,SAAS;AACZ,WAAK,IAAI;AAAA,IAAO,KAAK,GAAG,WAAW,MAAM,eAAe,CAAC,IAAI,IAAI,UAAK,OAAO,EAAE,CAAC,SAAM,KAAK,gBAAgB,CAAC;AAAA,CAAI;AAChH,iBAAW,KAAK,WAAY,MAAK,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE;AACnE,WAAK,IAAI,EAAE;AACX;AAAA,IACF;AAEA,QAAI,WAAW,WAAW,GAAG;AAC3B,WAAK,IAAI;AAAA,IAAO,IAAI,mCAAmC,CAAC,IAAI,IAAI,GAAG,CAAC;AAAA,CAAI;AACxE;AAAA,IACF;AAEA,UAAM,eAAe,WAAW,OAAO,OAAK,CAAC,QAAQ,IAAI,EAAE,OAAO,CAAC,EAAE;AACrE,UAAM,eAAe,WAAW,SAAS;AAEzC,SAAK,IAAI;AAAA,IAAO,KAAK,GAAG,WAAW,MAAM,eAAe,CAAC,IAAI,IAAI,UAAK,OAAO,EAAE,CAAC,SAAM,GAAG,GAAG,YAAY,UAAU,CAAC,SAAM,eAAe,IAAI,KAAK,GAAG,YAAY,UAAU,IAAI,IAAI,WAAW,CAAC;AAAA,CAAI;AAElM,eAAW,KAAK,YAAY;AAC1B,YAAM,YAAY,QAAQ,IAAI,EAAE,OAAO;AACvC,YAAM,OAAO,YAAY,GAAG,QAAG,IAAI,IAAI,QAAG;AAC1C,YAAM,QAAQ,YAAY,IAAI,EAAE,QAAQ,IAAI,EAAE;AAC9C,WAAK,IAAI,KAAK,IAAI,IAAI,KAAK,EAAE;AAAA,IAC/B;AACA,SAAK,IAAI,EAAE;AAAA,EACb;AACF;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/commands/report.ts"],"sourcesContent":["import { Flags } from '@oclif/core'\nimport { createInterface } from 'node:readline/promises'\nimport { BaseCommand } from '../base-command.js'\nimport { readRunLog, runLogPath, type RunLogEntry } from '../run-log.js'\nimport { ok, dim, bold, warn, cmd } from '../ui.js'\nimport { sanitizeForReport } from '../utils/sanitize.js'\n\nconst REPORT_ENDPOINT =\n process.env['SUPAFORGE_REPORT_URL'] ?? 'https://supaforge.dev/api/bug-reports'\nconst PRIVACY_URL = 'https://supaforge.dev/privacy'\nconst DATA_RETENTION_DAYS = 90\n\n/**\n * Display recent supaforge command history from the local run log.\n *\n * With --send: interactively select entries to send as anonymous bug reports.\n * The user sees exactly what data will be transmitted before confirming.\n * No SQL, table names, schema content, or identifying information is ever sent.\n */\nexport default class Report extends BaseCommand {\n static override description = 'Show recent supaforge command history from the local run log'\n\n static override examples = [\n '<%= config.bin %> report',\n '<%= config.bin %> report --last=20',\n '<%= config.bin %> report --send',\n '<%= config.bin %> report --json',\n ]\n\n static override flags = {\n last: Flags.integer({\n char: 'n',\n description: 'Number of recent entries to show',\n default: 10,\n }),\n send: Flags.boolean({\n description: 'Interactively select entries to send as anonymous bug reports',\n default: false,\n }),\n json: Flags.boolean({ description: 'Output as JSON' }),\n }\n\n async run(): Promise<void> {\n const { flags } = await this.parse(Report)\n const all = await readRunLog()\n const entries = all.slice(-flags.last)\n\n if (flags.json) {\n this.json(entries)\n return\n }\n\n if (flags.send) {\n await this.sendFlow(entries)\n return\n }\n\n this.displayEntries(entries)\n }\n\n private displayEntries(entries: RunLogEntry[]): void {\n const logFile = runLogPath()\n\n if (entries.length === 0) {\n this.log(`\\n ${dim('No command history found.')}`)\n this.log(` ${dim(`Log file: ${logFile}`)}`)\n this.log(` ${dim('Run any supaforge command to start logging.')}\\n`)\n return\n }\n\n this.log(`\\n ${bold(`Last ${entries.length} command(s)`)} ${dim(`· log: ${logFile}`)}\\n`)\n\n for (const entry of entries) {\n const ts = new Date(entry.timestamp).toLocaleString()\n const dur = entry.durationMs < 1000\n ? `${entry.durationMs}ms`\n : `${(entry.durationMs / 1000).toFixed(1)}s`\n const icon = entry.exitStatus === 'success' ? ok('✓') : warn('✗')\n this.log(` ${icon} ${bold(entry.command)} ${dim(entry.args.join(' '))}`)\n this.log(` ${dim(`${ts} · ${dur}`)}`)\n if (entry.error) {\n this.log(` ${warn(entry.error)}`)\n }\n if (entry.checkSummaries) {\n for (const c of entry.checkSummaries.filter(s => s.status === 'error' || s.issueCount > 0)) {\n const icon2 = c.status === 'error' ? warn('✗') : dim('●')\n const detail = c.status === 'error' ? warn(c.error ?? 'error') : `${c.issueCount} issues`\n this.log(` ${icon2} ${dim(`[${c.check}]`)} ${detail}`)\n }\n }\n this.log('')\n }\n\n this.log(dim(' ──────────────────────────────────────────────────────────'))\n this.log(dim(' Data is stored only on this machine (~/.supaforge/run-log.jsonl).'))\n this.log(dim(` To send a bug report: ${cmd('supaforge report --send')}`))\n this.log(dim(' To delete history: rm ~/.supaforge/run-log.jsonl\\n'))\n }\n\n private async sendFlow(entries: RunLogEntry[]): Promise<void> {\n if (!process.stdin.isTTY) {\n this.error('--send requires an interactive terminal.')\n }\n\n if (entries.length === 0) {\n this.log(`\\n ${dim('No command history to send.')}\\n`)\n return\n }\n\n this.log(`\\n ${bold('Recent commands')}\\n`)\n for (let i = 0; i < entries.length; i++) {\n const e = entries[i]\n const ts = new Date(e.timestamp).toLocaleString()\n const dur = (e.durationMs / 1000).toFixed(1)\n const icon = e.exitStatus === 'success' ? ok('✓') : warn('✗')\n this.log(` ${dim(`[${i + 1}]`)} ${icon} ${bold(e.command)} ${dim(e.args.join(' '))} ${dim(`${ts} · ${dur}s`)}`)\n if (e.error) this.log(` ${warn(e.error)}`)\n }\n\n const rl = createInterface({ input: process.stdin, output: process.stdout })\n\n let selected: number[]\n let confirmed = false\n\n try {\n const rawSelection = await rl.question(\n '\\n Enter numbers to send (e.g. 1,3 or all, or press Enter to cancel): '\n )\n\n if (!rawSelection.trim()) {\n this.log(`\\n ${dim('Cancelled.')}\\n`)\n return\n }\n\n if (rawSelection.trim().toLowerCase() === 'all') {\n selected = entries.map((_, i) => i)\n } else {\n selected = rawSelection\n .split(',')\n .map(s => parseInt(s.trim(), 10) - 1)\n .filter(n => !isNaN(n) && n >= 0 && n < entries.length)\n }\n\n if (selected.length === 0) {\n this.log(`\\n ${dim('No valid entries selected. Cancelled.')}\\n`)\n return\n }\n\n const payloads = selected.map(i => this.buildPayload(entries[i]))\n\n this.log(`\\n ${bold('Exactly this data will be sent')} ${dim('— nothing else:')}\\n`)\n for (const payload of payloads) {\n const lines = JSON.stringify(payload, null, 4).split('\\n')\n for (const line of lines) this.log(` ${line}`)\n this.log('')\n }\n\n this.log(dim(' ──────────────────────────────────────────────────────────'))\n this.log(dim(' Included: command name · duration · exit status · version'))\n this.log(dim(' per-check status and issue counts'))\n this.log(dim(' error messages (URLs and file paths redacted)'))\n this.log(dim(' Excluded: SQL · table/column names · data values'))\n this.log(dim(' database URLs · file paths · IP addresses'))\n this.log(dim(` Retention: deleted after ${DATA_RETENTION_DAYS} days · ${PRIVACY_URL}`))\n this.log(dim(' ──────────────────────────────────────────────────────────\\n'))\n\n const answer = await rl.question(` Send ${selected.length} report(s)? [y/N] `)\n confirmed = answer.trim().toLowerCase() === 'y'\n } finally {\n rl.close()\n }\n\n if (!confirmed) {\n this.log(`\\n ${dim('Cancelled. Nothing was sent.')}\\n`)\n return\n }\n\n const payloads = selected.map(i => this.buildPayload(entries[i]))\n\n this.log('')\n let sent = 0\n for (const payload of payloads) {\n try {\n const res = await fetch(REPORT_ENDPOINT, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json', 'User-Agent': `supaforge-cli/${payload.version ?? 'unknown'}` },\n body: JSON.stringify(payload),\n signal: AbortSignal.timeout(10_000),\n })\n if (res.ok) {\n const body = await res.json() as { reportId?: string }\n this.log(` ${ok('✓')} Sent${body.reportId ? ` ${dim(`ref: ${body.reportId}`)}` : ''}`)\n sent++\n } else {\n this.log(` ${warn('✗')} Failed (HTTP ${res.status})`)\n }\n } catch {\n this.log(` ${warn('✗')} Failed (network error — check your connection)`)\n }\n }\n\n this.log('')\n if (sent > 0) {\n this.log(dim(` ${sent} report(s) sent. Thank you — this helps us fix bugs faster.\\n`))\n }\n }\n\n private buildPayload(entry: RunLogEntry): Record<string, unknown> {\n return {\n command: entry.command,\n args: entry.args,\n durationMs: entry.durationMs,\n exitStatus: entry.exitStatus,\n ...(entry.error ? { error: sanitizeForReport(entry.error) } : {}),\n ...(entry.version ? { version: entry.version } : {}),\n ...(entry.checkSummaries?.length ? { checkSummaries: entry.checkSummaries } : {}),\n }\n }\n}\n"],"mappings":"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","names":["payloads"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/commands/restore.ts"],"sourcesContent":["import { Flags } from '@oclif/core'\nimport { BaseCommand } from '../base-command.js'\nimport { findLatestSnapshot, listSnapshots } from '../snapshot'\nimport {\n restoreFromSnapshot,\n restoreFromMigrations,\n previewSnapshotRestore,\n previewMigrationRestore,\n getPublicTables,\n summarizeStatement,\n} from '../restore'\nimport { warn, cmd } from '../ui.js'\nimport { renderTip } from '../tips.js'\n\nexport default class Restore extends BaseCommand {\n static override description = 'Restore a Supabase environment from a snapshot or migration history'\n\n static override examples = [\n '<%= config.bin %> restore --env=local --from-snapshot=latest',\n '<%= config.bin %> restore --env=local --from-snapshot=latest --apply',\n '<%= config.bin %> restore --env=local --from-migrations --apply',\n '<%= config.bin %> restore --env=local --from-migrations --to=20260407T120000Z --apply',\n '<%= config.bin %> restore --env=local --from-snapshot=latest --apply --force',\n ]\n\n static override flags = {\n env: Flags.string({\n char: 'e',\n description: 'Target environment to restore into',\n required: true,\n }),\n 'from-snapshot': Flags.string({\n description: 'Restore from a snapshot (\"latest\" or a timestamp)',\n exclusive: ['from-migrations'],\n }),\n 'from-migrations': Flags.boolean({\n description: 'Restore by replaying migration files',\n exclusive: ['from-snapshot'],\n }),\n to: Flags.string({\n description: 'Replay migrations up to this version (timestamp)',\n }),\n from: Flags.string({\n description: 'Replay migrations from this version (timestamp)',\n }),\n apply: Flags.boolean({\n description: 'Actually execute the restore (default: dry-run preview)',\n default: false,\n }),\n 'no-transaction': Flags.boolean({\n description:\n 'Apply each statement on its own, keeping whatever succeeds. Off by default: '\n + 'a snapshot restore runs in one transaction, so a failure leaves the target '\n + 'exactly as it was rather than half-restored. Applies to --from-snapshot.',\n default: false,\n }),\n force: Flags.boolean({\n description: 'Allow restore into a non-empty database (destructive)',\n default: false,\n }),\n json: Flags.boolean({ description: 'Output results as JSON' }),\n }\n\n async run(): Promise<void> {\n const { flags } = await this.parse(Restore)\n\n if (!flags['from-snapshot'] && !flags['from-migrations']) {\n this.error('Specify --from-snapshot or --from-migrations')\n }\n\n const config = await this.loadConfigOrFail()\n\n const envName = flags.env\n const { env } = this.resolveEnv(config, envName)\n\n // Preflight: verify database is reachable. Under --json too, where its\n // lines go to stderr and a failure is reported as JSON.\n const pre = this.createPreflight('Restore preflight checks')\n .addDatabase('Target', envName, env.dbUrl)\n await this.runPreflight(pre, 'Restore')\n\n // Safety: check if target DB has existing tables before destructive restore\n if (flags.apply) {\n const tables = await getPublicTables(env.dbUrl)\n if (tables.length > 0 && !flags.force) {\n if (flags.json) {\n this.json({ error: 'Target database is not empty', tables })\n this.exit(1)\n }\n this.log(`\\n${warn('Target database is not empty.')} Found ${tables.length} table(s) in public schema:`)\n for (const t of tables.slice(0, 10)) {\n this.log(` • ${t}`)\n }\n if (tables.length > 10) {\n this.log(` ... and ${tables.length - 10} more`)\n }\n this.log(`\\n Restore replays SQL into the target and may conflict with existing data.`)\n this.log(` → Use ${cmd('supaforge sync')} to apply only the differences instead.`)\n this.log(` → Add ${cmd('--force')} to drop and replace the schemas this snapshot covers.\\n`)\n // --apply was asked for and refused, so this is not success. Returning\n // 0 made `supaforge restore ... --apply && deploy` continue as though\n // the restore had happened, which is the worst possible reading of a\n // safety guard: it protects the data and then lets the pipeline act on\n // the assumption it did not have to.\n this.exit(1)\n }\n }\n\n if (flags['from-snapshot']) {\n await this.handleSnapshotRestore(flags, env.dbUrl)\n } else {\n await this.handleMigrationRestore(flags, env.dbUrl)\n }\n }\n\n private async handleSnapshotRestore(\n flags: Record<string, unknown>,\n targetUrl: string,\n ): Promise<void> {\n const snapshotRef = flags['from-snapshot'] as string\n let snapshotDir: string\n\n if (snapshotRef === 'latest') {\n const latest = await findLatestSnapshot()\n if (!latest) {\n this.error('No snapshots found. Create one with \"supaforge snapshot\" first.')\n }\n snapshotDir = latest\n } else {\n // Assume it's a timestamp — resolve to path\n const snapshots = await listSnapshots()\n const match = snapshots.find(s => s.manifest.timestamp === snapshotRef)\n if (!match) {\n this.error(`Snapshot \"${snapshotRef}\" not found. Use --from-snapshot=latest or a valid timestamp.`)\n }\n snapshotDir = match.dir\n }\n\n if (!flags.apply) {\n const preview = await previewSnapshotRestore(snapshotDir)\n if (flags.json) {\n this.json({ dryRun: true, snapshot: snapshotDir, layers: preview })\n return\n }\n this.log('\\nRestore preview (dry-run) -- from snapshot\\n')\n if (preview.length === 0) {\n this.log(' No executable SQL found in snapshot.')\n return\n }\n\n for (const { layer, statements } of preview) {\n this.log(` Layer: ${layer} (${statements.length} statements)`)\n // `summarizeStatement`, not the first line: a statement carrying a\n // leading comment — which every layer file's first one does, since the\n // header lands in the same chunk — showed the comment instead of the\n // SQL. A preview you cannot read is the one thing a preview must not\n // be. It is also what the apply path prints, so the two now describe\n // the same statement the same way.\n for (const stmt of statements.slice(0, 3)) {\n this.log(` ${summarizeStatement(stmt)}`)\n }\n if (statements.length > 3) {\n this.log(` ... and ${statements.length - 3} more`)\n }\n this.log('')\n }\n this.log(` → Add --apply to execute the restore.\\n`)\n return\n }\n\n if (!flags.json) this.log(`\\nRestoring from snapshot...\\n`)\n\n const result = await restoreFromSnapshot({\n targetUrl,\n snapshotDir,\n noTransaction: flags['no-transaction'] as boolean,\n // --force means replace: the schemas the snapshot covers are dropped\n // before it is replayed. It used to only skip the not-empty check, so a\n // restore over an existing database failed on every object already there\n // and replaced nothing (issue #95).\n replace: flags.force as boolean,\n })\n\n this.renderResult(result, flags.json as boolean)\n }\n\n private async handleMigrationRestore(\n flags: Record<string, unknown>,\n targetUrl: string,\n ): Promise<void> {\n const toVersion = flags.to as string | undefined\n const fromVersion = flags.from as string | undefined\n\n if (!flags.apply) {\n const migrations = await previewMigrationRestore(process.cwd(), toVersion, fromVersion)\n if (flags.json) {\n this.json({\n dryRun: true,\n migrations: migrations.map(m => ({\n version: m.version,\n description: m.description,\n layers: m.layers,\n sqlStatements: m.up.sql.length,\n apiActions: m.up.api.length,\n })),\n })\n return\n }\n this.log('\\nRestore preview (dry-run) -- from migrations\\n')\n if (migrations.length === 0) {\n this.log(' No migrations found.')\n return\n }\n\n for (const m of migrations) {\n this.log(` ${m.version} ${m.description}`)\n this.log(` Layers: ${m.layers.join(', ')}`)\n this.log(` SQL: ${m.up.sql.length} statements`)\n this.log(` API: ${m.up.api.length} actions`)\n this.log('')\n }\n this.log(` → Add --apply to execute the restore.\\n`)\n return\n }\n\n if (!flags.json) this.log(`\\nRestoring from migrations...\\n`)\n\n // --no-transaction is deliberately not forwarded: the migration path\n // applies and records one migration at a time, so wrapping the set in a\n // single transaction would roll back migrations that had already been\n // recorded as applied. Per-migration transactions belong with the rest of\n // the migration work in #92 rather than here.\n const result = await restoreFromMigrations({\n targetUrl,\n toVersion,\n fromVersion,\n })\n\n this.renderResult(result, flags.json as boolean)\n }\n\n private renderResult(\n result: Awaited<ReturnType<typeof restoreFromSnapshot>>,\n json: boolean,\n ): void {\n if (json) {\n // Only the JSON on stdout, so it parses, and the same exit code as the\n // text report: a restore that failed or left things out is not one a\n // script should read as success.\n this.json(result)\n if (result.errors.length > 0 || result.incomplete) this.exit(1)\n return\n }\n\n if (result.applied.length > 0) {\n this.log(`✅ Applied ${result.applied.length} operation(s):`)\n for (const op of result.applied.slice(0, 20)) {\n this.log(` ✓ [${op.type}] ${op.label}`)\n }\n if (result.applied.length > 20) {\n this.log(` ... and ${result.applied.length - 20} more`)\n }\n }\n\n if (result.skipped.length > 0) {\n this.log(`\\n⏭ Skipped ${result.skipped.length} operation(s):`)\n for (const op of result.skipped) {\n this.log(` ○ [${op.type}] ${op.label}: ${op.reason}`)\n }\n }\n\n if (result.rolledBack && result.rolledBack.length > 0) {\n // Reported apart from `applied`, which is empty: a restore that rolled\n // back applied nothing, and saying otherwise would be the most\n // misleading thing this command could print (issue #95).\n this.log(`\\n↩ Rolled back ${result.rolledBack.length} operation(s) — the target is unchanged.`)\n }\n\n if (result.incomplete && result.errors.length === 0) {\n // Restored, but not all of it: what was left out is listed above, each\n // with what it needed. Not a success a script should take as one.\n this.log(`\\n⚠ Restored everything this target can hold. What it cannot is listed above as skipped.`)\n process.exitCode = 1\n }\n\n if (result.errors.length > 0) {\n this.log(`\\n❌ ${result.errors.length} error(s):`)\n for (const op of result.errors) {\n this.log(` ✖ [${op.type}] ${op.label}: ${op.error}`)\n }\n if (result.rolledBack && result.rolledBack.length > 0) {\n this.log(`\\n Nothing was written. Re-run with ${cmd('--no-transaction')} to keep the parts that work.`)\n }\n this.exit(1)\n }\n\n this.log(renderTip({ command: 'restore' }))\n }\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/commands/snapshot.ts"],"sourcesContent":["import { Flags } from '@oclif/core'\nimport { BaseCommand } from '../base-command.js'\nimport { captureSnapshot, listSnapshots, pruneSnapshots, formatSnapshotLayers, DEFAULT_KEEP_COUNT } from '../snapshot.js'\nimport { backup, listMigrationFiles } from '../migration.js'\nimport type { SnapshotManifest } from '../types/config.js'\nimport { ok, warn, dim, cmd, bold } from '../ui.js'\nimport { renderTip } from '../tips.js'\n\n/** Human-readable layer names captured by a snapshot, shown in the dry-run preview. */\nconst SNAPSHOT_LAYERS = [\n 'schema (tables, columns, indexes, constraints)',\n 'rls (row-level security policies)',\n 'edge-functions (via Management API)',\n 'storage (buckets + policies)',\n 'auth (config via Management API)',\n 'cron (pg_cron jobs)',\n 'data (reference tables from checks.data.tables)',\n 'webhooks (database webhook triggers)',\n 'extensions (installed Postgres extensions)',\n]\n\n/**\n * Capture and manage environment state snapshots.\n *\n * Default: dry-run preview of what would be captured (requires --apply)\n * --apply: actually capture the snapshot\n * --migration: also generate an incremental migration diff (was: backup)\n * --list: list existing snapshots\n * --prune: delete old snapshots\n */\nexport default class Snapshot extends BaseCommand {\n static override description = 'Capture a point-in-time snapshot of a Supabase environment'\n\n static override examples = [\n '<%= config.bin %> snapshot',\n '<%= config.bin %> snapshot --apply',\n '<%= config.bin %> snapshot --env=production --apply',\n '<%= config.bin %> snapshot --migration --apply',\n '<%= config.bin %> snapshot --migration --apply --description=\"added profiles table\"',\n '<%= config.bin %> snapshot --list',\n '<%= config.bin %> snapshot --prune',\n '<%= config.bin %> snapshot --prune --keep=5 --apply',\n '<%= config.bin %> snapshot --output=./backups --apply',\n ]\n\n static override flags = {\n env: Flags.string({\n char: 'e',\n description: 'Environment to snapshot (defaults to config source)',\n }),\n migration: Flags.boolean({\n description: 'Also generate an incremental migration diff against the previous snapshot',\n default: false,\n }),\n description: Flags.string({\n char: 'd',\n description: 'Human-readable description for the migration',\n default: 'auto-backup',\n }),\n list: Flags.boolean({\n description: 'List existing snapshots',\n default: false,\n }),\n prune: Flags.boolean({\n description: `Delete old snapshots, keeping the most recent (default: ${DEFAULT_KEEP_COUNT})`,\n default: false,\n }),\n keep: Flags.integer({\n description: 'Number of snapshots to keep when pruning',\n default: DEFAULT_KEEP_COUNT,\n min: 1,\n }),\n apply: Flags.boolean({\n description: 'Execute the snapshot (default: dry-run preview). Also required for --prune.',\n default: false,\n }),\n json: Flags.boolean({ description: 'Output results as JSON' }),\n output: Flags.string({\n char: 'o',\n description: 'Custom output directory for snapshot files (timestamp subfolder is created inside)',\n }),\n }\n\n async run(): Promise<void> {\n const { flags } = await this.parse(Snapshot)\n\n const config = await this.loadConfigOrFail()\n\n // ── List mode ────────────────────────────────────────────────────────────\n if (flags.list) {\n const snapshots = await listSnapshots()\n if (snapshots.length === 0) {\n this.log('No snapshots found.')\n return\n }\n if (flags.json) {\n this.json(snapshots.map(s => s.manifest))\n return\n }\n this.log(`\\n${bold(`${snapshots.length} snapshot(s):`)}\\n`)\n for (const { manifest } of snapshots) {\n const layerCount = Object.values(manifest.layers).filter(l => l.captured).length\n const itemCount = Object.values(manifest.layers).reduce((sum, l) => sum + l.itemCount, 0)\n this.log(` ${bold(manifest.timestamp)} ${dim('env=')}${manifest.environment} ${dim('layers=')}${layerCount} ${dim('items=')}${itemCount}`)\n }\n this.log('')\n this.log(renderTip({ command: 'snapshot', snapshotList: true }))\n return\n }\n\n // ── Prune mode ───────────────────────────────────────────────────────────\n if (flags.prune) {\n const keepCount = flags.keep\n const snapshots = await listSnapshots()\n const deleteCount = Math.max(0, snapshots.length - keepCount)\n\n if (deleteCount === 0) {\n this.log(`\\nNothing to prune — ${snapshots.length} snapshot(s), keeping ${keepCount}.\\n`)\n return\n }\n\n this.log(`\\nPrune: ${snapshots.length} snapshot(s) found, keeping ${keepCount}.`)\n this.log(` ${deleteCount} snapshot(s) would be deleted:\\n`)\n\n const toDelete = snapshots.slice(0, deleteCount)\n for (const { manifest } of toDelete) {\n this.log(` ${warn('✗')} ${manifest.timestamp} ${dim('env=')}${manifest.environment}`)\n }\n this.log('')\n\n if (!flags.apply) {\n this.log(` → Add ${cmd('--apply')} to delete these snapshots.\\n`)\n return\n }\n\n const result = await pruneSnapshots(keepCount)\n\n if (flags.json) {\n this.json(result)\n return\n }\n\n this.log(` Deleted ${result.deleted.length} snapshot(s), ${result.kept.length} remaining.`)\n if (result.retainedForMigrations && result.retainedForMigrations.length > 0) {\n // Kept past the budget on purpose: a migration names each of these as\n // its parent, and deleting one breaks that migration's chain (#92).\n this.log(` ${result.retainedForMigrations.length} kept beyond --keep: a migration names each as its parent.`)\n }\n this.log('')\n return\n }\n\n // ── Capture snapshot (with optional migration) ───────────────────────────\n const { envName, env } = this.resolveEnv(config, flags.env)\n\n // Preflight: verify database is reachable. Under --json too, where its\n // lines go to stderr and a failure is reported as JSON.\n const pre = this.createPreflight('Snapshot preflight checks')\n .addDatabase('Database', envName, env.dbUrl)\n await this.runPreflight(pre, 'Snapshot')\n\n // ── Dry-run gate ─────────────────────────────────────────────────────────\n // Like clone / diff / restore, snapshot is a preview unless --apply is given.\n if (!flags.apply) {\n if (flags.json) {\n this.json({ dryRun: true, environment: envName, migration: flags.migration })\n return\n }\n this.log(`\\n ${bold('Snapshot preview')} ${dim('(dry-run)')}\\n`)\n this.log(` Environment: ${envName}`)\n this.log(` Mode: ${flags.migration ? 'snapshot + incremental migration' : 'snapshot'}`)\n this.log('')\n this.log(' Layers that will be captured (when present):')\n for (const layer of SNAPSHOT_LAYERS) {\n this.log(` ${dim('•')} ${layer}`)\n }\n this.log('')\n this.log(` ${dim('Layers with no data (e.g. no cron, no storage) are skipped automatically.')}`)\n this.log(`\\n → Add ${cmd('--apply')} to capture the snapshot.\\n`)\n this.log(renderTip({ command: 'snapshot', snapshotMigration: flags.migration, snapshotList: false }))\n return\n }\n\n if (flags.migration) {\n // Capture + generate migration (was: backup command)\n this.log(`\\nCapturing snapshot of \"${envName}\" with migration...\\n`)\n\n const result = await backup({\n envName,\n env,\n config,\n description: flags.description,\n outputDir: flags.output,\n })\n\n if (flags.json) {\n this.json({\n isBaseline: result.isBaseline,\n snapshot: result.snapshot.manifest,\n migration: result.migration,\n migrationFile: result.migrationFile,\n })\n return\n }\n\n this.logSnapshotResult(result.snapshot.manifest)\n this.log(` ${dim('Snapshot:')} ${result.snapshot.dir}`)\n\n if (result.isBaseline) {\n this.log(` ${dim('Type:')} baseline (first snapshot)`)\n } else {\n this.log(` ${dim('Type:')} incremental diff`)\n }\n\n if (result.migration) {\n this.log(` ${dim('Migration:')} ${result.migrationFile}`)\n this.log(` ${dim('Layers:')} ${result.migration.layers.join(', ')}`)\n this.log(` ${dim('SQL up:')} ${result.migration.up.sql.length} statement(s)`)\n this.log(` ${dim('API up:')} ${result.migration.up.api.length} action(s)`)\n } else {\n this.log(` ${dim('Migration:')} none (no changes detected)`)\n }\n\n this.log(`\\n ${ok('Snapshot + migration complete.')}\\n`)\n this.log(renderTip({ command: 'snapshot', snapshotMigration: true }))\n return\n }\n\n // Plain snapshot — just capture, no dry-run gate\n this.log(`\\nCapturing snapshot of \"${envName}\"...\\n`)\n\n const snapshot = await captureSnapshot({ envName, env, config, outputDir: flags.output })\n\n if (flags.json) {\n this.json(snapshot.manifest)\n return\n }\n\n this.logSnapshotResult(snapshot.manifest)\n this.log(`\\n ${dim('Snapshot saved to:')} ${snapshot.dir}`)\n\n // Show migration hint\n const existing = await listMigrationFiles()\n if (existing.length > 0) {\n this.log(` → Run with ${cmd('--migration')} to also generate an incremental diff.`)\n } else {\n this.log(` → Run with ${cmd('--migration')} to save a baseline migration.`)\n }\n this.log('')\n this.log(renderTip({ command: 'snapshot', snapshotMigration: false, snapshotList: false }))\n }\n\n private logSnapshotResult(manifest: SnapshotManifest): void {\n for (const line of formatSnapshotLayers(manifest)) {\n this.log(` ${line}`)\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,aAAa;AAStB,IAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAWA,IAAqB,WAArB,MAAqB,kBAAiB,YAAY;AAAA,EAChD,OAAgB,cAAc;AAAA,EAE9B,OAAgB,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EAEA,OAAgB,QAAQ;AAAA,IACtB,KAAK,MAAM,OAAO;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,IACf,CAAC;AAAA,IACD,WAAW,MAAM,QAAQ;AAAA,MACvB,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,IACD,aAAa,MAAM,OAAO;AAAA,MACxB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,IACD,MAAM,MAAM,QAAQ;AAAA,MAClB,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,IACD,OAAO,MAAM,QAAQ;AAAA,MACnB,aAAa,2DAA2D,kBAAkB;AAAA,MAC1F,SAAS;AAAA,IACX,CAAC;AAAA,IACD,MAAM,MAAM,QAAQ;AAAA,MAClB,aAAa;AAAA,MACb,SAAS;AAAA,MACT,KAAK;AAAA,IACP,CAAC;AAAA,IACD,OAAO,MAAM,QAAQ;AAAA,MACnB,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,IACD,MAAM,MAAM,QAAQ,EAAE,aAAa,yBAAyB,CAAC;AAAA,IAC7D,QAAQ,MAAM,OAAO;AAAA,MACnB,MAAM;AAAA,MACN,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,MAAM,SAAQ;AAE3C,UAAM,SAAS,MAAM,KAAK,iBAAiB;AAG3C,QAAI,MAAM,MAAM;AACd,YAAM,YAAY,MAAM,cAAc;AACtC,UAAI,UAAU,WAAW,GAAG;AAC1B,aAAK,IAAI,qBAAqB;AAC9B;AAAA,MACF;AACA,UAAI,MAAM,MAAM;AACd,aAAK,KAAK,UAAU,IAAI,OAAK,EAAE,QAAQ,CAAC;AACxC;AAAA,MACF;AACA,WAAK,IAAI;AAAA,EAAK,KAAK,GAAG,UAAU,MAAM,eAAe,CAAC;AAAA,CAAI;AAC1D,iBAAW,EAAE,SAAS,KAAK,WAAW;AACpC,cAAM,aAAa,OAAO,OAAO,SAAS,MAAM,EAAE,OAAO,OAAK,EAAE,QAAQ,EAAE;AAC1E,cAAM,YAAY,OAAO,OAAO,SAAS,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,WAAW,CAAC;AACxF,aAAK,IAAI,KAAK,KAAK,SAAS,SAAS,CAAC,KAAK,IAAI,MAAM,CAAC,GAAG,SAAS,WAAW,KAAK,IAAI,SAAS,CAAC,GAAG,UAAU,KAAK,IAAI,QAAQ,CAAC,GAAG,SAAS,EAAE;AAAA,MAC/I;AACA,WAAK,IAAI,EAAE;AACX,WAAK,IAAI,UAAU,EAAE,SAAS,YAAY,cAAc,KAAK,CAAC,CAAC;AAC/D;AAAA,IACF;AAGA,QAAI,MAAM,OAAO;AACf,YAAM,YAAY,MAAM;AACxB,YAAM,YAAY,MAAM,cAAc;AACtC,YAAM,cAAc,KAAK,IAAI,GAAG,UAAU,SAAS,SAAS;AAE5D,UAAI,gBAAgB,GAAG;AACrB,aAAK,IAAI;AAAA,0BAAwB,UAAU,MAAM,yBAAyB,SAAS;AAAA,CAAK;AACxF;AAAA,MACF;AAEA,WAAK,IAAI;AAAA,SAAY,UAAU,MAAM,+BAA+B,SAAS,GAAG;AAChF,WAAK,IAAI,KAAK,WAAW;AAAA,CAAkC;AAE3D,YAAM,WAAW,UAAU,MAAM,GAAG,WAAW;AAC/C,iBAAW,EAAE,SAAS,KAAK,UAAU;AACnC,aAAK,IAAI,KAAK,KAAK,QAAG,CAAC,IAAI,SAAS,SAAS,KAAK,IAAI,MAAM,CAAC,GAAG,SAAS,WAAW,EAAE;AAAA,MACxF;AACA,WAAK,IAAI,EAAE;AAEX,UAAI,CAAC,MAAM,OAAO;AAChB,aAAK,IAAI,gBAAW,IAAI,SAAS,CAAC;AAAA,CAA+B;AACjE;AAAA,MACF;AAEA,YAAM,SAAS,MAAM,eAAe,SAAS;AAE7C,UAAI,MAAM,MAAM;AACd,aAAK,KAAK,MAAM;AAChB;AAAA,MACF;AAEA,WAAK,IAAI,aAAa,OAAO,QAAQ,MAAM,iBAAiB,OAAO,KAAK,MAAM,aAAa;AAC3F,UAAI,OAAO,yBAAyB,OAAO,sBAAsB,SAAS,GAAG;AAG3E,aAAK,IAAI,KAAK,OAAO,sBAAsB,MAAM,4DAA4D;AAAA,MAC/G;AACA,WAAK,IAAI,EAAE;AACX;AAAA,IACF;AAGA,UAAM,EAAE,SAAS,IAAI,IAAI,KAAK,WAAW,QAAQ,MAAM,GAAG;AAI1D,UAAM,MAAM,KAAK,gBAAgB,2BAA2B,EACzD,YAAY,YAAY,SAAS,IAAI,KAAK;AAC7C,UAAM,KAAK,aAAa,KAAK,UAAU;AAIvC,QAAI,CAAC,MAAM,OAAO;AAChB,UAAI,MAAM,MAAM;AACd,aAAK,KAAK,EAAE,QAAQ,MAAM,aAAa,SAAS,WAAW,MAAM,UAAU,CAAC;AAC5E;AAAA,MACF;AACA,WAAK,IAAI;AAAA,IAAO,KAAK,kBAAkB,CAAC,IAAI,IAAI,WAAW,CAAC;AAAA,CAAI;AAChE,WAAK,IAAI,oBAAoB,OAAO,EAAE;AACtC,WAAK,IAAI,oBAAoB,MAAM,YAAY,qCAAqC,UAAU,EAAE;AAChG,WAAK,IAAI,EAAE;AACX,WAAK,IAAI,kDAAkD;AAC3D,iBAAW,SAAS,iBAAiB;AACnC,aAAK,IAAI,SAAS,IAAI,QAAG,CAAC,IAAI,KAAK,EAAE;AAAA,MACvC;AACA,WAAK,IAAI,EAAE;AACX,WAAK,IAAI,OAAO,IAAI,2EAA2E,CAAC,EAAE;AAClG,WAAK,IAAI;AAAA,iBAAe,IAAI,SAAS,CAAC;AAAA,CAA6B;AACnE,WAAK,IAAI,UAAU,EAAE,SAAS,YAAY,mBAAmB,MAAM,WAAW,cAAc,MAAM,CAAC,CAAC;AACpG;AAAA,IACF;AAEA,QAAI,MAAM,WAAW;AAEnB,WAAK,IAAI;AAAA,yBAA4B,OAAO;AAAA,CAAuB;AAEnE,YAAM,SAAS,MAAM,OAAO;AAAA,QAC1B;AAAA,QACA;AAAA,QACA;AAAA,QACA,aAAa,MAAM;AAAA,QACnB,WAAW,MAAM;AAAA,MACnB,CAAC;AAED,UAAI,MAAM,MAAM;AACd,aAAK,KAAK;AAAA,UACR,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO,SAAS;AAAA,UAC1B,WAAW,OAAO;AAAA,UAClB,eAAe,OAAO;AAAA,QACxB,CAAC;AACD;AAAA,MACF;AAEA,WAAK,kBAAkB,OAAO,SAAS,QAAQ;AAC/C,WAAK,IAAI,KAAK,IAAI,WAAW,CAAC,KAAK,OAAO,SAAS,GAAG,EAAE;AAExD,UAAI,OAAO,YAAY;AACrB,aAAK,IAAI,KAAK,IAAI,OAAO,CAAC,iCAAiC;AAAA,MAC7D,OAAO;AACL,aAAK,IAAI,KAAK,IAAI,OAAO,CAAC,wBAAwB;AAAA,MACpD;AAEA,UAAI,OAAO,WAAW;AACpB,aAAK,IAAI,KAAK,IAAI,YAAY,CAAC,IAAI,OAAO,aAAa,EAAE;AACzD,aAAK,IAAI,KAAK,IAAI,SAAS,CAAC,OAAO,OAAO,UAAU,OAAO,KAAK,IAAI,CAAC,EAAE;AACvE,aAAK,IAAI,KAAK,IAAI,SAAS,CAAC,OAAO,OAAO,UAAU,GAAG,IAAI,MAAM,eAAe;AAChF,aAAK,IAAI,KAAK,IAAI,SAAS,CAAC,OAAO,OAAO,UAAU,GAAG,IAAI,MAAM,YAAY;AAAA,MAC/E,OAAO;AACL,aAAK,IAAI,KAAK,IAAI,YAAY,CAAC,6BAA6B;AAAA,MAC9D;AAEA,WAAK,IAAI;AAAA,IAAO,GAAG,gCAAgC,CAAC;AAAA,CAAI;AACxD,WAAK,IAAI,UAAU,EAAE,SAAS,YAAY,mBAAmB,KAAK,CAAC,CAAC;AACpE;AAAA,IACF;AAGA,SAAK,IAAI;AAAA,yBAA4B,OAAO;AAAA,CAAQ;AAEpD,UAAM,WAAW,MAAM,gBAAgB,EAAE,SAAS,KAAK,QAAQ,WAAW,MAAM,OAAO,CAAC;AAExF,QAAI,MAAM,MAAM;AACd,WAAK,KAAK,SAAS,QAAQ;AAC3B;AAAA,IACF;AAEA,SAAK,kBAAkB,SAAS,QAAQ;AACxC,SAAK,IAAI;AAAA,IAAO,IAAI,oBAAoB,CAAC,IAAI,SAAS,GAAG,EAAE;AAG3D,UAAM,WAAW,MAAM,mBAAmB;AAC1C,QAAI,SAAS,SAAS,GAAG;AACvB,WAAK,IAAI,qBAAgB,IAAI,aAAa,CAAC,wCAAwC;AAAA,IACrF,OAAO;AACL,WAAK,IAAI,qBAAgB,IAAI,aAAa,CAAC,gCAAgC;AAAA,IAC7E;AACA,SAAK,IAAI,EAAE;AACX,SAAK,IAAI,UAAU,EAAE,SAAS,YAAY,mBAAmB,OAAO,cAAc,MAAM,CAAC,CAAC;AAAA,EAC5F;AAAA,EAEQ,kBAAkB,UAAkC;AAC1D,eAAW,QAAQ,qBAAqB,QAAQ,GAAG;AACjD,WAAK,IAAI,KAAK,IAAI,EAAE;AAAA,IACtB;AAAA,EACF;AACF;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/commands/sync.ts"],"sourcesContent":["import Diff from './diff.js'\n\n/**\n * Alias for `diff --apply` — detect and fix drift in one step.\n */\nexport default class Sync extends Diff {\n static override description = 'Detect and fix drift (alias for diff --apply)'\n\n static override examples = [\n '<%= config.bin %> sync',\n '<%= config.bin %> sync --check=rls',\n '<%= config.bin %> sync --source=staging --target=production',\n ]\n\n async run(): Promise<void> {\n // Inject --apply before delegating to Diff\n const argv = [...this.argv]\n if (!argv.includes('--apply')) {\n argv.push('--apply')\n }\n\n // Re-parse with injected --apply flag\n await Diff.run(argv, this.config)\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAKA,IAAqB,OAArB,cAAkC,KAAK;AAAA,EACrC,OAAgB,cAAc;AAAA,EAE9B,OAAgB,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EAEA,MAAM,MAAqB;AAEzB,UAAM,OAAO,CAAC,GAAG,KAAK,IAAI;AAC1B,QAAI,CAAC,KAAK,SAAS,SAAS,GAAG;AAC7B,WAAK,KAAK,SAAS;AAAA,IACrB;AAGA,UAAM,KAAK,IAAI,MAAM,KAAK,MAAM;AAAA,EAClC;AACF;","names":[]}
|
package/dist/help.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/help.ts"],"sourcesContent":["import { Help, type Command, type Interfaces } from '@oclif/core'\n\n/**\n * Environment variables a command reads, rendered as their own help section.\n *\n * These were documented only in the README, and `--help` is where users look\n * first — especially for `diff`, whose behaviour they change (issue #40).\n * Declared as a static on the command so the list sits next to the flags it\n * complements rather than in a table someone has to remember to update.\n */\nexport interface CommandWithEnvVars {\n envVars?: ReadonlyArray<{ name: string; description: string }>\n}\n\nfunction envVarsOf(command: Command.Loadable): CommandWithEnvVars['envVars'] {\n const declared = (command as unknown as CommandWithEnvVars).envVars\n return Array.isArray(declared) && declared.length > 0 ? declared : undefined\n}\n\n/**\n * Desired command order — matches the natural workflow:\n * setup → detect → snapshot → clone → restore → migrate, then the tools.\n *\n * Everything is named rather than only the first few: an unlisted command falls\n * to the alphabetical tail, which is how `migrate` — a topic of four\n * commands — ended up printed after `report` and `mcp`, and `help` in the\n * middle of the workflow (issue #97).\n */\nconst ORDER = [\n 'init',\n 'diff',\n 'sync',\n 'snapshot',\n 'clone',\n 'restore',\n 'migrate',\n 'report',\n 'mcp',\n 'hukam',\n 'help',\n]\n\nexport default class CustomHelp extends Help {\n /** Append an ENVIRONMENT VARIABLES section to commands that declare one. */\n protected override formatCommand(command: Command.Loadable): string {\n const base = super.formatCommand(command)\n const envVars = envVarsOf(command)\n if (!envVars) return base\n\n const width = Math.max(...envVars.map(v => v.name.length))\n const rows = envVars.map(v => ` ${v.name.padEnd(width)} ${v.description}`)\n return [base, '', 'ENVIRONMENT VARIABLES', ...rows].join('\\n')\n }\n\n protected override get sortedCommands(): Command.Loadable[] {\n const sorted = super.sortedCommands\n const ordered = ORDER\n .map((id) => sorted.find((c) => c.id === id))\n .filter((c): c is Command.Loadable => c !== undefined)\n const rest = sorted.filter((c) => !ORDER.includes(c.id))\n return [...ordered, ...rest]\n }\n\n /**\n * Render only COMMANDS (no separate TOPICS section).\n * Render only COMMANDS (no separate TOPICS section).\n */\n protected override async showRootHelp(): Promise<void> {\n const state = this.config.pjson?.oclif?.state as string | undefined\n if (state) {\n this.log(state === 'deprecated' ? `${this.config.bin} is deprecated` : `${this.config.bin} is in ${state}.\\n`)\n }\n\n this.log(this.formatRoot())\n this.log('')\n\n // Merge topics into the commands list so everything appears in one section.\n const rootCommands = this.sortedCommands.filter((c) => c.id && !c.id.includes(':'))\n const rootTopics = this.sortedTopics.filter((t) => !t.name.includes(':'))\n\n // Build topic entries that look like commands (id + description).\n const topicAsCommand = rootTopics\n .filter((t) => !rootCommands.some((c) => c.id === t.name))\n .map((t) => ({ id: t.name, summary: t.description ?? '' }) as unknown as Command.Loadable)\n\n // Merge and re-sort by ORDER\n const all = [...rootCommands, ...topicAsCommand]\n const ordered = ORDER\n .map((id) => all.find((c) => c.id === id))\n .filter((c): c is Command.Loadable => c !== undefined)\n const rest = all.filter((c) => !ORDER.includes(c.id))\n const merged = [...ordered, ...rest]\n\n if (merged.length > 0) {\n this.log(this.formatCommands(merged))\n this.log('')\n }\n }\n}\n"],"mappings":";AAAA,SAAS,YAA2C;AAcpD,SAAS,UAAU,SAA0D;AAC3E,QAAM,WAAY,QAA0C;AAC5D,SAAO,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS,IAAI,WAAW;AACrE;AAWA,IAAM,QAAQ;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAqB,aAArB,cAAwC,KAAK;AAAA;AAAA,EAExB,cAAc,SAAmC;AAClE,UAAM,OAAO,MAAM,cAAc,OAAO;AACxC,UAAM,UAAU,UAAU,OAAO;AACjC,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,QAAQ,KAAK,IAAI,GAAG,QAAQ,IAAI,OAAK,EAAE,KAAK,MAAM,CAAC;AACzD,UAAM,OAAO,QAAQ,IAAI,OAAK,KAAK,EAAE,KAAK,OAAO,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE;AAC3E,WAAO,CAAC,MAAM,IAAI,yBAAyB,GAAG,IAAI,EAAE,KAAK,IAAI;AAAA,EAC/D;AAAA,EAEA,IAAuB,iBAAqC;AAC1D,UAAM,SAAS,MAAM;AACrB,UAAM,UAAU,MACb,IAAI,CAAC,OAAO,OAAO,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAC3C,OAAO,CAAC,MAA6B,MAAM,MAAS;AACvD,UAAM,OAAO,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE,EAAE,CAAC;AACvD,WAAO,CAAC,GAAG,SAAS,GAAG,IAAI;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAyB,eAA8B;AACrD,UAAM,QAAQ,KAAK,OAAO,OAAO,OAAO;AACxC,QAAI,OAAO;AACT,WAAK,IAAI,UAAU,eAAe,GAAG,KAAK,OAAO,GAAG,mBAAmB,GAAG,KAAK,OAAO,GAAG,UAAU,KAAK;AAAA,CAAK;AAAA,IAC/G;AAEA,SAAK,IAAI,KAAK,WAAW,CAAC;AAC1B,SAAK,IAAI,EAAE;AAGX,UAAM,eAAe,KAAK,eAAe,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC;AAClF,UAAM,aAAa,KAAK,aAAa,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,SAAS,GAAG,CAAC;AAGxE,UAAM,iBAAiB,WACpB,OAAO,CAAC,MAAM,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EACxD,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,EAAE,eAAe,GAAG,EAAiC;AAG3F,UAAM,MAAM,CAAC,GAAG,cAAc,GAAG,cAAc;AAC/C,UAAM,UAAU,MACb,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EACxC,OAAO,CAAC,MAA6B,MAAM,MAAS;AACvD,UAAM,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE,EAAE,CAAC;AACpD,UAAM,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI;AAEnC,QAAI,OAAO,SAAS,GAAG;AACrB,WAAK,IAAI,KAAK,eAAe,MAAM,CAAC;AACpC,WAAK,IAAI,EAAE;AAAA,IACb;AAAA,EACF;AACF;","names":[]}
|
package/dist/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/hooks.ts"],"sourcesContent":["/**\n * Lightweight hook bus for SupaForge extensibility.\n * Provides actions (fire-and-forget) and filters (transform pipeline) with priority ordering.\n */\n\ntype Listener = (...args: any[]) => unknown | Promise<unknown>\ntype FilterFn<T = any> = (value: T, ...args: any[]) => T | Promise<T>\n\ninterface Entry { fn: Listener; priority: number }\n\nexport class HookBus {\n private actions = new Map<string, Entry[]>()\n private filters = new Map<string, Entry[]>()\n\n on(hook: string, fn: Listener, priority = 10): () => void {\n const bucket = this.actions.get(hook) ?? []\n const entry = { fn, priority }\n bucket.push(entry)\n bucket.sort((a, b) => a.priority - b.priority)\n this.actions.set(hook, bucket)\n return () => {\n const b = this.actions.get(hook)\n if (b) this.actions.set(hook, b.filter(e => e !== entry))\n }\n }\n\n async emit(hook: string, ...args: unknown[]): Promise<void> {\n for (const entry of this.actions.get(hook) ?? []) {\n await entry.fn(...args)\n }\n }\n\n addFilter<T>(hook: string, fn: FilterFn<T>, priority = 10): () => void {\n const bucket = this.filters.get(hook) ?? []\n const entry: Entry = { fn: fn as Listener, priority }\n bucket.push(entry)\n bucket.sort((a, b) => a.priority - b.priority)\n this.filters.set(hook, bucket)\n return () => {\n const b = this.filters.get(hook)\n if (b) this.filters.set(hook, b.filter(e => e !== entry))\n }\n }\n\n async applyFilter<T>(hook: string, value: T, ...args: unknown[]): Promise<T> {\n let result = value\n for (const entry of this.filters.get(hook) ?? []) {\n result = await (entry.fn as FilterFn<T>)(result, ...args)\n }\n return result\n }\n\n clear(): void {\n this.actions.clear()\n this.filters.clear()\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUO,IAAM,UAAN,MAAc;AAAA,EACX,UAAU,oBAAI,IAAqB;AAAA,EACnC,UAAU,oBAAI,IAAqB;AAAA,EAE3C,GAAG,MAAc,IAAc,WAAW,IAAgB;AACxD,UAAM,SAAS,KAAK,QAAQ,IAAI,IAAI,KAAK,CAAC;AAC1C,UAAM,QAAQ,EAAE,IAAI,SAAS;AAC7B,WAAO,KAAK,KAAK;AACjB,WAAO,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAC7C,SAAK,QAAQ,IAAI,MAAM,MAAM;AAC7B,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,QAAQ,IAAI,IAAI;AAC/B,UAAI,EAAG,MAAK,QAAQ,IAAI,MAAM,EAAE,OAAO,OAAK,MAAM,KAAK,CAAC;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,SAAiB,MAAgC;AAC1D,eAAW,SAAS,KAAK,QAAQ,IAAI,IAAI,KAAK,CAAC,GAAG;AAChD,YAAM,MAAM,GAAG,GAAG,IAAI;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,UAAa,MAAc,IAAiB,WAAW,IAAgB;AACrE,UAAM,SAAS,KAAK,QAAQ,IAAI,IAAI,KAAK,CAAC;AAC1C,UAAM,QAAe,EAAE,IAAoB,SAAS;AACpD,WAAO,KAAK,KAAK;AACjB,WAAO,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAC7C,SAAK,QAAQ,IAAI,MAAM,MAAM;AAC7B,WAAO,MAAM;AACX,YAAM,IAAI,KAAK,QAAQ,IAAI,IAAI;AAC/B,UAAI,EAAG,MAAK,QAAQ,IAAI,MAAM,EAAE,OAAO,OAAK,MAAM,KAAK,CAAC;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,YAAe,MAAc,UAAa,MAA6B;AAC3E,QAAI,SAAS;AACb,eAAW,SAAS,KAAK,QAAQ,IAAI,IAAI,KAAK,CAAC,GAAG;AAChD,eAAS,MAAO,MAAM,GAAmB,QAAQ,GAAG,IAAI;AAAA,IAC1D;AACA,WAAO;AAAA,EACT;AAAA,EAEA,QAAc;AACZ,SAAK,QAAQ,MAAM;AACnB,SAAK,QAAQ,MAAM;AAAA,EACrB;AACF;","names":[]}
|