@dizzlkheinz/ynab-mcpb 0.18.4 → 0.19.0

package/src/utils/__tests__/money.test.ts

@@ -1,189 +1,195 @@
-import { describe, it, expect } from 'vitest';
-import type * as ynab from 'ynab';
+import { describe, expect, it } from "vitest";
+import type * as ynab from "ynab";
 import {
-  toMilli,
-  fromMilli,
-  assertMilli,
-  addMilli,
-  inWindow,
-  moneyDirection,
-  formatMoney,
-  toMoneyValue,
-  toMoneyValueFromDecimal,
-  getDecimalDigits,
-  getCurrencyCode,
-} from '../money.js';
-
-describe('money utilities', () => {
-  describe('toMilli', () => {
-    it('converts dollars to milliunits correctly', () => {
-      expect(toMilli(1.23)).toBe(1230);
-      expect(toMilli(-5.67)).toBe(-5670);
-      expect(toMilli('10.50')).toBe(10500);
-    });
-
-    it('throws for invalid amounts', () => {
-      expect(() => toMilli(Number.MAX_SAFE_INTEGER)).toThrow('Invalid/unsafe amount');
-      expect(() => toMilli('invalid')).toThrow('Invalid/unsafe amount');
-    });
-  });
-
-  describe('fromMilli', () => {
-    it('converts milliunits with 2 decimal digits (USD) by default', () => {
-      expect(fromMilli(1230)).toBe(1.23);
-      expect(fromMilli(-5670)).toBe(-5.67);
-      expect(fromMilli(0)).toBe(0);
-    });
-
-    it('converts milliunits with 0 decimal digits (JPY)', () => {
-      expect(fromMilli(123000, 0)).toBe(123);
-      expect(fromMilli(1000, 0)).toBe(1);
-    });
-
-    it('converts milliunits with 3 decimal digits (BHD)', () => {
-      expect(fromMilli(1234, 3)).toBe(1.234);
-      expect(fromMilli(500, 3)).toBe(0.5);
-    });
-
-    it('converts milliunits with explicit 2 decimal digits', () => {
-      expect(fromMilli(1230, 2)).toBe(1.23);
-    });
-  });
-
-  describe('assertMilli', () => {
-    it('passes for safe integers', () => {
-      expect(() => assertMilli(1000)).not.toThrow();
-      expect(() => assertMilli(-500)).not.toThrow();
-      expect(() => assertMilli(0)).not.toThrow();
-    });
-
-    it('throws for non-safe integers', () => {
-      expect(() => assertMilli(1.5)).toThrow('Expected safe integer milliunits');
-      expect(() => assertMilli(Number.MAX_SAFE_INTEGER + 1)).toThrow(
-        'Expected safe integer milliunits',
-      );
-    });
-  });
-
-  describe('addMilli', () => {
-    it('adds milliunits correctly', () => {
-      expect(addMilli(1000, 2000)).toBe(3000);
-      expect(addMilli(-500, 300)).toBe(-200);
-    });
-
-    it('throws on overflow', () => {
-      expect(() => addMilli(Number.MAX_SAFE_INTEGER, 1)).toThrow('Milliunit sum overflow');
-    });
-  });
-
-  describe('inWindow', () => {
-    it('checks date windows correctly', () => {
-      expect(inWindow('2024-01-15', '2024-01-01', '2024-01-31')).toBe(true);
-      expect(inWindow('2023-12-31', '2024-01-01', '2024-01-31')).toBe(false);
-      expect(inWindow('2024-02-01', '2024-01-01', '2024-01-31')).toBe(false);
-    });
-
-    it('handles optional bounds', () => {
-      expect(inWindow('2024-01-15', undefined, '2024-01-31')).toBe(true);
-      expect(inWindow('2024-01-15', '2024-01-01', undefined)).toBe(true);
-      expect(inWindow('2024-01-15', undefined, undefined)).toBe(true);
-    });
-  });
-
-  describe('currency format helpers', () => {
-    it('extracts decimal digits from currency format', () => {
-      const usdFormat: ynab.CurrencyFormat = {
-        iso_code: 'USD',
-        example_format: '$1,234.56',
-        decimal_digits: 2,
-        decimal_separator: '.',
-        symbol_first: true,
-        group_separator: ',',
-        currency_symbol: '$',
-        display_symbol: true,
-      };
-      expect(getDecimalDigits(usdFormat)).toBe(2);
-
-      const jpyFormat: ynab.CurrencyFormat = {
-        iso_code: 'JPY',
-        example_format: '¥1,234',
-        decimal_digits: 0,
-        decimal_separator: '.',
-        symbol_first: true,
-        group_separator: ',',
-        currency_symbol: '¥',
-        display_symbol: true,
-      };
-      expect(getDecimalDigits(jpyFormat)).toBe(0);
-    });
-
-    it('returns default decimal digits for null/undefined', () => {
-      expect(getDecimalDigits(null)).toBe(2);
-      expect(getDecimalDigits(undefined)).toBe(2);
-    });
-
-    it('extracts currency code from currency format', () => {
-      const eurFormat: ynab.CurrencyFormat = {
-        iso_code: 'EUR',
-        example_format: '€1.234,56',
-        decimal_digits: 2,
-        decimal_separator: ',',
-        symbol_first: false,
-        group_separator: '.',
-        currency_symbol: '€',
-        display_symbol: true,
-      };
-      expect(getCurrencyCode(eurFormat)).toBe('EUR');
-    });
-
-    it('returns default currency for null/undefined', () => {
-      expect(getCurrencyCode(null)).toBe('USD');
-      expect(getCurrencyCode(undefined)).toBe('USD');
-    });
-  });
-
-  describe('moneyValue helpers', () => {
-    it('derives direction correctly', () => {
-      expect(moneyDirection(0)).toBe('balanced');
-      expect(moneyDirection(1500)).toBe('credit');
-      expect(moneyDirection(-2500)).toBe('debit');
-    });
-
-    it('formats milliunits into currency strings with default 2 decimals', () => {
-      expect(formatMoney(1234)).toBe('$1.23');
-      expect(formatMoney(-9870)).toBe('-$9.87');
-    });
-
-    it('formats milliunits with custom currency format', () => {
-      expect(formatMoney(123000, 'JPY', 0)).toBe('¥123');
-      expect(formatMoney(1234, 'USD', 2)).toBe('$1.23');
-      expect(formatMoney(1234, 'EUR', 3)).toBe('€1.234'); // 3 decimal digits requested
-    });
-
-    it('creates money values from milliunits with default 2 decimals', () => {
-      const value = toMoneyValue(22220);
-      expect(value.value).toBe(22.22);
-      expect(value.value_display).toBe('$22.22');
-      expect(value.direction).toBe('credit');
-    });
-
-    it('creates currency-aware money values with decimal digits', () => {
-      const valueJPY = toMoneyValue(123000, 'JPY', 0);
-      expect(valueJPY.value).toBe(123);
-      expect(valueJPY.value_display).toBe('¥123');
-      expect(valueJPY.currency).toBe('JPY');
-      expect(valueJPY.direction).toBe('credit');
-
-      const valueUSD = toMoneyValue(1234, 'USD', 2);
-      expect(valueUSD.value).toBe(1.23);
-      expect(valueUSD.value_display).toBe('$1.23');
-    });
-
-    it('creates money values from decimal amounts', () => {
-      const value = toMoneyValueFromDecimal(-45.67);
-      expect(value.value_milliunits).toBe(-45670);
-      expect(value.value_display).toBe('-$45.67');
-      expect(value.direction).toBe('debit');
-    });
-  });
+	addMilli,
+	assertMilli,
+	formatMoney,
+	fromMilli,
+	getCurrencyCode,
+	getDecimalDigits,
+	inWindow,
+	moneyDirection,
+	toMilli,
+	toMoneyValue,
+	toMoneyValueFromDecimal,
+} from "../money.js";
+
+describe("money utilities", () => {
+	describe("toMilli", () => {
+		it("converts dollars to milliunits correctly", () => {
+			expect(toMilli(1.23)).toBe(1230);
+			expect(toMilli(-5.67)).toBe(-5670);
+			expect(toMilli("10.50")).toBe(10500);
+		});
+
+		it("throws for invalid amounts", () => {
+			expect(() => toMilli(Number.MAX_SAFE_INTEGER)).toThrow(
+				"Invalid/unsafe amount",
+			);
+			expect(() => toMilli("invalid")).toThrow("Invalid/unsafe amount");
+		});
+	});
+
+	describe("fromMilli", () => {
+		it("converts milliunits with 2 decimal digits (USD) by default", () => {
+			expect(fromMilli(1230)).toBe(1.23);
+			expect(fromMilli(-5670)).toBe(-5.67);
+			expect(fromMilli(0)).toBe(0);
+		});
+
+		it("converts milliunits with 0 decimal digits (JPY)", () => {
+			expect(fromMilli(123000, 0)).toBe(123);
+			expect(fromMilli(1000, 0)).toBe(1);
+		});
+
+		it("converts milliunits with 3 decimal digits (BHD)", () => {
+			expect(fromMilli(1234, 3)).toBe(1.234);
+			expect(fromMilli(500, 3)).toBe(0.5);
+		});
+
+		it("converts milliunits with explicit 2 decimal digits", () => {
+			expect(fromMilli(1230, 2)).toBe(1.23);
+		});
+	});
+
+	describe("assertMilli", () => {
+		it("passes for safe integers", () => {
+			expect(() => assertMilli(1000)).not.toThrow();
+			expect(() => assertMilli(-500)).not.toThrow();
+			expect(() => assertMilli(0)).not.toThrow();
+		});
+
+		it("throws for non-safe integers", () => {
+			expect(() => assertMilli(1.5)).toThrow(
+				"Expected safe integer milliunits",
+			);
+			expect(() => assertMilli(Number.MAX_SAFE_INTEGER + 1)).toThrow(
+				"Expected safe integer milliunits",
+			);
+		});
+	});
+
+	describe("addMilli", () => {
+		it("adds milliunits correctly", () => {
+			expect(addMilli(1000, 2000)).toBe(3000);
+			expect(addMilli(-500, 300)).toBe(-200);
+		});
+
+		it("throws on overflow", () => {
+			expect(() => addMilli(Number.MAX_SAFE_INTEGER, 1)).toThrow(
+				"Milliunit sum overflow",
+			);
+		});
+	});
+
+	describe("inWindow", () => {
+		it("checks date windows correctly", () => {
+			expect(inWindow("2024-01-15", "2024-01-01", "2024-01-31")).toBe(true);
+			expect(inWindow("2023-12-31", "2024-01-01", "2024-01-31")).toBe(false);
+			expect(inWindow("2024-02-01", "2024-01-01", "2024-01-31")).toBe(false);
+		});
+
+		it("handles optional bounds", () => {
+			expect(inWindow("2024-01-15", undefined, "2024-01-31")).toBe(true);
+			expect(inWindow("2024-01-15", "2024-01-01", undefined)).toBe(true);
+			expect(inWindow("2024-01-15", undefined, undefined)).toBe(true);
+		});
+	});
+
+	describe("currency format helpers", () => {
+		it("extracts decimal digits from currency format", () => {
+			const usdFormat: ynab.CurrencyFormat = {
+				iso_code: "USD",
+				example_format: "$1,234.56",
+				decimal_digits: 2,
+				decimal_separator: ".",
+				symbol_first: true,
+				group_separator: ",",
+				currency_symbol: "$",
+				display_symbol: true,
+			};
+			expect(getDecimalDigits(usdFormat)).toBe(2);
+
+			const jpyFormat: ynab.CurrencyFormat = {
+				iso_code: "JPY",
+				example_format: "¥1,234",
+				decimal_digits: 0,
+				decimal_separator: ".",
+				symbol_first: true,
+				group_separator: ",",
+				currency_symbol: "¥",
+				display_symbol: true,
+			};
+			expect(getDecimalDigits(jpyFormat)).toBe(0);
+		});
+
+		it("returns default decimal digits for null/undefined", () => {
+			expect(getDecimalDigits(null)).toBe(2);
+			expect(getDecimalDigits(undefined)).toBe(2);
+		});
+
+		it("extracts currency code from currency format", () => {
+			const eurFormat: ynab.CurrencyFormat = {
+				iso_code: "EUR",
+				example_format: "€1.234,56",
+				decimal_digits: 2,
+				decimal_separator: ",",
+				symbol_first: false,
+				group_separator: ".",
+				currency_symbol: "€",
+				display_symbol: true,
+			};
+			expect(getCurrencyCode(eurFormat)).toBe("EUR");
+		});
+
+		it("returns default currency for null/undefined", () => {
+			expect(getCurrencyCode(null)).toBe("USD");
+			expect(getCurrencyCode(undefined)).toBe("USD");
+		});
+	});
+
+	describe("moneyValue helpers", () => {
+		it("derives direction correctly", () => {
+			expect(moneyDirection(0)).toBe("balanced");
+			expect(moneyDirection(1500)).toBe("credit");
+			expect(moneyDirection(-2500)).toBe("debit");
+		});
+
+		it("formats milliunits into currency strings with default 2 decimals", () => {
+			expect(formatMoney(1234)).toBe("$1.23");
+			expect(formatMoney(-9870)).toBe("-$9.87");
+		});
+
+		it("formats milliunits with custom currency format", () => {
+			expect(formatMoney(123000, "JPY", 0)).toBe("¥123");
+			expect(formatMoney(1234, "USD", 2)).toBe("$1.23");
+			expect(formatMoney(1234, "EUR", 3)).toBe("€1.234"); // 3 decimal digits requested
+		});
+
+		it("creates money values from milliunits with default 2 decimals", () => {
+			const value = toMoneyValue(22220);
+			expect(value.value).toBe(22.22);
+			expect(value.value_display).toBe("$22.22");
+			expect(value.direction).toBe("credit");
+		});
+
+		it("creates currency-aware money values with decimal digits", () => {
+			const valueJPY = toMoneyValue(123000, "JPY", 0);
+			expect(valueJPY.value).toBe(123);
+			expect(valueJPY.value_display).toBe("¥123");
+			expect(valueJPY.currency).toBe("JPY");
+			expect(valueJPY.direction).toBe("credit");
+
+			const valueUSD = toMoneyValue(1234, "USD", 2);
+			expect(valueUSD.value).toBe(1.23);
+			expect(valueUSD.value_display).toBe("$1.23");
+		});
+
+		it("creates money values from decimal amounts", () => {
+			const value = toMoneyValueFromDecimal(-45.67);
+			expect(value.value_milliunits).toBe(-45670);
+			expect(value.value_display).toBe("-$45.67");
+			expect(value.direction).toBe("debit");
+		});
+	});
 });

package/src/utils/amountUtils.ts

@@ -8,7 +8,7 @@
  * @returns Amount in dollars as a number with 2 decimal places
  */
 export function milliunitsToAmount(milliunits: number): number {
-  return Math.round(milliunits) / 1000;
+	return Math.round(milliunits) / 1000;
 }
 
 /**
@@ -17,7 +17,7 @@ export function milliunitsToAmount(milliunits: number): number {
  * @returns Amount in milliunits
  */
 export function amountToMilliunits(amount: number): number {
-  return Math.round(amount * 1000);
+	return Math.round(amount * 1000);
 }
 
 /**
@@ -26,7 +26,7 @@ export function amountToMilliunits(amount: number): number {
  * @param currencySymbol - Currency symbol (default: '$')
  * @returns Formatted currency string
  */
-export function formatAmount(milliunits: number, currencySymbol = '$'): string {
-  const amount = milliunitsToAmount(milliunits);
-  return `${currencySymbol}${amount.toFixed(2)}`;
+export function formatAmount(milliunits: number, currencySymbol = "$"): string {
+	const amount = milliunitsToAmount(milliunits);
+	return `${currencySymbol}${amount.toFixed(2)}`;
 }

package/src/utils/baseError.ts

@@ -1,7 +1,7 @@
 export class BaseError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = this.constructor.name;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
+	constructor(message: string) {
+		super(message);
+		this.name = this.constructor.name;
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
 }

package/src/utils/dateUtils.ts

@@ -8,7 +8,7 @@
  * YNAB-specific business logic.
  */
 
-import { format, subMonths, isValid, parse } from 'date-fns';
+import { format, isValid, parse, subMonths } from "date-fns";
 
 /**
  * Formats a date as YYYY-MM-01 (YNAB month format)
@@ -16,7 +16,7 @@ import { format, subMonths, isValid, parse } from 'date-fns';
  * @returns Formatted date string in YYYY-MM-01 format
  */
 export function formatYNABMonth(date: Date): string {
-  return format(date, "yyyy-MM-'01'");
+	return format(date, "yyyy-MM-'01'");
 }
 
 /**
@@ -25,7 +25,7 @@ export function formatYNABMonth(date: Date): string {
  * @returns Formatted date string in YYYY-MM-DD format
  */
 export function formatISODate(date: Date): string {
-  return format(date, 'yyyy-MM-dd');
+	return format(date, "yyyy-MM-dd");
 }
 
 /**
@@ -33,7 +33,7 @@ export function formatISODate(date: Date): string {
  * @returns Current month formatted as YYYY-MM-01
  */
 export function getCurrentMonth(): string {
-  return formatYNABMonth(new Date());
+	return formatYNABMonth(new Date());
 }
 
 /**
@@ -41,7 +41,7 @@ export function getCurrentMonth(): string {
  * @returns Today's date formatted as YYYY-MM-DD
  */
 export function getToday(): string {
-  return formatISODate(new Date());
+	return formatISODate(new Date());
 }
 
 /**
@@ -50,13 +50,16 @@ export function getToday(): string {
  * @param startDate The starting date (defaults to current date)
  * @returns Array of month strings in YYYY-MM-01 format, ordered newest to oldest
  */
-export function getHistoricalMonths(monthCount: number, startDate?: Date): string[] {
-  const baseDate = startDate || new Date();
+export function getHistoricalMonths(
+	monthCount: number,
+	startDate?: Date,
+): string[] {
+	const baseDate = startDate || new Date();
 
-  return Array.from({ length: monthCount }, (_, i) => {
-    const date = subMonths(baseDate, i);
-    return formatYNABMonth(date);
-  });
+	return Array.from({ length: monthCount }, (_, i) => {
+		const date = subMonths(baseDate, i);
+		return formatYNABMonth(date);
+	});
 }
 
 /**
@@ -66,7 +69,7 @@ export function getHistoricalMonths(monthCount: number, startDate?: Date): strin
  * @returns New date with months subtracted
  */
 export function subtractMonths(date: Date, months: number): Date {
-  return subMonths(date, months);
+	return subMonths(date, months);
 }
 
 /**
@@ -75,11 +78,11 @@ export function subtractMonths(date: Date, months: number): Date {
  * @returns True if valid ISO date format
  */
 export function isValidISODate(dateString: string): boolean {
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
-    return false;
-  }
-  const parsed = parse(dateString, 'yyyy-MM-dd', new Date());
-  return isValid(parsed);
+	if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+		return false;
+	}
+	const parsed = parse(dateString, "yyyy-MM-dd", new Date());
+	return isValid(parsed);
 }
 
 /**
@@ -88,11 +91,11 @@ export function isValidISODate(dateString: string): boolean {
  * @returns True if valid YNAB month format
  */
 export function isValidYNABMonth(monthString: string): boolean {
-  if (!/^\d{4}-\d{2}-01$/.test(monthString)) {
-    return false;
-  }
-  const parsed = parse(monthString, "yyyy-MM-'01'", new Date());
-  return isValid(parsed);
+	if (!/^\d{4}-\d{2}-01$/.test(monthString)) {
+		return false;
+	}
+	const parsed = parse(monthString, "yyyy-MM-'01'", new Date());
+	return isValid(parsed);
 }
 
 /**
@@ -101,8 +104,8 @@ export function isValidYNABMonth(monthString: string): boolean {
  * @returns String in YYYY-MM-01 format
  */
 export function yearMonthToYNABMonth(yearMonth: string): string {
-  if (!/^\d{4}-\d{2}$/.test(yearMonth)) {
-    throw new Error('Invalid year-month format. Expected YYYY-MM');
-  }
-  return `${yearMonth}-01`;
+	if (!/^\d{4}-\d{2}$/.test(yearMonth)) {
+		throw new Error("Invalid year-month format. Expected YYYY-MM");
+	}
+	return `${yearMonth}-01`;
 }

package/src/utils/errors.ts

@@ -1,21 +1,21 @@
-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(
-    public status: number,
-    public statusText: string,
-    public ynabErrorId?: string,
-  ) {
-    super(
-      `YNAB API request failed: ${status} ${statusText}${
-        ynabErrorId ? ` (Error ID: ${ynabErrorId})` : ''
-      }`,
-    );
-  }
+	constructor(
+		public status: number,
+		public statusText: string,
+		public ynabErrorId?: string,
+	) {
+		super(
+			`YNAB API request failed: ${status} ${statusText}${
+				ynabErrorId ? ` (Error ID: ${ynabErrorId})` : ""
+			}`,
+		);
+	}
 }