@salesforce/capg-client 0.1.0-beta.1

package/dist/errors/base.js

@@ -0,0 +1,162 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+/**
+ * Base Error Class for CAPG Client
+ *
+ * This is the foundation error class for all CAPG-specific errors.
+ * All other error classes should extend this base class.
+ *
+ * Features:
+ * - Error code for programmatic error type identification
+ * - Error cause chaining for tracking root causes
+ * - Retry flags for automatic retry logic
+ * - User actionability flags for UX decisions
+ * - Request ID for distributed tracing
+ * - Suggested actions for user guidance
+ * - Stack trace preservation
+ * - JSON serialization support
+ *
+ * @example
+ * ```typescript
+ * const error = new CAPGError(
+ *   'OPERATION_FAILED',
+ *   'Failed to complete operation',
+ *   'Try again later'
+ * );
+ * console.error(error.toJSON());
+ * ```
+ */
+export class CAPGError extends Error {
+    /**
+     * Error code for programmatic identification
+     *
+     * @readonly
+     */
+    code;
+    /**
+     * The underlying error that caused this error (if any)
+     *
+     * @readonly
+     */
+    cause;
+    /**
+     * Whether this error is retryable (transient failure)
+     *
+     * @readonly
+     */
+    isRetryable;
+    /**
+     * Whether user action can resolve this error
+     *
+     * @readonly
+     */
+    isUserActionable;
+    /**
+     * Request ID for distributed tracing (optional)
+     */
+    requestId;
+    /**
+     * Suggested action to resolve the error (optional)
+     *
+     * @readonly
+     */
+    suggestedAction;
+    /**
+     * Creates a new CAPGError instance
+     *
+     * @param code - Error code for programmatic identification
+     * @param message - Human-readable error message
+     * @param suggestedAction - Optional suggested action to resolve the error
+     * @param cause - Optional underlying error that caused this error
+     * @param isRetryable - Whether this error is retryable (default: false)
+     * @param isUserActionable - Whether user action can resolve this error (default: true)
+     *
+     * @example
+     * ```typescript
+     * const error = new CAPGError(
+     *   'CONFIG_ERROR',
+     *   'Invalid configuration',
+     *   'Check your config file',
+     *   originalError,
+     *   false,
+     *   true
+     * );
+     * ```
+     */
+    constructor(code, message, suggestedAction, cause, isRetryable = false, isUserActionable = true) {
+        super(message);
+        // Set error name to class name for better stack traces
+        this.name = 'CAPGError';
+        // Set all properties
+        this.code = code;
+        this.suggestedAction = suggestedAction;
+        this.cause = cause;
+        this.isRetryable = isRetryable;
+        this.isUserActionable = isUserActionable;
+        // Maintain proper prototype chain for instanceof checks
+        // This is required because TypeScript/JavaScript don't properly
+        // handle prototype chains when extending built-in classes like Error
+        Object.setPrototypeOf(this, CAPGError.prototype);
+        // Capture stack trace for debugging
+        // Exclude constructor call from stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serializes the error to a JSON object
+     *
+     * This method is called automatically by JSON.stringify().
+     * It includes all error properties and recursively serializes
+     * the cause chain.
+     *
+     * @returns JSON representation of the error
+     *
+     * @example
+     * ```typescript
+     * const error = new CAPGError('TEST_ERROR', 'Test message');
+     * const json = error.toJSON();
+     * console.log(JSON.stringify(json, null, 2));
+     * ```
+     */
+    toJSON() {
+        const json = {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            isRetryable: this.isRetryable,
+            isUserActionable: this.isUserActionable,
+            stack: this.stack,
+        };
+        // Include optional properties if they are defined
+        if (this.suggestedAction !== undefined) {
+            json.suggestedAction = this.suggestedAction;
+        }
+        if (this.requestId !== undefined) {
+            json.requestId = this.requestId;
+        }
+        // Recursively serialize cause chain
+        if (this.cause !== undefined) {
+            if (this.cause instanceof CAPGError) {
+                // CAPGError has toJSON method
+                json.cause = this.cause.toJSON();
+            }
+            else if (this.cause instanceof Error) {
+                // Native Error - serialize basic properties
+                json.cause = {
+                    name: this.cause.name,
+                    message: this.cause.message,
+                    stack: this.cause.stack,
+                };
+            }
+            else {
+                // Non-Error cause (edge case)
+                json.cause = this.cause;
+            }
+        }
+        return json;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/errors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC;;;;OAIG;IACa,IAAI,CAAS;IAE7B;;;;OAIG;IACa,KAAK,CAAS;IAE9B;;;;OAIG;IACa,WAAW,CAAU;IAErC;;;;OAIG;IACa,gBAAgB,CAAU;IAE1C;;OAEG;IACI,SAAS,CAAU;IAE1B;;;;OAIG;IACa,eAAe,CAAU;IAEzC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YACE,IAAY,EACZ,OAAe,EACf,eAAwB,EACxB,KAAa,EACb,cAAuB,KAAK,EAC5B,mBAA4B,IAAI;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,uDAAuD;QACvD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QAExB,qBAAqB;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAEzC,wDAAwD;QACxD,gEAAgE;QAChE,qEAAqE;QACrE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAEjD,oCAAoC;QACpC,4CAA4C;QAC5C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,MAAM;QACX,MAAM,IAAI,GAA4B;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,kDAAkD;QAClD,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QAC9C,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClC,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,YAAY,SAAS,EAAE,CAAC;gBACpC,8BAA8B;gBAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;gBACvC,4CAA4C;gBAC5C,IAAI,CAAC,KAAK,GAAG;oBACX,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;oBACrB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;oBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;iBACxB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/errors/hub-org.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Hub Org Error Classes
+ *
+ * Errors related to Hub Org authentication and validation.
+ * These errors indicate that the user needs to authenticate or provide a valid Hub Org.
+ *
+ * @deprecated These error classes are deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed in favor of explicit org alias specification. These classes are
+ * retained for future Connect API integration work but marked @internal.
+ *
+ * @internal These classes should not be used by external consumers. They are preserved
+ * for future Connect API integration work.
+ */
+import { CAPGError } from './base.js';
+/**
+ * Hub Org Not Found Error
+ *
+ * Thrown when no Hub Org is detected in the authenticated orgs.
+ * The user needs to authenticate with a Hub Org.
+ *
+ * Properties:
+ * - code: 'HUB_ORG_NOT_FOUND'
+ * - isRetryable: false (user must authenticate)
+ * - isUserActionable: true (user can fix by logging in)
+ * - suggestedAction: CLI command to authenticate with Hub Org
+ *
+ * @deprecated This error class is deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed. Use explicit org alias specification instead.
+ *
+ * @internal This class should not be used by external consumers. It is preserved
+ * for future Connect API integration work.
+ *
+ * @example
+ * ```typescript
+ * throw new HubOrgNotFoundError('No Hub Org found in authenticated orgs');
+ * ```
+ */
+export declare class HubOrgNotFoundError extends CAPGError {
+    /**
+     * Creates a new HubOrgNotFoundError instance
+     *
+     * @param message - Human-readable error message
+     * @param context - Optional context object with additional information
+     *
+     * @example
+     * ```typescript
+     * const error = new HubOrgNotFoundError(
+     *   'No Hub Org found. Checked aliases: hub1, hub2',
+     *   { attemptedAliases: ['hub1', 'hub2'], availableOrgs: 3 }
+     * );
+     * ```
+     */
+    constructor(message: string);
+}
+/**
+ * Invalid Hub Org Error
+ *
+ * Thrown when an org exists but is not a valid Dev Hub.
+ * The user needs to provide a different org that has Dev Hub enabled.
+ *
+ * Properties:
+ * - code: 'INVALID_HUB_ORG'
+ * - isRetryable: false (user must provide different org)
+ * - isUserActionable: true (user can fix by providing valid Hub Org)
+ * - orgAlias: The org alias that was invalid
+ * - suggestedAction: Guidance to provide a valid Hub Org
+ *
+ * @deprecated This error class is deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed. Use explicit org alias specification instead.
+ *
+ * @internal This class should not be used by external consumers. It is preserved
+ * for future Connect API integration work.
+ *
+ * @example
+ * ```typescript
+ * throw new InvalidHubOrgError('myOrg', 'Org is not a Dev Hub');
+ * ```
+ */
+export declare class InvalidHubOrgError extends CAPGError {
+    /**
+     * The org alias that was invalid
+     *
+     * @readonly
+     */
+    readonly orgAlias: string;
+    /**
+     * Creates a new InvalidHubOrgError instance
+     *
+     * @param orgAlias - The org alias that was invalid
+     * @param message - Human-readable error message
+     *
+     * @example
+     * ```typescript
+     * const error = new InvalidHubOrgError(
+     *   'testOrg',
+     *   'Org testOrg is not a Dev Hub. Enable Dev Hub in Setup.'
+     * );
+     * console.error(error.orgAlias); // 'testOrg'
+     * ```
+     */
+    constructor(orgAlias: string, message: string);
+    /**
+     * Serializes the error to JSON
+     * Includes orgAlias property
+     */
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=hub-org.d.ts.map

package/dist/errors/hub-org.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-org.d.ts","sourceRoot":"","sources":["../../src/errors/hub-org.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD;;;;;;;;;;;;;OAaG;gBACgB,OAAO,EAAE,MAAM;CAyBnC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C;;;;OAIG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC;;;;;;;;;;;;;;OAcG;gBACgB,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAyBpD;;;OAGG;IACI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQzC"}

package/dist/errors/hub-org.js

@@ -0,0 +1,144 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+/**
+ * Hub Org Error Classes
+ *
+ * Errors related to Hub Org authentication and validation.
+ * These errors indicate that the user needs to authenticate or provide a valid Hub Org.
+ *
+ * @deprecated These error classes are deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed in favor of explicit org alias specification. These classes are
+ * retained for future Connect API integration work but marked @internal.
+ *
+ * @internal These classes should not be used by external consumers. They are preserved
+ * for future Connect API integration work.
+ */
+import { CAPGError } from './base.js';
+/**
+ * Hub Org Not Found Error
+ *
+ * Thrown when no Hub Org is detected in the authenticated orgs.
+ * The user needs to authenticate with a Hub Org.
+ *
+ * Properties:
+ * - code: 'HUB_ORG_NOT_FOUND'
+ * - isRetryable: false (user must authenticate)
+ * - isUserActionable: true (user can fix by logging in)
+ * - suggestedAction: CLI command to authenticate with Hub Org
+ *
+ * @deprecated This error class is deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed. Use explicit org alias specification instead.
+ *
+ * @internal This class should not be used by external consumers. It is preserved
+ * for future Connect API integration work.
+ *
+ * @example
+ * ```typescript
+ * throw new HubOrgNotFoundError('No Hub Org found in authenticated orgs');
+ * ```
+ */
+export class HubOrgNotFoundError extends CAPGError {
+    /**
+     * Creates a new HubOrgNotFoundError instance
+     *
+     * @param message - Human-readable error message
+     * @param context - Optional context object with additional information
+     *
+     * @example
+     * ```typescript
+     * const error = new HubOrgNotFoundError(
+     *   'No Hub Org found. Checked aliases: hub1, hub2',
+     *   { attemptedAliases: ['hub1', 'hub2'], availableOrgs: 3 }
+     * );
+     * ```
+     */
+    constructor(message) {
+        super('HUB_ORG_NOT_FOUND', message, 'Login to Hub Org: sf org login web --set-default-dev-hub', undefined, false, // Not retryable - user must authenticate
+        true);
+        // Set error name to class name for better stack traces
+        this.name = 'HubOrgNotFoundError';
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, HubOrgNotFoundError.prototype);
+        // Capture stack trace for debugging
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        // Note: _context is accepted but not stored as a property
+        // It's just for flexibility in error construction
+        // Prefixed with _ to indicate intentionally unused parameter
+    }
+}
+/**
+ * Invalid Hub Org Error
+ *
+ * Thrown when an org exists but is not a valid Dev Hub.
+ * The user needs to provide a different org that has Dev Hub enabled.
+ *
+ * Properties:
+ * - code: 'INVALID_HUB_ORG'
+ * - isRetryable: false (user must provide different org)
+ * - isUserActionable: true (user can fix by providing valid Hub Org)
+ * - orgAlias: The org alias that was invalid
+ * - suggestedAction: Guidance to provide a valid Hub Org
+ *
+ * @deprecated This error class is deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed. Use explicit org alias specification instead.
+ *
+ * @internal This class should not be used by external consumers. It is preserved
+ * for future Connect API integration work.
+ *
+ * @example
+ * ```typescript
+ * throw new InvalidHubOrgError('myOrg', 'Org is not a Dev Hub');
+ * ```
+ */
+export class InvalidHubOrgError extends CAPGError {
+    /**
+     * The org alias that was invalid
+     *
+     * @readonly
+     */
+    orgAlias;
+    /**
+     * Creates a new InvalidHubOrgError instance
+     *
+     * @param orgAlias - The org alias that was invalid
+     * @param message - Human-readable error message
+     *
+     * @example
+     * ```typescript
+     * const error = new InvalidHubOrgError(
+     *   'testOrg',
+     *   'Org testOrg is not a Dev Hub. Enable Dev Hub in Setup.'
+     * );
+     * console.error(error.orgAlias); // 'testOrg'
+     * ```
+     */
+    constructor(orgAlias, message) {
+        super('INVALID_HUB_ORG', message, 'Provide a valid Hub Org alias or enable Dev Hub in the org', undefined, false, // Not retryable - user must provide different org
+        true);
+        // Set error name to class name for better stack traces
+        this.name = 'InvalidHubOrgError';
+        // Store org alias
+        this.orgAlias = orgAlias;
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, InvalidHubOrgError.prototype);
+        // Capture stack trace for debugging
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serializes the error to JSON
+     * Includes orgAlias property
+     */
+    toJSON() {
+        const json = super.toJSON();
+        // Include orgAlias
+        json.orgAlias = this.orgAlias;
+        return json;
+    }
+}
+//# sourceMappingURL=hub-org.js.map

package/dist/errors/hub-org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-org.js","sourceRoot":"","sources":["../../src/errors/hub-org.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD;;;;;;;;;;;;;OAaG;IACH,YAAmB,OAAe;QAChC,KAAK,CACH,mBAAmB,EACnB,OAAO,EACP,0DAA0D,EAC1D,SAAS,EACT,KAAK,EAAE,yCAAyC;QAChD,IAAI,CACL,CAAC;QAEF,uDAAuD;QACvD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAElC,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAE3D,oCAAoC;QACpC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;QAED,0DAA0D;QAC1D,kDAAkD;QAClD,6DAA6D;IAC/D,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C;;;;OAIG;IACa,QAAQ,CAAS;IAEjC;;;;;;;;;;;;;;OAcG;IACH,YAAmB,QAAgB,EAAE,OAAe;QAClD,KAAK,CACH,iBAAiB,EACjB,OAAO,EACP,4DAA4D,EAC5D,SAAS,EACT,KAAK,EAAE,kDAAkD;QACzD,IAAI,CACL,CAAC;QAEF,uDAAuD;QACvD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QAEjC,kBAAkB;QAClB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAE1D,oCAAoC;QACpC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,MAAM;QACX,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAE5B,mBAAmB;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CAPG Client Error Classes
+ *
+ * Barrel export file for all error classes.
+ * Import all error classes from this single entry point.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   CAPGError,
+ *   CAPGAuthError,
+ *   CAPGNetworkError,
+ *   CAPGAPIError,
+ *   HubOrgNotFoundError,
+ *   InvalidHubOrgError,
+ *   CAPGValidationError
+ * } from './errors.js';
+ * ```
+ */
+export { CAPGError } from './base.js';
+export { CAPGAuthError } from './auth.js';
+/**
+ * Hub Org errors
+ *
+ * @deprecated These error classes are deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed in favor of explicit org alias specification. These classes are
+ * retained for future Connect API integration work but marked @internal.
+ */
+export { HubOrgNotFoundError, InvalidHubOrgError } from './hub-org.js';
+export { CAPGNetworkError } from './network.js';
+export { CAPGAPIError } from './api.js';
+export { CAPGValidationError } from './validation.js';
+//# 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":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;GAMG;AACH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,42 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+/**
+ * CAPG Client Error Classes
+ *
+ * Barrel export file for all error classes.
+ * Import all error classes from this single entry point.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   CAPGError,
+ *   CAPGAuthError,
+ *   CAPGNetworkError,
+ *   CAPGAPIError,
+ *   HubOrgNotFoundError,
+ *   InvalidHubOrgError,
+ *   CAPGValidationError
+ * } from './errors.js';
+ * ```
+ */
+// Base error class
+export { CAPGError } from './base.js';
+// Authentication error
+export { CAPGAuthError } from './auth.js';
+/**
+ * Hub Org errors
+ *
+ * @deprecated These error classes are deprecated as of v0.2.0. Hub org auto-detection
+ * has been removed in favor of explicit org alias specification. These classes are
+ * retained for future Connect API integration work but marked @internal.
+ */
+export { HubOrgNotFoundError, InvalidHubOrgError } from './hub-org.js';
+// Network error
+export { CAPGNetworkError } from './network.js';
+// API error
+export { CAPGAPIError } from './api.js';
+// Validation error
+export { CAPGValidationError } from './validation.js';
+//# 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;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;GAMG;AACH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvE,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,mBAAmB;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/errors/network.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Network Error Class
+ *
+ * Thrown when network failures occur (timeout, DNS failure, connection refused, etc.).
+ * These are typically transient failures that can be retried.
+ *
+ * Properties:
+ * - code: 'NETWORK_ERROR'
+ * - isRetryable: true (transient network failures)
+ * - isUserActionable: false (network issues are usually temporary)
+ * - statusCode: Optional HTTP status code (e.g., 408 timeout, 504 gateway timeout)
+ *
+ * @example
+ * ```typescript
+ * throw new CAPGNetworkError('Connection timeout', 504);
+ * ```
+ */
+import { CAPGError } from './base.js';
+export declare class CAPGNetworkError extends CAPGError {
+    /**
+     * HTTP status code (if available)
+     *
+     * @readonly
+     */
+    readonly statusCode?: number;
+    /**
+     * Creates a new CAPGNetworkError instance
+     *
+     * @param message - Human-readable error message
+     * @param statusCode - Optional HTTP status code (e.g., 408, 503, 504)
+     * @param cause - Optional underlying error that caused this network error
+     *
+     * @example
+     * ```typescript
+     * // DNS failure (no status code)
+     * const dnsError = new CAPGNetworkError('DNS resolution failed');
+     *
+     * // Gateway timeout (with status code)
+     * const timeoutError = new CAPGNetworkError('Gateway timeout', 504);
+     *
+     * // Connection refused (with cause)
+     * const socketError = new Error('ECONNREFUSED');
+     * const connError = new CAPGNetworkError('Connection refused', undefined, socketError);
+     * ```
+     */
+    constructor(message: string, statusCode?: number, cause?: Error);
+    /**
+     * Serializes the network error to JSON
+     * Includes statusCode if present
+     */
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=network.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/errors/network.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C;;;;OAIG;IACH,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;OAmBG;gBACgB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAyBtE;;;OAGG;IACI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUzC"}

package/dist/errors/network.js

@@ -0,0 +1,77 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+/**
+ * Network Error Class
+ *
+ * Thrown when network failures occur (timeout, DNS failure, connection refused, etc.).
+ * These are typically transient failures that can be retried.
+ *
+ * Properties:
+ * - code: 'NETWORK_ERROR'
+ * - isRetryable: true (transient network failures)
+ * - isUserActionable: false (network issues are usually temporary)
+ * - statusCode: Optional HTTP status code (e.g., 408 timeout, 504 gateway timeout)
+ *
+ * @example
+ * ```typescript
+ * throw new CAPGNetworkError('Connection timeout', 504);
+ * ```
+ */
+import { CAPGError } from './base.js';
+export class CAPGNetworkError extends CAPGError {
+    /**
+     * HTTP status code (if available)
+     *
+     * @readonly
+     */
+    statusCode;
+    /**
+     * Creates a new CAPGNetworkError instance
+     *
+     * @param message - Human-readable error message
+     * @param statusCode - Optional HTTP status code (e.g., 408, 503, 504)
+     * @param cause - Optional underlying error that caused this network error
+     *
+     * @example
+     * ```typescript
+     * // DNS failure (no status code)
+     * const dnsError = new CAPGNetworkError('DNS resolution failed');
+     *
+     * // Gateway timeout (with status code)
+     * const timeoutError = new CAPGNetworkError('Gateway timeout', 504);
+     *
+     * // Connection refused (with cause)
+     * const socketError = new Error('ECONNREFUSED');
+     * const connError = new CAPGNetworkError('Connection refused', undefined, socketError);
+     * ```
+     */
+    constructor(message, statusCode, cause) {
+        super('NETWORK_ERROR', message, 'Check your network connection and try again', cause, true, // Retryable - network failures are typically transient
+        false);
+        // Set error name to class name for better stack traces
+        this.name = 'CAPGNetworkError';
+        // Store status code if provided
+        this.statusCode = statusCode;
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, CAPGNetworkError.prototype);
+        // Capture stack trace for debugging
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serializes the network error to JSON
+     * Includes statusCode if present
+     */
+    toJSON() {
+        const json = super.toJSON();
+        // Include statusCode if present
+        if (this.statusCode !== undefined) {
+            json.statusCode = this.statusCode;
+        }
+        return json;
+    }
+}
+//# sourceMappingURL=network.js.map

package/dist/errors/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/errors/network.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C;;;;OAIG;IACa,UAAU,CAAU;IAEpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAmB,OAAe,EAAE,UAAmB,EAAE,KAAa;QACpE,KAAK,CACH,eAAe,EACf,OAAO,EACP,6CAA6C,EAC7C,KAAK,EACL,IAAI,EAAE,uDAAuD;QAC7D,KAAK,CACN,CAAC;QAEF,uDAAuD;QACvD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAE/B,gCAAgC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAExD,oCAAoC;QACpC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,MAAM;QACX,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAE5B,gCAAgC;QAChC,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}