shsu 0.0.5 → 0.0.7

package/README.md

@@ -2,7 +2,7 @@
 
 **S**elf-**H**osted **S**upabase **U**tilities
 
-Deploy and manage Supabase Edge Functions on Coolify-hosted Supabase.
+Deploy and manage Supabase Edge Functions and migrations on Coolify-hosted Supabase.
 
 ## Install
 
@@ -27,17 +27,22 @@ This adds config to your `package.json`:
   "shsu": {
     "server": "root@your-coolify-server",
     "remotePath": "/data/coolify/services/YOUR_SERVICE_ID/volumes/functions",
-    "url": "https://your-supabase.example.com"
+    "url": "https://your-supabase.example.com",
+    "edgeContainer": "edge",
+    "dbContainer": "postgres"
   }
 }
 ```
 
-Find your `remotePath` by running on your server:
+### Finding Configuration Values
 
+**remotePath** - SSH to your server and run:
 ```bash
 docker inspect $(docker ps -q --filter 'name=edge') | grep -A 5 "Mounts"
 ```
 
+**Container names** - SSH to your server and run `docker ps` to list containers. Coolify names containers using the pattern `<service>-<uuid>` (e.g., `abc123-supabase-edge-functions-1`). The filter does substring matching, so `edge` matches any container with "edge" in its name.
+
 ## Usage
 
 ```bash
@@ -56,6 +61,9 @@ shsu deploy hello-world
 # Deploy without restarting edge-runtime
 shsu deploy hello-world --no-restart
 
+# Run database migrations
+shsu migrate
+
 # Stream logs
 shsu logs
 
@@ -75,6 +83,21 @@ shsu new my-function
 shsu restart
 ```
 
+## Migrations
+
+Place SQL files in `./supabase/migrations/` (or your configured `migrationsPath`). Files are sorted alphabetically and executed in order.
+
+```
+supabase/migrations/
+  001_create_users.sql
+  002_add_email_index.sql
+```
+
+Run with:
+```bash
+shsu migrate
+```
+
 ## Configuration
 
 Config is read from `package.json` "shsu" key. Environment variables override package.json values.
@@ -85,6 +108,9 @@ Config is read from `package.json` "shsu" key. Environment variables override pa
 | `remotePath` / `SHSU_REMOTE_PATH` | Yes | Remote path to functions directory |
 | `url` / `SHSU_URL` | For `invoke` | Supabase URL |
 | `localPath` / `SHSU_LOCAL_PATH` | No | Local functions path (default: `./supabase/functions`) |
+| `migrationsPath` / `SHSU_MIGRATIONS_PATH` | No | Local migrations path (default: `./supabase/migrations`) |
+| `edgeContainer` / `SHSU_EDGE_CONTAINER` | No | Edge runtime container filter (default: `edge`) |
+| `dbContainer` / `SHSU_DB_CONTAINER` | No | Database container filter (default: `postgres`) |
 
 ## MCP Server
 
@@ -136,14 +162,16 @@ Add to `.cursor/mcp.json` in your project:
 }
 ```
 
-### Available Tools
+### Available MCP Tools
 
 - `deploy` - Deploy edge functions
+- `migrate` - Run database migrations
 - `list` - List local and remote functions
 - `invoke` - Invoke a function
 - `restart` - Restart edge-runtime
 - `new` - Create new function from template
 - `config` - Show current configuration
+- `docs` - Get setup documentation
 
 ## Releasing
 

package/bin/shsu.mjs

@@ -27,7 +27,10 @@ function loadConfig() {
     server: process.env.SHSU_SERVER || pkgConfig.server,
     remotePath: process.env.SHSU_REMOTE_PATH || pkgConfig.remotePath,
     localPath: process.env.SHSU_LOCAL_PATH || pkgConfig.localPath || './supabase/functions',
+    migrationsPath: process.env.SHSU_MIGRATIONS_PATH || pkgConfig.migrationsPath || './supabase/migrations',
     url: process.env.SHSU_URL || pkgConfig.url,
+    edgeContainer: process.env.SHSU_EDGE_CONTAINER || pkgConfig.edgeContainer || 'edge',
+    dbContainer: process.env.SHSU_DB_CONTAINER || pkgConfig.dbContainer || 'postgres',
   };
 }
 
@@ -85,7 +88,7 @@ function runSync(cmd) {
 }
 
 function getEdgeContainer() {
-  return runSync(`ssh ${config.server} "docker ps -q --filter 'name=edge'"`);
+  return runSync(`ssh ${config.server} "docker ps -q --filter 'name=${config.edgeContainer}'"`);
 }
 
 // ─────────────────────────────────────────────────────────────
