@managesome/eposmatic-toolkit 0.4.9 → 0.4.11

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 (351) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +455 -0
  2. package/esm/constants/enums/delivery.js +8 -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 +248 -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 +245 -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 +430 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +373 -0
  12. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +216 -0
  13. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +319 -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 +115 -0
  20. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +89 -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 +477 -0
  25. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
  26. package/esm/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +9 -6
  27. package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +11 -4
  28. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
  29. package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +156 -0
  30. package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
  31. package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
  32. package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +157 -0
  33. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
  34. package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
  35. package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +238 -0
  36. package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +282 -0
  37. package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
  38. package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +346 -0
  39. package/esm/helpers/reporting-contract/index.js +2 -0
  40. package/esm/helpers/reporting-contract/overview-contract.js +123 -0
  41. package/esm/helpers/reporting-contract/report-contract.js +228 -0
  42. package/esm/helpers/rider-earnings/index.js +1 -0
  43. package/esm/helpers/rider-earnings/rider-earnings.js +53 -0
  44. package/esm/helpers/rider-reports/index.js +2 -0
  45. package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
  46. package/esm/helpers/rider-reports/rider-report.js +67 -0
  47. package/esm/helpers/store/common-order-actions.js +3 -2
  48. package/esm/schemas/models/deliveries.js +82 -1
  49. package/esm/schemas/models/index.js +15 -0
  50. package/esm/schemas/models/materialized_credit_bills.js +1 -1
  51. package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
  52. package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
  53. package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
  54. package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
  55. package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
  56. package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
  57. package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
  58. package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
  59. package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
  60. package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
  61. package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
  62. package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
  63. package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
  64. package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
  65. package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
  66. package/esm/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
  67. package/esm/schemas/types/index.js +15 -0
  68. package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
  69. package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
  70. package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
  71. package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
  72. package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
  73. package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
  74. package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
  75. package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
  76. package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
  77. package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
  78. package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
  79. package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
  80. package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
  81. package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
  82. package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
  83. package/lib/constants/MATERIALIZED_REPORTS.d.ts +345 -2
  84. package/lib/constants/MATERIALIZED_REPORTS.js +457 -1
  85. package/lib/constants/enums/delivery.d.ts +7 -0
  86. package/lib/constants/enums/delivery.js +9 -1
  87. package/lib/helpers/index.d.ts +3 -0
  88. package/lib/helpers/index.js +3 -0
  89. package/lib/helpers/materialized-reports/index.d.ts +32 -0
  90. package/lib/helpers/materialized-reports/index.js +32 -0
  91. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
  92. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
  93. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +142 -0
  94. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +257 -0
  95. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +103 -0
  96. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
  97. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +73 -0
  98. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +252 -0
  99. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
  100. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
  101. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +113 -0
  102. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +442 -0
  103. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +98 -0
  104. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +386 -0
  105. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +41 -0
  106. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +220 -0
  107. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
  108. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +325 -0
  109. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
  110. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
  111. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
  112. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
  113. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
  114. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
  115. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
  116. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
  117. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
  118. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
  119. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
  120. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +120 -0
  121. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
  122. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +99 -0
  123. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
  124. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
  125. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
  126. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
  127. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +98 -0
  128. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
  129. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +130 -0
  130. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +491 -0
  131. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +47 -0
  132. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
  133. package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.d.ts +6 -3
  134. package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +8 -5
  135. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
  136. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +10 -3
  137. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
  138. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
  139. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
  140. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +160 -0
  141. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
  142. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
  143. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
  144. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
  145. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
  146. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +160 -0
  147. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
  148. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
  149. package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
  150. package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
  151. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
  152. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +244 -0
  153. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
  154. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +289 -0
  155. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +98 -0
  156. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
  157. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
  158. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +352 -0
  159. package/lib/helpers/reporting-contract/index.d.ts +2 -0
  160. package/lib/helpers/reporting-contract/index.js +18 -0
  161. package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
  162. package/lib/helpers/reporting-contract/overview-contract.js +127 -0
  163. package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
  164. package/lib/helpers/reporting-contract/report-contract.js +239 -0
  165. package/lib/helpers/rider-earnings/index.d.ts +1 -0
  166. package/lib/helpers/rider-earnings/index.js +17 -0
  167. package/lib/helpers/rider-earnings/rider-earnings.d.ts +51 -0
  168. package/lib/helpers/rider-earnings/rider-earnings.js +57 -0
  169. package/lib/helpers/rider-reports/index.d.ts +2 -0
  170. package/lib/helpers/rider-reports/index.js +18 -0
  171. package/lib/helpers/rider-reports/rider-daily-report.d.ts +28 -0
  172. package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
  173. package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
  174. package/lib/helpers/rider-reports/rider-report.js +70 -0
  175. package/lib/helpers/store/common-order-actions.js +3 -2
  176. package/lib/helpers/types/materialized-reports-apis.d.ts +300 -1
  177. package/lib/schemas/models/deliveries.d.ts +58 -1
  178. package/lib/schemas/models/deliveries.js +81 -0
  179. package/lib/schemas/models/expense_details.d.ts +3 -3
  180. package/lib/schemas/models/index.d.ts +15 -0
  181. package/lib/schemas/models/index.js +15 -0
  182. package/lib/schemas/models/materialized_credit_bills.d.ts +3 -3
  183. package/lib/schemas/models/materialized_credit_bills.js +1 -1
  184. package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
  185. package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
  186. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
  187. package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
  188. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
  189. package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
  190. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
  191. package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
  192. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
  193. package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
  194. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
  195. package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
  196. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
  197. package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
  198. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
  199. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
  200. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
  201. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
  202. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
  203. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
  204. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
  205. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
  206. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
  207. package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
  208. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
  209. package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
  210. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
  211. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
  212. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
  213. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
  214. package/lib/schemas/models/materialized_tenant_sales_overview_reports.d.ts +3 -3
  215. package/lib/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
  216. package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
  217. package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
  218. package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
  219. package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
  220. package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
  221. package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
  222. package/lib/schemas/types/deliveries.d.ts +40 -1
  223. package/lib/schemas/types/index.d.ts +15 -0
  224. package/lib/schemas/types/index.js +15 -0
  225. package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
  226. package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
  227. package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
  228. package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
  229. package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
  230. package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
  231. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
  232. package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
  233. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
  234. package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
  235. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
  236. package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
  237. package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
  238. package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
  239. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
  240. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
  241. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
  242. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
  243. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
  244. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
  245. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
  246. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
  247. package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
  248. package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
  249. package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
  250. package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
  251. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
  252. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
  253. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
  254. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
  255. package/lib/schemas/types/materialized_tenant_sales_overview_reports.d.ts +7 -0
  256. package/lib/tests/deliveries-schema.test.d.ts +1 -0
  257. package/lib/tests/deliveries-schema.test.js +70 -0
  258. package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
  259. package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
  260. package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
  261. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  262. package/lib/tests/materialized-reports/fixtures.js +1 -0
  263. package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
  264. package/lib/tests/materialized-reports/materialized-cash-compile.test.js +197 -0
  265. package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
  266. package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
  267. package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
  268. package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +153 -0
  269. package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
  270. package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
  271. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
  272. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
  273. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
  274. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
  275. package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
  276. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +242 -0
  277. package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
  278. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
  279. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
  280. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +142 -0
  281. package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
  282. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
  283. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
  284. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
  285. package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
  286. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
  287. package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
  288. package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
  289. package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
  290. package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
  291. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
  292. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
  293. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
  294. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
  295. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
  296. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
  297. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
  298. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
  299. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
  300. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
  301. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
  302. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
  303. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
  304. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
  305. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
  306. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
  307. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
  308. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
  309. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
  310. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
  311. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
  312. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +271 -0
  313. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
  314. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
  315. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
  316. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
  317. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
  318. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
  319. package/lib/tests/materialized-reports/materialized-reports-scope-group-helpers.test.js +13 -13
  320. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
  321. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
  322. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
  323. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +207 -0
  324. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
  325. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
  326. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
  327. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
  328. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
  329. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
  330. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
  331. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
  332. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
  333. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
  334. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
  335. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
  336. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
  337. package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
  338. package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
  339. package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
  340. package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
  341. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
  342. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
  343. package/lib/tests/reporting-contract.test.d.ts +1 -0
  344. package/lib/tests/reporting-contract.test.js +267 -0
  345. package/lib/tests/rider-daily-report.test.d.ts +1 -0
  346. package/lib/tests/rider-daily-report.test.js +86 -0
  347. package/lib/tests/rider-earnings.test.d.ts +1 -0
  348. package/lib/tests/rider-earnings.test.js +65 -0
  349. package/lib/tests/rider-report.test.d.ts +1 -0
  350. package/lib/tests/rider-report.test.js +98 -0
  351. package/package.json +10 -1
