configforge 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/errors/ErrorTypes.d.ts

@@ -0,0 +1,103 @@
+import { ConfigForgeError } from '../types';
+/**
+ * File system related errors
+ */
+export declare class FileSystemError extends ConfigForgeError {
+    readonly code = "FILE_SYSTEM_ERROR";
+}
+/**
+ * Network related errors for remote file access
+ */
+export declare class NetworkError extends ConfigForgeError {
+    readonly code = "NETWORK_ERROR";
+}
+/**
+ * Type conversion errors
+ */
+export declare class TypeConversionError extends ConfigForgeError {
+    readonly code = "TYPE_CONVERSION_ERROR";
+}
+/**
+ * Circular reference errors
+ */
+export declare class CircularReferenceError extends ConfigForgeError {
+    readonly code = "CIRCULAR_REFERENCE_ERROR";
+}
+/**
+ * Memory limit errors
+ */
+export declare class MemoryLimitError extends ConfigForgeError {
+    readonly code = "MEMORY_LIMIT_ERROR";
+}
+/**
+ * Hook execution errors
+ */
+export declare class HookError extends ConfigForgeError {
+    readonly hookName: string;
+    readonly hookType: 'before' | 'after';
+    readonly code = "HOOK_ERROR";
+    constructor(message: string, hookName: string, hookType: 'before' | 'after', options?: {
+        path?: string;
+        context?: Record<string, any>;
+    });
+}
+/**
+ * Pipeline step errors
+ */
+export declare class PipelineStepError extends ConfigForgeError {
+    readonly stepName: string;
+    readonly stepIndex: number;
+    readonly code = "PIPELINE_STEP_ERROR";
+    constructor(message: string, stepName: string, stepIndex: number, options?: {
+        path?: string;
+        context?: Record<string, any>;
+    });
+}
+/**
+ * Aggregated error for multiple errors
+ */
+export declare class AggregateError extends ConfigForgeError {
+    readonly errors: ConfigForgeError[];
+    readonly code = "AGGREGATE_ERROR";
+    constructor(message: string, errors: ConfigForgeError[], options?: {
+        path?: string;
+        context?: Record<string, any>;
+    });
+    /**
+     * Get errors by code
+     */
+    getErrorsByCode(code: string): ConfigForgeError[];
+    /**
+     * Check if contains specific error type
+     */
+    hasErrorType(errorType: new (...args: any[]) => ConfigForgeError): boolean;
+}
+/**
+ * Recovery suggestion for errors
+ */
+export interface ErrorRecoverySuggestion {
+    action: string;
+    description: string;
+    code?: string;
+    automated?: boolean;
+}
+/**
+ * Enhanced error with recovery suggestions
+ */
+export declare class RecoverableError extends ConfigForgeError {
+    readonly suggestions: ErrorRecoverySuggestion[];
+    readonly code = "RECOVERABLE_ERROR";
+    constructor(message: string, suggestions: ErrorRecoverySuggestion[], options?: {
+        path?: string;
+        context?: Record<string, any>;
+    });
+    /**
+     * Get automated recovery suggestions
+     */
+    getAutomatedSuggestions(): ErrorRecoverySuggestion[];
+    /**
+     * Get manual recovery suggestions
+     */
+    getManualSuggestions(): ErrorRecoverySuggestion[];
+}
+//# sourceMappingURL=ErrorTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorTypes.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,QAAQ,CAAC,IAAI,uBAAuB;CACrC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,IAAI,mBAAmB;CACjC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,QAAQ,CAAC,IAAI,2BAA2B;CACzC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,IAAI,8BAA8B;CAC5C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,QAAQ,CAAC,IAAI,wBAAwB;CACtC;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,gBAAgB;aAK3B,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAL9C,QAAQ,CAAC,IAAI,gBAAgB;gBAG3B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAC5C,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B;CAIJ;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;aAKnC,QAAQ,EAAE,MAAM;aAChB,SAAS,EAAE,MAAM;IALnC,QAAQ,CAAC,IAAI,yBAAyB;gBAGpC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B;CAIJ;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;aAKhC,MAAM,EAAE,gBAAgB,EAAE;IAJ5C,QAAQ,CAAC,IAAI,qBAAqB;gBAGhC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,gBAAgB,EAAE,EAC1C,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B;IAKH;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIjD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,gBAAgB,GAAG,OAAO;CAG3E;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;aAKlC,WAAW,EAAE,uBAAuB,EAAE;IAJxD,QAAQ,CAAC,IAAI,uBAAuB;gBAGlC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,uBAAuB,EAAE,EACtD,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B;IAKH;;OAEG;IACH,uBAAuB,IAAI,uBAAuB,EAAE;IAIpD;;OAEG;IACH,oBAAoB,IAAI,uBAAuB,EAAE;CAGlD"}

