@api-now/cli 1.0.4 → 1.1.0

package/dist/commands/auth.js

@@ -1,314 +0,0 @@
-import { Argument } from 'commander';
-import http from 'node:http';
-import open from 'open';
-import { config } from '../utils/config.js';
-import { getSdkClient, handleApiError } from '../utils/api.js';
-import { Formatter, style, debug } from '../utils/formatter.js';
-import { setupFirstOrganizationIfNeeded } from '../utils/org-setup.js';
-import { registerTokensCommands } from './tokens.js';
-/**
- * Registers authentication management commands (login, status, logout) with the main Commander program.
- *
- * @param program - The root Commander program.
- */
-export function registerAuthCommands(program) {
-    const authCmd = program.command('auth').description('Manage CLI authentication');
-    registerTokensCommands(authCmd);
-    authCmd
-        .command('login')
-        .description('Authenticate with the API platform using OAuth2 (google, github, or linkedin)')
-        .addArgument(new Argument('provider', 'Authentication provider').choices(['google', 'github', 'linkedin']))
-        .action(async (provider) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        const allowedProviders = ['google', 'github', 'linkedin'];
-        if (!allowedProviders.includes(provider)) {
-            formatter.error({
-                message: `Invalid provider '${provider}'. Allowed: ${allowedProviders.join(', ')}`,
-            });
-            process.exit(1);
-        }
-        const apiUrl = config.resolved.apiUrl;
-        if (config.resolved.format !== 'json') {
-            console.log(`Starting authentication flow using provider '${provider}'...`);
-        }
-        try {
-            await runLoginServer(apiUrl, provider, formatter);
-            formatter.success('Successfully authenticated!');
-            const client = getSdkClient();
-            await setupFirstOrganizationIfNeeded(client, formatter);
-        }
-        catch (err) {
-            if (err instanceof Error) {
-                formatter.error({ message: err.message });
-            }
-            else {
-                formatter.error({ message: 'Authentication failed.' });
-            }
-            process.exit(1);
-        }
-    });
-    authCmd
-        .command('logout')
-        .description('Log out and clear the stored token')
-        .action(() => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        config.clearConfigKey('token');
-        formatter.success('Logged out successfully.');
-    });
-    authCmd
-        .command('status')
-        .description('Check current authentication status')
-        .action(async () => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        const resolved = config.resolved;
-        if (!resolved.token) {
-            formatter.error({ message: 'Not logged in. Use `auth login <provider>` to authenticate.' });
-            process.exit(1);
-        }
-        try {
-            const client = getSdkClient();
-            const user = await client.users.me({ token: client.token });
-            if (resolved.format === 'json') {
-                formatter.object({ authenticated: true, user });
-            }
-            else {
-                console.log(style.green('✔ Authenticated successfully!'));
-                console.log(`User: ${user.name} (${user.email})`);
-                console.log(`Default Org: ${resolved.org || 'None'}`);
-            }
-            await setupFirstOrganizationIfNeeded(client, formatter);
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error({
-                message: 'Authentication token is invalid or expired.',
-                detail: apiErr.message,
-            });
-            process.exit(1);
-        }
-    });
-}
-/**
- * Spins up a temporary local HTTP server to receive the OAuth authentication token
- * from the browser-based callback page.
- *
- * @param apiUrl - The target backend API server base URL.
- * @param provider - The OAuth login provider.
- * @param formatter - Output formatter.
- * @returns A promise resolving to the retrieved authentication token.
- */
-function runLoginServer(apiUrl, provider, formatter) {
-    return new Promise((resolve, reject) => {
-        const server = http.createServer((req, res) => {
-            if (req.method === 'GET' && req.url?.startsWith('/callback')) {
-                debug('auth', `Received request for callback: ${req.url}`);
-                res.writeHead(200, { 'Content-Type': 'text/html' });
-                const html = `
-<!DOCTYPE html>
-<html>
-<head>
-  <title>API NOW! CLI Login</title>
-  <style>
-    body {
-      font-family: system-ui, -apple-system, sans-serif;
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      height: 100vh;
-      margin: 0;
-      background: #121214;
-      color: #e1e1e6;
-    }
-    .card {
-      background: #202024;
-      padding: 2rem;
-      border-radius: 8px;
-      box-shadow: 0 4px 12px rgba(0,0,0,0.5);
-      text-align: center;
-      max-width: 450px;
-      width: 100%;
-    }
-    h1 { color: #04d361; margin-top: 0; }
-    .status { font-weight: bold; margin: 1rem 0; line-height: 1.4; }
-    .diagnostics {
-      display: none;
-      text-align: left;
-      margin-top: 1.5rem;
-      padding: 1rem;
-      background: #2f2f33;
-      border-radius: 4px;
-      font-size: 0.8rem;
-      font-family: monospace;
-      white-space: pre-wrap;
-      word-break: break-all;
-      border-left: 4px solid #f75a68;
-    }
-  </style>
-</head>
-<body>
-  <div class="card">
-    <h1>API NOW!</h1>
-    <p class="status" id="status">Retrieving token from server...</p>
-    <div class="diagnostics" id="diagnostics">
-      <strong>Diagnostic Details:</strong>
-      <div id="diagnostics-content" style="margin-top: 0.5rem;"></div>
-    </div>
-  </div>
-  <script>
-    fetch('${apiUrl}/auth/token', { credentials: 'include' })
-      .then(r => {
-        if (!r.ok) {
-          throw new Error('Token request failed: ' + r.statusText + ' (status: ' + r.status + ')');
-        }
-        return r.json();
-      })
-      .then(data => {
-        console.log("[DEBUG] Parse response JSON:", data);
-        const token = data.token || data.data?.token || data.data;
-        if (!token) {
-          throw new Error('Token not found in API response structure');
-        }
-        
-        console.log("[DEBUG] POSTing token to local server callback...");
-        return fetch('/token', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ token })
-        });
-      })
-      .then(r => {
-        if (!r.ok) {
-          throw new Error('Failed to save token in CLI server (status: ' + r.status + ')');
-        }
-        document.getElementById('status').innerText = 'Authentication successful! You can close this tab now.';
-        document.getElementById('status').style.color = '#04d361';
-      })
-      .catch(err => {
-        console.error("[ERROR]", err);
-        document.getElementById('status').innerText = 'Authentication failed.';
-        document.getElementById('status').style.color = '#f75a68';
-        
-        const diag = document.getElementById('diagnostics');
-        const content = document.getElementById('diagnostics-content');
-        diag.style.display = 'block';
-        content.innerText = 
-          'Error Message: ' + err.message + '\\n\\n' +
-          'Originating URL: ' + window.location.href + '\\n' +
-          'Target API URL: ${apiUrl}/auth/token\\n\\n' +
-          'TIP: If you get "Unauthorized (status: 401)", make sure that:\\n' +
-          '1. You completed the login flow on the browser window that opened.\\n' +
-          '2. The host of the page you are on (' + window.location.hostname + ') matches the host of the API (' + new URL('${apiUrl}').hostname + ') to satisfy SameSite cookie policy.\\n' +
-          '3. Check browser developer console (F12) for detailed CORS/Network errors.';
-        
-        fetch('/error', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ message: err.message })
-        }).catch(console.error);
-      });
-  </script>
-</body>
-</html>
-        `;
-                res.end(html);
-                return;
-            }
-            if (req.method === 'POST' && req.url === '/token') {
-                let body = '';
-                req.on('data', (chunk) => {
-                    body += chunk;
-                });
-                req.on('end', () => {
-                    try {
-                        const data = JSON.parse(body);
-                        if (data.token) {
-                            debug('auth', 'Storing retrieved token to CLI configuration...');
-                            config.writeProperty('token', data.token);
-                            res.writeHead(200, { 'Content-Type': 'application/json' });
-                            res.end(JSON.stringify({ success: true }));
-                            resolve(data.token);
-                        }
-                        else {
-                            res.writeHead(400, { 'Content-Type': 'application/json' });
-                            res.end(JSON.stringify({ error: 'Token missing' }));
-                            reject(new Error('Token missing from browser callback.'));
-                        }
-                    }
-                    catch (e) {
-                        if (e instanceof Error) {
-                            res.writeHead(400, { 'Content-Type': 'application/json' });
-                            res.end(JSON.stringify({ error: e.message }));
-                            reject(new Error('Invalid body received: ' + e.message));
-                        }
-                        else {
-                            res.writeHead(400, { 'Content-Type': 'application/json' });
-                            res.end(JSON.stringify({ error: 'Invalid body received' }));
-                            reject(new Error('Invalid body received'));
-                        }
-                    }
-                    finally {
-                        cleanup();
-                    }
-                });
-                return;
-            }
-            if (req.method === 'POST' && req.url === '/error') {
-                let body = '';
-                req.on('data', (chunk) => {
-                    body += chunk;
-                });
-                req.on('end', () => {
-                    try {
-                        const data = JSON.parse(body);
-                        debug('auth', `Received login error from browser callback: ${data.message}`);
-                        reject(new Error(data.message || 'Browser login failed'));
-                    }
-                    catch {
-                        reject(new Error('Browser login failed'));
-                    }
-                    finally {
-                        cleanup();
-                    }
-                });
-                return;
-            }
-            res.writeHead(404);
-            res.end();
-        });
-        const handleSigInt = () => {
-            cleanup();
-            process.exit(130);
-        };
-        process.on('SIGINT', handleSigInt);
-        process.on('SIGTERM', handleSigInt);
-        const timeout = setTimeout(() => {
-            reject(new Error('Authentication timed out.'));
-            cleanup();
-        }, 300000);
-        function cleanup() {
-            clearTimeout(timeout);
-            process.off('SIGINT', handleSigInt);
-            process.off('SIGTERM', handleSigInt);
-            server.close();
-        }
-        server.listen(0, '127.0.0.1', async () => {
-            const port = server.address().port;
-            // Smart hostname matching: resolve 127.0.0.1 vs localhost context dynamically to enable cookie transport
-            const apiHost = new URL(apiUrl).hostname;
-            const redirectHost = apiHost === 'localhost' ? 'localhost' : '127.0.0.1';
-            const loginUrl = `${apiUrl}/auth/${provider}/redirect?r=http://${redirectHost}:${port}/callback`;
-            debug('auth', `Ephemeral loopback server listening on http://127.0.0.1:${port}`);
-            debug('auth', `Browser callback origin configured to http://${redirectHost}:${port}`);
-            if (formatter.format !== 'json') {
-                console.log(`Opening browser to log in...`);
-                console.log(`If it doesn't open automatically, navigate to:\n  ${loginUrl}`);
-            }
-            try {
-                await open(loginUrl);
-            }
-            catch (_err) {
-                // Ignore open failure
-            }
-        });
-    });
-}

