@dizzlkheinz/ynab-mcpb 0.18.3 → 0.19.0

package/scripts/tmpTransaction.ts

@@ -1,48 +1,85 @@
-import { handleCreateTransaction } from '../src/tools/transactionTools.js';
-import { responseFormatter } from '../src/server/responseFormatter.js';
+import { handleCreateTransaction } from "../src/tools/transactionTools.js";
 
-const mockAPI: any = {
-  transactions: {
-    createTransaction: async (_budgetId: string, _payload: any) => ({
-      data: {
-        transaction: {
-          id: 'transaction-3',
-          date: '2024-01-17',
-          amount: -2500,
-          memo: 'Test transaction',
-          cleared: 'uncleared',
-          approved: true,
-          flag_color: null,
-          account_id: 'test-account',
-          payee_id: null,
-          category_id: 'category-1',
-          transfer_account_id: null,
-        },
-      },
-    }),
-  },
-  accounts: {
-    getAccountById: async (_budgetId: string, _accountId: string) => ({
-      data: {
-        account: {
-          id: 'test-account',
-          balance: 1000,
-          cleared_balance: 1000,
-          uncleared_balance: 0,
-        },
-      },
-    }),
-  },
+type MockTransaction = {
+	id: string;
+	date: string;
+	amount: number;
+	memo: string;
+	cleared: string;
+	approved: boolean;
+	flag_color: string | null;
+	account_id: string;
+	payee_id: string | null;
+	category_id: string | null;
+	transfer_account_id: string | null;
+};
+
+type MockAPI = {
+	transactions: {
+		createTransaction: (
+			budgetId: string,
+			payload: unknown,
+		) => Promise<{ data: { transaction: MockTransaction } }>;
+	};
+	accounts: {
+		getAccountById: (
+			budgetId: string,
+			accountId: string,
+		) => Promise<{
+			data: {
+				account: {
+					id: string;
+					balance: number;
+					cleared_balance: number;
+					uncleared_balance: number;
+				};
+			};
+		}>;
+	};
+};
+
+const mockAPI: MockAPI = {
+	transactions: {
+		createTransaction: async (_budgetId: string, _payload: unknown) => ({
+			data: {
+				transaction: {
+					id: "transaction-3",
+					date: "2024-01-17",
+					amount: -2500,
+					memo: "Test transaction",
+					cleared: "uncleared",
+					approved: true,
+					flag_color: null,
+					account_id: "test-account",
+					payee_id: null,
+					category_id: "category-1",
+					transfer_account_id: null,
+				},
+			},
+		}),
+	},
+	accounts: {
+		getAccountById: async (_budgetId: string, _accountId: string) => ({
+			data: {
+				account: {
+					id: "test-account",
+					balance: 1000,
+					cleared_balance: 1000,
+					uncleared_balance: 0,
+				},
+			},
+		}),
+	},
 };
 
 (async () => {
-  const result = await handleCreateTransaction(mockAPI, {
-    budget_id: 'test-budget',
-    account_id: 'test-account',
-    amount: -2500,
-    date: '2024-01-17',
-    memo: 'Test transaction',
-    cleared: 'uncleared',
-  });
-  console.log('result', result);
+	const result = await handleCreateTransaction(mockAPI, {
+		budget_id: "test-budget",
+		account_id: "test-account",
+		amount: -2500,
+		date: "2024-01-17",
+		memo: "Test transaction",
+		cleared: "uncleared",
+	});
+	console.log("result", result);
 })();

package/scripts/validate-env.js

@@ -5,118 +5,125 @@
  * Validates required environment variables for YNAB MCP Server
  */
 
-import { config } from 'dotenv';
-import { fileURLToPath } from 'url';
-import { dirname } from 'path';
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { config } from "dotenv";
 
 // Load environment variables from .env file
 config();
 
 // Allow CI builds to skip strict validation when packaging artifacts
-if (process.env['SKIP_ENV_VALIDATION'] === 'true') {
-  console.log('Skipping environment validation (SKIP_ENV_VALIDATION=true)');
-  process.exit(0);
+if (process.env.SKIP_ENV_VALIDATION === "true") {
+	console.log("Skipping environment validation (SKIP_ENV_VALIDATION=true)");
+	process.exit(0);
 }
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 const requiredEnvVars = [
-  {
-    name: 'YNAB_ACCESS_TOKEN',
-    description: 'YNAB Personal Access Token',
-    validation: (value) => {
-      if (!value) return 'YNAB_ACCESS_TOKEN is required';
-      if (typeof value !== 'string') return 'YNAB_ACCESS_TOKEN must be a string';
-      if (value.length < 10) return 'YNAB_ACCESS_TOKEN appears to be too short';
-      return null;
-    },
-  },
+	{
+		name: "YNAB_ACCESS_TOKEN",
+		description: "YNAB Personal Access Token",
+		validation: (value) => {
+			if (!value) return "YNAB_ACCESS_TOKEN is required";
+			if (typeof value !== "string")
+				return "YNAB_ACCESS_TOKEN must be a string";
+			if (value.length < 10) return "YNAB_ACCESS_TOKEN appears to be too short";
+			return null;
+		},
+	},
 ];
 
 const optionalEnvVars = [
-  {
-    name: 'NODE_ENV',
-    description: 'Node.js environment (development, production, test)',
-    default: 'development',
-    validation: (value) => {
-      const validEnvs = ['development', 'production', 'test'];
-      if (value && !validEnvs.includes(value)) {
-        return `NODE_ENV must be one of: ${validEnvs.join(', ')}`;
-      }
-      return null;
-    },
-  },
-  {
-    name: 'LOG_LEVEL',
-    description: 'Logging level (error, warn, info, debug)',
-    default: 'info',
-    validation: (value) => {
-      const validLevels = ['error', 'warn', 'info', 'debug'];
-      if (value && !validLevels.includes(value)) {
-        return `LOG_LEVEL must be one of: ${validLevels.join(', ')}`;
-      }
-      return null;
-    },
-  },
+	{
+		name: "NODE_ENV",
+		description: "Node.js environment (development, production, test)",
+		default: "development",
+		validation: (value) => {
+			const validEnvs = ["development", "production", "test"];
+			if (value && !validEnvs.includes(value)) {
+				return `NODE_ENV must be one of: ${validEnvs.join(", ")}`;
+			}
+			return null;
+		},
+	},
+	{
+		name: "LOG_LEVEL",
+		description: "Logging level (error, warn, info, debug)",
+		default: "info",
+		validation: (value) => {
+			const validLevels = ["error", "warn", "info", "debug"];
+			if (value && !validLevels.includes(value)) {
+				return `LOG_LEVEL must be one of: ${validLevels.join(", ")}`;
+			}
+			return null;
+		},
+	},
 ];
 
 function validateEnvironment() {
-  console.log('🔍 Validating environment variables...\n');
-
-  let hasErrors = false;
-  const warnings = [];
-
-  // Validate required environment variables
-  for (const envVar of requiredEnvVars) {
-    const value = process.env[envVar.name];
-    const error = envVar.validation(value);
-
-    if (error) {
-      console.error(`❌ ${envVar.name}: ${error}`);
-      console.error(`   Description: ${envVar.description}\n`);
-      hasErrors = true;
-    } else {
-      console.log(`✅ ${envVar.name}: Valid`);
-    }
-  }
-
-  // Validate optional environment variables
-  for (const envVar of optionalEnvVars) {
-    const value = process.env[envVar.name];
-
-    if (!value) {
-      warnings.push(`⚠️  ${envVar.name}: Not set (using default: ${envVar.default})`);
-      warnings.push(`   Description: ${envVar.description}`);
-    } else {
-      const error = envVar.validation(value);
-      if (error) {
-        console.error(`❌ ${envVar.name}: ${error}`);
-        console.error(`   Description: ${envVar.description}\n`);
-        hasErrors = true;
-      } else {
-        console.log(`✅ ${envVar.name}: ${value}`);
-      }
-    }
-  }
-
-  // Display warnings
-  if (warnings.length > 0) {
-    console.log('\nWarnings:');
-    warnings.forEach((warning) => console.log(warning));
-  }
-
-  if (hasErrors) {
-    console.error('\n❌ Environment validation failed. Please fix the errors above.');
-    process.exit(1);
-  } else {
-    console.log('\n✅ Environment validation passed!');
-  }
+	console.log("🔍 Validating environment variables...\n");
+
+	let hasErrors = false;
+	const warnings = [];
+
+	// Validate required environment variables
+	for (const envVar of requiredEnvVars) {
+		const value = process.env[envVar.name];
+		const error = envVar.validation(value);
+
+		if (error) {
+			console.error(`❌ ${envVar.name}: ${error}`);
+			console.error(`   Description: ${envVar.description}\n`);
+			hasErrors = true;
+		} else {
+			console.log(`✅ ${envVar.name}: Valid`);
+		}
+	}
+
+	// Validate optional environment variables
+	for (const envVar of optionalEnvVars) {
+		const value = process.env[envVar.name];
+
+		if (!value) {
+			warnings.push(
+				`⚠️  ${envVar.name}: Not set (using default: ${envVar.default})`,
+			);
+			warnings.push(`   Description: ${envVar.description}`);
+		} else {
+			const error = envVar.validation(value);
+			if (error) {
+				console.error(`❌ ${envVar.name}: ${error}`);
+				console.error(`   Description: ${envVar.description}\n`);
+				hasErrors = true;
+			} else {
+				console.log(`✅ ${envVar.name}: ${value}`);
+			}
+		}
+	}
+
+	// Display warnings
+	if (warnings.length > 0) {
+		console.log("\nWarnings:");
+		for (const warning of warnings) {
+			console.log(warning);
+		}
+	}
+
+	if (hasErrors) {
+		console.error(
+			"\n❌ Environment validation failed. Please fix the errors above.",
+		);
+		process.exit(1);
+	} else {
+		console.log("\n✅ Environment validation passed!");
+	}
 }
 
 // Run validation if this script is executed directly
 if (process.argv[1] === __filename) {
-  validateEnvironment();
+	validateEnvironment();
 }
 
 export { validateEnvironment };

package/scripts/verify-build.js

@@ -5,101 +5,103 @@
  * Verifies that the build output is correct and complete
  */
 
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { dirname } from 'path';
+import fs from "node:fs";
+import path from "node:path";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-const DIST_DIR = path.join(__dirname, '..', 'dist');
+const DIST_DIR = path.join(__dirname, "..", "dist");
 const REQUIRED_FILES = [
-  'index.js',
-  'index.d.ts',
-  'server/YNABMCPServer.js',
-  'server/YNABMCPServer.d.ts',
-  'tools/budgetTools.js',
-  'tools/budgetTools.d.ts',
-  'tools/accountTools.js',
-  'tools/accountTools.d.ts',
-  'tools/transactionTools.js',
-  'tools/transactionTools.d.ts',
-  'tools/categoryTools.js',
-  'tools/categoryTools.d.ts',
-  'tools/payeeTools.js',
-  'tools/payeeTools.d.ts',
-  'tools/monthTools.js',
-  'tools/monthTools.d.ts',
-  'tools/utilityTools.js',
-  'tools/utilityTools.d.ts',
-  'types/index.js',
-  'types/index.d.ts',
+	"index.js",
+	"index.d.ts",
+	"server/YNABMCPServer.js",
+	"server/YNABMCPServer.d.ts",
+	"tools/budgetTools.js",
+	"tools/budgetTools.d.ts",
+	"tools/accountTools.js",
+	"tools/accountTools.d.ts",
+	"tools/transactionTools.js",
+	"tools/transactionTools.d.ts",
+	"tools/categoryTools.js",
+	"tools/categoryTools.d.ts",
+	"tools/payeeTools.js",
+	"tools/payeeTools.d.ts",
+	"tools/monthTools.js",
+	"tools/monthTools.d.ts",
+	"tools/utilityTools.js",
+	"tools/utilityTools.d.ts",
+	"types/index.js",
+	"types/index.d.ts",
 ];
 
 function verifyBuild() {
-  console.log('🔍 Verifying build output...\n');
+	console.log("🔍 Verifying build output...\n");
 
-  // Check if dist directory exists
-  if (!fs.existsSync(DIST_DIR)) {
-    console.error('❌ Build directory does not exist:', DIST_DIR);
-    process.exit(1);
-  }
+	// Check if dist directory exists
+	if (!fs.existsSync(DIST_DIR)) {
+		console.error("❌ Build directory does not exist:", DIST_DIR);
+		process.exit(1);
+	}
 
-  let missingFiles = [];
-  let foundFiles = [];
+	const missingFiles = [];
+	const foundFiles = [];
 
-  // Check for required files
-  for (const file of REQUIRED_FILES) {
-    const filePath = path.join(DIST_DIR, file);
-    if (fs.existsSync(filePath)) {
-      foundFiles.push(file);
-      console.log(`✅ ${file}`);
-    } else {
-      missingFiles.push(file);
-      console.error(`❌ Missing: ${file}`);
-    }
-  }
+	// Check for required files
+	for (const file of REQUIRED_FILES) {
+		const filePath = path.join(DIST_DIR, file);
+		if (fs.existsSync(filePath)) {
+			foundFiles.push(file);
+			console.log(`✅ ${file}`);
+		} else {
+			missingFiles.push(file);
+			console.error(`❌ Missing: ${file}`);
+		}
+	}
 
-  // Check main entry point
-  const mainEntry = path.join(DIST_DIR, 'index.js');
-  if (fs.existsSync(mainEntry)) {
-    const content = fs.readFileSync(mainEntry, 'utf8');
-    if (content.includes('YNABMCPServer')) {
-      console.log('✅ Main entry point contains expected exports');
-    } else {
-      console.error('❌ Main entry point missing expected exports');
-      missingFiles.push('index.js (invalid content)');
-    }
-  }
+	// Check main entry point
+	const mainEntry = path.join(DIST_DIR, "index.js");
+	if (fs.existsSync(mainEntry)) {
+		const content = fs.readFileSync(mainEntry, "utf8");
+		if (content.includes("YNABMCPServer")) {
+			console.log("✅ Main entry point contains expected exports");
+		} else {
+			console.error("❌ Main entry point missing expected exports");
+			missingFiles.push("index.js (invalid content)");
+		}
+	}
 
-  // Check TypeScript declarations
-  const hasDeclarations = foundFiles.some((file) => file.endsWith('.d.ts'));
-  if (hasDeclarations) {
-    console.log('✅ TypeScript declarations generated');
-  } else {
-    console.error('❌ No TypeScript declarations found');
-  }
+	// Check TypeScript declarations
+	const hasDeclarations = foundFiles.some((file) => file.endsWith(".d.ts"));
+	if (hasDeclarations) {
+		console.log("✅ TypeScript declarations generated");
+	} else {
+		console.error("❌ No TypeScript declarations found");
+	}
 
-  // Summary
-  console.log(`\n📊 Build Verification Summary:`);
-  console.log(`   Found files: ${foundFiles.length}`);
-  console.log(`   Missing files: ${missingFiles.length}`);
+	// Summary
+	console.log("\n📊 Build Verification Summary:");
+	console.log(`   Found files: ${foundFiles.length}`);
+	console.log(`   Missing files: ${missingFiles.length}`);
 
-  if (missingFiles.length > 0) {
-    console.error('\n❌ Build verification failed!');
-    console.error('Missing files:');
-    missingFiles.forEach((file) => console.error(`   - ${file}`));
-    process.exit(1);
-  } else {
-    console.log('\n✅ Build verification passed!');
-    console.log('All required files are present and valid.');
-  }
+	if (missingFiles.length > 0) {
+		console.error("\n❌ Build verification failed!");
+		console.error("Missing files:");
+		for (const file of missingFiles) {
+			console.error(`   - ${file}`);
+		}
+		process.exit(1);
+	} else {
+		console.log("\n✅ Build verification passed!");
+		console.log("All required files are present and valid.");
+	}
 }
 
 // Run verification if this script is executed directly
 if (process.argv[1] === __filename) {
-  verifyBuild();
+	verifyBuild();
 }
 
 export { verifyBuild };