@ciphrix/cli 0.1.0

package/dist/banner.js

@@ -0,0 +1,12 @@
+import { CLI_VERSION } from './constants.js';
+// Shown only for a bare `ciphrix` invocation, never for a command.
+const BANNER_ART = [
+    '   ██████╗██╗██████╗ ██╗  ██╗██████╗ ██╗██╗  ██╗',
+    '  ██╔════╝██║██╔══██╗██║  ██║██╔══██╗██║╚██╗██╔╝',
+    '  ██║     ██║██████╔╝███████║██████╔╝██║ ╚███╔╝ ',
+    '  ██║     ██║██╔═══╝ ██╔══██║██╔══██╗██║ ██╔██╗ ',
+    '  ╚██████╗██║██║     ██║  ██║██║  ██║██║██╔╝ ██╗',
+    '   ╚═════╝╚═╝╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═╝',
+].join('\n');
+const TAGLINE = 'C i p h r i x   c o m p l i a n c e   C L I';
+export const formatBanner = (theme) => [theme.cyan(theme.bold(BANNER_ART)), theme.dim(`${TAGLINE}  v${CLI_VERSION}`)].join('\n');

package/dist/browser.d.ts

@@ -0,0 +1,2 @@
+/** Opens an HTTP(S) URL in the user's default browser without invoking a shell. */
+export declare const openInBrowser: (value: string, platform?: NodeJS.Platform) => Promise<boolean>;

package/dist/browser.js

@@ -0,0 +1,44 @@
+import { spawn } from 'node:child_process';
+/** Opens an HTTP(S) URL in the user's default browser without invoking a shell. */
+export const openInBrowser = (value, platform = process.platform) => {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return Promise.resolve(false);
+    }
+    const isLoopback = url.hostname === 'localhost' ||
+        url.hostname === '[::1]' ||
+        /^127(?:\.\d{1,3}){3}$/.test(url.hostname);
+    if ((url.protocol !== 'https:' && !(url.protocol === 'http:' && isLoopback)) ||
+        url.username ||
+        url.password) {
+        return Promise.resolve(false);
+    }
+    const commands = {
+        darwin: ['open', [url.href]],
+        linux: ['xdg-open', [url.href]],
+        win32: ['rundll32.exe', ['url.dll,FileProtocolHandler', url.href]],
+    };
+    const command = commands[platform];
+    if (!command)
+        return Promise.resolve(false);
+    return new Promise((resolve) => {
+        try {
+            const child = spawn(command[0], command[1], {
+                detached: true,
+                stdio: 'ignore',
+                windowsHide: true,
+            });
+            child.once('error', () => resolve(false));
+            child.once('spawn', () => {
+                child.unref();
+                resolve(true);
+            });
+        }
+        catch {
+            resolve(false);
+        }
+    });
+};

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+import { Command } from 'commander';
+import { type CliIO } from './io.js';
+export type { CliIO } from './io.js';
+export declare const CONFIGURATION_HELP = "\nConfiguration:\n  --api-url <url>                 override the API base URL for one command\n  CIPHRIX_API_URL                 default API base URL for this process\n  CIPHRIX_CREDENTIAL_STORE=file   use plaintext file credentials for local/headless testing\n  CIPHRIX_ALLOW_INSECURE_HTTP=true\n                                  permit HTTP for intentional local testing\n\nProduction and the OS keychain are used by default. No general config file is read.\nSee the README Configuration section for precedence and security details.\n";
+/**
+ * Builds the command tree. Kept separate from `main` so tests can construct a
+ * program with captured output and no process exits.
+ */
+export declare const createProgram: (io?: CliIO) => Command;
+/**
+ * Runs the CLI and resolves to a process exit code. `--help`/`--version` and
+ * usage errors are handled by commander and mapped to their exit codes.
+ */
+export declare const main: (argv?: readonly string[], io?: CliIO) => Promise<number>;