@jterrats/smart-deployment 1.0.3

package/lib/errors/network-error.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Network Error Classes - US-072
+ * Specialized errors for network operations
+ *
+ * @ac US-072-AC-1: Detect network errors
+ * @ac US-072-AC-6: User-friendly error messages
+ * @issue #72
+ */
+import { SmartDeploymentError } from './base-error.js';
+export type NetworkErrorOptions = {
+    url?: string;
+    statusCode?: number;
+    timeout?: number;
+    retryCount?: number;
+    originalError?: Error;
+};
+/**
+ * @ac US-072-AC-1: Detect network errors
+ * Base class for network-related errors
+ */
+export declare class NetworkError extends SmartDeploymentError {
+    readonly url?: string;
+    readonly statusCode?: number;
+    constructor(message: string, options?: NetworkErrorOptions, code?: string);
+    /**
+     * @ac US-072-AC-6: User-friendly error messages
+     * Get suggestions based on error type
+     */
+    private static getSuggestions;
+    /**
+     * @ac US-072-AC-1: Detect network errors
+     * Check if error is a network error
+     */
+    static isNetworkError(error: unknown): boolean;
+}
+/**
+ * Timeout-specific error
+ */
+export declare class TimeoutError extends NetworkError {
+    constructor(url: string, timeout: number);
+}
+/**
+ * Connection error
+ */
+export declare class ConnectionError extends NetworkError {
+    constructor(url: string, originalError?: Error);
+}
+/**
+ * HTTP error
+ */
+export declare class HttpError extends NetworkError {
+    constructor(url: string, statusCode: number, statusText?: string);
+}

package/lib/errors/network-error.js

@@ -0,0 +1,111 @@
+/**
+ * Network Error Classes - US-072
+ * Specialized errors for network operations
+ *
+ * @ac US-072-AC-1: Detect network errors
+ * @ac US-072-AC-6: User-friendly error messages
+ * @issue #72
+ */
+import { SmartDeploymentError } from './base-error.js';
+/**
+ * @ac US-072-AC-1: Detect network errors
+ * Base class for network-related errors
+ */
+export class NetworkError extends SmartDeploymentError {
+    url;
+    statusCode;
+    constructor(message, options = {}, code = 'NETWORK_ERROR') {
+        const context = {
+            url: options.url,
+            statusCode: options.statusCode,
+            timeout: options.timeout,
+            retryCount: options.retryCount,
+        };
+        const suggestions = NetworkError.getSuggestions(options);
+        super(message, code, context, suggestions);
+        this.url = options.url;
+        this.statusCode = options.statusCode;
+    }
+    /**
+     * @ac US-072-AC-6: User-friendly error messages
+     * Get suggestions based on error type
+     */
+    static getSuggestions(options) {
+        const suggestions = [];
+        if (options.statusCode === 404) {
+            suggestions.push('Check if the endpoint URL is correct');
+            suggestions.push('Verify the resource exists');
+        }
+        else if (options.statusCode === 401 || options.statusCode === 403) {
+            suggestions.push('Check your authentication credentials');
+            suggestions.push('Verify API permissions');
+        }
+        else if (options.statusCode && options.statusCode >= 500) {
+            suggestions.push('Server error - retry after a few minutes');
+            suggestions.push('Check server status');
+        }
+        else if (options.timeout) {
+            suggestions.push('Request timed out - check your network connection');
+            suggestions.push('Try increasing timeout value');
+        }
+        else {
+            suggestions.push('Check your internet connection');
+            suggestions.push('Verify firewall settings');
+            suggestions.push('Try again later');
+        }
+        return suggestions;
+    }
+    /**
+     * @ac US-072-AC-1: Detect network errors
+     * Check if error is a network error
+     */
+    static isNetworkError(error) {
+        if (error instanceof NetworkError)
+            return true;
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            return (message.includes('network') ||
+                message.includes('econnrefused') ||
+                message.includes('enotfound') ||
+                message.includes('etimedout') ||
+                message.includes('fetch') ||
+                message.includes('socket') ||
+                message.includes('connection'));
+        }
+        return false;
+    }
+}
+/**
+ * Timeout-specific error
+ */
+export class TimeoutError extends NetworkError {
+    constructor(url, timeout) {
+        super(`Request timeout after ${timeout}ms`, {
+            url,
+            timeout,
+        }, 'NETWORK_TIMEOUT');
+    }
+}
+/**
+ * Connection error
+ */
+export class ConnectionError extends NetworkError {
+    constructor(url, originalError) {
+        super(`Failed to connect to ${url}`, {
+            url,
+            originalError,
+        }, 'NETWORK_CONNECTION_FAILED');
+    }
+}
+/**
+ * HTTP error
+ */
+export class HttpError extends NetworkError {
+    constructor(url, statusCode, statusText) {
+        super(`HTTP ${statusCode}${statusText ? ': ' + statusText : ''} at ${url}`, {
+            url,
+            statusCode,
+        }, 'NETWORK_HTTP_ERROR');
+    }
+}
+//# sourceMappingURL=network-error.js.map

