@dizzlkheinz/ynab-mcpb 0.18.4 → 0.19.0

package/dist/server/errorHandler.js

@@ -1,7 +1,22 @@
+export var YNABErrorCode;
+(function (YNABErrorCode) {
+    YNABErrorCode[YNABErrorCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    YNABErrorCode[YNABErrorCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    YNABErrorCode[YNABErrorCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+    YNABErrorCode[YNABErrorCode["NOT_FOUND"] = 404] = "NOT_FOUND";
+    YNABErrorCode[YNABErrorCode["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+    YNABErrorCode[YNABErrorCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+})(YNABErrorCode || (YNABErrorCode = {}));
+export var SecurityErrorCode;
+(function (SecurityErrorCode) {
+    SecurityErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    SecurityErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    SecurityErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(SecurityErrorCode || (SecurityErrorCode = {}));
 export class YNABAPIError extends Error {
     constructor(code, message, originalError) {
         super(message);
-        this.name = 'YNABAPIError';
+        this.name = "YNABAPIError";
         this.code = code;
         this.originalError = originalError;
     }
@@ -12,7 +27,7 @@ export class YNABAPIError extends Error {
 export class ValidationError extends Error {
     constructor(message, details, suggestions) {
         super(message);
-        this.name = 'ValidationError';
+        this.name = "ValidationError";
         this.details = details;
         this.suggestions = suggestions;
     }
@@ -21,14 +36,6 @@ export class ErrorHandler {
     constructor(formatter) {
         this.formatter = formatter;
     }
-    static createFallbackFormatter() {
-        return {
-            format: (value) => JSON.stringify(value, null, 2),
-        };
-    }
-    static setFormatter(formatter) {
-        ErrorHandler.defaultInstance = new ErrorHandler(formatter);
-    }
     handleError(error, context) {
         const errorResponse = this.createErrorResponse(error, context);
         let formattedText;
@@ -47,18 +54,12 @@ export class ErrorHandler {
             isError: true,
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: formattedText,
                 },
             ],
         };
     }
-    static handleError(error, context) {
-        if (!ErrorHandler.defaultInstance) {
-            ErrorHandler.defaultInstance = new ErrorHandler(ErrorHandler.createFallbackFormatter());
-        }
-        return ErrorHandler.defaultInstance.handleError(error, context);
-    }
     createErrorResponse(error, context) {
         if (error instanceof YNABAPIError) {
             const ynabDetails = this.extractYNABApiError(error.originalError);
@@ -75,15 +76,17 @@ export class ErrorHandler {
             };
         }
         if (error instanceof ValidationError) {
-            const sanitizedDetails = error.details ? this.sanitizeErrorDetails(error.details) : undefined;
+            const sanitizedDetails = error.details
+                ? this.sanitizeErrorDetails(error.details)
+                : undefined;
             const suggestions = error.suggestions && error.suggestions.length > 0
                 ? error.suggestions
-                : this.getErrorSuggestions("VALIDATION_ERROR", context);
+                : this.getErrorSuggestions(SecurityErrorCode.VALIDATION_ERROR, context);
             return {
                 error: {
-                    code: "VALIDATION_ERROR",
+                    code: SecurityErrorCode.VALIDATION_ERROR,
                     message: error.message,
-                    userMessage: this.getUserFriendlyMessage("VALIDATION_ERROR", context),
+                    userMessage: this.getUserFriendlyMessage(SecurityErrorCode.VALIDATION_ERROR, context),
                     suggestions,
                     ...(sanitizedDetails && { details: sanitizedDetails }),
                 },
@@ -137,10 +140,10 @@ export class ErrorHandler {
         if (error instanceof Error) {
             errorMessage = error.message;
         }
-        else if (typeof error === 'string') {
+        else if (typeof error === "string") {
             errorMessage = error;
         }
-        else if (error && typeof error === 'object') {
+        else if (error && typeof error === "object") {
             try {
                 errorMessage = JSON.stringify(error, null, 2);
             }
@@ -154,13 +157,13 @@ export class ErrorHandler {
         const sanitizedDetails = this.sanitizeErrorDetails(errorMessage);
         return {
             error: {
-                code: "UNKNOWN_ERROR",
+                code: SecurityErrorCode.UNKNOWN_ERROR,
                 message: this.getGenericErrorMessage(context),
                 userMessage: this.getUserFriendlyGenericMessage(context),
                 suggestions: [
-                    'Try the operation again',
-                    'Check your internet connection',
-                    'Contact support if the issue persists',
+                    "Try the operation again",
+                    "Check your internet connection",
+                    "Contact support if the issue persists",
                 ],
                 ...(sanitizedDetails && { details: sanitizedDetails }),
             },
@@ -168,254 +171,264 @@ export class ErrorHandler {
     }
     detectErrorCode(error) {
         const message = error.message.toLowerCase();
-        if (message.includes('401') || message.includes('unauthorized')) {
-            return 401;
+        if (message.includes("401") || message.includes("unauthorized")) {
+            return YNABErrorCode.UNAUTHORIZED;
         }
-        if (message.includes('403') || message.includes('forbidden')) {
-            return 403;
+        if (message.includes("403") || message.includes("forbidden")) {
+            return YNABErrorCode.FORBIDDEN;
         }
-        if (message.includes('404') || message.includes('not found')) {
-            return 404;
+        if (message.includes("404") || message.includes("not found")) {
+            return YNABErrorCode.NOT_FOUND;
         }
-        if (message.includes('429') || message.includes('too many requests')) {
-            return 429;
+        if (message.includes("429") || message.includes("too many requests")) {
+            return YNABErrorCode.TOO_MANY_REQUESTS;
         }
-        if (message.includes('500') || message.includes('internal server error')) {
-            return 500;
+        if (message.includes("500") || message.includes("internal server error")) {
+            return YNABErrorCode.INTERNAL_SERVER_ERROR;
         }
         return null;
     }
     getUserFriendlyMessage(code, context) {
         switch (code) {
-            case 400:
-                return 'The request was invalid. Please check your input data.';
-            case 401:
-                return 'Your YNAB access token is invalid or has expired. Please check your token and try again.';
-            case 403:
+            case YNABErrorCode.BAD_REQUEST:
+                return "The request was invalid. Please check your input data.";
+            case YNABErrorCode.UNAUTHORIZED:
+                return "Your YNAB access token is invalid or has expired. Please check your token and try again.";
+            case YNABErrorCode.FORBIDDEN:
                 return "You don't have permission to access this YNAB data. Please check your account permissions.";
-            case 404:
+            case YNABErrorCode.NOT_FOUND:
                 return this.getUserFriendlyNotFoundMessage(context);
-            case 429:
+            case YNABErrorCode.TOO_MANY_REQUESTS:
                 return "We're making too many requests to YNAB. Please wait a moment and try again.";
-            case 500:
+            case YNABErrorCode.INTERNAL_SERVER_ERROR:
                 return "YNAB's servers are having issues. Please try again in a few minutes.";
-            case "VALIDATION_ERROR":
-                return 'Some of the information provided is invalid. Please check your inputs and try again.';
-            case "RATE_LIMIT_EXCEEDED":
-                return 'Too many requests have been made. Please wait before trying again.';
+            case SecurityErrorCode.VALIDATION_ERROR:
+                return "Some of the information provided is invalid. Please check your inputs and try again.";
+            case SecurityErrorCode.RATE_LIMIT_EXCEEDED:
+                return "Too many requests have been made. Please wait before trying again.";
             default:
                 return this.getUserFriendlyGenericMessage(context);
         }
     }
     getErrorSuggestions(code, context) {
         switch (code) {
-            case 400:
+            case YNABErrorCode.BAD_REQUEST:
                 return [
-                    'Check that all required fields are correct',
-                    'Verify that dates are in the correct format (ISO 8601)',
-                    'Ensure amounts are valid numbers',
+                    "Check that all required fields are correct",
+                    "Verify that dates are in the correct format (ISO 8601)",
+                    "Ensure amounts are valid numbers",
                 ];
-            case 401:
+            case YNABErrorCode.UNAUTHORIZED:
                 return [
-                    'Go to https://app.youneedabudget.com/settings/developer to generate a new access token',
-                    'Make sure you copied the entire token without any extra spaces',
+                    "Go to https://app.youneedabudget.com/settings/developer to generate a new access token",
+                    "Make sure you copied the entire token without any extra spaces",
                     "Check that your token hasn't expired",
                 ];
-            case 403:
+            case YNABErrorCode.FORBIDDEN:
                 return [
-                    'Verify that your YNAB account has access to the requested budget',
-                    'Check if your YNAB subscription is active',
-                    'Try logging into YNAB directly to confirm access',
+                    "Verify that your YNAB account has access to the requested budget",
+                    "Check if your YNAB subscription is active",
+                    "Try logging into YNAB directly to confirm access",
                 ];
-            case 404:
+            case YNABErrorCode.NOT_FOUND:
                 return this.getNotFoundSuggestions(context);
-            case 429:
+            case YNABErrorCode.TOO_MANY_REQUESTS:
                 return [
-                    'Wait 1-2 minutes before trying again',
-                    'Try making fewer requests at once',
-                    'The system will automatically retry after a short delay',
+                    "Wait 1-2 minutes before trying again",
+                    "Try making fewer requests at once",
+                    "The system will automatically retry after a short delay",
                 ];
-            case 500:
+            case YNABErrorCode.INTERNAL_SERVER_ERROR:
                 return [
                     "Check YNAB's status page at https://status.youneedabudget.com",
-                    'Try again in a few minutes',
-                    'Contact YNAB support if the issue persists',
+                    "Try again in a few minutes",
+                    "Contact YNAB support if the issue persists",
                 ];
-            case "VALIDATION_ERROR":
+            case SecurityErrorCode.VALIDATION_ERROR:
                 return [
-                    'Double-check all required fields are filled out',
-                    'Verify that amounts are in the correct format',
-                    'Make sure dates are valid and in the right format',
+                    "Double-check all required fields are filled out",
+                    "Verify that amounts are in the correct format",
+                    "Make sure dates are valid and in the right format",
                 ];
             default:
                 return [
-                    'Try the operation again',
-                    'Check your internet connection',
-                    'Contact support if the issue persists',
+                    "Try the operation again",
+                    "Check your internet connection",
+                    "Contact support if the issue persists",
                 ];
         }
     }
     getUserFriendlyNotFoundMessage(context) {
-        if (context.includes('account')) {
+        if (context.includes("account")) {
             return "We couldn't find the budget or account you're looking for.";
         }
-        if (context.includes('budget')) {
+        if (context.includes("budget")) {
             return "We couldn't find that budget. It may have been deleted or you may not have access.";
         }
-        if (context.includes('category')) {
+        if (context.includes("category")) {
             return "We couldn't find that category. It may have been deleted or moved.";
         }
-        if (context.includes('transaction')) {
+        if (context.includes("transaction")) {
             return "We couldn't find that transaction. It may have been deleted or moved.";
         }
-        if (context.includes('payee')) {
+        if (context.includes("payee")) {
             return "We couldn't find that payee in your budget.";
         }
         return "We couldn't find what you're looking for. Please check that all information is correct.";
     }
     getNotFoundSuggestions(context) {
         const baseSuggestions = [
-            'Double-check that the name or ID is spelled correctly',
-            'Try refreshing your budget data',
+            "Double-check that the name or ID is spelled correctly",
+            "Try refreshing your budget data",
             "Make sure you're using the right budget",
         ];
-        if (context.includes('account')) {
-            return [...baseSuggestions, 'Check if the account was recently closed or renamed'];
+        if (context.includes("account")) {
+            return [
+                ...baseSuggestions,
+                "Check if the account was recently closed or renamed",
+            ];
         }
-        if (context.includes('category')) {
+        if (context.includes("category")) {
             return [
                 ...baseSuggestions,
-                'Check if the category was deleted or moved to a different group',
+                "Check if the category was deleted or moved to a different group",
             ];
         }
-        if (context.includes('transaction')) {
+        if (context.includes("transaction")) {
             return [
                 ...baseSuggestions,
-                'Check if the transaction was deleted or is in a different account',
+                "Check if the transaction was deleted or is in a different account",
             ];
         }
         return baseSuggestions;
     }
     getUserFriendlyGenericMessage(context) {
-        if (context.includes('transaction')) {
-            return 'There was a problem with your transaction. Please check your information and try again.';
+        if (context.includes("transaction")) {
+            return "There was a problem with your transaction. Please check your information and try again.";
         }
-        if (context.includes('budget')) {
-            return 'There was a problem accessing your budget data. Please try again.';
+        if (context.includes("budget")) {
+            return "There was a problem accessing your budget data. Please try again.";
         }
-        if (context.includes('account')) {
-            return 'There was a problem accessing your account information. Please try again.';
+        if (context.includes("account")) {
+            return "There was a problem accessing your account information. Please try again.";
         }
-        return 'Something went wrong. Please try again in a moment.';
+        return "Something went wrong. Please try again in a moment.";
     }
     getErrorMessage(code, context) {
         switch (code) {
-            case 400:
-                return 'Bad request - invalid parameters';
-            case 401:
-                return 'Invalid or expired YNAB access token';
-            case 403:
-                return 'Insufficient permissions to access YNAB data';
-            case 404:
+            case YNABErrorCode.BAD_REQUEST:
+                return "Bad request - invalid parameters";
+            case YNABErrorCode.UNAUTHORIZED:
+                return "Invalid or expired YNAB access token";
+            case YNABErrorCode.FORBIDDEN:
+                return "Insufficient permissions to access YNAB data";
+            case YNABErrorCode.NOT_FOUND:
                 return this.getNotFoundMessage(context);
-            case 429:
-                return 'Rate limit exceeded. Please try again later';
-            case 500:
-                return 'YNAB service is currently unavailable';
+            case YNABErrorCode.TOO_MANY_REQUESTS:
+                return "Rate limit exceeded. Please try again later";
+            case YNABErrorCode.INTERNAL_SERVER_ERROR:
+                return "YNAB service is currently unavailable";
             default:
                 return this.getGenericErrorMessage(context);
         }
     }
     getNotFoundMessage(context) {
-        if (context.includes('listing accounts')) {
-            return 'Failed to list accounts - budget or account not found';
+        if (context.includes("listing accounts")) {
+            return "Failed to list accounts - budget or account not found";
         }
-        if (context.includes('getting account')) {
-            return 'Failed to get account - budget or account not found';
+        if (context.includes("getting account")) {
+            return "Failed to get account - budget or account not found";
         }
-        if (context.includes('listing budgets') || context.includes('getting budget')) {
-            return 'Budget not found';
+        if (context.includes("listing budgets") ||
+            context.includes("getting budget")) {
+            return "Budget not found";
         }
-        if (context.includes('listing categories') || context.includes('getting category')) {
-            return 'Budget or category not found';
+        if (context.includes("listing categories") ||
+            context.includes("getting category")) {
+            return "Budget or category not found";
         }
-        if (context.includes('listing months') || context.includes('getting month')) {
-            return 'Budget or month not found';
+        if (context.includes("listing months") ||
+            context.includes("getting month")) {
+            return "Budget or month not found";
         }
-        if (context.includes('listing payees') || context.includes('getting payee')) {
-            return 'Budget or payee not found';
+        if (context.includes("listing payees") ||
+            context.includes("getting payee")) {
+            return "Budget or payee not found";
         }
-        if (context.includes('listing transactions') || context.includes('getting transaction')) {
-            return 'Budget, account, category, or transaction not found';
+        if (context.includes("listing transactions") ||
+            context.includes("getting transaction")) {
+            return "Budget, account, category, or transaction not found";
         }
-        return 'The requested resource was not found. Please verify the provided IDs are correct.';
+        return "The requested resource was not found. Please verify the provided IDs are correct.";
     }
     getGenericErrorMessage(context) {
-        if (context.includes('listing accounts')) {
-            return 'Failed to list accounts';
+        if (context.includes("listing accounts")) {
+            return "Failed to list accounts";
         }
-        if (context.includes('getting account')) {
-            return 'Failed to get account';
+        if (context.includes("getting account")) {
+            return "Failed to get account";
         }
-        if (context.includes('creating account')) {
-            return 'Failed to create account';
+        if (context.includes("creating account")) {
+            return "Failed to create account";
         }
-        if (context.includes('listing budgets')) {
-            return 'Failed to list budgets';
+        if (context.includes("listing budgets")) {
+            return "Failed to list budgets";
         }
-        if (context.includes('getting budget')) {
-            return 'Failed to get budget';
+        if (context.includes("getting budget")) {
+            return "Failed to get budget";
         }
-        if (context.includes('listing categories')) {
-            return 'Failed to list categories';
+        if (context.includes("listing categories")) {
+            return "Failed to list categories";
         }
-        if (context.includes('getting category')) {
-            return 'Failed to get category';
+        if (context.includes("getting category")) {
+            return "Failed to get category";
         }
-        if (context.includes('updating category')) {
-            return 'Failed to update category';
+        if (context.includes("updating category")) {
+            return "Failed to update category";
         }
-        if (context.includes('listing months')) {
-            return 'Failed to list months';
+        if (context.includes("listing months")) {
+            return "Failed to list months";
         }
-        if (context.includes('getting month')) {
-            return 'Failed to get month data';
+        if (context.includes("getting month")) {
+            return "Failed to get month data";
         }
-        if (context.includes('listing payees')) {
-            return 'Failed to list payees';
+        if (context.includes("listing payees")) {
+            return "Failed to list payees";
         }
-        if (context.includes('getting payee')) {
-            return 'Failed to get payee';
+        if (context.includes("getting payee")) {
+            return "Failed to get payee";
         }
-        if (context.includes('listing transactions')) {
-            return 'Failed to list transactions';
+        if (context.includes("listing transactions")) {
+            return "Failed to list transactions";
         }
-        if (context.includes('getting transaction')) {
-            return 'Failed to get transaction';
+        if (context.includes("getting transaction")) {
+            return "Failed to get transaction";
         }
-        if (context.includes('creating transaction')) {
-            return 'Failed to create transaction';
+        if (context.includes("creating transaction")) {
+            return "Failed to create transaction";
         }
-        if (context.includes('updating transaction')) {
-            return 'Failed to update transaction';
+        if (context.includes("updating transaction")) {
+            return "Failed to update transaction";
         }
-        if (context.includes('getting user')) {
-            return 'Failed to get user information';
+        if (context.includes("getting user")) {
+            return "Failed to get user information";
         }
         return `An error occurred while ${context}`;
     }
     extractHttpStatus(error) {
-        if (!error || typeof error !== 'object') {
+        if (!error || typeof error !== "object") {
             return null;
         }
         const directStatus = error.status;
-        if (typeof directStatus === 'number' && Number.isInteger(directStatus) && directStatus > 0) {
+        if (typeof directStatus === "number" &&
+            Number.isInteger(directStatus) &&
+            directStatus > 0) {
             return directStatus;
         }
         const response = error.response;
-        if (response && typeof response === 'object') {
+        if (response && typeof response === "object") {
             const responseStatus = response.status;
-            if (typeof responseStatus === 'number' &&
+            if (typeof responseStatus === "number" &&
                 Number.isInteger(responseStatus) &&
                 responseStatus > 0) {
                 return responseStatus;
@@ -425,23 +438,23 @@ export class ErrorHandler {
     }
     mapHttpStatusToErrorCode(status) {
         switch (status) {
-            case 400:
-            case 401:
-            case 403:
-            case 404:
-            case 429:
-            case 500:
+            case YNABErrorCode.BAD_REQUEST:
+            case YNABErrorCode.UNAUTHORIZED:
+            case YNABErrorCode.FORBIDDEN:
+            case YNABErrorCode.NOT_FOUND:
+            case YNABErrorCode.TOO_MANY_REQUESTS:
+            case YNABErrorCode.INTERNAL_SERVER_ERROR:
                 return status;
             default:
                 return null;
         }
     }
     extractHttpStatusDetails(error) {
-        if (error && typeof error === 'object') {
+        if (error && typeof error === "object") {
             const response = error.response;
-            if (response && typeof response === 'object') {
+            if (response && typeof response === "object") {
                 const statusText = response.statusText;
-                if (typeof statusText === 'string' && statusText.trim().length > 0) {
+                if (typeof statusText === "string" && statusText.trim().length > 0) {
                     return this.sanitizeErrorDetails(statusText);
                 }
             }
@@ -452,51 +465,53 @@ export class ErrorHandler {
         return undefined;
     }
     extractYNABApiError(error) {
-        if (!error || typeof error !== 'object') {
+        if (!error || typeof error !== "object") {
             return null;
         }
         let payload = error.error;
         if (!payload) {
-            const responseData = error.response?.data;
-            if (responseData && typeof responseData === 'object') {
+            const responseData = error.response
+                ?.data;
+            if (responseData && typeof responseData === "object") {
                 payload = responseData.error;
             }
         }
-        if (!payload || typeof payload !== 'object') {
+        if (!payload || typeof payload !== "object") {
             return null;
         }
         const id = payload.id;
         const name = payload.name;
         const detail = payload.detail;
         let code = null;
-        if (typeof id === 'string') {
-            const numeric = parseInt(id, 10);
+        if (typeof id === "string") {
+            const numeric = Number.parseInt(id, 10);
             if (!Number.isNaN(numeric)) {
                 code = this.mapHttpStatusToErrorCode(numeric);
             }
         }
-        if (!code && typeof name === 'string') {
+        if (!code && typeof name === "string") {
             const normalized = name.toLowerCase();
-            if (normalized.includes('unauthorized')) {
-                code = 401;
+            if (normalized.includes("unauthorized")) {
+                code = YNABErrorCode.UNAUTHORIZED;
             }
-            else if (normalized.includes('forbidden')) {
-                code = 403;
+            else if (normalized.includes("forbidden")) {
+                code = YNABErrorCode.FORBIDDEN;
             }
-            else if (normalized.includes('not_found')) {
-                code = 404;
+            else if (normalized.includes("not_found")) {
+                code = YNABErrorCode.NOT_FOUND;
             }
-            else if (normalized.includes('too_many_requests') || normalized.includes('rate_limit')) {
-                code = 429;
+            else if (normalized.includes("too_many_requests") ||
+                normalized.includes("rate_limit")) {
+                code = YNABErrorCode.TOO_MANY_REQUESTS;
             }
-            else if (normalized.includes('internal_server_error')) {
-                code = 500;
+            else if (normalized.includes("internal_server_error")) {
+                code = YNABErrorCode.INTERNAL_SERVER_ERROR;
             }
         }
         if (!code) {
             return null;
         }
-        const details = typeof detail === 'string' ? detail : undefined;
+        const details = typeof detail === "string" ? detail : undefined;
         const result = { code };
         if (details !== undefined) {
             result.details = details;
@@ -506,22 +521,22 @@ export class ErrorHandler {
     sanitizeErrorDetails(error) {
         if (!error)
             return undefined;
-        let details = '';
+        let details = "";
         if (error instanceof Error) {
             details = error.message;
         }
-        else if (typeof error === 'string') {
+        else if (typeof error === "string") {
             details = error;
         }
         else {
-            details = 'Unknown error details';
+            details = "Unknown error details";
         }
         details = details
-            .replace(/token[s]?[:\s=]+([^\s,"']+)/gi, 'token=***')
-            .replace(/key[s]?[:\s=]+([^\s,"']+)/gi, 'key=***')
-            .replace(/password[s]?[:\s=]+([^\s,"']+)/gi, 'password=***')
-            .replace(/authorization[:\s=]+[^\r\n]+/gi, 'authorization=***')
-            .replace(/\bBearer\s+[A-Za-z0-9._-]+/gi, 'Bearer ***');
+            .replace(/token[s]?[:\s=]+([^\s,"']+)/gi, "token=***")
+            .replace(/key[s]?[:\s=]+([^\s,"']+)/gi, "key=***")
+            .replace(/password[s]?[:\s=]+([^\s,"']+)/gi, "password=***")
+            .replace(/authorization[:\s=]+[^\r\n]+/gi, "authorization=***")
+            .replace(/\bBearer\s+[A-Za-z0-9._-]+/gi, "Bearer ***");
         return details;
     }
     async withErrorHandling(operation, context) {
@@ -532,38 +547,25 @@ export class ErrorHandler {
             return this.handleError(error, context);
         }
     }
-    static async withErrorHandling(operation, context) {
-        if (!ErrorHandler.defaultInstance) {
-            ErrorHandler.defaultInstance = new ErrorHandler(ErrorHandler.createFallbackFormatter());
-        }
-        return ErrorHandler.defaultInstance.withErrorHandling(operation, context);
-    }
     createValidationError(message, details, suggestions) {
-        return this.handleError(new ValidationError(message, details, suggestions), 'validating parameters');
-    }
-    static createValidationError(message, details, suggestions) {
-        if (!ErrorHandler.defaultInstance) {
-            ErrorHandler.defaultInstance = new ErrorHandler(ErrorHandler.createFallbackFormatter());
-        }
-        return ErrorHandler.defaultInstance.createValidationError(message, details, suggestions);
+        return this.handleError(new ValidationError(message, details, suggestions), "validating parameters");
     }
     createYNABError(code, context, originalError) {
         const message = this.getErrorMessage(code, context);
         return new YNABAPIError(code, message, originalError);
     }
-    static createYNABError(code, context, originalError) {
-        if (!ErrorHandler.defaultInstance) {
-            ErrorHandler.defaultInstance = new ErrorHandler(ErrorHandler.createFallbackFormatter());
-        }
-        return ErrorHandler.defaultInstance.createYNABError(code, context, originalError);
-    }
 }
 export function createErrorHandler(formatter) {
     return new ErrorHandler(formatter);
 }
-export function handleToolError(error, toolName, operation) {
-    return ErrorHandler.handleError(error, `executing ${toolName} - ${operation}`);
+const fallbackErrorHandler = new ErrorHandler({
+    format: (value) => JSON.stringify(value, null, 2),
+});
+export function handleToolError(error, toolName, operation, errorHandler) {
+    const eh = errorHandler ?? fallbackErrorHandler;
+    return eh.handleError(error, `executing ${toolName} - ${operation}`);
 }
-export async function withToolErrorHandling(operation, toolName, operationName) {
-    return ErrorHandler.withErrorHandling(operation, `executing ${toolName} - ${operationName}`);
+export async function withToolErrorHandling(operation, toolName, operationName, errorHandler) {
+    const eh = errorHandler ?? fallbackErrorHandler;
+    return eh.withErrorHandling(operation, `executing ${toolName} - ${operationName}`);
 }