@portaidentity/cli 0.1.0

package/dist/commands/client.js

@@ -0,0 +1,385 @@
+/**
+ * CLI client management commands.
+ *
+ * Provides CRUD and lifecycle management for OIDC clients, plus
+ * nested secret subcommands. All operations use the Porta SDK for
+ * Admin API communication.
+ *
+ * Usage:
+ *   porta client create --org <org-id> --app <app-id> --type confidential --redirect-uris "https://..." [--name "My Client"]
+ *   porta client list --app <app-id> [--status active|revoked] [--page 1] [--page-size 20]
+ *   porta client show <client-id>
+ *   porta client update <client-id> --name "New Name" [--redirect-uris "..."]
+ *   porta client revoke <client-id>
+ *   porta client restore <client-id>
+ *   porta client history <client-id>
+ *   porta client login-methods get <client-id>
+ *   porta client login-methods set <client-id> --methods "password,magic_link"
+ *   porta client login-methods clear <client-id>
+ *   porta client secret <subcommand> ...
+ *
+ * @module commands/client
+ */
+import { createClient } from '../client-factory.js';
+import { handleError } from '../error-handler.js';
+import { printTable, printJson, success, warn, info, formatDate, truncate, } from '../output.js';
+import { confirm } from '../prompt.js';
+import { parseLoginMethodsFlag, parseCommaSeparated } from '../parsers.js';
+import { clientSecretCommand } from './client-secret.js';
+// ---------------------------------------------------------------------------
+// Command definition
+// ---------------------------------------------------------------------------
+/** The client command module — registered at the top level of the CLI */
+export const clientCommand = {
+    command: 'client',
+    describe: 'Manage OIDC clients',
+    builder: (yargs) => {
+        return yargs
+            // ── create ──────────────────────────────────────────────────────
+            .command('create', 'Create a new OIDC client', (y) => y
+            .option('org', {
+            type: 'string',
+            demandOption: true,
+            description: 'Organization UUID (owner of the client)',
+        })
+            .option('app', {
+            type: 'string',
+            demandOption: true,
+            description: 'Application UUID or slug',
+        })
+            .option('name', {
+            type: 'string',
+            description: 'Client display name',
+        })
+            .option('type', {
+            type: 'string',
+            choices: ['confidential', 'public'],
+            demandOption: true,
+            description: 'Client type (confidential has secret, public does not)',
+        })
+            .option('application-type', {
+            type: 'string',
+            choices: ['web', 'native', 'spa'],
+            default: 'web',
+            description: 'Application deployment type',
+        })
+            .option('redirect-uris', {
+            type: 'string',
+            demandOption: true,
+            description: 'Comma-separated redirect URIs',
+        })
+            .option('login-methods', {
+            type: 'string',
+            description: 'Comma-separated login methods (password, magic_link) or "inherit" to use the org default',
+        }), async (argv) => {
+            try {
+                const loginMethods = parseLoginMethodsFlag(argv['login-methods'], 
+                /* allowInherit */ true);
+                const sdkClient = createClient(argv);
+                // Resolve app slug → UUID if needed via SDK get
+                let appId = argv.app;
+                const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+                if (!UUID_REGEX.test(appId)) {
+                    const { data: app } = await sdkClient.applications.get(appId);
+                    appId = app.id;
+                }
+                const result = await sdkClient.clients.create({
+                    applicationId: appId,
+                    name: argv.name ?? 'Unnamed Client',
+                    clientType: argv.type,
+                    redirectUris: parseCommaSeparated(argv['redirect-uris']),
+                    ...(loginMethods !== undefined && { loginMethods }),
+                });
+                if (argv.json) {
+                    printJson(result);
+                }
+                else {
+                    success(`Client created: ${result.name} (${result.clientId})`);
+                    printTable(['Field', 'Value'], [
+                        ['ID', result.id],
+                        ['Client ID', result.clientId],
+                        ['Name', result.name],
+                        ['Type', result.clientType],
+                        ['Status', result.status],
+                        ['Redirect URIs', result.redirectUris.join(', ')],
+                        ['Created', formatDate(result.createdAt)],
+                    ]);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── list ────────────────────────────────────────────────────────
+            .command('list', 'List clients for an application', (y) => y
+            .option('app', {
+            type: 'string',
+            demandOption: true,
+            description: 'Application UUID or slug',
+        })
+            .option('status', {
+            type: 'string',
+            choices: ['active', 'revoked'],
+            description: 'Filter by status',
+        })
+            .option('page', {
+            type: 'number',
+            default: 1,
+            description: 'Page number',
+        })
+            .option('page-size', {
+            type: 'number',
+            default: 20,
+            description: 'Items per page',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const result = await sdkClient.clients.list({
+                    page: argv.page,
+                    pageSize: argv['page-size'],
+                    ...(argv.status && { status: argv.status }),
+                    ...(argv.app && { applicationId: argv.app }),
+                });
+                if (result.data.length === 0) {
+                    warn('No clients found');
+                    return;
+                }
+                if (argv.json) {
+                    printJson(result);
+                }
+                else {
+                    printTable(['ID', 'Client ID', 'Name', 'Type', 'Status', 'Created'], result.data.map((c) => [
+                        truncate(c.id, 8),
+                        truncate(c.clientId, 8),
+                        c.name,
+                        c.clientType,
+                        c.status,
+                        formatDate(c.createdAt),
+                    ]));
+                    info(`Total: ${result.total} clients`);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── show ────────────────────────────────────────────────────────
+            .command('show <client-id>', 'Show client details', (y) => y.positional('client-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'Client internal UUID or client_id',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const { data: c } = await sdkClient.clients.get(argv['client-id']);
+                if (argv.json) {
+                    printJson(c);
+                }
+                else {
+                    printTable(['Field', 'Value'], [
+                        ['ID', c.id],
+                        ['Client ID', c.clientId],
+                        ['Name', c.name],
+                        ['Type', c.clientType],
+                        ['Status', c.status],
+                        ['Redirect URIs', c.redirectUris.join(', ') || '—'],
+                        ['Grant Types', c.grantTypes.join(', ')],
+                        ['Login Methods', c.loginMethods === null ? 'inherit' : c.loginMethods.join(', ')],
+                        ['Created', formatDate(c.createdAt)],
+                        ['Updated', formatDate(c.updatedAt)],
+                    ]);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── update ──────────────────────────────────────────────────────
+            .command('update <client-id>', 'Update client fields', (y) => y
+            .positional('client-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'Client internal UUID or client_id',
+        })
+            .option('name', {
+            type: 'string',
+            description: 'New client display name',
+        })
+            .option('redirect-uris', {
+            type: 'string',
+            description: 'New comma-separated redirect URIs',
+        })
+            .option('login-methods', {
+            type: 'string',
+            description: 'Comma-separated login methods (password, magic_link) or "inherit" to reset to org default',
+        }), async (argv) => {
+            try {
+                const loginMethods = parseLoginMethodsFlag(argv['login-methods'], 
+                /* allowInherit */ true);
+                const sdkClient = createClient(argv);
+                const { data: current, etag } = await sdkClient.clients.get(argv['client-id']);
+                const updated = await sdkClient.clients.update(current.id, {
+                    name: argv.name,
+                    redirectUris: argv['redirect-uris']
+                        ? parseCommaSeparated(argv['redirect-uris'])
+                        : undefined,
+                    ...(loginMethods !== undefined && { loginMethods }),
+                }, etag ?? undefined);
+                if (argv.json) {
+                    printJson(updated);
+                }
+                else {
+                    success(`Client updated: ${updated.name} (${updated.clientId})`);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── revoke ──────────────────────────────────────────────────────
+            .command('revoke <client-id>', 'Revoke a client (permanent)', (y) => y.positional('client-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'Client internal UUID or client_id',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const { data: c } = await sdkClient.clients.get(argv['client-id']);
+                if (!argv.force) {
+                    const confirmed = await confirm(`Revoke client "${c.name}" (${c.clientId})? This is permanent and cannot be undone.`);
+                    if (!confirmed) {
+                        warn('Operation cancelled');
+                        return;
+                    }
+                }
+                await sdkClient.clients.revoke(c.id);
+                success(`Client revoked: ${c.name} (${c.clientId})`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── restore (NEW) ───────────────────────────────────────────────
+            .command('restore <client-id>', 'Restore a revoked client', (y) => y.positional('client-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'Client internal UUID or client_id',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const { data: c } = await sdkClient.clients.get(argv['client-id']);
+                await sdkClient.clients.restore(c.id);
+                success(`Client restored: ${c.name} (${c.clientId})`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── history (NEW) ───────────────────────────────────────────────
+            .command('history <client-id>', 'Show client change history', (y) => y.positional('client-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'Client internal UUID or client_id',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const history = await sdkClient.clients.getHistory(argv['client-id']);
+                if (history.length === 0) {
+                    warn('No history entries found');
+                    return;
+                }
+                if (argv.json) {
+                    printJson(history);
+                }
+                else {
+                    printTable(['Date', 'Action', 'Actor', 'Changes'], history.map((h) => [
+                        formatDate(h.createdAt),
+                        h.action,
+                        h.performedBy ?? '—',
+                        h.changes ? JSON.stringify(h.changes).slice(0, 60) : '—',
+                    ]));
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── login-methods ───────────────────────────────────────────────
+            .command('login-methods', 'Manage client login method overrides', (loginYargs) => {
+            return loginYargs
+                // ── login-methods get ──
+                .command('get <client-id>', 'Show current login methods for a client', (y) => y.positional('client-id', {
+                type: 'string',
+                demandOption: true,
+                description: 'Client internal UUID or client_id',
+            }), async (argv) => {
+                try {
+                    const sdkClient = createClient(argv);
+                    const { data: c } = await sdkClient.clients.get(argv['client-id']);
+                    if (argv.json) {
+                        printJson({
+                            clientId: c.clientId,
+                            loginMethods: c.loginMethods,
+                        });
+                    }
+                    else {
+                        const display = c.loginMethods === null
+                            ? 'inherit (using org default)'
+                            : c.loginMethods.join(', ');
+                        info(`Login methods for ${c.name}: ${display}`);
+                    }
+                }
+                catch (err) {
+                    handleError(err, argv.verbose);
+                }
+            })
+                // ── login-methods set ──
+                .command('set <client-id>', 'Set login method overrides for a client', (y) => y
+                .positional('client-id', {
+                type: 'string',
+                demandOption: true,
+                description: 'Client internal UUID or client_id',
+            })
+                .option('methods', {
+                type: 'string',
+                demandOption: true,
+                description: 'Comma-separated login methods (password, magic_link)',
+            }), async (argv) => {
+                try {
+                    const loginMethods = parseLoginMethodsFlag(argv.methods, false);
+                    const sdkClient = createClient(argv);
+                    const { data: current, etag } = await sdkClient.clients.get(argv['client-id']);
+                    await sdkClient.clients.update(current.id, { loginMethods: loginMethods ?? undefined }, etag ?? undefined);
+                    success(`Login methods set for ${current.name}: ${argv.methods}`);
+                }
+                catch (err) {
+                    handleError(err, argv.verbose);
+                }
+            })
+                // ── login-methods clear ──
+                .command('clear <client-id>', 'Clear login method overrides (inherit from org)', (y) => y.positional('client-id', {
+                type: 'string',
+                demandOption: true,
+                description: 'Client internal UUID or client_id',
+            }), async (argv) => {
+                try {
+                    const sdkClient = createClient(argv);
+                    const { data: current, etag } = await sdkClient.clients.get(argv['client-id']);
+                    await sdkClient.clients.update(current.id, { loginMethods: null }, etag ?? undefined);
+                    success(`Login methods cleared for ${current.name} (will inherit from org)`);
+                }
+                catch (err) {
+                    handleError(err, argv.verbose);
+                }
+            })
+                .demandCommand(1, 'Specify a login-methods subcommand: get, set, clear');
+        })
+            // ── nested subcommand groups ────────────────────────────────────
+            .command(clientSecretCommand)
+            .demandCommand(1, 'Specify a client subcommand: create, list, show, update, revoke, restore, history, login-methods, secret');
+    },
+    handler: () => {
+        // No-op — subcommands handle execution
+    },
+};
+//# sourceMappingURL=client.js.map

package/dist/commands/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/commands/client.ts"],"names":[],"mappings":"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"}

package/dist/commands/completion.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CLI completion command — generate shell completion scripts.
+ *
+ * Leverages yargs' built-in completion support to generate
+ * shell completion scripts for bash, zsh, and fish.
+ *
+ * Usage:
+ *   porta completion              # Print completion script
+ *   source <(porta completion)    # Install for current session (bash/zsh)
+ *
+ * Permanent installation:
+ *   porta completion >> ~/.bashrc    # bash
+ *   porta completion >> ~/.zshrc     # zsh
+ *
+ * @module commands/completion
+ */
+import type { CommandModule } from 'yargs';
+import type { GlobalOptions } from '../global-options.js';
+/**
+ * The completion command module — outputs shell completion script.
+ *
+ * This is a thin wrapper that triggers yargs' built-in `showCompletionScript()`
+ * method. The completion script handles tab-completion for commands,
+ * subcommands, and options.
+ */
+export declare const completionCommand: CommandModule<GlobalOptions, GlobalOptions>;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM1D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,aAAa,EAAE,aAAa,CAezE,CAAC"}

package/dist/commands/completion.js

@@ -0,0 +1,42 @@
+/**
+ * CLI completion command — generate shell completion scripts.
+ *
+ * Leverages yargs' built-in completion support to generate
+ * shell completion scripts for bash, zsh, and fish.
+ *
+ * Usage:
+ *   porta completion              # Print completion script
+ *   source <(porta completion)    # Install for current session (bash/zsh)
+ *
+ * Permanent installation:
+ *   porta completion >> ~/.bashrc    # bash
+ *   porta completion >> ~/.zshrc     # zsh
+ *
+ * @module commands/completion
+ */
+// ---------------------------------------------------------------------------
+// Command Definition
+// ---------------------------------------------------------------------------
+/**
+ * The completion command module — outputs shell completion script.
+ *
+ * This is a thin wrapper that triggers yargs' built-in `showCompletionScript()`
+ * method. The completion script handles tab-completion for commands,
+ * subcommands, and options.
+ */
+export const completionCommand = {
+    command: 'completion',
+    describe: 'Generate shell completion script',
+    handler: async () => {
+        // yargs.showCompletionScript() is called via the yargs configuration
+        // in index.ts. This handler is a fallback for direct invocation.
+        console.log('# Porta CLI shell completion');
+        console.log('# Add the following to your shell profile:');
+        console.log('#   source <(porta completion)');
+        console.log('#');
+        console.log('# Or use yargs built-in completion:');
+        console.log('#   porta --get-yargs-completions');
+        process.exit(0);
+    },
+};
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgD;IAC5E,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,kCAAkC;IAE5C,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,qEAAqE;QACrE,iEAAiE;QACjE,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Config command — manage system configuration.
+ *
+ * Subcommands:
+ *   list       List all configuration entries
+ *   get        Get a specific configuration value
+ *   set        Set a configuration value
+ *
+ * @module commands/config
+ */
+import type { CommandModule } from 'yargs';
+import type { GlobalOptions } from '../global-options.js';
+export declare const configCommand: CommandModule<GlobalOptions, GlobalOptions>;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsB1D,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE,aAAa,CAgGrE,CAAC"}

package/dist/commands/config.js

@@ -0,0 +1,85 @@
+/**
+ * Config command — manage system configuration.
+ *
+ * Subcommands:
+ *   list       List all configuration entries
+ *   get        Get a specific configuration value
+ *   set        Set a configuration value
+ *
+ * @module commands/config
+ */
+import { createClient } from '../client-factory.js';
+import { handleError } from '../error-handler.js';
+import { printTable, printJson, success, formatDate } from '../output.js';
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+export const configCommand = {
+    command: 'config',
+    describe: 'Manage system configuration',
+    builder: (yargs) => yargs
+        // ── list ──────────────────────────────────────────────────────────
+        .command('list', 'List all configuration entries', (y) => y, async (argv) => {
+        try {
+            const client = createClient(argv);
+            const entries = await client.config.list();
+            if (argv.json) {
+                printJson(entries);
+                return;
+            }
+            printTable(['Key', 'Value', 'Updated'], entries.map((e) => [e.key, e.value, formatDate(e.updatedAt)]));
+        }
+        catch (err) {
+            handleError(err, argv.verbose);
+        }
+    })
+        // ── get ───────────────────────────────────────────────────────────
+        .command('get <key>', 'Get a configuration value', (y) => y.positional('key', {
+        type: 'string',
+        describe: 'Configuration key',
+        demandOption: true,
+    }), async (argv) => {
+        try {
+            const client = createClient(argv);
+            const entry = await client.config.get(argv.key);
+            if (argv.json) {
+                printJson(entry);
+                return;
+            }
+            printTable(['Key', 'Value', 'Description', 'Updated'], [[entry.key, entry.value, entry.description ?? '—', formatDate(entry.updatedAt)]]);
+        }
+        catch (err) {
+            handleError(err, argv.verbose);
+        }
+    })
+        // ── set ───────────────────────────────────────────────────────────
+        .command('set <key> <value>', 'Set a configuration value', (y) => y
+        .positional('key', {
+        type: 'string',
+        describe: 'Configuration key',
+        demandOption: true,
+    })
+        .positional('value', {
+        type: 'string',
+        describe: 'New value',
+        demandOption: true,
+    }), async (argv) => {
+        try {
+            const client = createClient(argv);
+            const entry = await client.config.set(argv.key, argv.value);
+            if (argv.json) {
+                printJson(entry);
+                return;
+            }
+            success(`Set ${entry.key} = ${entry.value}`);
+        }
+        catch (err) {
+            handleError(err, argv.verbose);
+        }
+    })
+        .demandCommand(1, 'Please specify a config subcommand: list, get, set'),
+    handler: () => {
+        // No-op — subcommands handle execution
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAe1E,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAgD;IACxE,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;QACH,qEAAqE;SACpE,OAAO,CACN,MAAM,EACN,gCAAgC,EAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAE3C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,SAAS,CAAC,OAAO,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,UAAU,CACR,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAC3B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAC9D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CACF;QAED,qEAAqE;SACpE,OAAO,CACN,WAAW,EACX,2BAA2B,EAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,mBAAmB;QAC7B,YAAY,EAAE,IAAI;KACnB,CAAC,EACJ,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEhD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,SAAS,CAAC,KAAK,CAAC,CAAC;gBACjB,OAAO;YACT,CAAC;YAED,UAAU,CACR,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,EAC1C,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,IAAI,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAClF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CACF;QAED,qEAAqE;SACpE,OAAO,CACN,mBAAmB,EACnB,2BAA2B,EAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC;SACE,UAAU,CAAC,KAAK,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,mBAAmB;QAC7B,YAAY,EAAE,IAAI;KACnB,CAAC;SACD,UAAU,CAAC,OAAO,EAAE;QACnB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE,IAAI;KACnB,CAAC,EACN,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAE5D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,SAAS,CAAC,KAAK,CAAC,CAAC;gBACjB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,OAAO,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CACF;SACA,aAAa,CAAC,CAAC,EAAE,oDAAoD,CAAC;IAC3E,OAAO,EAAE,GAAG,EAAE;QACZ,uCAAuC;IACzC,CAAC;CACF,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CLI doctor command — diagnostic checks for the CLI environment.
+ *
+ * Runs a series of checks to verify the CLI setup is correct:
+ *   1. Node.js version (>= 22.0.0 required)
+ *   2. Credentials file exists and is readable
+ *   3. Token validity (not expired)
+ *   4. Server reachability (health endpoint)
+ *   5. Admin metadata endpoint accessible
+ *
+ * Useful for troubleshooting authentication or connectivity issues.
+ *
+ * Usage:
+ *   porta doctor          # Run all diagnostic checks
+ *   porta doctor --json   # JSON output (machine-readable)
+ *
+ * @module commands/doctor
+ */
+import type { CommandModule } from 'yargs';
+import type { GlobalOptions } from '../global-options.js';
+/**
+ * The doctor command module — runs diagnostic checks.
+ */
+export declare const doctorCommand: CommandModule<GlobalOptions, GlobalOptions>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAmK1D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE,aAAa,CAoDrE,CAAC"}