@supacloud/cli 0.3.1 → 0.3.4

package/README.md

@@ -2,7 +2,24 @@
 
 Project-scoped CLI for SupaCloud users.
 
-`supacloud` defaults to the current workspace's project context. If you do not pass explicit flags, it tries to auto-link from `.env`:
+Use the explicit `supacloud-cli` command for project workflows. The old `supacloud`
+binary name is kept as a compatibility alias only; it is easy to confuse with the
+server binary installed at `/usr/local/bin/supacloud`.
+
+Install:
+
+```bash
+npm install -g @supacloud/cli
+supacloud-cli status
+```
+
+One-off execution:
+
+```bash
+npm exec --package @supacloud/cli -- supacloud-cli status
+```
+
+`supacloud-cli` defaults to the current workspace's project context. If you do not pass explicit flags, it tries to auto-link from `.env`:
 
 - `SUPABASE_URL` or `SUPACLOUD_API_URL`
 - `SUPABASE_SERVICE_ROLE_KEY` or `SUPACLOUD_API_TOKEN`
@@ -10,13 +27,13 @@ Project-scoped CLI for SupaCloud users.
 Examples:
 
 ```bash
-npx @supacloud/cli status
-npx @supacloud/cli project get
-npx @supacloud/cli project logs --log_type database
-npx @supacloud/cli database query --sql "select now()"
-npx @supacloud/cli database query --ref abc123 --file ./queries/vector-search.sql
-npx @supacloud/cli database push_migrations --ref abc123 --dir supabase/migrations --dry_run
-npx @supacloud/cli frontend list --ref abc123
+supacloud-cli status
+supacloud-cli project get
+supacloud-cli project logs --log_type database
+supacloud-cli database query --sql "select now()"
+supacloud-cli database query --ref abc123 --file ./queries/vector-search.sql
+supacloud-cli database push_migrations --ref abc123 --dir supabase/migrations --dry_run
+supacloud-cli frontend list --ref abc123
 ```
 
 Use `database query --file` for complex SQL, pgvector queries, and single-request transaction blocks.

package/dist/index.js

@@ -14,6 +14,9 @@ var __export = (target, all) => {
     });
 };
 