@@ -0,0 +1,114 @@
1
+ import { CASH_IN_OUT_REF_ENUM } from '../../constants/enums/cash';
2
+ import { freshCashCounters } from './materialized-cash-classification-helpers';
3
+ /**
4
+ * M3 cash - folding counters across days into a PERIOD document.
5
+ *
6
+ * Two rules, and both exist because cash has non-additive quantities:
7
+ *
8
+ * 1. **Derived values are RECOMPUTED, never summed.** `ledger_net`, `operator.net`,
9
+ * `system.net` and every `by_ref` total are all `in - out`. They happen to be
10
+ * linear here, but recomputing from the summed parts means a future change to a
11
+ * definition cannot silently desynchronize a period total from its components.
12
+ * 2. **`staff_count` is a UNION, not a sum.** It counts DISTINCT staff, so adding two
13
+ * days double-counts anyone who worked both. The fold unions the stored id sets.
14
+ * A period document therefore cannot be produced by summing day documents alone -
15
+ * which is the same reason the prep time report stores its histogram rows.
16
+ *
17
+ * Period documents are always RE-FOLDED from the day documents rather than
18
+ * incremented in place: you cannot subtract a distinct count, so an incremental
19
+ * update could never undo a removed day.
20
+ */
21
+ const addFlow = (target, source) => {
22
+ target.in_count += Number(source?.in_count) || 0;
23
+ target.in_amount += Number(source?.in_amount) || 0;
24
+ target.out_count += Number(source?.out_count) || 0;
25
+ target.out_amount += Number(source?.out_amount) || 0;
26
+ };
27
+ /**
28
+ * Merges `source` into `target`, IN PLACE. Used to fold day counters into a period.
29
+ *
30
+ * Null-safe: a source block missing a sub-object is treated as zeroes rather than
31
+ * throwing, so one malformed historical document cannot break a whole fold.
32
+ */
33
+ export function mergeMaterializedCashCounters(target, source) {
34
+ var _a;
35
+ if (target == null || source == null)
36
+ return target;
37
+ const t = target.movements;
38
+ const s = source.movements;
39
+ if (t != null && s != null) {
40
+ t.count += Number(s.count) || 0;
41
+ t.in_count += Number(s.in_count) || 0;
42
+ t.in_amount += Number(s.in_amount) || 0;
43
+ t.out_count += Number(s.out_count) || 0;
44
+ t.out_amount += Number(s.out_amount) || 0;
45
+ if (t.operator != null && s.operator != null) {
46
+ addFlow(t.operator, s.operator);
47
+ t.operator.count += Number(s.operator.count) || 0;
48
+ }
49
+ if (t.system != null && s.system != null) {
50
+ addFlow(t.system, s.system);
51
+ t.system.count += Number(s.system.count) || 0;
52
+ }
53
+ if (t.lifecycle != null && s.lifecycle != null) {
54
+ t.lifecycle.float_count += Number(s.lifecycle.float_count) || 0;
55
+ t.lifecycle.float_amount += Number(s.lifecycle.float_amount) || 0;
56
+ t.lifecycle.reopen_count += Number(s.lifecycle.reopen_count) || 0;
57
+ t.lifecycle.reopen_amount += Number(s.lifecycle.reopen_amount) || 0;
58
+ t.lifecycle.countout_count += Number(s.lifecycle.countout_count) || 0;
59
+ t.lifecycle.countout_amount += Number(s.lifecycle.countout_amount) || 0;
60
+ }
61
+ t.by_ref ?? (t.by_ref = {});
62
+ for (const refType of Object.values(CASH_IN_OUT_REF_ENUM)) {
63
+ const sourceFlow = s.by_ref?.[refType];
64
+ if (sourceFlow == null)
65
+ continue;
66
+ (_a = t.by_ref)[refType] ?? (_a[refType] = { in_count: 0, in_amount: 0, out_count: 0, out_amount: 0 });
67
+ addFlow(t.by_ref[refType], sourceFlow);
68
+ }
69
+ // UNION the rosters - never add the counts.
70
+ const roster = new Set(t.staff_ids ?? []);
71
+ for (const id of s.staff_ids ?? [])
72
+ roster.add(String(id));
73
+ t.staff_ids = [...roster].sort();
74
+ t.staff_count = t.staff_ids.length;
75
+ }
76
+ const ts = target.sessions;
77
+ const ss = source.sessions;
78
+ if (ts != null && ss != null) {
79
+ ts.session_count += Number(ss.session_count) || 0;
80
+ ts.reopen_count += Number(ss.reopen_count) || 0;
81
+ ts.reopened_session_count += Number(ss.reopened_session_count) || 0;
82
+ ts.opening_float_amount += Number(ss.opening_float_amount) || 0;
83
+ ts.net_movements_amount += Number(ss.net_movements_amount) || 0;
84
+ ts.expected_close_amount += Number(ss.expected_close_amount) || 0;
85
+ ts.counted_close_amount += Number(ss.counted_close_amount) || 0;
86
+ ts.variance_amount += Number(ss.variance_amount) || 0;
87
+ ts.variance_positive_count += Number(ss.variance_positive_count) || 0;
88
+ ts.variance_negative_count += Number(ss.variance_negative_count) || 0;
89
+ ts.open_sessions_count += Number(ss.open_sessions_count) || 0;
90
+ ts.unmatched_close_count += Number(ss.unmatched_close_count) || 0;
91
+ }
92
+ recalculateCashDerived(target);
93
+ return target;
94
+ }
95
+ /**
96
+ * Recomputes every DERIVED value from the summed components, in place.
97
+ *
98
+ * This is what makes a folded document self-consistent: the nets and the `by_ref`
99
+ * totals are always a function of the counts and amounts beside them.
100
+ */
101
+ export function recalculateCashDerived(counters) {
102
+ const m = counters?.movements;
103
+ if (m == null)
104
+ return;
105
+ m.ledger_net = (Number(m.in_amount) || 0) - (Number(m.out_amount) || 0);
106
+ if (m.operator != null) {
107
+ m.operator.net = (Number(m.operator.in_amount) || 0) - (Number(m.operator.out_amount) || 0);
108
+ }
109
+ if (m.system != null) {
110
+ m.system.net = (Number(m.system.in_amount) || 0) - (Number(m.system.out_amount) || 0);
111
+ }
112
+ }
113
+ /** A fresh zeroed block - re-exported so callers fold from the same seed. */
114
+ export { freshCashCounters };
@@ -0,0 +1,248 @@
1
+ import { CASH_DRAWER_STATUS_ENUM, CASH_IN_OUT_REF_ENUM, CASH_IN_OUT_TYPE_ENUM } from '../../constants/enums/cash';
2
+ /** Note prefixes written by the cash drawer repository. */
3
+ export const CASH_OPENING_NOTE_PREFIX = 'Drawer opened';
4
+ export const CASH_REOPEN_NOTE_PREFIX = 'Drawer reopened';
5
+ export const CASH_COUNT_OUT_NOTE_PREFIX = 'Drawer closed';
6
+ export const CASH_SYSTEM_NOTE_PREFIX = 'System adjustment';
7
+ const noteOf = (row) => (typeof row?.note === 'string' ? row.note : '');
8
+ /**
9
+ * Classifies one ledger row.
10
+ *
11
+ * The note prefix is PRIMARY (it is what the source writes). The balance SHAPE is
12
+ * the fallback, because a lifecycle CASH_IN always opens from a zero balance while
13
+ * an operator cash-in never does - so a row whose note is missing or reworded is
14
+ * still classified correctly rather than silently counted as operator movement.
15
+ */
16
+ export function classifyCashMovement(row) {
17
+ const refType = String(row?.ref_type ?? '');
18
+ const type = String(row?.type ?? '');
19
+ const note = noteOf(row);
20
+ const startsAtZero = Number(row?.drawer_balance_before ?? 0) === 0;
21
+ const isSystemAdjustment = refType === CASH_IN_OUT_REF_ENUM.SYSTEM_ADJUSTMENT || note.startsWith(CASH_SYSTEM_NOTE_PREFIX);
22
+ const isDrawerCashIn = refType === CASH_IN_OUT_REF_ENUM.DRAWER && type === CASH_IN_OUT_TYPE_ENUM.CASH_IN;
23
+ const isDrawerCashOut = refType === CASH_IN_OUT_REF_ENUM.DRAWER && type === CASH_IN_OUT_TYPE_ENUM.CASH_OUT;
24
+ // The NOTE is authoritative: the source always writes it, so an exact prefix
25
+ // match is trusted outright.
26
+ const isReopen = isDrawerCashIn && !isSystemAdjustment && note.startsWith(CASH_REOPEN_NOTE_PREFIX);
27
+ // The SHAPE is only a fallback, and it cannot distinguish a float from a reopen -
28
+ // both open from a zero balance and both are CASH_IN / DRAWER. Given a note-less
29
+ // row the classifier therefore resolves to the FLOAT (the opening case), and the
30
+ // attribution is CROSS-CHECKED against the session documents instead of guessed:
31
+ // the harness asserts lifecycle.float_amount == sessions.opening_float_amount, so
32
+ // a note-less reopen shows up as a disagreement rather than silently mislabelling.
33
+ // (This is exactly the guessing decision (i3) accepts for v1 and the durable
34
+ // is_lifecycle stamp removes.)
35
+ const isOpeningFloat = isDrawerCashIn &&
36
+ !isSystemAdjustment &&
37
+ !isReopen &&
38
+ (note.startsWith(CASH_OPENING_NOTE_PREFIX) || (note === '' && startsAtZero));
39
+ const isCountOut = isDrawerCashOut && !isSystemAdjustment && (note.startsWith(CASH_COUNT_OUT_NOTE_PREFIX) || note === '');
40
+ const isLifecycle = isReopen || isOpeningFloat || isCountOut || isSystemAdjustment;
41
+ return {
42
+ is_opening_float: isOpeningFloat,
43
+ is_reopen: isReopen,
44
+ is_count_out: isCountOut,
45
+ is_system_adjustment: isSystemAdjustment,
46
+ is_operator: !isLifecycle,
47
+ };
48
+ }
49
+ const emptyFlow = () => ({
50
+ in_count: 0,
51
+ in_amount: 0,
52
+ out_count: 0,
53
+ out_amount: 0,
54
+ });
55
+ /** A zeroed counter block with every ref type present. */
56
+ export function freshCashCounters() {
57
+ const byRef = {};
58
+ for (const refType of Object.values(CASH_IN_OUT_REF_ENUM))
59
+ byRef[refType] = emptyFlow();
60
+ return {
61
+ movements: {
62
+ count: 0,
63
+ in_count: 0,
64
+ in_amount: 0,
65
+ out_count: 0,
66
+ out_amount: 0,
67
+ ledger_net: 0,
68
+ operator: { ...emptyFlow(), count: 0, net: 0 },
69
+ lifecycle: {
70
+ float_count: 0,
71
+ float_amount: 0,
72
+ reopen_count: 0,
73
+ reopen_amount: 0,
74
+ countout_count: 0,
75
+ countout_amount: 0,
76
+ },
77
+ system: { ...emptyFlow(), count: 0, net: 0 },
78
+ by_ref: byRef,
79
+ staff_count: 0,
80
+ staff_ids: [],
81
+ },
82
+ sessions: {
83
+ session_count: 0,
84
+ reopen_count: 0,
85
+ reopened_session_count: 0,
86
+ opening_float_amount: 0,
87
+ net_movements_amount: 0,
88
+ expected_close_amount: 0,
89
+ counted_close_amount: 0,
90
+ variance_amount: 0,
91
+ variance_positive_count: 0,
92
+ variance_negative_count: 0,
93
+ open_sessions_count: 0,
94
+ unmatched_close_count: 0,
95
+ },
96
+ };
97
+ }
98
+ /** A fresh buffer. */
99
+ export function freshCashAccumulator() {
100
+ return { counters: freshCashCounters(), staff: new Set(), seen: new Set() };
101
+ }
102
+ /** Adds one ledger row. Returns false when it was already counted. */
103
+ export function addCashMovement(acc, row) {
104
+ var _a;
105
+ if (acc == null || row == null)
106
+ return false;
107
+ const id = row.cash_in_out_id ?? row._id;
108
+ if (id != null) {
109
+ const key = String(id);
110
+ if (acc.seen.has(key))
111
+ return false;
112
+ acc.seen.add(key);
113
+ }
114
+ const provenance = classifyCashMovement(row);
115
+ const amount = Math.abs(Number(row.amount) || 0);
116
+ const isIn = String(row.type) === CASH_IN_OUT_TYPE_ENUM.CASH_IN;
117
+ const movements = acc.counters.movements;
118
+ if (row.staff_id != null)
119
+ acc.staff.add(String(row.staff_id));
120
+ movements.count += 1;
121
+ if (isIn) {
122
+ movements.in_count += 1;
123
+ movements.in_amount += amount;
124
+ }
125
+ else {
126
+ movements.out_count += 1;
127
+ movements.out_amount += amount;
128
+ }
129
+ movements.ledger_net = movements.in_amount - movements.out_amount;
130
+ // by_ref is a BREAKDOWN of the same rows, so it uses the same classification.
131
+ const refKey = String(row.ref_type ?? CASH_IN_OUT_REF_ENUM.NONE);
132
+ const refFlow = ((_a = movements.by_ref)[refKey] ?? (_a[refKey] = emptyFlow()));
133
+ if (isIn) {
134
+ refFlow.in_count += 1;
135
+ refFlow.in_amount += amount;
136
+ }
137
+ else {
138
+ refFlow.out_count += 1;
139
+ refFlow.out_amount += amount;
140
+ }
141
+ if (provenance.is_operator) {
142
+ const operator = movements.operator;
143
+ operator.count += 1;
144
+ if (isIn) {
145
+ operator.in_count += 1;
146
+ operator.in_amount += amount;
147
+ }
148
+ else {
149
+ operator.out_count += 1;
150
+ operator.out_amount += amount;
151
+ }
152
+ operator.net = operator.in_amount - operator.out_amount;
153
+ return true;
154
+ }
155
+ if (provenance.is_system_adjustment) {
156
+ const system = movements.system;
157
+ system.count += 1;
158
+ if (isIn) {
159
+ system.in_count += 1;
160
+ system.in_amount += amount;
161
+ }
162
+ else {
163
+ system.out_count += 1;
164
+ system.out_amount += amount;
165
+ }
166
+ system.net = system.in_amount - system.out_amount;
167
+ return true;
168
+ }
169
+ const lifecycle = movements.lifecycle;
170
+ if (provenance.is_opening_float) {
171
+ lifecycle.float_count += 1;
172
+ lifecycle.float_amount += amount;
173
+ }
174
+ else if (provenance.is_reopen) {
175
+ lifecycle.reopen_count += 1;
176
+ lifecycle.reopen_amount += amount;
177
+ }
178
+ else if (provenance.is_count_out) {
179
+ lifecycle.countout_count += 1;
180
+ lifecycle.countout_amount += amount;
181
+ }
182
+ return true;
183
+ }
184
+ /** Adds one drawer session document. */
185
+ export function addCashSession(acc, session) {
186
+ if (acc == null || session == null)
187
+ return;
188
+ const sessions = acc.counters.sessions;
189
+ sessions.session_count += 1;
190
+ const reopenedTimes = Number(session.reopened_times) || 0;
191
+ sessions.reopen_count += reopenedTimes;
192
+ if (reopenedTimes > 0)
193
+ sessions.reopened_session_count += 1;
194
+ // The float is preserved across reopens, so it is counted ONCE per session.
195
+ sessions.opening_float_amount += Math.abs(Number(session.opening?.cash_amount) || 0);
196
+ sessions.net_movements_amount += Number(session.net_movements) || 0;
197
+ const closing = session.closing ?? null;
198
+ if (closing == null) {
199
+ // No closing record: a session still IN_USE is normal; anything else is a
200
+ // data-integrity tripwire.
201
+ if (String(session.status) === CASH_DRAWER_STATUS_ENUM.IN_USE)
202
+ sessions.open_sessions_count += 1;
203
+ else
204
+ sessions.unmatched_close_count += 1;
205
+ return;
206
+ }
207
+ // EVERY lifecycle counts, not just the last one.
208
+ //
209
+ // FOUND BY THE DEMO DATASET, not by reading the source: a REOPENED session has two
210
+ // (or more) lifecycles, and the ledger holds an over/short SWEEP for EACH of them -
211
+ // but `closing.difference` only describes the FINAL one. Summing just that made
212
+ // `variance_amount` undercount the day and broke the report's second cross-collection
213
+ // check (`system.net == -variance_amount`) on every reopened drawer-day: measured
214
+ // 120 vs -300 for one drawer, where lifecycle 1 was 420 OVER and lifecycle 2 was 300
215
+ // SHORT, netting to 120. The earlier lifecycle is snapshotted in
216
+ // `reopened_iterations`, so it is recoverable - and summing all of them makes the
217
+ // identity exact again.
218
+ const lifecycles = [closing];
219
+ for (const iteration of Array.isArray(session.reopened_iterations) ? session.reopened_iterations : []) {
220
+ if (iteration?.closing != null)
221
+ lifecycles.push(iteration.closing);
222
+ else if (iteration != null)
223
+ lifecycles.push(iteration);
224
+ }
225
+ for (const lifecycle of lifecycles) {
226
+ sessions.expected_close_amount += Number(lifecycle.expected_cash_amount) || 0;
227
+ sessions.counted_close_amount += Number(lifecycle.cash_amount) || 0;
228
+ const difference = Number(lifecycle.difference) || 0;
229
+ sessions.variance_amount += difference;
230
+ // SIGN: difference = expected - counted, so POSITIVE = SHORT.
231
+ if (difference > 0)
232
+ sessions.variance_positive_count += 1;
233
+ else if (difference < 0)
234
+ sessions.variance_negative_count += 1;
235
+ }
236
+ }
237
+ /**
238
+ * Materializes the staff roster into the counter block (call before persisting).
239
+ *
240
+ * The IDS are kept alongside the count so a later period fold can take a UNION
241
+ * rather than a sum - a distinct count cannot be added.
242
+ */
243
+ export function finalizeCashAccumulator(acc) {
244
+ const ids = [...acc.staff].sort();
245
+ acc.counters.movements.staff_ids = ids;
246
+ acc.counters.movements.staff_count = ids.length;
247
+ return acc.counters;
248
+ }