@kadi.build/deploy-ability 0.0.1

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

@@ -0,0 +1,95 @@
+/**
+ * Certificate-related error classes
+ *
+ * Errors specific to TLS certificate operations for Akash provider communication
+ *
+ * @module errors/certificate-error
+ */
+import { DeploymentError, type ErrorContext, type ErrorSeverity } from './deployment-error.js';
+/**
+ * Certificate error codes
+ */
+export declare const CertificateErrorCodes: {
+    /** Certificate file not found */
+    readonly CERT_NOT_FOUND: "CERT_NOT_FOUND";
+    /** Certificate file is invalid or corrupted */
+    readonly CERT_INVALID: "CERT_INVALID";
+    /** Certificate has expired */
+    readonly CERT_EXPIRED: "CERT_EXPIRED";
+    /** Failed to create new certificate */
+    readonly CERT_CREATION_FAILED: "CERT_CREATION_FAILED";
+    /** Failed to save certificate to disk */
+    readonly CERT_SAVE_FAILED: "CERT_SAVE_FAILED";
+    /** Failed to broadcast certificate to blockchain */
+    readonly CERT_BROADCAST_FAILED: "CERT_BROADCAST_FAILED";
+    /** Certificate parsing error */
+    readonly CERT_PARSE_ERROR: "CERT_PARSE_ERROR";
+    /** Generic certificate error */
+    readonly CERT_ERROR: "CERT_ERROR";
+};
+export type CertificateErrorCode = (typeof CertificateErrorCodes)[keyof typeof CertificateErrorCodes];
+/**
+ * Certificate operation error
+ *
+ * Thrown when certificate-related operations fail, including:
+ * - Loading existing certificates
+ * - Creating new certificates
+ * - Broadcasting certificates to blockchain
+ * - Certificate validation
+ *
+ * @example
+ * throw new CertificateError(
+ *   'Certificate file not found',
+ *   CertificateErrorCodes.CERT_NOT_FOUND,
+ *   { path: '/path/to/cert.json' },
+ *   true,
+ *   'A new certificate will be created automatically'
+ * );
+ */
+export declare class CertificateError extends DeploymentError {
+    constructor(message: string, code?: CertificateErrorCode, context?: ErrorContext, recoverable?: boolean, suggestion?: string, severity?: ErrorSeverity, cause?: Error);
+}
+/**
+ * Create a certificate not found error
+ *
+ * @param path - Path where certificate was expected
+ * @returns CertificateError instance
+ */
+export declare function certificateNotFoundError(path: string): CertificateError;
+/**
+ * Create a certificate invalid error
+ *
+ * @param path - Path to invalid certificate
+ * @param reason - Why the certificate is invalid
+ * @returns CertificateError instance
+ */
+export declare function certificateInvalidError(path: string, reason: string): CertificateError;
+/**
+ * Create a certificate expired error
+ *
+ * @param expiryDate - When the certificate expired
+ * @returns CertificateError instance
+ */
+export declare function certificateExpiredError(expiryDate: Date): CertificateError;
+/**
+ * Create a certificate creation failed error
+ *
+ * @param cause - Original error
+ * @returns CertificateError instance
+ */
+export declare function certificateCreationFailedError(cause?: Error): CertificateError;
+/**
+ * Create a certificate broadcast failed error
+ *
+ * @param cause - Original error
+ * @returns CertificateError instance
+ */
+export declare function certificateBroadcastFailedError(cause?: Error): CertificateError;
+/**
+ * Type guard to check if an error is a CertificateError
+ *
+ * @param error - The error to check
+ * @returns True if error is a CertificateError
+ */
+export declare function isCertificateError(error: unknown): error is CertificateError;
+//# sourceMappingURL=certificate-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"certificate-error.d.ts","sourceRoot":"","sources":["../../src/errors/certificate-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,iCAAiC;;IAGjC,+CAA+C;;IAG/C,8BAA8B;;IAG9B,uCAAuC;;IAGvC,yCAAyC;;IAGzC,oDAAoD;;IAGpD,gCAAgC;;IAGhC,gCAAgC;;CAExB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;gBAEjD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,oBAAuD,EAC7D,OAAO,GAAE,YAAiB,EAC1B,WAAW,GAAE,OAAe,EAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,aAAuB,EACjC,KAAK,CAAC,EAAE,KAAK;CAShB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CASvE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,gBAAgB,CASlB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,IAAI,GACf,gBAAgB,CASlB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,CAAC,EAAE,KAAK,GACZ,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,CAAC,EAAE,KAAK,GACZ,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E"}

