@dizzlkheinz/ynab-mcpb 0.18.4 → 0.19.0

package/dist/tools/utilityTools.d.ts

@@ -1,5 +1,6 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import * as ynab from 'ynab';
-import type { ToolFactory } from '../types/toolRegistration.js';
-export declare function handleGetUser(ynabAPI: ynab.API): Promise<CallToolResult>;
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type * as ynab from "ynab";
+import type { ErrorHandler } from "../server/errorHandler.js";
+import type { ToolFactory } from "../types/toolRegistration.js";
+export declare function handleGetUser(ynabAPI: ynab.API, errorHandler?: ErrorHandler): Promise<CallToolResult>;
 export declare const registerUtilityTools: ToolFactory;

package/dist/tools/utilityTools.js

@@ -1,9 +1,9 @@
-import { responseFormatter } from '../server/responseFormatter.js';
-import { withToolErrorHandling } from '../types/index.js';
-import { createAdapters } from './adapters.js';
-import { emptyObjectSchema } from './schemas/common.js';
-import { ToolAnnotationPresets } from './toolCategories.js';
-export async function handleGetUser(ynabAPI) {
+import { responseFormatter } from "../server/responseFormatter.js";
+import { withToolErrorHandling } from "../types/index.js";
+import { createAdapters } from "./adapters.js";
+import { emptyObjectSchema } from "./schemas/common.js";
+import { ToolAnnotationPresets } from "./toolCategories.js";
+export async function handleGetUser(ynabAPI, errorHandler) {
     return await withToolErrorHandling(async () => {
         const response = await ynabAPI.user.getUser();
         const userInfo = response.data.user;
@@ -13,24 +13,24 @@ export async function handleGetUser(ynabAPI) {
         return {
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: responseFormatter.format({ user }),
                 },
             ],
         };
-    }, 'ynab:get_user', 'getting user information');
+    }, "ynab:get_user", "getting user information", errorHandler);
 }
 export const registerUtilityTools = (registry, context) => {
     const { adaptNoInput } = createAdapters(context);
     registry.register({
-        name: 'get_user',
-        description: 'Get information about the authenticated user',
+        name: "get_user",
+        description: "Get information about the authenticated user",
         inputSchema: emptyObjectSchema,
         handler: adaptNoInput(handleGetUser),
         metadata: {
             annotations: {
                 ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
-                title: 'YNAB: Get User Information',
+                title: "YNAB: Get User Information",
             },
         },
     });

package/dist/types/index.d.ts

@@ -12,10 +12,10 @@ export declare class AuthenticationError extends Error {
 export declare class ConfigurationError extends Error {
     constructor(message: string);
 }
-export { ErrorHandler, YNABAPIError, ValidationError, YNABErrorCode, SecurityErrorCode, type ErrorResponse, handleToolError, withToolErrorHandling, } from '../server/errorHandler.js';
-export { RateLimiter, RateLimitError, globalRateLimiter, type RateLimitConfig, type RateLimitInfo, } from '../server/rateLimiter.js';
-export { RequestLogger, globalRequestLogger, type LogEntry, type LoggerConfig, } from '../server/requestLogger.js';
-export { SecurityMiddleware, withSecurityWrapper, type SecurityContext, } from '../server/securityMiddleware.js';
-export type { MCPToolAnnotations } from './toolAnnotations.js';
-export type { ToolDefinition } from '../server/toolRegistry.js';
-export type { ToolContext, ToolFactory, BudgetIdResolverFactory } from './toolRegistration.js';
+export { ErrorHandler, YNABAPIError, ValidationError, YNABErrorCode, SecurityErrorCode, type ErrorResponse, handleToolError, withToolErrorHandling, } from "../server/errorHandler.js";
+export { RateLimiter, RateLimitError, globalRateLimiter, type RateLimitConfig, type RateLimitInfo, } from "../server/rateLimiter.js";
+export { RequestLogger, globalRequestLogger, type LogEntry, type LoggerConfig, } from "../server/requestLogger.js";
+export { SecurityMiddleware, withSecurityWrapper, type SecurityContext, } from "../server/securityMiddleware.js";
+export type { MCPToolAnnotations } from "./toolAnnotations.js";
+export type { ToolDefinition } from "../server/toolRegistry.js";
+export type { ToolContext, ToolFactory, BudgetIdResolverFactory, } from "./toolRegistration.js";

package/dist/types/index.js

@@ -1,16 +1,16 @@
 export class AuthenticationError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'AuthenticationError';
+        this.name = "AuthenticationError";
     }
 }
 export class ConfigurationError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'ConfigurationError';
