@supacloud/cli 0.2.0 → 0.3.0

package/README.md

@@ -14,9 +14,29 @@ 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
 ```
 
+Use `database query --file` for complex SQL, pgvector queries, and single-request transaction blocks.
+
+```sql
+CREATE EXTENSION IF NOT EXISTS vector;
+
+CREATE TABLE documents (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  content text NOT NULL,
+  embedding vector(1536)
+);
+
+CREATE INDEX documents_embedding_hnsw_idx
+ON documents
+USING hnsw (embedding vector_cosine_ops);
+```
+
+Transaction boundary: SupaCloud supports transaction blocks inside one SQL request and transactional migrations. It does not expose long-lived HTTP transaction sessions; use a direct Postgres DSN for application-side long transactions.
+
 Project commands owned by this CLI:
 
 - `project get`

package/dist/index.js

@@ -4347,21 +4347,6 @@ class HttpTransport {
 // src/shared/tools/database-tools.ts
 import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, statSync } from "node:fs";
 import { basename, join } from "node:path";
-function normalizeSqlResponse(result) {
-  if (!result.ok)
-    return result;
-  const data = result.data;
-  if (Array.isArray(data?.result) && !Array.isArray(data.rows)) {
-    return {
-      ...result,
-      data: {
-        rows: data.result,
-        rowCount: data.result.length
-      }
-    };
-  }
-  return result;
-}
 function migrationVersionFromFilename(file, fallbackIndex = 0) {
   const match = basename(file).match(/^(\d{8,20})[_-]/);
   if (match)
@@ -4382,6 +4367,36 @@ function appliedMigrationKeys(data) {
   }
   return keys;
 }
+function sqlReferencesVector(sql) {
+  return /\bvector\s*\(\s*\d+\s*\)/i.test(sql) || /::\s*vector\b/i.test(sql) || /\bvector_(cosine|l2|ip)_ops\b/i.test(sql) || /<=>|<#>|<->/.test(sql);
+}
+function sqlCreatesVectorExtension(sql) {
+  return /\bCREATE\s+EXTENSION\s+(?:IF\s+NOT\s+EXISTS\s+)?["']?vector["']?/i.test(sql);
+}
+function extensionRows(data) {
+  if (Array.isArray(data))
+    return data;
+  const shaped = data;
+  const rows = shaped?.rows || [];
+  return Array.isArray(rows) ? rows : [];
+}
+function vectorWarningsForPendingMigrations(migrations, vectorEnabled) {
+  const warnings = [];
+  const vectorUsers = migrations.filter(({ sql }) => sqlReferencesVector(sql));
+  const vectorCreators = migrations.filter(({ sql }) => sqlCreatesVectorExtension(sql));
+  if (!vectorUsers.length && !vectorCreators.length)
+    return warnings;
+  if (vectorEnabled === false && vectorUsers.length && !vectorCreators.length) {
+    warnings.push(`vector extension is not enabled, but pending migrations use vector types/operators: ${vectorUsers.map(({ file }) => file).join(", ")}`);
+  }
+  if (vectorEnabled === false && vectorCreators.length) {
+    warnings.push(`pending migrations will enable pgvector: ${vectorCreators.map(({ file }) => file).join(", ")}`);
+  }
+  if (vectorEnabled === null) {
+    warnings.push("could not verify whether vector extension is enabled");
+  }
+  return warnings;
+}
 function registerDatabaseTools(server, http, config = {}) {
   const { readOnly = false, projectRef } = config;
   const actions = [
@@ -4431,7 +4446,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) => normalizeSqlResponse(await http.post(`/v1/projects/${ref}/database/sql`, { sql }));
+    const execSql = async (sql) => http.post(`/v1/projects/${ref}/database/sql`, { sql });
     let text;
     switch (action) {
       case "query": {
@@ -4578,13 +4593,26 @@ Actions: ${allActions.join(", ")}${readOnly ? " (read-only mode)" : ""}`, {
           const appliedKeys = appliedMigrationKeys(r.data);
           const pending = migrationFiles.filter(({ name, version }) => !appliedKeys.has(name) && !appliedKeys.has(String(version)));
           const alreadyApplied = migrationFiles.filter(({ name, version }) => appliedKeys.has(name) || appliedKeys.has(String(version)));
+          const pendingWithSql = pending.map((migration) => ({
+            ...migration,
+            sql: readFileSync2(join(dir, migration.file), "utf-8")
+          }));
+          let vectorEnabled = null;
+          if (pendingWithSql.some(({ sql }) => sqlReferencesVector(sql) || sqlCreatesVectorExtension(sql))) {
+            const extResult = await execSql("SELECT extname AS name FROM pg_extension WHERE extname = 'vector';");
+            vectorEnabled = extResult.ok ? extensionRows(extResult.data).some((row) => row.name === "vector" || row.extname === "vector") : null;
+          }
+          const warnings = vectorWarningsForPendingMigrations(pendingWithSql, vectorEnabled);
           text = [
             `Migration dry run for ${dir}`,
             `Total: ${migrationFiles.length}`,
-            `Pending: ${pending.length}`,
-            `Already applied: ${alreadyApplied.length}`,
-            ...pending.length ? ["", "Would apply:", ...pending.map(({ file, version }) => `  - ${file} (${version})`)] : [],
-            ...alreadyApplied.length ? ["", "Already applied:", ...alreadyApplied.map(({ file, version }) => `  - ${file} (${version})`)] : []
+            "",
+            "Pending:",
+            ...pending.length ? pending.map(({ file, version }) => `  - ${file} (${version})`) : ["  - none"],
+            "",
+            "Already applied:",
+            ...alreadyApplied.length ? alreadyApplied.map(({ file, version }) => `  - ${file} (${version})`) : ["  - none"],
+            ...warnings.length ? ["", "Warnings:", ...warnings.map((warning) => `  - ${warning}`)] : []
           ].join(`
 `);
           break;
@@ -5671,6 +5699,8 @@ EXAMPLES
   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/*"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",