package/dist/errors/ErrorTypes.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecoverableError = exports.AggregateError = exports.PipelineStepError = exports.HookError = exports.MemoryLimitError = exports.CircularReferenceError = exports.TypeConversionError = exports.NetworkError = exports.FileSystemError = void 0;
+const types_1 = require("../types");
+/**
+ * File system related errors
+ */
+class FileSystemError extends types_1.ConfigForgeError {
+    constructor() {
+        super(...arguments);
+        this.code = 'FILE_SYSTEM_ERROR';
+    }
+}
+exports.FileSystemError = FileSystemError;
+/**
+ * Network related errors for remote file access
+ */
+class NetworkError extends types_1.ConfigForgeError {
+    constructor() {
+        super(...arguments);
+        this.code = 'NETWORK_ERROR';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Type conversion errors
+ */
+class TypeConversionError extends types_1.ConfigForgeError {
+    constructor() {
+        super(...arguments);
+        this.code = 'TYPE_CONVERSION_ERROR';
+    }
+}
+exports.TypeConversionError = TypeConversionError;
+/**
+ * Circular reference errors
+ */
+class CircularReferenceError extends types_1.ConfigForgeError {
+    constructor() {
+        super(...arguments);
+        this.code = 'CIRCULAR_REFERENCE_ERROR';
+    }
+}
+exports.CircularReferenceError = CircularReferenceError;
+/**
+ * Memory limit errors
+ */
+class MemoryLimitError extends types_1.ConfigForgeError {
+    constructor() {
+        super(...arguments);
+        this.code = 'MEMORY_LIMIT_ERROR';
+    }
+}
+exports.MemoryLimitError = MemoryLimitError;
+/**
+ * Hook execution errors
+ */
+class HookError extends types_1.ConfigForgeError {
+    constructor(message, hookName, hookType, options) {
+        super(message, options);
+        this.hookName = hookName;
+        this.hookType = hookType;
+        this.code = 'HOOK_ERROR';
+    }
+}
+exports.HookError = HookError;
+/**
+ * Pipeline step errors
+ */
+class PipelineStepError extends types_1.ConfigForgeError {
+    constructor(message, stepName, stepIndex, options) {
+        super(message, options);
+        this.stepName = stepName;
+        this.stepIndex = stepIndex;
+        this.code = 'PIPELINE_STEP_ERROR';
+    }
+}
+exports.PipelineStepError = PipelineStepError;
+/**
+ * Aggregated error for multiple errors
+ */
+class AggregateError extends types_1.ConfigForgeError {
+    constructor(message, errors, options) {
+        super(message, options);
+        this.errors = errors;
+        this.code = 'AGGREGATE_ERROR';
+    }
+    /**
+     * Get errors by code
+     */
+    getErrorsByCode(code) {
+        return this.errors.filter(error => error.code === code);
+    }
+    /**
+     * Check if contains specific error type
+     */
+    hasErrorType(errorType) {
+        return this.errors.some(error => error instanceof errorType);
+    }
+}
+exports.AggregateError = AggregateError;
+/**
+ * Enhanced error with recovery suggestions
+ */
+class RecoverableError extends types_1.ConfigForgeError {
+    constructor(message, suggestions, options) {
+        super(message, options);
+        this.suggestions = suggestions;
+        this.code = 'RECOVERABLE_ERROR';
+    }
+    /**
+     * Get automated recovery suggestions
+     */
+    getAutomatedSuggestions() {
+        return this.suggestions.filter(s => s.automated);
+    }
+    /**
+     * Get manual recovery suggestions
+     */
+    getManualSuggestions() {
+        return this.suggestions.filter(s => !s.automated);
+    }
+}
+exports.RecoverableError = RecoverableError;
+//# sourceMappingURL=ErrorTypes.js.map

package/dist/errors/ErrorTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorTypes.js","sourceRoot":"","sources":["../../src/errors/ErrorTypes.ts"],"names":[],"mappings":";;;AAAA,oCAA4C;AAE5C;;GAEG;AACH,MAAa,eAAgB,SAAQ,wBAAgB;IAArD;;QACW,SAAI,GAAG,mBAAmB,CAAC;IACtC,CAAC;CAAA;AAFD,0CAEC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,wBAAgB;IAAlD;;QACW,SAAI,GAAG,eAAe,CAAC;IAClC,CAAC;CAAA;AAFD,oCAEC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,wBAAgB;IAAzD;;QACW,SAAI,GAAG,uBAAuB,CAAC;IAC1C,CAAC;CAAA;AAFD,kDAEC;AAED;;GAEG;AACH,MAAa,sBAAuB,SAAQ,wBAAgB;IAA5D;;QACW,SAAI,GAAG,0BAA0B,CAAC;IAC7C,CAAC;CAAA;AAFD,wDAEC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,wBAAgB;IAAtD;;QACW,SAAI,GAAG,oBAAoB,CAAC;IACvC,CAAC;CAAA;AAFD,4CAEC;AAED;;GAEG;AACH,MAAa,SAAU,SAAQ,wBAAgB;IAG7C,YACE,OAAe,EACC,QAAgB,EAChB,QAA4B,EAC5C,OAGC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAPR,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAoB;QALrC,SAAI,GAAG,YAAY,CAAC;IAY7B,CAAC;CACF;AAdD,8BAcC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,wBAAgB;IAGrD,YACE,OAAe,EACC,QAAgB,EAChB,SAAiB,EACjC,OAGC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAPR,aAAQ,GAAR,QAAQ,CAAQ;QAChB,cAAS,GAAT,SAAS,CAAQ;QAL1B,SAAI,GAAG,qBAAqB,CAAC;IAYtC,CAAC;CACF;AAdD,8CAcC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,wBAAgB;IAGlD,YACE,OAAe,EACC,MAA0B,EAC1C,OAGC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QANR,WAAM,GAAN,MAAM,CAAoB;QAJnC,SAAI,GAAG,iBAAiB,CAAC;IAWlC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAmD;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,YAAY,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF;AA3BD,wCA2BC;AAYD;;GAEG;AACH,MAAa,gBAAiB,SAAQ,wBAAgB;IAGpD,YACE,OAAe,EACC,WAAsC,EACtD,OAGC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QANR,gBAAW,GAAX,WAAW,CAA2B;QAJ/C,SAAI,GAAG,mBAAmB,CAAC;IAWpC,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AA3BD,4CA2BC"}

package/dist/errors/SpecificErrors.d.ts

@@ -0,0 +1,45 @@
+import { ConfigForgeError } from '../types';
+/**
+ * Specific error types for different ConfigForge scenarios
+ */
+export declare class SchemaError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, schemaName?: string);
+}
+export declare class PathError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, path: string, availablePaths?: string[]);
+}
+export declare class ConversionError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, fromType: string, toType: string, value?: any);
+}
+export declare class FileError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, filePath: string, operation: 'read' | 'write' | 'parse');
+}
+export declare class ConfigurationError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, configKey?: string, validValues?: string[]);
+}
+export declare class DependencyError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, dependency: string, requiredBy?: string);
+}
+export declare class TimeoutError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, operation: string, timeoutMs: number);
+}
+export declare class ConcurrencyError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, operation: string, maxConcurrency?: number);
+}
+export declare class SecurityError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, securityCheck: string, limit?: number);
+}
+export declare class CompatibilityError extends ConfigForgeError {
+    code: string;
+    constructor(message: string, feature: string, requiredVersion?: string);
+}
+//# sourceMappingURL=SpecificErrors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpecificErrors.d.ts","sourceRoot":"","sources":["../../src/errors/SpecificErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AAEH,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,IAAI,SAAkB;gBAEV,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAOjD;AAED,qBAAa,SAAU,SAAQ,gBAAgB;IAC7C,IAAI,SAAgB;gBAER,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE;CASrE;AAED,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,IAAI,SAAsB;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;CAM3E;AAED,qBAAa,SAAU,SAAQ,gBAAgB;IAC7C,IAAI,SAAgB;gBAGlB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;CAaxC;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,IAAI,SAAyB;gBAEjB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;CAQxE;AAED,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,IAAI,SAAsB;gBAEd,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMrE;AAED,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,IAAI,SAAmB;gBAEX,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMlE;AAED,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,IAAI,SAAuB;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;CAQxE;AAED,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,IAAI,SAAoB;gBAEZ,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAQnE;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,IAAI,SAAyB;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM;CAQvE"}