@@ -121,7 +124,7 @@ async function cmdDeploy(funcName, noRestart = false) {
     info('Restarting edge-runtime...');
     await run('ssh', [
       config.server,
-      `docker restart $(docker ps -q --filter 'name=edge')`,
+      `docker restart $(docker ps -q --filter 'name=${config.edgeContainer}')`,
     ], { stdio: ['inherit', 'pipe', 'inherit'] });
     success(`Deployed${funcName ? ` ${funcName}` : ''}`);
   } else {
@@ -136,7 +139,7 @@ async function cmdLogs(filter, lines = 100) {
 
   const sshArgs = [
     config.server,
-    `docker logs -f $(docker ps -q --filter 'name=edge') --tail ${lines} 2>&1`,
+    `docker logs -f $(docker ps -q --filter 'name=${config.edgeContainer}') --tail ${lines} 2>&1`,
   ];
 
   if (filter) {
@@ -196,11 +199,62 @@ async function cmdRestart() {
   info('Restarting edge-runtime...');
   await run('ssh', [
     config.server,
-    `docker restart $(docker ps -q --filter 'name=edge')`,
+    `docker restart $(docker ps -q --filter 'name=${config.edgeContainer}')`,
   ], { stdio: ['inherit', 'pipe', 'inherit'] });
   success('Restarted');
 }
 
+async function cmdMigrate() {
+  requireServer();
+
+  if (!existsSync(config.migrationsPath)) {
+    error(`Migrations folder not found: ${config.migrationsPath}`);
+  }
+
+  // Get list of migration files
+  const migrations = readdirSync(config.migrationsPath)
+    .filter((f) => f.endsWith('.sql'))
+    .sort();
+
+  if (migrations.length === 0) {
+    info('No migration files found.');
+    return;
+  }
+
+  info(`Found ${migrations.length} migration(s): ${migrations.join(', ')}`);
+
+  // Copy migrations to server
+  const remoteMigrationsPath = '/tmp/shsu-migrations';
+  info('Syncing migrations to server...');
+  await run('rsync', [
+    '-avz', '--delete',
+    `${config.migrationsPath}/`,
+    `${config.server}:${remoteMigrationsPath}/`,
+  ]);
+
+  // Find the database container
+  const dbContainer = runSync(`ssh ${config.server} "docker ps -q --filter 'name=${config.dbContainer}'"`);
+  if (!dbContainer) {
+    error(`Database container not found (filter: ${config.dbContainer})`);
+  }
+
+  // Run each migration
+  for (const migration of migrations) {
+    info(`Running ${migration}...`);
+    try {
+      await run('ssh', [
+        config.server,
+        `docker exec -i ${dbContainer} psql -U postgres -d postgres -f /tmp/shsu-migrations/${migration}`,
+      ]);
+      success(`Applied ${migration}`);
+    } catch (e) {
+      error(`Failed to apply ${migration}: ${e.message}`);
+    }
+  }
+
+  success('All migrations applied');
+}
+
 async function cmdNew(funcName) {
   if (!funcName) {
     error('Usage: shsu new <function-name>');
@@ -239,23 +293,26 @@ function cmdEnv() {
   console.log(`
 ${c.yellow('Configuration (package.json "shsu" key or environment variables):')}
 
-  server        SSH host for your Coolify server
-  remotePath    Remote path to functions directory
-  url           Supabase URL (for invoke command)
-  localPath     Local functions path (default: ./supabase/functions)
-
-${c.yellow('Environment variables override package.json:')}
-
-  SHSU_SERVER, SHSU_REMOTE_PATH, SHSU_URL, SHSU_LOCAL_PATH
+  server          SSH host for your Coolify server
+  remotePath      Remote path to functions directory
+  url             Supabase URL (for invoke command)
+  localPath       Local functions path (default: ./supabase/functions)
+  migrationsPath  Local migrations path (default: ./supabase/migrations)
+  edgeContainer   Edge runtime container filter (default: edge)
+  dbContainer     Database container filter (default: postgres)
 
 ${c.yellow('Current values:')}
 
-  server       = ${config.server || c.dim('(not set)')}
-  remotePath   = ${config.remotePath || c.dim('(not set)')}
-  url          = ${config.url || c.dim('(not set)')}
-  localPath    = ${config.localPath}
+  server          = ${config.server || c.dim('(not set)')}
+  remotePath      = ${config.remotePath || c.dim('(not set)')}
+  url             = ${config.url || c.dim('(not set)')}
+  localPath       = ${config.localPath}
+  migrationsPath  = ${config.migrationsPath}
+  edgeContainer   = ${config.edgeContainer}
+  dbContainer     = ${config.dbContainer}
 
 ${c.dim('Run "shsu init" to configure via prompts.')}
+${c.dim('Find container names in Coolify: Services → Your Service → look for container name prefix')}
 `);
 }
 
@@ -285,6 +342,8 @@ async function cmdInit() {
   const remotePath = await ask('Remote path to functions', config.remotePath);
   const url = await ask('Supabase URL', config.url);
   const localPath = await ask('Local functions path', config.localPath || './supabase/functions');
+  const edgeContainer = await ask('Edge container name filter', config.edgeContainer || 'edge');
+  const dbContainer = await ask('Database container name filter', config.dbContainer || 'postgres');
 
   rl.close();
 
@@ -295,6 +354,8 @@ async function cmdInit() {
     remotePath: remotePath || undefined,
     url: url || undefined,
     localPath: localPath !== './supabase/functions' ? localPath : undefined,
+    edgeContainer: edgeContainer !== 'edge' ? edgeContainer : undefined,
+    dbContainer: dbContainer !== 'postgres' ? dbContainer : undefined,
   };
 
   // Remove undefined values
@@ -362,6 +423,16 @@ async function cmdMcp() {
       description: 'Get current shsu configuration.',
       inputSchema: { type: 'object', properties: {} },
     },
+    {
+      name: 'migrate',
+      description: 'Run SQL migrations on the database. Syncs migration files via rsync and executes them via psql.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'docs',
+      description: 'Get documentation on how to set up and use shsu for deploying Supabase Edge Functions.',
+      inputSchema: { type: 'object', properties: {} },
+    },
   ];
 
   const serverInfo = {
@@ -411,7 +482,7 @@ async function cmdMcp() {
         }
 
         if (!noRestart) {
-          output += '\n' + captureExec(`ssh ${config.server} "docker restart \\$(docker ps -q --filter 'name=edge')"`);
+          output += '\n' + captureExec(`ssh ${config.server} "docker restart \\$(docker ps -q --filter 'name=${config.edgeContainer}')"`);
         }
 
         return { content: [{ type: 'text', text: `Deployed${funcName ? ` ${funcName}` : ' all functions'}${noRestart ? ' (no restart)' : ''}\n\n${output}` }] };
@@ -448,7 +519,7 @@ async function cmdMcp() {
         if (!config.server) {
           return { content: [{ type: 'text', text: 'Error: server must be configured.' }] };
         }
-        const output = captureExec(`ssh ${config.server} "docker restart \\$(docker ps -q --filter 'name=edge')"`);
+        const output = captureExec(`ssh ${config.server} "docker restart \\$(docker ps -q --filter 'name=${config.edgeContainer}')"`);
         return { content: [{ type: 'text', text: `Restarted edge-runtime\n\n${output}` }] };
       }
 
@@ -487,7 +558,124 @@ async function cmdMcp() {
         return {
           content: [{
             type: 'text',
-            text: `Current configuration:\n  server: ${config.server || '(not set)'}\n  remotePath: ${config.remotePath || '(not set)'}\n  url: ${config.url || '(not set)'}\n  localPath: ${config.localPath}`,
+            text: `Current configuration:\n  server: ${config.server || '(not set)'}\n  remotePath: ${config.remotePath || '(not set)'}\n  url: ${config.url || '(not set)'}\n  localPath: ${config.localPath}\n  migrationsPath: ${config.migrationsPath}\n  edgeContainer: ${config.edgeContainer}\n  dbContainer: ${config.dbContainer}`,
+          }],
+        };
+      }
+
+      case 'migrate': {
+        if (!config.server) {
+          return { content: [{ type: 'text', text: 'Error: server must be configured.' }] };
+        }
+        if (!existsSync(config.migrationsPath)) {
+          return { content: [{ type: 'text', text: `Error: Migrations folder not found: ${config.migrationsPath}` }] };
+        }
+        const migrations = readdirSync(config.migrationsPath)
+          .filter((f) => f.endsWith('.sql'))
+          .sort();
+        if (migrations.length === 0) {
+          return { content: [{ type: 'text', text: 'No migration files found.' }] };
+        }
+        let output = `Found ${migrations.length} migration(s): ${migrations.join(', ')}\n\n`;
+        // Sync migrations
+        output += captureExec(`rsync -avz --delete "${config.migrationsPath}/" "${config.server}:/tmp/shsu-migrations/"`) + '\n';
+        // Find db container
+        const dbContainer = captureExec(`ssh ${config.server} "docker ps -q --filter 'name=${config.dbContainer}'"`);
+        if (!dbContainer) {
+          return { content: [{ type: 'text', text: `Error: Database container not found (filter: ${config.dbContainer})` }] };
+        }
+        // Run migrations
+        for (const migration of migrations) {
+          output += `\nRunning ${migration}...\n`;
+          output += captureExec(`ssh ${config.server} "docker exec -i ${dbContainer} psql -U postgres -d postgres -f /tmp/shsu-migrations/${migration}"`) + '\n';
+        }
+        output += '\nAll migrations applied.';
+        return { content: [{ type: 'text', text: output }] };
+      }
+
+      case 'docs': {
+        return {
+          content: [{
+            type: 'text',
+            text: `# shsu - Self-Hosted Supabase Utilities
+
+Deploy and manage Supabase Edge Functions on Coolify-hosted Supabase.
+
+## Project Setup
+
+1. **Configure shsu** by adding to package.json:
+\`\`\`json
+{
+  "shsu": {
+    "server": "root@your-coolify-server",
+    "remotePath": "/data/coolify/services/YOUR_SERVICE_ID/volumes/functions",
+    "url": "https://your-supabase.example.com",
+    "edgeContainer": "edge",
+    "dbContainer": "postgres"
+  }
+}
+\`\`\`
+
+Or run \`npx shsu init\` for interactive setup.
+
+2. **Find configuration values** by SSH'ing to your server:
+   - Container names: \`docker ps\` (Coolify uses pattern \`<service>-<uuid>\`)
+   - Remote path: \`docker inspect $(docker ps -q --filter 'name=edge') | grep -A 5 "Mounts"\`
+
+## Directory Structure
+
+\`\`\`
+your-project/
+├── package.json          # Contains shsu config
+├── supabase/
+│   ├── functions/        # Edge functions (default localPath)
+│   │   ├── hello-world/
+│   │   │   └── index.ts
+│   │   └── another-func/
+│   │       └── index.ts
+│   └── migrations/       # SQL migrations (default migrationsPath)
+│       ├── 001_create_users.sql
+│       └── 002_add_indexes.sql
+\`\`\`
+
+## Configuration Options
+
+| Key | Required | Default | Description |
+|-----|----------|---------|-------------|
+| server | Yes | - | SSH host (e.g., root@server.com) |
+| remotePath | Yes | - | Remote path to functions directory |
+| url | For invoke | - | Supabase URL |
+| localPath | No | ./supabase/functions | Local functions path |
+| migrationsPath | No | ./supabase/migrations | Local migrations path |
+| edgeContainer | No | edge | Edge runtime container filter |
+| dbContainer | No | postgres | Database container filter |
+
+## Edge Function Template
+
+Use \`new\` tool to create functions. Each function needs an index.ts:
+
+\`\`\`typescript
+Deno.serve(async (req) => {
+  const { name } = await req.json()
+  return new Response(
+    JSON.stringify({ message: \`Hello \${name}!\` }),
+    { headers: { "Content-Type": "application/json" } }
+  )
+})
+\`\`\`
+
+## Workflow
+
+1. Create function: \`new\` tool with function name
+2. Edit the function code in supabase/functions/<name>/index.ts
+3. Deploy: \`deploy\` tool (syncs via rsync, restarts edge-runtime)
+4. Test: \`invoke\` tool with JSON data
+5. Debug: Check logs on the server
+
+## Migrations
+
+Place .sql files in supabase/migrations/. They execute alphabetically.
+Use \`migrate\` tool to run all migrations via psql in the database container.`,
           }],
         };
       }
@@ -559,6 +747,8 @@ ${c.yellow('Commands:')}
                        - With name: deploy single function
                        Options: --no-restart
 
+  migrate              Run SQL migrations on database
+
   logs [filter]        Stream edge-runtime logs
                        - Optional filter string
 
@@ -578,6 +768,7 @@ ${c.yellow('Examples:')}
   shsu init
   shsu deploy
   shsu deploy hello-world --no-restart
+  shsu migrate
   shsu logs hello-world
   shsu invoke hello-world '{"name":"Stefan"}'
   shsu new my-function
@@ -617,6 +808,11 @@ async function main() {
       case 'restart':
         await cmdRestart();
         break;
+      case 'migrate':
+      case 'migration':
+      case 'migrations':
+        await cmdMigrate();
+        break;
       case 'new':
       case 'create':
         await cmdNew(args[1]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shsu",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "CLI for deploying and managing Supabase Edge Functions on self-hosted Supabase (Coolify, Docker Compose). Sync functions via rsync, stream logs, and invoke endpoints.",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"