package/dist/errors/certificate-error.js

@@ -0,0 +1,111 @@
+/**
+ * Certificate-related error classes
+ *
+ * Errors specific to TLS certificate operations for Akash provider communication
+ *
+ * @module errors/certificate-error
+ */
+import { DeploymentError } from './deployment-error.js';
+/**
+ * Certificate error codes
+ */
+export const CertificateErrorCodes = {
+    /** Certificate file not found */
+    CERT_NOT_FOUND: 'CERT_NOT_FOUND',
+    /** Certificate file is invalid or corrupted */
+    CERT_INVALID: 'CERT_INVALID',
+    /** Certificate has expired */
+    CERT_EXPIRED: 'CERT_EXPIRED',
+    /** Failed to create new certificate */
+    CERT_CREATION_FAILED: 'CERT_CREATION_FAILED',
+    /** Failed to save certificate to disk */
+    CERT_SAVE_FAILED: 'CERT_SAVE_FAILED',
+    /** Failed to broadcast certificate to blockchain */
+    CERT_BROADCAST_FAILED: 'CERT_BROADCAST_FAILED',
+    /** Certificate parsing error */
+    CERT_PARSE_ERROR: 'CERT_PARSE_ERROR',
+    /** Generic certificate error */
+    CERT_ERROR: 'CERT_ERROR',
+};
+/**
+ * Certificate operation error
+ *
+ * Thrown when certificate-related operations fail, including:
+ * - Loading existing certificates
+ * - Creating new certificates
+ * - Broadcasting certificates to blockchain
+ * - Certificate validation
+ *
+ * @example
+ * throw new CertificateError(
+ *   'Certificate file not found',
+ *   CertificateErrorCodes.CERT_NOT_FOUND,
+ *   { path: '/path/to/cert.json' },
+ *   true,
+ *   'A new certificate will be created automatically'
+ * );
+ */
+export class CertificateError extends DeploymentError {
+    constructor(message, code = CertificateErrorCodes.CERT_ERROR, context = {}, recoverable = false, suggestion, severity = 'error', cause) {
+        super(message, code, context, recoverable, suggestion, severity, cause);
+        // Maintain proper prototype chain
+        Object.setPrototypeOf(this, CertificateError.prototype);
+        this.name = 'CertificateError';
+    }
+}
+/**
+ * Create a certificate not found error
+ *
+ * @param path - Path where certificate was expected
+ * @returns CertificateError instance
+ */
+export function certificateNotFoundError(path) {
+    return new CertificateError(`Certificate not found at ${path}`, CertificateErrorCodes.CERT_NOT_FOUND, { path }, true, 'A new certificate will be created automatically', 'warning');
+}
+/**
+ * Create a certificate invalid error
+ *
+ * @param path - Path to invalid certificate
+ * @param reason - Why the certificate is invalid
+ * @returns CertificateError instance
+ */
+export function certificateInvalidError(path, reason) {
+    return new CertificateError(`Certificate at ${path} is invalid: ${reason}`, CertificateErrorCodes.CERT_INVALID, { path, reason }, true, 'A new certificate will be created to replace the invalid one', 'warning');
+}
+/**
+ * Create a certificate expired error
+ *
+ * @param expiryDate - When the certificate expired
+ * @returns CertificateError instance
+ */
+export function certificateExpiredError(expiryDate) {
+    return new CertificateError(`Certificate expired on ${expiryDate.toISOString()}`, CertificateErrorCodes.CERT_EXPIRED, { expiryDate: expiryDate.toISOString() }, true, 'A new certificate will be created automatically', 'warning');
+}
+/**
+ * Create a certificate creation failed error
+ *
+ * @param cause - Original error
+ * @returns CertificateError instance
+ */
+export function certificateCreationFailedError(cause) {
+    return new CertificateError('Failed to create new certificate', CertificateErrorCodes.CERT_CREATION_FAILED, {}, false, 'Check wallet connection and try again', 'error', cause);
+}
+/**
+ * Create a certificate broadcast failed error
+ *
+ * @param cause - Original error
+ * @returns CertificateError instance
+ */
+export function certificateBroadcastFailedError(cause) {
+    return new CertificateError('Failed to broadcast certificate to blockchain', CertificateErrorCodes.CERT_BROADCAST_FAILED, {}, true, 'Check your network connection and try again', 'error', cause);
+}
+/**
+ * Type guard to check if an error is a CertificateError
+ *
+ * @param error - The error to check
+ * @returns True if error is a CertificateError
+ */
+export function isCertificateError(error) {
+    return error instanceof CertificateError;
+}
+//# sourceMappingURL=certificate-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"certificate-error.js","sourceRoot":"","sources":["../../src/errors/certificate-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAyC,MAAM,uBAAuB,CAAC;AAE/F;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iCAAiC;IACjC,cAAc,EAAE,gBAAgB;IAEhC,+CAA+C;IAC/C,YAAY,EAAE,cAAc;IAE5B,8BAA8B;IAC9B,YAAY,EAAE,cAAc;IAE5B,uCAAuC;IACvC,oBAAoB,EAAE,sBAAsB;IAE5C,yCAAyC;IACzC,gBAAgB,EAAE,kBAAkB;IAEpC,oDAAoD;IACpD,qBAAqB,EAAE,uBAAuB;IAE9C,gCAAgC;IAChC,gBAAgB,EAAE,kBAAkB;IAEpC,gCAAgC;IAChC,UAAU,EAAE,YAAY;CAChB,CAAC;AAKX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnD,YACE,OAAe,EACf,OAA6B,qBAAqB,CAAC,UAAU,EAC7D,UAAwB,EAAE,EAC1B,cAAuB,KAAK,EAC5B,UAAmB,EACnB,WAA0B,OAAO,EACjC,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAExE,kCAAkC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAExD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,gBAAgB,CACzB,4BAA4B,IAAI,EAAE,EAClC,qBAAqB,CAAC,cAAc,EACpC,EAAE,IAAI,EAAE,EACR,IAAI,EACJ,iDAAiD,EACjD,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,MAAc;IAEd,OAAO,IAAI,gBAAgB,CACzB,kBAAkB,IAAI,gBAAgB,MAAM,EAAE,EAC9C,qBAAqB,CAAC,YAAY,EAClC,EAAE,IAAI,EAAE,MAAM,EAAE,EAChB,IAAI,EACJ,8DAA8D,EAC9D,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAgB;IAEhB,OAAO,IAAI,gBAAgB,CACzB,0BAA0B,UAAU,CAAC,WAAW,EAAE,EAAE,EACpD,qBAAqB,CAAC,YAAY,EAClC,EAAE,UAAU,EAAE,UAAU,CAAC,WAAW,EAAE,EAAE,EACxC,IAAI,EACJ,iDAAiD,EACjD,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAa;IAEb,OAAO,IAAI,gBAAgB,CACzB,kCAAkC,EAClC,qBAAqB,CAAC,oBAAoB,EAC1C,EAAE,EACF,KAAK,EACL,uCAAuC,EACvC,OAAO,EACP,KAAK,CACN,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAAa;IAEb,OAAO,IAAI,gBAAgB,CACzB,+CAA+C,EAC/C,qBAAqB,CAAC,qBAAqB,EAC3C,EAAE,EACF,IAAI,EACJ,6CAA6C,EAC7C,OAAO,EACP,KAAK,CACN,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC3C,CAAC"}

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

