@motherbase/cli 0.2.4 → 0.2.6

package/src/commands/projects.js

@@ -1,125 +1,130 @@
-'use strict';
-
-const api = require('../api');
-const { output, requireArg } = require('./_util');
-const { CliError } = require('../context');
-
-const LIFECYCLE = ['start', 'stop', 'restart', 'update', 'rebuild'];
-
-function lifecycleCmd(action) {
-  return {
-    summary: `${action} a project`,
-    usage: `motherbase projects ${action} <id>`,
-    async run(ctx, args) {
-      const id = requireArg(args[0], 'id');
-      const data = await api.consoleRequest(ctx, 'POST', `/projects/${id}/${action}`);
-      output(ctx, data, (d, ui) => ui.success(`${action} → ${id}`));
-    },
-  };
-}
-
-const subcommands = {
-  list: {
-    summary: 'List all projects on the console',
-    usage: 'motherbase projects list',
-    async run(ctx) {
-      const data = await api.consoleRequest(ctx, 'GET', '/projects');
-      output(ctx, data, (rows, ui) =>
-        ui.table(Array.isArray(rows) ? rows : [], [
-          { key: 'name', label: 'NAME' },
-          { key: 'status', label: 'STATUS' },
-          { key: 'domain', label: 'DOMAIN' },
-        ]),
-      );
-    },
-  },
-  create: {
-    summary: 'Create a new project',
-    usage: 'motherbase projects create <name> [--domain <domain>]',
-    async run(ctx, args, flags) {
-      const name = requireArg(args[0], 'name');
-      const body = { name };
-      if (flags.domain) body.domain = flags.domain;
-      const data = await api.consoleRequest(ctx, 'POST', '/projects', { body });
-      output(ctx, data, (d, ui) => ui.success(`Created project ${name}`));
-    },
-  },
-  delete: {
-    summary: 'Delete a project (requires --confirm <name>)',
-    usage: 'motherbase projects delete <id> --confirm <name>',
-    async run(ctx, args, flags) {
-      const id = requireArg(args[0], 'id');
-      const confirm = flags.confirm;
-      if (confirm !== id) {
-        throw new CliError(`Refusing to delete. Pass --confirm ${id} to proceed.`);
-      }
-      const data = await api.consoleRequest(ctx, 'DELETE', `/projects/${id}`, { body: { confirm } });
-      output(ctx, data, (d, ui) => ui.success(`Deleted project ${id}`));
-    },
-  },
-  logs: {
-    summary: 'Show recent logs for a project',
-    usage: 'motherbase projects logs <id> [-f]',
-    async run(ctx, args, flags) {
-      const id = requireArg(args[0], 'id');
-      const fetchOnce = () => api.consoleRequest(ctx, 'GET', `/projects/${id}/logs`);
-      const data = await fetchOnce();
-      output(ctx, data, (d, ui) => {
-        if (d && d.stdout) ui.print(d.stdout);
-        if (d && d.stderr) ui.printErr(d.stderr);
-      });
-      if (flags.f && !ctx.flags.json) {
-        // The console logs endpoint returns a snapshot; approximate -f by polling.
-        const ui = require('../ui');
-        ui.warn('(-f) polling every 3s; Ctrl-C to stop');
-        setInterval(async () => {
-          try {
-            const next = await fetchOnce();
-            if (next && next.stdout) process.stdout.write(next.stdout);
-          } catch (e) { ui.warn(e.message); }
-        }, 3000);
-        await new Promise(() => {});
-      }
-    },
-  },
-  info: {
-    summary: 'Show project details and DNS checks',
-    usage: 'motherbase projects info <id>',
-    async run(ctx, args) {
-      const id = requireArg(args[0], 'id');
-      const list = await api.consoleRequest(ctx, 'GET', '/projects');
-      const project = (Array.isArray(list) ? list : []).find(p => p.name === id || p.id === id) || { name: id };
-      let dns = null;
-      try { dns = await api.consoleRequest(ctx, 'GET', `/projects/${id}/dns`); } catch { /* optional */ }
-      const data = { ...project, dns: dns && dns.checks };
-      output(ctx, data, (d, ui) => ui.keyValue(d));
-    },
-  },
-  limits: {
-    summary: 'Get or set per-project resource limits',
-    usage: 'motherbase projects limits <id> [--api-cpus n --api-mem mb --db-cpus n --db-mem mb --minio-cpus n --minio-mem mb]',
-    async run(ctx, args, flags) {
-      const id = requireArg(args[0], 'id');
-      const map = {
-        'api-cpus': 'apiCpus', 'api-mem': 'apiMemMb',
-        'db-cpus': 'dbCpus', 'db-mem': 'dbMemMb',
-        'minio-cpus': 'minioCpus', 'minio-mem': 'minioMemMb',
-      };
-      const body = {};
-      for (const [flag, key] of Object.entries(map)) {
-        if (flags[flag] !== undefined) body[key] = Number(flags[flag]);
-      }
-      const method = Object.keys(body).length ? 'PATCH' : 'GET';
-      const data = await api.consoleRequest(ctx, method, `/projects/${id}/limits`, method === 'PATCH' ? { body } : {});
-      output(ctx, data, (d, ui) => ui.keyValue(d || {}));
-    },
-  },
-};
-
-for (const action of LIFECYCLE) subcommands[action] = lifecycleCmd(action);
-
-module.exports = {
-  summary: 'Manage projects on the Platform Console',
-  usage: 'motherbase projects <list|create|start|stop|restart|update|rebuild|delete|logs|info|limits> ...',
-  subcommands,
-};
+'use strict';
+
+const api = require('../api');
+const keys = require('./keys');
+const { output, alias, requireArg } = require('./_util');
+const { CliError } = require('../context');
+const { outputFormat } = require('../format');
+
+const LIFECYCLE = ['start', 'stop', 'restart', 'update', 'rebuild'];
+
+function lifecycleCmd(action) {
+  return {
+    summary: `${action} a project`,
+    usage: `motherbase projects ${action} <id>`,
+    async run(ctx, args) {
+      const id = requireArg(args[0], 'id');
+      const data = await api.consoleRequest(ctx, 'POST', `/projects/${id}/${action}`);
+      output(ctx, data, (d, ui) => ui.success(`${action} → ${id}`));
+    },
+  };
+}
+
+const subcommands = {
+  list: {
+    summary: 'List all projects on the console',
+    usage: 'motherbase projects list',
+    async run(ctx) {
+      const data = await api.consoleRequest(ctx, 'GET', '/projects');
+      output(ctx, data, (rows, ui) =>
+        ui.table(Array.isArray(rows) ? rows : [], [
+          { key: 'name', label: 'NAME' },
+          { key: 'status', label: 'STATUS' },
+          { key: 'domain', label: 'DOMAIN' },
+        ]),
+      );
+    },
+  },
+  create: {
+    summary: 'Create a new project',
+    usage: 'motherbase projects create <name> [--domain <domain>]',
+    async run(ctx, args, flags) {
+      const name = requireArg(args[0], 'name');
+      const body = { name };
+      if (flags.domain) body.domain = flags.domain;
+      const data = await api.consoleRequest(ctx, 'POST', '/projects', { body });
+      output(ctx, data, (d, ui) => ui.success(`Created project ${name}`));
+    },
+  },
+  delete: {
+    summary: 'Delete a project (requires --confirm <name>)',
+    usage: 'motherbase projects delete <id> --confirm <name>',
+    async run(ctx, args, flags) {
+      const id = requireArg(args[0], 'id');
+      const confirm = flags.confirm;
+      if (confirm !== id) {
+        throw new CliError(`Refusing to delete. Pass --confirm ${id} to proceed.`);
+      }
+      const data = await api.consoleRequest(ctx, 'DELETE', `/projects/${id}`, { body: { confirm } });
+      output(ctx, data, (d, ui) => ui.success(`Deleted project ${id}`));
+    },
+  },
+  logs: {
+    summary: 'Show recent logs for a project',
+    usage: 'motherbase projects logs <id> [-f]',
+    async run(ctx, args, flags) {
+      const id = requireArg(args[0], 'id');
+      const fetchOnce = () => api.consoleRequest(ctx, 'GET', `/projects/${id}/logs`);
+      const data = await fetchOnce();
+      output(ctx, data, (d, ui) => {
+        if (d && d.stdout) ui.print(d.stdout);
+        if (d && d.stderr) ui.printErr(d.stderr);
+      });
+      if (flags.f && outputFormat(ctx.flags) === 'pretty') {
+        // The console logs endpoint returns a snapshot; approximate -f by polling.
+        const ui = require('../ui');
+        ui.warn('(-f) polling every 3s; Ctrl-C to stop');
+        setInterval(async () => {
+          try {
+            const next = await fetchOnce();
+            if (next && next.stdout) process.stdout.write(next.stdout);
+          } catch (e) { ui.warn(e.message); }
+        }, 3000);
+        await new Promise(() => {});
+      }
+    },
+  },
+  info: {
+    summary: 'Show project details and DNS checks',
+    usage: 'motherbase projects info <id>',
+    async run(ctx, args) {
+      const id = requireArg(args[0], 'id');
+      const list = await api.consoleRequest(ctx, 'GET', '/projects');
+      const project = (Array.isArray(list) ? list : []).find(p => p.name === id || p.id === id) || { name: id };
+      let dns = null;
+      try { dns = await api.consoleRequest(ctx, 'GET', `/projects/${id}/dns`); } catch { /* optional */ }
+      const data = { ...project, dns: dns && dns.checks };
+      output(ctx, data, (d, ui) => ui.keyValue(d));
+    },
+  },
+  limits: {
+    summary: 'Get or set per-project resource limits',
+    usage: 'motherbase projects limits <id> [--api-cpus n --api-mem mb --db-cpus n --db-mem mb --minio-cpus n --minio-mem mb]',
+    async run(ctx, args, flags) {
+      const id = requireArg(args[0], 'id');
+      const map = {
+        'api-cpus': 'apiCpus', 'api-mem': 'apiMemMb',
+        'db-cpus': 'dbCpus', 'db-mem': 'dbMemMb',
+        'minio-cpus': 'minioCpus', 'minio-mem': 'minioMemMb',
+      };
+      const body = {};
+      for (const [flag, key] of Object.entries(map)) {
+        if (flags[flag] !== undefined) body[key] = Number(flags[flag]);
+      }
+      const method = Object.keys(body).length ? 'PATCH' : 'GET';
+      const data = await api.consoleRequest(ctx, method, `/projects/${id}/limits`, method === 'PATCH' ? { body } : {});
+      output(ctx, data, (d, ui) => ui.keyValue(d || {}));
+    },
+  },
+};
+
+for (const action of LIFECYCLE) subcommands[action] = lifecycleCmd(action);
+
+// Supabase's `projects api-keys`; the keys themselves live under `keys`.
+subcommands['api-keys'] = alias(keys.subcommands.list, 'motherbase projects api-keys [--project-ref <id>]');
+
+module.exports = {
+  summary: 'Manage projects on the Platform Console',
+  usage: 'motherbase projects <list|create|start|stop|restart|update|rebuild|delete|logs|info|limits|api-keys> ...',
+  subcommands,
+};

