@dizzlkheinz/ynab-mcpb 0.18.4 → 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 (343) hide show
  1. package/CLAUDE.md +87 -8
  2. package/bin/ynab-mcp-server.cjs +2 -2
  3. package/bin/ynab-mcp-server.js +3 -3
  4. package/biome.json +39 -0
  5. package/dist/bundle/index.cjs +67 -67
  6. package/dist/index.d.ts +1 -1
  7. package/dist/index.js +27 -27
  8. package/dist/server/YNABMCPServer.d.ts +3 -4
  9. package/dist/server/YNABMCPServer.js +111 -116
  10. package/dist/server/budgetResolver.d.ts +6 -5
  11. package/dist/server/budgetResolver.js +46 -36
  12. package/dist/server/cacheKeys.js +6 -6
  13. package/dist/server/cacheManager.js +14 -11
  14. package/dist/server/completions.d.ts +2 -2
  15. package/dist/server/completions.js +20 -15
  16. package/dist/server/config.d.ts +10 -5
  17. package/dist/server/config.js +24 -7
  18. package/dist/server/deltaCache.d.ts +2 -2
  19. package/dist/server/deltaCache.js +22 -16
  20. package/dist/server/deltaCache.merge.d.ts +2 -2
  21. package/dist/server/diagnostics.d.ts +4 -4
  22. package/dist/server/diagnostics.js +38 -32
  23. package/dist/server/errorHandler.d.ts +5 -12
  24. package/dist/server/errorHandler.js +219 -217
  25. package/dist/server/prompts.d.ts +2 -2
  26. package/dist/server/prompts.js +45 -45
  27. package/dist/server/rateLimiter.js +4 -4
  28. package/dist/server/requestLogger.d.ts +1 -1
  29. package/dist/server/requestLogger.js +40 -35
  30. package/dist/server/resources.d.ts +3 -3
  31. package/dist/server/resources.js +55 -52
  32. package/dist/server/responseFormatter.js +6 -6
  33. package/dist/server/securityMiddleware.d.ts +2 -2
  34. package/dist/server/securityMiddleware.js +22 -20
  35. package/dist/server/serverKnowledgeStore.js +1 -1
  36. package/dist/server/toolRegistry.d.ts +3 -3
  37. package/dist/server/toolRegistry.js +47 -40
  38. package/dist/tools/__tests__/deltaTestUtils.d.ts +3 -3
  39. package/dist/tools/__tests__/deltaTestUtils.js +2 -2
  40. package/dist/tools/accountTools.d.ts +9 -8
  41. package/dist/tools/accountTools.js +47 -47
  42. package/dist/tools/adapters.d.ts +13 -8
  43. package/dist/tools/adapters.js +21 -11
  44. package/dist/tools/budgetTools.d.ts +8 -7
  45. package/dist/tools/budgetTools.js +22 -22
  46. package/dist/tools/categoryTools.d.ts +9 -8
  47. package/dist/tools/categoryTools.js +68 -59
  48. package/dist/tools/compareTransactions/formatter.d.ts +3 -3
  49. package/dist/tools/compareTransactions/formatter.js +9 -9
  50. package/dist/tools/compareTransactions/index.d.ts +6 -6
  51. package/dist/tools/compareTransactions/index.js +58 -43
  52. package/dist/tools/compareTransactions/matcher.d.ts +1 -1
  53. package/dist/tools/compareTransactions/matcher.js +28 -15
  54. package/dist/tools/compareTransactions/parser.d.ts +2 -2
  55. package/dist/tools/compareTransactions/parser.js +144 -138
  56. package/dist/tools/compareTransactions/types.d.ts +4 -4
  57. package/dist/tools/compareTransactions.d.ts +1 -1
  58. package/dist/tools/compareTransactions.js +1 -1
  59. package/dist/tools/deltaFetcher.d.ts +2 -2
  60. package/dist/tools/deltaFetcher.js +16 -15
  61. package/dist/tools/deltaSupport.d.ts +4 -4
  62. package/dist/tools/deltaSupport.js +35 -41
  63. package/dist/tools/exportTransactions.d.ts +5 -4
  64. package/dist/tools/exportTransactions.js +61 -59
  65. package/dist/tools/monthTools.d.ts +7 -6
  66. package/dist/tools/monthTools.js +31 -29
  67. package/dist/tools/payeeTools.d.ts +7 -6
  68. package/dist/tools/payeeTools.js +28 -28
  69. package/dist/tools/reconcileAdapter.d.ts +2 -2
  70. package/dist/tools/reconcileAdapter.js +19 -12
  71. package/dist/tools/reconciliation/analyzer.d.ts +4 -4
  72. package/dist/tools/reconciliation/analyzer.js +73 -59
  73. package/dist/tools/reconciliation/csvParser.d.ts +3 -3
  74. package/dist/tools/reconciliation/csvParser.js +128 -104
  75. package/dist/tools/reconciliation/executor.d.ts +4 -4
  76. package/dist/tools/reconciliation/executor.js +148 -109
  77. package/dist/tools/reconciliation/index.d.ts +10 -10
  78. package/dist/tools/reconciliation/index.js +96 -83
  79. package/dist/tools/reconciliation/matcher.d.ts +3 -3
  80. package/dist/tools/reconciliation/matcher.js +17 -16
  81. package/dist/tools/reconciliation/payeeNormalizer.js +19 -8
  82. package/dist/tools/reconciliation/recommendationEngine.d.ts +1 -1
  83. package/dist/tools/reconciliation/recommendationEngine.js +40 -40
  84. package/dist/tools/reconciliation/reportFormatter.d.ts +2 -2
  85. package/dist/tools/reconciliation/reportFormatter.js +59 -58
  86. package/dist/tools/reconciliation/signDetector.d.ts +1 -1
  87. package/dist/tools/reconciliation/types.d.ts +16 -16
  88. package/dist/tools/reconciliation/ynabAdapter.d.ts +2 -2
  89. package/dist/tools/schemas/common.d.ts +1 -1
  90. package/dist/tools/schemas/common.js +1 -1
  91. package/dist/tools/schemas/outputs/accountOutputs.d.ts +1 -1
  92. package/dist/tools/schemas/outputs/accountOutputs.js +24 -18
  93. package/dist/tools/schemas/outputs/budgetOutputs.d.ts +1 -1
  94. package/dist/tools/schemas/outputs/budgetOutputs.js +14 -11
  95. package/dist/tools/schemas/outputs/categoryOutputs.d.ts +1 -1
  96. package/dist/tools/schemas/outputs/categoryOutputs.js +49 -29
  97. package/dist/tools/schemas/outputs/comparisonOutputs.d.ts +1 -1
  98. package/dist/tools/schemas/outputs/comparisonOutputs.js +12 -12
  99. package/dist/tools/schemas/outputs/index.d.ts +14 -14
  100. package/dist/tools/schemas/outputs/index.js +14 -14
  101. package/dist/tools/schemas/outputs/monthOutputs.d.ts +1 -1
  102. package/dist/tools/schemas/outputs/monthOutputs.js +56 -41
  103. package/dist/tools/schemas/outputs/payeeOutputs.d.ts +1 -1
  104. package/dist/tools/schemas/outputs/payeeOutputs.js +10 -10
  105. package/dist/tools/schemas/outputs/reconciliationOutputs.d.ts +2 -2
  106. package/dist/tools/schemas/outputs/reconciliationOutputs.js +45 -45
  107. package/dist/tools/schemas/outputs/transactionMutationOutputs.d.ts +1 -1
  108. package/dist/tools/schemas/outputs/transactionMutationOutputs.js +28 -22
  109. package/dist/tools/schemas/outputs/transactionOutputs.d.ts +1 -1
  110. package/dist/tools/schemas/outputs/transactionOutputs.js +43 -35
  111. package/dist/tools/schemas/outputs/utilityOutputs.d.ts +1 -1
  112. package/dist/tools/schemas/outputs/utilityOutputs.js +5 -3
  113. package/dist/tools/schemas/shared/commonOutputs.d.ts +1 -1
  114. package/dist/tools/schemas/shared/commonOutputs.js +15 -9
  115. package/dist/tools/transactionReadTools.d.ts +11 -0
  116. package/dist/tools/transactionReadTools.js +202 -0
  117. package/dist/tools/transactionSchemas.d.ts +7 -7
  118. package/dist/tools/transactionSchemas.js +77 -57
  119. package/dist/tools/transactionTools.d.ts +6 -24
  120. package/dist/tools/transactionTools.js +7 -1499
  121. package/dist/tools/transactionUtils.d.ts +6 -6
  122. package/dist/tools/transactionUtils.js +78 -63
  123. package/dist/tools/transactionWriteTools.d.ts +20 -0
  124. package/dist/tools/transactionWriteTools.js +1342 -0
  125. package/dist/tools/utilityTools.d.ts +5 -4
  126. package/dist/tools/utilityTools.js +11 -11
  127. package/dist/types/index.d.ts +7 -7
  128. package/dist/types/index.js +6 -6
  129. package/dist/types/reconciliation.d.ts +1 -1
  130. package/dist/types/toolRegistration.d.ts +14 -12
  131. package/dist/utils/amountUtils.js +1 -1
  132. package/dist/utils/dateUtils.js +4 -4
  133. package/dist/utils/errors.d.ts +3 -3
  134. package/dist/utils/errors.js +4 -4
  135. package/dist/utils/money.d.ts +2 -2
  136. package/dist/utils/money.js +8 -8
  137. package/dist/utils/validationError.d.ts +1 -1
  138. package/dist/utils/validationError.js +1 -1
  139. package/docs/assets/examples/reconciliation-with-recommendations.json +66 -66
  140. package/docs/assets/schemas/reconciliation-v2.json +360 -336
  141. package/esbuild.config.mjs +53 -50
  142. package/meta.json +12548 -12548
  143. package/package.json +98 -111
  144. package/scripts/analyze-bundle.mjs +33 -30
  145. package/scripts/create-pr-description.js +169 -120
  146. package/scripts/run-all-tests.js +178 -169
  147. package/scripts/run-domain-integration-tests.js +28 -18
  148. package/scripts/run-generate-mcpb.js +19 -17
  149. package/scripts/run-throttled-integration-tests.js +92 -83
  150. package/scripts/test-delta-params.mjs +149 -120
  151. package/scripts/test-recommendations.ts +36 -32
  152. package/scripts/tmpTransaction.ts +80 -43
  153. package/scripts/validate-env.js +98 -91
  154. package/scripts/verify-build.js +78 -76
  155. package/src/__tests__/comprehensive.integration.test.ts +1281 -1154
  156. package/src/__tests__/performance.test.ts +723 -671
  157. package/src/__tests__/setup.ts +442 -395
  158. package/src/__tests__/smoke.e2e.test.ts +41 -39
  159. package/src/__tests__/testRunner.ts +314 -295
  160. package/src/__tests__/testUtils.ts +456 -364
  161. package/src/__tests__/tools/reconciliation/csvParser.integration.test.ts +109 -107
  162. package/src/__tests__/tools/reconciliation/real-world.integration.test.ts +41 -41
  163. package/src/index.ts +68 -59
  164. package/src/server/CLAUDE.md +480 -0
  165. package/src/server/YNABMCPServer.ts +821 -794
  166. package/src/server/__tests__/YNABMCPServer.integration.test.ts +929 -893
  167. package/src/server/__tests__/YNABMCPServer.test.ts +903 -899
  168. package/src/server/__tests__/budgetResolver.test.ts +466 -423
  169. package/src/server/__tests__/cacheManager.test.ts +891 -874
  170. package/src/server/__tests__/completions.integration.test.ts +115 -106
  171. package/src/server/__tests__/completions.test.ts +334 -313
  172. package/src/server/__tests__/config.test.ts +98 -86
  173. package/src/server/__tests__/deltaCache.merge.test.ts +774 -703
  174. package/src/server/__tests__/deltaCache.swr.test.ts +198 -153
  175. package/src/server/__tests__/deltaCache.test.ts +946 -759
  176. package/src/server/__tests__/diagnostics.test.ts +825 -792
  177. package/src/server/__tests__/errorHandler.integration.test.ts +512 -462
  178. package/src/server/__tests__/errorHandler.test.ts +402 -397
  179. package/src/server/__tests__/prompts.test.ts +424 -347
  180. package/src/server/__tests__/rateLimiter.test.ts +313 -309
  181. package/src/server/__tests__/requestLogger.test.ts +443 -403
  182. package/src/server/__tests__/resources.template.test.ts +196 -185
  183. package/src/server/__tests__/resources.test.ts +294 -288
  184. package/src/server/__tests__/security.integration.test.ts +487 -421
  185. package/src/server/__tests__/securityMiddleware.test.ts +519 -444
  186. package/src/server/__tests__/server-startup.integration.test.ts +509 -490
  187. package/src/server/__tests__/serverKnowledgeStore.test.ts +174 -173
  188. package/src/server/__tests__/toolRegistration.test.ts +239 -210
  189. package/src/server/__tests__/toolRegistry.test.ts +907 -845
  190. package/src/server/budgetResolver.ts +221 -181
  191. package/src/server/cacheKeys.ts +6 -6
  192. package/src/server/cacheManager.ts +498 -484
  193. package/src/server/completions.ts +267 -243
  194. package/src/server/config.ts +35 -14
  195. package/src/server/deltaCache.merge.ts +146 -128
  196. package/src/server/deltaCache.ts +352 -309
  197. package/src/server/diagnostics.ts +257 -242
  198. package/src/server/errorHandler.ts +747 -744
  199. package/src/server/prompts.ts +181 -176
  200. package/src/server/rateLimiter.ts +131 -129
  201. package/src/server/requestLogger.ts +350 -322
  202. package/src/server/resources.ts +442 -374
  203. package/src/server/responseFormatter.ts +41 -37
  204. package/src/server/securityMiddleware.ts +223 -205
  205. package/src/server/serverKnowledgeStore.ts +67 -67
  206. package/src/server/toolRegistry.ts +508 -474
  207. package/src/tools/CLAUDE.md +604 -0
  208. package/src/tools/__tests__/accountTools.delta.integration.test.ts +128 -111
  209. package/src/tools/__tests__/accountTools.integration.test.ts +129 -111
  210. package/src/tools/__tests__/accountTools.test.ts +685 -638
  211. package/src/tools/__tests__/adapters.test.ts +142 -108
  212. package/src/tools/__tests__/budgetTools.delta.integration.test.ts +73 -73
  213. package/src/tools/__tests__/budgetTools.integration.test.ts +132 -124
  214. package/src/tools/__tests__/budgetTools.test.ts +442 -413
  215. package/src/tools/__tests__/categoryTools.delta.integration.test.ts +76 -68
  216. package/src/tools/__tests__/categoryTools.integration.test.ts +314 -288
  217. package/src/tools/__tests__/categoryTools.test.ts +656 -625
  218. package/src/tools/__tests__/compareTransactions/formatter.test.ts +535 -462
  219. package/src/tools/__tests__/compareTransactions/index.test.ts +378 -358
  220. package/src/tools/__tests__/compareTransactions/matcher.test.ts +497 -398
  221. package/src/tools/__tests__/compareTransactions/parser.test.ts +765 -747
  222. package/src/tools/__tests__/compareTransactions.test.ts +352 -332
  223. package/src/tools/__tests__/compareTransactions.window.test.ts +150 -146
  224. package/src/tools/__tests__/deltaFetcher.scheduled.integration.test.ts +69 -65
  225. package/src/tools/__tests__/deltaFetcher.test.ts +325 -265
  226. package/src/tools/__tests__/deltaSupport.test.ts +211 -184
  227. package/src/tools/__tests__/deltaTestUtils.ts +37 -33
  228. package/src/tools/__tests__/exportTransactions.test.ts +205 -200
  229. package/src/tools/__tests__/monthTools.delta.integration.test.ts +68 -68
  230. package/src/tools/__tests__/monthTools.integration.test.ts +178 -166
  231. package/src/tools/__tests__/monthTools.test.ts +561 -512
  232. package/src/tools/__tests__/payeeTools.delta.integration.test.ts +68 -68
  233. package/src/tools/__tests__/payeeTools.integration.test.ts +158 -142
  234. package/src/tools/__tests__/payeeTools.test.ts +486 -434
  235. package/src/tools/__tests__/transactionSchemas.test.ts +1202 -1186
  236. package/src/tools/__tests__/transactionTools.integration.test.ts +875 -825
  237. package/src/tools/__tests__/transactionTools.test.ts +4923 -4366
  238. package/src/tools/__tests__/transactionUtils.test.ts +1004 -977
  239. package/src/tools/__tests__/utilityTools.integration.test.ts +32 -32
  240. package/src/tools/__tests__/utilityTools.test.ts +68 -58
  241. package/src/tools/accountTools.ts +293 -271
  242. package/src/tools/adapters.ts +120 -63
  243. package/src/tools/budgetTools.ts +121 -116
  244. package/src/tools/categoryTools.ts +379 -339
  245. package/src/tools/compareTransactions/formatter.ts +131 -119
  246. package/src/tools/compareTransactions/index.ts +249 -214
  247. package/src/tools/compareTransactions/matcher.ts +259 -209
  248. package/src/tools/compareTransactions/parser.ts +517 -487
  249. package/src/tools/compareTransactions/types.ts +38 -38
  250. package/src/tools/compareTransactions.ts +1 -1
  251. package/src/tools/deltaFetcher.ts +281 -260
  252. package/src/tools/deltaSupport.ts +264 -259
  253. package/src/tools/exportTransactions.ts +230 -218
  254. package/src/tools/monthTools.ts +180 -165
  255. package/src/tools/payeeTools.ts +152 -140
  256. package/src/tools/reconcileAdapter.ts +297 -252
  257. package/src/tools/reconciliation/CLAUDE.md +506 -0
  258. package/src/tools/reconciliation/__tests__/adapter.causes.test.ts +133 -124
  259. package/src/tools/reconciliation/__tests__/adapter.test.ts +249 -230
  260. package/src/tools/reconciliation/__tests__/analyzer.test.ts +408 -400
  261. package/src/tools/reconciliation/__tests__/csvParser.test.ts +71 -69
  262. package/src/tools/reconciliation/__tests__/executor.integration.test.ts +348 -323
  263. package/src/tools/reconciliation/__tests__/executor.progress.test.ts +503 -457
  264. package/src/tools/reconciliation/__tests__/executor.test.ts +898 -831
  265. package/src/tools/reconciliation/__tests__/matcher.test.ts +667 -663
  266. package/src/tools/reconciliation/__tests__/payeeNormalizer.test.ts +296 -276
  267. package/src/tools/reconciliation/__tests__/recommendationEngine.integration.test.ts +692 -624
  268. package/src/tools/reconciliation/__tests__/recommendationEngine.test.ts +1008 -989
  269. package/src/tools/reconciliation/__tests__/reconciliation.delta.integration.test.ts +187 -146
  270. package/src/tools/reconciliation/__tests__/reportFormatter.test.ts +583 -533
  271. package/src/tools/reconciliation/__tests__/scenarios/adapterCurrency.scenario.test.ts +75 -74
  272. package/src/tools/reconciliation/__tests__/scenarios/extremes.scenario.test.ts +70 -62
  273. package/src/tools/reconciliation/__tests__/scenarios/repeatAmount.scenario.test.ts +102 -88
  274. package/src/tools/reconciliation/__tests__/schemaUrl.test.ts +56 -55
  275. package/src/tools/reconciliation/__tests__/signDetector.test.ts +209 -206
  276. package/src/tools/reconciliation/__tests__/ynabAdapter.test.ts +66 -60
  277. package/src/tools/reconciliation/analyzer.ts +564 -504
  278. package/src/tools/reconciliation/csvParser.ts +656 -609
  279. package/src/tools/reconciliation/executor.ts +1290 -1128
  280. package/src/tools/reconciliation/index.ts +580 -528
  281. package/src/tools/reconciliation/matcher.ts +256 -240
  282. package/src/tools/reconciliation/payeeNormalizer.ts +92 -78
  283. package/src/tools/reconciliation/recommendationEngine.ts +357 -345
  284. package/src/tools/reconciliation/reportFormatter.ts +343 -307
  285. package/src/tools/reconciliation/signDetector.ts +89 -83
  286. package/src/tools/reconciliation/types.ts +164 -159
  287. package/src/tools/reconciliation/ynabAdapter.ts +17 -15
  288. package/src/tools/schemas/CLAUDE.md +546 -0
  289. package/src/tools/schemas/common.ts +1 -1
  290. package/src/tools/schemas/outputs/__tests__/accountOutputs.test.ts +410 -409
  291. package/src/tools/schemas/outputs/__tests__/budgetOutputs.test.ts +305 -299
  292. package/src/tools/schemas/outputs/__tests__/categoryOutputs.test.ts +431 -430
  293. package/src/tools/schemas/outputs/__tests__/comparisonOutputs.test.ts +510 -495
  294. package/src/tools/schemas/outputs/__tests__/dateValidation.test.ts +179 -153
  295. package/src/tools/schemas/outputs/__tests__/discrepancyDirection.test.ts +293 -254
  296. package/src/tools/schemas/outputs/__tests__/monthOutputs.test.ts +457 -457
  297. package/src/tools/schemas/outputs/__tests__/payeeOutputs.test.ts +362 -356
  298. package/src/tools/schemas/outputs/__tests__/reconciliationOutputs.test.ts +402 -399
  299. package/src/tools/schemas/outputs/__tests__/transactionMutationSchemas.test.ts +225 -211
  300. package/src/tools/schemas/outputs/__tests__/transactionOutputs.test.ts +457 -454
  301. package/src/tools/schemas/outputs/__tests__/utilityOutputs.test.ts +316 -315
  302. package/src/tools/schemas/outputs/accountOutputs.ts +40 -34
  303. package/src/tools/schemas/outputs/budgetOutputs.ts +24 -19
  304. package/src/tools/schemas/outputs/categoryOutputs.ts +76 -56
  305. package/src/tools/schemas/outputs/comparisonOutputs.ts +192 -169
  306. package/src/tools/schemas/outputs/index.ts +163 -163
  307. package/src/tools/schemas/outputs/monthOutputs.ts +95 -80
  308. package/src/tools/schemas/outputs/payeeOutputs.ts +18 -18
  309. package/src/tools/schemas/outputs/reconciliationOutputs.ts +386 -373
  310. package/src/tools/schemas/outputs/transactionMutationOutputs.ts +259 -231
  311. package/src/tools/schemas/outputs/transactionOutputs.ts +81 -71
  312. package/src/tools/schemas/outputs/utilityOutputs.ts +90 -84
  313. package/src/tools/schemas/shared/commonOutputs.ts +27 -19
  314. package/src/tools/toolCategories.ts +114 -114
  315. package/src/tools/transactionReadTools.ts +327 -0
  316. package/src/tools/transactionSchemas.ts +322 -291
  317. package/src/tools/transactionTools.ts +84 -2246
  318. package/src/tools/transactionUtils.ts +507 -422
  319. package/src/tools/transactionWriteTools.ts +2110 -0
  320. package/src/tools/utilityTools.ts +46 -41
  321. package/src/types/CLAUDE.md +477 -0
  322. package/src/types/__tests__/index.test.ts +51 -51
  323. package/src/types/index.ts +43 -39
  324. package/src/types/integration-tests.d.ts +26 -26
  325. package/src/types/reconciliation.ts +29 -29
  326. package/src/types/toolAnnotations.ts +30 -30
  327. package/src/types/toolRegistration.ts +43 -32
  328. package/src/utils/CLAUDE.md +508 -0
  329. package/src/utils/__tests__/dateUtils.test.ts +174 -168
  330. package/src/utils/__tests__/money.test.ts +193 -187
  331. package/src/utils/amountUtils.ts +5 -5
  332. package/src/utils/baseError.ts +5 -5
  333. package/src/utils/dateUtils.ts +29 -26
  334. package/src/utils/errors.ts +14 -14
  335. package/src/utils/money.ts +66 -52
  336. package/src/utils/validationError.ts +1 -1
  337. package/tsconfig.json +29 -29
  338. package/tsconfig.prod.json +16 -16
  339. package/vitest-reporters/split-json-reporter.ts +247 -204
  340. package/vitest.config.ts +99 -95
  341. package/.prettierignore +0 -10
  342. package/.prettierrc.json +0 -10
  343. 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
  });