@hypercli/core 0.1.1

package/dist/errors/hypergen-errors.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Hypergen Error System
+ *
+ * Provides comprehensive error handling with user-friendly messages
+ * and actionable guidance for common issues
+ */
+export declare enum ErrorCode {
+    CONFIG_FILE_NOT_FOUND = "CONFIG_FILE_NOT_FOUND",
+    CONFIG_INVALID_FORMAT = "CONFIG_INVALID_FORMAT",
+    CONFIG_MISSING_REQUIRED = "CONFIG_MISSING_REQUIRED",
+    TEMPLATE_NOT_FOUND = "TEMPLATE_NOT_FOUND",
+    TEMPLATE_INVALID_SYNTAX = "TEMPLATE_INVALID_SYNTAX",
+    TEMPLATE_MISSING_VARIABLES = "TEMPLATE_MISSING_VARIABLES",
+    TEMPLATE_INVALID_FRONTMATTER = "TEMPLATE_INVALID_FRONTMATTER",
+    TEMPLATE_PARSING_ERROR = "TEMPLATE_PARSING_ERROR",
+    TEMPLATE_EXECUTION_ERROR = "TEMPLATE_EXECUTION_ERROR",
+    ACTION_NOT_FOUND = "ACTION_NOT_FOUND",
+    ACTION_EXECUTION_FAILED = "ACTION_EXECUTION_FAILED",
+    ACTION_INVALID_PARAMETERS = "ACTION_INVALID_PARAMETERS",
+    ACTION_MISSING_REQUIRED_PARAM = "ACTION_MISSING_REQUIRED_PARAM",
+    ACTION_INVALID_PARAM_TYPE = "ACTION_INVALID_PARAM_TYPE",
+    ACTION_INVALID_PARAM_VALUE = "ACTION_INVALID_PARAM_VALUE",
+    CODEMOD_NOT_FOUND = "CODEMOD_NOT_FOUND",
+    CODEMOD_EXECUTION_FAILED = "CODEMOD_EXECUTION_FAILED",
+    CODEMOD_INVALID_PARAMETERS = "CODEMOD_INVALID_PARAMETERS",
+    CODEMOD_TRANSFORMATION_FAILED = "CODEMOD_TRANSFORMATION_FAILED",
+    CODEMOD_SYNTAX_ERROR = "CODEMOD_SYNTAX_ERROR",
+    CODEMOD_AST_PARSING_ERROR = "CODEMOD_AST_PARSING_ERROR",
+    CODEMOD_BACKUP_FAILED = "CODEMOD_BACKUP_FAILED",
+    CODEMOD_FILE_NOT_FOUND = "CODEMOD_FILE_NOT_FOUND",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    FILE_PERMISSION_DENIED = "FILE_PERMISSION_DENIED",
+    FILE_ALREADY_EXISTS = "FILE_ALREADY_EXISTS",
+    DIRECTORY_NOT_FOUND = "DIRECTORY_NOT_FOUND",
+    DIRECTORY_NOT_EMPTY = "DIRECTORY_NOT_EMPTY",
+    GENERATOR_NOT_FOUND = "GENERATOR_NOT_FOUND",
+    GENERATOR_INVALID_STRUCTURE = "GENERATOR_INVALID_STRUCTURE",
+    GENERATOR_MISSING_METADATA = "GENERATOR_MISSING_METADATA",
+    URL_INVALID_FORMAT = "URL_INVALID_FORMAT",
+    URL_RESOLUTION_FAILED = "URL_RESOLUTION_FAILED",
+    URL_FETCH_FAILED = "URL_FETCH_FAILED",
+    NETWORK_CONNECTION_FAILED = "NETWORK_CONNECTION_FAILED",
+    NETWORK_TIMEOUT = "NETWORK_TIMEOUT",
+    NETWORK_UNAUTHORIZED = "NETWORK_UNAUTHORIZED",
+    AI_API_KEY_MISSING = "AI_API_KEY_MISSING",
+    AI_PROVIDER_UNAVAILABLE = "AI_PROVIDER_UNAVAILABLE",
+    AI_GENERATION_FAILED = "AI_GENERATION_FAILED",
+    AI_BUDGET_EXCEEDED = "AI_BUDGET_EXCEEDED",
+    AI_SCHEMA_VALIDATION_FAILED = "AI_SCHEMA_VALIDATION_FAILED",
+    AI_SYNTAX_VALIDATION_FAILED = "AI_SYNTAX_VALIDATION_FAILED",
+    AI_IMPORT_VALIDATION_FAILED = "AI_IMPORT_VALIDATION_FAILED",
+    AI_RATE_LIMITED = "AI_RATE_LIMITED",
+    AI_CONTEXT_TOO_LARGE = "AI_CONTEXT_TOO_LARGE",
+    AI_TRANSPORT_FAILED = "AI_TRANSPORT_FAILED",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR"
+}
+export interface ErrorSuggestion {
+    title: string;
+    description: string;
+    command?: string;
+    url?: string;
+}
+export interface ErrorContext {
+    file?: string;
+    line?: number;
+    column?: number;
+    function?: string;
+    action?: string;
+    parameter?: string;
+    value?: any;
+    expected?: string;
+    received?: string;
+    channel?: string;
+    templatePath?: string;
+    template?: string;
+    extends?: string;
+    variable?: string;
+    url?: string;
+    version?: string;
+    dependency?: string;
+    type?: string;
+    path?: string;
+    include?: string;
+    base?: string;
+    hook?: string;
+    phase?: string;
+    error?: string;
+    errors?: string[];
+    toolType?: string;
+    toolName?: string;
+    codemodType?: string;
+    codemodPath?: string;
+    parser?: string;
+    filePath?: string;
+    transformationType?: string;
+    backupPath?: string;
+    cause?: any;
+    executionId?: string;
+    source?: any;
+    config?: any;
+    missingVariables?: string[];
+    assigned?: any;
+    step?: any;
+    steps?: any;
+    total?: any;
+    tool?: any;
+}
+export declare class HypergenError extends Error {
+    readonly code: ErrorCode;
+    context: ErrorContext;
+    readonly suggestions: ErrorSuggestion[];
+    readonly isUserError: boolean;
+    readonly severity: "low" | "medium" | "high" | "critical";
+    constructor(code: ErrorCode, message: string, context?: ErrorContext, suggestions?: ErrorSuggestion[], isUserError?: boolean, severity?: "low" | "medium" | "high" | "critical");
+}
+export declare class ErrorHandler {
+    private static readonly ERROR_MESSAGES;
+    private static readonly ERROR_SUGGESTIONS;
+    /**
+     * Create a user-friendly error with context and suggestions
+     */
+    static createError(code: ErrorCode, customMessage?: string, context?: ErrorContext, customSuggestions?: ErrorSuggestion[]): HypergenError;
+    /**
+     * Format error for display in CLI
+     */
+    static formatError(error: HypergenError): string;
+    /**
+     * Handle and format any error for CLI display
+     */
+    static handleError(error: unknown): string;
+    /**
+     * Extract file path from error message
+     */
+    private static extractFileFromError;
+    /**
+     * Create parameter validation error
+     */
+    static createParameterError(parameter: string, value: any, expected: string, action?: string): HypergenError;
+    /**
+     * Create template validation error
+     */
+    static createTemplateError(file: string, line?: number, column?: number, details?: string): HypergenError;
+    /**
+     * Create action not found error
+     */
+    static createActionNotFoundError(actionName: string): HypergenError;
+    /**
+     * Create file operation error
+     */
+    static createFileError(operation: string, file: string, reason: string): HypergenError;
+}
+/**
+ * Utility function to wrap async operations with error handling
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, errorContext?: ErrorContext): Promise<T>;
+/**
+ * Utility function to validate parameters
+ */
+export declare function validateParameter(name: string, value: any, type: string, required?: boolean, pattern?: string, allowedValues?: string[]): void;
+//# sourceMappingURL=hypergen-errors.d.ts.map

package/dist/errors/hypergen-errors.d.ts.map

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