@dizzlkheinz/ynab-mcpb 0.18.3 → 0.19.0

package/dist/server/prompts.d.ts

@@ -11,9 +11,9 @@ export interface PromptDefinition {
 export interface PromptResponse {
     description: string;
     messages: {
-        role: 'user' | 'assistant';
+        role: "user" | "assistant";
         content: {
-            type: 'text';
+            type: "text";
             text: string;
         };
     }[];

package/dist/server/prompts.js

@@ -1,88 +1,88 @@
 const defaultPromptDefinitions = [
     {
-        name: 'create-transaction',
-        description: 'Create a new transaction in YNAB',
+        name: "create-transaction",
+        description: "Create a new transaction in YNAB",
         arguments: [
             {
-                name: 'budget_name',
-                description: 'Name of the budget (optional, uses first budget if not specified)',
+                name: "budget_name",
+                description: "Name of the budget (optional, uses first budget if not specified)",
                 required: false,
             },
             {
-                name: 'account_name',
-                description: 'Name of the account',
+                name: "account_name",
+                description: "Name of the account",
                 required: true,
             },
             {
-                name: 'amount',
-                description: 'Transaction amount (negative for expenses, positive for income)',
+                name: "amount",
+                description: "Transaction amount (negative for expenses, positive for income)",
                 required: true,
             },
             {
-                name: 'payee',
-                description: 'Who you paid or received money from',
+                name: "payee",
+                description: "Who you paid or received money from",
                 required: true,
             },
             {
-                name: 'category',
-                description: 'Budget category (optional)',
+                name: "category",
+                description: "Budget category (optional)",
                 required: false,
             },
             {
-                name: 'memo',
-                description: 'Additional notes (optional)',
+                name: "memo",
+                description: "Additional notes (optional)",
                 required: false,
             },
         ],
     },
     {
-        name: 'budget-summary',
-        description: 'Get a summary of your budget status',
+        name: "budget-summary",
+        description: "Get a summary of your budget status",
         arguments: [
             {
-                name: 'budget_name',
-                description: 'Name of the budget (optional, uses first budget if not specified)',
+                name: "budget_name",
+                description: "Name of the budget (optional, uses first budget if not specified)",
                 required: false,
             },
             {
-                name: 'month',
-                description: 'Month to analyze (YYYY-MM format, optional, uses current month if not specified)',
+                name: "month",
+                description: "Month to analyze (YYYY-MM format, optional, uses current month if not specified)",
                 required: false,
             },
         ],
     },
     {
-        name: 'account-balances',
-        description: 'Check balances across all accounts',
+        name: "account-balances",
+        description: "Check balances across all accounts",
         arguments: [
             {
-                name: 'budget_name',
-                description: 'Name of the budget (optional, uses first budget if not specified)',
+                name: "budget_name",
+                description: "Name of the budget (optional, uses first budget if not specified)",
                 required: false,
             },
             {
-                name: 'account_type',
-                description: 'Filter by account type (checking, savings, creditCard, etc.)',
+                name: "account_type",
+                description: "Filter by account type (checking, savings, creditCard, etc.)",
                 required: false,
             },
         ],
     },
 ];
 const defaultPromptHandlers = {
-    'create-transaction': async (_name, args) => {
-        const budgetName = args?.['budget_name'] || 'first available budget';
-        const accountName = args?.['account_name'] || '[ACCOUNT_NAME]';
-        const amount = args?.['amount'] || '[AMOUNT]';
-        const payee = args?.['payee'] || '[PAYEE]';
-        const category = args?.['category'] || '[CATEGORY]';
-        const memo = args?.['memo'] || '';
+    "create-transaction": async (_name, args) => {
+        const budgetName = args?.["budget_name"] || "first available budget";
+        const accountName = args?.["account_name"] || "[ACCOUNT_NAME]";
+        const amount = args?.["amount"] || "[AMOUNT]";
+        const payee = args?.["payee"] || "[PAYEE]";
+        const category = args?.["category"] || "[CATEGORY]";
+        const memo = args?.["memo"] || "";
         return {
             description: `Create a transaction for ${payee} in ${accountName}`,
             messages: [
                 {
-                    role: 'user',
+                    role: "user",
                     content: {
-                        type: 'text',
+                        type: "text",
                         text: `Please create a transaction with the following details:
 - Budget: ${budgetName}
 - Account: ${accountName}
@@ -102,16 +102,16 @@ Use the appropriate YNAB MCP tools to:
             ],
         };
     },
-    'budget-summary': async (_name, args) => {
-        const summaryBudget = args?.['budget_name'] || 'first available budget';
-        const month = args?.['month'] || 'current month';
+    "budget-summary": async (_name, args) => {
+        const summaryBudget = args?.["budget_name"] || "first available budget";
+        const month = args?.["month"] || "current month";
         return {
             description: `Get budget summary for ${summaryBudget}`,
             messages: [
                 {
-                    role: 'user',
+                    role: "user",
                     content: {
-                        type: 'text',
+                        type: "text",
                         text: `Please provide a comprehensive budget summary for ${summaryBudget} (${month}):
 
 IMPORTANT: In YNAB, understand these key fields:
@@ -148,16 +148,16 @@ Format the response in a clear, easy-to-read summary.`,
             ],
         };
     },
-    'account-balances': async (_name, args) => {
-        const balanceBudget = args?.['budget_name'] || 'first available budget';
-        const accountType = args?.['account_type'] || 'all accounts';
+    "account-balances": async (_name, args) => {
+        const balanceBudget = args?.["budget_name"] || "first available budget";
+        const accountType = args?.["account_type"] || "all accounts";
         return {
             description: `Check account balances for ${accountType}`,
             messages: [
                 {
-                    role: 'user',
+                    role: "user",
                     content: {
-                        type: 'text',
+                        type: "text",
                         text: `Please show account balances for ${balanceBudget}:
 
 1. List all budgets and select the appropriate one

package/dist/server/rateLimiter.js

@@ -74,11 +74,11 @@ export class RateLimitError extends Error {
         super(message);
         this.resetTime = resetTime;
         this.remaining = remaining;
-        this.name = 'RateLimitError';
+        this.name = "RateLimitError";
     }
 }
 export const globalRateLimiter = new RateLimiter({
-    enableLogging: process.env['RATE_LIMIT_LOGGING'] === 'true' ||
-        process.env['LOG_LEVEL'] === 'debug' ||
-        process.env['VERBOSE_TESTS'] === 'true',
+    enableLogging: process.env["RATE_LIMIT_LOGGING"] === "true" ||
+        process.env["LOG_LEVEL"] === "debug" ||
+        process.env["VERBOSE_TESTS"] === "true",
 });

package/dist/server/requestLogger.d.ts

@@ -13,7 +13,7 @@ export interface LogEntry {
 }
 export interface LoggerConfig {
     enabled: boolean;
-    logLevel: 'error' | 'warn' | 'info' | 'debug';
+    logLevel: "error" | "warn" | "info" | "debug";
     maxLogEntries: number;
     sanitizeParameters: boolean;
 }

package/dist/server/requestLogger.js

@@ -2,8 +2,8 @@ export class RequestLogger {
     constructor(config = {}) {
         this.logs = [];
         this.config = {
-            enabled: process.env['NODE_ENV'] !== 'production',
-            logLevel: process.env['LOG_LEVEL'] || 'info',
+            enabled: process.env["NODE_ENV"] !== "production",
+            logLevel: process.env["LOG_LEVEL"] || "info",
             maxLogEntries: 1000,
             sanitizeParameters: true,
             ...config,
@@ -16,7 +16,9 @@ export class RequestLogger {
             timestamp: new Date(),
             toolName,
             operation,
-            parameters: this.config.sanitizeParameters ? this.sanitizeParameters(parameters) : parameters,
+            parameters: this.config.sanitizeParameters
+                ? this.sanitizeParameters(parameters)
+                : parameters,
             success,
             ...(duration !== undefined && { duration }),
             ...(error && { error: this.sanitizeError(error) }),
@@ -46,7 +48,8 @@ export class RequestLogger {
             filtered = filtered.filter((log) => log.success === filter.success);
         }
         if (filter.since) {
-            filtered = filtered.filter((log) => log.timestamp >= filter.since);
+            const since = filter.since;
+            filtered = filtered.filter((log) => log.timestamp >= since);
         }
         if (filter.limit) {
             filtered = filtered.slice(-filter.limit);
@@ -61,17 +64,17 @@ export class RequestLogger {
         const successfulRequests = this.logs.filter((log) => log.success).length;
         const failedRequests = totalRequests - successfulRequests;
         const durationsWithValues = this.logs
-            .filter((log) => log.duration !== undefined)
-            .map((log) => log.duration);
+            .map((log) => log.duration)
+            .filter((duration) => duration !== undefined);
         const averageDuration = durationsWithValues.length > 0
             ? durationsWithValues.reduce((sum, duration) => sum + duration, 0) /
                 durationsWithValues.length
             : 0;
         const rateLimitedRequests = this.logs.filter((log) => log.rateLimitInfo?.isLimited).length;
         const toolUsage = {};
-        this.logs.forEach((log) => {
+        for (const log of this.logs) {
             toolUsage[log.toolName] = (toolUsage[log.toolName] || 0) + 1;
-        });
+        }
         return {
             totalRequests,
             successfulRequests,
@@ -85,12 +88,12 @@ export class RequestLogger {
         const sanitized = {};
         for (const [key, value] of Object.entries(parameters)) {
             if (this.isSensitiveParameter(key)) {
-                sanitized[key] = '***';
+                sanitized[key] = "***";
             }
-            else if (typeof value === 'string') {
+            else if (typeof value === "string") {
                 sanitized[key] = this.sanitizeString(value);
             }
-            else if (typeof value === 'object' && value !== null) {
+            else if (typeof value === "object" && value !== null) {
                 sanitized[key] = this.sanitizeObject(value);
             }
             else {
@@ -101,39 +104,41 @@ export class RequestLogger {
     }
     isSensitiveParameter(key) {
         const sensitiveKeys = [
-            'token',
-            'access_token',
-            'api_key',
-            'password',
-            'secret',
-            'authorization',
-            'auth',
-            'key',
-            'credential',
+            "token",
+            "access_token",
+            "api_key",
+            "password",
+            "secret",
+            "authorization",
+            "auth",
+            "key",
+            "credential",
         ];
         return sensitiveKeys.some((sensitiveKey) => key.toLowerCase().includes(sensitiveKey));
     }
     sanitizeString(value) {
         return value
-            .replace(/[a-zA-Z0-9]{30,}/g, '***')
-            .replace(/Bearer\s+[a-zA-Z0-9_-]+/gi, 'Bearer ***')
-            .replace(/token[s]?[:\s=]+[a-zA-Z0-9_-]+/gi, 'token=***')
-            .replace(/key[s]?[:\s=]+[a-zA-Z0-9_-]+/gi, 'key=***');
+            .replace(/[a-zA-Z0-9]{30,}/g, "***")
+            .replace(/Bearer\s+[a-zA-Z0-9_-]+/gi, "Bearer ***")
+            .replace(/token[s]?[:\s=]+[a-zA-Z0-9_-]+/gi, "token=***")
+            .replace(/key[s]?[:\s=]+[a-zA-Z0-9_-]+/gi, "key=***");
     }
     sanitizeObject(obj) {
         if (Array.isArray(obj)) {
-            return obj.map((item) => typeof item === 'object' && item !== null ? this.sanitizeObject(item) : item);
+            return obj.map((item) => typeof item === "object" && item !== null
+                ? this.sanitizeObject(item)
+                : item);
         }
-        if (typeof obj === 'object' && obj !== null) {
+        if (typeof obj === "object" && obj !== null) {
             const sanitized = {};
             for (const [key, value] of Object.entries(obj)) {
                 if (this.isSensitiveParameter(key)) {
-                    sanitized[key] = '***';
+                    sanitized[key] = "***";
                 }
-                else if (typeof value === 'string') {
+                else if (typeof value === "string") {
                     sanitized[key] = this.sanitizeString(value);
                 }
-                else if (typeof value === 'object' && value !== null) {
+                else if (typeof value === "object" && value !== null) {
                     sanitized[key] = this.sanitizeObject(value);
                 }
                 else {
@@ -150,21 +155,21 @@ export class RequestLogger {
     outputLog(logEntry) {
         const logMessage = this.formatLogMessage(logEntry);
         if (logEntry.success) {
-            if (this.shouldLog('info')) {
+            if (this.shouldLog("info")) {
                 console.error(`[INFO] ${logMessage}`);
             }
         }
         else {
-            if (this.shouldLog('error')) {
+            if (this.shouldLog("error")) {
                 console.error(`[ERROR] ${logMessage}`);
             }
         }
-        if (logEntry.rateLimitInfo?.isLimited && this.shouldLog('warn')) {
+        if (logEntry.rateLimitInfo?.isLimited && this.shouldLog("warn")) {
             console.error(`[WARN] Rate limit exceeded for ${logEntry.toolName}`);
         }
     }
     shouldLog(level) {
-        const levels = ['error', 'warn', 'info', 'debug'];
+        const levels = ["error", "warn", "info", "debug"];
         const currentLevelIndex = levels.indexOf(this.config.logLevel);
         const requestedLevelIndex = levels.indexOf(level);
         return requestedLevelIndex <= currentLevelIndex;
@@ -172,7 +177,7 @@ export class RequestLogger {
     formatLogMessage(logEntry) {
         const parts = [
             `${logEntry.toolName}:${logEntry.operation}`,
-            logEntry.success ? 'SUCCESS' : 'FAILED',
+            logEntry.success ? "SUCCESS" : "FAILED",
         ];
         if (logEntry.duration !== undefined) {
             parts.push(`${logEntry.duration}ms`);
@@ -183,7 +188,7 @@ export class RequestLogger {
         if (logEntry.error) {
             parts.push(`error:"${logEntry.error}"`);
         }
-        return parts.join(' | ');
+        return parts.join(" | ");
     }
 }
 export const globalRequestLogger = new RequestLogger();

package/dist/server/resources.d.ts

@@ -1,6 +1,6 @@
-import type * as ynab from 'ynab';
-import { ResourceTemplate as MCPResourceTemplate, Resource as MCPResource, ResourceContents } from '@modelcontextprotocol/sdk/types.js';
-import { CacheManager } from './cacheManager.js';
+import { type Resource as MCPResource, type ResourceTemplate as MCPResourceTemplate, type ResourceContents } from "@modelcontextprotocol/sdk/types.js";
+import type * as ynab from "ynab";
+import { CacheManager } from "./cacheManager.js";
 interface ResponseFormatter {
     format(data: unknown): string;
 }

package/dist/server/resources.js

@@ -1,9 +1,9 @@
-import { ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
-import { CacheManager, CACHE_TTLS } from './cacheManager.js';
+import { ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { CACHE_TTLS, CacheManager } from "./cacheManager.js";
 const RESOURCE_NOT_FOUND_ERROR_CODE = -32002;
 const defaultResourceHandlers = {
-    'ynab://budgets': async (uri, { ynabAPI, responseFormatter, cacheManager }) => {
-        const cacheKey = CacheManager.generateKey('resources', 'budgets', 'list');
+    "ynab://budgets": async (uri, { ynabAPI, responseFormatter, cacheManager }) => {
+        const cacheKey = CacheManager.generateKey("resources", "budgets", "list");
         return cacheManager.wrap(cacheKey, {
             ttl: CACHE_TTLS.BUDGETS,
             loader: async () => {
@@ -20,7 +20,7 @@ const defaultResourceHandlers = {
                     return [
                         {
                             uri: uri,
-                            mimeType: 'application/json',
+                            mimeType: "application/json",
                             text: responseFormatter.format({ budgets }),
                         },
                     ];
@@ -32,8 +32,8 @@ const defaultResourceHandlers = {
             },
         });
     },
-    'ynab://user': async (uri, { ynabAPI, responseFormatter, cacheManager }) => {
-        const cacheKey = CacheManager.generateKey('resources', 'user');
+    "ynab://user": async (uri, { ynabAPI, responseFormatter, cacheManager }) => {
+        const cacheKey = CacheManager.generateKey("resources", "user");
         return cacheManager.wrap(cacheKey, {
             ttl: CACHE_TTLS.USER_INFO,
             loader: async () => {
@@ -46,7 +46,7 @@ const defaultResourceHandlers = {
                     return [
                         {
                             uri: uri,
-                            mimeType: 'application/json',
+                            mimeType: "application/json",
                             text: responseFormatter.format({ user }),
                         },
                     ];
@@ -61,30 +61,30 @@ const defaultResourceHandlers = {
 };
 const defaultResourceDefinitions = [
     {
-        uri: 'ynab://budgets',
-        name: 'YNAB Budgets',
-        description: 'List of all available budgets',
-        mimeType: 'application/json',
+        uri: "ynab://budgets",
+        name: "YNAB Budgets",
+        description: "List of all available budgets",
+        mimeType: "application/json",
     },
     {
-        uri: 'ynab://user',
-        name: 'YNAB User Info',
-        description: 'Current user information including ID and email address',
-        mimeType: 'application/json',
+        uri: "ynab://user",
+        name: "YNAB User Info",
+        description: "Current user information including ID and email address",
+        mimeType: "application/json",
     },
 ];
 const defaultResourceTemplates = [
     {
-        uriTemplate: 'ynab://budgets/{budget_id}',
-        name: 'Budget Details',
-        description: 'Detailed information for a specific budget',
-        mimeType: 'application/json',
+        uriTemplate: "ynab://budgets/{budget_id}",
+        name: "Budget Details",
+        description: "Detailed information for a specific budget",
+        mimeType: "application/json",
         handler: async (uri, params, { ynabAPI, responseFormatter, cacheManager }) => {
-            const budget_id = params['budget_id'];
+            const budget_id = params["budget_id"];
             if (!budget_id) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing budget_id parameter');
+                throw new McpError(ErrorCode.InvalidParams, "Missing budget_id parameter");
             }
-            const cacheKey = CacheManager.generateKey('resources', 'budgets', 'get', budget_id);
+            const cacheKey = CacheManager.generateKey("resources", "budgets", "get", budget_id);
             return cacheManager.wrap(cacheKey, {
                 ttl: CACHE_TTLS.BUDGETS,
                 loader: async () => {
@@ -93,7 +93,7 @@ const defaultResourceTemplates = [
                         return [
                             {
                                 uri,
-                                mimeType: 'application/json',
+                                mimeType: "application/json",
                                 text: responseFormatter.format(response.data.budget),
                             },
                         ];
@@ -107,16 +107,16 @@ const defaultResourceTemplates = [
         },
     },
     {
-        uriTemplate: 'ynab://budgets/{budget_id}/accounts',
-        name: 'Budget Accounts',
-        description: 'List of accounts for a specific budget',
-        mimeType: 'application/json',
+        uriTemplate: "ynab://budgets/{budget_id}/accounts",
+        name: "Budget Accounts",
+        description: "List of accounts for a specific budget",
+        mimeType: "application/json",
         handler: async (uri, params, { ynabAPI, responseFormatter, cacheManager }) => {
-            const budget_id = params['budget_id'];
+            const budget_id = params["budget_id"];
             if (!budget_id) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing budget_id parameter');
+                throw new McpError(ErrorCode.InvalidParams, "Missing budget_id parameter");
             }
-            const cacheKey = CacheManager.generateKey('resources', 'accounts', 'list', budget_id);
+            const cacheKey = CacheManager.generateKey("resources", "accounts", "list", budget_id);
             return cacheManager.wrap(cacheKey, {
                 ttl: CACHE_TTLS.ACCOUNTS,
                 loader: async () => {
@@ -125,7 +125,7 @@ const defaultResourceTemplates = [
                         return [
                             {
                                 uri,
-                                mimeType: 'application/json',
+                                mimeType: "application/json",
                                 text: responseFormatter.format(response.data.accounts),
                             },
                         ];
@@ -139,20 +139,20 @@ const defaultResourceTemplates = [
         },
     },
     {
-        uriTemplate: 'ynab://budgets/{budget_id}/accounts/{account_id}',
-        name: 'Account Details',
-        description: 'Detailed information for a specific account within a budget',
-        mimeType: 'application/json',
+        uriTemplate: "ynab://budgets/{budget_id}/accounts/{account_id}",
+        name: "Account Details",
+        description: "Detailed information for a specific account within a budget",
+        mimeType: "application/json",
         handler: async (uri, params, { ynabAPI, responseFormatter, cacheManager }) => {
-            const budget_id = params['budget_id'];
-            const account_id = params['account_id'];
+            const budget_id = params["budget_id"];
+            const account_id = params["account_id"];
             if (!budget_id) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing budget_id parameter');
+                throw new McpError(ErrorCode.InvalidParams, "Missing budget_id parameter");
             }
             if (!account_id) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing account_id parameter');
+                throw new McpError(ErrorCode.InvalidParams, "Missing account_id parameter");
             }
-            const cacheKey = CacheManager.generateKey('resources', 'accounts', 'get', budget_id, account_id);
+            const cacheKey = CacheManager.generateKey("resources", "accounts", "get", budget_id, account_id);
             return cacheManager.wrap(cacheKey, {
                 ttl: CACHE_TTLS.ACCOUNTS,
                 loader: async () => {
@@ -161,7 +161,7 @@ const defaultResourceTemplates = [
                         return [
                             {
                                 uri,
-                                mimeType: 'application/json',
+                                mimeType: "application/json",
                                 text: responseFormatter.format(response.data.account),
                             },
                         ];
@@ -181,7 +181,9 @@ export class ResourceManager {
         this.resourceHandlers = { ...defaultResourceHandlers };
         this.resourceDefinitions = [...defaultResourceDefinitions];
         this.resourceTemplates = [];
-        defaultResourceTemplates.forEach((template) => this.registerTemplate(template));
+        for (const template of defaultResourceTemplates) {
+            this.registerTemplate(template);
+        }
     }
     registerResource(definition, handler) {
         this.resourceDefinitions.push(definition);
@@ -242,28 +244,28 @@ export class ResourceManager {
     }
     matchTemplate(template, uri) {
         if (!/^[a-z0-9:/\-_{}]+$/i.test(template)) {
-            throw new Error('Invalid template format: contains unsafe characters');
+            throw new Error("Invalid template format: contains unsafe characters");
         }
         const paramNames = [];
         const regexPattern = template
-            .replace(/[.*+?^$()|[\]\\]/g, '\\$&')
+            .replace(/[.*+?^$()|[\]\\]/g, "\\$&")
             .replace(/{([a-z_][a-z0-9_]*)}/gi, (_, name) => {
             paramNames.push(name);
-            return '([^/]+)';
+            return "([^/]+)";
         });
         const regex = new RegExp(`^${regexPattern}$`);
         const match = uri.match(regex);
         if (match) {
             const result = {};
-            paramNames.forEach((name, i) => {
+            for (const [i, name] of paramNames.entries()) {
                 const value = match[i + 1];
                 if (value) {
-                    if (value.includes('..') || value.includes('\\')) {
+                    if (value.includes("..") || value.includes("\\")) {
                         throw new Error(`Invalid parameter value: ${name}=${value}`);
                     }
                     result[name] = value;
                 }
-            });
+            }
             return result;
         }
         return null;
@@ -275,13 +277,14 @@ export class ResourceManager {
         }
         const placeholderPattern = /{([^}]+)}/g;
         const paramNames = [];
-        let match;
-        while ((match = placeholderPattern.exec(uriTemplate)) !== null) {
-            const paramName = match[1] ?? '';
+        let match = placeholderPattern.exec(uriTemplate);
+        while (match !== null) {
+            const paramName = match[1] ?? "";
             if (!/^[a-z_][a-z0-9_]*$/i.test(paramName)) {
                 throw new Error(`Invalid template parameter name '${paramName}' in template ${uriTemplate}`);
             }
             paramNames.push(paramName);
+            match = placeholderPattern.exec(uriTemplate);
         }
         const uniqueNames = new Set(paramNames);
         if (uniqueNames.size !== paramNames.length) {