@api-now/cli 1.0.4 → 1.1.0

package/dist/commands/files.js

@@ -1,293 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { getSdkClient, handleApiError } from '../utils/api.js';
-import { config } from '../utils/config.js';
-import { Formatter, CliErrorCode } from '../utils/formatter.js';
-import { ApiFileKind, DomainFileKind, FolderKind } from '@api-now/core/models/kinds.js';
-import { File } from '@api-now/core/models/index.js';
-import { askInput, askSelect } from '../utils/prompt.js';
-/**
- * Registers files management commands (list, create, read) with the main Commander program.
- *
- * @param program - The root Commander program.
- */
-export function registerFilesCommands(program) {
-    const filesCmd = program.command('files').description('Manage files and metadata');
-    filesCmd
-        .command('list')
-        .description('List files in an organization')
-        .option('--org <oid>', 'Organization ID (optional, defaults to configured default org)')
-        .option('--kind <kind>', 'Filter by file kind (e.g. domain, api, folder)')
-        .option('--parent <parent>', 'Filter by parent folder ID')
-        .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);
-        }
-        try {
-            const client = getSdkClient();
-            const listOpts = {};
-            if (options.parent) {
-                listOpts.parent = options.parent;
-            }
-            if (options.kind) {
-                const targetKind = getFileMetaKind(options.kind);
-                listOpts.filter = {
-                    field: 'kind',
-                    operator: 'eq',
-                    value: targetKind,
-                };
-            }
-            const res = await client.files.list(orgId, listOpts, { token: client.token });
-            const files = res.data || [];
-            const rows = files.map((f) => ({
-                id: f.key,
-                name: f.info?.name || '',
-                kind: f.kind,
-                isShortcut: f.isShortcut ? 'Yes' : 'No',
-            }));
-            formatter.list(rows, ['id', 'name', 'kind', 'isShortcut'], {
-                headers: ['ID', 'NAME', 'KIND', 'SHORTCUT'],
-            });
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-    filesCmd
-        .command('create')
-        .description('Create a new file metadata record (and optionally upload media)')
-        .option('--name <name>', 'Name of the file')
-        .option('--kind <kind>', 'Kind of the file (e.g., domain, api)')
-        .option('--org <oid>', 'Organization ID (optional, defaults to configured default org)')
-        .option('--parent <parent>', 'Parent folder ID')
-        .option('--media <path>', 'Local path to the file content/media to upload')
-        .option('--stdin', 'Read media content from STDIN')
-        .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);
-        }
-        if (options.media && options.stdin) {
-            formatter.error({
-                code: CliErrorCode.INVALID_ARGUMENT,
-                message: 'Cannot specify both --media <path> and --stdin',
-            });
-            process.exit(1);
-        }
-        // Empathic interactive fallbacks
-        let name = options.name;
-        if (!name && process.stdout.isTTY) {
-            name = await askInput('Enter file name:');
-        }
-        if (!name) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'Name is required.',
-                detail: 'Specify --name <name>.',
-            });
-            process.exit(1);
-        }
-        let kind = options.kind;
-        if (!kind && process.stdout.isTTY) {
-            kind = await askSelect('Select file kind:', [
-                { name: 'API Domain / Schema (domain)', value: 'domain' },
-                { name: 'API Schema (api)', value: 'api' },
-                { name: 'Folder (folder)', value: 'folder' },
-            ]);
-        }
-        if (!kind) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'Kind is required.',
-                detail: 'Specify --kind <kind> (allowed: api, domain, folder).',
-            });
-            process.exit(1);
-        }
-        try {
-            let mediaContent;
-            if (options.media) {
-                const filePath = path.resolve(options.media);
-                if (!fs.existsSync(filePath)) {
-                    formatter.error({
-                        code: CliErrorCode.INVALID_ARGUMENT,
-                        message: `Media file not found at path: ${filePath}`,
-                    });
-                    process.exit(1);
-                }
-                mediaContent = fs.readFileSync(filePath, 'utf8');
-            }
-            else if (options.stdin) {
-                mediaContent = await readStdin();
-            }
-            let fileKey;
-            let fileContent;
-            if (mediaContent !== undefined) {
-                try {
-                    fileContent = JSON.parse(mediaContent);
-                }
-                catch {
-                    throw new Error('invalid API now platform file');
-                }
-                if (!fileContent ||
-                    typeof fileContent !== 'object' ||
-                    Array.isArray(fileContent) ||
-                    !('key' in fileContent) ||
-                    typeof fileContent.key !== 'string' ||
-                    !fileContent.key.trim()) {
-                    throw new Error('invalid API now platform file');
-                }
-                fileKey = fileContent.key;
-            }
-            const client = getSdkClient();
-            const fileMeta = File.createSchema({
-                kind: getFileMetaKind(kind),
-                info: {
-                    name,
-                },
-                key: fileKey,
-            });
-            const createOpts = {};
-            if (options.parent) {
-                createOpts.parent = options.parent;
-            }
-            const file = await client.files.createMeta(fileMeta, orgId, createOpts, { token: client.token });
-            const fileId = file.key;
-            if (mediaContent !== undefined) {
-                await client.files.createMedia(fileContent, orgId, fileId, {}, { token: client.token });
-            }
-            formatter.success('File created successfully!', file);
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error({
-                code: CliErrorCode.API_FAILURE,
-                ...apiErr,
-            });
-            process.exit(1);
-        }
-    });
-    filesCmd
-        .command('read')
-        .description('Read file metadata or media content')
-        .option('--id <fid>', 'File ID')
-        .option('--org <oid>', 'Organization ID (optional, defaults to configured default org)')
-        .option('--meta', 'Read file metadata (default)')
-        .option('--media', 'Read file media/content')
-        .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);
-        }
-        let id = options.id;
-        if (!id && process.stdout.isTTY) {
-            try {
-                const client = getSdkClient();
-                const res = await client.files.list(orgId, {}, { token: client.token });
-                const files = res.data || [];
-                if (files.length > 0) {
-                    id = await askSelect('Select a file to read:', files.map((f) => ({
-                        name: `${f.info?.name || 'Unnamed'} (${f.kind})`,
-                        value: f.key,
-                    })));
-                }
-            }
-            catch (_err) {
-                // Ignore and let standard missing error handle below
-            }
-        }
-        if (!id) {
-            formatter.error({
-                code: CliErrorCode.MISSING_REQUIRED,
-                message: 'File ID is required.',
-                detail: 'Specify --id <fid>.',
-            });
-            process.exit(1);
-        }
-        try {
-            const client = getSdkClient();
-            if (options.media) {
-                const res = await client.files.readMedia(orgId, id, { token: client.token });
-                const content = res.media;
-                if (resolved.format === 'json') {
-                    console.log(JSON.stringify(content, null, 2));
-                }
-                else {
-                    if (typeof content === 'object' && content !== null) {
-                        console.log(JSON.stringify(content, null, 2));
-                    }
-                    else {
-                        console.log(content);
-                    }
-                }
-            }
-            else {
-                const meta = await client.files.read(orgId, id, { token: client.token });
-                formatter.object(meta);
-            }
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-}
-/**
- * Translates a user-friendly kind name (e.g. 'api', 'domain', 'folder')
- * to the corresponding core platform file metadata Kind value.
- */
-function getFileMetaKind(kind) {
-    const k = kind.toLowerCase();
-    if (k === 'api') {
-        return ApiFileKind;
-    }
-    if (k === 'domain') {
-        return DomainFileKind;
-    }
-    if (k === 'folder') {
-        return FolderKind;
-    }
-    throw new Error(`Unsupported file kind "${kind}". Allowed: api, domain, folder`);
-}
-/**
- * Asynchronously reads all input from standard input (STDIN).
- */
-async function readStdin() {
-    return new Promise((resolve, reject) => {
-        let data = '';
-        process.stdin.setEncoding('utf8');
-        process.stdin.on('data', (chunk) => {
-            data += chunk;
-        });
-        process.stdin.on('end', () => {
-            resolve(data);
-        });
-        process.stdin.on('error', (err) => {
-            reject(err);
-        });
-    });
-}

