@supacloud/cli 0.3.1 → 0.3.3

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")
@@ -5642,6 +5645,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 +5677,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 +5700,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 +5755,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 +5770,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 +5786,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 +5849,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.3",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
+    "supacloud-cli": "dist/index.js",
     "supacloud": "dist/index.js"
   },
   "files": [