@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,175 @@
1
+ import mongoose from 'mongoose';
2
+ import { MATERIALIZED_REPORT_SCOPE_ENUM, MATERIALIZED_TENANT_SALES_COMPARISON_ENTRIES_SCHEMA_VERSION, MATERIALIZED_TENANT_SALES_COMPARISON_REPORTS_SCHEMA_VERSION, SALES_COMPARISON_KEY_FILTERS, } from '../../constants/MATERIALIZED_REPORTS';
3
+ import { addOrderToSalesComparisonCounters, createEmptySalesComparisonCounters, getOrderDiscountAmountCents, getOrderGrossAmountCents, getOrderItemCount, getSalesComparisonSettledLocalDate, } from './materialized-sales-comparison-accumulator-helpers';
4
+ import { buildMaterializedReportKey } from './key-helpers';
5
+ import { getDayIndexFromLocalDate } from './scope-helpers';
6
+ const watermarkOf = (order, fallback) => {
7
+ const raw = order?.updatedAt;
8
+ const time = raw == null ? NaN : new Date(raw).getTime();
9
+ return Number.isNaN(time) ? fallback : new Date(time);
10
+ };
11
+ /** Newest-first order of the drill-down rows (then by id for a stable page). */
12
+ function compareEntryDescending(a, b) {
13
+ const byTime = new Date(b.time).getTime() - new Date(a.time).getTime();
14
+ if (byTime !== 0)
15
+ return byTime;
16
+ // Same instant: `order_id` ASC, matching the page cursor.
17
+ return a.order_id < b.order_id ? -1 : a.order_id > b.order_id ? 1 : 0;
18
+ }
19
+ /**
20
+ * Compiles one settled tenant-day.
21
+ *
22
+ * Returns EMPTY arrays (never null) when the day has no settled orders: an
23
+ * emptied day must produce no day document, and the close-day plan deletes the
24
+ * stored one.
25
+ */
26
+ export function compileTenantSalesComparisonReports(input) {
27
+ if (input == null)
28
+ return null;
29
+ const { tenantId, brandId, localDate, orders, computedAt } = input;
30
+ if (typeof tenantId !== 'string' || tenantId.length === 0)
31
+ return null;
32
+ if (typeof brandId !== 'string' || brandId.length === 0)
33
+ return null;
34
+ if (typeof localDate !== 'string' || localDate.length === 0)
35
+ return null;
36
+ if (!Array.isArray(orders))
37
+ return null;
38
+ if (!(computedAt instanceof Date) || Number.isNaN(computedAt.getTime()))
39
+ return null;
40
+ const dayIndex = getDayIndexFromLocalDate(localDate);
41
+ if (dayIndex == null)
42
+ return null;
43
+ const byKey = new Map();
44
+ const rowsByKey = new Map();
45
+ let watermark = null;
46
+ let contributingOrders = 0;
47
+ let skippedUnsettledOrders = 0;
48
+ let skippedForeignOrders = 0;
49
+ let skippedUnkeyableOrders = 0;
50
+ for (const order of orders) {
51
+ if (order == null)
52
+ continue;
53
+ // Soft-deleted orders are never materialized (they would reappear after a
54
+ // delete unless the close recompiles the day — which it does).
55
+ if (order.is_deleted === true)
56
+ continue;
57
+ // Foreign tenants never leak into this tenant's documents.
58
+ if (order.tenant_id != null && String(order.tenant_id) !== tenantId)
59
+ continue;
60
+ const settledLocalDate = getSalesComparisonSettledLocalDate(order, input.gmtOffset);
61
+ if (settledLocalDate == null) {
62
+ skippedUnsettledOrders += 1;
63
+ continue;
64
+ }
65
+ if (settledLocalDate !== localDate) {
66
+ skippedForeignOrders += 1;
67
+ continue;
68
+ }
69
+ const key = buildMaterializedReportKey([String(order.order_status ?? ''), String(order.platform ?? '')]);
70
+ // A key with a reserved character (or a missing component) cannot be a
71
+ // Mongo field name — the order is skipped rather than silently mis-keyed.
72
+ if (key == null) {
73
+ skippedUnkeyableOrders += 1;
74
+ continue;
75
+ }
76
+ let counters = byKey.get(key);
77
+ if (counters == null) {
78
+ counters = createEmptySalesComparisonCounters();
79
+ byKey.set(key, counters);
80
+ }
81
+ addOrderToSalesComparisonCounters(counters, order);
82
+ const settledAt = new Date(order.order_settled_at);
83
+ const gross = getOrderGrossAmountCents(order);
84
+ const discount = getOrderDiscountAmountCents(order);
85
+ const row = {
86
+ order_id: String(order._id ?? ''),
87
+ order_number: order.order_number == null ? null : Number(order.order_number),
88
+ time: settledAt.toISOString(),
89
+ order_status: String(order.order_status ?? ''),
90
+ platform: String(order.platform ?? ''),
91
+ net_amount: gross - discount,
92
+ discount_amount: discount,
93
+ item_count: getOrderItemCount(order),
94
+ };
95
+ const bucket = rowsByKey.get(key);
96
+ if (bucket == null)
97
+ rowsByKey.set(key, [row]);
98
+ else
99
+ bucket.push(row);
100
+ const orderWatermark = watermarkOf(order, computedAt);
101
+ if (watermark == null || orderWatermark.getTime() > watermark.getTime()) {
102
+ watermark = orderWatermark;
103
+ }
104
+ contributingOrders += 1;
105
+ }
106
+ if (byKey.size === 0) {
107
+ return {
108
+ reports: [],
109
+ entries: [],
110
+ contributingOrders,
111
+ skippedUnsettledOrders,
112
+ skippedForeignOrders,
113
+ skippedUnkeyableOrders,
114
+ };
115
+ }
116
+ const sourceWatermark = watermark ?? computedAt;
117
+ const salesCounters = {};
118
+ const counterRows = [];
119
+ const entrySections = {};
120
+ for (const key of [...byKey.keys()].sort()) {
121
+ const counters = byKey.get(key);
122
+ salesCounters[key] = counters;
123
+ counterRows.push({ key, counters });
124
+ const rows = (rowsByKey.get(key) ?? []).slice().sort(compareEntryDescending);
125
+ if (rows.length > 0)
126
+ entrySections[key] = { rows };
127
+ }
128
+ const reports = [
129
+ {
130
+ _id: new mongoose.Types.ObjectId().toHexString(),
131
+ tenant_id: tenantId,
132
+ brand_id: brandId,
133
+ scope_context: MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
134
+ scope_field: localDate,
135
+ day_index: dayIndex,
136
+ sale_type_key_filters: [...SALES_COMPARISON_KEY_FILTERS],
137
+ sales_counters: salesCounters,
138
+ sales_counter_rows: counterRows,
139
+ schema_version: MATERIALIZED_TENANT_SALES_COMPARISON_REPORTS_SCHEMA_VERSION,
140
+ source_watermark: sourceWatermark,
141
+ computed_at: computedAt,
142
+ createdAt: computedAt,
143
+ updatedAt: computedAt,
144
+ iteration: 1,
145
+ },
146
+ ];
147
+ const entries = [
148
+ {
149
+ _id: new mongoose.Types.ObjectId().toHexString(),
150
+ tenant_id: tenantId,
151
+ brand_id: brandId,
152
+ scope_context: MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
153
+ scope_field: localDate,
154
+ day_index: dayIndex,
155
+ sale_type_key_filters: [...SALES_COMPARISON_KEY_FILTERS],
156
+ sales_entries: entrySections,
157
+ schema_version: MATERIALIZED_TENANT_SALES_COMPARISON_ENTRIES_SCHEMA_VERSION,
158
+ source_watermark: sourceWatermark,
159
+ computed_at: computedAt,
160
+ createdAt: computedAt,
161
+ updatedAt: computedAt,
162
+ iteration: 1,
163
+ },
164
+ ];
165
+ return {
166
+ reports,
167
+ entries,
168
+ contributingOrders,
169
+ skippedUnsettledOrders,
170
+ skippedForeignOrders,
171
+ skippedUnkeyableOrders,
172
+ };
173
+ }
174
+ /** The scopes this report materializes — exported for the close plan + tests. */
175
+ export const MATERIALIZED_SALES_COMPARISON_COMPILED_SCOPES = [MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE];
@@ -0,0 +1,156 @@
1
+ import { convertPriceFromCents } from '../utils/price-conversion';
2
+ import { parseMaterializedCashKey } from './materialized-cash-compile-helpers';
3
+ import { freshCashCounters } from './materialized-cash-classification-helpers';
4
+ import { mergeMaterializedCashCounters } from './materialized-cash-accumulator-helpers';
5
+ const toDecimal = (cents) => convertPriceFromCents(cents ?? 0);
6
+ const isDayScope = (scopeContext) => String(scopeContext) === 'localDate';
7
+ /** True when a key passes the caller-supplied drawer / ref-type filters. */
8
+ function keyPassesFilters(key, filters) {
9
+ const parsed = parseMaterializedCashKey(key);
10
+ if (parsed == null)
11
+ return true; // never hide a row we cannot parse
12
+ const drawers = filters.drawer_ids;
13
+ if (drawers != null && drawers.length > 0 && !drawers.includes(parsed.drawerId))
14
+ return false;
15
+ const refs = filters.ref_types;
16
+ if (refs != null && refs.length > 0 && !refs.includes(parsed.refType))
17
+ return false;
18
+ return true;
19
+ }
20
+ /** Accumulates one page of data for ONE tenant (or the folded brand view). */
21
+ function buildPageForTenant(tenantIds, docs, filters) {
22
+ const total = freshCashCounters();
23
+ const byDrawer = new Map();
24
+ const byRef = new Map();
25
+ const trend = [];
26
+ const weekday = new Map();
27
+ let sawDayScope = false;
28
+ const drawerNames = new Map();
29
+ for (const doc of docs) {
30
+ if (isDayScope(doc.scope_context))
31
+ sawDayScope = true;
32
+ const counters = doc.cash_counters ?? {};
33
+ const daySessions = { variance: 0, counted: 0, ledger: 0 };
34
+ for (const [key, block] of Object.entries(counters)) {
35
+ if (!keyPassesFilters(key, filters))
36
+ continue;
37
+ const parsed = parseMaterializedCashKey(key);
38
+ const drawerId = parsed?.drawerId ?? key;
39
+ mergeMaterializedCashCounters(total, block);
40
+ const drawerBlock = byDrawer.get(drawerId) ?? freshCashCounters();
41
+ mergeMaterializedCashCounters(drawerBlock, block);
42
+ byDrawer.set(drawerId, drawerBlock);
43
+ for (const [refType, flow] of Object.entries(block.movements.by_ref ?? {})) {
44
+ const bucket = byRef.get(refType) ?? { in_amount: 0, out_amount: 0, count: 0 };
45
+ bucket.in_amount += Number(flow?.in_amount) || 0;
46
+ bucket.out_amount += Number(flow?.out_amount) || 0;
47
+ bucket.count += (Number(flow?.in_count) || 0) + (Number(flow?.out_count) || 0);
48
+ byRef.set(refType, bucket);
49
+ }
50
+ daySessions.variance += Number(block.sessions?.variance_amount) || 0;
51
+ daySessions.counted += Number(block.sessions?.counted_close_amount) || 0;
52
+ daySessions.ledger += Number(block.movements?.ledger_net) || 0;
53
+ }
54
+ if (isDayScope(doc.scope_context)) {
55
+ trend.push({
56
+ scope_field: String(doc.scope_field),
57
+ variance: toDecimal(daySessions.variance),
58
+ counted_close: toDecimal(daySessions.counted),
59
+ });
60
+ const weekdayKey = doc.day_index == null ? null : String(doc.day_index);
61
+ if (weekdayKey != null) {
62
+ const bucket = weekday.get(weekdayKey) ?? { variance: 0, ledger_net: 0 };
63
+ bucket.variance += daySessions.variance;
64
+ bucket.ledger_net += daySessions.ledger;
65
+ weekday.set(weekdayKey, bucket);
66
+ }
67
+ }
68
+ }
69
+ const movements = total.movements;
70
+ const sessions = total.sessions;
71
+ return {
72
+ tenant_ids: tenantIds,
73
+ summary: {
74
+ cash_in: toDecimal(movements.in_amount),
75
+ cash_out: toDecimal(movements.out_amount),
76
+ ledger_net: toDecimal(movements.ledger_net),
77
+ operator_net: toDecimal(movements.operator.net),
78
+ reopen_amount: toDecimal(movements.lifecycle.reopen_amount),
79
+ opening_float: toDecimal(movements.lifecycle.float_amount),
80
+ count_out: toDecimal(movements.lifecycle.countout_amount),
81
+ system_net: toDecimal(movements.system.net),
82
+ movement_count: movements.count,
83
+ expected_close: toDecimal(sessions.expected_close_amount),
84
+ counted_close: toDecimal(sessions.counted_close_amount),
85
+ variance: toDecimal(sessions.variance_amount),
86
+ over_count: sessions.variance_negative_count,
87
+ short_count: sessions.variance_positive_count,
88
+ open_sessions: sessions.open_sessions_count,
89
+ session_count: sessions.session_count,
90
+ reopen_count: sessions.reopen_count,
91
+ unmatched_close_count: sessions.unmatched_close_count,
92
+ },
93
+ by_drawer: [...byDrawer.entries()]
94
+ .map(([drawerId, block]) => ({
95
+ drawer_id: drawerId,
96
+ drawer_name: drawerNames.get(drawerId) ?? null,
97
+ cash_in: toDecimal(block.movements.in_amount),
98
+ cash_out: toDecimal(block.movements.out_amount),
99
+ ledger_net: toDecimal(block.movements.ledger_net),
100
+ variance: toDecimal(block.sessions.variance_amount),
101
+ session_count: block.sessions.session_count,
102
+ reopen_count: block.sessions.reopen_count,
103
+ }))
104
+ .sort((a, b) => b.ledger_net - a.ledger_net),
105
+ // Empty ref types are DROPPED: storage keeps all five enum members so a fold
106
+ // stays shape-stable, but a breakdown table must not show rows the filter
107
+ // excluded (or five zero rows for a day that only touched one).
108
+ by_ref: [...byRef.entries()]
109
+ .filter(([, flow]) => flow.count > 0 || flow.in_amount > 0 || flow.out_amount > 0)
110
+ .map(([refType, flow]) => ({
111
+ ref_type: refType,
112
+ in_amount: toDecimal(flow.in_amount),
113
+ out_amount: toDecimal(flow.out_amount),
114
+ count: flow.count,
115
+ }))
116
+ .sort((a, b) => b.in_amount + b.out_amount - (a.in_amount + a.out_amount)),
117
+ variance_trend: sawDayScope ? trend.sort((a, b) => (a.scope_field < b.scope_field ? -1 : 1)) : null,
118
+ weekday: sawDayScope
119
+ ? [...weekday.entries()].map(([dayIndex, bucket]) => ({
120
+ day_index: dayIndex,
121
+ variance: toDecimal(bucket.variance),
122
+ ledger_net: toDecimal(bucket.ledger_net),
123
+ }))
124
+ : null,
125
+ };
126
+ }
127
+ /**
128
+ * Formats cash documents into page data.
129
+ *
130
+ * `separate_view_per_tenant` yields one entry per tenant; otherwise every tenant is
131
+ * folded into a single brand view. Returns null on unusable input rather than an empty
132
+ * page, so the caller can tell "no data" from "malformed request".
133
+ */
134
+ export function getFormattedTenantCashInOutReporting(docs, filters, separate_view_per_tenant) {
135
+ if (!Array.isArray(docs) || docs.length === 0)
136
+ return null;
137
+ const usable = docs.filter((doc) => doc != null && doc.cash_counters != null);
138
+ if (usable.length === 0)
139
+ return null;
140
+ const resolvedFilters = filters ?? {};
141
+ if (separate_view_per_tenant === true) {
142
+ const byTenant = new Map();
143
+ for (const doc of usable) {
144
+ const tenantId = String(doc.tenant_id);
145
+ const bucket = byTenant.get(tenantId) ?? [];
146
+ bucket.push(doc);
147
+ byTenant.set(tenantId, bucket);
148
+ }
149
+ return [
150
+ [...byTenant.entries()].map(([tenantId, tenantDocs]) => buildPageForTenant([tenantId], tenantDocs, resolvedFilters)),
151
+ null,
152
+ ];
153
+ }
154
+ const tenantIds = [...new Set(usable.map((doc) => String(doc.tenant_id)))].sort();
155
+ return [[buildPageForTenant(tenantIds, usable, resolvedFilters)], null];
156
+ }
@@ -0,0 +1,230 @@
1
+ import { convertPriceFromCents } from '../utils/price-conversion';
2
+ import { DELIVERY_UNKNOWN_TOKEN, freshDeliveryCounters, parseMaterializedDeliveryKey, } from './materialized-delivery-classification-helpers';
3
+ import { mergeMaterializedDeliveryCounters } from './materialized-delivery-accumulator-helpers';
4
+ import { MATERIALIZED_DELIVERY_DISTANCE_BUCKETS } from '../../constants/MATERIALIZED_REPORTS';
5
+ const toDecimal = (cents) => convertPriceFromCents(cents ?? 0);
6
+ const km = (meters) => Math.round(((meters ?? 0) / 1000) * 100) / 100;
7
+ const safeAverage = (total, count) => count > 0 ? Math.round((total / count) * 100) / 100 : null;
8
+ const isDayScope = (scopeContext) => String(scopeContext) === 'localDate';
9
+ /** True when a key passes the caller-supplied platform / city filters. */
10
+ function keyPassesFilters(key, filters) {
11
+ const parsed = parseMaterializedDeliveryKey(key);
12
+ if (parsed == null)
13
+ return true; // never hide a key we cannot parse
14
+ const platforms = filters.platforms;
15
+ if (platforms != null && platforms.length > 0 && !platforms.includes(parsed.platform))
16
+ return false;
17
+ const cities = filters.cities;
18
+ if (cities != null && cities.length > 0 && !cities.includes(parsed.city))
19
+ return false;
20
+ return true;
21
+ }
22
+ /** True when a rider row survives the rider filter (no filter = everything). */
23
+ function riderPassesFilters(riderId, filters) {
24
+ const riders = filters.rider_ids;
25
+ if (riders == null || riders.length === 0)
26
+ return true;
27
+ return riders.includes(riderId);
28
+ }
29
+ /** Accumulates one page for ONE view (a tenant, or the folded brand). */
30
+ function buildPageForTenant(tenantIds, docs, filters) {
31
+ const total = freshDeliveryCounters();
32
+ const byPlatform = new Map();
33
+ const byCity = new Map();
34
+ const weekday = new Map();
35
+ let sawDayScope = false;
36
+ for (const doc of docs) {
37
+ if (isDayScope(doc.scope_context))
38
+ sawDayScope = true;
39
+ for (const [key, block] of Object.entries(doc.delivery_counters ?? {})) {
40
+ if (!keyPassesFilters(key, filters))
41
+ continue;
42
+ const parsed = parseMaterializedDeliveryKey(key);
43
+ const platform = parsed?.platform ?? DELIVERY_UNKNOWN_TOKEN;
44
+ const city = parsed?.city ?? DELIVERY_UNKNOWN_TOKEN;
45
+ const blockCounters = block;
46
+ mergeMaterializedDeliveryCounters(total, blockCounters);
47
+ const platformBlock = byPlatform.get(platform) ?? freshDeliveryCounters();
48
+ mergeMaterializedDeliveryCounters(platformBlock, blockCounters);
49
+ byPlatform.set(platform, platformBlock);
50
+ const cityBlock = byCity.get(city) ?? freshDeliveryCounters();
51
+ mergeMaterializedDeliveryCounters(cityBlock, blockCounters);
52
+ byCity.set(city, cityBlock);
53
+ }
54
+ if (isDayScope(doc.scope_context)) {
55
+ const dayIndex = doc.day_index == null ? null : String(doc.day_index);
56
+ if (dayIndex != null) {
57
+ let dayDeliveries = 0;
58
+ let dayCompleted = 0;
59
+ let dayRevenue = 0;
60
+ for (const [key, block] of Object.entries(doc.delivery_counters ?? {})) {
61
+ if (!keyPassesFilters(key, filters))
62
+ continue;
63
+ const counters = block;
64
+ dayDeliveries += Number(counters.deliveries?.count) || 0;
65
+ dayCompleted += Number(counters.deliveries?.completed_count) || 0;
66
+ dayRevenue += Number(counters.money?.rider_revenue_amount) || 0;
67
+ }
68
+ const bucket = weekday.get(dayIndex) ?? { deliveries: 0, completed: 0, revenue: 0 };
69
+ bucket.deliveries += dayDeliveries;
70
+ bucket.completed += dayCompleted;
71
+ bucket.revenue += dayRevenue;
72
+ weekday.set(dayIndex, bucket);
73
+ }
74
+ }
75
+ }
76
+ const adoption = total.adoption;
77
+ const deliveries = total.deliveries;
78
+ const money = total.money;
79
+ const distance = total.distance;
80
+ const timing = total.timing;
81
+ const completedForTiming = Number(deliveries.completed_count) || 0;
82
+ const exactCompletions = Number(timing?.exact_completion_count) || 0;
83
+ const riders = [];
84
+ for (const [riderId, row] of Object.entries(total.riders ?? {})) {
85
+ if (!riderPassesFilters(riderId, filters))
86
+ continue;
87
+ riders.push({
88
+ rider_id: riderId,
89
+ rider_name: row.rider_name ?? null,
90
+ deliveries: Number(row.count) || 0,
91
+ completed: Number(row.completed_count) || 0,
92
+ cancelled: Number(row.cancelled_count) || 0,
93
+ rider_revenue: toDecimal(row.rider_revenue_amount),
94
+ avg_distance_km: safeAverage(km(row.distance_sum_meters), Number(row.count) || 0),
95
+ last_delivery_at: row.last_delivery_at == null ? null : new Date(row.last_delivery_at),
96
+ });
97
+ }
98
+ riders.sort((a, b) => b.deliveries - a.deliveries);
99
+ const hotAreas = [];
100
+ for (const [city, row] of Object.entries(total.areas ?? {})) {
101
+ for (const [hour, count] of Object.entries(row.by_hour ?? {})) {
102
+ const numeric = Number(count) || 0;
103
+ if (numeric === 0)
104
+ continue;
105
+ hotAreas.push({ city, hour: Number(hour) || 0, deliveries: numeric });
106
+ }
107
+ }
108
+ hotAreas.sort((a, b) => b.deliveries - a.deliveries);
109
+ const totalDistance = Number(distance.sum_meters) || 0;
110
+ const distanceCount = Number(distance.count) || 0;
111
+ return {
112
+ tenant_ids: tenantIds,
113
+ adoption: {
114
+ delivery_orders: Number(adoption.delivery_order_count) || 0,
115
+ via_app: Number(adoption.delivered_via_app_count) || 0,
116
+ off_app: Number(adoption.off_app_count) || 0,
117
+ // NULL, not 0, when there were no delivery orders at all: "0%" would claim the
118
+ // app covered nothing when the truth is there was nothing to cover.
119
+ adoption_percent: Number(adoption.delivery_order_count) > 0
120
+ ? Math.round(((Number(adoption.delivered_via_app_count) || 0) / Number(adoption.delivery_order_count)) * 1000) / 10
121
+ : null,
122
+ tracking_enabled: Number(adoption.tracking_enabled_count) || 0,
123
+ with_pickup_proof: Number(adoption.proof_pickup_count) || 0,
124
+ with_dropoff_proof: Number(adoption.proof_dropoff_count) || 0,
125
+ },
126
+ summary: {
127
+ deliveries: Number(deliveries.count) || 0,
128
+ completed: completedForTiming,
129
+ cancelled: Number(deliveries.cancelled_count) || 0,
130
+ in_progress: Number(deliveries.in_progress_count) || 0,
131
+ rider_revenue: toDecimal(money.rider_revenue_amount),
132
+ net_sale: toDecimal(money.net_sale_amount),
133
+ collected: toDecimal(money.collected_amount),
134
+ charges_levied: toDecimal(money.delivery_charge_amount),
135
+ tips: toDecimal(money.tip_amount),
136
+ discounts: toDecimal(money.discount_amount),
137
+ refunds: toDecimal(money.refund_amount),
138
+ tax: toDecimal(money.tax_amount),
139
+ total_distance_km: km(totalDistance),
140
+ average_distance_km: safeAverage(km(totalDistance), distanceCount),
141
+ average_rider_revenue: safeAverage(toDecimal(money.rider_revenue_amount), Number(money.rider_revenue_count) || 0),
142
+ average_dispatch_lag_minutes: safeAverage(Number(timing?.dispatch_lag_sum_minutes) || 0, Number(timing?.graded_count) || 0),
143
+ average_complete_minutes: safeAverage(Number(timing?.complete_sum_minutes) || 0, Number(timing?.graded_count) || 0),
144
+ average_total_minutes: safeAverage(Number(timing?.total_sum_minutes) || 0, Number(timing?.graded_count) || 0),
145
+ average_assignment_minutes: safeAverage(Number(timing?.assignment_sum_minutes) || 0, Number(timing?.assignment_count) || 0),
146
+ average_pickup_wait_minutes: safeAverage(Number(timing?.pickup_wait_sum_minutes) || 0, Number(timing?.pickup_wait_count) || 0),
147
+ average_transit_minutes: safeAverage(Number(timing?.transit_sum_minutes) || 0, Number(timing?.transit_count) || 0),
148
+ average_cancel_minutes: safeAverage(Number(timing?.cancel_sum_minutes) || 0, Number(timing?.cancel_count) || 0),
149
+ average_status_updates: safeAverage(Number(timing?.status_updates_sum) || 0, Number(timing?.status_updates_count) || 0),
150
+ cancelled_after_pickup: Number(timing?.cancelled_after_pickup_count) || 0,
151
+ promise_known: Number(timing?.promise_known_count) || 0,
152
+ on_time: Number(timing?.on_time_count) || 0,
153
+ on_time_percent: Number(timing?.promise_known_count) > 0
154
+ ? Math.round(((Number(timing?.on_time_count) || 0) / Number(timing?.promise_known_count)) * 1000) / 10
155
+ : null,
156
+ late: Number(timing?.late_count) || 0,
157
+ late_minutes: Number(timing?.late_minutes_sum) || 0,
158
+ },
159
+ by_platform: [...byPlatform.entries()]
160
+ .map(([platform, block]) => ({
161
+ platform,
162
+ deliveries: Number(block.deliveries?.count) || 0,
163
+ completed: Number(block.deliveries?.completed_count) || 0,
164
+ net_sale: toDecimal(block.money?.net_sale_amount),
165
+ charges_levied: toDecimal(block.money?.delivery_charge_amount),
166
+ rider_revenue: toDecimal(block.money?.rider_revenue_amount),
167
+ avg_distance_km: safeAverage(km(Number(block.distance.sum_meters) || 0), Number(block.distance.count) || 0),
168
+ }))
169
+ .sort((a, b) => b.deliveries - a.deliveries),
170
+ by_area: [...byCity.entries()]
171
+ .map(([city, block]) => ({
172
+ city,
173
+ deliveries: Number(block.deliveries?.count) || 0,
174
+ completed: Number(block.deliveries?.completed_count) || 0,
175
+ net_sale: toDecimal(block.money?.net_sale_amount),
176
+ charges_levied: toDecimal(block.money?.delivery_charge_amount),
177
+ rider_revenue: toDecimal(block.money?.rider_revenue_amount),
178
+ avg_distance_km: safeAverage(km(Number(block.distance.sum_meters) || 0), Number(block.distance.count) || 0),
179
+ }))
180
+ .sort((a, b) => b.deliveries - a.deliveries),
181
+ by_rider: riders,
182
+ distance_buckets: MATERIALIZED_DELIVERY_DISTANCE_BUCKETS.map((bucket) => ({
183
+ label: bucket.key,
184
+ count: Number(distance[bucket.key]) || 0,
185
+ percent: distanceCount > 0 ? Math.round(((Number(distance[bucket.key]) || 0) / distanceCount) * 1000) / 10 : 0,
186
+ })),
187
+ hot_areas: hotAreas.length > 0 ? hotAreas.slice(0, 50) : null,
188
+ weekday: sawDayScope
189
+ ? [...weekday.entries()].map(([dayIndex, bucket]) => ({
190
+ day_index: dayIndex,
191
+ deliveries: bucket.deliveries,
192
+ completed: bucket.completed,
193
+ rider_revenue: toDecimal(bucket.revenue),
194
+ }))
195
+ : null,
196
+ // Approximate as soon as ONE completion leaned on the proxy, and never claimed when
197
+ // nothing was graded at all (no evidence is not the same as approximate evidence).
198
+ timing_approximate: exactCompletions < completedForTiming,
199
+ };
200
+ }
201
+ /**
202
+ * Formats delivery documents into page data.
203
+ *
204
+ * `separate_view_per_tenant` yields one entry per tenant; otherwise every tenant folds
205
+ * into a single brand view. Returns null on unusable input rather than an empty page, so
206
+ * the caller can tell "no data" from "malformed request".
207
+ */
208
+ export function getFormattedTenantDeliveryReporting(docs, filters, separate_view_per_tenant) {
209
+ if (!Array.isArray(docs) || docs.length === 0)
210
+ return null;
211
+ const usable = docs.filter((doc) => doc != null && doc.delivery_counters != null);
212
+ if (usable.length === 0)
213
+ return null;
214
+ const resolvedFilters = filters ?? {};
215
+ if (separate_view_per_tenant === true) {
216
+ const byTenant = new Map();
217
+ for (const doc of usable) {
218
+ const tenantId = String(doc.tenant_id);
219
+ const bucket = byTenant.get(tenantId) ?? [];
220
+ bucket.push(doc);
221
+ byTenant.set(tenantId, bucket);
222
+ }
223
+ return [
224
+ [...byTenant.entries()].map(([tenantId, tenantDocs]) => buildPageForTenant([tenantId], tenantDocs, resolvedFilters)),
225
+ null,
226
+ ];
227
+ }
228
+ const tenantIds = [...new Set(usable.map((doc) => String(doc.tenant_id)))].sort();
229
+ return [[buildPageForTenant(tenantIds, usable, resolvedFilters)], null];
230
+ }