pigeongov 0.2.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 (571) hide show
  1. package/AGENTS.md +258 -0
  2. package/LICENSE +21 -0
  3. package/PRIVACY.md +38 -0
  4. package/README.md +234 -0
  5. package/agents.json +72 -0
  6. package/dist/bin/pigeongov.d.ts +2 -0
  7. package/dist/bin/pigeongov.js +4 -0
  8. package/dist/bin/pigeongov.js.map +1 -0
  9. package/dist/src/advisory/decision-support/contribution-optimizer.d.ts +36 -0
  10. package/dist/src/advisory/decision-support/contribution-optimizer.js +88 -0
  11. package/dist/src/advisory/decision-support/contribution-optimizer.js.map +1 -0
  12. package/dist/src/advisory/decision-support/deduction-optimizer.d.ts +31 -0
  13. package/dist/src/advisory/decision-support/deduction-optimizer.js +96 -0
  14. package/dist/src/advisory/decision-support/deduction-optimizer.js.map +1 -0
  15. package/dist/src/advisory/life-events/events.d.ts +4 -0
  16. package/dist/src/advisory/life-events/events.js +156 -0
  17. package/dist/src/advisory/life-events/events.js.map +1 -0
  18. package/dist/src/advisory/life-events/planner.d.ts +19 -0
  19. package/dist/src/advisory/life-events/planner.js +72 -0
  20. package/dist/src/advisory/life-events/planner.js.map +1 -0
  21. package/dist/src/advisory/screener/engine.d.ts +4 -0
  22. package/dist/src/advisory/screener/engine.js +368 -0
  23. package/dist/src/advisory/screener/engine.js.map +1 -0
  24. package/dist/src/advisory/screener/intake.d.ts +68 -0
  25. package/dist/src/advisory/screener/intake.js +93 -0
  26. package/dist/src/advisory/screener/intake.js.map +1 -0
  27. package/dist/src/analytics/stats.d.ts +18 -0
  28. package/dist/src/analytics/stats.js +158 -0
  29. package/dist/src/analytics/stats.js.map +1 -0
  30. package/dist/src/api/handlers/deadlines.d.ts +2 -0
  31. package/dist/src/api/handlers/deadlines.js +7 -0
  32. package/dist/src/api/handlers/deadlines.js.map +1 -0
  33. package/dist/src/api/handlers/openapi.d.ts +2 -0
  34. package/dist/src/api/handlers/openapi.js +7 -0
  35. package/dist/src/api/handlers/openapi.js.map +1 -0
  36. package/dist/src/api/handlers/workflows.d.ts +5 -0
  37. package/dist/src/api/handlers/workflows.js +73 -0
  38. package/dist/src/api/handlers/workflows.js.map +1 -0
  39. package/dist/src/api/index.d.ts +20 -0
  40. package/dist/src/api/index.js +70 -0
  41. package/dist/src/api/index.js.map +1 -0
  42. package/dist/src/api/openapi.d.ts +5 -0
  43. package/dist/src/api/openapi.js +384 -0
  44. package/dist/src/api/openapi.js.map +1 -0
  45. package/dist/src/api/router.d.ts +19 -0
  46. package/dist/src/api/router.js +57 -0
  47. package/dist/src/api/router.js.map +1 -0
  48. package/dist/src/cli/commands/completions.d.ts +2 -0
  49. package/dist/src/cli/commands/completions.js +396 -0
  50. package/dist/src/cli/commands/completions.js.map +1 -0
  51. package/dist/src/cli/commands/deadlines.d.ts +2 -0
  52. package/dist/src/cli/commands/deadlines.js +47 -0
  53. package/dist/src/cli/commands/deadlines.js.map +1 -0
  54. package/dist/src/cli/commands/doctor.d.ts +2 -0
  55. package/dist/src/cli/commands/doctor.js +50 -0
  56. package/dist/src/cli/commands/doctor.js.map +1 -0
  57. package/dist/src/cli/commands/drafts.d.ts +2 -0
  58. package/dist/src/cli/commands/drafts.js +75 -0
  59. package/dist/src/cli/commands/drafts.js.map +1 -0
  60. package/dist/src/cli/commands/extract.d.ts +2 -0
  61. package/dist/src/cli/commands/extract.js +17 -0
  62. package/dist/src/cli/commands/extract.js.map +1 -0
  63. package/dist/src/cli/commands/fees.d.ts +2 -0
  64. package/dist/src/cli/commands/fees.js +40 -0
  65. package/dist/src/cli/commands/fees.js.map +1 -0
  66. package/dist/src/cli/commands/fill.d.ts +25 -0
  67. package/dist/src/cli/commands/fill.js +354 -0
  68. package/dist/src/cli/commands/fill.js.map +1 -0
  69. package/dist/src/cli/commands/glossary.d.ts +2 -0
  70. package/dist/src/cli/commands/glossary.js +90 -0
  71. package/dist/src/cli/commands/glossary.js.map +1 -0
  72. package/dist/src/cli/commands/life-event.d.ts +2 -0
  73. package/dist/src/cli/commands/life-event.js +41 -0
  74. package/dist/src/cli/commands/life-event.js.map +1 -0
  75. package/dist/src/cli/commands/list.d.ts +2 -0
  76. package/dist/src/cli/commands/list.js +19 -0
  77. package/dist/src/cli/commands/list.js.map +1 -0
  78. package/dist/src/cli/commands/machine.d.ts +2 -0
  79. package/dist/src/cli/commands/machine.js +100 -0
  80. package/dist/src/cli/commands/machine.js.map +1 -0
  81. package/dist/src/cli/commands/merge.d.ts +2 -0
  82. package/dist/src/cli/commands/merge.js +24 -0
  83. package/dist/src/cli/commands/merge.js.map +1 -0
  84. package/dist/src/cli/commands/plugin.d.ts +2 -0
  85. package/dist/src/cli/commands/plugin.js +119 -0
  86. package/dist/src/cli/commands/plugin.js.map +1 -0
  87. package/dist/src/cli/commands/profile.d.ts +2 -0
  88. package/dist/src/cli/commands/profile.js +125 -0
  89. package/dist/src/cli/commands/profile.js.map +1 -0
  90. package/dist/src/cli/commands/review.d.ts +2 -0
  91. package/dist/src/cli/commands/review.js +25 -0
  92. package/dist/src/cli/commands/review.js.map +1 -0
  93. package/dist/src/cli/commands/scaffold.d.ts +2 -0
  94. package/dist/src/cli/commands/scaffold.js +304 -0
  95. package/dist/src/cli/commands/scaffold.js.map +1 -0
  96. package/dist/src/cli/commands/schemas.d.ts +2 -0
  97. package/dist/src/cli/commands/schemas.js +14 -0
  98. package/dist/src/cli/commands/schemas.js.map +1 -0
  99. package/dist/src/cli/commands/screen.d.ts +2 -0
  100. package/dist/src/cli/commands/screen.js +89 -0
  101. package/dist/src/cli/commands/screen.js.map +1 -0
  102. package/dist/src/cli/commands/serve.d.ts +2 -0
  103. package/dist/src/cli/commands/serve.js +46 -0
  104. package/dist/src/cli/commands/serve.js.map +1 -0
  105. package/dist/src/cli/commands/start.d.ts +2 -0
  106. package/dist/src/cli/commands/start.js +16 -0
  107. package/dist/src/cli/commands/start.js.map +1 -0
  108. package/dist/src/cli/commands/stats.d.ts +2 -0
  109. package/dist/src/cli/commands/stats.js +17 -0
  110. package/dist/src/cli/commands/stats.js.map +1 -0
  111. package/dist/src/cli/commands/testdata.d.ts +2 -0
  112. package/dist/src/cli/commands/testdata.js +60 -0
  113. package/dist/src/cli/commands/testdata.js.map +1 -0
  114. package/dist/src/cli/commands/tui.d.ts +2 -0
  115. package/dist/src/cli/commands/tui.js +26 -0
  116. package/dist/src/cli/commands/tui.js.map +1 -0
  117. package/dist/src/cli/commands/validate.d.ts +2 -0
  118. package/dist/src/cli/commands/validate.js +22 -0
  119. package/dist/src/cli/commands/validate.js.map +1 -0
  120. package/dist/src/cli/commands/vault.d.ts +2 -0
  121. package/dist/src/cli/commands/vault.js +73 -0
  122. package/dist/src/cli/commands/vault.js.map +1 -0
  123. package/dist/src/cli/commands/workflows.d.ts +2 -0
  124. package/dist/src/cli/commands/workflows.js +23 -0
  125. package/dist/src/cli/commands/workflows.js.map +1 -0
  126. package/dist/src/cli/display/review.d.ts +2 -0
  127. package/dist/src/cli/display/review.js +4 -0
  128. package/dist/src/cli/display/review.js.map +1 -0
  129. package/dist/src/cli/display/summary.d.ts +2 -0
  130. package/dist/src/cli/display/summary.js +19 -0
  131. package/dist/src/cli/display/summary.js.map +1 -0
  132. package/dist/src/cli/display/validation.d.ts +2 -0
  133. package/dist/src/cli/display/validation.js +16 -0
  134. package/dist/src/cli/display/validation.js.map +1 -0
  135. package/dist/src/cli/index.d.ts +1 -0
  136. package/dist/src/cli/index.js +83 -0
  137. package/dist/src/cli/index.js.map +1 -0
  138. package/dist/src/cli/output.d.ts +21 -0
  139. package/dist/src/cli/output.js +107 -0
  140. package/dist/src/cli/output.js.map +1 -0
  141. package/dist/src/cli/prompts/common.d.ts +21 -0
  142. package/dist/src/cli/prompts/common.js +53 -0
  143. package/dist/src/cli/prompts/common.js.map +1 -0
  144. package/dist/src/cli/prompts/credits.d.ts +3 -0
  145. package/dist/src/cli/prompts/credits.js +23 -0
  146. package/dist/src/cli/prompts/credits.js.map +1 -0
  147. package/dist/src/cli/prompts/deductions.d.ts +12 -0
  148. package/dist/src/cli/prompts/deductions.js +26 -0
  149. package/dist/src/cli/prompts/deductions.js.map +1 -0
  150. package/dist/src/cli/prompts/identity.d.ts +8 -0
  151. package/dist/src/cli/prompts/identity.js +36 -0
  152. package/dist/src/cli/prompts/identity.js.map +1 -0
  153. package/dist/src/cli/prompts/income.d.ts +15 -0
  154. package/dist/src/cli/prompts/income.js +61 -0
  155. package/dist/src/cli/prompts/income.js.map +1 -0
  156. package/dist/src/cli/prompts/workflow.d.ts +3 -0
  157. package/dist/src/cli/prompts/workflow.js +74 -0
  158. package/dist/src/cli/prompts/workflow.js.map +1 -0
  159. package/dist/src/cli/support.d.ts +53 -0
  160. package/dist/src/cli/support.js +80 -0
  161. package/dist/src/cli/support.js.map +1 -0
  162. package/dist/src/cli/tui.d.ts +22 -0
  163. package/dist/src/cli/tui.js +122 -0
  164. package/dist/src/cli/tui.js.map +1 -0
  165. package/dist/src/engine/audit-risk/scorer.d.ts +36 -0
  166. package/dist/src/engine/audit-risk/scorer.js +132 -0
  167. package/dist/src/engine/audit-risk/scorer.js.map +1 -0
  168. package/dist/src/engine/crypto/cost-basis.d.ts +19 -0
  169. package/dist/src/engine/crypto/cost-basis.js +115 -0
  170. package/dist/src/engine/crypto/cost-basis.js.map +1 -0
  171. package/dist/src/engine/crypto/transaction-parser.d.ts +36 -0
  172. package/dist/src/engine/crypto/transaction-parser.js +124 -0
  173. package/dist/src/engine/crypto/transaction-parser.js.map +1 -0
  174. package/dist/src/engine/crypto/wash-sale.d.ts +25 -0
  175. package/dist/src/engine/crypto/wash-sale.js +51 -0
  176. package/dist/src/engine/crypto/wash-sale.js.map +1 -0
  177. package/dist/src/engine/equity/espp.d.ts +41 -0
  178. package/dist/src/engine/equity/espp.js +90 -0
  179. package/dist/src/engine/equity/espp.js.map +1 -0
  180. package/dist/src/engine/equity/iso.d.ts +42 -0
  181. package/dist/src/engine/equity/iso.js +94 -0
  182. package/dist/src/engine/equity/iso.js.map +1 -0
  183. package/dist/src/engine/equity/nso.d.ts +35 -0
  184. package/dist/src/engine/equity/nso.js +63 -0
  185. package/dist/src/engine/equity/nso.js.map +1 -0
  186. package/dist/src/engine/equity/rsu.d.ts +33 -0
  187. package/dist/src/engine/equity/rsu.js +64 -0
  188. package/dist/src/engine/equity/rsu.js.map +1 -0
  189. package/dist/src/engine/field-mapper.d.ts +26 -0
  190. package/dist/src/engine/field-mapper.js +119 -0
  191. package/dist/src/engine/field-mapper.js.map +1 -0
  192. package/dist/src/engine/forms/core-1040.d.ts +2 -0
  193. package/dist/src/engine/forms/core-1040.js +124 -0
  194. package/dist/src/engine/forms/core-1040.js.map +1 -0
  195. package/dist/src/engine/forms/form-8949.d.ts +21 -0
  196. package/dist/src/engine/forms/form-8949.js +96 -0
  197. package/dist/src/engine/forms/form-8949.js.map +1 -0
  198. package/dist/src/engine/forms/index.d.ts +7 -0
  199. package/dist/src/engine/forms/index.js +6 -0
  200. package/dist/src/engine/forms/index.js.map +1 -0
  201. package/dist/src/engine/forms/schedule-b.d.ts +15 -0
  202. package/dist/src/engine/forms/schedule-b.js +78 -0
  203. package/dist/src/engine/forms/schedule-b.js.map +1 -0
  204. package/dist/src/engine/forms/schedule-d.d.ts +9 -0
  205. package/dist/src/engine/forms/schedule-d.js +86 -0
  206. package/dist/src/engine/forms/schedule-d.js.map +1 -0
  207. package/dist/src/engine/fpl.d.ts +70 -0
  208. package/dist/src/engine/fpl.js +127 -0
  209. package/dist/src/engine/fpl.js.map +1 -0
  210. package/dist/src/engine/gig/home-office.d.ts +34 -0
  211. package/dist/src/engine/gig/home-office.js +53 -0
  212. package/dist/src/engine/gig/home-office.js.map +1 -0
  213. package/dist/src/engine/gig/mileage.d.ts +30 -0
  214. package/dist/src/engine/gig/mileage.js +45 -0
  215. package/dist/src/engine/gig/mileage.js.map +1 -0
  216. package/dist/src/engine/gig/multi-1099.d.ts +19 -0
  217. package/dist/src/engine/gig/multi-1099.js +28 -0
  218. package/dist/src/engine/gig/multi-1099.js.map +1 -0
  219. package/dist/src/engine/multiyear/carryforward.d.ts +31 -0
  220. package/dist/src/engine/multiyear/carryforward.js +77 -0
  221. package/dist/src/engine/multiyear/carryforward.js.map +1 -0
  222. package/dist/src/engine/multiyear/compare.d.ts +25 -0
  223. package/dist/src/engine/multiyear/compare.js +94 -0
  224. package/dist/src/engine/multiyear/compare.js.map +1 -0
  225. package/dist/src/engine/multiyear/import.d.ts +23 -0
  226. package/dist/src/engine/multiyear/import.js +193 -0
  227. package/dist/src/engine/multiyear/import.js.map +1 -0
  228. package/dist/src/engine/optimizer/filing-status.d.ts +29 -0
  229. package/dist/src/engine/optimizer/filing-status.js +66 -0
  230. package/dist/src/engine/optimizer/filing-status.js.map +1 -0
  231. package/dist/src/engine/orchestrator.d.ts +14 -0
  232. package/dist/src/engine/orchestrator.js +135 -0
  233. package/dist/src/engine/orchestrator.js.map +1 -0
  234. package/dist/src/engine/scenarios/whatif.d.ts +34 -0
  235. package/dist/src/engine/scenarios/whatif.js +70 -0
  236. package/dist/src/engine/scenarios/whatif.js.map +1 -0
  237. package/dist/src/engine/state/ca/calculator.d.ts +3 -0
  238. package/dist/src/engine/state/ca/calculator.js +107 -0
  239. package/dist/src/engine/state/ca/calculator.js.map +1 -0
  240. package/dist/src/engine/state/common.d.ts +39 -0
  241. package/dist/src/engine/state/common.js +115 -0
  242. package/dist/src/engine/state/common.js.map +1 -0
  243. package/dist/src/engine/state/ga/calculator.d.ts +3 -0
  244. package/dist/src/engine/state/ga/calculator.js +82 -0
  245. package/dist/src/engine/state/ga/calculator.js.map +1 -0
  246. package/dist/src/engine/state/il/calculator.d.ts +3 -0
  247. package/dist/src/engine/state/il/calculator.js +49 -0
  248. package/dist/src/engine/state/il/calculator.js.map +1 -0
  249. package/dist/src/engine/state/mi/calculator.d.ts +3 -0
  250. package/dist/src/engine/state/mi/calculator.js +60 -0
  251. package/dist/src/engine/state/mi/calculator.js.map +1 -0
  252. package/dist/src/engine/state/nc/calculator.d.ts +3 -0
  253. package/dist/src/engine/state/nc/calculator.js +54 -0
  254. package/dist/src/engine/state/nc/calculator.js.map +1 -0
  255. package/dist/src/engine/state/nj/calculator.d.ts +3 -0
  256. package/dist/src/engine/state/nj/calculator.js +90 -0
  257. package/dist/src/engine/state/nj/calculator.js.map +1 -0
  258. package/dist/src/engine/state/ny/calculator.d.ts +3 -0
  259. package/dist/src/engine/state/ny/calculator.js +103 -0
  260. package/dist/src/engine/state/ny/calculator.js.map +1 -0
  261. package/dist/src/engine/state/oh/calculator.d.ts +3 -0
  262. package/dist/src/engine/state/oh/calculator.js +79 -0
  263. package/dist/src/engine/state/oh/calculator.js.map +1 -0
  264. package/dist/src/engine/state/pa/calculator.d.ts +3 -0
  265. package/dist/src/engine/state/pa/calculator.js +58 -0
  266. package/dist/src/engine/state/pa/calculator.js.map +1 -0
  267. package/dist/src/engine/state/registry.d.ts +9 -0
  268. package/dist/src/engine/state/registry.js +67 -0
  269. package/dist/src/engine/state/registry.js.map +1 -0
  270. package/dist/src/engine/state/types.d.ts +57 -0
  271. package/dist/src/engine/state/types.js +2 -0
  272. package/dist/src/engine/state/types.js.map +1 -0
  273. package/dist/src/engine/state/va/calculator.d.ts +3 -0
  274. package/dist/src/engine/state/va/calculator.js +76 -0
  275. package/dist/src/engine/state/va/calculator.js.map +1 -0
  276. package/dist/src/engine/suggestions/missed-deductions.d.ts +43 -0
  277. package/dist/src/engine/suggestions/missed-deductions.js +128 -0
  278. package/dist/src/engine/suggestions/missed-deductions.js.map +1 -0
  279. package/dist/src/engine/tax-calculator.d.ts +55 -0
  280. package/dist/src/engine/tax-calculator.js +156 -0
  281. package/dist/src/engine/tax-calculator.js.map +1 -0
  282. package/dist/src/engine/tax-constants-2025.d.ts +56 -0
  283. package/dist/src/engine/tax-constants-2025.js +138 -0
  284. package/dist/src/engine/tax-constants-2025.js.map +1 -0
  285. package/dist/src/engine/types.d.ts +77 -0
  286. package/dist/src/engine/types.js +2 -0
  287. package/dist/src/engine/types.js.map +1 -0
  288. package/dist/src/engine/va-math.d.ts +24 -0
  289. package/dist/src/engine/va-math.js +90 -0
  290. package/dist/src/engine/va-math.js.map +1 -0
  291. package/dist/src/engine/validator.d.ts +7 -0
  292. package/dist/src/engine/validator.js +108 -0
  293. package/dist/src/engine/validator.js.map +1 -0
  294. package/dist/src/glossary/entries/healthcare.d.ts +2 -0
  295. package/dist/src/glossary/entries/healthcare.js +78 -0
  296. package/dist/src/glossary/entries/healthcare.js.map +1 -0
  297. package/dist/src/glossary/entries/immigration.d.ts +2 -0
  298. package/dist/src/glossary/entries/immigration.js +112 -0
  299. package/dist/src/glossary/entries/immigration.js.map +1 -0
  300. package/dist/src/glossary/entries/tax.d.ts +2 -0
  301. package/dist/src/glossary/entries/tax.js +149 -0
  302. package/dist/src/glossary/entries/tax.js.map +1 -0
  303. package/dist/src/glossary/entries/unemployment.d.ts +2 -0
  304. package/dist/src/glossary/entries/unemployment.js +52 -0
  305. package/dist/src/glossary/entries/unemployment.js.map +1 -0
  306. package/dist/src/glossary/index.d.ts +19 -0
  307. package/dist/src/glossary/index.js +39 -0
  308. package/dist/src/glossary/index.js.map +1 -0
  309. package/dist/src/i18n/index.d.ts +21 -0
  310. package/dist/src/i18n/index.js +92 -0
  311. package/dist/src/i18n/index.js.map +1 -0
  312. package/dist/src/mcp/result.d.ts +3 -0
  313. package/dist/src/mcp/result.js +7 -0
  314. package/dist/src/mcp/result.js.map +1 -0
  315. package/dist/src/mcp/return-bundle.d.ts +19 -0
  316. package/dist/src/mcp/return-bundle.js +49 -0
  317. package/dist/src/mcp/return-bundle.js.map +1 -0
  318. package/dist/src/mcp/shared.d.ts +49102 -0
  319. package/dist/src/mcp/shared.js +354 -0
  320. package/dist/src/mcp/shared.js.map +1 -0
  321. package/dist/src/mcp/tools/build-packet.d.ts +7 -0
  322. package/dist/src/mcp/tools/build-packet.js +23 -0
  323. package/dist/src/mcp/tools/build-packet.js.map +1 -0
  324. package/dist/src/mcp/tools/calculate-tax.d.ts +40 -0
  325. package/dist/src/mcp/tools/calculate-tax.js +17 -0
  326. package/dist/src/mcp/tools/calculate-tax.js.map +1 -0
  327. package/dist/src/mcp/tools/deadlines.d.ts +7 -0
  328. package/dist/src/mcp/tools/deadlines.js +23 -0
  329. package/dist/src/mcp/tools/deadlines.js.map +1 -0
  330. package/dist/src/mcp/tools/describe-form.d.ts +14 -0
  331. package/dist/src/mcp/tools/describe-form.js +23 -0
  332. package/dist/src/mcp/tools/describe-form.js.map +1 -0
  333. package/dist/src/mcp/tools/describe-workflow.d.ts +6 -0
  334. package/dist/src/mcp/tools/describe-workflow.js +16 -0
  335. package/dist/src/mcp/tools/describe-workflow.js.map +1 -0
  336. package/dist/src/mcp/tools/explain-flag.d.ts +7 -0
  337. package/dist/src/mcp/tools/explain-flag.js +19 -0
  338. package/dist/src/mcp/tools/explain-flag.js.map +1 -0
  339. package/dist/src/mcp/tools/extract-document.d.ts +13 -0
  340. package/dist/src/mcp/tools/extract-document.js +20 -0
  341. package/dist/src/mcp/tools/extract-document.js.map +1 -0
  342. package/dist/src/mcp/tools/fees.d.ts +7 -0
  343. package/dist/src/mcp/tools/fees.js +24 -0
  344. package/dist/src/mcp/tools/fees.js.map +1 -0
  345. package/dist/src/mcp/tools/fill-form.d.ts +56 -0
  346. package/dist/src/mcp/tools/fill-form.js +47 -0
  347. package/dist/src/mcp/tools/fill-form.js.map +1 -0
  348. package/dist/src/mcp/tools/fill-workflow.d.ts +7 -0
  349. package/dist/src/mcp/tools/fill-workflow.js +24 -0
  350. package/dist/src/mcp/tools/fill-workflow.js.map +1 -0
  351. package/dist/src/mcp/tools/glossary.d.ts +8 -0
  352. package/dist/src/mcp/tools/glossary.js +54 -0
  353. package/dist/src/mcp/tools/glossary.js.map +1 -0
  354. package/dist/src/mcp/tools/list-forms.d.ts +6 -0
  355. package/dist/src/mcp/tools/list-forms.js +15 -0
  356. package/dist/src/mcp/tools/list-forms.js.map +1 -0
  357. package/dist/src/mcp/tools/list-workflows.d.ts +6 -0
  358. package/dist/src/mcp/tools/list-workflows.js +16 -0
  359. package/dist/src/mcp/tools/list-workflows.js.map +1 -0
  360. package/dist/src/mcp/tools/plan-life-event.d.ts +59 -0
  361. package/dist/src/mcp/tools/plan-life-event.js +41 -0
  362. package/dist/src/mcp/tools/plan-life-event.js.map +1 -0
  363. package/dist/src/mcp/tools/review-form.d.ts +40 -0
  364. package/dist/src/mcp/tools/review-form.js +26 -0
  365. package/dist/src/mcp/tools/review-form.js.map +1 -0
  366. package/dist/src/mcp/tools/review-workflow.d.ts +7 -0
  367. package/dist/src/mcp/tools/review-workflow.js +27 -0
  368. package/dist/src/mcp/tools/review-workflow.js.map +1 -0
  369. package/dist/src/mcp/tools/screen-eligibility.d.ts +53 -0
  370. package/dist/src/mcp/tools/screen-eligibility.js +44 -0
  371. package/dist/src/mcp/tools/screen-eligibility.js.map +1 -0
  372. package/dist/src/mcp/tools/start-workflow.d.ts +6 -0
  373. package/dist/src/mcp/tools/start-workflow.js +17 -0
  374. package/dist/src/mcp/tools/start-workflow.js.map +1 -0
  375. package/dist/src/mcp/tools/validate-form.d.ts +48 -0
  376. package/dist/src/mcp/tools/validate-form.js +30 -0
  377. package/dist/src/mcp/tools/validate-form.js.map +1 -0
  378. package/dist/src/mcp/tools/validate-workflow.d.ts +7 -0
  379. package/dist/src/mcp/tools/validate-workflow.js +24 -0
  380. package/dist/src/mcp/tools/validate-workflow.js.map +1 -0
  381. package/dist/src/pdf/batch.d.ts +8 -0
  382. package/dist/src/pdf/batch.js +15 -0
  383. package/dist/src/pdf/batch.js.map +1 -0
  384. package/dist/src/pdf/merge.d.ts +10 -0
  385. package/dist/src/pdf/merge.js +62 -0
  386. package/dist/src/pdf/merge.js.map +1 -0
  387. package/dist/src/pdf/ocr.d.ts +22 -0
  388. package/dist/src/pdf/ocr.js +52 -0
  389. package/dist/src/pdf/ocr.js.map +1 -0
  390. package/dist/src/pdf/reader.d.ts +2 -0
  391. package/dist/src/pdf/reader.js +354 -0
  392. package/dist/src/pdf/reader.js.map +1 -0
  393. package/dist/src/pdf/shared.d.ts +89 -0
  394. package/dist/src/pdf/shared.js +137 -0
  395. package/dist/src/pdf/shared.js.map +1 -0
  396. package/dist/src/pdf/writer.d.ts +7 -0
  397. package/dist/src/pdf/writer.js +311 -0
  398. package/dist/src/pdf/writer.js.map +1 -0
  399. package/dist/src/plugins/loader.d.ts +15 -0
  400. package/dist/src/plugins/loader.js +86 -0
  401. package/dist/src/plugins/loader.js.map +1 -0
  402. package/dist/src/plugins/sandbox.d.ts +14 -0
  403. package/dist/src/plugins/sandbox.js +88 -0
  404. package/dist/src/plugins/sandbox.js.map +1 -0
  405. package/dist/src/plugins/types.d.ts +17 -0
  406. package/dist/src/plugins/types.js +13 -0
  407. package/dist/src/plugins/types.js.map +1 -0
  408. package/dist/src/schemas/2025/f1040.d.ts +127 -0
  409. package/dist/src/schemas/2025/f1040.js +104 -0
  410. package/dist/src/schemas/2025/f1040.js.map +1 -0
  411. package/dist/src/schemas/2025/f1099-int.d.ts +53 -0
  412. package/dist/src/schemas/2025/f1099-int.js +51 -0
  413. package/dist/src/schemas/2025/f1099-int.js.map +1 -0
  414. package/dist/src/schemas/2025/f1099-nec.d.ts +47 -0
  415. package/dist/src/schemas/2025/f1099-nec.js +45 -0
  416. package/dist/src/schemas/2025/f1099-nec.js.map +1 -0
  417. package/dist/src/schemas/2025/form-8949.d.ts +46 -0
  418. package/dist/src/schemas/2025/form-8949.js +71 -0
  419. package/dist/src/schemas/2025/form-8949.js.map +1 -0
  420. package/dist/src/schemas/2025/index.d.ts +1004 -0
  421. package/dist/src/schemas/2025/index.js +60 -0
  422. package/dist/src/schemas/2025/index.js.map +1 -0
  423. package/dist/src/schemas/2025/schedule-1.d.ts +44 -0
  424. package/dist/src/schemas/2025/schedule-1.js +56 -0
  425. package/dist/src/schemas/2025/schedule-1.js.map +1 -0
  426. package/dist/src/schemas/2025/schedule-b.d.ts +32 -0
  427. package/dist/src/schemas/2025/schedule-b.js +53 -0
  428. package/dist/src/schemas/2025/schedule-b.js.map +1 -0
  429. package/dist/src/schemas/2025/schedule-c.d.ts +58 -0
  430. package/dist/src/schemas/2025/schedule-c.js +46 -0
  431. package/dist/src/schemas/2025/schedule-c.js.map +1 -0
  432. package/dist/src/schemas/2025/schedule-d.d.ts +36 -0
  433. package/dist/src/schemas/2025/schedule-d.js +52 -0
  434. package/dist/src/schemas/2025/schedule-d.js.map +1 -0
  435. package/dist/src/schemas/2025/shared.d.ts +98 -0
  436. package/dist/src/schemas/2025/shared.js +161 -0
  437. package/dist/src/schemas/2025/shared.js.map +1 -0
  438. package/dist/src/schemas/2025/w2.d.ts +57 -0
  439. package/dist/src/schemas/2025/w2.js +62 -0
  440. package/dist/src/schemas/2025/w2.js.map +1 -0
  441. package/dist/src/storage/drafts.d.ts +25 -0
  442. package/dist/src/storage/drafts.js +117 -0
  443. package/dist/src/storage/drafts.js.map +1 -0
  444. package/dist/src/storage/paths.d.ts +15 -0
  445. package/dist/src/storage/paths.js +33 -0
  446. package/dist/src/storage/paths.js.map +1 -0
  447. package/dist/src/storage/profile.d.ts +17 -0
  448. package/dist/src/storage/profile.js +59 -0
  449. package/dist/src/storage/profile.js.map +1 -0
  450. package/dist/src/storage/vault.d.ts +38 -0
  451. package/dist/src/storage/vault.js +187 -0
  452. package/dist/src/storage/vault.js.map +1 -0
  453. package/dist/src/testing/synthetic.d.ts +13 -0
  454. package/dist/src/testing/synthetic.js +164 -0
  455. package/dist/src/testing/synthetic.js.map +1 -0
  456. package/dist/src/types.d.ts +362 -0
  457. package/dist/src/types.js +2 -0
  458. package/dist/src/types.js.map +1 -0
  459. package/dist/src/workflows/deadlines.d.ts +13 -0
  460. package/dist/src/workflows/deadlines.js +88 -0
  461. package/dist/src/workflows/deadlines.js.map +1 -0
  462. package/dist/src/workflows/domains/benefits.d.ts +409 -0
  463. package/dist/src/workflows/domains/benefits.js +744 -0
  464. package/dist/src/workflows/domains/benefits.js.map +1 -0
  465. package/dist/src/workflows/domains/business.d.ts +65 -0
  466. package/dist/src/workflows/domains/business.js +76 -0
  467. package/dist/src/workflows/domains/business.js.map +1 -0
  468. package/dist/src/workflows/domains/education.d.ts +251 -0
  469. package/dist/src/workflows/domains/education.js +504 -0
  470. package/dist/src/workflows/domains/education.js.map +1 -0
  471. package/dist/src/workflows/domains/estate.d.ts +217 -0
  472. package/dist/src/workflows/domains/estate.js +407 -0
  473. package/dist/src/workflows/domains/estate.js.map +1 -0
  474. package/dist/src/workflows/domains/healthcare-ext.d.ts +88 -0
  475. package/dist/src/workflows/domains/healthcare-ext.js +150 -0
  476. package/dist/src/workflows/domains/healthcare-ext.js.map +1 -0
  477. package/dist/src/workflows/domains/healthcare.d.ts +92 -0
  478. package/dist/src/workflows/domains/healthcare.js +126 -0
  479. package/dist/src/workflows/domains/healthcare.js.map +1 -0
  480. package/dist/src/workflows/domains/identity-domain.d.ts +291 -0
  481. package/dist/src/workflows/domains/identity-domain.js +541 -0
  482. package/dist/src/workflows/domains/identity-domain.js.map +1 -0
  483. package/dist/src/workflows/domains/immigration-ext.d.ts +282 -0
  484. package/dist/src/workflows/domains/immigration-ext.js +590 -0
  485. package/dist/src/workflows/domains/immigration-ext.js.map +1 -0
  486. package/dist/src/workflows/domains/immigration.d.ts +121 -0
  487. package/dist/src/workflows/domains/immigration.js +152 -0
  488. package/dist/src/workflows/domains/immigration.js.map +1 -0
  489. package/dist/src/workflows/domains/legal.d.ts +235 -0
  490. package/dist/src/workflows/domains/legal.js +380 -0
  491. package/dist/src/workflows/domains/legal.js.map +1 -0
  492. package/dist/src/workflows/domains/permits.d.ts +65 -0
  493. package/dist/src/workflows/domains/permits.js +74 -0
  494. package/dist/src/workflows/domains/permits.js.map +1 -0
  495. package/dist/src/workflows/domains/retirement.d.ts +59 -0
  496. package/dist/src/workflows/domains/retirement.js +155 -0
  497. package/dist/src/workflows/domains/retirement.js.map +1 -0
  498. package/dist/src/workflows/domains/tax.d.ts +133 -0
  499. package/dist/src/workflows/domains/tax.js +187 -0
  500. package/dist/src/workflows/domains/tax.js.map +1 -0
  501. package/dist/src/workflows/domains/unemployment.d.ts +105 -0
  502. package/dist/src/workflows/domains/unemployment.js +122 -0
  503. package/dist/src/workflows/domains/unemployment.js.map +1 -0
  504. package/dist/src/workflows/domains/veterans.d.ts +189 -0
  505. package/dist/src/workflows/domains/veterans.js +380 -0
  506. package/dist/src/workflows/domains/veterans.js.map +1 -0
  507. package/dist/src/workflows/fees.d.ts +15 -0
  508. package/dist/src/workflows/fees.js +93 -0
  509. package/dist/src/workflows/fees.js.map +1 -0
  510. package/dist/src/workflows/helpers.d.ts +8 -0
  511. package/dist/src/workflows/helpers.js +66 -0
  512. package/dist/src/workflows/helpers.js.map +1 -0
  513. package/dist/src/workflows/io.d.ts +3 -0
  514. package/dist/src/workflows/io.js +38 -0
  515. package/dist/src/workflows/io.js.map +1 -0
  516. package/dist/src/workflows/registry.d.ts +51355 -0
  517. package/dist/src/workflows/registry.js +140 -0
  518. package/dist/src/workflows/registry.js.map +1 -0
  519. package/dist/src/workflows/schemas/benefits.d.ts +78 -0
  520. package/dist/src/workflows/schemas/benefits.js +91 -0
  521. package/dist/src/workflows/schemas/benefits.js.map +1 -0
  522. package/dist/src/workflows/schemas/common.d.ts +27 -0
  523. package/dist/src/workflows/schemas/common.js +28 -0
  524. package/dist/src/workflows/schemas/common.js.map +1 -0
  525. package/dist/src/workflows/schemas/education.d.ts +70 -0
  526. package/dist/src/workflows/schemas/education.js +85 -0
  527. package/dist/src/workflows/schemas/education.js.map +1 -0
  528. package/dist/src/workflows/schemas/estate.d.ts +64 -0
  529. package/dist/src/workflows/schemas/estate.js +85 -0
  530. package/dist/src/workflows/schemas/estate.js.map +1 -0
  531. package/dist/src/workflows/schemas/healthcare-ext.d.ts +15 -0
  532. package/dist/src/workflows/schemas/healthcare-ext.js +17 -0
  533. package/dist/src/workflows/schemas/healthcare-ext.js.map +1 -0
  534. package/dist/src/workflows/schemas/healthcare.d.ts +33 -0
  535. package/dist/src/workflows/schemas/healthcare.js +20 -0
  536. package/dist/src/workflows/schemas/healthcare.js.map +1 -0
  537. package/dist/src/workflows/schemas/identity-domain.d.ts +64 -0
  538. package/dist/src/workflows/schemas/identity-domain.js +87 -0
  539. package/dist/src/workflows/schemas/identity-domain.js.map +1 -0
  540. package/dist/src/workflows/schemas/immigration-ext.d.ts +63 -0
  541. package/dist/src/workflows/schemas/immigration-ext.js +58 -0
  542. package/dist/src/workflows/schemas/immigration-ext.js.map +1 -0
  543. package/dist/src/workflows/schemas/immigration.d.ts +48 -0
  544. package/dist/src/workflows/schemas/immigration.js +27 -0
  545. package/dist/src/workflows/schemas/immigration.js.map +1 -0
  546. package/dist/src/workflows/schemas/legal.d.ts +45 -0
  547. package/dist/src/workflows/schemas/legal.js +45 -0
  548. package/dist/src/workflows/schemas/legal.js.map +1 -0
  549. package/dist/src/workflows/schemas/planning.d.ts +23 -0
  550. package/dist/src/workflows/schemas/planning.js +15 -0
  551. package/dist/src/workflows/schemas/planning.js.map +1 -0
  552. package/dist/src/workflows/schemas/retirement.d.ts +14 -0
  553. package/dist/src/workflows/schemas/retirement.js +22 -0
  554. package/dist/src/workflows/schemas/retirement.js.map +1 -0
  555. package/dist/src/workflows/schemas/tax.d.ts +58 -0
  556. package/dist/src/workflows/schemas/tax.js +51 -0
  557. package/dist/src/workflows/schemas/tax.js.map +1 -0
  558. package/dist/src/workflows/schemas/unemployment.d.ts +33 -0
  559. package/dist/src/workflows/schemas/unemployment.js +19 -0
  560. package/dist/src/workflows/schemas/unemployment.js.map +1 -0
  561. package/dist/src/workflows/schemas/veterans.d.ts +47 -0
  562. package/dist/src/workflows/schemas/veterans.js +51 -0
  563. package/dist/src/workflows/schemas/veterans.js.map +1 -0
  564. package/dist/src/workflows/types.d.ts +9 -0
  565. package/dist/src/workflows/types.js +2 -0
  566. package/dist/src/workflows/types.js.map +1 -0
  567. package/dist/xmcp.config.d.ts +3 -0
  568. package/dist/xmcp.config.js +29 -0
  569. package/dist/xmcp.config.js.map +1 -0
  570. package/llms.txt +48 -0
  571. package/package.json +82 -0