+        this.name = "ConfigurationError";
     }
 }
-export { ErrorHandler, YNABAPIError, ValidationError, handleToolError, withToolErrorHandling, } from '../server/errorHandler.js';
-export { RateLimiter, RateLimitError, globalRateLimiter, } from '../server/rateLimiter.js';
-export { RequestLogger, globalRequestLogger, } from '../server/requestLogger.js';
-export { SecurityMiddleware, withSecurityWrapper, } from '../server/securityMiddleware.js';
+export { ErrorHandler, YNABAPIError, ValidationError, YNABErrorCode, SecurityErrorCode, handleToolError, withToolErrorHandling, } from "../server/errorHandler.js";
+export { RateLimiter, RateLimitError, globalRateLimiter, } from "../server/rateLimiter.js";
+export { RequestLogger, globalRequestLogger, } from "../server/requestLogger.js";
+export { SecurityMiddleware, withSecurityWrapper, } from "../server/securityMiddleware.js";

package/dist/types/reconciliation.d.ts

@@ -19,6 +19,6 @@ export interface NormalizedYNABTransaction {
     payee: string | null;
     memo: string | null;
     categoryName: string | null;
-    cleared: 'cleared' | 'uncleared' | 'reconciled';
+    cleared: "cleared" | "uncleared" | "reconciled";
     approved: boolean;
 }

package/dist/types/toolRegistration.d.ts

