@dizzlkheinz/ynab-mcpb 0.18.3 → 0.19.0

package/dist/server/diagnostics.js

@@ -6,15 +6,13 @@ export function formatUptime(ms) {
     if (days > 0) {
         return `${days}d ${hours % 24}h ${minutes % 60}m ${seconds % 60}s`;
     }
-    else if (hours > 0) {
+    if (hours > 0) {
         return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
     }
-    else if (minutes > 0) {
+    if (minutes > 0) {
         return `${minutes}m ${seconds % 60}s`;
     }
-    else {
-        return `${seconds}s`;
-    }
+    return `${seconds}s`;
 }
 export function formatBytes(bytes) {
     return Math.round((bytes / 1024 / 1024) * 100) / 100;
@@ -27,7 +25,7 @@ export function maskToken(token) {
     }
     const firstPart = token.slice(0, 4);
     let lastPart = token.slice(-4);
-    const trailingHyphenIndex = token.lastIndexOf('-');
+    const trailingHyphenIndex = token.lastIndexOf("-");
     if (trailingHyphenIndex !== -1 && token.length - trailingHyphenIndex <= 6) {
         lastPart = token.slice(trailingHyphenIndex);
     }
@@ -43,8 +41,8 @@ export class DiagnosticManager {
         };
         if (options.include_server) {
             const uptimeMs = Math.round(process.uptime() * 1000);
-            diagnostics['server'] = {
-                name: 'ynab-mcp-server',
+            diagnostics["server"] = {
+                name: "ynab-mcp-server",
                 version: this.dependencies.serverVersion,
                 node_version: process.version,
                 platform: process.platform,
@@ -53,35 +51,37 @@ export class DiagnosticManager {
                 uptime_ms: uptimeMs,
                 uptime_readable: formatUptime(uptimeMs),
                 env: {
-                    node_env: process.env['NODE_ENV'] || 'development',
-                    minify_output: process.env['YNAB_MCP_MINIFY_OUTPUT'] ?? 'true',
+                    node_env: process.env["NODE_ENV"] || "development",
+                    minify_output: process.env["YNAB_MCP_MINIFY_OUTPUT"] ?? "true",
                 },
             };
         }
         if (options.include_memory) {
             const memUsage = process.memoryUsage();
-            diagnostics['memory'] = {
+            diagnostics["memory"] = {
                 rss_mb: formatBytes(memUsage.rss),
                 heap_used_mb: formatBytes(memUsage.heapUsed),
                 heap_total_mb: formatBytes(memUsage.heapTotal),
                 external_mb: formatBytes(memUsage.external),
                 array_buffers_mb: formatBytes(memUsage.arrayBuffers ?? 0),
                 description: {
-                    rss: 'Resident Set Size - total memory allocated for the process',
-                    heap_used: 'Used heap memory (objects, closures, etc.)',
-                    heap_total: 'Total heap memory allocated',
-                    external: 'Memory used by C++ objects bound to JavaScript objects',
-                    array_buffers: 'Memory allocated for ArrayBuffer and SharedArrayBuffer',
+                    rss: "Resident Set Size - total memory allocated for the process",
+                    heap_used: "Used heap memory (objects, closures, etc.)",
+                    heap_total: "Total heap memory allocated",
+                    external: "Memory used by C++ objects bound to JavaScript objects",
+                    array_buffers: "Memory allocated for ArrayBuffer and SharedArrayBuffer",
                 },
             };
         }
         if (options.include_environment) {
-            const token = process.env['YNAB_ACCESS_TOKEN'];
+            const token = process.env["YNAB_ACCESS_TOKEN"];
             const envKeys = Object.keys(process.env ?? {});
-            const ynabEnvKeys = envKeys.filter((key) => key.toUpperCase().includes('YNAB'));
+            const ynabEnvKeys = envKeys.filter((key) => key.toUpperCase().includes("YNAB"));
             const rawTokenLength = token?.length ?? 0;
-            const reportedTokenLength = token && token.length >= 8 ? rawTokenLength + (rawTokenLength % 2) : rawTokenLength;
-            diagnostics['environment'] = {
+            const reportedTokenLength = token && token.length >= 8
+                ? rawTokenLength + (rawTokenLength % 2)
+                : rawTokenLength;
+            diagnostics["environment"] = {
                 token_present: !!token,
                 token_length: reportedTokenLength,
                 token_preview: maskToken(token),
@@ -90,7 +90,8 @@ export class DiagnosticManager {
             };
         }
         if (options.include_security) {
-            diagnostics['security'] = this.dependencies.securityMiddleware.getSecurityStats();
+            diagnostics["security"] =
+                this.dependencies.securityMiddleware.getSecurityStats();
         }
         if (options.include_cache) {
             const cacheStats = this.dependencies.cacheManager.getStats();
@@ -98,21 +99,21 @@ export class DiagnosticManager {
                 try {
                     const metadata = this.dependencies.cacheManager.getCacheMetadata();
                     const serialized = JSON.stringify(metadata);
-                    return Math.round(Buffer.byteLength(serialized, 'utf8') / 1024);
+                    return Math.round(Buffer.byteLength(serialized, "utf8") / 1024);
                 }
                 catch {
                     return 0;
                 }
             };
             const performanceParts = [];
-            if ('hitRate' in cacheStats) {
+            if ("hitRate" in cacheStats) {
                 const hitRatePercent = (cacheStats.hitRate * 100).toFixed(1);
                 performanceParts.push(`Hit rate: ${hitRatePercent}% (${cacheStats.hits} hits, ${cacheStats.misses} misses)`);
             }
-            if ('evictions' in cacheStats && cacheStats.evictions > 0) {
+            if ("evictions" in cacheStats && cacheStats.evictions > 0) {
                 performanceParts.push(`LRU evictions: ${cacheStats.evictions}`);
             }
-            if ('lastCleanup' in cacheStats && cacheStats.lastCleanup) {
+            if ("lastCleanup" in cacheStats && cacheStats.lastCleanup) {
                 const lastCleanupDate = new Date(cacheStats.lastCleanup);
                 const minutesAgo = Math.round((Date.now() - lastCleanupDate.getTime()) / (60 * 1000));
                 performanceParts.push(`Last cleanup: ${minutesAgo} minutes ago`);
@@ -122,7 +123,7 @@ export class DiagnosticManager {
                 estimated_size_kb: estimateCacheSize(),
                 keys: cacheStats.keys,
             };
-            if ('hits' in cacheStats) {
+            if ("hits" in cacheStats) {
                 cacheData.hits = cacheStats.hits;
                 cacheData.misses = cacheStats.misses;
                 cacheData.evictions = cacheStats.evictions;
@@ -132,10 +133,10 @@ export class DiagnosticManager {
                 cacheData.maxEntries = cacheStats.maxEntries;
                 cacheData.hitRate = `${(cacheStats.hitRate * 100).toFixed(2)}%`;
                 if (performanceParts.length > 0) {
-                    cacheData.performance_summary = performanceParts.join(', ');
+                    cacheData.performance_summary = performanceParts.join(", ");
                 }
             }
-            diagnostics['cache'] = cacheData;
+            diagnostics["cache"] = cacheData;
         }
         if (options.include_delta === true &&
             this.dependencies.serverKnowledgeStore &&
@@ -144,11 +145,11 @@ export class DiagnosticManager {
             const deltaStats = this.dependencies.deltaCache.getStats();
             const totalDeltaRequests = deltaStats.deltaHits + deltaStats.deltaMisses;
             const deltaHitRate = totalDeltaRequests > 0 ? deltaStats.deltaHits / totalDeltaRequests : 0;
-            diagnostics['delta'] = {
-                enabled: process.env['YNAB_MCP_ENABLE_DELTA'] === 'true',
+            diagnostics["delta"] = {
+                enabled: process.env["YNAB_MCP_ENABLE_DELTA"] === "true",
                 knowledge_entries: Object.keys(knowledgeStats.entries).length,
                 knowledge_stats: knowledgeStats.entries,
-                feature_flag: process.env['YNAB_MCP_ENABLE_DELTA'] ?? 'false',
+                feature_flag: process.env["YNAB_MCP_ENABLE_DELTA"] ?? "false",
                 delta_hits: deltaStats.deltaHits,
                 delta_misses: deltaStats.deltaMisses,
                 delta_hit_rate: Number(deltaHitRate.toFixed(4)),
@@ -157,7 +158,12 @@ export class DiagnosticManager {
             };
         }
         return {
-            content: [{ type: 'text', text: this.dependencies.responseFormatter.format(diagnostics) }],
+            content: [
+                {
+                    type: "text",
+                    text: this.dependencies.responseFormatter.format(diagnostics),
+                },
+            ],
         };
     }
 }

package/dist/server/errorHandler.d.ts

@@ -1,8 +1,8 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 interface ErrorResponseFormatter {
     format(value: unknown): string;
 }
-export declare const enum YNABErrorCode {
+export declare enum YNABErrorCode {
     BAD_REQUEST = 400,
     UNAUTHORIZED = 401,
     FORBIDDEN = 403,
@@ -10,7 +10,7 @@ export declare const enum YNABErrorCode {
     TOO_MANY_REQUESTS = 429,
     INTERNAL_SERVER_ERROR = 500
 }
-export declare const enum SecurityErrorCode {
+export declare enum SecurityErrorCode {
     RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
     VALIDATION_ERROR = "VALIDATION_ERROR",
     UNKNOWN_ERROR = "UNKNOWN_ERROR"
@@ -37,12 +37,8 @@ export declare class ValidationError extends Error {
 }
 export declare class ErrorHandler {
     private formatter;
-    private static defaultInstance;
     constructor(formatter: ErrorResponseFormatter);
-    private static createFallbackFormatter;
-    static setFormatter(formatter: ErrorResponseFormatter): void;
     handleError(error: unknown, context: string): CallToolResult;
-    static handleError(error: unknown, context: string): CallToolResult;
     private createErrorResponse;
     private detectErrorCode;
     private getUserFriendlyMessage;
@@ -59,13 +55,10 @@ export declare class ErrorHandler {
     private extractYNABApiError;
     private sanitizeErrorDetails;
     withErrorHandling<T>(operation: () => Promise<T>, context: string): Promise<T | CallToolResult>;
-    static withErrorHandling<T>(operation: () => Promise<T>, context: string): Promise<T | CallToolResult>;
     createValidationError(message: string, details?: string, suggestions?: string[]): CallToolResult;
-    static createValidationError(message: string, details?: string, suggestions?: string[]): CallToolResult;
     createYNABError(code: YNABErrorCode, context: string, originalError?: unknown): YNABAPIError;
-    static createYNABError(code: YNABErrorCode, context: string, originalError?: unknown): YNABAPIError;
 }
 export declare function createErrorHandler(formatter: ErrorResponseFormatter): ErrorHandler;
-export declare function handleToolError(error: unknown, toolName: string, operation: string): CallToolResult;
-export declare function withToolErrorHandling<T>(operation: () => Promise<T>, toolName: string, operationName: string): Promise<T | CallToolResult>;
+export declare function handleToolError(error: unknown, toolName: string, operation: string, errorHandler?: ErrorHandler): CallToolResult;
+export declare function withToolErrorHandling<T>(operation: () => Promise<T>, toolName: string, operationName: string, errorHandler?: ErrorHandler): Promise<T | CallToolResult>;
 export {};