insta 0.1.10 → 0.1.11

package/dist/commands/postgres.js

@@ -3,13 +3,22 @@ import { constants as osConstants } from 'node:os';
 import { ApiClient, ApiError, requireProject } from '../api.js';
 import { info, printJson, handleApproval, relayExitCode } from '../util.js';
 import { parseVolumeGib, q, resolveSoleService } from './services.js';
-// Toggle a postgres service between scale-to-zero (the default: instance suspends when idle,
-// cold-starts on the next connection) and always-on (instance stays warm; idle RAM bills at
-// actual usage). Thin wrapper over PATCH /database/settings {scaleToZero} — insta-db-backed
-// postgres only.
-export async function dbAlwaysOn(mode, service, opts) {
-    if (mode !== 'on' && mode !== 'off')
+export function alwaysOnArgs(first, second) {
+    if (first === 'on' || first === 'off')
+        return { mode: first, service: second };
+    if (second !== undefined)
         throw new Error('mode must be on|off');
+    return { service: first };
+}
+export function alwaysOnLine(group, scaleToZero) {
+    return `postgres ${group}: always-on ${scaleToZero === false ? 'on — instance stays warm' : scaleToZero === true ? 'off — scales to zero when idle' : 'unknown — the provider did not report it'}`;
+}
+// Show or set a postgres service's idle mode: scale-to-zero (the default: instance suspends when
+// idle, cold-starts on the next connection) or always-on (instance stays warm; idle RAM bills at
+// actual usage). Reads GET /database/instance, sets PATCH /database/settings {scaleToZero} —
+// insta-db-backed postgres only.
+export async function dbAlwaysOn(first, second, opts) {
+    const { mode, service } = alwaysOnArgs(first, second);
     const api = await ApiClient.load();
     const p = await requireProject();
     const qs = new URLSearchParams();
@@ -18,7 +27,19 @@ export async function dbAlwaysOn(mode, service, opts) {
         qs.set('branch', branch);
     if (service)
         qs.set('group', service);
-    const res = await api.rawRequest('PATCH', `/projects/${p.projectId}/database/settings${qs.toString() ? `?${qs}` : ''}`, { scaleToZero: mode !== 'on' });
+    const suffix = qs.toString() ? `?${qs}` : '';
+    if (!mode) {
+        const read = await fetchDbInstance(api, p.projectId, suffix);
+        if (read.kind === 'no-instance') {
+            info(`postgres ${service ?? 'default'}: no manageable instance (this service manages its own resources)`);
+            return;
+        }
+        if (opts.json)
+            return printJson(read.body);
+        info(alwaysOnLine(service ?? 'default', read.body?.scaleToZero));
+        return;
+    }
+    const res = await api.rawRequest('PATCH', `/projects/${p.projectId}/database/settings${suffix}`, { scaleToZero: mode !== 'on' });
     if (handleApproval(res, opts.json))
         return;
     if (opts.json)

package/dist/index.js

@@ -438,7 +438,7 @@ pg.command('volume [service]').description("Show or grow a postgres service's pr
     .option('--size <gi>', 'new size in whole Gi, e.g. 10 (must be ≥ the current size)')
     .option('--json').option('--branch <branch>', 'branch (default: current)')
     .action(guard((service, o) => pgCmd.dbVolume(service, o)));
-pg.command('always-on <mode> [service]').description('Set a postgres service always-on (mode: on|off). on = instance stays warm, no cold starts; off = default scale-to-zero (idle instance suspends; first connection cold-starts). insta-db-backed services only')
+pg.command('always-on [mode] [service]').description('Show or set a postgres service always-on (mode: on|off; no mode = print the current setting). on = instance stays warm, no cold starts; off = default scale-to-zero (idle instance suspends; first connection cold-starts). insta-db-backed services only')
     .option('--json').option('--branch <branch>', 'branch (default: current)')
     .action(guard((mode, service, o) => pgCmd.dbAlwaysOn(mode, service, o)));
 addObservability(pg, 'db', 'postgres');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "insta",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "type": "module",
   "description": "InstaCloud CLI — a thin client of the platform control-plane API.",
   "keywords": [