@purveyors/cli 0.9.6 → 0.14.0

package/dist/lib/errors.d.ts

@@ -1,3 +1,13 @@
+export declare const EXIT_CODES: {
+    readonly OK: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly INVALID_ARGUMENT: 2;
+    readonly AUTH_ERROR: 3;
+    readonly NOT_FOUND: 4;
+    readonly DEPENDENCY_CONFLICT: 5;
+    readonly CONFIG_ERROR: 6;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
 export declare class PrvrsError extends Error {
     readonly code: string;
     readonly details?: unknown;
@@ -9,8 +19,10 @@ export declare class AuthError extends PrvrsError {
 export declare class ConfigError extends PrvrsError {
     constructor(message: string, details?: unknown);
 }
+export declare function normalizeCliError(error: unknown): unknown;
+export declare function exitCodeForError(error: unknown): ExitCode;
 /**
- * Print a formatted error to stderr and exit with code 1.
+ * Print a formatted error to stderr and exit with a structured exit code.
  */
 export declare function fatal(error: unknown): never;
 /**

package/dist/lib/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEtB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAM7D;AAED,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAe3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EACnD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAChC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ/B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,UAAU;;;;;;;;CAQb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAoBpE,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEtB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAM7D;AAED,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAWD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAczD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAYzD;AAqGD;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA4B3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EACnD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAChC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ/B"}

package/dist/lib/errors.js

@@ -1,4 +1,32 @@
 import chalk from 'chalk';
+import { CommanderError } from 'commander';
+import { ZodError } from 'zod';
+import { formatStructuredOutput, outputOptionsFromArgv, shouldUseInteractiveOutput, } from './output.js';
+export const EXIT_CODES = {
+    OK: 0,
+    GENERAL_ERROR: 1,
+    INVALID_ARGUMENT: 2,
+    AUTH_ERROR: 3,
+    NOT_FOUND: 4,
+    DEPENDENCY_CONFLICT: 5,
+    CONFIG_ERROR: 6,
+};
+const PRVRS_ERROR_EXIT_CODES = {
+    INVALID_ARGUMENT: EXIT_CODES.INVALID_ARGUMENT,
+    AUTH_ERROR: EXIT_CODES.AUTH_ERROR,
+    NOT_FOUND: EXIT_CODES.NOT_FOUND,
+    DEPENDENCY_CONFLICT: EXIT_CODES.DEPENDENCY_CONFLICT,
+    CONFIG_ERROR: EXIT_CODES.CONFIG_ERROR,
+};
+const COMMANDER_INVALID_ARGUMENT_CODES = new Set([
+    'commander.invalidArgument',
+    'commander.missingArgument',
+    'commander.optionMissingArgument',
+    'commander.missingMandatoryOptionValue',
+    'commander.unknownOption',
+    'commander.unknownCommand',
+    'commander.excessArguments',
+]);
 export class PrvrsError extends Error {
     code;
     details;
@@ -21,26 +49,141 @@ export class ConfigError extends PrvrsError {
         this.name = 'ConfigError';
     }
 }
+function normalizeCommanderErrorMessage(message) {
+    const normalized = message.replace(/^error:\s*/i, '').trim();
+    if (!normalized) {
+        return 'Commander parse error';
+    }
+    return normalized.charAt(0).toUpperCase() + normalized.slice(1);
+}
+export function normalizeCliError(error) {
+    if (!(error instanceof CommanderError)) {
+        return error;
+    }
+    const code = COMMANDER_INVALID_ARGUMENT_CODES.has(error.code)
+        ? 'INVALID_ARGUMENT'
+        : 'GENERAL_ERROR';
+    return new PrvrsError(code, normalizeCommanderErrorMessage(error.message), {
+        commanderCode: error.code,
+        commanderExitCode: error.exitCode,
+        ...(error.nestedError ? { nestedError: error.nestedError } : {}),
+    });
+}
+export function exitCodeForError(error) {
+    const normalized = normalizeCliError(error);
+    if (normalized instanceof PrvrsError) {
+        return PRVRS_ERROR_EXIT_CODES[normalized.code] ?? EXIT_CODES.GENERAL_ERROR;
+    }
+    if (normalized instanceof ZodError) {
+        return EXIT_CODES.INVALID_ARGUMENT;
+    }
+    return EXIT_CODES.GENERAL_ERROR;
+}
+function errorCodeLabel(error) {
+    const normalized = normalizeCliError(error);
+    if (normalized instanceof PrvrsError) {
+        return normalized.code;
+    }
+    if (normalized instanceof ZodError) {
+        return 'INVALID_ARGUMENT';
+    }
+    return 'GENERAL_ERROR';
+}
+function formatZodErrorMessage(error) {
+    const issue = error.issues[0];
+    if (!issue) {
+        return 'Invalid arguments.';
+    }
+    const path = issue.path.length > 0 ? ` (${issue.path.join('.')})` : '';
+    return `Invalid argument${path}: ${issue.message}`;
+}
+function errorMessageForError(error) {
+    const normalized = normalizeCliError(error);
+    if (normalized instanceof PrvrsError) {
+        return normalized.message;
+    }
+    if (normalized instanceof ZodError) {
+        return formatZodErrorMessage(normalized);
+    }
+    if (normalized instanceof Error) {
+        return normalized.message;
+    }
+    return 'An unknown error occurred';
+}
+function errorDetailsForError(error) {
+    if (!process.env.PURVEY_DEBUG) {
+        return undefined;
+    }
+    const normalized = normalizeCliError(error);
+    if (normalized instanceof PrvrsError) {
+        return normalized.details;
+    }
+    if (normalized instanceof ZodError) {
+        return normalized.issues;
+    }
+    if (normalized instanceof Error && normalized.stack) {
+        return { stack: normalized.stack };
+    }
+    return undefined;
+}
+function buildCliErrorEnvelope(error) {
+    const envelope = {
+        error: true,
+        code: errorCodeLabel(error),
+        exitCode: exitCodeForError(error),
+        message: errorMessageForError(error),
+    };
+    const details = errorDetailsForError(error);
+    if (details !== undefined) {
+        envelope.details = details;
+    }
+    return envelope;
+}
+function shouldUseStructuredErrorOutput(argv = process.argv) {
+    const options = outputOptionsFromArgv(argv);
+    // Keep human-readable errors only when the whole invocation is interactive.
+    // If either stdout or stderr is redirected, prefer the machine contract.
+    const isFullyInteractive = Boolean(process.stdout.isTTY && process.stderr.isTTY);
+    return !shouldUseInteractiveOutput(options, isFullyInteractive);
+}
+function writeStructuredError(error, argv = process.argv) {
+    const options = outputOptionsFromArgv(argv);
+    const formatted = formatStructuredOutput(buildCliErrorEnvelope(error), {
+        pretty: options.pretty,
+    });
+    process.stderr.write(`${formatted}\n`);
+}
 /**
- * Print a formatted error to stderr and exit with code 1.
+ * Print a formatted error to stderr and exit with a structured exit code.
  */
 export function fatal(error) {
-    if (error instanceof PrvrsError) {
-        console.error(chalk.red(`✖ ${error.message}`));
-        if (process.env.PURVEY_DEBUG && error.details) {
-            console.error(chalk.dim('Details:'), error.details);
+    const normalized = normalizeCliError(error);
+    if (shouldUseStructuredErrorOutput()) {
+        writeStructuredError(normalized);
+        process.exit(exitCodeForError(normalized));
+    }
+    if (normalized instanceof PrvrsError) {
+        console.error(chalk.red(`✖ ${normalized.message}`));
+        if (process.env.PURVEY_DEBUG && normalized.details) {
+            console.error(chalk.dim('Details:'), normalized.details);
+        }
+    }
+    else if (normalized instanceof ZodError) {
+        console.error(chalk.red(`✖ ${formatZodErrorMessage(normalized)}`));
+        if (process.env.PURVEY_DEBUG) {
+            console.error(chalk.dim(JSON.stringify(normalized.issues, null, 2)));
         }
     }
-    else if (error instanceof Error) {
-        console.error(chalk.red(`✖ ${error.message}`));
-        if (process.env.PURVEY_DEBUG && error.stack) {
-            console.error(chalk.dim(error.stack));
+    else if (normalized instanceof Error) {
+        console.error(chalk.red(`✖ ${normalized.message}`));
+        if (process.env.PURVEY_DEBUG && normalized.stack) {
+            console.error(chalk.dim(normalized.stack));
         }
     }
     else {
         console.error(chalk.red('✖ An unknown error occurred'));
     }
-    process.exit(1);
+    process.exit(exitCodeForError(normalized));
 }
 /**
  * Wrap an async command handler to catch and format errors.

package/dist/lib/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,IAAI,CAAS;IACb,OAAO,CAAW;IAElC,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAiC;IAEjC,OAAO,KAAK,EAAE,GAAG,IAAO,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,KAAK,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"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"}

package/dist/lib/index.d.ts

@@ -1,5 +1,6 @@
 export * from './catalog.js';
 export * from './inventory.js';
+export * from './manifest.js';
 export * from './roast.js';
 export * from './sales.js';
 export * from './tasting.js';

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAMA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAMA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/lib/index.js

@@ -5,6 +5,7 @@
 //   import { listInventory } from '@purveyors/cli/inventory'
 export * from './catalog.js';
 export * from './inventory.js';
+export * from './manifest.js';
 export * from './roast.js';
 export * from './sales.js';
 export * from './tasting.js';

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2EAA2E;AAC3E,qCAAqC;AACrC,2DAA2D;AAC3D,6DAA6D;AAE7D,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2EAA2E;AAC3E,qCAAqC;AACrC,2DAA2D;AAC3D,6DAA6D;AAE7D,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/lib/manifest.d.ts

@@ -0,0 +1,100 @@
+export type CliAuthRequirement = 'none' | 'viewer' | 'member';
+export type CliOutputMode = 'json' | 'pretty' | 'csv';
+export interface CliDocLink {
+    label: string;
+    url: string;
+}
+export interface CliRoleContract {
+    role: 'viewer' | 'member';
+    description: string;
+}
+export interface CliOutputModeContract {
+    mode: CliOutputMode;
+    description: string;
+}
+export interface CliExitCodeContract {
+    exitCode: number;
+    code: string;
+    description: string;
+}
+export interface CliIdContract {
+    name: string;
+    source: string;
+    usedBy: string[];
+    note?: string;
+}
+export interface CliOptionContract {
+    flags: string;
+    description?: string;
+    defaultValue?: string | number | boolean;
+    requiredInFlagMode?: boolean;
+    notes?: string[];
+}
+export interface CliArgumentContract {
+    name: string;
+    cliToken?: string;
+    description: string;
+    required: boolean;
+    idType?: string;
+}
+export interface CliStructuredErrorContract {
+    channel: 'stderr';
+    guaranteedFields: string[];
+    optionalFields: string[];
+    when: string;
+    exception?: string;
+}
+export interface CliCommandContract {
+    name: string;
+    summary: string;
+    auth: CliAuthRequirement;
+    arguments?: CliArgumentContract[];
+    options?: CliOptionContract[];
+    notes?: string[];
+    examples?: string[];
+}
+export interface CliCommandGroupContract {
+    name: string;
+    summary: string;
+    auth: CliAuthRequirement | 'mixed';
+    command?: CliCommandContract;
+    subcommands?: CliCommandContract[];
+}
+export interface CliWorkflowContract {
+    title: string;
+    commands: string[];
+}
+export interface CliErrorPatternContract {
+    title: string;
+    exitCodes: number[];
+    guidance: string[];
+}
+export interface CliManifest {
+    schemaVersion: '1';
+    binary: string;
+    packageName: string;
+    description: string;
+    nodeVersion: string;
+    files: {
+        credentials: string;
+        config: string;
+    };
+    docs: CliDocLink[];
+    roles: CliRoleContract[];
+    globalOptions: CliOptionContract[];
+    outputModes: CliOutputModeContract[];
+    outputContract: {
+        stdout: string;
+        stderr: string;
+        notes: string[];
+        structuredErrors: CliStructuredErrorContract;
+    };
+    exitCodes: CliExitCodeContract[];
+    idTypes: CliIdContract[];
+    commandGroups: CliCommandGroupContract[];
+    workflows: CliWorkflowContract[];
+    errorPatterns: CliErrorPatternContract[];
+}
+export declare function getCliManifest(): CliManifest;
+export declare function renderContextText(manifest?: CliManifest): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/lib/manifest.d.ts.map

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