package/lib/errors/network-error.js.map

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

package/lib/errors/parsing-error.d.ts

@@ -0,0 +1,41 @@
+import { SmartDeploymentError } from './base-error.js';
+/**
+ * Error thrown when parsing metadata or project files fails
+ *
+ * @example
+ * ```typescript
+ * throw new ParsingError('Failed to parse package.xml', {
+ *   filePath: '/path/to/package.xml',
+ *   line: 42,
+ *   column: 15,
+ *   parseError: 'Unexpected token <'
+ * });
+ * ```
+ */
+export declare class ParsingError extends SmartDeploymentError {
+    constructor(message: string, context?: {
+        [key: string]: unknown;
+        filePath?: string;
+        line?: number;
+        column?: number;
+        parseError?: string;
+    });
+}
+/**
+ * Error thrown when XML parsing fails specifically
+ */
+export declare class XmlParsingError extends ParsingError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when JSON parsing fails specifically
+ */
+export declare class JsonParsingError extends ParsingError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when SFDX project structure is invalid
+ */
+export declare class ProjectStructureError extends ParsingError {
+    constructor(message: string, context?: Record<string, unknown>);
+}

package/lib/errors/parsing-error.js

@@ -0,0 +1,69 @@
+import { SmartDeploymentError } from './base-error.js';
+/**
+ * Error thrown when parsing metadata or project files fails
+ *
+ * @example
+ * ```typescript
+ * throw new ParsingError('Failed to parse package.xml', {
+ *   filePath: '/path/to/package.xml',
+ *   line: 42,
+ *   column: 15,
+ *   parseError: 'Unexpected token <'
+ * });
+ * ```
+ */
+export class ParsingError extends SmartDeploymentError {
+    constructor(message, context = {}) {
+        const suggestions = [];
+        // Add context-specific suggestions
+        if (context.filePath?.endsWith('.xml')) {
+            suggestions.push('Validate XML syntax using an XML validator');
+            suggestions.push('Check for unclosed tags or invalid characters');
+        }
+        if (context.filePath?.endsWith('.json')) {
+            suggestions.push('Validate JSON syntax using a JSON validator');
+            suggestions.push('Check for trailing commas or unquoted keys');
+        }
+        if (context.line && context.column) {
+            suggestions.push(`Check line ${context.line}, column ${context.column} in the file`);
+        }
+        if (context.filePath) {
+            suggestions.push(`Review file: ${context.filePath}`);
+        }
+        super(message, 'PARSING_ERROR', context, suggestions);
+    }
+}
+/**
+ * Error thrown when XML parsing fails specifically
+ */
+export class XmlParsingError extends ParsingError {
+    constructor(message, context = {}) {
+        super(`XML parsing failed: ${message}`, {
+            ...context,
+            xmlError: true,
+        });
+    }
+}
+/**
+ * Error thrown when JSON parsing fails specifically
+ */
+export class JsonParsingError extends ParsingError {
+    constructor(message, context = {}) {
+        super(`JSON parsing failed: ${message}`, {
+            ...context,
+            jsonError: true,
+        });
+    }
+}
+/**
+ * Error thrown when SFDX project structure is invalid
+ */
+export class ProjectStructureError extends ParsingError {
+    constructor(message, context = {}) {
+        super(`Invalid project structure: ${message}`, context);
+        this.suggestions.push('Ensure sfdx-project.json exists and is valid');
+        this.suggestions.push('Check packageDirectories configuration');
+        this.suggestions.push('Run: sf project validate');
+    }
+}
+//# sourceMappingURL=parsing-error.js.map

