spine-framework 0.1.14 → 0.1.15

package/.framework/cli/commands/migrate.ts

@@ -0,0 +1,134 @@
+/// <reference types="node" />
+/**
+ * @module cli/commands/migrate
+ * @audience installer
+ * @layer cli
+ * @stability stable
+ *
+ * `spine-framework migrate` — Apply SQL migrations to a Supabase project
+ * via a direct Postgres connection.
+ *
+ * Requires --db-password (the Supabase database password).
+ * Get it from: https://supabase.com/dashboard/project/_/settings/database
+ *
+ * **Usage:**
+ * ```bash
+ * spine-framework migrate --db-password <password>
+ * spine-framework migrate --db-password <password> --dry-run
+ * ```
+ */
+
+import type { Command } from 'commander'
+import { existsSync, readdirSync, readFileSync } from 'fs'
+import { resolve, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const MIGRATIONS_DIR = resolve(__dirname, '../../migrations')
+
+interface MigrateOptions {
+  dbPassword: string
+  dryRun: boolean
+}
+
+async function migrateCommand(options: MigrateOptions): Promise<void> {
+  console.log('\n🗄️  Spine Framework — Migrate\n')
+
+  const supabaseUrl = process.env.SUPABASE_URL
+  if (!supabaseUrl) {
+    console.error('❌ SUPABASE_URL not set. Run `spine-framework init` first.')
+    process.exit(1)
+  }
+
+  // Derive connection string from Supabase URL
+  // Format: https://<ref>.supabase.co → postgres://postgres.<ref>:<password>@aws-0-<region>.pooler.supabase.com:5432/postgres
+  // Use direct connection (port 5432) via the db.<ref>.supabase.co host
+  const projectRef = supabaseUrl.replace('https://', '').split('.')[0]
+  const connectionString = `postgresql://postgres:${options.dbPassword}@db.${projectRef}.supabase.co:5432/postgres`
+
+  if (!existsSync(MIGRATIONS_DIR)) {
+    console.error(`❌ Migrations directory not found: ${MIGRATIONS_DIR}`)
+    process.exit(1)
+  }
+
+  const files = readdirSync(MIGRATIONS_DIR)
+    .filter(f => f.endsWith('.sql'))
+    .sort()
+
+  if (files.length === 0) {
+    console.log('  No migration files found.')
+    return
+  }
+
+  console.log(`  Found ${files.length} migration file(s)\n`)
+
+  if (options.dryRun) {
+    for (const file of files) {
+      console.log(`  [dry-run] Would apply: ${file}`)
+    }
+    return
+  }
+
+  // Dynamically import pg to avoid loading it at module init time
+  const { default: pg } = await import('pg')
+  const client = new pg.Client({ connectionString })
+
+  try {
+    await client.connect()
+    console.log('  ✓ Connected to database\n')
+  } catch (err: any) {
+    console.error(`❌ Could not connect to database: ${err.message}`)
+    console.error('   Check your --db-password and that the project is active.')
+    process.exit(1)
+  }
+
+  let applied = 0
+  let failed = 0
+
+  for (const file of files) {
+    const sql = readFileSync(resolve(MIGRATIONS_DIR, file), 'utf8')
+    process.stdout.write(`  Applying ${file}... `)
+    try {
+      await client.query(sql)
+      console.log('✓')
+      applied++
+    } catch (err: any) {
+      console.log('❌')
+      console.error(`     ${err.message}`)
+      failed++
+      // Continue applying remaining migrations
+    }
+  }
+
+  await client.end()
+
+  console.log(`\n  ${applied} applied, ${failed} failed`)
+
+  if (failed > 0) {
+    console.error('\n❌ Some migrations failed. Check errors above.')
+    process.exit(1)
+  }
+
+  console.log('\n✅ All migrations applied successfully!')
+  console.log('\n   Next steps:')
+  console.log('   1. spine-framework install-app <app-slug>')
+  console.log('   2. npm run assemble && netlify dev')
+}
+
+export function registerMigrateCommands(program: Command) {
+  program
+    .command('migrate')
+    .description('Apply SQL migrations via direct Postgres connection')
+    .requiredOption('--db-password <password>', 'Supabase database password (from dashboard → Settings → Database)')
+    .option('--dry-run', 'Show what would happen without making changes', false)
+    .action(async (opts) => {
+      try {
+        await migrateCommand(opts)
+      } catch (err: any) {
+        console.error('Error:', err.message)
+        if (process.env.SPINE_CLI_DEBUG) console.error(err.stack)
+        process.exit(1)
+      }
+    })
+}

package/.framework/cli/index.ts

@@ -66,6 +66,7 @@ const [
   { registerInstallAppCommands },
   { registerStatusCommands },
   { registerUninstallAppCommands },
+  { registerMigrateCommands },
 ] = await Promise.all([
   import('./commands/auth.ts'),
   import('./commands/pipelines.ts'),
@@ -82,6 +83,7 @@ const [
   import('./commands/install-app.ts'),
   import('./commands/status.ts'),
   import('./commands/uninstall-app.ts'),
+  import('./commands/migrate.ts'),
 ])
 
 registerAuthCommands(program)
@@ -99,6 +101,7 @@ registerInitCommands(program)
 registerInstallAppCommands(program)
 registerStatusCommands(program)
 registerUninstallAppCommands(program)
+registerMigrateCommands(program)
 
 program.parseAsync(process.argv).catch((err) => {
   console.error('Error:', err.message)

package/dist/cli/commands/migrate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module cli/commands/migrate
+ * @audience installer
+ * @layer cli
+ * @stability stable
+ *
+ * `spine-framework migrate` — Apply SQL migrations to a Supabase project
+ * via a direct Postgres connection.
+ *
+ * Requires --db-password (the Supabase database password).
+ * Get it from: https://supabase.com/dashboard/project/_/settings/database
+ *
+ * **Usage:**
+ * ```bash
+ * spine-framework migrate --db-password <password>
+ * spine-framework migrate --db-password <password> --dry-run
+ * ```
+ */
+import type { Command } from 'commander';
+export declare function registerMigrateCommands(program: Command): void;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/cli/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/migrate.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkGxC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAevD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "private": false,
   "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
   "type": "module",
@@ -90,7 +90,8 @@
     "jsonwebtoken": "^9.0.3",
     "jwt-decode": "^4.0.0",
     "tsx": "^4.21.0",
-    "ws": "^8.21.0"
+    "ws": "^8.21.0",
+    "pg": "^8.13.0"
   },
   "peerDependencies": {
     "@netlify/functions": "^2.0.0",