package/src/commands/queues.js

@@ -0,0 +1,133 @@
+'use strict';
+
+const api = require('../api');
+const { output, requireArg } = require('./_util');
+const { CliError } = require('../context');
+
+const enc = encodeURIComponent;
+
+function int(flag, name) {
+  if (flag === undefined) return undefined;
+  const n = Number(flag);
+  if (!Number.isInteger(n) || n < 0) throw new CliError(`--${name} must be a non-negative integer`);
+  return n;
+}
+
+function parseMessage(raw) {
+  try {
+    return JSON.parse(requireArg(raw, 'json'));
+  } catch (err) {
+    if (err instanceof CliError) throw err;
+    throw new CliError('the message must be valid JSON, e.g. \'{"task":"resize"}\'');
+  }
+}
+
+const subcommands = {
+  list: {
+    summary: 'List queues with their depth',
+    usage: 'motherbase queues list',
+    async run(ctx) {
+      const data = await api.adminRequest(ctx, 'GET', '/queues');
+      const queues = (data && data.queues) || [];
+      output(ctx, data, (_d, ui) =>
+        ui.table(queues, [
+          { key: 'name', label: 'NAME' },
+          { key: 'type', label: 'TYPE' },
+          { key: 'length', label: 'MESSAGES' },
+          { key: 'visibleLength', label: 'VISIBLE' },
+          { key: 'totalMessages', label: 'TOTAL' },
+        ]),
+      );
+    },
+  },
+  enable: {
+    summary: 'Install pgmq for this project',
+    usage: 'motherbase queues enable',
+    async run(ctx) {
+      const data = await api.adminRequest(ctx, 'POST', '/queues/enable');
+      output(ctx, data, (_d, ui) => ui.success('Queues enabled'));
+    },
+  },
+  expose: {
+    summary: 'Expose queues to the client SDK through pgmq_public (or hide them)',
+    usage: 'motherbase queues expose <true|false>',
+    async run(ctx, args) {
+      const value = requireArg(args[0], 'true|false');
+      if (value !== 'true' && value !== 'false') throw new CliError('expected true or false');
+      const data = await api.adminRequest(ctx, 'PUT', '/queues/expose', { body: { enabled: value === 'true' } });
+      output(ctx, data, (_d, ui) => ui.success(`Queues ${value === 'true' ? 'exposed' : 'hidden'}`));
+    },
+  },
+  create: {
+    summary: 'Create a queue',
+    usage: 'motherbase queues create <name> [--type basic|unlogged|partitioned] [--rls true|false]',
+    async run(ctx, args, flags) {
+      const name = requireArg(args[0], 'name');
+      const body = { name };
+      if (flags.type) body.type = flags.type;
+      if (flags.rls !== undefined) body.rls = flags.rls === true || flags.rls === 'true';
+      const data = await api.adminRequest(ctx, 'POST', '/queues', { body });
+      output(ctx, data, (_d, ui) => ui.success(`Created queue ${name}`));
+    },
+  },
+  drop: {
+    summary: 'Drop a queue and its messages',
+    usage: 'motherbase queues drop <name>',
+    async run(ctx, args) {
+      const name = requireArg(args[0], 'name');
+      const data = await api.adminRequest(ctx, 'DELETE', `/queues/${enc(name)}`);
+      output(ctx, data, (_d, ui) => ui.success(`Dropped queue ${name}`));
+    },
+  },
+  send: {
+    summary: 'Send a JSON message',
+    usage: "motherbase queues send <name> '<json>' [--delay seconds]",
+    async run(ctx, args, flags) {
+      const name = requireArg(args[0], 'name');
+      const body = { message: parseMessage(args[1]) };
+      const delay = int(flags.delay, 'delay');
+      if (delay !== undefined) body.delay = delay;
+      const data = await api.adminRequest(ctx, 'POST', `/queues/${enc(name)}/messages`, { body });
+      output(ctx, data, (d, ui) => ui.success(`Sent message ${((d && d.msgIds) || []).join(', ')}`));
+    },
+  },
+  read: {
+    summary: 'Read messages, hiding them from other readers for the visibility timeout',
+    usage: 'motherbase queues read <name> [--qty 1] [--vt 30]',
+    async run(ctx, args, flags) {
+      const name = requireArg(args[0], 'name');
+      const body = {};
+      const qty = int(flags.qty, 'qty');
+      const vt = int(flags.vt, 'vt');
+      if (qty !== undefined) body.qty = qty;
+      if (vt !== undefined) body.vt = vt;
+      const data = await api.adminRequest(ctx, 'POST', `/queues/${enc(name)}/read`, { body });
+      output(ctx, data, (d, ui) => ui.json((d && d.messages) || []));
+    },
+  },
+  archive: {
+    summary: 'Move a message to the archive',
+    usage: 'motherbase queues archive <name> <msg-id>',
+    async run(ctx, args) {
+      const name = requireArg(args[0], 'name');
+      const id = requireArg(args[1], 'msg-id');
+      const data = await api.adminRequest(ctx, 'POST', `/queues/${enc(name)}/messages/${enc(id)}/archive`);
+      output(ctx, data, (_d, ui) => ui.success(`Archived message ${id}`));
+    },
+  },
+  purge: {
+    summary: 'Delete every message in a queue',
+    usage: 'motherbase queues purge <name>',
+    async run(ctx, args) {
+      const name = requireArg(args[0], 'name');
+      const data = await api.adminRequest(ctx, 'POST', `/queues/${enc(name)}/purge`);
+      output(ctx, data, (d, ui) => ui.success(`Purged ${(d && d.purged) ?? 0} messages from ${name}`));
+    },
+  },
+};
+
+module.exports = {
+  summary: 'Message queues (pgmq)',
+  usage: 'motherbase queues <list|enable|expose|create|drop|send|read|archive|purge> ...',
+  subcommands,
+};