package/lib/errors/parsing-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing-error.js","sourceRoot":"","sources":["../../src/errors/parsing-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAa,SAAQ,oBAAoB;IACpD,YACE,OAAe,EACf,UAMI,EAAE;QAEN,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,mCAAmC;QACnC,IAAI,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,WAAW,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC/D,WAAW,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAChE,WAAW,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,WAAW,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,IAAI,YAAY,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,WAAW,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAmB,OAAe,EAAE,UAAmC,EAAE;QACvE,KAAK,CAAC,uBAAuB,OAAO,EAAE,EAAE;YACtC,GAAG,OAAO;YACV,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,YAAmB,OAAe,EAAE,UAAmC,EAAE;QACvE,KAAK,CAAC,wBAAwB,OAAO,EAAE,EAAE;YACvC,GAAG,OAAO;YACV,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,YAAmB,OAAe,EAAE,UAAmC,EAAE;QACvE,KAAK,CAAC,8BAA8B,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAExD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QACtE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACpD,CAAC;CACF"}

package/lib/errors/validation-error-reporter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Validation Error Reporter - US-075
+ * Clear validation error messages with documentation links
+ *
+ * @ac US-075-AC-1: User-friendly error messages
+ * @ac US-075-AC-2: Include file paths
+ * @ac US-075-AC-3: Include line numbers
+ * @ac US-075-AC-4: Suggest fixes
+ * @ac US-075-AC-5: Link to documentation
+ * @ac US-075-AC-6: Categorize by severity
+ * @issue #75
+ */
+import { ValidationError } from './validation-error.js';
+export declare class ValidationErrorReporter {
+    /**
+     * @ac US-075-AC-5: Link to documentation
+     * Get documentation link for error
+     */
+    getDocumentationLink(errorCode: string): string;
+    /**
+     * @ac US-075-AC-1: User-friendly error messages
+     * @ac US-075-AC-2: Include file paths
+     * @ac US-075-AC-3: Include line numbers
+     * @ac US-075-AC-4: Suggest fixes
+     * @ac US-075-AC-5: Link to documentation
+     * Format validation error with all details
+     */
+    format(error: ValidationError): string;
+    /**
+     * @ac US-075-AC-6: Categorize by severity
+     * Format multiple validation errors grouped by severity
+     */
+    formatMultiple(errors: ValidationError[]): string;
+}

package/lib/errors/validation-error-reporter.js