package/dist/commands/catalog.js

@@ -1,289 +0,0 @@
-import { getSdkClient, handleApiError } from '../utils/api.js';
-import { config } from '../utils/config.js';
-import { Formatter, CliErrorCode } from '../utils/formatter.js';
-import { DomainFileKind } from '@api-now/core/models/kinds.js';
-import { askInput, askSelect } from '../utils/prompt.js';
-import { DataCatalogKind, DataCatalogVersion, } from '@api-now/core/models/index.js';
-/**
- * Registers catalog management commands (publish, list) with the main Commander program.
- *
- * @param program - The root Commander program.
- */
-export function registerCatalogCommands(program) {
-    const catalogCmd = program.command('catalog').description('Manage Data Catalog items');
-    catalogCmd
-        .command('publish')
-        .description('Publish a data domain file to the data catalog')
-        .option('--file <fid>', 'File ID of the data domain')
-        .option('--name <name>', 'Name for the catalog entry')
-        .option('--description <desc>', 'Description of the catalog entry')
-        .option('--scope <scope>', 'Publish scope: public, organization, private')
-        .option('-v, --catalog-version <ver>', 'Semantic version (e.g. 1.0.0)')
-        .option('--org <oid>', 'Organization ID (optional, defaults to configured default org)')
-        .option('--lifecycle <lifecycle>', 'Version lifecycle status (dev, beta, stable)', 'stable')
-        .option('--changelog <changelog>', 'Changelog description for this version')
-        .action(async (options) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        const resolved = config.resolved;
-        const orgId = options.org || resolved.org;
-        if (!orgId) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'Organization ID is required.',
-                detail: 'Pass --org <oid> or set a default organization using `apinow orgs set-default <oid>`.',
-            });
-            process.exit(1);
-        }
-        // Empathic interactive fallbacks
-        let fileId = options.file;
-        if (!fileId && process.stdout.isTTY) {
-            try {
-                const client = getSdkClient();
-                const res = await client.files.list(orgId, {
-                    filter: {
-                        field: 'kind',
-                        operator: 'eq',
-                        value: DomainFileKind,
-                    },
-                }, { token: client.token });
-                const files = res.data || [];
-                if (files.length > 0) {
-                    fileId = await askSelect('Select a data domain file to publish:', files.map((f) => ({
-                        name: `${f.info?.name || 'Unnamed'} (${f.key})`,
-                        value: f.key,
-                    })));
-                }
-            }
-            catch (_err) {
-                // Ignore list error and fail/prompt below
-            }
-        }
-        if (!fileId) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'File ID is required.',
-                detail: 'Specify --file <fid>.',
-            });
-            process.exit(1);
-        }
-        let name = options.name;
-        if (!name && process.stdout.isTTY) {
-            name = await askInput('Enter catalog entry name:');
-        }
-        if (!name) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'Name is required.',
-                detail: 'Specify --name <name>.',
-            });
-            process.exit(1);
-        }
-        let description = options.description;
-        if (!description && process.stdout.isTTY) {
-            description = await askInput('Enter catalog entry description:');
-        }
-        if (!description) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'Description is required.',
-                detail: 'Specify --description <desc>.',
-            });
-            process.exit(1);
-        }
-        let scope = options.scope;
-        if (!scope && process.stdout.isTTY) {
-            scope = await askSelect('Select publish scope:', [
-                { name: 'Public (public)', value: 'public' },
-                { name: 'Organization (organization)', value: 'organization' },
-                { name: 'Private (private)', value: 'private' },
-            ]);
-        }
-        if (!scope) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'Scope is required.',
-                detail: 'Specify --scope <scope> (allowed: public, organization, private).',
-            });
-            process.exit(1);
-        }
-        const allowedScopes = ['public', 'organization', 'private'];
-        if (!allowedScopes.includes(scope)) {
-            formatter.error({
-                code: CliErrorCode.INVALID_ARGUMENT,
-                message: `Invalid scope '${scope}'.`,
-                detail: `Allowed: ${allowedScopes.join(', ')}`,
-            });
-            process.exit(1);
-        }
-        let version = options.catalogVersion;
-        if (!version && process.stdout.isTTY) {
-            version = await askInput('Enter semantic version:', '1.0.0');
-        }
-        if (!version) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'Version is required.',
-                detail: 'Specify --catalog-version <ver> or -v <ver>.',
-            });
-            process.exit(1);
-        }
-        const allowedLifecycles = ['dev', 'beta', 'stable'];
-        if (!allowedLifecycles.includes(options.lifecycle)) {
-            formatter.error({
-                code: CliErrorCode.INVALID_ARGUMENT,
-                message: `Invalid lifecycle '${options.lifecycle}'.`,
-                detail: `Allowed: ${allowedLifecycles.join(', ')}`,
-            });
-            process.exit(1);
-        }
-        try {
-            const client = getSdkClient();
-            let catalogId = null;
-            try {
-                const status = await client.dataCatalog.checkPublicationStatus(fileId, orgId, {
-                    token: client.token,
-                });
-                catalogId = status.key;
-            }
-            catch (err) {
-                const apiErr = handleApiError(err);
-                if (apiErr.status !== 404) {
-                    throw err;
-                }
-            }
-            if (!catalogId) {
-                if (config.resolved.format !== 'json') {
-                    console.log('Catalog entry does not exist. Creating new catalog entry...');
-                }
-                const entry = {
-                    key: '',
-                    kind: DataCatalogKind,
-                    organization: orgId,
-                    file: fileId,
-                    scope: scope,
-                    name: name,
-                    description: description,
-                    publishedBy: '',
-                    publishedAt: 0,
-                    createdAt: 0,
-                    updatedAt: 0,
-                    tags: [],
-                };
-                const createdRecord = await client.dataCatalog.publish(entry, { token: client.token });
-                catalogId = createdRecord.key;
-            }
-            else {
-                if (config.resolved.format !== 'json') {
-                    console.log(`Catalog entry already exists (ID: ${catalogId}). Publishing new version...`);
-                }
-            }
-            const versionPayload = DataCatalogVersion.createSchema({
-                scope: scope,
-                lifecycle: options.lifecycle,
-                version: version,
-                changelog: options.changelog || undefined,
-            });
-            const versionData = await client.dataCatalog.publishVersion(catalogId, versionPayload, {
-                token: client.token,
-            });
-            formatter.success(`Successfully published version '${version}' to the data catalog!`, versionData);
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-    catalogCmd
-        .command('list')
-        .description('List published data catalog items or versions of a specific catalog entry')
-        .option('--scope <scope>', 'Filter by scope: all, public, organization, private', 'all')
-        .option('--org <oid>', 'Organization ID (optional, defaults to configured default org)')
-        .option('--key <key>', 'Data catalog item key to list all versions of a specific data domain')
-        .action(async (options) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        const resolved = config.resolved;
-        const orgId = options.org || resolved.org;
-        const allowedScopes = ['all', 'public', 'organization', 'private'];
-        if (!allowedScopes.includes(options.scope)) {
-            formatter.error({
-                message: `Invalid scope '${options.scope}'. Allowed: ${allowedScopes.join(', ')}`,
-            });
-            process.exit(1);
-        }
-        if (['organization', 'private'].includes(options.scope) && !orgId) {
-            formatter.error({
-                message: `Organization ID (--org <oid>) is required when filtering by scope '${options.scope}'.`,
-            });
-            process.exit(1);
-        }
-        try {
-            const client = getSdkClient();
-            if (options.key) {
-                const res = await client.dataCatalog.listVersions(options.key, { token: client.token });
-                const versions = res.data || [];
-                const rows = versions.map((v) => ({
-                    key: v.key,
-                    version: v.version,
-                    published: new Date(v.published).toLocaleString(),
-                }));
-                formatter.list(rows, ['key', 'version', 'published'], {
-                    headers: ['VERSION KEY', 'VERSION', 'PUBLISHED AT'],
-                });
-            }
-            else {
-                const results = [];
-                if (options.scope === 'all') {
-                    const resPublic = await client.dataCatalog.list({ scope: 'public', oid: orgId }, { token: client.token });
-                    results.push(...(resPublic.data || []));
-                    if (orgId) {
-                        try {
-                            const resOrg = await client.dataCatalog.list({ scope: 'organization', oid: orgId }, { token: client.token });
-                            results.push(...(resOrg.data || []));
-                        }
-                        catch {
-                            // Ignore if organization query fails
-                        }
-                        try {
-                            const resPrivate = await client.dataCatalog.list({ scope: 'private', oid: orgId }, { token: client.token });
-                            results.push(...(resPrivate.data || []));
-                        }
-                        catch {
-                            // Ignore if private query fails
-                        }
-                    }
-                }
-                else {
-                    const res = await client.dataCatalog.list({ scope: options.scope, oid: orgId }, { token: client.token });
-                    results.push(...(res.data || []));
-                }
-                const seen = new Set();
-                const uniqueResults = results.filter((item) => {
-                    const key = item.key;
-                    if (seen.has(key))
-                        return false;
-                    seen.add(key);
-                    return true;
-                });
-                const rows = uniqueResults.map((item) => {
-                    const lastVersion = item.versions && item.versions[0] ? item.versions[0].version : 'N/A';
-                    return {
-                        key: item.key,
-                        name: item.name,
-                        scope: item.scope,
-                        lastVersion,
-                        organization: item.organization || 'N/A',
-                    };
-                });
-                formatter.list(rows, ['key', 'name', 'scope', 'lastVersion', 'organization'], {
-                    headers: ['KEY', 'NAME', 'SCOPE', 'LAST VERSION', 'ORGANIZATION'],
-                });
-            }
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-}

package/dist/commands/config.js

@@ -1,59 +0,0 @@
-import { config } from '../utils/config.js';
-import { Formatter, CliErrorCode } from '../utils/formatter.js';
-/**
- * Registers configuration management commands with the main Commander program.
- *
- * @param program - The root Commander program.
- */
-export function registerConfigCommands(program) {
-    const configCmd = program.command('config').description('Manage CLI configuration settings');
-    configCmd
-        .command('get <key>')
-        .description('Get a configuration value')
-        .action((key) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        const configObj = config.resolved;
-        if (key in configObj) {
-            const val = configObj[key];
-            if (config.resolved.format === 'json') {
-                formatter.object({ [key]: val });
-            }
-            else {
-                console.log(val);
-            }
-        }
-        else {
-            formatter.error({
-                code: CliErrorCode.INVALID_ARGUMENT,
-                message: `Configuration key '${key}' not found.`,
-                detail: `Run \`apinow config set ${key} <value>\` to define it.`,
-            });
-            process.exit(1);
-        }
-    });
-    configCmd
-        .command('set <key> <value>')
-        .description('Set a configuration value')
-        .action((key, value) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        const allowedKeys = ['apiUrl', 'token', 'org'];
-        if (!allowedKeys.includes(key)) {
-            formatter.error({
-                code: CliErrorCode.INVALID_ARGUMENT,
-                message: `Invalid configuration key '${key}'.`,
-                detail: `Allowed keys: ${allowedKeys.join(', ')}`,
-            });
-            process.exit(1);
-        }
-        config.writeProperty(key, value);
-        formatter.success(`Configuration '${key}' set to '${value}'.`);
-    });
-    configCmd
-        .command('reset')
-        .description('Reset all configuration settings and remove stored files')
-        .action(() => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        config.reset();
-        formatter.success('Configuration has been reset successfully.');
-    });
-}