@@ -1,11 +1,12 @@
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import * as ynab from 'ynab';
-import type { ToolRegistry, ToolExecutionPayload, DefaultArgumentResolver } from '../server/toolRegistry.js';
-import type { DeltaFetcher } from '../tools/deltaFetcher.js';
-import type { DeltaCache } from '../server/deltaCache.js';
-import type { ServerKnowledgeStore } from '../server/serverKnowledgeStore.js';
-import type { DiagnosticManager } from '../server/diagnostics.js';
-import type { CacheManager } from '../server/cacheManager.js';
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type * as ynab from "ynab";
+import type { CacheManager } from "../server/cacheManager.js";
+import type { DeltaCache } from "../server/deltaCache.js";
+import type { DiagnosticManager } from "../server/diagnostics.js";
+import type { ErrorHandler } from "../server/errorHandler.js";
+import type { ServerKnowledgeStore } from "../server/serverKnowledgeStore.js";
+import type { DefaultArgumentResolver, ToolExecutionPayload, ToolRegistry } from "../server/toolRegistry.js";
+import type { DeltaFetcher } from "../tools/deltaFetcher.js";
 export interface ToolContext {
     ynabAPI: ynab.API;
     deltaFetcher: DeltaFetcher;
@@ -14,14 +15,15 @@ export interface ToolContext {
     getDefaultBudgetId: () => string | undefined;
     setDefaultBudget: (budgetId: string) => void;
     cacheManager: CacheManager;
+    errorHandler: ErrorHandler;
     diagnosticManager?: DiagnosticManager;
 }
 export type ToolFactory = (registry: ToolRegistry, context: ToolContext) => void;
 export type Adapter<TInput extends Record<string, unknown>> = (payload: ToolExecutionPayload<TInput>) => Promise<CallToolResult>;
-export type Handler<TInput extends Record<string, unknown>> = (api: ynab.API, params: TInput) => Promise<CallToolResult>;
-export type DeltaHandler<TInput extends Record<string, unknown>> = (api: ynab.API, deltaFetcher: DeltaFetcher, params: TInput) => Promise<CallToolResult>;
-export type WriteHandler<TInput extends Record<string, unknown>> = (api: ynab.API, deltaCache: DeltaCache, serverKnowledgeStore: ServerKnowledgeStore, params: TInput) => Promise<CallToolResult>;
-export type NoInputHandler = (api: ynab.API) => Promise<CallToolResult>;
+export type Handler<TInput extends Record<string, unknown>> = (api: ynab.API, params: TInput, errorHandler?: ErrorHandler) => Promise<CallToolResult>;
+export type DeltaHandler<TInput extends Record<string, unknown>> = (api: ynab.API, deltaFetcher: DeltaFetcher, params: TInput, errorHandler?: ErrorHandler) => Promise<CallToolResult>;
+export type WriteHandler<TInput extends Record<string, unknown>> = (api: ynab.API, deltaCache: DeltaCache, serverKnowledgeStore: ServerKnowledgeStore, params: TInput, errorHandler?: ErrorHandler) => Promise<CallToolResult>;
+export type NoInputHandler = (api: ynab.API, errorHandler?: ErrorHandler) => Promise<CallToolResult>;
 export type BudgetIdResolverFactory = <TInput extends {
     budget_id?: string | undefined;
 }>() => DefaultArgumentResolver<TInput>;

package/dist/utils/amountUtils.js

@@ -4,7 +4,7 @@ export function milliunitsToAmount(milliunits) {
 export function amountToMilliunits(amount) {
     return Math.round(amount * 1000);
 }
-export function formatAmount(milliunits, currencySymbol = '$') {
+export function formatAmount(milliunits, currencySymbol = "$") {
     const amount = milliunitsToAmount(milliunits);
     return `${currencySymbol}${amount.toFixed(2)}`;
 }

package/dist/utils/dateUtils.js

@@ -1,9 +1,9 @@
-import { format, subMonths, isValid, parse } from 'date-fns';
+import { format, isValid, parse, subMonths } from "date-fns";
 export function formatYNABMonth(date) {
     return format(date, "yyyy-MM-'01'");
 }
 export function formatISODate(date) {
-    return format(date, 'yyyy-MM-dd');
+    return format(date, "yyyy-MM-dd");
 }
 export function getCurrentMonth() {
     return formatYNABMonth(new Date());
@@ -25,7 +25,7 @@ export function isValidISODate(dateString) {
     if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
         return false;
     }
-    const parsed = parse(dateString, 'yyyy-MM-dd', new Date());
+    const parsed = parse(dateString, "yyyy-MM-dd", new Date());
     return isValid(parsed);
 }
 export function isValidYNABMonth(monthString) {
@@ -37,7 +37,7 @@ export function isValidYNABMonth(monthString) {
 }
 export function yearMonthToYNABMonth(yearMonth) {
     if (!/^\d{4}-\d{2}$/.test(yearMonth)) {
-        throw new Error('Invalid year-month format. Expected YYYY-MM');
+        throw new Error("Invalid year-month format. Expected YYYY-MM");
     }
     return `${yearMonth}-01`;
 }

package/dist/utils/errors.d.ts

@@ -1,6 +1,6 @@
-export { BaseError } from './baseError.js';
-export { ValidationError } from './validationError.js';
-import { BaseError } from './baseError.js';
+export { BaseError } from "./baseError.js";
+export { ValidationError } from "./validationError.js";
+import { BaseError } from "./baseError.js";
 export declare class ConfigurationError extends BaseError {
 }
 export declare class AuthenticationError extends BaseError {

package/dist/utils/errors.js

@@ -1,13 +1,13 @@
-export { BaseError } from './baseError.js';
-export { ValidationError } from './validationError.js';
-import { BaseError } from './baseError.js';
+export { BaseError } from "./baseError.js";
+export { ValidationError } from "./validationError.js";
+import { BaseError } from "./baseError.js";
 export class ConfigurationError extends BaseError {
 }
 export class AuthenticationError extends BaseError {
 }
 export class YNABRequestError extends BaseError {
     constructor(status, statusText, ynabErrorId) {
-        super(`YNAB API request failed: ${status} ${statusText}${ynabErrorId ? ` (Error ID: ${ynabErrorId})` : ''}`);
+        super(`YNAB API request failed: ${status} ${statusText}${ynabErrorId ? ` (Error ID: ${ynabErrorId})` : ""}`);
         this.status = status;
         this.statusText = statusText;
         this.ynabErrorId = ynabErrorId;

package/dist/utils/money.d.ts

@@ -1,6 +1,6 @@
-import * as ynab from 'ynab';
+import * as ynab from "ynab";
 export type Milli = number;
-export type MoneyDirection = 'credit' | 'debit' | 'balanced';
+export type MoneyDirection = "credit" | "debit" | "balanced";
 export interface MoneyValue {
     value_milliunits: Milli;
     value: number;

package/dist/utils/money.js

@@ -1,5 +1,5 @@
-import * as ynab from 'ynab';
-const DEFAULT_CURRENCY = 'USD';
+import * as ynab from "ynab";
+const DEFAULT_CURRENCY = "USD";
 const DEFAULT_DECIMAL_DIGITS = 2;
 export const getDecimalDigits = (currencyFormat) => {
     return currencyFormat?.decimal_digits ?? DEFAULT_DECIMAL_DIGITS;
@@ -18,24 +18,24 @@ export const toMilli = (x) => {
 export const fromMilli = (m, decimalDigits = DEFAULT_DECIMAL_DIGITS) => {
     return ynab.utils.convertMilliUnitsToCurrencyAmount(m, decimalDigits);
 };
-export const assertMilli = (m, msg = 'Expected safe integer milliunits') => {
+export const assertMilli = (m, msg = "Expected safe integer milliunits") => {
     if (!Number.isSafeInteger(m))
         throw new Error(msg);
 };
 export const addMilli = (a, b) => {
     const s = a + b;
     if (!Number.isSafeInteger(s))
-        throw new Error('Milliunit sum overflow');
+        throw new Error("Milliunit sum overflow");
     return s;
 };
 export const inWindow = (iso, start = undefined, end = undefined) => (!start || iso >= start) && (!end || iso <= end);
 export const moneyDirection = (value) => {
     if (value === 0)
-        return 'balanced';
-    return value > 0 ? 'credit' : 'debit';
+        return "balanced";
+    return value > 0 ? "credit" : "debit";
 };
-const makeFormatter = (currency, decimalDigits = DEFAULT_DECIMAL_DIGITS) => new Intl.NumberFormat('en-US', {
-    style: 'currency',
+const makeFormatter = (currency, decimalDigits = DEFAULT_DECIMAL_DIGITS) => new Intl.NumberFormat("en-US", {
+    style: "currency",
     currency,
     minimumFractionDigits: decimalDigits,
     maximumFractionDigits: decimalDigits,

package/dist/utils/validationError.d.ts

@@ -1,3 +1,3 @@
-import { BaseError } from './baseError.js';
+import { BaseError } from "./baseError.js";
 export declare class ValidationError extends BaseError {
 }

package/dist/utils/validationError.js

@@ -1,3 +1,3 @@
-import { BaseError } from './baseError.js';
+import { BaseError } from "./baseError.js";
 export class ValidationError extends BaseError {
 }

package/docs/assets/examples/reconciliation-with-recommendations.json

@@ -1,68 +1,68 @@
 {
-  "version": "2.0",
-  "schema_url": "https://raw.githubusercontent.com/dizzlkheinz/ynab-mcp-mcpb/master/docs/schemas/reconciliation-v2.json",
-  "timestamp": "2024-01-31T10:30:00Z",
-  "data": {
-    "balance_info": {
-      "current_cleared": {
-        "value": 100.0,
-        "value_display": "$100.00",
-        "currency": "USD",
-        "direction": "debit"
-      },
-      "target_statement": {
-        "value": 122.22,
-        "value_display": "$122.22",
-        "currency": "USD",
-        "direction": "debit"
-      },
-      "discrepancy": {
-        "value": 22.22,
-        "value_display": "$22.22",
-        "currency": "USD",
-        "direction": "debit"
-      },
-      "on_track": false
-    },
-    "insights": [
-      {
-        "id": "insight-1",
-        "type": "near_match",
-        "severity": "high",
-        "title": "Unmatched Transaction Found",
-        "description": "Transaction 'EvoCarShare' for $22.22 has no match in YNAB"
-      }
-    ],
-    "recommendations": [
-      {
-        "id": "rec-abc123",
-        "action_type": "create_transaction",
-        "priority": "high",
-        "confidence": 0.95,
-        "message": "Create transaction for EvoCarShare",
-        "reason": "Transaction appears on bank statement but not in YNAB",
-        "estimated_impact": {
-          "value": 22.22,
-          "value_display": "$22.22",
-          "currency": "USD",
-          "direction": "debit"
-        },
-        "account_id": "account-xyz",
-        "source_insight_id": "insight-1",
-        "metadata": {
-          "version": "1.0",
-          "created_at": "2024-01-31T10:30:00Z"
-        },
-        "parameters": {
-          "account_id": "account-xyz",
-          "date": "2024-01-15",
-          "amount": 22.22,
-          "payee_name": "EvoCarShare",
-          "memo": "Car rental",
-          "cleared": "cleared",
-          "approved": true
-        }
-      }
-    ]
-  }
+	"version": "2.0",
+	"schema_url": "https://raw.githubusercontent.com/dizzlkheinz/ynab-mcp-mcpb/master/docs/schemas/reconciliation-v2.json",
+	"timestamp": "2024-01-31T10:30:00Z",
+	"data": {
+		"balance_info": {
+			"current_cleared": {
+				"value": 100.0,
+				"value_display": "$100.00",
+				"currency": "USD",
+				"direction": "debit"
+			},
+			"target_statement": {
+				"value": 122.22,
+				"value_display": "$122.22",
+				"currency": "USD",
+				"direction": "debit"
+			},
+			"discrepancy": {
+				"value": 22.22,
+				"value_display": "$22.22",
+				"currency": "USD",
+				"direction": "debit"
+			},
+			"on_track": false
+		},
+		"insights": [
+			{
+				"id": "insight-1",
+				"type": "near_match",
+				"severity": "high",
+				"title": "Unmatched Transaction Found",
+				"description": "Transaction 'EvoCarShare' for $22.22 has no match in YNAB"
+			}
+		],
+		"recommendations": [
+			{
+				"id": "rec-abc123",
+				"action_type": "create_transaction",
+				"priority": "high",
+				"confidence": 0.95,
+				"message": "Create transaction for EvoCarShare",
+				"reason": "Transaction appears on bank statement but not in YNAB",
+				"estimated_impact": {
+					"value": 22.22,
+					"value_display": "$22.22",
+					"currency": "USD",
+					"direction": "debit"
+				},
+				"account_id": "account-xyz",
+				"source_insight_id": "insight-1",
+				"metadata": {
+					"version": "1.0",
+					"created_at": "2024-01-31T10:30:00Z"
+				},
+				"parameters": {
+					"account_id": "account-xyz",
+					"date": "2024-01-15",
+					"amount": 22.22,
+					"payee_name": "EvoCarShare",
+					"memo": "Car rental",
+					"cleared": "cleared",
+					"approved": true
+				}
+			}
+		]
+	}
 }