package/src/commands/realtime.js

@@ -1,35 +1,35 @@
-'use strict';
-
-const api = require('../api');
-const { output } = require('./_util');
-
-const subcommands = {
-  config: {
-    summary: 'Show realtime config, or set enabled models with --models a,b,c',
-    usage: 'motherbase realtime config [--models a,b,c]',
-    async run(ctx, args, flags) {
-      if (flags.models !== undefined) {
-        const models = String(flags.models).split(',').map(s => s.trim()).filter(Boolean);
-        const data = await api.adminRequest(ctx, 'PATCH', '/realtime/config', { body: { models } });
-        output(ctx, data, (d, ui) => ui.success(`Enabled models: ${(d && d.models ? d.models : models).join(', ') || '(none)'}`));
-        return;
-      }
-      const data = await api.adminRequest(ctx, 'GET', '/realtime/config');
-      output(ctx, data, (d, ui) => ui.keyValue(d || {}));
-    },
-  },
-  channels: {
-    summary: 'List active realtime channels',
-    usage: 'motherbase realtime channels',
-    async run(ctx) {
-      const data = await api.adminRequest(ctx, 'GET', '/realtime/channels');
-      output(ctx, data, (d, ui) => ui.json((d && d.channels) || d));
-    },
-  },
-};
-
-module.exports = {
-  summary: 'Realtime configuration and channels',
-  usage: 'motherbase realtime <config|channels> ...',
-  subcommands,
-};
+'use strict';
+
+const api = require('../api');
+const { output } = require('./_util');
+
+const subcommands = {
+  config: {
+    summary: 'Show realtime config, or set enabled models with --models a,b,c',
+    usage: 'motherbase realtime config [--models a,b,c]',
+    async run(ctx, args, flags) {
+      if (flags.models !== undefined) {
+        const models = String(flags.models).split(',').map(s => s.trim()).filter(Boolean);
+        const data = await api.adminRequest(ctx, 'PATCH', '/realtime/config', { body: { models } });
+        output(ctx, data, (d, ui) => ui.success(`Enabled models: ${(d && d.models ? d.models : models).join(', ') || '(none)'}`));
+        return;
+      }
+      const data = await api.adminRequest(ctx, 'GET', '/realtime/config');
+      output(ctx, data, (d, ui) => ui.keyValue(d || {}));
+    },
+  },
+  channels: {
+    summary: 'List active realtime channels',
+    usage: 'motherbase realtime channels',
+    async run(ctx) {
+      const data = await api.adminRequest(ctx, 'GET', '/realtime/channels');
+      output(ctx, data, (d, ui) => ui.json((d && d.channels) || d));
+    },
+  },
+};
+
+module.exports = {
+  summary: 'Realtime configuration and channels',
+  usage: 'motherbase realtime <config|channels> ...',
+  subcommands,
+};