package/dist/commands/orgs.js

@@ -1,104 +0,0 @@
-import { getSdkClient, handleApiError } from '../utils/api.js';
-import { config } from '../utils/config.js';
-import { Formatter, CliErrorCode } from '../utils/formatter.js';
-/**
- * Registers organization commands (list, set-default) with the main Commander program.
- *
- * @param program - The root Commander program.
- */
-export function registerOrgsCommands(program) {
-    const orgsCmd = program.command('orgs').description('Manage organization configurations');
-    orgsCmd
-        .command('list')
-        .description('List all organizations you belong to')
-        .action(async () => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        try {
-            const client = getSdkClient();
-            const res = await client.organizations.list({ token: client.token });
-            const orgs = res.data || [];
-            const resolved = config.resolved;
-            const rows = orgs.map((org) => ({
-                id: org.key,
-                name: org.name,
-                slug: org.slug,
-                isDefault: org.key === resolved.org ? 'Yes' : 'No',
-            }));
-            formatter.list(rows, ['id', 'name', 'slug', 'isDefault'], {
-                headers: ['ID', 'NAME', 'SLUG', 'DEFAULT'],
-            });
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-    orgsCmd
-        .command('set-default <oid>')
-        .description('Set your default organization ID')
-        .action(async (oid) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        try {
-            const client = getSdkClient();
-            const res = await client.organizations.list({ token: client.token });
-            const orgs = res.data || [];
-            const exists = orgs.some((org) => org.key === oid);
-            if (!exists) {
-                formatter.error({
-                    code: CliErrorCode.INVALID_ARGUMENT,
-                    message: `Organization ID '${oid}' not found in your authorized list.`,
-                    detail: 'Run `apinow orgs list` to see all authorized organizations and their IDs.',
-                });
-                process.exit(1);
-            }
-            config.writeProperty('org', oid);
-            formatter.success(`Default organization ID set to '${oid}'.`);
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-    orgsCmd
-        .command('default')
-        .alias('get-default')
-        .description('Get the default configured organization')
-        .action(async () => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        try {
-            const resolved = config.resolved;
-            if (!resolved.org) {
-                formatter.error({
-                    code: CliErrorCode.MISSING_REQUIRED,
-                    message: 'No default organization configured.',
-                    detail: 'Set one using `apinow orgs set-default <oid>`. Run `apinow orgs list` to list available organizations.',
-                });
-                process.exit(1);
-            }
-            const client = getSdkClient();
-            const res = await client.organizations.list({ token: client.token });
-            const orgs = res.data || [];
-            const org = orgs.find((org) => org.key === resolved.org);
-            if (!org) {
-                formatter.error({
-                    code: CliErrorCode.INVALID_ARGUMENT,
-                    message: `Default organization ID '${resolved.org}' not found in your authorized list.`,
-                    detail: 'Run `apinow orgs set-default <oid>` to configure a valid default organization.',
-                });
-                process.exit(1);
-            }
-            formatter.object({
-                id: org.key,
-                name: org.name,
-                slug: org.slug,
-            });
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-}

package/dist/commands/tokens.js

@@ -1,145 +0,0 @@
-import { getSdkClient, handleApiError } from '../utils/api.js';
-import { config } from '../utils/config.js';
-import { Formatter, CliErrorCode, style } from '../utils/formatter.js';
-/**
- * Helper function to decode the active token and extract its ID (jti or id claim).
- *
- * @returns The active token's ID if available, otherwise null.
- */
-function getActiveTokenId() {
-    const token = config.resolved.token;
-    if (!token)
-        return null;
-    try {
-        const parts = token.split('.');
-        if (parts.length === 3) {
-            const payload = parts[1];
-            const decoded = Buffer.from(payload, 'base64url').toString('utf8');
-            const parsed = JSON.parse(decoded);
-            if (parsed && typeof parsed === 'object') {
-                return parsed.jti || parsed.id || null;
-            }
-        }
-    }
-    catch {
-        // Ignore and return null if decoding fails
-    }
-    return null;
-}
-/**
- * Registers personal access tokens commands (list, create, delete) under the auth command namespace.
- *
- * @param authCmd - The auth subcommand router.
- */
-export function registerTokensCommands(authCmd) {
-    const tokensCmd = authCmd.command('tokens').description('Manage personal access tokens');
-    tokensCmd
-        .command('list')
-        .description('List all personal access tokens')
-        .action(async () => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        try {
-            const client = getSdkClient();
-            if (!client.token) {
-                formatter.error({
-                    code: CliErrorCode.UNAUTHORIZED,
-                    message: 'Not logged in.',
-                    detail: 'Use `apinow auth login <provider>` to authenticate.',
-                });
-                process.exit(1);
-            }
-            const tokens = await client.users.listTokens({ token: client.token });
-            const activeTokenId = getActiveTokenId();
-            const rows = tokens.map((token) => ({
-                id: token.id,
-                name: token.name || 'N/A',
-                lastUsedAt: token.lastUsedAt || 'Never',
-                expiresAt: token.expiresAt || 'Never',
-                active: token.id === activeTokenId ? 'Yes' : 'No',
-            }));
-            formatter.list(rows, ['id', 'name', 'lastUsedAt', 'expiresAt', 'active'], {
-                headers: ['ID', 'NAME', 'LAST USED', 'EXPIRES', 'ACTIVE'],
-            });
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-    tokensCmd
-        .command('create')
-        .description('Create a new personal access token')
-        .option('--name <name>', 'Optional name to identify the token')
-        .option('--expires-at <expires>', 'Optional expiration time (e.g. "30 days", "10 minutes", or timestamp)')
-        .action(async (options) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        try {
-            const client = getSdkClient();
-            if (!client.token) {
-                formatter.error({
-                    code: CliErrorCode.UNAUTHORIZED,
-                    message: 'Not logged in.',
-                    detail: 'Use `apinow auth login <provider>` to authenticate.',
-                });
-                process.exit(1);
-            }
-            const payload = {};
-            if (options.name) {
-                payload.name = options.name;
-            }
-            if (options.expiresAt) {
-                if (/^\d+$/.test(options.expiresAt)) {
-                    payload.expiresAt = parseInt(options.expiresAt, 10);
-                }
-                else {
-                    payload.expiresAt = options.expiresAt;
-                }
-            }
-            const res = await client.users.createToken(payload, { token: client.token });
-            if (config.resolved.format === 'json') {
-                formatter.success('Token created successfully!', res);
-            }
-            else {
-                formatter.success('Token created successfully!');
-                console.log('\n' +
-                    style.yellow('⚠ WARNING: Make sure to copy your personal access token now. You will NOT be able to see it again!') +
-                    '\n');
-                console.log(`${style.bold('Raw Token')}: ${style.cyan(res.token)}`);
-                console.log(`${style.bold('ID')}: ${res.id}`);
-                console.log(`${style.bold('Name')}: ${res.name || 'N/A'}`);
-                console.log(`${style.bold('Type')}: ${res.type}`);
-                console.log(`${style.bold('Expires At')}: ${res.expiresAt || 'Never'}\n`);
-            }
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-    tokensCmd
-        .command('delete <id>')
-        .description('Delete a personal access token by ID')
-        .action(async (id) => {
-        const formatter = new Formatter({ format: config.resolved.format });
-        try {
-            const client = getSdkClient();
-            if (!client.token) {
-                formatter.error({
-                    code: CliErrorCode.UNAUTHORIZED,
-                    message: 'Not logged in.',
-                    detail: 'Use `apinow auth login <provider>` to authenticate.',
-                });
-                process.exit(1);
-            }
-            await client.users.deleteToken(id, { token: client.token });
-            formatter.success(`Token '${id}' deleted successfully.`);
-        }
-        catch (err) {
-            const apiErr = handleApiError(err);
-            formatter.error(apiErr);
-            process.exit(1);
-        }
-    });
-}

package/dist/utils/api.js

@@ -1,54 +0,0 @@
-import { StoreSdk } from '@api-now/core/sdk/StoreSdkNode.js';
-import { config } from './config.js';
-import { CliErrorCode } from './formatter.js';
-/**
- * Configures and returns a StoreSdk instance for communicating with the API NOW! platform.
- * Reads the token from local configuration and configures it on the SDK automatically.
- *
- * @param options - Configuration overrides for the client connection.
- * @returns A StoreSdk instance ready for requests.
- */
-export function getSdkClient(options = {}) {
-    const resolved = config.resolved;
-    const apiUrl = options.apiUrl || resolved.apiUrl;
-    const sdk = new StoreSdk(apiUrl);
-    if (resolved.token) {
-        sdk.token = resolved.token;
-    }
-    return sdk;
-}
-/**
- * Standardizes raw error throws from the SDK into a consistent, readable format.
- *
- * @param error - The raw error object caught in a try/catch block.
- * @returns A standardized ApiErrorResponse object.
- */
-export function handleApiError(error) {
-    if (error && typeof error === 'object') {
-        const err = error;
-        const status = err.status;
-        const code = err.code;
-        let message = err.message || 'An unknown error occurred.';
-        const help = err.help;
-        if (status === 401) {
-            message = 'Unauthorized. Please login using `auth login`.';
-            return {
-                message,
-                status,
-                code: CliErrorCode.UNAUTHORIZED,
-                help,
-            };
-        }
-        return {
-            message,
-            status,
-            code: code || CliErrorCode.API_FAILURE,
-            help,
-        };
-    }
-    const err = error;
-    return {
-        message: err?.message || 'An unknown error occurred.',
-        code: CliErrorCode.UNKNOWN,
-    };
-}