@grayspar/cli 0.0.1 → 0.0.2

package/dist/lib/retry-transient.js

@@ -0,0 +1,32 @@
+/* A request that never arrived or failed without Grayspar's own answer is tried again with a growing, jittered wait,
+   for as long as failures follow one another without a break, then the last failure is let through. The two minutes
+   count from the start of the first failing attempt, and each later attempt is cut off when they are up. */
+import { setTimeout as pause } from 'node:timers/promises';
+import { CliError } from './errors.js';
+const FIRST_DELAY_MS = 1000;
+const LONGEST_DELAY_MS = 15_000;
+const GIVE_UP_AFTER_MS = 2 * 60 * 1000;
+export const realClock = { now: () => Date.now(), sleep: (ms) => pause(ms) };
+export function isTransient(error) {
+    return (error instanceof CliError && (error.code === 'unreachable' || error.code === 'unavailable'));
+}
+export async function retryTransient(work, clock = realClock) {
+    let failingSince = null;
+    for (let attempt = 0;; attempt += 1) {
+        const started = clock.now();
+        try {
+            return await work(failingSince === null
+                ? undefined
+                : AbortSignal.timeout(Math.max(1, Math.round(failingSince + GIVE_UP_AFTER_MS - started))));
+        }
+        catch (error) {
+            if (!isTransient(error))
+                throw error;
+            failingSince ??= started;
+            if (clock.now() - failingSince >= GIVE_UP_AFTER_MS)
+                throw error;
+            const delay = Math.min(LONGEST_DELAY_MS, FIRST_DELAY_MS * 2 ** attempt);
+            await clock.sleep(delay * (0.5 + Math.random() / 2));
+        }
+    }
+}

package/dist/lib/services-table.js

@@ -5,6 +5,7 @@ const RUNTIME_STATUS = {
     running: { label: 'Running', tint: color.ok },
     restarting: { label: 'Restarting', tint: untinted },
     crashed: { label: 'Crashed', tint: color.bad },
+    unknown: { label: 'Unknown', tint: untinted },
     failed: { label: 'Failed', tint: color.bad },
 };
 export function servicesTable(project) {

package/dist/lib/usage-errors.js

@@ -0,0 +1,43 @@
+import { CliError } from './errors.js';
+import { exitWithError } from './output.js';
+const HELP_LINE = 'Run it with --help to see what it takes.';
+const FLAG_NAME_PATTERN = /^--[\w-]+/;
+function match(error, pattern) {
+    return pattern.exec(error.message);
+}
+export function usageErrorFor(error) {
+    const flag = match(error, /option '([^']+)'/)?.[1];
+    const flagName = flag === undefined ? undefined : FLAG_NAME_PATTERN.exec(flag)?.[0];
+    switch (error.code) {
+        case 'commander.missingMandatoryOptionValue':
+            return new CliError('bad_usage', `This command needs ${flag ?? 'a flag'}.\n${HELP_LINE}`, flagName);
+        case 'commander.optionMissingArgument':
+            return new CliError('bad_usage', `${flag ?? 'A flag'} needs a value.\n${HELP_LINE}`, flagName);
+        case 'commander.invalidArgument': {
+            const choices = match(error, /Allowed choices are ([^.]+)/)?.[1];
+            return new CliError('bad_usage', `${flag ?? 'That'} ${choices === undefined ? "doesn't take that value" : `takes one of ${choices}`}.\n${HELP_LINE}`, flagName);
+        }
+        case 'commander.unknownOption':
+            return new CliError('bad_usage', `${match(error, /unknown option '([^']+)'/)?.[1] ?? 'That flag'} isn't a flag of this command.\n${HELP_LINE}`);
+        case 'commander.unknownCommand':
+            return new CliError('bad_usage', `${match(error, /unknown command '([^']+)'/)?.[1] ?? 'That'} isn't a command.\nRun grayspar --help to see the commands.`);
+        case 'commander.missingArgument':
+            return new CliError('bad_usage', `This command needs ${match(error, /argument '([^']+)'/)?.[1] ?? 'more'} after its name.\n${HELP_LINE}`);
+        case 'commander.excessArguments':
+            return new CliError('bad_usage', `This command was given more than it takes.\n${HELP_LINE}`);
+        default:
+            return new CliError('bad_usage', `That command line isn't valid.\n${HELP_LINE}`);
+    }
+}
+export function routeUsageErrors(program) {
+    const refuse = (error) => {
+        if (error.exitCode === 0 || error.code === 'commander.help')
+            process.exit(error.exitCode);
+        exitWithError(program.opts().json === true ? 'json' : 'text', usageErrorFor(error));
+    };
+    const route = (command) => {
+        command.exitOverride(refuse).configureOutput({ outputError: () => undefined });
+        command.commands.forEach(route);
+    };
+    route(program);
+}

package/dist/lib/version.js

@@ -7,6 +7,6 @@ function readVersion() {
         typeof manifest.version === 'string') {
         return manifest.version;
     }
-    throw new Error('The CLI\u2019s package.json has no version.');
+    throw new Error('package.json of the CLI has no version');
 }
 export const cliVersion = readVersion();

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@grayspar/cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "The cloud for small software. Deploy your applications with one command, and share them with exactly the people you choose.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grayspar/Grayspar.git",
+    "directory": "packages/cli"
+  },
   "keywords": [
     "grayspar",
     "deploy",

package/dist/lib/listening.js

@@ -1,24 +0,0 @@
-import { receipt, warning } from './ui.js';
-function advice(found) {
-    switch (found.kind) {
-        case 'several':
-            return `listens on ports ${found.ports.join(' and ')}. Choose one with grayspar service set ${found.service} --port …`;
-        case 'localhost':
-            return 'listens only on localhost, where no request reaches it. Listen on 0.0.0.0';
-        case 'none':
-            return 'has not opened a port, so no request reaches it. Listen on $PORT';
-    }
-}
-export function portLines(listening) {
-    const receipts = [];
-    const warnings = [];
-    for (const found of listening) {
-        if (found.kind === 'adopted') {
-            receipts.push(receipt(`Set port of ${found.service} to ${found.port}, the port it listens on`));
-        }
-        else {
-            warnings.push(warning(`${found.service} ${advice(found)}`));
-        }
-    }
-    return { receipts, warnings };
-}