@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,426 @@
1
+ import { DELIVERY_STATUS_ENUM } from '../../constants/enums/delivery';
2
+ import { MATERIALIZED_DELIVERY_AREA_LIMIT, MATERIALIZED_DELIVERY_DISTANCE_BUCKETS, MATERIALIZED_DELIVERY_RIDER_LIMIT, } from '../../constants/MATERIALIZED_REPORTS';
3
+ /**
4
+ * M4 delivery - key grammar, the order join, and the accumulators.
5
+ *
6
+ * ## Adoption is the headline, and it needs BOTH populations
7
+ *
8
+ * The `deliveries` collection is written ONLY by the rider app, so for a tenant that does
9
+ * not use it the collection is EMPTY. An empty collection renders as "no deliveries"
10
+ * rather than "no visibility" - which is why the counters always carry
11
+ * `delivery_order_count` (from the ORDERS stage) beside `delivered_via_app_count` (from the
12
+ * DELIVERIES stage). Neither stage alone can compute `off_app_count`.
13
+ *
14
+ * `off_app_count` is NOT an error state: it is the pool the rider app can win.
15
+ *
16
+ * ## The join
17
+ *
18
+ * A delivery document carries neither the platform nor the city, so the key
19
+ * `<PLATFORM>:<CITY>` and every order-derived money figure come from joining by
20
+ * `order_id`. An order with no platform/city details falls into an explicit UNKNOWN
21
+ * bucket rather than being dropped silently - a missing dimension must still show up in
22
+ * the totals.
23
+ *
24
+ * ## One order, N attempts
25
+ *
26
+ * The unique `order_id + rider_id` index allows a re-assignment to create a SECOND
27
+ * delivery for the same order. `deliveries.count` therefore counts ATTEMPTS while
28
+ * `delivery_order_count` counts ORDERS, and the two are deliberately not expected to
29
+ * match. `off_app_count` is computed from a SET difference so a reassigned order is never
30
+ * counted as off-app.
31
+ */
32
+ /** The key token used when a dimension is missing, so nothing is silently dropped. */
33
+ export const DELIVERY_UNKNOWN_TOKEN = 'UNKNOWN';
34
+ export const MATERIALIZED_DELIVERY_KEY_SEPARATOR = ':';
35
+ /** Builds `<PLATFORM>:<CITY>`, substituting UNKNOWN for missing dimensions. */
36
+ export function buildMaterializedDeliveryKey(platform, city) {
37
+ return normalizeDimension(platform) + MATERIALIZED_DELIVERY_KEY_SEPARATOR + normalizeDimension(city);
38
+ }
39
+ function normalizeDimension(value) {
40
+ if (value == null)
41
+ return DELIVERY_UNKNOWN_TOKEN;
42
+ const text = String(value).trim();
43
+ if (text === '')
44
+ return DELIVERY_UNKNOWN_TOKEN;
45
+ // The separator must never appear inside a component, or the key is ambiguous;
46
+ // collapsing it to a dash keeps the row rather than dropping it.
47
+ return text.split(MATERIALIZED_DELIVERY_KEY_SEPARATOR).join('-');
48
+ }
49
+ /** Splits a key back into its parts, or null when it is malformed. */
50
+ export function parseMaterializedDeliveryKey(key) {
51
+ if (key == null)
52
+ return null;
53
+ const parts = String(key).split(MATERIALIZED_DELIVERY_KEY_SEPARATOR);
54
+ if (parts.length !== 2)
55
+ return null;
56
+ const [platform, city] = parts;
57
+ if (platform === '' || city === '')
58
+ return null;
59
+ return { platform, city };
60
+ }
61
+ const emptyRiderRow = (name) => ({
62
+ rider_name: name,
63
+ count: 0,
64
+ completed_count: 0,
65
+ cancelled_count: 0,
66
+ in_progress_count: 0,
67
+ rider_revenue_amount: 0,
68
+ distance_sum_meters: 0,
69
+ first_delivery_at: null,
70
+ last_delivery_at: null,
71
+ });
72
+ const emptyAreaRow = () => ({
73
+ count: 0,
74
+ completed_count: 0,
75
+ cancelled_count: 0,
76
+ rider_revenue_amount: 0,
77
+ distance_sum_meters: 0,
78
+ by_hour: {},
79
+ });
80
+ /** A zeroed counter block. */
81
+ export function freshDeliveryCounters() {
82
+ const distance = { sum_meters: 0, count: 0 };
83
+ for (const bucket of MATERIALIZED_DELIVERY_DISTANCE_BUCKETS)
84
+ distance[bucket.key] = 0;
85
+ return {
86
+ adoption: {
87
+ delivery_order_count: 0,
88
+ delivered_via_app_count: 0,
89
+ off_app_count: 0,
90
+ tracking_enabled_count: 0,
91
+ proof_pickup_count: 0,
92
+ proof_dropoff_count: 0,
93
+ },
94
+ deliveries: {
95
+ count: 0,
96
+ pending_count: 0,
97
+ assigned_count: 0,
98
+ in_progress_count: 0,
99
+ completed_count: 0,
100
+ cancelled_count: 0,
101
+ cancel_reason_count: 0,
102
+ },
103
+ money: {
104
+ rider_revenue_amount: 0,
105
+ rider_revenue_count: 0,
106
+ net_sale_amount: 0,
107
+ collected_amount: 0,
108
+ delivery_charge_amount: 0,
109
+ delivery_charge_count: 0,
110
+ tip_amount: 0,
111
+ discount_amount: 0,
112
+ refund_amount: 0,
113
+ tax_amount: 0,
114
+ },
115
+ distance: distance,
116
+ riders: {},
117
+ areas: {},
118
+ timing: {
119
+ graded_count: 0,
120
+ dispatch_lag_sum_minutes: 0,
121
+ complete_sum_minutes: 0,
122
+ total_sum_minutes: 0,
123
+ exact_completion_count: 0,
124
+ assignment_sum_minutes: 0,
125
+ assignment_count: 0,
126
+ pickup_wait_sum_minutes: 0,
127
+ pickup_wait_count: 0,
128
+ transit_sum_minutes: 0,
129
+ transit_count: 0,
130
+ cancel_sum_minutes: 0,
131
+ cancel_count: 0,
132
+ cancelled_after_pickup_count: 0,
133
+ status_updates_sum: 0,
134
+ status_updates_count: 0,
135
+ promise_known_count: 0,
136
+ on_time_count: 0,
137
+ late_count: 0,
138
+ late_minutes_sum: 0,
139
+ },
140
+ };
141
+ }
142
+ /** Which fixed distance bucket a metre value falls in. */
143
+ export function deliveryDistanceBucketKey(meters) {
144
+ const value = Math.abs(Number(meters) || 0);
145
+ for (const bucket of MATERIALIZED_DELIVERY_DISTANCE_BUCKETS) {
146
+ if (value >= bucket.min && (bucket.max == null || value < bucket.max))
147
+ return bucket.key;
148
+ }
149
+ const last = MATERIALIZED_DELIVERY_DISTANCE_BUCKETS[MATERIALIZED_DELIVERY_DISTANCE_BUCKETS.length - 1];
150
+ return last.key;
151
+ }
152
+ /** A fresh buffer. */
153
+ export function freshDeliveryAccumulator() {
154
+ return {
155
+ counters: freshDeliveryCounters(),
156
+ deliveryOrderIds: new Set(),
157
+ deliveredOrderIds: new Set(),
158
+ watermark: null,
159
+ };
160
+ }
161
+ const minutesBetween = (from, to) => {
162
+ const a = from == null ? NaN : new Date(from).getTime();
163
+ const b = to == null ? NaN : new Date(to).getTime();
164
+ if (Number.isNaN(a) || Number.isNaN(b))
165
+ return null;
166
+ return Math.round((b - a) / 60000);
167
+ };
168
+ const laterOf = (current, candidate) => {
169
+ const time = candidate == null ? NaN : new Date(candidate).getTime();
170
+ if (Number.isNaN(time))
171
+ return current;
172
+ if (current == null || time > current.getTime())
173
+ return new Date(time);
174
+ return current;
175
+ };
176
+ const earlierOf = (current, candidate) => {
177
+ const time = candidate == null ? NaN : new Date(candidate).getTime();
178
+ if (Number.isNaN(time))
179
+ return current;
180
+ if (current == null || time < current.getTime())
181
+ return new Date(time);
182
+ return current;
183
+ };
184
+ /** True when an order is a DELIVERY order (it has delivery details). */
185
+ export function isDeliveryOrder(order) {
186
+ return order?.delivery_details != null;
187
+ }
188
+ /**
189
+ * Consumes ONE delivery ORDER - the ADOPTION half of the join.
190
+ *
191
+ * Order-side money is counted HERE rather than on the delivery, because a cancelled
192
+ * delivery must not lose the order figures the operator recognises.
193
+ */
194
+ export function addDeliveryOrder(acc, order) {
195
+ if (acc == null || order == null)
196
+ return;
197
+ const orderId = order._id == null ? null : String(order._id);
198
+ if (orderId == null)
199
+ return;
200
+ if (acc.deliveryOrderIds.has(orderId))
201
+ return;
202
+ acc.deliveryOrderIds.add(orderId);
203
+ const counters = acc.counters;
204
+ counters.adoption.delivery_order_count += 1;
205
+ const details = order.delivery_details ?? {};
206
+ counters.money.net_sale_amount += Number(order.net_sale_amount ?? order.amount_earned) || 0;
207
+ counters.money.collected_amount += Number(order.amount_collected) || 0;
208
+ counters.money.tip_amount += Number(order.tip_amount) || 0;
209
+ counters.money.discount_amount += Number(order.total_discount_applied) || 0;
210
+ counters.money.refund_amount += Number(order.amount_refunded) || 0;
211
+ counters.money.tax_amount += (Number(order.gst_amount) || 0) + (Number(order.tax_amount) || 0);
212
+ // `delivery_cost` is the field IOrderDeliveryDetails ACTUALLY declares; the other two
213
+ // names are tolerated fallbacks. Reading the wrong one silently reported every charge
214
+ // as ZERO while the statement row (which used the right field) showed the real value -
215
+ // an inconsistency the formatter test caught.
216
+ const charge = Number(details.delivery_cost ?? details.delivery_charge ?? details.delivery_charge_amount) || 0;
217
+ if (charge !== 0) {
218
+ counters.money.delivery_charge_amount += charge;
219
+ counters.money.delivery_charge_count += 1;
220
+ }
221
+ acc.watermark = laterOf(acc.watermark, order.updatedAt ?? order.createdAt);
222
+ }
223
+ /**
224
+ * Consumes ONE delivery document - the APP-SIDE half of the join.
225
+ *
226
+ * `order` may be null (the order was not staged): the delivery still counts toward
227
+ * adoption and its own fields, but the order-derived money and the area cannot be
228
+ * attributed, so it lands in the UNKNOWN bucket.
229
+ */
230
+ export function addDelivery(acc, delivery, order, key) {
231
+ var _a, _b;
232
+ if (acc == null || delivery == null)
233
+ return;
234
+ const counters = acc.counters;
235
+ const orderId = delivery.order_id == null ? null : String(delivery.order_id);
236
+ if (orderId != null)
237
+ acc.deliveredOrderIds.add(orderId);
238
+ counters.deliveries.count += 1;
239
+ const status = String(delivery.status ?? '');
240
+ if (status === DELIVERY_STATUS_ENUM.PENDING)
241
+ counters.deliveries.pending_count += 1;
242
+ else if (status === DELIVERY_STATUS_ENUM.ASSIGNED)
243
+ counters.deliveries.assigned_count += 1;
244
+ else if (status === DELIVERY_STATUS_ENUM.IN_PROGRESS)
245
+ counters.deliveries.in_progress_count += 1;
246
+ else if (status === DELIVERY_STATUS_ENUM.COMPLETED)
247
+ counters.deliveries.completed_count += 1;
248
+ else if (status === DELIVERY_STATUS_ENUM.CANCELLED)
249
+ counters.deliveries.cancelled_count += 1;
250
+ if (status === DELIVERY_STATUS_ENUM.CANCELLED && delivery.cancel_reason != null) {
251
+ counters.deliveries.cancel_reason_count += 1;
252
+ }
253
+ if (delivery.tracking_enabled === true)
254
+ counters.adoption.tracking_enabled_count += 1;
255
+ if (delivery.pickup_food_image_url != null)
256
+ counters.adoption.proof_pickup_count += 1;
257
+ if (delivery.dropoff_food_image_url != null)
258
+ counters.adoption.proof_dropoff_count += 1;
259
+ // Only a FINAL snapshot is payout. A PENDING snapshot is an estimate shown to
260
+ // the rider before completion and must not inflate the materialized report.
261
+ const earnings = delivery.rider_earnings;
262
+ const revenue = Number(earnings != null ? (earnings.status === 'FINAL' ? earnings.amount : 0) : delivery.rider_revenue);
263
+ const hasRevenue = Number.isFinite(revenue);
264
+ if (hasRevenue) {
265
+ counters.money.rider_revenue_amount += revenue;
266
+ counters.money.rider_revenue_count += 1;
267
+ }
268
+ const meters = Number(delivery.distance_in_meters_from_store) || 0;
269
+ counters.distance.sum_meters += meters;
270
+ counters.distance.count += 1;
271
+ const bucketKey = deliveryDistanceBucketKey(meters);
272
+ const distanceRecord = counters.distance;
273
+ distanceRecord[bucketKey] = (distanceRecord[bucketKey] ?? 0) + 1;
274
+ // ---- the bounded rider leaderboard ----
275
+ const riderId = delivery.rider_id == null ? null : String(delivery.rider_id);
276
+ if (riderId != null) {
277
+ counters.riders ?? (counters.riders = {});
278
+ const row = ((_a = counters.riders)[riderId] ?? (_a[riderId] = emptyRiderRow(delivery.rider_name == null ? null : String(delivery.rider_name))));
279
+ row.count += 1;
280
+ if (status === DELIVERY_STATUS_ENUM.COMPLETED)
281
+ row.completed_count += 1;
282
+ else if (status === DELIVERY_STATUS_ENUM.CANCELLED)
283
+ row.cancelled_count += 1;
284
+ else if (status === DELIVERY_STATUS_ENUM.IN_PROGRESS)
285
+ row.in_progress_count += 1;
286
+ if (hasRevenue)
287
+ row.rider_revenue_amount += revenue;
288
+ row.distance_sum_meters += meters;
289
+ row.first_delivery_at = earlierOf(row.first_delivery_at, delivery.createdAt);
290
+ row.last_delivery_at = laterOf(row.last_delivery_at, delivery.createdAt);
291
+ }
292
+ // ---- the bounded area heat map (city from the JOIN) ----
293
+ const parsed = parseMaterializedDeliveryKey(key);
294
+ const city = parsed == null ? DELIVERY_UNKNOWN_TOKEN : parsed.city;
295
+ counters.areas ?? (counters.areas = {});
296
+ const area = ((_b = counters.areas)[city] ?? (_b[city] = emptyAreaRow()));
297
+ area.count += 1;
298
+ if (status === DELIVERY_STATUS_ENUM.COMPLETED)
299
+ area.completed_count += 1;
300
+ else if (status === DELIVERY_STATUS_ENUM.CANCELLED)
301
+ area.cancelled_count += 1;
302
+ if (hasRevenue)
303
+ area.rider_revenue_amount += revenue;
304
+ area.distance_sum_meters += meters;
305
+ const hour = hourKeyOf(delivery);
306
+ if (hour != null)
307
+ area.by_hour[hour] = (area.by_hour[hour] ?? 0) + 1;
308
+ // ---- timing ----
309
+ const timing = (counters.timing ?? (counters.timing = freshDeliveryCounters().timing));
310
+ let graded = false;
311
+ const orderCreatedAt = order?.createdAt ?? null;
312
+ const dispatchLag = minutesBetween(orderCreatedAt, delivery.createdAt);
313
+ if (dispatchLag != null) {
314
+ timing.dispatch_lag_sum_minutes += dispatchLag;
315
+ graded = true;
316
+ }
317
+ if (status === DELIVERY_STATUS_ENUM.COMPLETED) {
318
+ // `delivered_at` is EXACT once the capture has run; before that the only available
319
+ // instant is `updatedAt`, which moves on ANY later mutation - so the report records
320
+ // WHICH one it used rather than presenting a proxy as exact.
321
+ const exact = delivery.delivered_at != null;
322
+ const completedAt = exact ? delivery.delivered_at : delivery.updatedAt;
323
+ const complete = minutesBetween(delivery.createdAt, completedAt);
324
+ if (complete != null) {
325
+ timing.complete_sum_minutes += complete;
326
+ graded = true;
327
+ if (exact)
328
+ timing.exact_completion_count += 1;
329
+ }
330
+ const total = minutesBetween(orderCreatedAt, completedAt);
331
+ if (total != null)
332
+ timing.total_sum_minutes += total;
333
+ // Explicit ETA only. ASAP orders need tenant settings the compile does not
334
+ // receive, so they stay UNMEASURED rather than being given an invented promise.
335
+ const expectedRaw = delivery.expected_delivery_at ?? order?.delivery_details?.estimated_delivery_time;
336
+ const deliveredRaw = delivery.delivered_at;
337
+ if (expectedRaw != null && deliveredRaw != null) {
338
+ const expected = new Date(expectedRaw).getTime();
339
+ const delivered = new Date(deliveredRaw).getTime();
340
+ if (!Number.isNaN(expected) && !Number.isNaN(delivered)) {
341
+ timing.promise_known_count += 1;
342
+ if (delivered <= expected) {
343
+ timing.on_time_count += 1;
344
+ }
345
+ else {
346
+ timing.late_count += 1;
347
+ timing.late_minutes_sum += Math.round((delivered - expected) / 60000);
348
+ }
349
+ }
350
+ }
351
+ }
352
+ if (graded)
353
+ timing.graded_count += 1;
354
+ // ---- captured stage timings / churn ----
355
+ const assignment = minutesBetween(delivery.createdAt, delivery.assigned_at);
356
+ if (assignment != null) {
357
+ timing.assignment_sum_minutes += assignment;
358
+ timing.assignment_count += 1;
359
+ }
360
+ const pickupWait = minutesBetween(delivery.assigned_at, delivery.picked_up_at);
361
+ if (pickupWait != null) {
362
+ timing.pickup_wait_sum_minutes += pickupWait;
363
+ timing.pickup_wait_count += 1;
364
+ }
365
+ const transit = minutesBetween(delivery.picked_up_at, delivery.delivered_at);
366
+ if (transit != null) {
367
+ timing.transit_sum_minutes += transit;
368
+ timing.transit_count += 1;
369
+ }
370
+ const cancel = minutesBetween(delivery.createdAt, delivery.cancelled_at);
371
+ if (cancel != null) {
372
+ timing.cancel_sum_minutes += cancel;
373
+ timing.cancel_count += 1;
374
+ }
375
+ if (status === DELIVERY_STATUS_ENUM.CANCELLED && delivery.picked_up_at != null) {
376
+ timing.cancelled_after_pickup_count += 1;
377
+ }
378
+ if (delivery.status_updated_count != null) {
379
+ timing.status_updates_sum += Number(delivery.status_updated_count) || 0;
380
+ timing.status_updates_count += 1;
381
+ }
382
+ acc.watermark = laterOf(acc.watermark, delivery.updatedAt ?? delivery.createdAt);
383
+ }
384
+ /** `HH` of a delivery, from the local hour when present. */
385
+ function hourKeyOf(delivery) {
386
+ const explicit = delivery.localHour;
387
+ if (typeof explicit === 'number' && Number.isFinite(explicit)) {
388
+ return String(Math.max(0, Math.min(23, Math.floor(explicit)))).padStart(2, '0');
389
+ }
390
+ const raw = delivery.createdAt;
391
+ if (raw == null)
392
+ return null;
393
+ const date = new Date(raw);
394
+ if (Number.isNaN(date.getTime()))
395
+ return null;
396
+ return String(date.getHours()).padStart(2, '0');
397
+ }
398
+ /**
399
+ * Computes the DERIVED adoption figures and prunes the bounded maps.
400
+ *
401
+ * Call ONCE per key, after both stages have been consumed. `off_app_count` is a set
402
+ * difference, so an order reassigned to a second rider is NOT counted as off-app even
403
+ * though there are more deliveries than orders.
404
+ */
405
+ export function finalizeDeliveryAccumulator(acc) {
406
+ const counters = acc.counters;
407
+ const deliveredOrders = [...acc.deliveredOrderIds].filter((id) => acc.deliveryOrderIds.has(id)).length;
408
+ counters.adoption.delivered_via_app_count = deliveredOrders;
409
+ counters.adoption.off_app_count = Math.max(0, acc.deliveryOrderIds.size - deliveredOrders);
410
+ counters.riders = pruneMap(counters.riders, MATERIALIZED_DELIVERY_RIDER_LIMIT, (row) => Number(row.count) || 0);
411
+ counters.areas = pruneMap(counters.areas, MATERIALIZED_DELIVERY_AREA_LIMIT, (row) => Number(row.count) || 0);
412
+ return counters;
413
+ }
414
+ /** Keeps the N busiest entries, so a document stays bounded. */
415
+ function pruneMap(source, limit, weightOf) {
416
+ if (source == null)
417
+ return null;
418
+ const entries = Object.entries(source);
419
+ if (entries.length <= limit)
420
+ return source;
421
+ entries.sort((a, b) => weightOf(b[1]) - weightOf(a[1]));
422
+ const kept = {};
423
+ for (const [key, value] of entries.slice(0, limit))
424
+ kept[key] = value;
425
+ return kept;
426
+ }