+// src/index.ts
+import path from "node:path";
+
 // node_modules/zod/v3/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -4354,7 +4357,7 @@ function migrationVersionFromFilename(file, fallbackIndex = 0) {
   return Date.now() * 1000 + fallbackIndex;
 }
 function appliedMigrationKeys(data) {
-  const rows = data?.rows || [];
+  const rows = Array.isArray(data) ? data : data?.rows || [];
   const keys = new Set;
   for (const row of rows) {
     if (!row || typeof row !== "object")
@@ -4415,7 +4418,7 @@ function registerDatabaseTools(server, http, config = {}) {
     "project_url",
     "generate_types"
   ];
-  const writeActions = ["apply_migration", "push_migrations", "create_table_rls"];
+  const writeActions = ["apply_migration", "push_migrations", "baseline_migrations", "create_table_rls"];
   const allActions = readOnly ? actions : [...actions, ...writeActions];
   server.tool("database", `Database operations: query, schema, RLS, migrations, stats.
 Actions: ${allActions.join(", ")}${readOnly ? " (read-only mode)" : ""}`, {
@@ -4423,8 +4426,8 @@ Actions: ${allActions.join(", ")}${readOnly ? " (read-only mode)" : ""}`, {
     ref: projectRef ? exports_external.string().optional() : exports_external.string().optional().describe("Project ref"),
     sql: exports_external.string().optional().describe("[query/apply_migration] SQL statement"),
     file: exports_external.string().optional().describe("[query/apply_migration] Read SQL from local file path (avoids shell escaping issues with $$ and multi-statement DDL)"),
-    dir: exports_external.string().optional().describe("[push_migrations] Directory containing .sql migration files (default: supabase/migrations)"),
-    dry_run: exports_external.boolean().optional().describe("[push_migrations] List pending migration files without applying them"),
+    dir: exports_external.string().optional().describe("[push_migrations/baseline_migrations] Directory containing .sql migration files (default: supabase/migrations)"),
+    dry_run: exports_external.boolean().optional().describe("[push_migrations/baseline_migrations] Preview changes without applying them"),
     schema: exports_external.string().optional().describe("[*] Schema name (default: public)"),
     table: exports_external.string().optional().describe("[describe_columns/indexes/constraints/rls_*] Table name"),
     schemas: exports_external.array(exports_external.string()).optional().describe("[list_tables/generate_types] Schemas array"),
@@ -4444,7 +4447,7 @@ Actions: ${allActions.join(", ")}${readOnly ? " (read-only mode)" : ""}`, {
         return { content: [{ type: "text", text: `❌ Failed to read file ${args.file}: ${e.message}` }] };
       }
     }
-    const execSql = async (sql) => http.post(`/v1/projects/${ref}/database/sql`, { sql });
+    const execSql = async (sql, mode) => http.post(`/v1/projects/${ref}/database/sql`, mode ? { sql, mode } : { sql });
     let text;
     switch (action) {
       case "query": {
@@ -4646,6 +4649,64 @@ Actions: ${allActions.join(", ")}${readOnly ? " (read-only mode)" : ""}`, {
 `);
         break;
       }
+      case "baseline_migrations": {
+        const dir = args.dir || "supabase/migrations";
+        if (!existsSync2(dir) || !statSync(dir).isDirectory()) {
+          throw new Error(`Migration directory not found: ${dir}`);
+        }
+        const files = readdirSync(dir).filter((file) => file.endsWith(".sql")).sort();
+        if (!files.length) {
+          text = `No .sql migration files found in ${dir}`;
+          break;
+        }
+        const migrationFiles = files.map((file, i) => ({
+          file,
+          name: basename(file, ".sql"),
+          version: migrationVersionFromFilename(file, i)
+        }));
+        const r = await http.get(`/v1/projects/${ref}/database/migrations`);
+        if (!r.ok) {
+          text = `❌ Failed to load applied migrations (${r.status}): ${JSON.stringify(r.data)}`;
+          break;
+        }
+        const appliedKeys = appliedMigrationKeys(r.data);
+        const missing = migrationFiles.filter(({ name, version }) => !appliedKeys.has(name) && !appliedKeys.has(String(version)));
+        const alreadyApplied = migrationFiles.filter(({ name, version }) => appliedKeys.has(name) || appliedKeys.has(String(version)));
+        if (args.dry_run) {
+          text = [
+            `Migration baseline dry run for ${dir}`,
+            `Total: ${migrationFiles.length}`,
+            "",
+            "Would mark as applied:",
+            ...missing.length ? missing.map(({ file, version }) => `  - ${file} (${version})`) : ["  - none"],
+            "",
+            "Already applied:",
+            ...alreadyApplied.length ? alreadyApplied.map(({ file, version }) => `  - ${file} (${version})`) : ["  - none"]
+          ].join(`
+`);
+          break;
+        }
+        if (!missing.length) {
+          text = [
+            `✅ Migration baseline already aligned for ${dir}`,
+            `Already applied: ${alreadyApplied.length}`
+          ].join(`
+`);
+          break;
+        }
+        const baselineSql = buildMigrationBaselineSql(missing);
+        const baselineResult = await execSql(baselineSql, "migration");
+        text = baselineResult.ok ? [
+          `✅ Migration baseline completed for ${dir}`,
+          `Marked applied: ${missing.length}`,
+          `Already applied: ${alreadyApplied.length}`,
+          "",
+          "Marked files:",
+          ...missing.map(({ file, version }) => `  - ${file} (${version})`)
+        ].join(`
+`) : `❌ Failed (${baselineResult.status}): ${JSON.stringify(baselineResult.data)}`;
+        break;
+      }
       case "create_table_rls": {
         if (!args.table || !args.columns)
           throw new Error("'table' and 'columns' required");
@@ -4660,6 +4721,48 @@ Actions: ${allActions.join(", ")}${readOnly ? " (read-only mode)" : ""}`, {
     return { content: [{ type: "text", text }] };
   });
 }
+function sqlString(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+function buildMigrationBaselineSql(migrations) {
+  const values = migrations.map(({ name, version }) => `(${version}, ${sqlString(name)}, ARRAY[${sqlString(`baseline:${name}`)}]::text[])`).join(`,
+    `);
+  return `
+CREATE SCHEMA IF NOT EXISTS supabase_migrations;
+
+CREATE TABLE IF NOT EXISTS supabase_migrations.schema_migrations (
+  version BIGINT PRIMARY KEY,
+  statements TEXT[],
+  name TEXT
+);
+
+CREATE TABLE IF NOT EXISTS public.schema_migrations (
+  version VARCHAR(255) PRIMARY KEY,
+  statements TEXT[],
+  name TEXT
+);
+
+WITH baseline(version, name, statements) AS (
+  VALUES
+    ${values}
+)
+INSERT INTO supabase_migrations.schema_migrations (version, statements, name)
+SELECT version, statements, name FROM baseline
+ON CONFLICT (version) DO UPDATE
+SET statements = EXCLUDED.statements,
+    name = EXCLUDED.name;
+
+WITH baseline(version, name, statements) AS (
+  VALUES
+    ${values}
+)
+INSERT INTO public.schema_migrations (version, statements, name)
+SELECT version::text, statements, name FROM baseline
+ON CONFLICT (version) DO UPDATE
+SET statements = EXCLUDED.statements,
+    name = EXCLUDED.name;
+`.trim();
+}
 function formatSqlResult(data) {
   if (!data || typeof data !== "object")
     return JSON.stringify(data, null, 2);
@@ -5642,6 +5745,9 @@ function registerUserProjectCliTools(server, http, options = {}) {
 }
 
 // src/index.ts
+var invokedCommand = path.basename(process.argv[1] || "supacloud-cli");
+var commandName = invokedCommand === "supacloud" ? "supacloud" : "supacloud-cli";
+var preferredCommand = "supacloud-cli";
 var projectActionSchema = exports_external.enum(["get", "health", "logs", "api_keys", "settings", "tasks"]);
 var genericActionSchema = exports_external.string();
 function unwrapMcpSchema(schema) {
@@ -5671,15 +5777,17 @@ function printHelp(context = resolveSupaCloudContext()) {
   const autoLink = context.inferredSupabaseUrl ? `Project context: ${context.inferredSupabaseUrl} (${context.source})` : "Project context: not detected";
   console.error(`
 ╔═══════════════════════════════════════════════════════════╗
-║  supacloud                                               ║
+║  supacloud-cli                                           ║
 ║  Project CLI for SupaCloud users                         ║
 ╚═══════════════════════════════════════════════════════════╝
 
+${commandName === "supacloud" ? "NOTE\n\n  `supacloud` is kept as a compatibility alias. Prefer `supacloud-cli`\n  to avoid confusion with the server binary at /usr/local/bin/supacloud.\n" : ""}
+
 USAGE
 
-  supacloud <module> <action> [--flags]
-  supacloud status
-  supacloud --help
+  ${preferredCommand} <module> <action> [--flags]
+  ${preferredCommand} status
+  ${preferredCommand} --help
 
 DEFAULT CONTEXT
 
@@ -5692,15 +5800,15 @@ DEFAULT CONTEXT
 
 EXAMPLES
 
-  supacloud status
-  supacloud project get
-  supacloud project logs --log_type database
-  supacloud frontend list --ref abc123
-  supacloud database query --sql "select now()"
-  supacloud database query --ref abc123 --file ./queries/vector-search.sql
-  supacloud database push_migrations --ref abc123 --dir supabase/migrations --dry_run
-  supacloud edge_functions deploy --ref abc123 --slug hello --path ./supabase/functions/hello
-  supacloud edge_functions config --ref abc123 --slug hello --verify_jwt false --background_routes "/queue/*,/render/*"
+  ${preferredCommand} status
+  ${preferredCommand} project get
+  ${preferredCommand} project logs --log_type database
+  ${preferredCommand} frontend list --ref abc123
+  ${preferredCommand} database query --sql "select now()"
+  ${preferredCommand} database query --ref abc123 --file ./queries/vector-search.sql
+  ${preferredCommand} database push_migrations --ref abc123 --dir supabase/migrations --dry_run
+  ${preferredCommand} edge_functions deploy --ref abc123 --slug hello --path ./supabase/functions/hello
+  ${preferredCommand} edge_functions config --ref abc123 --slug hello --verify_jwt false --background_routes "/queue/*,/render/*"
 
 SEPARATE ADMIN CLI
 
@@ -5747,8 +5855,8 @@ function createCliTools() {
               "  - SUPACLOUD_API_URL + SUPACLOUD_API_TOKEN",
               "",
               "Then retry commands such as:",
-              "  supacloud project get",
-              "  supacloud project logs --log_type database"
+              `  ${preferredCommand} project get`,
+              `  ${preferredCommand} project logs --log_type database`
             ].join(`
 `)
           }
@@ -5762,7 +5870,7 @@ function createCliTools() {
           content: [
             {
               type: "text",
-              text: "⚠️ This command requires project-scoped API context. Run `supacloud status` to inspect current detection."
+              text: `⚠️ This command requires project-scoped API context. Run \`${preferredCommand} status\` to inspect current detection.`
             }
           ]
         })
@@ -5778,9 +5886,9 @@ function createCliTools() {
           {
             type: "text",
             text: [
-              "⚠️ No project context found for supacloud.",
+              `⚠️ No project context found for ${preferredCommand}.`,
               "",
-              "supacloud expects project-scoped credentials by default.",
+              `${preferredCommand} expects project-scoped credentials by default.`,
               "Provide one of these sources:",
               "",
               "  1. Current workspace .env",
@@ -5841,9 +5949,9 @@ async function main() {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  await runCli(cliTools, args, { commandName: "supacloud" });
+  await runCli(cliTools, args, { commandName });
 }
 main().catch((error) => {
-  console.error("supacloud failed:", error);
+  console.error(`${commandName} failed:`, error);
   process.exit(1);
 });

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@supacloud/cli",
-  "version": "0.3.1",
+  "version": "0.3.4",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
+    "supacloud-cli": "dist/index.js",
     "supacloud": "dist/index.js"
   },
   "files": [