@kaitranntt/ccs 6.7.0 → 6.7.1-dev.2

package/dist/errors/error-types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Custom error types for CCS CLI
+ *
+ * All custom errors extend CCSError which provides:
+ * - Standardized exit codes
+ * - Recoverable flag for retry logic
+ * - Consistent error formatting
+ */
+import { ExitCode } from './exit-codes';
+/**
+ * Base error class for all CCS errors
+ * Extends standard Error with exit code and recovery information
+ */
+export declare class CCSError extends Error {
+    readonly code: ExitCode;
+    readonly recoverable: boolean;
+    constructor(message: string, code?: ExitCode, recoverable?: boolean);
+}
+/**
+ * Configuration-related errors
+ * Examples: missing config file, invalid JSON, corrupt settings
+ */
+export declare class ConfigError extends CCSError {
+    readonly configPath?: string | undefined;
+    constructor(message: string, configPath?: string | undefined);
+}
+/**
+ * Network-related errors
+ * Examples: connection refused, timeout, DNS resolution failure
+ */
+export declare class NetworkError extends CCSError {
+    readonly url?: string | undefined;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, url?: string | undefined, statusCode?: number | undefined);
+}
+/**
+ * Authentication/authorization errors
+ * Examples: invalid API key, expired token, insufficient permissions
+ */
+export declare class AuthError extends CCSError {
+    readonly provider?: string | undefined;
+    constructor(message: string, provider?: string | undefined);
+}
+/**
+ * Binary/executable errors
+ * Examples: Claude CLI not found, corrupted binary, permission denied
+ */
+export declare class BinaryError extends CCSError {
+    readonly binaryPath?: string | undefined;
+    constructor(message: string, binaryPath?: string | undefined);
+}
+/**
+ * Provider-specific errors
+ * Examples: API rate limit, service unavailable, invalid model
+ */
+export declare class ProviderError extends CCSError {
+    readonly provider: string;
+    readonly details?: unknown;
+    constructor(message: string, provider: string, details?: unknown);
+}
+/**
+ * Profile-related errors
+ * Examples: profile not found, invalid profile name, duplicate profile
+ */
+export declare class ProfileError extends CCSError {
+    readonly profileName?: string | undefined;
+    readonly availableProfiles?: string[] | undefined;
+    constructor(message: string, profileName?: string | undefined, availableProfiles?: string[] | undefined);
+}
+/**
+ * Proxy-related errors
+ * Examples: proxy startup failure, port conflict, proxy timeout
+ */
+export declare class ProxyError extends CCSError {
+    readonly port?: number | undefined;
+    constructor(message: string, port?: number | undefined);
+}
+/**
+ * Migration-related errors
+ * Examples: failed to migrate config, backup creation failed
+ */
+export declare class MigrationError extends CCSError {
+    readonly fromVersion?: string | undefined;
+    readonly toVersion?: string | undefined;
+    constructor(message: string, fromVersion?: string | undefined, toVersion?: string | undefined);
+}
+/**
+ * User abort error (Ctrl+C, SIGINT)
+ * Used when user explicitly cancels an operation
+ */
+export declare class UserAbortError extends CCSError {
+    constructor(message?: string);
+}
+/**
+ * Type guard to check if an error is a CCSError
+ */
+export declare function isCCSError(error: unknown): error is CCSError;
+/**
+ * Type guard to check if an error is recoverable
+ */
+export declare function isRecoverableError(error: unknown): boolean;
+//# sourceMappingURL=error-types.d.ts.map

