mcp-server-framework 1.0.0

package/build/errors/categories/validation.js

@@ -0,0 +1,311 @@
+/**
+ * Validation Error Classes
+ *
+ * Errors related to input validation and configuration:
+ * - ValidationError: Input validation failures
+ * - ConfigurationError: Configuration/environment errors
+ *
+ * @module errors/categories/validation
+ */
+import { ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { ZodError } from "zod";
+import { AppError, ErrorCodes, VALIDATION_LIMITS, REDACTED_PLACEHOLDER, isSensitiveKey } from "../core/index.js";
+// ============================================================================
+// Validation Error
+// ============================================================================
+/**
+ * Error thrown when input validation fails.
+ *
+ * Integrates with Zod for schema validation errors.
+ *
+ * @example
+ * ```typescript
+ * // From Zod error
+ * throw ValidationError.fromZodError(zodError, 'Invalid server configuration');
+ *
+ * // Manual validation
+ * throw new ValidationError('Server name is required', {
+ *   field: 'server',
+ *   value: undefined
+ * });
+ *
+ * // Using factory methods
+ * throw ValidationError.fieldRequired('server');
+ * ```
+ */
+export class ValidationError extends AppError {
+    /** The field that failed validation */
+    field;
+    /** The invalid value (sanitized) */
+    value;
+    /** All validation issues (for multi-field validation) */
+    issues;
+    constructor(message, options = {}) {
+        super(message, {
+            code: ErrorCodes.VALIDATION_ERROR,
+            statusCode: 400,
+            mcpCode: ErrorCode.InvalidParams,
+            cause: options.cause,
+            recoveryHint: options.recoveryHint,
+            context: {
+                ...options.context,
+                field: options.field,
+                // Don't include actual value in context to avoid sensitive data leaks
+                hasValue: options.value !== undefined,
+            },
+        });
+        this.field = options.field;
+        // Sanitize the value - don't store sensitive information
+        this.value = this.sanitizeValue(options.value, options.field);
+        this.issues = options.issues;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Value Sanitization
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Sanitize a value for safe storage/logging.
+     * Removes potential sensitive data.
+     */
+    sanitizeValue(value, fieldName) {
+        if (value === undefined || value === null) {
+            return value;
+        }
+        // Check for potential secrets based on field name
+        if (fieldName && isSensitiveKey(fieldName)) {
+            return REDACTED_PLACEHOLDER;
+        }
+        // For strings, truncate and indicate type
+        if (typeof value === "string") {
+            if (value.length > VALIDATION_LIMITS.MAX_STRING_DISPLAY_LENGTH) {
+                return `[string:${value.length} chars]`;
+            }
+            return value;
+        }
+        // For objects/arrays, indicate structure only
+        if (typeof value === "object") {
+            if (Array.isArray(value)) {
+                return `[array:${value.length} items]`;
+            }
+            return `[object:${Object.keys(value).length} keys]`;
+        }
+        return value;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Factory Methods
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Create a ValidationError from a Zod error.
+     */
+    static fromZodError(zodError, message) {
+        const issues = zodError.issues.map((issue) => ({
+            path: issue.path.join("."),
+            message: issue.message,
+            code: issue.code,
+        }));
+        const primaryIssue = issues[0];
+        const errorMessage = message || primaryIssue?.message || "Validation failed";
+        return new ValidationError(errorMessage, {
+            field: primaryIssue?.path,
+            issues,
+            cause: zodError,
+            recoveryHint: "Check the input parameters against the expected schema.",
+        });
+    }
+    /**
+     * Create a ValidationError for a required field.
+     */
+    static fieldRequired(field) {
+        return new ValidationError(`Field '${field}' is required`, {
+            field,
+            recoveryHint: `Provide a value for the required field '${field}'.`,
+        });
+    }
+    /**
+     * Create a ValidationError for an invalid field value.
+     */
+    static fieldInvalid(field, value) {
+        return new ValidationError(`Invalid value for field '${field}'`, {
+            field,
+            value,
+            recoveryHint: `Check the value provided for '${field}' and ensure it meets the requirements.`,
+        });
+    }
+    /**
+     * Create a ValidationError for a type mismatch.
+     */
+    static fieldTypeMismatch(field, expectedType) {
+        return new ValidationError(`Field '${field}' must be of type ${expectedType}`, {
+            field,
+            recoveryHint: `Field '${field}' must be of type '${expectedType}'.`,
+        });
+    }
+    /**
+     * Create a ValidationError for minimum value constraint.
+     */
+    static fieldMin(field, min) {
+        return new ValidationError(`Field '${field}' must be at least ${min}`, {
+            field,
+            recoveryHint: `Provide a value of at least ${min} for '${field}'.`,
+        });
+    }
+    /**
+     * Create a ValidationError for maximum value constraint.
+     */
+    static fieldMax(field, max) {
+        return new ValidationError(`Field '${field}' must be at most ${max}`, {
+            field,
+            recoveryHint: `Provide a value of at most ${max} for '${field}'.`,
+        });
+    }
+    /**
+     * Create a ValidationError for pattern mismatch.
+     */
+    static fieldPattern(field) {
+        return new ValidationError(`Field '${field}' does not match the required pattern`, {
+            field,
+            recoveryHint: `Ensure '${field}' matches the expected format.`,
+        });
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Formatting
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Format issues as a human-readable list.
+     */
+    formatIssues() {
+        if (!this.issues || this.issues.length === 0) {
+            return this.message;
+        }
+        return this.issues.map((issue) => `  - ${issue.path}: ${issue.message}`).join("\n");
+    }
+}
+// ============================================================================
+// Configuration Error
+// ============================================================================
+/**
+ * Error thrown when configuration is invalid.
+ *
+ * @example
+ * ```typescript
+ * throw new ConfigurationError('Missing required environment variable: API_URL');
+ *
+ * // Using factory methods
+ * throw ConfigurationError.missingEnvVar('API_URL');
+ * throw ConfigurationError.invalidEnvVar('API_PORT', 'must be a number');
+ * ```
+ */
+export class ConfigurationError extends AppError {
+    /** The configuration key that is invalid */
+    configKey;
+    constructor(message, options = {}) {
+        super(message, {
+            code: ErrorCodes.CONFIGURATION_ERROR,
+            statusCode: 500, // Configuration errors are server-side
+            mcpCode: ErrorCode.InternalError,
+            cause: options.cause,
+            context: {
+                ...options.context,
+                configKey: options.configKey,
+            },
+        });
+        this.configKey = options.configKey;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Factory Methods
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Create a ConfigurationError for a missing environment variable.
+     */
+    static missingEnvVar(varName) {
+        return new ConfigurationError(`Missing required environment variable: ${varName}`, {
+            configKey: varName,
+            recoveryHint: `Set the environment variable '${varName}' in your configuration.`,
+        });
+    }
+    /**
+     * Create a ConfigurationError for an invalid environment variable value.
+     */
+    static invalidEnvVar(varName, reason) {
+        return new ConfigurationError(`Invalid value for environment variable ${varName}: ${reason}`, {
+            configKey: varName,
+            recoveryHint: `Check the value of '${varName}': ${reason}.`,
+        });
+    }
+    /**
+     * Create a ConfigurationError with a custom message.
+     */
+    static invalid(message) {
+        return new ConfigurationError(`Invalid configuration: ${message}`, {
+            recoveryHint: "Review your configuration settings and correct any issues.",
+        });
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Config File Factory Methods
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Create a ConfigurationError for an explicitly specified config file that doesn't exist.
+     */
+    static fileNotFound(filePath) {
+        return new ConfigurationError(`Config file not found: ${filePath}`, {
+            configKey: "MCP_CONFIG_FILE",
+            recoveryHint: `Ensure the file '${filePath}' exists or remove the MCP_CONFIG_FILE environment variable.`,
+        });
+    }
+    /**
+     * Create a ConfigurationError for a file that could not be read.
+     */
+    static fileReadFailed(filePath, cause) {
+        return new ConfigurationError(`Failed to read config file: ${filePath}`, {
+            configKey: "MCP_CONFIG_FILE",
+            cause,
+            recoveryHint: `Check file permissions and path for '${filePath}'.`,
+        });
+    }
+    /**
+     * Create a ConfigurationError for a TOML/YAML parse failure.
+     */
+    static fileParseFailed(filePath, cause) {
+        return new ConfigurationError(`Failed to parse config file: ${filePath}`, {
+            configKey: "MCP_CONFIG_FILE",
+            cause,
+            recoveryHint: `Check the syntax of '${filePath}' — ensure it is valid TOML or YAML.`,
+        });
+    }
+    /**
+     * Create a ConfigurationError for schema validation failures in a config file.
+     *
+     * Formats Zod issues into a human-readable message with the file path
+     * so users can locate and fix typos or invalid values.
+     */
+    static fileValidationFailed(filePath, zodError) {
+        const issues = zodError.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        const detail = `Validation failed for '${filePath}':\n${issues}`;
+        return new ConfigurationError(detail, {
+            configKey: "MCP_CONFIG_FILE",
+            cause: zodError,
+            recoveryHint: "Fix the listed issues in your config file. Use `.strict()` sections to catch typos.",
+        });
+    }
+    /**
+     * Create a ConfigurationError for an unsupported config file extension.
+     */
+    static unsupportedFormat(extension) {
+        return new ConfigurationError(`Unsupported config file format: ${extension}. Supported: .toml, .yaml, .yml`, {
+            configKey: "MCP_CONFIG_FILE",
+            recoveryHint: `Supported formats: .toml, .yaml, .yml`,
+        });
+    }
+    /**
+     * Create a ConfigurationError for cross-field validation failures.
+     *
+     * Used after merging all config sources (env + file + overrides)
+     * to validate constraints that span multiple fields.
+     */
+    static constraintViolation(message, fields) {
+        return new ConfigurationError(message, {
+            context: { fields },
+            recoveryHint: `Check the relationship between: ${fields.join(", ")}`,
+        });
+    }
+}
+//# sourceMappingURL=validation.js.map

package/build/errors/categories/validation.js.map

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

package/build/errors/core/base.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Base Error Class Module
+ *
+ * Provides the foundational AppError class that all application errors
+ * extend from. Features include:
+ *
+ * - Unique error ID for tracking and support
+ * - Typed error codes for programmatic handling
+ * - HTTP status code mapping for REST responses
+ * - MCP error code mapping for JSON-RPC responses
+ * - Recovery hints for user guidance
+ * - Error cause chain support
+ * - Serialization for logging
+ * - Environment-aware stack traces
+ *
+ * @module errors/core/base
+ */
+import { ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { type ErrorCodeType } from "./error-codes.js";
+import type { BaseErrorOptions, SerializedError } from "./types.js";
+/**
+ * Base error class for all MCP Server errors.
+ *
+ * All application errors should extend this class or one of its
+ * specialized subclasses. Provides consistent error handling,
+ * serialization, and integration with MCP/HTTP error codes.
+ *
+ * @example
+ * ```typescript
+ * throw new AppError('Something went wrong', {
+ *   code: ErrorCodes.INTERNAL_ERROR,
+ *   cause: originalError,
+ *   context: { operation: 'listContainers' },
+ *   recoveryHint: 'Try again later or check the server status'
+ * });
+ * ```
+ */
+export declare class AppError extends Error {
+    /** Unique identifier for this error instance (for tracking/support) */
+    readonly errorId: string;
+    /** Application-specific error code */
+    readonly code: ErrorCodeType | string;
+    /** HTTP status code for REST API responses */
+    readonly statusCode: number;
+    /** MCP error code for JSON-RPC responses */
+    readonly mcpCode: ErrorCode;
+    /** Additional context for debugging */
+    readonly context?: Record<string, unknown> | undefined;
+    /** Original error that caused this error */
+    readonly cause?: Error | undefined;
+    /** Timestamp when the error occurred */
+    readonly timestamp: Date;
+    /** Recovery hint for users - guidance on how to resolve the error */
+    readonly recoveryHint?: string | undefined;
+    constructor(message: string, options?: BaseErrorOptions);
+    /**
+     * Serialize error for logging or API response.
+     * Excludes stack trace in production for security.
+     *
+     * @returns Serialized error object
+     */
+    toJSON(): SerializedError;
+    /**
+     * Create a human-readable error message including cause chain.
+     *
+     * @returns Detailed error string with cause chain
+     */
+    toDetailedString(): string;
+    /**
+     * Type guard to check if an error is a AppError instance.
+     *
+     * @param error - The error to check
+     * @returns True if error is a AppError
+     */
+    static isAppError(error: unknown): error is AppError;
+    /**
+     * Wrap any error as a AppError.
+     * If already a AppError, returns it unchanged.
+     *
+     * @param error - The error to wrap
+     * @param defaultMessage - Message to use if error has none
+     * @returns A AppError instance
+     */
+    static wrap(error: unknown, defaultMessage?: string): AppError;
+    /**
+     * Create a AppError from an unknown error, preserving type if already AppError.
+     * Useful for catch blocks where you want to re-throw with additional context.
+     *
+     * @param error - The error to wrap
+     * @param context - Additional context to add
+     * @returns A AppError with merged context
+     */
+    static wrapWithContext(error: unknown, context: Record<string, unknown>): AppError;
+    /**
+     * Check if an error is a cancellation error.
+     * Handles both OperationCancelledError and native AbortError.
+     *
+     * @param error - The error to check
+     * @returns True if error represents a cancellation
+     */
+    static isCancellation(error: unknown): boolean;
+}
+//# sourceMappingURL=base.d.ts.map

package/build/errors/core/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/errors/core/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMpE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAEtC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAE5B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvD,4CAA4C;IAC5C,SAAkB,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAE5C,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAyB3D;;;;;OAKG;IACH,MAAM,IAAI,eAAe;IAuCzB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IA0B1B;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ;IAIpD;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,SAAiC,GAAG,QAAQ;IAiBtF;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ;IAclF;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAa/C"}

package/build/errors/core/base.js

@@ -0,0 +1,219 @@
+/**
+ * Base Error Class Module
+ *
+ * Provides the foundational AppError class that all application errors
+ * extend from. Features include:
+ *
+ * - Unique error ID for tracking and support
+ * - Typed error codes for programmatic handling
+ * - HTTP status code mapping for REST responses
+ * - MCP error code mapping for JSON-RPC responses
+ * - Recovery hints for user guidance
+ * - Error cause chain support
+ * - Serialization for logging
+ * - Environment-aware stack traces
+ *
+ * @module errors/core/base
+ */
+import { randomUUID } from "node:crypto";
+import { ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { ErrorCodes } from "./error-codes.js";
+import { ErrorCodeToHttpStatus } from "./http.js";
+// ============================================================================
+// Base Error Class
+// ============================================================================
+/**
+ * Base error class for all MCP Server errors.
+ *
+ * All application errors should extend this class or one of its
+ * specialized subclasses. Provides consistent error handling,
+ * serialization, and integration with MCP/HTTP error codes.
+ *
+ * @example
+ * ```typescript
+ * throw new AppError('Something went wrong', {
+ *   code: ErrorCodes.INTERNAL_ERROR,
+ *   cause: originalError,
+ *   context: { operation: 'listContainers' },
+ *   recoveryHint: 'Try again later or check the server status'
+ * });
+ * ```
+ */
+export class AppError extends Error {
+    /** Unique identifier for this error instance (for tracking/support) */
+    errorId;
+    /** Application-specific error code */
+    code;
+    /** HTTP status code for REST API responses */
+    statusCode;
+    /** MCP error code for JSON-RPC responses */
+    mcpCode;
+    /** Additional context for debugging */
+    context;
+    /** Original error that caused this error */
+    cause;
+    /** Timestamp when the error occurred */
+    timestamp;
+    /** Recovery hint for users - guidance on how to resolve the error */
+    recoveryHint;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = this.constructor.name;
+        this.errorId = randomUUID();
+        this.code = options.code ?? ErrorCodes.INTERNAL_ERROR;
+        // @ts-limitation — this.code is ErrorCodeType | string; lookup map requires ErrorCodeType key
+        this.statusCode = options.statusCode ?? ErrorCodeToHttpStatus[this.code] ?? 500;
+        this.mcpCode = options.mcpCode ?? ErrorCode.InternalError;
+        this.cause = options.cause;
+        this.context = options.context;
+        this.timestamp = new Date();
+        this.recoveryHint = options.recoveryHint;
+        // Maintain proper stack trace in V8 environments
+        /* v8 ignore start - V8-specific runtime feature */
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        /* v8 ignore stop */
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Serialization
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Serialize error for logging or API response.
+     * Excludes stack trace in production for security.
+     *
+     * @returns Serialized error object
+     */
+    toJSON() {
+        const serialized = {
+            name: this.name,
+            message: this.message,
+            errorId: this.errorId,
+            code: this.code,
+            statusCode: this.statusCode,
+            mcpCode: this.mcpCode,
+            timestamp: this.timestamp.toISOString(),
+        };
+        // Include stack in development only
+        if (process.env.NODE_ENV !== "production" && this.stack) {
+            serialized.stack = this.stack;
+        }
+        // Serialize cause if present
+        if (this.cause) {
+            if (this.cause instanceof AppError) {
+                serialized.cause = this.cause.toJSON();
+            }
+            else {
+                serialized.cause = this.cause.message;
+            }
+        }
+        // Include context in development only — prevents leaking internal details
+        // (operation names, field names, paths) in production HTTP responses.
+        if (process.env.NODE_ENV !== "production" && this.context && Object.keys(this.context).length > 0) {
+            serialized.context = this.context;
+        }
+        // Include recovery hint if present
+        if (this.recoveryHint) {
+            serialized.recoveryHint = this.recoveryHint;
+        }
+        return serialized;
+    }
+    /**
+     * Create a human-readable error message including cause chain.
+     *
+     * @returns Detailed error string with cause chain
+     */
+    toDetailedString() {
+        let result = `${this.name} [${this.code}] (${this.errorId}): ${this.message}`;
+        if (this.recoveryHint) {
+            result += ` | Hint: ${this.recoveryHint}`;
+        }
+        if (this.context && Object.keys(this.context).length > 0) {
+            result += ` | Context: ${JSON.stringify(this.context)}`;
+        }
+        if (this.cause) {
+            if (this.cause instanceof AppError) {
+                result += `\n  Caused by: ${this.cause.toDetailedString()}`;
+            }
+            else {
+                result += `\n  Caused by: ${this.cause.message}`;
+            }
+        }
+        return result;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Static Utilities
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Type guard to check if an error is a AppError instance.
+     *
+     * @param error - The error to check
+     * @returns True if error is a AppError
+     */
+    static isAppError(error) {
+        return error instanceof AppError;
+    }
+    /**
+     * Wrap any error as a AppError.
+     * If already a AppError, returns it unchanged.
+     *
+     * @param error - The error to wrap
+     * @param defaultMessage - Message to use if error has none
+     * @returns A AppError instance
+     */
+    static wrap(error, defaultMessage = "An unexpected error occurred") {
+        if (error instanceof AppError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new AppError(error.message || defaultMessage, {
+                cause: error,
+                code: ErrorCodes.INTERNAL_ERROR,
+            });
+        }
+        return new AppError(String(error) || defaultMessage, {
+            code: ErrorCodes.INTERNAL_ERROR,
+        });
+    }
+    /**
+     * Create a AppError from an unknown error, preserving type if already AppError.
+     * Useful for catch blocks where you want to re-throw with additional context.
+     *
+     * @param error - The error to wrap
+     * @param context - Additional context to add
+     * @returns A AppError with merged context
+     */
+    static wrapWithContext(error, context) {
+        const wrappedError = AppError.wrap(error);
+        // Merge context and preserve recoveryHint
+        return new AppError(wrappedError.message, {
+            code: wrappedError.code,
+            statusCode: wrappedError.statusCode,
+            mcpCode: wrappedError.mcpCode,
+            cause: wrappedError.cause,
+            context: { ...wrappedError.context, ...context },
+            recoveryHint: wrappedError.recoveryHint,
+        });
+    }
+    /**
+     * Check if an error is a cancellation error.
+     * Handles both OperationCancelledError and native AbortError.
+     *
+     * @param error - The error to check
+     * @returns True if error represents a cancellation
+     */
+    static isCancellation(error) {
+        if (error instanceof Error) {
+            // Check for AbortError (from AbortController)
+            if (error.name === "AbortError") {
+                return true;
+            }
+            // Check for our cancellation code
+            if (error instanceof AppError && error.code === ErrorCodes.OPERATION_CANCELLED) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=base.js.map

package/build/errors/core/base.js.map

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