@dizzlkheinz/ynab-mcpb 0.18.3 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (346) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/CLAUDE.md +87 -8
  3. package/bin/ynab-mcp-server.cjs +2 -2
  4. package/bin/ynab-mcp-server.js +3 -3
  5. package/biome.json +39 -0
  6. package/dist/bundle/index.cjs +67 -67
  7. package/dist/index.d.ts +1 -1
  8. package/dist/index.js +27 -27
  9. package/dist/server/YNABMCPServer.d.ts +3 -4
  10. package/dist/server/YNABMCPServer.js +111 -116
  11. package/dist/server/budgetResolver.d.ts +6 -5
  12. package/dist/server/budgetResolver.js +46 -36
  13. package/dist/server/cacheKeys.js +6 -6
  14. package/dist/server/cacheManager.js +14 -11
  15. package/dist/server/completions.d.ts +2 -2
  16. package/dist/server/completions.js +20 -15
  17. package/dist/server/config.d.ts +10 -5
  18. package/dist/server/config.js +24 -7
  19. package/dist/server/deltaCache.d.ts +2 -2
  20. package/dist/server/deltaCache.js +22 -16
  21. package/dist/server/deltaCache.merge.d.ts +2 -2
  22. package/dist/server/diagnostics.d.ts +4 -4
  23. package/dist/server/diagnostics.js +38 -32
  24. package/dist/server/errorHandler.d.ts +5 -12
  25. package/dist/server/errorHandler.js +219 -217
  26. package/dist/server/prompts.d.ts +2 -2
  27. package/dist/server/prompts.js +45 -45
  28. package/dist/server/rateLimiter.js +4 -4
  29. package/dist/server/requestLogger.d.ts +1 -1
  30. package/dist/server/requestLogger.js +40 -35
  31. package/dist/server/resources.d.ts +3 -3
  32. package/dist/server/resources.js +55 -52
  33. package/dist/server/responseFormatter.js +6 -6
  34. package/dist/server/securityMiddleware.d.ts +2 -2
  35. package/dist/server/securityMiddleware.js +22 -20
  36. package/dist/server/serverKnowledgeStore.js +1 -1
  37. package/dist/server/toolRegistry.d.ts +3 -3
  38. package/dist/server/toolRegistry.js +47 -40
  39. package/dist/tools/__tests__/deltaTestUtils.d.ts +3 -3
  40. package/dist/tools/__tests__/deltaTestUtils.js +2 -2
  41. package/dist/tools/accountTools.d.ts +9 -8
  42. package/dist/tools/accountTools.js +47 -47
  43. package/dist/tools/adapters.d.ts +13 -8
  44. package/dist/tools/adapters.js +21 -11
  45. package/dist/tools/budgetTools.d.ts +8 -7
  46. package/dist/tools/budgetTools.js +22 -22
  47. package/dist/tools/categoryTools.d.ts +9 -8
  48. package/dist/tools/categoryTools.js +68 -59
  49. package/dist/tools/compareTransactions/formatter.d.ts +3 -3
  50. package/dist/tools/compareTransactions/formatter.js +9 -9
  51. package/dist/tools/compareTransactions/index.d.ts +6 -6
  52. package/dist/tools/compareTransactions/index.js +58 -43
  53. package/dist/tools/compareTransactions/matcher.d.ts +1 -1
  54. package/dist/tools/compareTransactions/matcher.js +28 -15
  55. package/dist/tools/compareTransactions/parser.d.ts +2 -2
  56. package/dist/tools/compareTransactions/parser.js +144 -138
  57. package/dist/tools/compareTransactions/types.d.ts +4 -4
  58. package/dist/tools/compareTransactions.d.ts +1 -1
  59. package/dist/tools/compareTransactions.js +1 -1
  60. package/dist/tools/deltaFetcher.d.ts +2 -2
  61. package/dist/tools/deltaFetcher.js +16 -15
  62. package/dist/tools/deltaSupport.d.ts +4 -4
  63. package/dist/tools/deltaSupport.js +35 -41
  64. package/dist/tools/exportTransactions.d.ts +5 -4
  65. package/dist/tools/exportTransactions.js +61 -59
  66. package/dist/tools/monthTools.d.ts +7 -6
  67. package/dist/tools/monthTools.js +31 -29
  68. package/dist/tools/payeeTools.d.ts +7 -6
  69. package/dist/tools/payeeTools.js +28 -28
  70. package/dist/tools/reconcileAdapter.d.ts +2 -2
  71. package/dist/tools/reconcileAdapter.js +21 -11
  72. package/dist/tools/reconciliation/analyzer.d.ts +4 -4
  73. package/dist/tools/reconciliation/analyzer.js +136 -57
  74. package/dist/tools/reconciliation/csvParser.d.ts +3 -3
  75. package/dist/tools/reconciliation/csvParser.js +128 -104
  76. package/dist/tools/reconciliation/executor.d.ts +4 -4
  77. package/dist/tools/reconciliation/executor.js +148 -109
  78. package/dist/tools/reconciliation/index.d.ts +10 -10
  79. package/dist/tools/reconciliation/index.js +96 -83
  80. package/dist/tools/reconciliation/matcher.d.ts +3 -3
  81. package/dist/tools/reconciliation/matcher.js +17 -16
  82. package/dist/tools/reconciliation/payeeNormalizer.js +19 -8
  83. package/dist/tools/reconciliation/recommendationEngine.d.ts +1 -1
  84. package/dist/tools/reconciliation/recommendationEngine.js +40 -40
  85. package/dist/tools/reconciliation/reportFormatter.d.ts +2 -2
  86. package/dist/tools/reconciliation/reportFormatter.js +79 -54
  87. package/dist/tools/reconciliation/signDetector.d.ts +1 -1
  88. package/dist/tools/reconciliation/types.d.ts +19 -16
  89. package/dist/tools/reconciliation/ynabAdapter.d.ts +2 -2
  90. package/dist/tools/schemas/common.d.ts +1 -1
  91. package/dist/tools/schemas/common.js +1 -1
  92. package/dist/tools/schemas/outputs/accountOutputs.d.ts +1 -1
  93. package/dist/tools/schemas/outputs/accountOutputs.js +24 -18
  94. package/dist/tools/schemas/outputs/budgetOutputs.d.ts +1 -1
  95. package/dist/tools/schemas/outputs/budgetOutputs.js +14 -11
  96. package/dist/tools/schemas/outputs/categoryOutputs.d.ts +1 -1
  97. package/dist/tools/schemas/outputs/categoryOutputs.js +49 -29
  98. package/dist/tools/schemas/outputs/comparisonOutputs.d.ts +1 -1
  99. package/dist/tools/schemas/outputs/comparisonOutputs.js +12 -12
  100. package/dist/tools/schemas/outputs/index.d.ts +14 -14
  101. package/dist/tools/schemas/outputs/index.js +14 -14
  102. package/dist/tools/schemas/outputs/monthOutputs.d.ts +1 -1
  103. package/dist/tools/schemas/outputs/monthOutputs.js +56 -41
  104. package/dist/tools/schemas/outputs/payeeOutputs.d.ts +1 -1
  105. package/dist/tools/schemas/outputs/payeeOutputs.js +10 -10
  106. package/dist/tools/schemas/outputs/reconciliationOutputs.d.ts +2 -2
  107. package/dist/tools/schemas/outputs/reconciliationOutputs.js +45 -45
  108. package/dist/tools/schemas/outputs/transactionMutationOutputs.d.ts +1 -1
  109. package/dist/tools/schemas/outputs/transactionMutationOutputs.js +28 -22
  110. package/dist/tools/schemas/outputs/transactionOutputs.d.ts +1 -1
  111. package/dist/tools/schemas/outputs/transactionOutputs.js +43 -35
  112. package/dist/tools/schemas/outputs/utilityOutputs.d.ts +1 -1
  113. package/dist/tools/schemas/outputs/utilityOutputs.js +5 -3
  114. package/dist/tools/schemas/shared/commonOutputs.d.ts +1 -1
  115. package/dist/tools/schemas/shared/commonOutputs.js +15 -9
  116. package/dist/tools/transactionReadTools.d.ts +11 -0
  117. package/dist/tools/transactionReadTools.js +202 -0
  118. package/dist/tools/transactionSchemas.d.ts +309 -0
  119. package/dist/tools/transactionSchemas.js +235 -0
  120. package/dist/tools/transactionTools.d.ts +6 -302
  121. package/dist/tools/transactionTools.js +7 -2054
  122. package/dist/tools/transactionUtils.d.ts +31 -0
  123. package/dist/tools/transactionUtils.js +364 -0
  124. package/dist/tools/transactionWriteTools.d.ts +20 -0
  125. package/dist/tools/transactionWriteTools.js +1342 -0
  126. package/dist/tools/utilityTools.d.ts +5 -4
  127. package/dist/tools/utilityTools.js +11 -11
  128. package/dist/types/index.d.ts +7 -7
  129. package/dist/types/index.js +6 -6
  130. package/dist/types/reconciliation.d.ts +1 -1
  131. package/dist/types/toolRegistration.d.ts +14 -12
  132. package/dist/utils/amountUtils.js +1 -1
  133. package/dist/utils/dateUtils.js +4 -4
  134. package/dist/utils/errors.d.ts +3 -3
  135. package/dist/utils/errors.js +4 -4
  136. package/dist/utils/money.d.ts +2 -2
  137. package/dist/utils/money.js +8 -8
  138. package/dist/utils/validationError.d.ts +1 -1
  139. package/dist/utils/validationError.js +1 -1
  140. package/docs/assets/examples/reconciliation-with-recommendations.json +66 -66
  141. package/docs/assets/schemas/reconciliation-v2.json +360 -336
  142. package/docs/plans/2025-12-25-transaction-tools-refactor-design.md +211 -0
  143. package/docs/plans/2025-12-25-transaction-tools-refactor.md +905 -0
  144. package/esbuild.config.mjs +53 -50
  145. package/meta.json +12548 -12548
  146. package/package.json +98 -109
  147. package/scripts/analyze-bundle.mjs +33 -30
  148. package/scripts/create-pr-description.js +169 -120
  149. package/scripts/run-all-tests.js +205 -0
  150. package/scripts/run-domain-integration-tests.js +28 -18
  151. package/scripts/run-generate-mcpb.js +19 -17
  152. package/scripts/run-throttled-integration-tests.js +92 -83
  153. package/scripts/test-delta-params.mjs +149 -120
  154. package/scripts/test-recommendations.ts +36 -32
  155. package/scripts/tmpTransaction.ts +80 -43
  156. package/scripts/validate-env.js +98 -91
  157. package/scripts/verify-build.js +78 -76
  158. package/src/__tests__/comprehensive.integration.test.ts +1281 -1154
  159. package/src/__tests__/performance.test.ts +723 -671
  160. package/src/__tests__/setup.ts +442 -395
  161. package/src/__tests__/smoke.e2e.test.ts +41 -39
  162. package/src/__tests__/testRunner.ts +314 -295
  163. package/src/__tests__/testUtils.ts +456 -364
  164. package/src/__tests__/tools/reconciliation/csvParser.integration.test.ts +109 -107
  165. package/src/__tests__/tools/reconciliation/real-world.integration.test.ts +41 -41
  166. package/src/index.ts +68 -59
  167. package/src/server/CLAUDE.md +480 -0
  168. package/src/server/YNABMCPServer.ts +821 -794
  169. package/src/server/__tests__/YNABMCPServer.integration.test.ts +929 -893
  170. package/src/server/__tests__/YNABMCPServer.test.ts +903 -899
  171. package/src/server/__tests__/budgetResolver.test.ts +466 -423
  172. package/src/server/__tests__/cacheManager.test.ts +891 -874
  173. package/src/server/__tests__/completions.integration.test.ts +115 -106
  174. package/src/server/__tests__/completions.test.ts +334 -313
  175. package/src/server/__tests__/config.test.ts +98 -86
  176. package/src/server/__tests__/deltaCache.merge.test.ts +774 -703
  177. package/src/server/__tests__/deltaCache.swr.test.ts +198 -153
  178. package/src/server/__tests__/deltaCache.test.ts +946 -759
  179. package/src/server/__tests__/diagnostics.test.ts +825 -792
  180. package/src/server/__tests__/errorHandler.integration.test.ts +512 -462
  181. package/src/server/__tests__/errorHandler.test.ts +402 -397
  182. package/src/server/__tests__/prompts.test.ts +424 -347
  183. package/src/server/__tests__/rateLimiter.test.ts +313 -309
  184. package/src/server/__tests__/requestLogger.test.ts +443 -403
  185. package/src/server/__tests__/resources.template.test.ts +196 -185
  186. package/src/server/__tests__/resources.test.ts +294 -288
  187. package/src/server/__tests__/security.integration.test.ts +487 -421
  188. package/src/server/__tests__/securityMiddleware.test.ts +519 -444
  189. package/src/server/__tests__/server-startup.integration.test.ts +509 -490
  190. package/src/server/__tests__/serverKnowledgeStore.test.ts +174 -173
  191. package/src/server/__tests__/toolRegistration.test.ts +239 -210
  192. package/src/server/__tests__/toolRegistry.test.ts +907 -845
  193. package/src/server/budgetResolver.ts +221 -181
  194. package/src/server/cacheKeys.ts +6 -6
  195. package/src/server/cacheManager.ts +498 -484
  196. package/src/server/completions.ts +267 -243
  197. package/src/server/config.ts +35 -14
  198. package/src/server/deltaCache.merge.ts +146 -128
  199. package/src/server/deltaCache.ts +352 -309
  200. package/src/server/diagnostics.ts +257 -242
  201. package/src/server/errorHandler.ts +747 -744
  202. package/src/server/prompts.ts +181 -176
  203. package/src/server/rateLimiter.ts +131 -129
  204. package/src/server/requestLogger.ts +350 -322
  205. package/src/server/resources.ts +442 -374
  206. package/src/server/responseFormatter.ts +41 -37
  207. package/src/server/securityMiddleware.ts +223 -205
  208. package/src/server/serverKnowledgeStore.ts +67 -67
  209. package/src/server/toolRegistry.ts +508 -474
  210. package/src/tools/CLAUDE.md +604 -0
  211. package/src/tools/__tests__/accountTools.delta.integration.test.ts +128 -111
  212. package/src/tools/__tests__/accountTools.integration.test.ts +129 -111
  213. package/src/tools/__tests__/accountTools.test.ts +685 -638
  214. package/src/tools/__tests__/adapters.test.ts +142 -108
  215. package/src/tools/__tests__/budgetTools.delta.integration.test.ts +73 -73
  216. package/src/tools/__tests__/budgetTools.integration.test.ts +132 -124
  217. package/src/tools/__tests__/budgetTools.test.ts +442 -413
  218. package/src/tools/__tests__/categoryTools.delta.integration.test.ts +76 -68
  219. package/src/tools/__tests__/categoryTools.integration.test.ts +314 -288
  220. package/src/tools/__tests__/categoryTools.test.ts +656 -625
  221. package/src/tools/__tests__/compareTransactions/formatter.test.ts +535 -462
  222. package/src/tools/__tests__/compareTransactions/index.test.ts +378 -358
  223. package/src/tools/__tests__/compareTransactions/matcher.test.ts +497 -398
  224. package/src/tools/__tests__/compareTransactions/parser.test.ts +765 -747
  225. package/src/tools/__tests__/compareTransactions.test.ts +352 -332
  226. package/src/tools/__tests__/compareTransactions.window.test.ts +150 -146
  227. package/src/tools/__tests__/deltaFetcher.scheduled.integration.test.ts +69 -65
  228. package/src/tools/__tests__/deltaFetcher.test.ts +325 -265
  229. package/src/tools/__tests__/deltaSupport.test.ts +211 -184
  230. package/src/tools/__tests__/deltaTestUtils.ts +37 -33
  231. package/src/tools/__tests__/exportTransactions.test.ts +205 -200
  232. package/src/tools/__tests__/monthTools.delta.integration.test.ts +68 -68
  233. package/src/tools/__tests__/monthTools.integration.test.ts +178 -166
  234. package/src/tools/__tests__/monthTools.test.ts +561 -512
  235. package/src/tools/__tests__/payeeTools.delta.integration.test.ts +68 -68
  236. package/src/tools/__tests__/payeeTools.integration.test.ts +158 -142
  237. package/src/tools/__tests__/payeeTools.test.ts +486 -434
  238. package/src/tools/__tests__/transactionSchemas.test.ts +1204 -0
  239. package/src/tools/__tests__/transactionTools.integration.test.ts +875 -825
  240. package/src/tools/__tests__/transactionTools.test.ts +4923 -4366
  241. package/src/tools/__tests__/transactionUtils.test.ts +1016 -0
  242. package/src/tools/__tests__/utilityTools.integration.test.ts +32 -32
  243. package/src/tools/__tests__/utilityTools.test.ts +68 -58
  244. package/src/tools/accountTools.ts +293 -271
  245. package/src/tools/adapters.ts +120 -63
  246. package/src/tools/budgetTools.ts +121 -116
  247. package/src/tools/categoryTools.ts +379 -339
  248. package/src/tools/compareTransactions/formatter.ts +131 -119
  249. package/src/tools/compareTransactions/index.ts +249 -214
  250. package/src/tools/compareTransactions/matcher.ts +259 -209
  251. package/src/tools/compareTransactions/parser.ts +517 -487
  252. package/src/tools/compareTransactions/types.ts +38 -38
  253. package/src/tools/compareTransactions.ts +1 -1
  254. package/src/tools/deltaFetcher.ts +281 -260
  255. package/src/tools/deltaSupport.ts +264 -259
  256. package/src/tools/exportTransactions.ts +230 -218
  257. package/src/tools/monthTools.ts +180 -165
  258. package/src/tools/payeeTools.ts +152 -140
  259. package/src/tools/reconcileAdapter.ts +297 -246
  260. package/src/tools/reconciliation/CLAUDE.md +506 -0
  261. package/src/tools/reconciliation/__tests__/adapter.causes.test.ts +135 -112
  262. package/src/tools/reconciliation/__tests__/adapter.test.ts +249 -227
  263. package/src/tools/reconciliation/__tests__/analyzer.test.ts +408 -335
  264. package/src/tools/reconciliation/__tests__/csvParser.test.ts +71 -69
  265. package/src/tools/reconciliation/__tests__/executor.integration.test.ts +348 -323
  266. package/src/tools/reconciliation/__tests__/executor.progress.test.ts +503 -457
  267. package/src/tools/reconciliation/__tests__/executor.test.ts +898 -831
  268. package/src/tools/reconciliation/__tests__/matcher.test.ts +667 -663
  269. package/src/tools/reconciliation/__tests__/payeeNormalizer.test.ts +296 -276
  270. package/src/tools/reconciliation/__tests__/recommendationEngine.integration.test.ts +692 -624
  271. package/src/tools/reconciliation/__tests__/recommendationEngine.test.ts +1008 -986
  272. package/src/tools/reconciliation/__tests__/reconciliation.delta.integration.test.ts +187 -146
  273. package/src/tools/reconciliation/__tests__/reportFormatter.test.ts +583 -530
  274. package/src/tools/reconciliation/__tests__/scenarios/adapterCurrency.scenario.test.ts +75 -71
  275. package/src/tools/reconciliation/__tests__/scenarios/extremes.scenario.test.ts +70 -58
  276. package/src/tools/reconciliation/__tests__/scenarios/repeatAmount.scenario.test.ts +102 -88
  277. package/src/tools/reconciliation/__tests__/schemaUrl.test.ts +58 -43
  278. package/src/tools/reconciliation/__tests__/signDetector.test.ts +209 -206
  279. package/src/tools/reconciliation/__tests__/ynabAdapter.test.ts +66 -60
  280. package/src/tools/reconciliation/analyzer.ts +582 -406
  281. package/src/tools/reconciliation/csvParser.ts +656 -609
  282. package/src/tools/reconciliation/executor.ts +1290 -1128
  283. package/src/tools/reconciliation/index.ts +580 -528
  284. package/src/tools/reconciliation/matcher.ts +256 -240
  285. package/src/tools/reconciliation/payeeNormalizer.ts +92 -78
  286. package/src/tools/reconciliation/recommendationEngine.ts +357 -345
  287. package/src/tools/reconciliation/reportFormatter.ts +349 -276
  288. package/src/tools/reconciliation/signDetector.ts +89 -83
  289. package/src/tools/reconciliation/types.ts +164 -153
  290. package/src/tools/reconciliation/ynabAdapter.ts +17 -15
  291. package/src/tools/schemas/CLAUDE.md +546 -0
  292. package/src/tools/schemas/common.ts +1 -1
  293. package/src/tools/schemas/outputs/__tests__/accountOutputs.test.ts +410 -409
  294. package/src/tools/schemas/outputs/__tests__/budgetOutputs.test.ts +305 -299
  295. package/src/tools/schemas/outputs/__tests__/categoryOutputs.test.ts +431 -430
  296. package/src/tools/schemas/outputs/__tests__/comparisonOutputs.test.ts +510 -495
  297. package/src/tools/schemas/outputs/__tests__/dateValidation.test.ts +179 -153
  298. package/src/tools/schemas/outputs/__tests__/discrepancyDirection.test.ts +293 -254
  299. package/src/tools/schemas/outputs/__tests__/monthOutputs.test.ts +457 -457
  300. package/src/tools/schemas/outputs/__tests__/payeeOutputs.test.ts +362 -356
  301. package/src/tools/schemas/outputs/__tests__/reconciliationOutputs.test.ts +402 -399
  302. package/src/tools/schemas/outputs/__tests__/transactionMutationSchemas.test.ts +225 -211
  303. package/src/tools/schemas/outputs/__tests__/transactionOutputs.test.ts +457 -454
  304. package/src/tools/schemas/outputs/__tests__/utilityOutputs.test.ts +316 -315
  305. package/src/tools/schemas/outputs/accountOutputs.ts +40 -34
  306. package/src/tools/schemas/outputs/budgetOutputs.ts +24 -19
  307. package/src/tools/schemas/outputs/categoryOutputs.ts +76 -56
  308. package/src/tools/schemas/outputs/comparisonOutputs.ts +192 -169
  309. package/src/tools/schemas/outputs/index.ts +163 -163
  310. package/src/tools/schemas/outputs/monthOutputs.ts +95 -80
  311. package/src/tools/schemas/outputs/payeeOutputs.ts +18 -18
  312. package/src/tools/schemas/outputs/reconciliationOutputs.ts +386 -373
  313. package/src/tools/schemas/outputs/transactionMutationOutputs.ts +259 -231
  314. package/src/tools/schemas/outputs/transactionOutputs.ts +81 -71
  315. package/src/tools/schemas/outputs/utilityOutputs.ts +90 -84
  316. package/src/tools/schemas/shared/commonOutputs.ts +27 -19
  317. package/src/tools/toolCategories.ts +114 -114
  318. package/src/tools/transactionReadTools.ts +327 -0
  319. package/src/tools/transactionSchemas.ts +484 -0
  320. package/src/tools/transactionTools.ts +107 -2990
  321. package/src/tools/transactionUtils.ts +621 -0
  322. package/src/tools/transactionWriteTools.ts +2110 -0
  323. package/src/tools/utilityTools.ts +46 -41
  324. package/src/types/CLAUDE.md +477 -0
  325. package/src/types/__tests__/index.test.ts +51 -51
  326. package/src/types/index.ts +43 -39
  327. package/src/types/integration-tests.d.ts +26 -26
  328. package/src/types/reconciliation.ts +29 -29
  329. package/src/types/toolAnnotations.ts +30 -30
  330. package/src/types/toolRegistration.ts +43 -32
  331. package/src/utils/CLAUDE.md +508 -0
  332. package/src/utils/__tests__/dateUtils.test.ts +174 -168
  333. package/src/utils/__tests__/money.test.ts +193 -187
  334. package/src/utils/amountUtils.ts +5 -5
  335. package/src/utils/baseError.ts +5 -5
  336. package/src/utils/dateUtils.ts +29 -26
  337. package/src/utils/errors.ts +14 -14
  338. package/src/utils/money.ts +66 -52
  339. package/src/utils/validationError.ts +1 -1
  340. package/tsconfig.json +29 -29
  341. package/tsconfig.prod.json +16 -16
  342. package/vitest-reporters/split-json-reporter.ts +247 -204
  343. package/vitest.config.ts +99 -95
  344. package/.prettierignore +0 -10
  345. package/.prettierrc.json +0 -10
  346. package/eslint.config.js +0 -49