package/dist/errors/error-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-types.d.ts","sourceRoot":"","sources":["../../src/errors/error-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,IAAI,EAAE,QAAQ;aACd,WAAW,EAAE,OAAO;gBAFpC,OAAO,EAAE,MAAM,EACC,IAAI,GAAE,QAAiC,EACvC,WAAW,GAAE,OAAe;CAS/C;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,QAAQ;aAGrB,UAAU,CAAC;gBAD3B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,oBAAQ;CAKtC;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,GAAG,CAAC;aACJ,UAAU,CAAC;gBAF3B,OAAO,EAAE,MAAM,EACC,GAAG,CAAC,oBAAQ,EACZ,UAAU,CAAC,oBAAQ;CAKtC;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,QAAQ;aAGnB,QAAQ,CAAC;gBADzB,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,oBAAQ;CAKpC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,QAAQ;aAGrB,UAAU,CAAC;gBAD3B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,oBAAQ;CAKtC;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,QAAQ;aAGvB,QAAQ,EAAE,MAAM;aAChB,OAAO,CAAC;gBAFxB,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,SAAS;CAKpC;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,WAAW,CAAC;aACZ,iBAAiB,CAAC;gBAFlC,OAAO,EAAE,MAAM,EACC,WAAW,CAAC,oBAAQ,EACpB,iBAAiB,CAAC,sBAAU;CAK/C;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,QAAQ;aAGpB,IAAI,CAAC;gBADrB,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,oBAAQ;CAKhC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;aAGxB,WAAW,CAAC;aACZ,SAAS,CAAC;gBAF1B,OAAO,EAAE,MAAM,EACC,WAAW,CAAC,oBAAQ,EACpB,SAAS,CAAC,oBAAQ;CAKrC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAAsC;CAI5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D"}