@@ -0,0 +1,122 @@
+/**
+ * Base deployment error class
+ *
+ * Provides structured error handling with error codes, context, and suggestions
+ *
+ * @module errors/deployment-error
+ */
+/**
+ * Error context type
+ *
+ * Additional contextual information about the error
+ * Can include any relevant data for debugging or error handling
+ */
+export type ErrorContext = Readonly<Record<string, unknown>>;
+/**
+ * Error severity levels
+ */
+export type ErrorSeverity = 'critical' | 'error' | 'warning' | 'info';
+/**
+ * Base deployment error class
+ *
+ * All deployment-related errors extend from this class.
+ * Provides rich error information including:
+ * - Structured error codes
+ * - Contextual data
+ * - Actionable suggestions
+ * - Recoverability hints
+ *
+ * @example
+ * throw new DeploymentError(
+ *   'Failed to create deployment',
+ *   'DEPLOY_CREATE_FAILED',
+ *   { dseq: 12345, provider: 'akash1...' },
+ *   true,
+ *   'Check your wallet balance and try again'
+ * );
+ */
+export declare class DeploymentError extends Error {
+    /**
+     * Structured error code for programmatic handling
+     */
+    readonly code: string;
+    /**
+     * Additional context about the error
+     */
+    readonly context: ErrorContext;
+    /**
+     * Whether the operation can be retried
+     */
+    readonly recoverable: boolean;
+    /**
+     * Human-readable suggestion for fixing the error
+     */
+    readonly suggestion?: string;
+    /**
+     * Error severity level
+     */
+    readonly severity: ErrorSeverity;
+    /**
+     * Timestamp when error occurred
+     */
+    readonly timestamp: Date;
+    /**
+     * Original error that caused this error (if any)
+     */
+    readonly cause?: Error;
+    constructor(message: string, code: string, context?: ErrorContext, recoverable?: boolean, suggestion?: string, severity?: ErrorSeverity, cause?: Error);
+    /**
+     * Convert error to JSON representation
+     *
+     * Useful for logging or sending error details over the network
+     *
+     * @returns JSON-serializable error object
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Get a user-friendly error message
+     *
+     * Combines the error message with suggestion if available
+     *
+     * @returns Formatted error message
+     */
+    getUserMessage(): string;
+    /**
+     * Check if error is recoverable
+     *
+     * @returns True if the operation can be retried
+     */
+    isRecoverable(): boolean;
+    /**
+     * Get formatted context string for logging
+     *
+     * @returns Formatted context information
+     */
+    getContextString(): string;
+    /**
+     * Create a detailed error report
+     *
+     * Useful for debugging or error logging
+     *
+     * @returns Formatted error report
+     */
+    getDetailedReport(): string;
+}
+/**
+ * Type guard to check if an error is a DeploymentError
+ *
+ * @param error - The error to check
+ * @returns True if error is a DeploymentError
+ *
+ * @example
+ * try {
+ *   await deploy();
+ * } catch (error) {
+ *   if (isDeploymentError(error)) {
+ *     console.log(error.code);
+ *     console.log(error.context);
+ *   }
+ * }
+ */
+export declare function isDeploymentError(error: unknown): error is DeploymentError;
+//# sourceMappingURL=deployment-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-error.d.ts","sourceRoot":"","sources":["../../src/errors/deployment-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,OAAO,EAAE,YAAY,CAAC;IAEtC;;OAEG;IACH,SAAgB,WAAW,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,SAAgB,QAAQ,EAAE,aAAa,CAAC;IAExC;;OAEG;IACH,SAAgB,SAAS,EAAE,IAAI,CAAC;IAEhC;;OAEG;IACH,SAAyB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAiB,EAC1B,WAAW,GAAE,OAAe,EAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,aAAuB,EACjC,KAAK,CAAC,EAAE,KAAK;IAsBf;;;;;;OAMG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoBjC;;;;;;OAMG;IACH,cAAc,IAAI,MAAM;IAOxB;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IAU1B;;;;;;OAMG;IACH,iBAAiB,IAAI,MAAM;CA8B5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/errors/deployment-error.js