@@ -8,512 +8,527 @@
8
8
  * - DateRangeSchema
9
9
  */
10
10
 
11
- import { describe, it, expect } from 'vitest';
11
+ import { describe, expect, it } from "vitest";
12
12
  import {
13
- CompareTransactionsOutputSchema,
14
- ExportTransactionsOutputSchema,
15
- ISODateStringSchema,
16
- DateRangeSchema,
17
- MatchItemSchema,
18
- MissingInYNABItemSchema,
19
- MissingInBankItemSchema,
20
- } from '../comparisonOutputs.js';
21
-
22
- describe('ISODateStringSchema', () => {
23
- it('should validate correct ISO date format', () => {
24
- const validDates = ['2025-01-01', '2025-12-31', '2024-02-29']; // 2024 is leap year
25
-
26
- for (const date of validDates) {
27
- const result = ISODateStringSchema.safeParse(date);
28
- expect(result.success).toBe(true);
29
- }
30
- });
31
-
32
- it('should reject invalid date formats', () => {
33
- const invalidDates = ['2025/01/01', '01-01-2025', '2025-1-1', 'not-a-date'];
34
-
35
- for (const date of invalidDates) {
36
- const result = ISODateStringSchema.safeParse(date);
37
- expect(result.success).toBe(false);
38
- }
39
- });
40
-
41
- it('should reject invalid calendar dates', () => {
42
- const invalidDates = ['2025-02-30', '2025-13-01', '2025-02-31', '2025-00-01'];
43
-
44
- for (const date of invalidDates) {
45
- const result = ISODateStringSchema.safeParse(date);
46
- expect(result.success).toBe(false);
47
- }
48
- });
49
-
50
- it('should validate leap year dates correctly', () => {
51
- const result1 = ISODateStringSchema.safeParse('2024-02-29'); // Leap year
52
- expect(result1.success).toBe(true);
53
-
54
- const result2 = ISODateStringSchema.safeParse('2025-02-29'); // Not a leap year
55
- expect(result2.success).toBe(false);
56
- });
13
+ CompareTransactionsOutputSchema,
14
+ DateRangeSchema,
15
+ ExportTransactionsOutputSchema,
16
+ ISODateStringSchema,
17
+ MatchItemSchema,
18
+ MissingInBankItemSchema,
19
+ MissingInYNABItemSchema,
20
+ } from "../comparisonOutputs.js";
21
+
22
+ describe("ISODateStringSchema", () => {
23
+ it("should validate correct ISO date format", () => {
24
+ const validDates = ["2025-01-01", "2025-12-31", "2024-02-29"]; // 2024 is leap year
25
+
26
+ for (const date of validDates) {
27
+ const result = ISODateStringSchema.safeParse(date);
28
+ expect(result.success).toBe(true);
29
+ }
30
+ });
31
+
32
+ it("should reject invalid date formats", () => {
33
+ const invalidDates = ["2025/01/01", "01-01-2025", "2025-1-1", "not-a-date"];
34
+
35
+ for (const date of invalidDates) {
36
+ const result = ISODateStringSchema.safeParse(date);
37
+ expect(result.success).toBe(false);
38
+ }
39
+ });
40
+
41
+ it("should reject invalid calendar dates", () => {
42
+ const invalidDates = [
43
+ "2025-02-30",
44
+ "2025-13-01",
45
+ "2025-02-31",
46
+ "2025-00-01",
47
+ ];
48
+
49
+ for (const date of invalidDates) {
50
+ const result = ISODateStringSchema.safeParse(date);
51
+ expect(result.success).toBe(false);
52
+ }
53
+ });
54
+
55
+ it("should validate leap year dates correctly", () => {
56
+ const result1 = ISODateStringSchema.safeParse("2024-02-29"); // Leap year
57
+ expect(result1.success).toBe(true);
58
+
59
+ const result2 = ISODateStringSchema.safeParse("2025-02-29"); // Not a leap year
60
+ expect(result2.success).toBe(false);
61
+ });
57
62
  });
58
63
 
59
- describe('DateRangeSchema', () => {
60
- it('should validate valid date range', () => {
61
- const validRange = {
62
- start: '2025-01-01',
63
- end: '2025-12-31',
64
- };
65
-
66
- const result = DateRangeSchema.safeParse(validRange);
67
- expect(result.success).toBe(true);
68
- });
69
-
70
- it('should validate date range where start equals end', () => {
71
- const validRange = {
72
- start: '2025-10-15',
73
- end: '2025-10-15',
74
- };
75
-
76
- const result = DateRangeSchema.safeParse(validRange);
77
- expect(result.success).toBe(true);
78
- });
79
-
80
- it('should reject date range where start is after end', () => {
81
- const invalidRange = {
82
- start: '2025-12-31',
83
- end: '2025-01-01',
84
- };
85
-
86
- const result = DateRangeSchema.safeParse(invalidRange);
87
- expect(result.success).toBe(false);
88
- });
89
-
90
- it('should reject invalid date formats in range', () => {
91
- const invalidRange = {
92
- start: '2025/01/01', // Wrong format
93
- end: '2025-12-31',
94
- };
95
-
96
- const result = DateRangeSchema.safeParse(invalidRange);
97
- expect(result.success).toBe(false);
98
- });
64
+ describe("DateRangeSchema", () => {
65
+ it("should validate valid date range", () => {
66
+ const validRange = {
67
+ start: "2025-01-01",
68
+ end: "2025-12-31",
69
+ };
70
+
71
+ const result = DateRangeSchema.safeParse(validRange);
72
+ expect(result.success).toBe(true);
73
+ });
74
+
75
+ it("should validate date range where start equals end", () => {
76
+ const validRange = {
77
+ start: "2025-10-15",
78
+ end: "2025-10-15",
79
+ };
80
+
81
+ const result = DateRangeSchema.safeParse(validRange);
82
+ expect(result.success).toBe(true);
83
+ });
84
+
85
+ it("should reject date range where start is after end", () => {
86
+ const invalidRange = {
87
+ start: "2025-12-31",
88
+ end: "2025-01-01",
89
+ };
90
+
91
+ const result = DateRangeSchema.safeParse(invalidRange);
92
+ expect(result.success).toBe(false);
93
+ });
94
+
95
+ it("should reject invalid date formats in range", () => {
96
+ const invalidRange = {
97
+ start: "2025/01/01", // Wrong format
98
+ end: "2025-12-31",
99
+ };
100
+
101
+ const result = DateRangeSchema.safeParse(invalidRange);
102
+ expect(result.success).toBe(false);
103
+ });
99
104
  });
100
105
 
101
- describe('MatchItemSchema', () => {
102
- it('should validate complete match item', () => {
103
- const validMatch = {
104
- bank_date: '2025-10-15',
105
- bank_amount: '25.50',
106
- bank_description: 'Grocery Store',
107
- ynab_date: '2025-10-15',
108
- ynab_amount: '25.50',
109
- ynab_payee: 'Grocery Store',
110
- ynab_transaction: {
111
- id: 'txn-1',
112
- cleared: 'cleared',
113
- },
114
- match_score: 95,
115
- match_reasons: ['exact_amount_match', 'exact_date_match', 'payee_similarity'],
116
- };
117
-
118
- const result = MatchItemSchema.safeParse(validMatch);
119
- expect(result.success).toBe(true);
120
- if (result.success) {
121
- expect(result.data.match_score).toBe(95);
122
- expect(result.data.match_reasons).toHaveLength(3);
123
- }
124
- });
125
-
126
- it('should validate match with negative amounts', () => {
127
- const validMatch = {
128
- bank_date: '2025-10-15',
129
- bank_amount: '-125.00',
130
- bank_description: 'Payment',
131
- ynab_date: '2025-10-15',
132
- ynab_amount: '-125.00',
133
- ynab_payee: null,
134
- ynab_transaction: { id: 'txn-2', cleared: 'uncleared' },
135
- match_score: 100,
136
- match_reasons: ['exact_match'],
137
- };
138
-
139
- const result = MatchItemSchema.safeParse(validMatch);
140
- expect(result.success).toBe(true);
141
- });
142
-
143
- it('should fail validation when amount format is incorrect', () => {
144
- const invalidMatch = {
145
- bank_date: '2025-10-15',
146
- bank_amount: '25.5', // Should be '25.50' (2 decimal places)
147
- bank_description: 'Grocery Store',
148
- ynab_date: '2025-10-15',
149
- ynab_amount: '25.50',
150
- ynab_payee: 'Grocery Store',
151
- ynab_transaction: { id: 'txn-1', cleared: 'cleared' },
152
- match_score: 95,
153
- match_reasons: ['exact_amount_match'],
154
- };
155
-
156
- const result = MatchItemSchema.safeParse(invalidMatch);
157
- expect(result.success).toBe(false);
158
- });
106
+ describe("MatchItemSchema", () => {
107
+ it("should validate complete match item", () => {
108
+ const validMatch = {
109
+ bank_date: "2025-10-15",
110
+ bank_amount: "25.50",
111
+ bank_description: "Grocery Store",
112
+ ynab_date: "2025-10-15",
113
+ ynab_amount: "25.50",
114
+ ynab_payee: "Grocery Store",
115
+ ynab_transaction: {
116
+ id: "txn-1",
117
+ cleared: "cleared",
118
+ },
119
+ match_score: 95,
120
+ match_reasons: [
121
+ "exact_amount_match",
122
+ "exact_date_match",
123
+ "payee_similarity",
124
+ ],
125
+ };
126
+
127
+ const result = MatchItemSchema.safeParse(validMatch);
128
+ expect(result.success).toBe(true);
129
+ if (result.success) {
130
+ expect(result.data.match_score).toBe(95);
131
+ expect(result.data.match_reasons).toHaveLength(3);
132
+ }
133
+ });
134
+
135
+ it("should validate match with negative amounts", () => {
136
+ const validMatch = {
137
+ bank_date: "2025-10-15",
138
+ bank_amount: "-125.00",
139
+ bank_description: "Payment",
140
+ ynab_date: "2025-10-15",
141
+ ynab_amount: "-125.00",
142
+ ynab_payee: null,
143
+ ynab_transaction: { id: "txn-2", cleared: "uncleared" },
144
+ match_score: 100,
145
+ match_reasons: ["exact_match"],
146
+ };
147
+
148
+ const result = MatchItemSchema.safeParse(validMatch);
149
+ expect(result.success).toBe(true);
150
+ });
151
+
152
+ it("should fail validation when amount format is incorrect", () => {
153
+ const invalidMatch = {
154
+ bank_date: "2025-10-15",
155
+ bank_amount: "25.5", // Should be '25.50' (2 decimal places)
156
+ bank_description: "Grocery Store",
157
+ ynab_date: "2025-10-15",
158
+ ynab_amount: "25.50",
159
+ ynab_payee: "Grocery Store",
160
+ ynab_transaction: { id: "txn-1", cleared: "cleared" },
161
+ match_score: 95,
162
+ match_reasons: ["exact_amount_match"],
163
+ };
164
+
165
+ const result = MatchItemSchema.safeParse(invalidMatch);
166
+ expect(result.success).toBe(false);
167
+ });
159
168
  });
160
169
 
161
- describe('MissingInYNABItemSchema', () => {
162
- it('should validate complete missing in YNAB item with suggestions', () => {
163
- const validItem = {
164
- date: '2025-10-20',
165
- amount: '15.00',
166
- description: 'Unknown Store',
167
- row_number: 12,
168
- suggested_payee_id: 'payee-123',
169
- suggested_payee_name: 'Unknown Store',
170
- suggestion_reason: 'Matched by description similarity',
171
- };
172
-
173
- const result = MissingInYNABItemSchema.safeParse(validItem);
174
- expect(result.success).toBe(true);
175
- if (result.success) {
176
- expect(result.data.suggested_payee_id).toBe('payee-123');
177
- expect(result.data.row_number).toBe(12);
178
- }
179
- });
180
-
181
- it('should validate minimal missing in YNAB item without suggestions', () => {
182
- const validItem = {
183
- date: '2025-10-21',
184
- amount: '-50.00',
185
- description: 'Cash Withdrawal',
186
- row_number: 15,
187
- };
188
-
189
- const result = MissingInYNABItemSchema.safeParse(validItem);
190
- expect(result.success).toBe(true);
191
- if (result.success) {
192
- expect(result.data.suggested_payee_id).toBeUndefined();
193
- }
194
- });
195
-
196
- it('should fail validation when amount format is incorrect', () => {
197
- const invalidItem = {
198
- date: '2025-10-20',
199
- amount: '15', // Should have 2 decimal places
200
- description: 'Unknown Store',
201
- row_number: 12,
202
- };
203
-
204
- const result = MissingInYNABItemSchema.safeParse(invalidItem);
205
- expect(result.success).toBe(false);
206
- });
170
+ describe("MissingInYNABItemSchema", () => {
171
+ it("should validate complete missing in YNAB item with suggestions", () => {
172
+ const validItem = {
173
+ date: "2025-10-20",
174
+ amount: "15.00",
175
+ description: "Unknown Store",
176
+ row_number: 12,
177
+ suggested_payee_id: "payee-123",
178
+ suggested_payee_name: "Unknown Store",
179
+ suggestion_reason: "Matched by description similarity",
180
+ };
181
+
182
+ const result = MissingInYNABItemSchema.safeParse(validItem);
183
+ expect(result.success).toBe(true);
184
+ if (result.success) {
185
+ expect(result.data.suggested_payee_id).toBe("payee-123");
186
+ expect(result.data.row_number).toBe(12);
187
+ }
188
+ });
189
+
190
+ it("should validate minimal missing in YNAB item without suggestions", () => {
191
+ const validItem = {
192
+ date: "2025-10-21",
193
+ amount: "-50.00",
194
+ description: "Cash Withdrawal",
195
+ row_number: 15,
196
+ };
197
+
198
+ const result = MissingInYNABItemSchema.safeParse(validItem);
199
+ expect(result.success).toBe(true);
200
+ if (result.success) {
201
+ expect(result.data.suggested_payee_id).toBeUndefined();
202
+ }
203
+ });
204
+
205
+ it("should fail validation when amount format is incorrect", () => {
206
+ const invalidItem = {
207
+ date: "2025-10-20",
208
+ amount: "15", // Should have 2 decimal places
209
+ description: "Unknown Store",
210
+ row_number: 12,
211
+ };
212
+
213
+ const result = MissingInYNABItemSchema.safeParse(invalidItem);
214
+ expect(result.success).toBe(false);
215
+ });
207
216
  });
208
217
 
209
- describe('MissingInBankItemSchema', () => {
210
- it('should validate complete missing in bank item', () => {
211
- const validItem = {
212
- id: 'txn-99',
213
- date: '2025-10-22',
214
- amount: '20.00',
215
- payee_name: 'Coffee Shop',
216
- memo: 'Morning coffee',
217
- cleared: 'cleared',
218
- };
219
-
220
- const result = MissingInBankItemSchema.safeParse(validItem);
221
- expect(result.success).toBe(true);
222
- if (result.success) {
223
- expect(result.data.id).toBe('txn-99');
224
- expect(result.data.payee_name).toBe('Coffee Shop');
225
- }
226
- });
227
-
228
- it('should validate missing in bank item with null fields', () => {
229
- const validItem = {
230
- id: 'txn-100',
231
- date: '2025-10-23',
232
- amount: '-30.50',
233
- payee_name: null,
234
- memo: null,
235
- cleared: 'uncleared',
236
- };
237
-
238
- const result = MissingInBankItemSchema.safeParse(validItem);
239
- expect(result.success).toBe(true);
240
- if (result.success) {
241
- expect(result.data.payee_name).toBeNull();
242
- expect(result.data.memo).toBeNull();
243
- }
244
- });
245
-
246
- it('should fail validation when missing required fields', () => {
247
- const invalidItem = {
248
- id: 'txn-99',
249
- date: '2025-10-22',
250
- // Missing: amount, payee_name, memo, cleared
251
- };
252
-
253
- const result = MissingInBankItemSchema.safeParse(invalidItem);
254
- expect(result.success).toBe(false);
255
- });
218
+ describe("MissingInBankItemSchema", () => {
219
+ it("should validate complete missing in bank item", () => {
220
+ const validItem = {
221
+ id: "txn-99",
222
+ date: "2025-10-22",
223
+ amount: "20.00",
224
+ payee_name: "Coffee Shop",
225
+ memo: "Morning coffee",
226
+ cleared: "cleared",
227
+ };
228
+
229
+ const result = MissingInBankItemSchema.safeParse(validItem);
230
+ expect(result.success).toBe(true);
231
+ if (result.success) {
232
+ expect(result.data.id).toBe("txn-99");
233
+ expect(result.data.payee_name).toBe("Coffee Shop");
234
+ }
235
+ });
236
+
237
+ it("should validate missing in bank item with null fields", () => {
238
+ const validItem = {
239
+ id: "txn-100",
240
+ date: "2025-10-23",
241
+ amount: "-30.50",
242
+ payee_name: null,
243
+ memo: null,
244
+ cleared: "uncleared",
245
+ };
246
+
247
+ const result = MissingInBankItemSchema.safeParse(validItem);
248
+ expect(result.success).toBe(true);
249
+ if (result.success) {
250
+ expect(result.data.payee_name).toBeNull();
251
+ expect(result.data.memo).toBeNull();
252
+ }
253
+ });
254
+
255
+ it("should fail validation when missing required fields", () => {
256
+ const invalidItem = {
257
+ id: "txn-99",
258
+ date: "2025-10-22",
259
+ // Missing: amount, payee_name, memo, cleared
260
+ };
261
+
262
+ const result = MissingInBankItemSchema.safeParse(invalidItem);
263
+ expect(result.success).toBe(false);
264
+ });
256
265
  });
257
266
 
258
- describe('CompareTransactionsOutputSchema', () => {
259
- it('should validate complete comparison result with all sections', () => {
260
- const validOutput = {
261
- summary: {
262
- bank_transactions_count: 50,
263
- ynab_transactions_count: 52,
264
- matches_found: 45,
265
- missing_in_ynab: 5,
266
- missing_in_bank: 7,
267
- date_range: {
268
- start: '2025-10-01',
269
- end: '2025-10-31',
270
- },
271
- parameters: {
272
- amount_tolerance: 0,
273
- date_tolerance_days: 2,
274
- },
275
- },
276
- matches: [
277
- {
278
- bank_date: '2025-10-15',
279
- bank_amount: '25.50',
280
- bank_description: 'Grocery Store',
281
- ynab_date: '2025-10-15',
282
- ynab_amount: '25.50',
283
- ynab_payee: 'Grocery Store',
284
- ynab_transaction: { id: 'txn-1', cleared: 'cleared' },
285
- match_score: 95,
286
- match_reasons: ['exact_amount_match', 'exact_date_match'],
287
- },
288
- ],
289
- missing_in_ynab: [
290
- {
291
- date: '2025-10-20',
292
- amount: '15.00',
293
- description: 'Unknown Store',
294
- row_number: 12,
295
- suggested_payee_name: 'Unknown Store',
296
- suggestion_reason: 'No matching payee found',
297
- },
298
- ],
299
- missing_in_bank: [
300
- {
301
- id: 'txn-99',
302
- date: '2025-10-22',
303
- amount: '20.00',
304
- payee_name: 'Coffee Shop',
305
- memo: null,
306
- cleared: 'cleared',
307
- },
308
- ],
309
- };
310
-
311
- const result = CompareTransactionsOutputSchema.safeParse(validOutput);
312
- expect(result.success).toBe(true);
313
- if (result.success) {
314
- expect(result.data.summary.matches_found).toBe(45);
315
- expect(result.data.matches).toHaveLength(1);
316
- expect(result.data.missing_in_ynab).toHaveLength(1);
317
- expect(result.data.missing_in_bank).toHaveLength(1);
318
- }
319
- });
320
-
321
- it('should validate comparison result with empty match arrays', () => {
322
- const validOutput = {
323
- summary: {
324
- bank_transactions_count: 10,
325
- ynab_transactions_count: 10,
326
- matches_found: 0,
327
- missing_in_ynab: 10,
328
- missing_in_bank: 10,
329
- date_range: {
330
- start: '2025-11-01',
331
- end: '2025-11-30',
332
- },
333
- parameters: {},
334
- },
335
- matches: [],
336
- missing_in_ynab: [],
337
- missing_in_bank: [],
338
- };
339
-
340
- const result = CompareTransactionsOutputSchema.safeParse(validOutput);
341
- expect(result.success).toBe(true);
342
- if (result.success) {
343
- expect(result.data.summary.matches_found).toBe(0);
344
- expect(result.data.matches).toHaveLength(0);
345
- }
346
- });
347
-
348
- it('should fail validation when missing required summary fields', () => {
349
- const invalidOutput = {
350
- summary: {
351
- bank_transactions_count: 50,
352
- // Missing: ynab_transactions_count, matches_found, etc.
353
- },
354
- matches: [],
355
- missing_in_ynab: [],
356
- missing_in_bank: [],
357
- };
358
-
359
- const result = CompareTransactionsOutputSchema.safeParse(invalidOutput);
360
- expect(result.success).toBe(false);
361
- });
362
-
363
- it('should fail validation when date range is invalid', () => {
364
- const invalidOutput = {
365
- summary: {
366
- bank_transactions_count: 50,
367
- ynab_transactions_count: 52,
368
- matches_found: 45,
369
- missing_in_ynab: 5,
370
- missing_in_bank: 7,
371
- date_range: {
372
- start: '2025-10-31',
373
- end: '2025-10-01', // End before start
374
- },
375
- parameters: {},
376
- },
377
- matches: [],
378
- missing_in_ynab: [],
379
- missing_in_bank: [],
380
- };
381
-
382
- const result = CompareTransactionsOutputSchema.safeParse(invalidOutput);
383
- expect(result.success).toBe(false);
384
- });
267
+ describe("CompareTransactionsOutputSchema", () => {
268
+ it("should validate complete comparison result with all sections", () => {
269
+ const validOutput = {
270
+ summary: {
271
+ bank_transactions_count: 50,
272
+ ynab_transactions_count: 52,
273
+ matches_found: 45,
274
+ missing_in_ynab: 5,
275
+ missing_in_bank: 7,
276
+ date_range: {
277
+ start: "2025-10-01",
278
+ end: "2025-10-31",
279
+ },
280
+ parameters: {
281
+ amount_tolerance: 0,
282
+ date_tolerance_days: 2,
283
+ },
284
+ },
285
+ matches: [
286
+ {
287
+ bank_date: "2025-10-15",
288
+ bank_amount: "25.50",
289
+ bank_description: "Grocery Store",
290
+ ynab_date: "2025-10-15",
291
+ ynab_amount: "25.50",
292
+ ynab_payee: "Grocery Store",
293
+ ynab_transaction: { id: "txn-1", cleared: "cleared" },
294
+ match_score: 95,
295
+ match_reasons: ["exact_amount_match", "exact_date_match"],
296
+ },
297
+ ],
298
+ missing_in_ynab: [
299
+ {
300
+ date: "2025-10-20",
301
+ amount: "15.00",
302
+ description: "Unknown Store",
303
+ row_number: 12,
304
+ suggested_payee_name: "Unknown Store",
305
+ suggestion_reason: "No matching payee found",
306
+ },
307
+ ],
308
+ missing_in_bank: [
309
+ {
310
+ id: "txn-99",
311
+ date: "2025-10-22",
312
+ amount: "20.00",
313
+ payee_name: "Coffee Shop",
314
+ memo: null,
315
+ cleared: "cleared",
316
+ },
317
+ ],
318
+ };
319
+
320
+ const result = CompareTransactionsOutputSchema.safeParse(validOutput);
321
+ expect(result.success).toBe(true);
322
+ if (result.success) {
323
+ expect(result.data.summary.matches_found).toBe(45);
324
+ expect(result.data.matches).toHaveLength(1);
325
+ expect(result.data.missing_in_ynab).toHaveLength(1);
326
+ expect(result.data.missing_in_bank).toHaveLength(1);
327
+ }
328
+ });
329
+
330
+ it("should validate comparison result with empty match arrays", () => {
331
+ const validOutput = {
332
+ summary: {
333
+ bank_transactions_count: 10,
334
+ ynab_transactions_count: 10,
335
+ matches_found: 0,
336
+ missing_in_ynab: 10,
337
+ missing_in_bank: 10,
338
+ date_range: {
339
+ start: "2025-11-01",
340
+ end: "2025-11-30",
341
+ },
342
+ parameters: {},
343
+ },
344
+ matches: [],
345
+ missing_in_ynab: [],
346
+ missing_in_bank: [],
347
+ };
348
+
349
+ const result = CompareTransactionsOutputSchema.safeParse(validOutput);
350
+ expect(result.success).toBe(true);
351
+ if (result.success) {
352
+ expect(result.data.summary.matches_found).toBe(0);
353
+ expect(result.data.matches).toHaveLength(0);
354
+ }
355
+ });
356
+
357
+ it("should fail validation when missing required summary fields", () => {
358
+ const invalidOutput = {
359
+ summary: {
360
+ bank_transactions_count: 50,
361
+ // Missing: ynab_transactions_count, matches_found, etc.
362
+ },
363
+ matches: [],
364
+ missing_in_ynab: [],
365
+ missing_in_bank: [],
366
+ };
367
+
368
+ const result = CompareTransactionsOutputSchema.safeParse(invalidOutput);
369
+ expect(result.success).toBe(false);
370
+ });
371
+
372
+ it("should fail validation when date range is invalid", () => {
373
+ const invalidOutput = {
374
+ summary: {
375
+ bank_transactions_count: 50,
376
+ ynab_transactions_count: 52,
377
+ matches_found: 45,
378
+ missing_in_ynab: 5,
379
+ missing_in_bank: 7,
380
+ date_range: {
381
+ start: "2025-10-31",
382
+ end: "2025-10-01", // End before start
383
+ },
384
+ parameters: {},
385
+ },
386
+ matches: [],
387
+ missing_in_ynab: [],
388
+ missing_in_bank: [],
389
+ };
390
+
391
+ const result = CompareTransactionsOutputSchema.safeParse(invalidOutput);
392
+ expect(result.success).toBe(false);
393
+ });
385
394
  });
386
395
 
387
- describe('ExportTransactionsOutputSchema', () => {
388
- it('should validate minimal export mode output', () => {
389
- const validOutput = {
390
- message: 'Successfully exported 150 transactions (minimal fields)',
391
- filename: 'ynab_transactions_minimal_2025-11-18.json',
392
- full_path: '/Users/username/Downloads/ynab_transactions_minimal_2025-11-18.json',
393
- export_directory: '/Users/username/Downloads',
394
- export_mode: 'minimal',
395
- minimal_fields: 'id, date, amount, payee_name, cleared',
396
- filename_explanation: 'Filename format: ynab_{filters}_{count}items_{timestamp}.json',
397
- preview_count: 10,
398
- total_count: 150,
399
- preview_transactions: [
400
- {
401
- id: 'txn-1',
402
- date: '2025-11-15',
403
- amount: -25500, // Milliunits
404
- memo: 'Groceries',
405
- payee_name: 'Grocery Store',
406
- category_name: 'Food',
407
- },
408
- ],
409
- };
410
-
411
- const result = ExportTransactionsOutputSchema.safeParse(validOutput);
412
- expect(result.success).toBe(true);
413
- if (result.success) {
414
- expect(result.data.export_mode).toBe('minimal');
415
- expect(result.data.minimal_fields).toBe('id, date, amount, payee_name, cleared');
416
- expect(result.data.preview_transactions).toHaveLength(1);
417
- expect(result.data.total_count).toBe(150);
418
- }
419
- });
420
-
421
- it('should validate full export mode output', () => {
422
- const validOutput = {
423
- message: 'Successfully exported 150 transactions (full fields)',
424
- filename: 'ynab_transactions_2025-11-18.json',
425
- full_path: '/Users/username/Downloads/ynab_transactions_2025-11-18.json',
426
- export_directory: '/Users/username/Downloads',
427
- export_mode: 'full',
428
- minimal_fields: null,
429
- filename_explanation: 'Filename format: ynab_{filters}_{count}items_{timestamp}.json',
430
- preview_count: 10,
431
- total_count: 150,
432
- preview_transactions: [
433
- {
434
- id: 'txn-2',
435
- date: '2025-11-16',
436
- amount: -15000, // Milliunits: -$15.00
437
- payee_name: 'Cafe',
438
- category_name: 'Dining',
439
- },
440
- ],
441
- };
442
-
443
- const result = ExportTransactionsOutputSchema.safeParse(validOutput);
444
- expect(result.success).toBe(true);
445
- if (result.success) {
446
- expect(result.data.export_mode).toBe('full');
447
- expect(result.data.minimal_fields).toBeNull();
448
- }
449
- });
450
-
451
- it('should validate export output with empty preview', () => {
452
- const validOutput = {
453
- message: 'Successfully exported 0 transactions',
454
- filename: 'ynab_transactions_empty_2025-11-18.json',
455
- full_path: '/Users/username/Downloads/ynab_transactions_empty_2025-11-18.json',
456
- export_directory: '/Users/username/Downloads',
457
- export_mode: 'full',
458
- minimal_fields: null,
459
- filename_explanation: 'No transactions to export',
460
- preview_count: 0,
461
- total_count: 0,
462
- preview_transactions: [],
463
- };
464
-
465
- const result = ExportTransactionsOutputSchema.safeParse(validOutput);
466
- expect(result.success).toBe(true);
467
- if (result.success) {
468
- expect(result.data.preview_transactions).toHaveLength(0);
469
- expect(result.data.total_count).toBe(0);
470
- }
471
- });
472
-
473
- it('should fail validation when export_mode is invalid', () => {
474
- const invalidOutput = {
475
- message: 'Export complete',
476
- filename: 'export.json',
477
- full_path: '/path/to/export.json',
478
- export_directory: '/path/to',
479
- export_mode: 'invalid', // Should be 'minimal' or 'full'
480
- minimal_fields: null,
481
- filename_explanation: 'Filename',
482
- preview_count: 0,
483
- total_count: 0,
484
- preview_transactions: [],
485
- };
486
-
487
- const result = ExportTransactionsOutputSchema.safeParse(invalidOutput);
488
- expect(result.success).toBe(false);
489
- });
490
-
491
- it('should fail validation when missing required fields', () => {
492
- const invalidOutput = {
493
- message: 'Export complete',
494
- filename: 'export.json',
495
- // Missing: full_path, export_directory, export_mode, etc.
496
- };
497
-
498
- const result = ExportTransactionsOutputSchema.safeParse(invalidOutput);
499
- expect(result.success).toBe(false);
500
- });
501
-
502
- it('should fail validation when preview_count is not a number', () => {
503
- const invalidOutput = {
504
- message: 'Export complete',
505
- filename: 'export.json',
506
- full_path: '/path/to/export.json',
507
- export_directory: '/path/to',
508
- export_mode: 'full',
509
- minimal_fields: null,
510
- filename_explanation: 'Filename',
511
- preview_count: '10', // Should be number
512
- total_count: 100,
513
- preview_transactions: [],
514
- };
515
-
516
- const result = ExportTransactionsOutputSchema.safeParse(invalidOutput);
517
- expect(result.success).toBe(false);
518
- });
396
+ describe("ExportTransactionsOutputSchema", () => {
397
+ it("should validate minimal export mode output", () => {
398
+ const validOutput = {
399
+ message: "Successfully exported 150 transactions (minimal fields)",
400
+ filename: "ynab_transactions_minimal_2025-11-18.json",
401
+ full_path:
402
+ "/Users/username/Downloads/ynab_transactions_minimal_2025-11-18.json",
403
+ export_directory: "/Users/username/Downloads",
404
+ export_mode: "minimal",
405
+ minimal_fields: "id, date, amount, payee_name, cleared",
406
+ filename_explanation:
407
+ "Filename format: ynab_{filters}_{count}items_{timestamp}.json",
408
+ preview_count: 10,
409
+ total_count: 150,
410
+ preview_transactions: [
411
+ {
412
+ id: "txn-1",
413
+ date: "2025-11-15",
414
+ amount: -25500, // Milliunits
415
+ memo: "Groceries",
416
+ payee_name: "Grocery Store",
417
+ category_name: "Food",
418
+ },
419
+ ],
420
+ };
421
+
422
+ const result = ExportTransactionsOutputSchema.safeParse(validOutput);
423
+ expect(result.success).toBe(true);
424
+ if (result.success) {
425
+ expect(result.data.export_mode).toBe("minimal");
426
+ expect(result.data.minimal_fields).toBe(
427
+ "id, date, amount, payee_name, cleared",
428
+ );
429
+ expect(result.data.preview_transactions).toHaveLength(1);
430
+ expect(result.data.total_count).toBe(150);
431
+ }
432
+ });
433
+
434
+ it("should validate full export mode output", () => {
435
+ const validOutput = {
436
+ message: "Successfully exported 150 transactions (full fields)",
437
+ filename: "ynab_transactions_2025-11-18.json",
438
+ full_path: "/Users/username/Downloads/ynab_transactions_2025-11-18.json",
439
+ export_directory: "/Users/username/Downloads",
440
+ export_mode: "full",
441
+ minimal_fields: null,
442
+ filename_explanation:
443
+ "Filename format: ynab_{filters}_{count}items_{timestamp}.json",
444
+ preview_count: 10,
445
+ total_count: 150,
446
+ preview_transactions: [
447
+ {
448
+ id: "txn-2",
449
+ date: "2025-11-16",
450
+ amount: -15000, // Milliunits: -$15.00
451
+ payee_name: "Cafe",
452
+ category_name: "Dining",
453
+ },
454
+ ],
455
+ };
456
+
457
+ const result = ExportTransactionsOutputSchema.safeParse(validOutput);
458
+ expect(result.success).toBe(true);
459
+ if (result.success) {
460
+ expect(result.data.export_mode).toBe("full");
461
+ expect(result.data.minimal_fields).toBeNull();
462
+ }
463
+ });
464
+
465
+ it("should validate export output with empty preview", () => {
466
+ const validOutput = {
467
+ message: "Successfully exported 0 transactions",
468
+ filename: "ynab_transactions_empty_2025-11-18.json",
469
+ full_path:
470
+ "/Users/username/Downloads/ynab_transactions_empty_2025-11-18.json",
471
+ export_directory: "/Users/username/Downloads",
472
+ export_mode: "full",
473
+ minimal_fields: null,
474
+ filename_explanation: "No transactions to export",
475
+ preview_count: 0,
476
+ total_count: 0,
477
+ preview_transactions: [],
478
+ };
479
+
480
+ const result = ExportTransactionsOutputSchema.safeParse(validOutput);
481
+ expect(result.success).toBe(true);
482
+ if (result.success) {
483
+ expect(result.data.preview_transactions).toHaveLength(0);
484
+ expect(result.data.total_count).toBe(0);
485
+ }
486
+ });
487
+
488
+ it("should fail validation when export_mode is invalid", () => {
489
+ const invalidOutput = {
490
+ message: "Export complete",
491
+ filename: "export.json",
492
+ full_path: "/path/to/export.json",
493
+ export_directory: "/path/to",
494
+ export_mode: "invalid", // Should be 'minimal' or 'full'
495
+ minimal_fields: null,
496
+ filename_explanation: "Filename",
497
+ preview_count: 0,
498
+ total_count: 0,
499
+ preview_transactions: [],
500
+ };
501
+
502
+ const result = ExportTransactionsOutputSchema.safeParse(invalidOutput);
503
+ expect(result.success).toBe(false);
504
+ });
505
+
506
+ it("should fail validation when missing required fields", () => {
507
+ const invalidOutput = {
508
+ message: "Export complete",
509
+ filename: "export.json",
510
+ // Missing: full_path, export_directory, export_mode, etc.
511
+ };
512
+
513
+ const result = ExportTransactionsOutputSchema.safeParse(invalidOutput);
514
+ expect(result.success).toBe(false);
515
+ });
516
+
517
+ it("should fail validation when preview_count is not a number", () => {
518
+ const invalidOutput = {
519
+ message: "Export complete",
520
+ filename: "export.json",
521
+ full_path: "/path/to/export.json",
522
+ export_directory: "/path/to",
523
+ export_mode: "full",
524
+ minimal_fields: null,
525
+ filename_explanation: "Filename",
526
+ preview_count: "10", // Should be number
527
+ total_count: 100,
528
+ preview_transactions: [],
529
+ };
530
+
531
+ const result = ExportTransactionsOutputSchema.safeParse(invalidOutput);
532
+ expect(result.success).toBe(false);
533
+ });
519
534
  });