@@ -0,0 +1,99 @@
+/**
+ * Validation Error Reporter - US-075
+ * Clear validation error messages with documentation links
+ *
+ * @ac US-075-AC-1: User-friendly error messages
+ * @ac US-075-AC-2: Include file paths
+ * @ac US-075-AC-3: Include line numbers
+ * @ac US-075-AC-4: Suggest fixes
+ * @ac US-075-AC-5: Link to documentation
+ * @ac US-075-AC-6: Categorize by severity
+ * @issue #75
+ */
+const DOCS_BASE_URL = 'https://github.com/jterrats/smart-deployment/blob/main/docs';
+export class ValidationErrorReporter {
+    /**
+     * @ac US-075-AC-5: Link to documentation
+     * Get documentation link for error
+     */
+    getDocumentationLink(errorCode) {
+        const docMap = {
+            INVALID_DEPENDENCY: `${DOCS_BASE_URL}/errors/INVALID_DEPENDENCY.md`,
+            CIRCULAR_DEPENDENCY: `${DOCS_BASE_URL}/errors/CIRCULAR_DEPENDENCY.md`,
+            MISSING_COMPONENT: `${DOCS_BASE_URL}/errors/MISSING_COMPONENT.md`,
+            INVALID_METADATA: `${DOCS_BASE_URL}/errors/INVALID_METADATA.md`,
+        };
+        return docMap[errorCode] || `${DOCS_BASE_URL}/ERROR_CATALOG.md`;
+    }
+    /**
+     * @ac US-075-AC-1: User-friendly error messages
+     * @ac US-075-AC-2: Include file paths
+     * @ac US-075-AC-3: Include line numbers
+     * @ac US-075-AC-4: Suggest fixes
+     * @ac US-075-AC-5: Link to documentation
+     * Format validation error with all details
+     */
+    format(error) {
+        const lines = [];
+        lines.push(`❌ ${error.name} [${error.code}]`);
+        lines.push(`   ${error.message}`);
+        lines.push('');
+        // File and line info
+        if (error.context.file) {
+            lines.push(`📁 File: ${error.context.file}`);
+            if (error.context.line) {
+                lines.push(`📍 Line: ${error.context.line}`);
+            }
+            lines.push('');
+        }
+        // Suggestions
+        if (error.suggestions.length > 0) {
+            lines.push('💡 Suggested Fixes:');
+            for (const suggestion of error.suggestions) {
+                lines.push(`   • ${suggestion}`);
+            }
+            lines.push('');
+        }
+        // Documentation link
+        const docLink = this.getDocumentationLink(error.code);
+        lines.push(`📖 Documentation: ${docLink}`);
+        return lines.join('\n');
+    }
+    /**
+     * @ac US-075-AC-6: Categorize by severity
+     * Format multiple validation errors grouped by severity
+     */
+    formatMultiple(errors) {
+        const lines = [];
+        lines.push('📋 Validation Errors Report');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`Total Errors: ${errors.length}`);
+        lines.push('');
+        // Group by severity (based on code)
+        const critical = errors.filter((e) => e.code.includes('CRITICAL'));
+        const high = errors.filter((e) => e.code.includes('ERROR'));
+        const medium = errors.filter((e) => e.code.includes('WARNING'));
+        if (critical.length > 0) {
+            lines.push(`🔴 Critical (${critical.length}):`);
+            for (const error of critical) {
+                lines.push(`   ${error.message}`);
+            }
+            lines.push('');
+        }
+        if (high.length > 0) {
+            lines.push(`🟠 Errors (${high.length}):`);
+            for (const error of high) {
+                lines.push(`   ${error.message}`);
+            }
+            lines.push('');
+        }
+        if (medium.length > 0) {
+            lines.push(`🟡 Warnings (${medium.length}):`);
+            for (const error of medium) {
+                lines.push(`   ${error.message}`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=validation-error-reporter.js.map

package/lib/errors/validation-error-reporter.js.map

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

package/lib/errors/validation-error.d.ts

@@ -0,0 +1,58 @@
+import { SmartDeploymentError } from './base-error.js';
+/**
+ * Error thrown when metadata or configuration validation fails
+ *
+ * @example
+ * ```typescript
+ * throw new ValidationError('Invalid API version', {
+ *   currentVersion: '30.0',
+ *   minimumVersion: '40.0',
+ *   field: 'sourceApiVersion'
+ * });
+ * ```
+ */
+export declare class ValidationError extends SmartDeploymentError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when required configuration is missing
+ */
+export declare class ConfigurationError extends ValidationError {
+    constructor(missingConfig: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when API version is invalid or outdated
+ */
+export declare class ApiVersionError extends ValidationError {
+    constructor(currentVersion: string, minimumVersion: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when metadata type is unknown or unsupported
+ */
+export declare class UnknownMetadataTypeError extends ValidationError {
+    constructor(metadataType: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when component count exceeds limits
+ */
+export declare class ComponentCountError extends ValidationError {
+    constructor(count: number, limit: number, componentType?: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when required metadata is missing
+ */
+export declare class MissingMetadataError extends ValidationError {
+    constructor(metadataType: string, metadataName: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when file or directory does not exist
+ */
+export declare class FileNotFoundError extends ValidationError {
+    constructor(filePath: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when file permissions are insufficient
+ */
+export declare class PermissionError extends ValidationError {
+    constructor(filePath: string, operation: string, context?: Record<string, unknown>);
+}

package/lib/errors/validation-error.js

@@ -0,0 +1,131 @@
+import { SmartDeploymentError } from './base-error.js';
+/**
+ * Error thrown when metadata or configuration validation fails
+ *
+ * @example
+ * ```typescript
+ * throw new ValidationError('Invalid API version', {
+ *   currentVersion: '30.0',
+ *   minimumVersion: '40.0',
+ *   field: 'sourceApiVersion'
+ * });
+ * ```
+ */
+export class ValidationError extends SmartDeploymentError {
+    constructor(message, context = {}) {
+        const suggestions = [];
+        // Add context-specific suggestions
+        if (context.field) {
+            suggestions.push(`Check field: ${String(context.field)}`);
+        }
+        if (context.minimumVersion) {
+            suggestions.push(`Update to minimum version: ${String(context.minimumVersion)}`);
+        }
+        if (context.allowedValues) {
+            suggestions.push(`Allowed values: ${JSON.stringify(context.allowedValues)}`);
+        }
+        super(message, 'VALIDATION_ERROR', context, suggestions);
+    }
+}
+/**
+ * Error thrown when required configuration is missing
+ */
+export class ConfigurationError extends ValidationError {
+    constructor(missingConfig, context = {}) {
+        super(`Missing required configuration: ${missingConfig}`, {
+            ...context,
+            missingConfig,
+        });
+        this.suggestions.push(`Add '${missingConfig}' to your configuration`);
+        this.suggestions.push('Check .sfsmartdeploy.json or CLI flags');
+    }
+}
+/**
+ * Error thrown when API version is invalid or outdated
+ */
+export class ApiVersionError extends ValidationError {
+    constructor(currentVersion, minimumVersion, context = {}) {
+        super(`API version ${currentVersion} is below minimum ${minimumVersion}`, {
+            ...context,
+            currentVersion,
+            minimumVersion,
+        });
+        this.suggestions.push(`Update sourceApiVersion in sfdx-project.json to ${minimumVersion} or higher`);
+        this.suggestions.push('Salesforce deprecates API versions older than 3 years');
+        this.suggestions.push('Consider using the latest API version for new features');
+    }
+}
+/**
+ * Error thrown when metadata type is unknown or unsupported
+ */
+export class UnknownMetadataTypeError extends ValidationError {
+    constructor(metadataType, context = {}) {
+        super(`Unknown metadata type: ${metadataType}`, {
+            ...context,
+            metadataType,
+        });
+        this.suggestions.push('Check metadata type spelling and casing');
+        this.suggestions.push('Verify the type exists in Salesforce documentation');
+        this.suggestions.push('Type may be new - update plugin to latest version');
+    }
+}
+/**
+ * Error thrown when component count exceeds limits
+ */
+export class ComponentCountError extends ValidationError {
+    constructor(count, limit, componentType, context = {}) {
+        const typeStr = componentType ? ` ${componentType}` : '';
+        super(`Too many${typeStr} components: ${count} exceeds limit of ${limit}`, {
+            ...context,
+            count,
+            limit,
+            componentType,
+        });
+        this.suggestions.push('Split deployment into multiple waves');
+        this.suggestions.push('Use selective deployment for changed components only');
+    }
+}
+/**
+ * Error thrown when required metadata is missing
+ */
+export class MissingMetadataError extends ValidationError {
+    constructor(metadataType, metadataName, context = {}) {
+        super(`Missing required ${metadataType}: ${metadataName}`, {
+            ...context,
+            metadataType,
+            metadataName,
+        });
+        this.suggestions.push(`Add ${metadataType} '${metadataName}' to your deployment`);
+        this.suggestions.push('Check if the component was deleted or renamed');
+    }
+}
+/**
+ * Error thrown when file or directory does not exist
+ */
+export class FileNotFoundError extends ValidationError {
+    constructor(filePath, context = {}) {
+        super(`File or directory not found: ${filePath}`, {
+            ...context,
+            filePath,
+        });
+        this.suggestions.push(`Verify path exists: ${filePath}`);
+        this.suggestions.push('Check for typos in file path');
+        this.suggestions.push('Ensure you are in the correct directory');
+    }
+}
+/**
+ * Error thrown when file permissions are insufficient
+ */
+export class PermissionError extends ValidationError {
+    constructor(filePath, operation, context = {}) {
+        super(`Permission denied: cannot ${operation} ${filePath}`, {
+            ...context,
+            filePath,
+            operation,
+        });
+        this.suggestions.push(`Check file permissions: ls -la ${filePath}`);
+        this.suggestions.push(`Grant ${operation} permission: chmod +r ${filePath}`);
+        this.suggestions.push('Run command with appropriate user privileges');
+    }
+}
+//# sourceMappingURL=validation-error.js.map

package/lib/errors/validation-error.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/lib/index.js

@@ -0,0 +1,2 @@
+export default {};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe,EAAE,CAAC"}