@managesome/eposmatic-toolkit 0.4.8 → 0.4.10

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 (336) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +448 -0
  2. package/esm/constants/enums/communications.js +1 -0
  3. package/esm/helpers/index.js +3 -0
  4. package/esm/helpers/materialized-reports/index.js +32 -0
  5. package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
  6. package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +286 -0
  7. package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
  8. package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +244 -0
  9. package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
  10. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +426 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +372 -0
  12. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +214 -0
  13. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +318 -0
  14. package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
  15. package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
  16. package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
  17. package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
  18. package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
  19. package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +111 -0
  20. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +88 -0
  21. package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
  22. package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
  23. package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
  24. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +476 -0
  25. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
  26. package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +7 -0
  27. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
  28. package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +157 -0
  29. package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
  30. package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
  31. package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +156 -0
  32. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
  33. package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
  34. package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +237 -0
  35. package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +279 -0
  36. package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
  37. package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +343 -0
  38. package/esm/helpers/reporting-contract/index.js +2 -0
  39. package/esm/helpers/reporting-contract/overview-contract.js +122 -0
  40. package/esm/helpers/reporting-contract/report-contract.js +228 -0
  41. package/esm/helpers/rider-earnings/index.js +1 -0
  42. package/esm/helpers/rider-earnings/rider-earnings.js +59 -0
  43. package/esm/helpers/rider-reports/index.js +2 -0
  44. package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
  45. package/esm/helpers/rider-reports/rider-report.js +67 -0
  46. package/esm/schemas/models/deliveries.js +75 -0
  47. package/esm/schemas/models/index.js +15 -0
  48. package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
  49. package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
  50. package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
  51. package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
  52. package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
  53. package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
  54. package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
  55. package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
  56. package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
  57. package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
  58. package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
  59. package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
  60. package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
  61. package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
  62. package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
  63. package/esm/schemas/types/index.js +15 -0
  64. package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
  65. package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
  66. package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
  67. package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
  68. package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
  69. package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
  70. package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
  71. package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
  72. package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
  73. package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
  74. package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
  75. package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
  76. package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
  77. package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
  78. package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
  79. package/lib/constants/MATERIALIZED_REPORTS.d.ts +339 -2
  80. package/lib/constants/MATERIALIZED_REPORTS.js +450 -1
  81. package/lib/constants/enums/communications.d.ts +1 -0
  82. package/lib/constants/enums/communications.js +2 -1
  83. package/lib/helpers/index.d.ts +3 -0
  84. package/lib/helpers/index.js +3 -0
  85. package/lib/helpers/materialized-reports/index.d.ts +32 -0
  86. package/lib/helpers/materialized-reports/index.js +32 -0
  87. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
  88. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
  89. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +90 -0
  90. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +295 -0
  91. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +102 -0
  92. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
  93. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +72 -0
  94. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +251 -0
  95. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
  96. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
  97. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +84 -0
  98. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +438 -0
  99. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +97 -0
  100. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +385 -0
  101. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +40 -0
  102. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +218 -0
  103. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
  104. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +324 -0
  105. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
  106. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
  107. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
  108. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
  109. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
  110. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
  111. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
  112. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
  113. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
  114. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
  115. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
  116. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +116 -0
  117. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
  118. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +98 -0
  119. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
  120. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
  121. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
  122. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
  123. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +66 -0
  124. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
  125. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +128 -0
  126. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +490 -0
  127. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +46 -0
  128. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
  129. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
  130. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +8 -1
  131. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
  132. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
  133. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
  134. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +161 -0
  135. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
  136. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
  137. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
  138. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
  139. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
  140. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +159 -0
  141. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
  142. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
  143. package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
  144. package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
  145. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
  146. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +243 -0
  147. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
  148. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +286 -0
  149. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +97 -0
  150. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
  151. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
  152. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +349 -0
  153. package/lib/helpers/reporting-contract/index.d.ts +2 -0
  154. package/lib/helpers/reporting-contract/index.js +18 -0
  155. package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
  156. package/lib/helpers/reporting-contract/overview-contract.js +126 -0
  157. package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
  158. package/lib/helpers/reporting-contract/report-contract.js +239 -0
  159. package/lib/helpers/rider-earnings/index.d.ts +1 -0
  160. package/lib/helpers/rider-earnings/index.js +17 -0
  161. package/lib/helpers/rider-earnings/rider-earnings.d.ts +58 -0
  162. package/lib/helpers/rider-earnings/rider-earnings.js +64 -0
  163. package/lib/helpers/rider-reports/index.d.ts +2 -0
  164. package/lib/helpers/rider-reports/index.js +18 -0
  165. package/lib/helpers/rider-reports/rider-daily-report.d.ts +26 -0
  166. package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
  167. package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
  168. package/lib/helpers/rider-reports/rider-report.js +70 -0
  169. package/lib/helpers/types/materialized-reports-apis.d.ts +297 -1
  170. package/lib/schemas/models/deliveries.d.ts +54 -0
  171. package/lib/schemas/models/deliveries.js +75 -0
  172. package/lib/schemas/models/expense_details.d.ts +3 -3
  173. package/lib/schemas/models/index.d.ts +15 -0
  174. package/lib/schemas/models/index.js +15 -0
  175. package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
  176. package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
  177. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
  178. package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
  179. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
  180. package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
  181. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
  182. package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
  183. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
  184. package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
  185. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
  186. package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
  187. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
  188. package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
  189. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
  190. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
  191. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
  192. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
  193. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
  194. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
  195. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
  196. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
  197. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
  198. package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
  199. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
  200. package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
  201. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
  202. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
  203. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
  204. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
  205. package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
  206. package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
  207. package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
  208. package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
  209. package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
  210. package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
  211. package/lib/schemas/types/deliveries.d.ts +40 -1
  212. package/lib/schemas/types/index.d.ts +15 -0
  213. package/lib/schemas/types/index.js +15 -0
  214. package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
  215. package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
  216. package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
  217. package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
  218. package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
  219. package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
  220. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
  221. package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
  222. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
  223. package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
  224. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
  225. package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
  226. package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
  227. package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
  228. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
  229. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
  230. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
  231. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
  232. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
  233. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
  234. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
  235. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
  236. package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
  237. package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
  238. package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
  239. package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
  240. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
  241. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
  242. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
  243. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
  244. package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
  245. package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
  246. package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
  247. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  248. package/lib/tests/materialized-reports/fixtures.js +1 -0
  249. package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
  250. package/lib/tests/materialized-reports/materialized-cash-compile.test.js +196 -0
  251. package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
  252. package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
  253. package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
  254. package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +152 -0
  255. package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
  256. package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
  257. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
  258. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
  259. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
  260. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
  261. package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
  262. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +241 -0
  263. package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
  264. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
  265. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
  266. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +141 -0
  267. package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
  268. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
  269. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
  270. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
  271. package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
  272. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
  273. package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
  274. package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
  275. package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
  276. package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
  277. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
  278. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
  279. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
  280. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
  281. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
  282. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
  283. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
  284. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
  285. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
  286. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
  287. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
  288. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
  289. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
  290. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
  291. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
  292. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
  293. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
  294. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
  295. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
  296. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
  297. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
  298. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +270 -0
  299. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
  300. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
  301. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
  302. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
  303. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
  304. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
  305. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
  306. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
  307. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
  308. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +206 -0
  309. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
  310. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
  311. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
  312. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
  313. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
  314. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
  315. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
  316. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
  317. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
  318. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
  319. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
  320. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
  321. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
  322. package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
  323. package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
  324. package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
  325. package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
  326. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
  327. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
  328. package/lib/tests/reporting-contract.test.d.ts +1 -0
  329. package/lib/tests/reporting-contract.test.js +267 -0
  330. package/lib/tests/rider-daily-report.test.d.ts +1 -0
  331. package/lib/tests/rider-daily-report.test.js +86 -0
  332. package/lib/tests/rider-earnings.test.d.ts +1 -0
  333. package/lib/tests/rider-earnings.test.js +65 -0
  334. package/lib/tests/rider-report.test.d.ts +1 -0
  335. package/lib/tests/rider-report.test.js +98 -0
  336. package/package.json +10 -1