package/dist/errors/SpecificErrors.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompatibilityError = exports.SecurityError = exports.ConcurrencyError = exports.TimeoutError = exports.DependencyError = exports.ConfigurationError = exports.FileError = exports.ConversionError = exports.PathError = exports.SchemaError = void 0;
+const types_1 = require("../types");
+/**
+ * Specific error types for different ConfigForge scenarios
+ */
+class SchemaError extends types_1.ConfigForgeError {
+    constructor(message, schemaName) {
+        super(message, {
+            context: { schemaName },
+            suggestion: 'Check schema definition and ensure all required fields are present',
+        });
+        this.code = 'SCHEMA_ERROR';
+    }
+}
+exports.SchemaError = SchemaError;
+class PathError extends types_1.ConfigForgeError {
+    constructor(message, path, availablePaths) {
+        super(message, {
+            path,
+            context: { availablePaths },
+            suggestion: availablePaths?.length
+                ? `Available paths: ${availablePaths.slice(0, 5).join(', ')}${availablePaths.length > 5 ? '...' : ''}`
+                : 'Check the path syntax and ensure the field exists in the source data',
+        });
+        this.code = 'PATH_ERROR';
+    }
+}
+exports.PathError = PathError;
+class ConversionError extends types_1.ConfigForgeError {
+    constructor(message, fromType, toType, value) {
+        super(message, {
+            context: { fromType, toType, value },
+            suggestion: `Cannot convert ${fromType} to ${toType}. Consider using a transform function.`,
+        });
+        this.code = 'CONVERSION_ERROR';
+    }
+}
+exports.ConversionError = ConversionError;
+class FileError extends types_1.ConfigForgeError {
+    constructor(message, filePath, operation) {
+        super(message, {
+            path: filePath,
+            context: { operation },
+            suggestion: operation === 'read'
+                ? 'Check if the file exists and you have read permissions'
+                : operation === 'write'
+                    ? 'Check if the directory exists and you have write permissions'
+                    : 'Check if the file format is supported and the content is valid',
+        });
+        this.code = 'FILE_ERROR';
+    }
+}
+exports.FileError = FileError;
+class ConfigurationError extends types_1.ConfigForgeError {
+    constructor(message, configKey, validValues) {
+        super(message, {
+            context: { configKey, validValues },
+            suggestion: validValues?.length
+                ? `Valid values for ${configKey}: ${validValues.join(', ')}`
+                : 'Check the configuration documentation for valid options',
+        });
+        this.code = 'CONFIGURATION_ERROR';
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class DependencyError extends types_1.ConfigForgeError {
+    constructor(message, dependency, requiredBy) {
+        super(message, {
+            context: { dependency, requiredBy },
+            suggestion: `Install the required dependency: npm install ${dependency}`,
+        });
+        this.code = 'DEPENDENCY_ERROR';
+    }
+}
+exports.DependencyError = DependencyError;
+class TimeoutError extends types_1.ConfigForgeError {
+    constructor(message, operation, timeoutMs) {
+        super(message, {
+            context: { operation, timeoutMs },
+            suggestion: `Operation '${operation}' timed out after ${timeoutMs}ms. Consider increasing the timeout or simplifying the operation.`,
+        });
+        this.code = 'TIMEOUT_ERROR';
+    }
+}
+exports.TimeoutError = TimeoutError;
+class ConcurrencyError extends types_1.ConfigForgeError {
+    constructor(message, operation, maxConcurrency) {
+        super(message, {
+            context: { operation, maxConcurrency },
+            suggestion: maxConcurrency
+                ? `Reduce concurrency level (current max: ${maxConcurrency}) or process items sequentially`
+                : 'Consider processing items sequentially to avoid concurrency issues',
+        });
+        this.code = 'CONCURRENCY_ERROR';
+    }
+}
+exports.ConcurrencyError = ConcurrencyError;
+class SecurityError extends types_1.ConfigForgeError {
+    constructor(message, securityCheck, limit) {
+        super(message, {
+            context: { securityCheck, limit },
+            suggestion: limit
+                ? `Security limit exceeded: ${securityCheck} (limit: ${limit}). Reduce the input size or adjust security settings.`
+                : `Security check failed: ${securityCheck}. Review the input data for potential security issues.`,
+        });
+        this.code = 'SECURITY_ERROR';
+    }
+}
+exports.SecurityError = SecurityError;
+class CompatibilityError extends types_1.ConfigForgeError {
+    constructor(message, feature, requiredVersion) {
+        super(message, {
+            context: { feature, requiredVersion },
+            suggestion: requiredVersion
+                ? `Feature '${feature}' requires version ${requiredVersion} or higher`
+                : `Feature '${feature}' is not compatible with the current configuration`,
+        });
+        this.code = 'COMPATIBILITY_ERROR';
+    }
+}
+exports.CompatibilityError = CompatibilityError;
+//# sourceMappingURL=SpecificErrors.js.map

package/dist/errors/SpecificErrors.js.map

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

package/dist/errors/SuggestionEngine.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Suggestion engine for providing helpful error messages and corrections
+ */
+export declare class SuggestionEngine {
+    private static readonly SIMILARITY_THRESHOLD;
+    private static readonly MAX_SUGGESTIONS;
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    private static levenshteinDistance;
+    /**
+     * Calculate similarity score between two strings (0-1, where 1 is identical)
+     */
+    private static calculateSimilarity;
+    /**
+     * Find similar strings from a list of candidates
+     */
+    static findSimilar(target: string, candidates: string[], threshold?: number): Array<{
+        value: string;
+        similarity: number;
+    }>;
+    /**
+     * Suggest field names for mapping errors
+     */
+    static suggestFieldNames(invalidField: string, availableFields: string[]): string[];
+    /**
+     * Suggest property paths for nested object access
+     */
+    static suggestPropertyPaths(invalidPath: string, availablePaths: string[]): string[];
+    /**
+     * Suggest configuration values
+     */
+    static suggestConfigValues(invalidValue: string, validValues: string[]): string[];
+    /**
+     * Generate helpful error message for missing fields
+     */
+    static generateMissingFieldMessage(missingField: string, availableFields: string[]): string;
+    /**
+     * Generate helpful error message for invalid paths
+     */
+    static generateInvalidPathMessage(invalidPath: string, availablePaths: string[]): string;
+    /**
+     * Generate helpful error message for invalid configuration
+     */
+    static generateInvalidConfigMessage(configKey: string, invalidValue: string, validValues: string[]): string;
+    /**
+     * Generate suggestions for transform function errors
+     */
+    static suggestTransformFix(error: Error, inputValue: any, expectedType?: string): string;
+    /**
+     * Generate suggestions for validation errors
+     */
+    static suggestValidationFix(fieldPath: string, value: any, validationRule: string): string;
+    /**
+     * Extract all possible paths from an object for suggestions
+     */
+    static extractPaths(obj: any, prefix?: string): string[];
+    /**
+     * Extract field names from an object (top-level and nested)
+     */
+    static extractFieldNames(obj: any, includeNested?: boolean): string[];
+}
+//# sourceMappingURL=SuggestionEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestionEngine.d.ts","sourceRoot":"","sources":["../../src/errors/SuggestionEngine.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAO;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAK;IAE5C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA4BlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAsBlC;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,GAAE,MAA8C,GACxD,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAwB/C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,EAAE;IAkBX;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE;IAyDX;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,EAAE;IAkBX;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAChC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM;IAkBT;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM;IAkBT;;OAEG;IACH,MAAM,CAAC,4BAA4B,CACjC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM;IAmBT;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,GAAG,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM;IA+BT;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,GAAG,EACV,cAAc,EAAE,MAAM,GACrB,MAAM;IAgCT;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,EAAE;IAwB5D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,GAAE,OAAc,GAAG,MAAM,EAAE;CA6B5E"}