package/dist/errors/error-types.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Custom error types for CCS CLI
+ *
+ * All custom errors extend CCSError which provides:
+ * - Standardized exit codes
+ * - Recoverable flag for retry logic
+ * - Consistent error formatting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecoverableError = exports.isCCSError = exports.UserAbortError = exports.MigrationError = exports.ProxyError = exports.ProfileError = exports.ProviderError = exports.BinaryError = exports.AuthError = exports.NetworkError = exports.ConfigError = exports.CCSError = void 0;
+const exit_codes_1 = require("./exit-codes");
+/**
+ * Base error class for all CCS errors
+ * Extends standard Error with exit code and recovery information
+ */
+class CCSError extends Error {
+    constructor(message, code = exit_codes_1.ExitCode.GENERAL_ERROR, recoverable = false) {
+        super(message);
+        this.code = code;
+        this.recoverable = recoverable;
+        this.name = 'CCSError';
+        // Maintain proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.CCSError = CCSError;
+/**
+ * Configuration-related errors
+ * Examples: missing config file, invalid JSON, corrupt settings
+ */
+class ConfigError extends CCSError {
+    constructor(message, configPath) {
+        super(message, exit_codes_1.ExitCode.CONFIG_ERROR, false);
+        this.configPath = configPath;
+        this.name = 'ConfigError';
+    }
+}
+exports.ConfigError = ConfigError;
+/**
+ * Network-related errors
+ * Examples: connection refused, timeout, DNS resolution failure
+ */
+class NetworkError extends CCSError {
+    constructor(message, url, statusCode) {
+        super(message, exit_codes_1.ExitCode.NETWORK_ERROR, true); // Network errors are typically recoverable
+        this.url = url;
+        this.statusCode = statusCode;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Authentication/authorization errors
+ * Examples: invalid API key, expired token, insufficient permissions
+ */
+class AuthError extends CCSError {
+    constructor(message, provider) {
+        super(message, exit_codes_1.ExitCode.AUTH_ERROR, false);
+        this.provider = provider;
+        this.name = 'AuthError';
+    }
+}
+exports.AuthError = AuthError;
+/**
+ * Binary/executable errors
+ * Examples: Claude CLI not found, corrupted binary, permission denied
+ */
+class BinaryError extends CCSError {
+    constructor(message, binaryPath) {
+        super(message, exit_codes_1.ExitCode.BINARY_ERROR, false);
+        this.binaryPath = binaryPath;
+        this.name = 'BinaryError';
+    }
+}
+exports.BinaryError = BinaryError;
+/**
+ * Provider-specific errors
+ * Examples: API rate limit, service unavailable, invalid model
+ */
+class ProviderError extends CCSError {
+    constructor(message, provider, details) {
+        super(message, exit_codes_1.ExitCode.PROVIDER_ERROR, true); // Provider errors may be recoverable
+        this.provider = provider;
+        this.details = details;
+        this.name = 'ProviderError';
+    }
+}
+exports.ProviderError = ProviderError;
+/**
+ * Profile-related errors
+ * Examples: profile not found, invalid profile name, duplicate profile
+ */
+class ProfileError extends CCSError {
+    constructor(message, profileName, availableProfiles) {
+        super(message, exit_codes_1.ExitCode.PROFILE_ERROR, false);
+        this.profileName = profileName;
+        this.availableProfiles = availableProfiles;
+        this.name = 'ProfileError';
+    }
+}
+exports.ProfileError = ProfileError;
+/**
+ * Proxy-related errors
+ * Examples: proxy startup failure, port conflict, proxy timeout
+ */
+class ProxyError extends CCSError {
+    constructor(message, port) {
+        super(message, exit_codes_1.ExitCode.PROXY_ERROR, false);
+        this.port = port;
+        this.name = 'ProxyError';
+    }
+}
+exports.ProxyError = ProxyError;
+/**
+ * Migration-related errors
+ * Examples: failed to migrate config, backup creation failed
+ */
+class MigrationError extends CCSError {
+    constructor(message, fromVersion, toVersion) {
+        super(message, exit_codes_1.ExitCode.MIGRATION_ERROR, false);
+        this.fromVersion = fromVersion;
+        this.toVersion = toVersion;
+        this.name = 'MigrationError';
+    }
+}
+exports.MigrationError = MigrationError;
+/**
+ * User abort error (Ctrl+C, SIGINT)
+ * Used when user explicitly cancels an operation
+ */
+class UserAbortError extends CCSError {
+    constructor(message = 'Operation cancelled by user') {
+        super(message, exit_codes_1.ExitCode.USER_ABORT, false);
+        this.name = 'UserAbortError';
+    }
+}
+exports.UserAbortError = UserAbortError;
+/**
+ * Type guard to check if an error is a CCSError
+ */
+function isCCSError(error) {
+    return error instanceof CCSError;
+}
+exports.isCCSError = isCCSError;
+/**
+ * Type guard to check if an error is recoverable
+ */
+function isRecoverableError(error) {
+    if (isCCSError(error)) {
+        return error.recoverable;
+    }
+    return false;
+}
+exports.isRecoverableError = isRecoverableError;
+//# sourceMappingURL=error-types.js.map

package/dist/errors/error-types.js.map

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

package/dist/errors/exit-codes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Standardized exit codes for CCS CLI
+ *
+ * Exit codes follow Unix conventions:
+ * - 0: Success
+ * - 1-125: Application errors
+ * - 126-127: Command execution errors (reserved by shell)
+ * - 128+N: Signal termination (128 + signal number)
+ * - 130: SIGINT (Ctrl+C) - 128 + 2
+ */
+export declare enum ExitCode {
+    /** Successful execution */
+    SUCCESS = 0,
+    /** General/unspecified error */
+    GENERAL_ERROR = 1,
+    /** Configuration file errors (missing, invalid, corrupt) */
+    CONFIG_ERROR = 2,
+    /** Network-related errors (connection, timeout, DNS) */
+    NETWORK_ERROR = 3,
+    /** Authentication/authorization errors (invalid token, expired, forbidden) */
+    AUTH_ERROR = 4,
+    /** Binary/executable errors (missing Claude CLI, corrupted binary) */
+    BINARY_ERROR = 5,
+    /** Provider-specific errors (API errors, rate limits, service unavailable) */
+    PROVIDER_ERROR = 6,
+    /** Profile not found or invalid */
+    PROFILE_ERROR = 7,
+    /** Proxy-related errors (startup failure, port conflict) */
+    PROXY_ERROR = 8,
+    /** Migration errors (failed to migrate config) */
+    MIGRATION_ERROR = 9,
+    /** User aborted operation (Ctrl+C, SIGINT) */
+    USER_ABORT = 130
+}
+/**
+ * Human-readable descriptions for exit codes
+ * Used in error messages and documentation
+ */
+export declare const EXIT_CODE_DESCRIPTIONS: Record<ExitCode, string>;
+/**
+ * Check if an exit code indicates success
+ */
+export declare function isSuccess(code: ExitCode | number): boolean;
+/**
+ * Check if an exit code indicates a recoverable error
+ * (errors that might succeed on retry)
+ */
+export declare function isRecoverable(code: ExitCode | number): boolean;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/errors/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/errors/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oBAAY,QAAQ;IAClB,2BAA2B;IAC3B,OAAO,IAAI;IAEX,gCAAgC;IAChC,aAAa,IAAI;IAEjB,4DAA4D;IAC5D,YAAY,IAAI;IAEhB,wDAAwD;IACxD,aAAa,IAAI;IAEjB,8EAA8E;IAC9E,UAAU,IAAI;IAEd,sEAAsE;IACtE,YAAY,IAAI;IAEhB,8EAA8E;IAC9E,cAAc,IAAI;IAElB,mCAAmC;IACnC,aAAa,IAAI;IAEjB,4DAA4D;IAC5D,WAAW,IAAI;IAEf,kDAAkD;IAClD,eAAe,IAAI;IAEnB,8CAA8C;IAC9C,UAAU,MAAM;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAY3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAG9D"}

package/dist/errors/exit-codes.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Standardized exit codes for CCS CLI
+ *
+ * Exit codes follow Unix conventions:
+ * - 0: Success
+ * - 1-125: Application errors
+ * - 126-127: Command execution errors (reserved by shell)
+ * - 128+N: Signal termination (128 + signal number)
+ * - 130: SIGINT (Ctrl+C) - 128 + 2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecoverable = exports.isSuccess = exports.EXIT_CODE_DESCRIPTIONS = exports.ExitCode = void 0;
+var ExitCode;
+(function (ExitCode) {
+    /** Successful execution */
+    ExitCode[ExitCode["SUCCESS"] = 0] = "SUCCESS";
+    /** General/unspecified error */
+    ExitCode[ExitCode["GENERAL_ERROR"] = 1] = "GENERAL_ERROR";
+    /** Configuration file errors (missing, invalid, corrupt) */
+    ExitCode[ExitCode["CONFIG_ERROR"] = 2] = "CONFIG_ERROR";
+    /** Network-related errors (connection, timeout, DNS) */
+    ExitCode[ExitCode["NETWORK_ERROR"] = 3] = "NETWORK_ERROR";
+    /** Authentication/authorization errors (invalid token, expired, forbidden) */
+    ExitCode[ExitCode["AUTH_ERROR"] = 4] = "AUTH_ERROR";
+    /** Binary/executable errors (missing Claude CLI, corrupted binary) */
+    ExitCode[ExitCode["BINARY_ERROR"] = 5] = "BINARY_ERROR";
+    /** Provider-specific errors (API errors, rate limits, service unavailable) */
+    ExitCode[ExitCode["PROVIDER_ERROR"] = 6] = "PROVIDER_ERROR";
+    /** Profile not found or invalid */
+    ExitCode[ExitCode["PROFILE_ERROR"] = 7] = "PROFILE_ERROR";
+    /** Proxy-related errors (startup failure, port conflict) */
+    ExitCode[ExitCode["PROXY_ERROR"] = 8] = "PROXY_ERROR";
+    /** Migration errors (failed to migrate config) */
+    ExitCode[ExitCode["MIGRATION_ERROR"] = 9] = "MIGRATION_ERROR";
+    /** User aborted operation (Ctrl+C, SIGINT) */
+    ExitCode[ExitCode["USER_ABORT"] = 130] = "USER_ABORT";
+})(ExitCode || (exports.ExitCode = ExitCode = {}));
+/**
+ * Human-readable descriptions for exit codes
+ * Used in error messages and documentation
+ */
+exports.EXIT_CODE_DESCRIPTIONS = {
+    [ExitCode.SUCCESS]: 'Success',
+    [ExitCode.GENERAL_ERROR]: 'General error',
+    [ExitCode.CONFIG_ERROR]: 'Configuration error',
+    [ExitCode.NETWORK_ERROR]: 'Network error',
+    [ExitCode.AUTH_ERROR]: 'Authentication error',
+    [ExitCode.BINARY_ERROR]: 'Binary/executable error',
+    [ExitCode.PROVIDER_ERROR]: 'Provider error',
+    [ExitCode.PROFILE_ERROR]: 'Profile error',
+    [ExitCode.PROXY_ERROR]: 'Proxy error',
+    [ExitCode.MIGRATION_ERROR]: 'Migration error',
+    [ExitCode.USER_ABORT]: 'User abort (Ctrl+C)',
+};
+/**
+ * Check if an exit code indicates success
+ */
+function isSuccess(code) {
+    return code === ExitCode.SUCCESS;
+}
+exports.isSuccess = isSuccess;
+/**
+ * Check if an exit code indicates a recoverable error
+ * (errors that might succeed on retry)
+ */
+function isRecoverable(code) {
+    const recoverableCodes = [ExitCode.NETWORK_ERROR, ExitCode.PROVIDER_ERROR];
+    return recoverableCodes.includes(code);
+}
+exports.isRecoverable = isRecoverable;
+//# sourceMappingURL=exit-codes.js.map

package/dist/errors/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/errors/exit-codes.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,IAAY,QAiCX;AAjCD,WAAY,QAAQ;IAClB,2BAA2B;IAC3B,6CAAW,CAAA;IAEX,gCAAgC;IAChC,yDAAiB,CAAA;IAEjB,4DAA4D;IAC5D,uDAAgB,CAAA;IAEhB,wDAAwD;IACxD,yDAAiB,CAAA;IAEjB,8EAA8E;IAC9E,mDAAc,CAAA;IAEd,sEAAsE;IACtE,uDAAgB,CAAA;IAEhB,8EAA8E;IAC9E,2DAAkB,CAAA;IAElB,mCAAmC;IACnC,yDAAiB,CAAA;IAEjB,4DAA4D;IAC5D,qDAAe,CAAA;IAEf,kDAAkD;IAClD,6DAAmB,CAAA;IAEnB,8CAA8C;IAC9C,qDAAgB,CAAA;AAClB,CAAC,EAjCW,QAAQ,wBAAR,QAAQ,QAiCnB;AAED;;;GAGG;AACU,QAAA,sBAAsB,GAA6B;IAC9D,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;IAC7B,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe;IACzC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB;IAC9C,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe;IACzC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB;IAC7C,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB;IAClD,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB;IAC3C,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe;IACzC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa;IACrC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,iBAAiB;IAC7C,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB;CAC7C,CAAC;AAEF;;GAEG;AACH,SAAgB,SAAS,CAAC,IAAuB;IAC/C,OAAO,IAAI,KAAK,QAAQ,CAAC,OAAO,CAAC;AACnC,CAAC;AAFD,8BAEC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAuB;IACnD,MAAM,gBAAgB,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC3E,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC;AACrD,CAAC;AAHD,sCAGC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CCS Error Handling Module
+ *
+ * Centralized error handling system for CCS CLI providing:
+ * - Standardized exit codes
+ * - Custom error types with exit code mapping
+ * - Centralized error handler with cleanup
+ * - Cleanup callback registry
+ *
+ * @example
+ * ```typescript
+ * import { handleError, ConfigError, ExitCode, registerCleanup } from './errors';
+ *
+ * // Register cleanup for spawned process
+ * registerCleanup(() => proxy.kill());
+ *
+ * // Throw typed error
+ * throw new ConfigError('Invalid config file', '~/.ccs/config.json');
+ *
+ * // Or handle directly
+ * handleError(new NetworkError('Connection refused'));
+ * ```
+ */
+export { ExitCode, EXIT_CODE_DESCRIPTIONS, isSuccess, isRecoverable } from './exit-codes';
+export { CCSError, ConfigError, NetworkError, AuthError, BinaryError, ProviderError, ProfileError, ProxyError, MigrationError, UserAbortError, isCCSError, isRecoverableError, } from './error-types';
+export { handleError, exitWithError, exitWithSuccess, withErrorHandling, assertOrExit, } from './error-handler';
+export { registerCleanup, runCleanup, clearCleanup, getCleanupCount, hasCleanupRun, createCleanupScope, } from './cleanup-registry';
+export type { CleanupCallback } from './cleanup-registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * CCS Error Handling Module
+ *
+ * Centralized error handling system for CCS CLI providing:
+ * - Standardized exit codes
+ * - Custom error types with exit code mapping
+ * - Centralized error handler with cleanup
+ * - Cleanup callback registry
+ *
+ * @example
+ * ```typescript
+ * import { handleError, ConfigError, ExitCode, registerCleanup } from './errors';
+ *
+ * // Register cleanup for spawned process
+ * registerCleanup(() => proxy.kill());
+ *
+ * // Throw typed error
+ * throw new ConfigError('Invalid config file', '~/.ccs/config.json');
+ *
+ * // Or handle directly
+ * handleError(new NetworkError('Connection refused'));
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCleanupScope = exports.hasCleanupRun = exports.getCleanupCount = exports.clearCleanup = exports.runCleanup = exports.registerCleanup = exports.assertOrExit = exports.withErrorHandling = exports.exitWithSuccess = exports.exitWithError = exports.handleError = exports.isRecoverableError = exports.isCCSError = exports.UserAbortError = exports.MigrationError = exports.ProxyError = exports.ProfileError = exports.ProviderError = exports.BinaryError = exports.AuthError = exports.NetworkError = exports.ConfigError = exports.CCSError = exports.isRecoverable = exports.isSuccess = exports.EXIT_CODE_DESCRIPTIONS = exports.ExitCode = void 0;
+// Exit codes
+var exit_codes_1 = require("./exit-codes");
+Object.defineProperty(exports, "ExitCode", { enumerable: true, get: function () { return exit_codes_1.ExitCode; } });
+Object.defineProperty(exports, "EXIT_CODE_DESCRIPTIONS", { enumerable: true, get: function () { return exit_codes_1.EXIT_CODE_DESCRIPTIONS; } });
+Object.defineProperty(exports, "isSuccess", { enumerable: true, get: function () { return exit_codes_1.isSuccess; } });
+Object.defineProperty(exports, "isRecoverable", { enumerable: true, get: function () { return exit_codes_1.isRecoverable; } });
+// Error types
+var error_types_1 = require("./error-types");
+Object.defineProperty(exports, "CCSError", { enumerable: true, get: function () { return error_types_1.CCSError; } });
+Object.defineProperty(exports, "ConfigError", { enumerable: true, get: function () { return error_types_1.ConfigError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return error_types_1.NetworkError; } });
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return error_types_1.AuthError; } });
+Object.defineProperty(exports, "BinaryError", { enumerable: true, get: function () { return error_types_1.BinaryError; } });
+Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return error_types_1.ProviderError; } });
+Object.defineProperty(exports, "ProfileError", { enumerable: true, get: function () { return error_types_1.ProfileError; } });
+Object.defineProperty(exports, "ProxyError", { enumerable: true, get: function () { return error_types_1.ProxyError; } });
+Object.defineProperty(exports, "MigrationError", { enumerable: true, get: function () { return error_types_1.MigrationError; } });
+Object.defineProperty(exports, "UserAbortError", { enumerable: true, get: function () { return error_types_1.UserAbortError; } });
+Object.defineProperty(exports, "isCCSError", { enumerable: true, get: function () { return error_types_1.isCCSError; } });
+Object.defineProperty(exports, "isRecoverableError", { enumerable: true, get: function () { return error_types_1.isRecoverableError; } });
+// Error handler
+var error_handler_1 = require("./error-handler");
+Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return error_handler_1.handleError; } });
+Object.defineProperty(exports, "exitWithError", { enumerable: true, get: function () { return error_handler_1.exitWithError; } });
+Object.defineProperty(exports, "exitWithSuccess", { enumerable: true, get: function () { return error_handler_1.exitWithSuccess; } });
+Object.defineProperty(exports, "withErrorHandling", { enumerable: true, get: function () { return error_handler_1.withErrorHandling; } });
+Object.defineProperty(exports, "assertOrExit", { enumerable: true, get: function () { return error_handler_1.assertOrExit; } });
+// Cleanup registry
+var cleanup_registry_1 = require("./cleanup-registry");
+Object.defineProperty(exports, "registerCleanup", { enumerable: true, get: function () { return cleanup_registry_1.registerCleanup; } });
+Object.defineProperty(exports, "runCleanup", { enumerable: true, get: function () { return cleanup_registry_1.runCleanup; } });
+Object.defineProperty(exports, "clearCleanup", { enumerable: true, get: function () { return cleanup_registry_1.clearCleanup; } });
+Object.defineProperty(exports, "getCleanupCount", { enumerable: true, get: function () { return cleanup_registry_1.getCleanupCount; } });
+Object.defineProperty(exports, "hasCleanupRun", { enumerable: true, get: function () { return cleanup_registry_1.hasCleanupRun; } });
+Object.defineProperty(exports, "createCleanupScope", { enumerable: true, get: function () { return cleanup_registry_1.createCleanupScope; } });
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,aAAa;AACb,2CAA0F;AAAjF,sGAAA,QAAQ,OAAA;AAAE,oHAAA,sBAAsB,OAAA;AAAE,uGAAA,SAAS,OAAA;AAAE,2GAAA,aAAa,OAAA;AAEnE,cAAc;AACd,6CAauB;AAZrB,uGAAA,QAAQ,OAAA;AACR,0GAAA,WAAW,OAAA;AACX,2GAAA,YAAY,OAAA;AACZ,wGAAA,SAAS,OAAA;AACT,0GAAA,WAAW,OAAA;AACX,4GAAA,aAAa,OAAA;AACb,2GAAA,YAAY,OAAA;AACZ,yGAAA,UAAU,OAAA;AACV,6GAAA,cAAc,OAAA;AACd,6GAAA,cAAc,OAAA;AACd,yGAAA,UAAU,OAAA;AACV,iHAAA,kBAAkB,OAAA;AAGpB,gBAAgB;AAChB,iDAMyB;AALvB,4GAAA,WAAW,OAAA;AACX,8GAAA,aAAa,OAAA;AACb,gHAAA,eAAe,OAAA;AACf,kHAAA,iBAAiB,OAAA;AACjB,6GAAA,YAAY,OAAA;AAGd,mBAAmB;AACnB,uDAO4B;AAN1B,mHAAA,eAAe,OAAA;AACf,8GAAA,UAAU,OAAA;AACV,gHAAA,YAAY,OAAA;AACZ,mHAAA,eAAe,OAAA;AACf,iHAAA,aAAa,OAAA;AACb,sHAAA,kBAAkB,OAAA"}