@@ -0,0 +1,116 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const materialized_cash_classification_helpers_1 = require("../../helpers/materialized-reports/materialized-cash-classification-helpers");
4
+ const materialized_cash_accumulator_helpers_1 = require("../../helpers/materialized-reports/materialized-cash-accumulator-helpers");
5
+ /**
6
+ * M3 period folding.
7
+ *
8
+ * The load-bearing case is `staff_count`: it is a DISTINCT count, so a period must
9
+ * UNION the day rosters. Summing them is the obvious implementation and it is wrong -
10
+ * anyone who worked both days gets counted twice, inflating the headcount the page
11
+ * shows. That is the same class of error as summing a minimum in the prep time
12
+ * report, and it is invisible unless a test deliberately shares a staff member across
13
+ * two days.
14
+ */
15
+ /** Builds a day block directly, so the test states its own inputs. */
16
+ function day(over = {}) {
17
+ return { ...baseDay(), ...over };
18
+ }
19
+ function baseDay() {
20
+ const counters = (0, materialized_cash_classification_helpers_1.freshCashCounters)();
21
+ return counters;
22
+ }
23
+ describe('M3 period fold', () => {
24
+ it('UNIONS staff rosters instead of summing the counts', () => {
25
+ const monday = baseDay();
26
+ monday.movements.staff_ids = ['staff-a', 'staff-b'];
27
+ monday.movements.staff_count = 2;
28
+ const tuesday = baseDay();
29
+ // staff-b worked BOTH days - the double-count trap.
30
+ tuesday.movements.staff_ids = ['staff-b', 'staff-c'];
31
+ tuesday.movements.staff_count = 2;
32
+ const folded = (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(baseDay(), monday);
33
+ (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(folded, tuesday);
34
+ // A sum would give 4. The union is 3.
35
+ expect(folded.movements.staff_count).toBe(3);
36
+ expect(folded.movements.staff_ids).toEqual(['staff-a', 'staff-b', 'staff-c']);
37
+ });
38
+ it('RECOMPUTES the derived nets from the summed parts', () => {
39
+ const dayOne = baseDay();
40
+ dayOne.movements.in_amount = 10000;
41
+ dayOne.movements.out_amount = 4000;
42
+ // deliberately WRONG on the input, to prove the fold recomputes rather than trusts.
43
+ dayOne.movements.ledger_net = 999999;
44
+ dayOne.movements.operator.in_amount = 6000;
45
+ dayOne.movements.operator.out_amount = 4000;
46
+ dayOne.movements.system.in_amount = 4000;
47
+ const folded = (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(baseDay(), dayOne);
48
+ expect(folded.movements.ledger_net).toBe(6000);
49
+ expect(folded.movements.operator.net).toBe(2000);
50
+ expect(folded.movements.system.net).toBe(4000);
51
+ });
52
+ it('keeps the reconciliation identity true AFTER folding', () => {
53
+ const build = (float, opIn, opOut, counted) => {
54
+ const counters = baseDay();
55
+ const difference = float + opIn - opOut - counted;
56
+ counters.movements.in_amount = float + opIn + Math.max(0, -difference);
57
+ counters.movements.out_amount = opOut + counted + Math.max(0, difference);
58
+ counters.movements.operator.in_amount = opIn;
59
+ counters.movements.operator.out_amount = opOut;
60
+ counters.movements.system.in_amount = Math.max(0, -difference);
61
+ counters.movements.system.out_amount = Math.max(0, difference);
62
+ counters.movements.lifecycle.float_amount = float;
63
+ counters.movements.lifecycle.countout_amount = counted;
64
+ (0, materialized_cash_accumulator_helpers_1.recalculateCashDerived)(counters);
65
+ return counters;
66
+ };
67
+ const folded = (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(baseDay(), build(10000, 5000, 2000, 12000));
68
+ (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(folded, build(8000, 1000, 3000, 5500));
69
+ const m = folded.movements;
70
+ const identity = m.operator.net +
71
+ m.lifecycle.float_amount -
72
+ m.lifecycle.countout_amount +
73
+ m.lifecycle.reopen_amount +
74
+ m.system.net;
75
+ expect(m.ledger_net).toBe(identity);
76
+ });
77
+ it('folds by_ref across days, keeping it a breakdown of the same rows', () => {
78
+ const dayOne = baseDay();
79
+ dayOne.movements.by_ref.ORDER = { in_count: 2, in_amount: 5000, out_count: 0, out_amount: 0 };
80
+ dayOne.movements.by_ref.EXPENSE = { in_count: 0, in_amount: 0, out_count: 1, out_amount: 2000 };
81
+ const dayTwo = baseDay();
82
+ dayTwo.movements.by_ref.ORDER = { in_count: 3, in_amount: 7000, out_count: 1, out_amount: 500 };
83
+ const folded = (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(baseDay(), dayOne);
84
+ (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(folded, dayTwo);
85
+ expect(folded.movements.by_ref.ORDER.in_amount).toBe(12000);
86
+ expect(folded.movements.by_ref.ORDER.in_count).toBe(5);
87
+ expect(folded.movements.by_ref.ORDER.out_amount).toBe(500);
88
+ expect(folded.movements.by_ref.EXPENSE.out_amount).toBe(2000);
89
+ });
90
+ it('survives a malformed source block rather than throwing', () => {
91
+ const broken = baseDay();
92
+ broken.movements.by_ref = null;
93
+ broken.movements.operator = null;
94
+ broken.sessions = null;
95
+ expect(() => (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(baseDay(), broken)).not.toThrow();
96
+ });
97
+ it('adds session counters straight through', () => {
98
+ const dayOne = baseDay();
99
+ dayOne.sessions.session_count = 2;
100
+ dayOne.sessions.reopen_count = 1;
101
+ dayOne.sessions.opening_float_amount = 20000;
102
+ dayOne.sessions.variance_amount = 500;
103
+ dayOne.sessions.open_sessions_count = 1;
104
+ const dayTwo = baseDay();
105
+ dayTwo.sessions.session_count = 3;
106
+ dayTwo.sessions.opening_float_amount = 30000;
107
+ dayTwo.sessions.variance_amount = -250;
108
+ const folded = (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(baseDay(), dayOne);
109
+ (0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(folded, dayTwo);
110
+ expect(folded.sessions.session_count).toBe(5);
111
+ expect(folded.sessions.reopen_count).toBe(1);
112
+ expect(folded.sessions.opening_float_amount).toBe(50000);
113
+ expect(folded.sessions.variance_amount).toBe(250);
114
+ expect(folded.sessions.open_sessions_count).toBe(1);
115
+ });
116
+ });
@@ -0,0 +1,152 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const materialized_cash_compile_helpers_1 = require("../../helpers/materialized-reports/materialized-cash-compile-helpers");
4
+ const tenant_cash_in_out_formatter_1 = require("../../helpers/materialized-reports/tenant-cash-in-out-formatter");
5
+ /**
6
+ * M3 formatter.
7
+ *
8
+ * The contract this pins: the page must be able to show the RECONCILIATION, so the
9
+ * summary exposes ledger net, operator net, the float, the count-out, the reopen
10
+ * total and the system net together. And `variance` must stay SIGNED as
11
+ * `expected - counted` (positive = SHORT) all the way to the UI, because a page that
12
+ * renders positive variance as "over" inverts the report's meaning.
13
+ */
14
+ const TENANT = 'tenant-1';
15
+ const BRAND = 'brand-1';
16
+ const DAY = '2026-09-14';
17
+ let seq = 0;
18
+ const movement = (over = {}) => ({
19
+ _id: 'mov-' + (seq += 1),
20
+ tenant_id: TENANT,
21
+ drawer_id: 'drawer-A',
22
+ day_id: 'day-1',
23
+ ref_type: 'ORDER',
24
+ type: 'CASH_IN',
25
+ amount: 1000,
26
+ drawer_balance_before: 500,
27
+ drawer_balance_after: 1500,
28
+ staff_id: 'staff-1',
29
+ createdAt: new Date('2026-09-14T10:00:00.000Z'),
30
+ localDate: DAY,
31
+ ...over,
32
+ });
33
+ /** A complete drawer-day: float, an order in, an expense out, then a close. */
34
+ function closedDay(counted) {
35
+ const expected = 10000 + 5000 - 2000;
36
+ const difference = expected - counted;
37
+ const rows = [
38
+ movement({ ref_type: 'DRAWER', type: 'CASH_IN', amount: 10000, note: 'Drawer opened', drawer_balance_before: 0 }),
39
+ movement({ ref_type: 'ORDER', type: 'CASH_IN', amount: 5000 }),
40
+ movement({ ref_type: 'EXPENSE', type: 'CASH_OUT', amount: 2000 }),
41
+ movement({ ref_type: 'DRAWER', type: 'CASH_OUT', amount: counted, note: 'Drawer closed' }),
42
+ ];
43
+ if (difference < 0) {
44
+ rows.push(movement({ ref_type: 'SYSTEM_ADJUSTMENT', type: 'CASH_IN', amount: -difference, note: 'System adjustment' }));
45
+ }
46
+ else if (difference > 0) {
47
+ rows.push(movement({ ref_type: 'SYSTEM_ADJUSTMENT', type: 'CASH_OUT', amount: difference, note: 'System adjustment' }));
48
+ }
49
+ return (0, materialized_cash_compile_helpers_1.compileTenantCashReports)({
50
+ tenantId: TENANT,
51
+ brandId: BRAND,
52
+ localDate: DAY,
53
+ movements: rows,
54
+ sessions: [
55
+ {
56
+ tenant_id: TENANT,
57
+ drawer_id: 'drawer-A',
58
+ status: 'CLOSED',
59
+ opening: { cash_amount: 10000 },
60
+ net_movements: 3000,
61
+ closing: { expected_cash_amount: expected, cash_amount: counted, difference },
62
+ },
63
+ ],
64
+ computedAt: new Date('2026-09-14T23:00:00.000Z'),
65
+ });
66
+ }
67
+ describe('M3 formatter', () => {
68
+ it('returns null rather than an empty page for unusable input', () => {
69
+ expect((0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(null)).toBeNull();
70
+ expect((0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)([])).toBeNull();
71
+ expect((0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)([{ tenant_id: TENANT }])).toBeNull();
72
+ });
73
+ it('publishes every term of the reconciliation', () => {
74
+ const compiled = closedDay(12000); // SHORT by 1000
75
+ const result = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(compiled.reports);
76
+ const page = result[0][0];
77
+ const s = page.summary;
78
+ // the identity the banner renders, in decimals.
79
+ const reconciled = s.operator_net + s.opening_float - s.count_out + s.reopen_amount + s.system_net;
80
+ expect(Math.round(reconciled * 100) / 100).toBe(s.ledger_net);
81
+ expect(s.ledger_net).toBe(0);
82
+ expect(s.opening_float).toBe(100);
83
+ expect(s.count_out).toBe(120);
84
+ expect(s.operator_net).toBe(30);
85
+ });
86
+ it('keeps variance SIGNED: positive is SHORT', () => {
87
+ const short = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(closedDay(12000).reports)[0][0];
88
+ expect(short.summary.variance).toBe(10); // 1000 cents short
89
+ expect(short.summary.short_count).toBe(1);
90
+ expect(short.summary.over_count).toBe(0);
91
+ const over = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(closedDay(13500).reports)[0][0];
92
+ expect(over.summary.variance).toBe(-5);
93
+ expect(over.summary.over_count).toBe(1);
94
+ expect(over.summary.short_count).toBe(0);
95
+ });
96
+ it('breaks down by drawer and by ref type', () => {
97
+ const page = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(closedDay(12000).reports)[0][0];
98
+ expect(page.by_drawer).toHaveLength(1);
99
+ expect(page.by_drawer[0].drawer_id).toBe('drawer-A');
100
+ expect(page.by_drawer[0].session_count).toBe(1);
101
+ const refs = new Map(page.by_ref.map((r) => [r.ref_type, r]));
102
+ expect(refs.get('ORDER').in_amount).toBe(50);
103
+ expect(refs.get('EXPENSE').out_amount).toBe(20);
104
+ expect(refs.get('DRAWER').in_amount).toBe(100); // the float
105
+ expect(refs.get('SYSTEM_ADJUSTMENT').out_amount).toBe(10);
106
+ });
107
+ it('builds the trend and weekday from DAY documents', () => {
108
+ const page = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(closedDay(12000).reports)[0][0];
109
+ expect(page.variance_trend).not.toBeNull();
110
+ expect(page.variance_trend[0].scope_field).toBe(DAY);
111
+ expect(page.variance_trend[0].variance).toBe(10);
112
+ expect(page.weekday).not.toBeNull();
113
+ // 2026-09-14 is a Monday
114
+ expect(page.weekday[0].day_index).toBe('MONDAY');
115
+ });
116
+ it('leaves the trend null for a period-only selection instead of guessing', () => {
117
+ const compiled = closedDay(12000);
118
+ const month = {
119
+ ...compiled.reports[0],
120
+ scope_context: 'localMonth',
121
+ scope_field: '2026-09',
122
+ day_index: null,
123
+ };
124
+ const page = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)([month])[0][0];
125
+ expect(page.variance_trend).toBeNull();
126
+ expect(page.weekday).toBeNull();
127
+ // but the summary still works from the folded counters.
128
+ expect(page.summary.session_count).toBe(1);
129
+ });
130
+ it('honours the drawer and ref-type filters', () => {
131
+ const compiled = closedDay(12000);
132
+ const onlyOrders = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(compiled.reports, {
133
+ ref_types: ['ORDER'],
134
+ })[0][0];
135
+ expect(onlyOrders.by_ref).toHaveLength(1);
136
+ expect(onlyOrders.by_ref[0].ref_type).toBe('ORDER');
137
+ // the summary follows the filter too - only the order movement survives.
138
+ expect(onlyOrders.summary.cash_in).toBe(50);
139
+ const otherDrawer = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)(compiled.reports, {
140
+ drawer_ids: ['drawer-Z'],
141
+ })[0][0];
142
+ expect(otherDrawer.by_ref).toHaveLength(0);
143
+ expect(otherDrawer.summary.movement_count).toBe(0);
144
+ });
145
+ it('splits one view per tenant when asked', () => {
146
+ const compiled = closedDay(12000);
147
+ const other = { ...compiled.reports[0], tenant_id: 'tenant-2' };
148
+ const result = (0, tenant_cash_in_out_formatter_1.getFormattedTenantCashInOutReporting)([compiled.reports[0], other], null, true);
149
+ expect(result[0]).toHaveLength(2);
150
+ expect(result[0].map((p) => p.tenant_ids[0]).sort()).toEqual(['tenant-1', 'tenant-2']);
151
+ });
152
+ });
@@ -0,0 +1,168 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const materialized_cash_close_day_helpers_1 = require("../../helpers/materialized-reports/materialized-cash-close-day-helpers");
4
+ const materialized_cash_compile_helpers_1 = require("../../helpers/materialized-reports/materialized-cash-compile-helpers");
5
+ /**
6
+ * M3 close-day plan.
7
+ *
8
+ * The case that matters most here is the WATERMARK ADVANCE. A folded period document
9
+ * that inherits the STORED document watermark looks unchanged to the write guard, so
10
+ * the write is skipped forever and the period freezes at its first closed day. That
11
+ * bug actually shipped in the prep time report (a month document holding 94 rows where
12
+ * its days totalled 1726), so it is pinned here deliberately.
13
+ */
14
+ const TENANT = 'tenant-1';
15
+ const BRAND = 'brand-1';
16
+ const DAY_ONE = '2026-09-14';
17
+ const DAY_TWO = '2026-09-15';
18
+ let seq = 0;
19
+ const movement = (over = {}) => ({
20
+ _id: 'mov-' + (seq += 1),
21
+ tenant_id: TENANT,
22
+ drawer_id: 'drawer-A',
23
+ day_id: 'day-1',
24
+ ref_type: 'ORDER',
25
+ type: 'CASH_IN',
26
+ amount: 1000,
27
+ drawer_balance_before: 500,
28
+ drawer_balance_after: 1500,
29
+ staff_id: 'staff-1',
30
+ createdAt: new Date('2026-09-14T10:00:00.000Z'),
31
+ localDate: DAY_ONE,
32
+ ...over,
33
+ });
34
+ const compileDay = (localDate, movements, stamp) => (0, materialized_cash_compile_helpers_1.compileTenantCashReports)({
35
+ tenantId: TENANT,
36
+ brandId: BRAND,
37
+ localDate,
38
+ movements,
39
+ computedAt: new Date(stamp),
40
+ });
41
+ describe('M3 close-day plan', () => {
42
+ it('writes the DAY scope straight from the compile', () => {
43
+ const dayOne = compileDay(DAY_ONE, [movement()], '2026-09-14T23:00:00.000Z');
44
+ const plan = (0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({
45
+ tenantId: TENANT,
46
+ reports: dayOne.reports,
47
+ entries: dayOne.entries,
48
+ root: undefined,
49
+ existing: [],
50
+ existingEntries: [],
51
+ reason: 'NEW_DAY',
52
+ computedAt: new Date('2026-09-14T23:00:00.000Z'),
53
+ });
54
+ const dayWrite = plan.writes.find((w) => w.report.scope_context === 'localDate');
55
+ expect(dayWrite).toBeDefined();
56
+ expect(dayWrite.report.scope_field).toBe(DAY_ONE);
57
+ // it also folds the periods the day touches (a Monday in ISO week 38).
58
+ const scopes = plan.writes.map((w) => String(w.report.scope_context));
59
+ expect(scopes).toContain('localWeek');
60
+ expect(scopes).toContain('localWeekOfYear');
61
+ expect(scopes).toContain('localMonth');
62
+ });
63
+ it('ADVANCES the folded period watermark across closes', () => {
64
+ const dayOne = compileDay(DAY_ONE, [movement()], '2026-09-14T23:00:00.000Z');
65
+ const first = (0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({
66
+ tenantId: TENANT,
67
+ reports: dayOne.reports,
68
+ entries: dayOne.entries,
69
+ existing: [],
70
+ existingEntries: [],
71
+ reason: 'NEW_DAY',
72
+ computedAt: new Date('2026-09-14T23:00:00.000Z'),
73
+ });
74
+ const persistedReports = first.writes.map((w) => w.report);
75
+ const persistedEntries = first.entryWrites.map((w) => w.report);
76
+ const monthOne = persistedReports.find((r) => String(r.scope_context) === 'localMonth');
77
+ // close the NEXT day against what the first close stored.
78
+ const dayTwo = compileDay(DAY_TWO, [movement({ localDate: DAY_TWO })], '2026-09-15T23:00:00.000Z');
79
+ const second = (0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({
80
+ tenantId: TENANT,
81
+ reports: dayTwo.reports,
82
+ entries: dayTwo.entries,
83
+ // the stored month document is offered back with its OLD watermark.
84
+ existing: persistedReports,
85
+ existingEntries: persistedEntries,
86
+ reason: 'NEW_DAY',
87
+ computedAt: new Date('2026-09-15T23:00:00.000Z'),
88
+ });
89
+ const monthWrite = second.writes.find((w) => String(w.report.scope_context) === 'localMonth');
90
+ // If the folded document had inherited the stored watermark this would be
91
+ // undefined - the write would have been skipped and the month frozen.
92
+ expect(monthWrite).toBeDefined();
93
+ expect(monthWrite.report.source_watermark.getTime()).toBeGreaterThan(new Date(monthOne.source_watermark).getTime());
94
+ // and both days are now inside it.
95
+ expect(monthWrite.report.cash_counters['drawer-A:ORDER'].movements.in_count).toBe(2);
96
+ });
97
+ it('EMPTYING a day deletes it and removes its contribution from every period', () => {
98
+ const dayOne = compileDay(DAY_ONE, [movement({ amount: 1000 })], '2026-09-14T23:00:00.000Z');
99
+ const first = (0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({
100
+ tenantId: TENANT,
101
+ reports: dayOne.reports,
102
+ entries: dayOne.entries,
103
+ existing: [],
104
+ existingEntries: [],
105
+ reason: 'NEW_DAY',
106
+ computedAt: new Date('2026-09-14T23:00:00.000Z'),
107
+ });
108
+ const stored = first.writes.map((w) => w.report);
109
+ const storedEntries = first.entryWrites.map((w) => w.report);
110
+ // re-close the SAME day with nothing on it.
111
+ const plan = (0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({
112
+ tenantId: TENANT,
113
+ reports: [],
114
+ entries: [],
115
+ localDate: DAY_ONE,
116
+ existing: stored,
117
+ existingEntries: storedEntries,
118
+ reason: 'CORRECTION',
119
+ computedAt: new Date('2026-09-14T23:30:00.000Z'),
120
+ });
121
+ expect(plan.staleDocuments.map((d) => d.scope_field)).toContain(DAY_ONE);
122
+ // the month has no days left, so it must go too.
123
+ const staleScopes = plan.staleDocuments.map((d) => String(d.scope_context));
124
+ expect(staleScopes).toContain('localMonth');
125
+ expect(staleScopes).toContain('localWeek');
126
+ });
127
+ it('does NOT report a period the day does not touch', () => {
128
+ const dayOne = compileDay(DAY_ONE, [movement()], '2026-09-14T23:00:00.000Z');
129
+ const plan = (0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({
130
+ tenantId: TENANT,
131
+ reports: dayOne.reports,
132
+ entries: dayOne.entries,
133
+ existing: [],
134
+ existingEntries: [],
135
+ reason: 'NEW_DAY',
136
+ computedAt: new Date('2026-09-14T23:00:00.000Z'),
137
+ });
138
+ const scopes = new Set(plan.writes.map((w) => String(w.report.scope_context)));
139
+ // September 2026 only - never a neighbouring month.
140
+ for (const w of plan.writes) {
141
+ if (String(w.report.scope_context) === 'localMonth') {
142
+ expect(w.report.scope_field).toBe('2026-09');
143
+ }
144
+ }
145
+ expect(scopes.has('localDate')).toBe(true);
146
+ });
147
+ it('returns null on malformed input', () => {
148
+ expect((0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)(null)).toBeNull();
149
+ expect((0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({ tenantId: '', reports: [], entries: [], reason: 'NEW_DAY' })).toBeNull();
150
+ expect((0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({ tenantId: TENANT, reports: [], entries: [], reason: '' })).toBeNull();
151
+ // nothing compiled and no localDate to clear.
152
+ expect((0, materialized_cash_close_day_helpers_1.buildTenantCashCloseDayPlan)({ tenantId: TENANT, reports: [], entries: [], reason: 'NEW_DAY' })).toBeNull();
153
+ });
154
+ });
155
+ describe('M3 period fold correctness', () => {
156
+ it('unions staff across the folded days of a period', () => {
157
+ const dayOne = compileDay(DAY_ONE, [movement({ staff_id: 'staff-a' })], '2026-09-14T23:00:00.000Z');
158
+ const dayTwo = compileDay(DAY_TWO, [movement({ staff_id: 'staff-b', localDate: DAY_TWO }), movement({ staff_id: 'staff-a', localDate: DAY_TWO })], '2026-09-15T23:00:00.000Z');
159
+ const folded = (0, materialized_cash_close_day_helpers_1.foldMaterializedCashPeriodCounters)({
160
+ periodScope: 'localMonth',
161
+ periodScopeField: '2026-09',
162
+ dayDocuments: [...dayOne.reports, ...dayTwo.reports],
163
+ });
164
+ // staff-a appears on both days and must be counted ONCE.
165
+ expect(folded['drawer-A:ORDER'].movements.staff_count).toBe(2);
166
+ expect(folded['drawer-A:ORDER'].movements.staff_ids).toEqual(['staff-a', 'staff-b']);
167
+ });
168
+ });