@@ -0,0 +1,354 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { PDFParse } from "pdf-parse";
3
+ import { createFlag, extractMoneyNearLabel, extractTextNearLabel, firstMeaningfulLine, normalizePdfText, } from "./shared.js";
4
+ import { hasTesseract, ocrExtractText } from "./ocr.js";
5
+ function toBytes(source) {
6
+ if (typeof source === "string") {
7
+ throw new Error("String sources are treated as file paths by readPdfDocument; pass bytes to parse a string directly.");
8
+ }
9
+ if (source instanceof Uint8Array) {
10
+ return source;
11
+ }
12
+ return new Uint8Array(source);
13
+ }
14
+ async function loadSourceBytes(source) {
15
+ if (typeof source === "string") {
16
+ const result = {
17
+ bytes: new Uint8Array(await readFile(source)),
18
+ };
19
+ const fileName = source.split(/[\\/]/).at(-1);
20
+ if (fileName) {
21
+ result.fileName = fileName;
22
+ }
23
+ return result;
24
+ }
25
+ return { bytes: toBytes(source) };
26
+ }
27
+ function detectDocumentType(text, typeHint) {
28
+ const normalized = text.toLowerCase();
29
+ const reasons = [];
30
+ const scores = {
31
+ w2: 0,
32
+ "1099-nec": 0,
33
+ "1099-int": 0,
34
+ "1098": 0,
35
+ "1095-a": 0,
36
+ "1099-div": 0,
37
+ "1099-b": 0,
38
+ "1099-r": 0,
39
+ "k-1": 0,
40
+ };
41
+ if (normalized.includes("form w-2")) {
42
+ scores.w2 += 3;
43
+ reasons.push("matched Form W-2 heading");
44
+ }
45
+ if (normalized.includes("wages, tips, other compensation")) {
46
+ scores.w2 += 2;
47
+ reasons.push("matched W-2 wage label");
48
+ }
49
+ if (normalized.includes("social security wages")) {
50
+ scores.w2 += 1;
51
+ }
52
+ if (normalized.includes("form 1099-nec")) {
53
+ scores["1099-nec"] += 3;
54
+ reasons.push("matched Form 1099-NEC heading");
55
+ }
56
+ if (normalized.includes("nonemployee compensation")) {
57
+ scores["1099-nec"] += 2;
58
+ reasons.push("matched 1099-NEC compensation label");
59
+ }
60
+ if (normalized.includes("form 1099-int")) {
61
+ scores["1099-int"] += 3;
62
+ reasons.push("matched Form 1099-INT heading");
63
+ }
64
+ if (normalized.includes("interest income")) {
65
+ scores["1099-int"] += 2;
66
+ reasons.push("matched 1099-INT interest label");
67
+ }
68
+ // New document type scoring
69
+ if (normalized.includes("form 1098") || normalized.includes("mortgage interest statement")) {
70
+ scores["1098"] += 3;
71
+ reasons.push("matched Form 1098 heading");
72
+ }
73
+ if (normalized.includes("mortgage interest received")) {
74
+ scores["1098"] += 2;
75
+ }
76
+ if (normalized.includes("form 1095-a") || normalized.includes("health insurance marketplace")) {
77
+ scores["1095-a"] += 3;
78
+ reasons.push("matched Form 1095-A heading");
79
+ }
80
+ if (normalized.includes("monthly enrollment premiums")) {
81
+ scores["1095-a"] += 2;
82
+ }
83
+ if (normalized.includes("form 1099-div")) {
84
+ scores["1099-div"] += 3;
85
+ reasons.push("matched Form 1099-DIV heading");
86
+ }
87
+ if (normalized.includes("ordinary dividends") && normalized.includes("qualified dividends")) {
88
+ scores["1099-div"] += 2;
89
+ }
90
+ if (normalized.includes("form 1099-b") || normalized.includes("proceeds from broker")) {
91
+ scores["1099-b"] += 3;
92
+ reasons.push("matched Form 1099-B heading");
93
+ }
94
+ if (normalized.includes("cost or other basis") && normalized.includes("proceeds")) {
95
+ scores["1099-b"] += 2;
96
+ }
97
+ if (normalized.includes("form 1099-r")) {
98
+ scores["1099-r"] += 3;
99
+ reasons.push("matched Form 1099-R heading");
100
+ }
101
+ if (normalized.includes("gross distribution") && normalized.includes("taxable amount")) {
102
+ scores["1099-r"] += 2;
103
+ }
104
+ if (normalized.includes("schedule k-1") || normalized.includes("partner's share")) {
105
+ scores["k-1"] += 3;
106
+ reasons.push("matched Schedule K-1 heading");
107
+ }
108
+ if (normalized.includes("ordinary business income")) {
109
+ scores["k-1"] += 2;
110
+ }
111
+ if (typeHint) {
112
+ scores[typeHint] += 1.5;
113
+ reasons.push(`type hint: ${typeHint}`);
114
+ }
115
+ const entries = Object.entries(scores);
116
+ entries.sort((left, right) => right[1] - left[1]);
117
+ const [bestType, bestScore] = entries[0] ?? ["unknown", 0];
118
+ const secondScore = entries[1]?.[1] ?? 0;
119
+ const confidence = bestScore <= 0 ? 0 : Math.min(1, Math.max(0.35, (bestScore - secondScore + 1) / 4));
120
+ if (bestScore <= 0) {
121
+ return {
122
+ detectedType: typeHint ?? "unknown",
123
+ confidence: typeHint ? 0.45 : 0,
124
+ reasons,
125
+ };
126
+ }
127
+ return {
128
+ detectedType: bestType,
129
+ confidence,
130
+ reasons,
131
+ };
132
+ }
133
+ function normalizeSourceName(options, fallback) {
134
+ return options.fileName ?? fallback;
135
+ }
136
+ function buildW2Document(text) {
137
+ const lines = normalizePdfText(text).split("\n");
138
+ const employerName = firstMeaningfulLine(lines) ??
139
+ extractTextNearLabel(text, ["Employer's name", "Employer name", "Employer"]) ??
140
+ "";
141
+ const employeeName = extractTextNearLabel(text, ["Employee's first name and initial", "Employee name"]) ??
142
+ undefined;
143
+ const document = {
144
+ type: "w2",
145
+ employerName,
146
+ wages: extractMoneyNearLabel(text, [
147
+ "Wages, tips, other compensation",
148
+ "Box 1",
149
+ "1 Wages",
150
+ ]) ?? 0,
151
+ federalWithheld: extractMoneyNearLabel(text, [
152
+ "Federal income tax withheld",
153
+ "Box 2",
154
+ "2 Federal income tax withheld",
155
+ ]) ?? 0,
156
+ };
157
+ if (employeeName) {
158
+ document.employeeName = employeeName;
159
+ }
160
+ const employerEin = extractTextNearLabel(text, ["Employer identification number", "EIN"]);
161
+ if (employerEin) {
162
+ document.employerEin = employerEin;
163
+ }
164
+ const socialSecurityWages = extractMoneyNearLabel(text, ["Social security wages", "Box 3"]);
165
+ if (socialSecurityWages !== undefined) {
166
+ document.socialSecurityWages = socialSecurityWages;
167
+ }
168
+ const medicareWages = extractMoneyNearLabel(text, ["Medicare wages and tips", "Box 5"]);
169
+ if (medicareWages !== undefined) {
170
+ document.medicareWages = medicareWages;
171
+ }
172
+ return document;
173
+ }
174
+ function build1099NecDocument(text) {
175
+ const lines = normalizePdfText(text).split("\n");
176
+ const payerName = firstMeaningfulLine(lines) ??
177
+ extractTextNearLabel(text, ["Payer's name", "Payer name", "PAYER"]) ??
178
+ "";
179
+ const document = {
180
+ type: "1099-nec",
181
+ payerName,
182
+ nonemployeeCompensation: extractMoneyNearLabel(text, [
183
+ "Nonemployee compensation",
184
+ "Box 1",
185
+ "1 Nonemployee compensation",
186
+ ]) ?? 0,
187
+ };
188
+ const federalWithheld = extractMoneyNearLabel(text, [
189
+ "Federal income tax withheld",
190
+ "Box 4",
191
+ "4 Federal income tax withheld",
192
+ ]);
193
+ if (federalWithheld !== undefined) {
194
+ document.federalWithheld = federalWithheld;
195
+ }
196
+ return document;
197
+ }
198
+ function build1099IntDocument(text) {
199
+ const lines = normalizePdfText(text).split("\n");
200
+ const payerName = firstMeaningfulLine(lines) ??
201
+ extractTextNearLabel(text, ["Payer's name", "Payer name", "PAYER"]) ??
202
+ "";
203
+ const document = {
204
+ type: "1099-int",
205
+ payerName,
206
+ interestIncome: extractMoneyNearLabel(text, ["Interest income", "Box 1", "1 Interest income"]) ?? 0,
207
+ };
208
+ const federalWithheld = extractMoneyNearLabel(text, [
209
+ "Federal income tax withheld",
210
+ "Box 4",
211
+ "4 Federal income tax withheld",
212
+ ]);
213
+ if (federalWithheld !== undefined) {
214
+ document.federalWithheld = federalWithheld;
215
+ }
216
+ return document;
217
+ }
218
+ function buildFallbackDocument(detectedType) {
219
+ return {
220
+ type: "unknown",
221
+ };
222
+ }
223
+ export async function readPdfDocument(source, options = {}) {
224
+ const { bytes, fileName } = await loadSourceBytes(source);
225
+ const parser = new PDFParse({ data: bytes });
226
+ try {
227
+ const textResult = await parser.getText({
228
+ ...(options.pageNumbers ? { partial: options.pageNumbers } : {}),
229
+ pageJoiner: "\n",
230
+ itemJoiner: " ",
231
+ includeMarkedContent: false,
232
+ disableNormalization: false,
233
+ lineEnforce: true,
234
+ parseHyperlinks: false,
235
+ });
236
+ const textPages = textResult.pages.map((page) => ({
237
+ pageNumber: page.num,
238
+ text: normalizePdfText(page.text),
239
+ }));
240
+ let rawText = normalizePdfText(textResult.text);
241
+ let ocrUsed = false;
242
+ // If the native text layer is suspiciously short and Tesseract is
243
+ // available, fall back to OCR. This handles scanned PDFs that are
244
+ // essentially images with no embedded text.
245
+ const OCR_THRESHOLD = 50;
246
+ if (rawText.length < OCR_THRESHOLD && hasTesseract()) {
247
+ try {
248
+ const ocrText = await ocrExtractText(bytes);
249
+ if (ocrText.trim().length > rawText.length) {
250
+ rawText = normalizePdfText(ocrText);
251
+ ocrUsed = true;
252
+ }
253
+ }
254
+ catch {
255
+ // OCR failed — proceed with whatever text we managed to extract.
256
+ }
257
+ }
258
+ const detection = detectDocumentType(rawText, options.typeHint);
259
+ const sourceFileName = normalizeSourceName(options, fileName);
260
+ const flaggedFields = [];
261
+ if (options.typeHint && detection.detectedType !== options.typeHint) {
262
+ flaggedFields.push(createFlag("documentType", `Type hint ${options.typeHint} disagrees with heuristic detection of ${detection.detectedType}.`, "review", sourceFileName));
263
+ }
264
+ if (detection.detectedType === "w2") {
265
+ const document = buildW2Document(rawText);
266
+ if (!document.employerName) {
267
+ flaggedFields.push(createFlag("employerName", "Employer name was not confidently extracted.", "review", sourceFileName));
268
+ }
269
+ if (document.wages === 0) {
270
+ flaggedFields.push(createFlag("wages", "W-2 wages could not be confidently extracted.", "review", sourceFileName));
271
+ }
272
+ const result = {
273
+ detectedType: "w2",
274
+ confidence: detection.confidence,
275
+ pageCount: textResult.total,
276
+ rawText: options.includeRawText === false ? "" : rawText,
277
+ textPages,
278
+ flaggedFields,
279
+ document,
280
+ ocrUsed,
281
+ };
282
+ if (sourceFileName) {
283
+ result.sourceFileName = sourceFileName;
284
+ }
285
+ return result;
286
+ }
287
+ if (detection.detectedType === "1099-nec") {
288
+ const document = build1099NecDocument(rawText);
289
+ if (!document.payerName) {
290
+ flaggedFields.push(createFlag("payerName", "Payer name was not confidently extracted.", "review", sourceFileName));
291
+ }
292
+ if (document.nonemployeeCompensation === 0) {
293
+ flaggedFields.push(createFlag("nonemployeeCompensation", "1099-NEC compensation could not be confidently extracted.", "review", sourceFileName));
294
+ }
295
+ const result = {
296
+ detectedType: "1099-nec",
297
+ confidence: detection.confidence,
298
+ pageCount: textResult.total,
299
+ rawText: options.includeRawText === false ? "" : rawText,
300
+ textPages,
301
+ flaggedFields,
302
+ document,
303
+ ocrUsed,
304
+ };
305
+ if (sourceFileName) {
306
+ result.sourceFileName = sourceFileName;
307
+ }
308
+ return result;
309
+ }
310
+ if (detection.detectedType === "1099-int") {
311
+ const document = build1099IntDocument(rawText);
312
+ if (!document.payerName) {
313
+ flaggedFields.push(createFlag("payerName", "Payer name was not confidently extracted.", "review", sourceFileName));
314
+ }
315
+ if (document.interestIncome === 0) {
316
+ flaggedFields.push(createFlag("interestIncome", "1099-INT interest income could not be confidently extracted.", "review", sourceFileName));
317
+ }
318
+ const result = {
319
+ detectedType: "1099-int",
320
+ confidence: detection.confidence,
321
+ pageCount: textResult.total,
322
+ rawText: options.includeRawText === false ? "" : rawText,
323
+ textPages,
324
+ flaggedFields,
325
+ document,
326
+ ocrUsed,
327
+ };
328
+ if (sourceFileName) {
329
+ result.sourceFileName = sourceFileName;
330
+ }
331
+ return result;
332
+ }
333
+ const document = buildFallbackDocument(detection.detectedType);
334
+ flaggedFields.push(createFlag("documentType", "Could not confidently identify the PDF as a W-2 or 1099 form.", "review", sourceFileName));
335
+ const result = {
336
+ detectedType: "unknown",
337
+ confidence: detection.confidence,
338
+ pageCount: textResult.total,
339
+ rawText: options.includeRawText === false ? "" : rawText,
340
+ textPages,
341
+ flaggedFields,
342
+ document,
343
+ ocrUsed,
344
+ };
345
+ if (sourceFileName) {
346
+ result.sourceFileName = sourceFileName;
347
+ }
348
+ return result;
349
+ }
350
+ finally {
351
+ await parser.destroy();
352
+ }
353
+ }
354
+ //# sourceMappingURL=reader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/pdf/reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAQrC,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GAKjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAExD,SAAS,OAAO,CAAC,MAAiB;IAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,qGAAqG,CACtG,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,YAAY,UAAU,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,MAAiB;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAA6C;YACvD,KAAK,EAAE,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC9C,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,QAA8C;IAKtF,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAwD;QAClE,EAAE,EAAE,CAAC;QACL,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,iCAAiC,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAClD,CAAC;IAED,4BAA4B;IAC5B,IAAI,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;QAC3F,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;QAC9F,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC5F,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACtF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAClF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAEpC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAElD,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,GAAG,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEvG,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO;YACL,YAAY,EAAE,QAAQ,IAAI,SAAS;YACnC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,OAAO;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY,EAAE,QAAQ;QACtB,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAuB,EAAE,QAAiB;IACrE,OAAO,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,YAAY,GAChB,mBAAmB,CAAC,KAAK,CAAC;QAC1B,oBAAoB,CAAC,IAAI,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAC5E,EAAE,CAAC;IACL,MAAM,YAAY,GAChB,oBAAoB,CAAC,IAAI,EAAE,CAAC,mCAAmC,EAAE,eAAe,CAAC,CAAC;QAClF,SAAS,CAAC;IAEZ,MAAM,QAAQ,GAAyC;QACrD,IAAI,EAAE,IAAI;QACV,YAAY;QACZ,KAAK,EAAE,qBAAqB,CAAC,IAAI,EAAE;YACjC,iCAAiC;YACjC,OAAO;YACP,SAAS;SACV,CAAC,IAAI,CAAC;QACP,eAAe,EACb,qBAAqB,CAAC,IAAI,EAAE;YAC1B,6BAA6B;YAC7B,OAAO;YACP,+BAA+B;SAChC,CAAC,IAAI,CAAC;KACV,CAAC;IAEF,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;IACvC,CAAC;IAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,EAAE,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1F,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;IACrC,CAAC;IAED,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,IAAI,EAAE,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5F,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,QAAQ,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IACrD,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,EAAE,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC,CAAC;IACxF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC;IACzC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,SAAS,GACb,mBAAmB,CAAC,KAAK,CAAC;QAC1B,oBAAoB,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACnE,EAAE,CAAC;IAEL,MAAM,QAAQ,GAAwD;QACpE,IAAI,EAAE,UAAU;QAChB,SAAS;QACT,uBAAuB,EACrB,qBAAqB,CAAC,IAAI,EAAE;YAC1B,0BAA0B;YAC1B,OAAO;YACP,4BAA4B;SAC7B,CAAC,IAAI,CAAC;KACV,CAAC;IAEF,MAAM,eAAe,GAAG,qBAAqB,CAAC,IAAI,EAAE;QAClD,6BAA6B;QAC7B,OAAO;QACP,+BAA+B;KAChC,CAAC,CAAC;IACH,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,eAAe,GAAG,eAAe,CAAC;IAC7C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,SAAS,GACb,mBAAmB,CAAC,KAAK,CAAC;QAC1B,oBAAoB,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACnE,EAAE,CAAC;IAEL,MAAM,QAAQ,GAAwD;QACpE,IAAI,EAAE,UAAU;QAChB,SAAS;QACT,cAAc,EACZ,qBAAqB,CAAC,IAAI,EAAE,CAAC,iBAAiB,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,IAAI,CAAC;KACtF,CAAC;IAEF,MAAM,eAAe,GAAG,qBAAqB,CAAC,IAAI,EAAE;QAClD,6BAA6B;QAC7B,OAAO;QACP,+BAA+B;KAChC,CAAC,CAAC;IACH,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,eAAe,GAAG,eAAe,CAAC;IAC7C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,qBAAqB,CAAC,YAA6B;IAC1D,OAAO;QACL,IAAI,EAAE,SAAS;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAiB,EACjB,UAA0B,EAAE;IAE5B,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YACtC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,GAAG;YACf,oBAAoB,EAAE,KAAK;YAC3B,oBAAoB,EAAE,KAAK;YAC3B,WAAW,EAAE,IAAI;YACjB,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChD,UAAU,EAAE,IAAI,CAAC,GAAG;YACpB,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC,CAAC;QACJ,IAAI,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,kEAAkE;QAClE,kEAAkE;QAClE,4CAA4C;QAC5C,MAAM,aAAa,GAAG,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa,IAAI,YAAY,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC3C,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBACpC,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAqB,EAAE,CAAC;QAE3C,IAAI,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,YAAY,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;YACpE,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,cAAc,EACd,aAAa,OAAO,CAAC,QAAQ,0CAA0C,SAAS,CAAC,YAAY,GAAG,EAChG,QAAQ,EACR,cAAc,CACf,CACF,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC3B,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,cAAc,EACd,8CAA8C,EAC9C,QAAQ,EACR,cAAc,CACf,CACF,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;gBACzB,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,OAAO,EACP,+CAA+C,EAC/C,QAAQ,EACR,cAAc,CACf,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAkB;gBAC5B,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,SAAS,EAAE,UAAU,CAAC,KAAK;gBAC3B,OAAO,EAAE,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;gBACxD,SAAS;gBACT,aAAa;gBACb,QAAQ;gBACR,OAAO;aACR,CAAC;YACF,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;YACzC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,SAAS,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACxB,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,WAAW,EACX,2CAA2C,EAC3C,QAAQ,EACR,cAAc,CACf,CACF,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,uBAAuB,KAAK,CAAC,EAAE,CAAC;gBAC3C,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,yBAAyB,EACzB,2DAA2D,EAC3D,QAAQ,EACR,cAAc,CACf,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAkB;gBAC5B,YAAY,EAAE,UAAU;gBACxB,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,SAAS,EAAE,UAAU,CAAC,KAAK;gBAC3B,OAAO,EAAE,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;gBACxD,SAAS;gBACT,aAAa;gBACb,QAAQ;gBACR,OAAO;aACR,CAAC;YACF,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;YACzC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,SAAS,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACxB,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,WAAW,EACX,2CAA2C,EAC3C,QAAQ,EACR,cAAc,CACf,CACF,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;gBAClC,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,gBAAgB,EAChB,8DAA8D,EAC9D,QAAQ,EACR,cAAc,CACf,CACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAkB;gBAC5B,YAAY,EAAE,UAAU;gBACxB,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,SAAS,EAAE,UAAU,CAAC,KAAK;gBAC3B,OAAO,EAAE,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;gBACxD,SAAS;gBACT,aAAa;gBACb,QAAQ;gBACR,OAAO;aACR,CAAC;YACF,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;YACzC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC/D,aAAa,CAAC,IAAI,CAChB,UAAU,CACR,cAAc,EACd,+DAA+D,EAC/D,QAAQ,EACR,cAAc,CACf,CACF,CAAC;QAEF,MAAM,MAAM,GAAkB;YAC5B,YAAY,EAAE,SAAS;YACvB,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,SAAS,EAAE,UAAU,CAAC,KAAK;YAC3B,OAAO,EAAE,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;YACxD,SAAS;YACT,aAAa;YACb,QAAQ;YACR,OAAO;SACR,CAAC;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}
@@ -0,0 +1,89 @@
1
+ import type { Form1099IntDocument, Form1099NecDocument, ImportedDocument, ReviewSummary, ValidationFlag, W2Document } from "../types.js";
2
+ export type PdfDocumentKind = ImportedDocument["type"] | "unknown";
3
+ export type PdfSource = string | Uint8Array | ArrayBuffer | Buffer;
4
+ export interface PdfReadOptions {
5
+ fileName?: string;
6
+ password?: string;
7
+ typeHint?: Exclude<PdfDocumentKind, "unknown">;
8
+ pageNumbers?: number[];
9
+ includeRawText?: boolean;
10
+ }
11
+ export interface PdfTextPage {
12
+ pageNumber: number;
13
+ text: string;
14
+ }
15
+ export interface PdfReadResultBase {
16
+ detectedType: PdfDocumentKind;
17
+ confidence: number;
18
+ pageCount: number;
19
+ rawText: string;
20
+ textPages: PdfTextPage[];
21
+ flaggedFields: ValidationFlag[];
22
+ sourceFileName?: string;
23
+ ocrUsed?: boolean;
24
+ }
25
+ export type PdfReadResult = (PdfReadResultBase & {
26
+ detectedType: "w2";
27
+ document: Partial<W2Document> & {
28
+ type: "w2";
29
+ };
30
+ }) | (PdfReadResultBase & {
31
+ detectedType: "1099-nec";
32
+ document: Partial<Form1099NecDocument> & {
33
+ type: "1099-nec";
34
+ };
35
+ }) | (PdfReadResultBase & {
36
+ detectedType: "1099-int";
37
+ document: Partial<Form1099IntDocument> & {
38
+ type: "1099-int";
39
+ };
40
+ }) | (PdfReadResultBase & {
41
+ detectedType: "unknown";
42
+ document: {
43
+ type: "unknown";
44
+ };
45
+ });
46
+ export interface PdfReviewSectionItem {
47
+ label: string;
48
+ value: string;
49
+ severity?: ValidationFlag["severity"];
50
+ }
51
+ export interface PdfReviewSection {
52
+ title: string;
53
+ items: PdfReviewSectionItem[];
54
+ }
55
+ export interface PdfReviewInput extends ReviewSummary {
56
+ title: string;
57
+ subtitle?: string;
58
+ sections?: PdfReviewSection[];
59
+ footer?: string[];
60
+ }
61
+ export interface PdfTemplateFieldValue {
62
+ name: string;
63
+ value: string | number | boolean | null | undefined;
64
+ kind?: "text" | "checkbox" | "radio";
65
+ }
66
+ export interface PdfTemplateFillInput {
67
+ template: PdfSource;
68
+ fields: PdfTemplateFieldValue[];
69
+ flatten?: boolean;
70
+ title?: string;
71
+ subject?: string;
72
+ author?: string;
73
+ }
74
+ export interface PdfWriteResult {
75
+ pdfBytes: Uint8Array;
76
+ flaggedFields: ValidationFlag[];
77
+ appliedFields: number;
78
+ }
79
+ export declare function formatCurrency(value: number): string;
80
+ export declare function normalizePdfText(text: string): string;
81
+ export declare function compactTextLines(text: string): string[];
82
+ export declare function parseMoney(text: string | undefined): number | undefined;
83
+ export declare function formatTemplateValue(value: string | number | boolean | null | undefined): string;
84
+ export declare function escapeRegex(value: string): string;
85
+ export declare function findLineIndex(lines: string[], label: string): number;
86
+ export declare function extractMoneyNearLabel(text: string, labels: string[]): number | undefined;
87
+ export declare function extractTextNearLabel(text: string, labels: string[]): string | undefined;
88
+ export declare function firstMeaningfulLine(lines: string[]): string | undefined;
89
+ export declare function createFlag(field: string, message: string, severity?: ValidationFlag["severity"], source?: string): ValidationFlag;
@@ -0,0 +1,137 @@
1
+ const currencyFormatter = new Intl.NumberFormat("en-US", {
2
+ style: "currency",
3
+ currency: "USD",
4
+ maximumFractionDigits: 2,
5
+ });
6
+ export function formatCurrency(value) {
7
+ return currencyFormatter.format(value);
8
+ }
9
+ export function normalizePdfText(text) {
10
+ return text
11
+ .replace(/\r\n/g, "\n")
12
+ .replace(/\r/g, "\n")
13
+ .replace(/\u00a0/g, " ")
14
+ .replace(/[ \t]+/g, " ")
15
+ .replace(/\n[ \t]+/g, "\n")
16
+ .replace(/[ \t]+\n/g, "\n")
17
+ .trim();
18
+ }
19
+ export function compactTextLines(text) {
20
+ return normalizePdfText(text)
21
+ .split("\n")
22
+ .map((line) => line.trim())
23
+ .filter(Boolean);
24
+ }
25
+ export function parseMoney(text) {
26
+ if (!text) {
27
+ return undefined;
28
+ }
29
+ const normalized = text
30
+ .replace(/[\s,$]/g, "")
31
+ .replace(/[^\d().-]/g, "");
32
+ if (!normalized) {
33
+ return undefined;
34
+ }
35
+ const isNegative = normalized.startsWith("(") && normalized.endsWith(")");
36
+ const stripped = normalized.replace(/[()]/g, "");
37
+ const parsed = Number.parseFloat(stripped);
38
+ if (Number.isNaN(parsed)) {
39
+ return undefined;
40
+ }
41
+ return isNegative ? -parsed : parsed;
42
+ }
43
+ export function formatTemplateValue(value) {
44
+ if (value === null || value === undefined) {
45
+ return "";
46
+ }
47
+ if (typeof value === "boolean") {
48
+ return value ? "Yes" : "No";
49
+ }
50
+ if (typeof value === "number") {
51
+ if (Number.isInteger(value)) {
52
+ return String(value);
53
+ }
54
+ return value.toFixed(2).replace(/\.00$/, "");
55
+ }
56
+ return value;
57
+ }
58
+ export function escapeRegex(value) {
59
+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
60
+ }
61
+ export function findLineIndex(lines, label) {
62
+ const lowerLabel = label.toLowerCase();
63
+ return lines.findIndex((line) => line.toLowerCase().includes(lowerLabel));
64
+ }
65
+ export function extractMoneyNearLabel(text, labels) {
66
+ const lines = compactTextLines(text);
67
+ for (const label of labels) {
68
+ const lowerLabel = label.toLowerCase();
69
+ for (let index = 0; index < lines.length; index += 1) {
70
+ const line = lines[index];
71
+ if (!line) {
72
+ continue;
73
+ }
74
+ if (!line.toLowerCase().includes(lowerLabel)) {
75
+ continue;
76
+ }
77
+ const sameLineMatch = line.match(/\(?-?\$?\d[\d,]*(?:\.\d{2})?\)?/g);
78
+ const nextLine = lines[index + 1];
79
+ const nextLineMatch = nextLine?.match(/\(?-?\$?\d[\d,]*(?:\.\d{2})?\)?/g);
80
+ const token = sameLineMatch?.at(-1) ?? nextLineMatch?.at(-1);
81
+ const parsed = parseMoney(token);
82
+ if (parsed !== undefined) {
83
+ return parsed;
84
+ }
85
+ }
86
+ }
87
+ return undefined;
88
+ }
89
+ export function extractTextNearLabel(text, labels) {
90
+ const lines = compactTextLines(text);
91
+ for (const label of labels) {
92
+ const lowerLabel = label.toLowerCase();
93
+ for (let index = 0; index < lines.length; index += 1) {
94
+ const line = lines[index];
95
+ if (!line) {
96
+ continue;
97
+ }
98
+ if (!line.toLowerCase().includes(lowerLabel)) {
99
+ continue;
100
+ }
101
+ const tail = line
102
+ .slice(line.toLowerCase().indexOf(lowerLabel) + label.length)
103
+ .trim();
104
+ if (tail) {
105
+ return tail;
106
+ }
107
+ const nextLine = lines[index + 1];
108
+ if (nextLine) {
109
+ return nextLine;
110
+ }
111
+ }
112
+ }
113
+ return undefined;
114
+ }
115
+ export function firstMeaningfulLine(lines) {
116
+ return lines.find((line) => {
117
+ const lower = line.toLowerCase();
118
+ return (line.length > 1 &&
119
+ !lower.includes("form ") &&
120
+ !lower.includes("department of the treasury") &&
121
+ !lower.includes("internal revenue service") &&
122
+ !lower.includes("omb no.") &&
123
+ !lower.includes("social security number"));
124
+ });
125
+ }
126
+ export function createFlag(field, message, severity = "review", source) {
127
+ const flag = {
128
+ field,
129
+ severity,
130
+ message,
131
+ };
132
+ if (source) {
133
+ flag.source = source;
134
+ }
135
+ return flag;
136
+ }
137
+ //# sourceMappingURL=shared.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/pdf/shared.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { ReviewSummary, ValidationFlag } from "../types.js";
2
+ import { type PdfReviewInput, type PdfReviewSection, type PdfTemplateFillInput, type PdfWriteResult } from "./shared.js";
3
+ export declare function createReviewPdf(input: PdfReviewInput): Promise<Uint8Array>;
4
+ export declare function fillPdfTemplate(input: PdfTemplateFillInput): Promise<PdfWriteResult>;
5
+ export declare function summarizeReviewSections(review: ReviewSummary): PdfReviewSection[];
6
+ export declare function buildReviewFooter(flaggedFields: ValidationFlag[]): string[];
7
+ export declare function splitLongText(text: string): string[];