@@ -0,0 +1,185 @@
+/**
+ * Base deployment error class
+ *
+ * Provides structured error handling with error codes, context, and suggestions
+ *
+ * @module errors/deployment-error
+ */
+/**
+ * Base deployment error class
+ *
+ * All deployment-related errors extend from this class.
+ * Provides rich error information including:
+ * - Structured error codes
+ * - Contextual data
+ * - Actionable suggestions
+ * - Recoverability hints
+ *
+ * @example
+ * throw new DeploymentError(
+ *   'Failed to create deployment',
+ *   'DEPLOY_CREATE_FAILED',
+ *   { dseq: 12345, provider: 'akash1...' },
+ *   true,
+ *   'Check your wallet balance and try again'
+ * );
+ */
+export class DeploymentError extends Error {
+    /**
+     * Structured error code for programmatic handling
+     */
+    code;
+    /**
+     * Additional context about the error
+     */
+    context;
+    /**
+     * Whether the operation can be retried
+     */
+    recoverable;
+    /**
+     * Human-readable suggestion for fixing the error
+     */
+    suggestion;
+    /**
+     * Error severity level
+     */
+    severity;
+    /**
+     * Timestamp when error occurred
+     */
+    timestamp;
+    /**
+     * Original error that caused this error (if any)
+     */
+    cause;
+    constructor(message, code, context = {}, recoverable = false, suggestion, severity = 'error', cause) {
+        super(message);
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, DeploymentError.prototype);
+        this.name = 'DeploymentError';
+        this.code = code;
+        this.context = context;
+        this.recoverable = recoverable;
+        this.suggestion = suggestion;
+        this.severity = severity;
+        this.timestamp = new Date();
+        this.cause = cause;
+        // Capture stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert error to JSON representation
+     *
+     * Useful for logging or sending error details over the network
+     *
+     * @returns JSON-serializable error object
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+            recoverable: this.recoverable,
+            suggestion: this.suggestion,
+            severity: this.severity,
+            timestamp: this.timestamp.toISOString(),
+            stack: this.stack,
+            cause: this.cause
+                ? {
+                    message: this.cause.message,
+                    stack: this.cause.stack,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Get a user-friendly error message
+     *
+     * Combines the error message with suggestion if available
+     *
+     * @returns Formatted error message
+     */
+    getUserMessage() {
+        if (this.suggestion) {
+            return `${this.message}\n\nSuggestion: ${this.suggestion}`;
+        }
+        return this.message;
+    }
+    /**
+     * Check if error is recoverable
+     *
+     * @returns True if the operation can be retried
+     */
+    isRecoverable() {
+        return this.recoverable;
+    }
+    /**
+     * Get formatted context string for logging
+     *
+     * @returns Formatted context information
+     */
+    getContextString() {
+        if (Object.keys(this.context).length === 0) {
+            return 'No additional context';
+        }
+        return Object.entries(this.context)
+            .map(([key, value]) => `  ${key}: ${JSON.stringify(value)}`)
+            .join('\n');
+    }
+    /**
+     * Create a detailed error report
+     *
+     * Useful for debugging or error logging
+     *
+     * @returns Formatted error report
+     */
+    getDetailedReport() {
+        const parts = [
+            `Error: ${this.message}`,
+            `Code: ${this.code}`,
+            `Severity: ${this.severity}`,
+            `Recoverable: ${this.recoverable ? 'Yes' : 'No'}`,
+            `Timestamp: ${this.timestamp.toISOString()}`,
+        ];
+        if (this.suggestion) {
+            parts.push(`Suggestion: ${this.suggestion}`);
+        }
+        if (Object.keys(this.context).length > 0) {
+            parts.push(`Context:\n${this.getContextString()}`);
+        }
+        if (this.cause) {
+            parts.push(`Caused by: ${this.cause.message}`);
+            if (this.cause.stack) {
+                parts.push(`Cause Stack:\n${this.cause.stack}`);
+            }
+        }
+        if (this.stack) {
+            parts.push(`Stack:\n${this.stack}`);
+        }
+        return parts.join('\n');
+    }
+}
+/**
+ * Type guard to check if an error is a DeploymentError
+ *
+ * @param error - The error to check
+ * @returns True if error is a DeploymentError
+ *
+ * @example
+ * try {
+ *   await deploy();
+ * } catch (error) {
+ *   if (isDeploymentError(error)) {
+ *     console.log(error.code);
+ *     console.log(error.context);
+ *   }
+ * }
+ */
+export function isDeploymentError(error) {
+    return error instanceof DeploymentError;
+}
+//# sourceMappingURL=deployment-error.js.map

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

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

package/dist/errors/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Error classes barrel export
+ *
+ * Centralized export point for all error types in deploy-ability
+ *
+ * @module errors
+ */
+export { DeploymentError, isDeploymentError, type ErrorContext, type ErrorSeverity, } from './deployment-error.js';
+export { WalletError, isWalletError, WalletErrorCodes, walletNotFoundError, connectionRejectedError, insufficientFundsError, walletLockedError, signingFailedError, networkMismatchError, type WalletErrorCode, } from './wallet-error.js';
+export { CertificateError, isCertificateError, CertificateErrorCodes, certificateNotFoundError, certificateInvalidError, certificateExpiredError, certificateCreationFailedError, certificateBroadcastFailedError, type CertificateErrorCode, } from './certificate-error.js';
+export { ProviderError, isProviderError, ProviderErrorCodes, providerUnreachableError, manifestRejectedError, noBidsReceivedError, containerTimeoutError, containerStartFailedError, type ProviderErrorCode, } from './provider-error.js';
+export { ProfileError, isProfileError, ProfileErrorCodes, agentJsonNotFoundError, agentJsonParseError, profileNotFoundError, noProfilesDefinedError, profileInvalidError, serviceConfigInvalidError, type ProfileErrorCode, } from './profile-error.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":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,18 @@
+/**
+ * Error classes barrel export
+ *
+ * Centralized export point for all error types in deploy-ability
+ *
+ * @module errors
+ */
+// Base error
+export { DeploymentError, isDeploymentError, } from './deployment-error.js';
+// Wallet errors
+export { WalletError, isWalletError, WalletErrorCodes, walletNotFoundError, connectionRejectedError, insufficientFundsError, walletLockedError, signingFailedError, networkMismatchError, } from './wallet-error.js';
+// Certificate errors
+export { CertificateError, isCertificateError, CertificateErrorCodes, certificateNotFoundError, certificateInvalidError, certificateExpiredError, certificateCreationFailedError, certificateBroadcastFailedError, } from './certificate-error.js';
+// Provider errors
+export { ProviderError, isProviderError, ProviderErrorCodes, providerUnreachableError, manifestRejectedError, noBidsReceivedError, containerTimeoutError, containerStartFailedError, } from './provider-error.js';
+// Profile errors
+export { ProfileError, isProfileError, ProfileErrorCodes, agentJsonNotFoundError, agentJsonParseError, profileNotFoundError, noProfilesDefinedError, profileInvalidError, serviceConfigInvalidError, } from './profile-error.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;;;;;;GAMG;AAEH,aAAa;AACb,OAAO,EACL,eAAe,EACf,iBAAiB,GAGlB,MAAM,uBAAuB,CAAC;AAE/B,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,GAEhC,MAAM,wBAAwB,CAAC;AAEhC,kBAAkB;AAClB,OAAO,EACL,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,GAE1B,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,GAE1B,MAAM,oBAAoB,CAAC"}