@managesome/eposmatic-toolkit 0.4.9 → 0.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (351) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +455 -0
  2. package/esm/constants/enums/delivery.js +8 -0
  3. package/esm/helpers/index.js +3 -0
  4. package/esm/helpers/materialized-reports/index.js +32 -0
  5. package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
  6. package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +248 -0
  7. package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
  8. package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +245 -0
  9. package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
  10. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +430 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +373 -0
  12. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +216 -0
  13. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +319 -0
  14. package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
  15. package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
  16. package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
  17. package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
  18. package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
  19. package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +115 -0
  20. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +89 -0
  21. package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
  22. package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
  23. package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
  24. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +477 -0
  25. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
  26. package/esm/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +9 -6
  27. package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +11 -4
  28. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
  29. package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +156 -0
  30. package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
  31. package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
  32. package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +157 -0
  33. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
  34. package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
  35. package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +238 -0
  36. package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +282 -0
  37. package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
  38. package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +346 -0
  39. package/esm/helpers/reporting-contract/index.js +2 -0
  40. package/esm/helpers/reporting-contract/overview-contract.js +123 -0
  41. package/esm/helpers/reporting-contract/report-contract.js +228 -0
  42. package/esm/helpers/rider-earnings/index.js +1 -0
  43. package/esm/helpers/rider-earnings/rider-earnings.js +53 -0
  44. package/esm/helpers/rider-reports/index.js +2 -0
  45. package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
  46. package/esm/helpers/rider-reports/rider-report.js +67 -0
  47. package/esm/helpers/store/common-order-actions.js +3 -2
  48. package/esm/schemas/models/deliveries.js +82 -1
  49. package/esm/schemas/models/index.js +15 -0
  50. package/esm/schemas/models/materialized_credit_bills.js +1 -1
  51. package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
  52. package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
  53. package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
  54. package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
  55. package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
  56. package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
  57. package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
  58. package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
  59. package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
  60. package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
  61. package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
  62. package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
  63. package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
  64. package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
  65. package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
  66. package/esm/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
  67. package/esm/schemas/types/index.js +15 -0
  68. package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
  69. package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
  70. package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
  71. package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
  72. package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
  73. package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
  74. package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
  75. package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
  76. package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
  77. package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
  78. package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
  79. package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
  80. package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
  81. package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
  82. package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
  83. package/lib/constants/MATERIALIZED_REPORTS.d.ts +345 -2
  84. package/lib/constants/MATERIALIZED_REPORTS.js +457 -1
  85. package/lib/constants/enums/delivery.d.ts +7 -0
  86. package/lib/constants/enums/delivery.js +9 -1
  87. package/lib/helpers/index.d.ts +3 -0
  88. package/lib/helpers/index.js +3 -0
  89. package/lib/helpers/materialized-reports/index.d.ts +32 -0
  90. package/lib/helpers/materialized-reports/index.js +32 -0
  91. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
  92. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
  93. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +142 -0
  94. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +257 -0
  95. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +103 -0
  96. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
  97. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +73 -0
  98. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +252 -0
  99. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
  100. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
  101. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +113 -0
  102. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +442 -0
  103. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +98 -0
  104. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +386 -0
  105. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +41 -0
  106. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +220 -0
  107. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
  108. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +325 -0
  109. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
  110. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
  111. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
  112. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
  113. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
  114. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
  115. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
  116. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
  117. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
  118. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
  119. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
  120. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +120 -0
  121. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
  122. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +99 -0
  123. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
  124. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
  125. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
  126. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
  127. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +98 -0
  128. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
  129. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +130 -0
  130. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +491 -0
  131. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +47 -0
  132. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
  133. package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.d.ts +6 -3
  134. package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +8 -5
  135. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
  136. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +10 -3
  137. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
  138. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
  139. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
  140. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +160 -0
  141. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
  142. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
  143. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
  144. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
  145. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
  146. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +160 -0
  147. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
  148. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
  149. package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
  150. package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
  151. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
  152. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +244 -0
  153. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
  154. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +289 -0
  155. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +98 -0
  156. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
  157. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
  158. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +352 -0
  159. package/lib/helpers/reporting-contract/index.d.ts +2 -0
  160. package/lib/helpers/reporting-contract/index.js +18 -0
  161. package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
  162. package/lib/helpers/reporting-contract/overview-contract.js +127 -0
  163. package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
  164. package/lib/helpers/reporting-contract/report-contract.js +239 -0
  165. package/lib/helpers/rider-earnings/index.d.ts +1 -0
  166. package/lib/helpers/rider-earnings/index.js +17 -0
  167. package/lib/helpers/rider-earnings/rider-earnings.d.ts +51 -0
  168. package/lib/helpers/rider-earnings/rider-earnings.js +57 -0
  169. package/lib/helpers/rider-reports/index.d.ts +2 -0
  170. package/lib/helpers/rider-reports/index.js +18 -0
  171. package/lib/helpers/rider-reports/rider-daily-report.d.ts +28 -0
  172. package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
  173. package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
  174. package/lib/helpers/rider-reports/rider-report.js +70 -0
  175. package/lib/helpers/store/common-order-actions.js +3 -2
  176. package/lib/helpers/types/materialized-reports-apis.d.ts +300 -1
  177. package/lib/schemas/models/deliveries.d.ts +58 -1
  178. package/lib/schemas/models/deliveries.js +81 -0
  179. package/lib/schemas/models/expense_details.d.ts +3 -3
  180. package/lib/schemas/models/index.d.ts +15 -0
  181. package/lib/schemas/models/index.js +15 -0
  182. package/lib/schemas/models/materialized_credit_bills.d.ts +3 -3
  183. package/lib/schemas/models/materialized_credit_bills.js +1 -1
  184. package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
  185. package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
  186. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
  187. package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
  188. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
  189. package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
  190. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
  191. package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
  192. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
  193. package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
  194. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
  195. package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
  196. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
  197. package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
  198. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
  199. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
  200. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
  201. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
  202. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
  203. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
  204. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
  205. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
  206. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
  207. package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
  208. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
  209. package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
  210. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
  211. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
  212. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
  213. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
  214. package/lib/schemas/models/materialized_tenant_sales_overview_reports.d.ts +3 -3
  215. package/lib/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
  216. package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
  217. package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
  218. package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
  219. package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
  220. package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
  221. package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
  222. package/lib/schemas/types/deliveries.d.ts +40 -1
  223. package/lib/schemas/types/index.d.ts +15 -0
  224. package/lib/schemas/types/index.js +15 -0
  225. package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
  226. package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
  227. package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
  228. package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
  229. package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
  230. package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
  231. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
  232. package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
  233. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
  234. package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
  235. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
  236. package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
  237. package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
  238. package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
  239. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
  240. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
  241. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
  242. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
  243. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
  244. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
  245. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
  246. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
  247. package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
  248. package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
  249. package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
  250. package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
  251. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
  252. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
  253. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
  254. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
  255. package/lib/schemas/types/materialized_tenant_sales_overview_reports.d.ts +7 -0
  256. package/lib/tests/deliveries-schema.test.d.ts +1 -0
  257. package/lib/tests/deliveries-schema.test.js +70 -0
  258. package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
  259. package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
  260. package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
  261. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  262. package/lib/tests/materialized-reports/fixtures.js +1 -0
  263. package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
  264. package/lib/tests/materialized-reports/materialized-cash-compile.test.js +197 -0
  265. package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
  266. package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
  267. package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
  268. package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +153 -0
  269. package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
  270. package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
  271. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
  272. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
  273. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
  274. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
  275. package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
  276. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +242 -0
  277. package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
  278. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
  279. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
  280. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +142 -0
  281. package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
  282. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
  283. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
  284. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
  285. package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
  286. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
  287. package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
  288. package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
  289. package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
  290. package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
  291. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
  292. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
  293. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
  294. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
  295. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
  296. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
  297. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
  298. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
  299. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
  300. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
  301. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
  302. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
  303. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
  304. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
  305. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
  306. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
  307. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
  308. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
  309. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
  310. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
  311. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
  312. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +271 -0
  313. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
  314. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
  315. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
  316. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
  317. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
  318. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
  319. package/lib/tests/materialized-reports/materialized-reports-scope-group-helpers.test.js +13 -13
  320. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
  321. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
  322. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
  323. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +207 -0
  324. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
  325. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
  326. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
  327. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
  328. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
  329. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
  330. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
  331. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
  332. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
  333. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
  334. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
  335. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
  336. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
  337. package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
  338. package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
  339. package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
  340. package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
  341. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
  342. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
  343. package/lib/tests/reporting-contract.test.d.ts +1 -0
  344. package/lib/tests/reporting-contract.test.js +267 -0
  345. package/lib/tests/rider-daily-report.test.d.ts +1 -0
  346. package/lib/tests/rider-daily-report.test.js +86 -0
  347. package/lib/tests/rider-earnings.test.d.ts +1 -0
  348. package/lib/tests/rider-earnings.test.js +65 -0
  349. package/lib/tests/rider-report.test.d.ts +1 -0
  350. package/lib/tests/rider-report.test.js +98 -0
  351. package/package.json +10 -1
@@ -0,0 +1,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,157 @@
1
+ import { MATERIALIZED_REPORT_SCOPE_ENUM, } from '../../constants/MATERIALIZED_REPORTS';
2
+ import { convertPriceFromCents } from '../utils/price-conversion';
3
+ import { parseMaterializedCashKey } from './materialized-cash-compile-helpers';
4
+ import { freshCashCounters } from './materialized-cash-classification-helpers';
5
+ import { mergeMaterializedCashCounters } from './materialized-cash-accumulator-helpers';
6
+ const toDecimal = (cents) => convertPriceFromCents(cents ?? 0);
7
+ const isDayScope = (scopeContext) => String(scopeContext) === MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE;
8
+ /** True when a key passes the caller-supplied drawer / ref-type filters. */
9
+ function keyPassesFilters(key, filters) {
10
+ const parsed = parseMaterializedCashKey(key);
11
+ if (parsed == null)
12
+ return true; // never hide a row we cannot parse
13
+ const drawers = filters.drawer_ids;
14
+ if (drawers != null && drawers.length > 0 && !drawers.includes(parsed.drawerId))
15
+ return false;
16
+ const refs = filters.ref_types;
17
+ if (refs != null && refs.length > 0 && !refs.includes(parsed.refType))
18
+ return false;
19
+ return true;
20
+ }
21
+ /** Accumulates one page of data for ONE tenant (or the folded brand view). */
22
+ function buildPageForTenant(tenantIds, docs, filters) {
23
+ const total = freshCashCounters();
24
+ const byDrawer = new Map();
25
+ const byRef = new Map();
26
+ const trend = [];
27
+ const weekday = new Map();
28
+ let sawDayScope = false;
29
+ const drawerNames = new Map();
30
+ for (const doc of docs) {
31
+ if (isDayScope(doc.scope_context))
32
+ sawDayScope = true;
33
+ const counters = doc.cash_counters ?? {};
34
+ const daySessions = { variance: 0, counted: 0, ledger: 0 };
35
+ for (const [key, block] of Object.entries(counters)) {
36
+ if (!keyPassesFilters(key, filters))
37
+ continue;
38
+ const parsed = parseMaterializedCashKey(key);
39
+ const drawerId = parsed?.drawerId ?? key;
40
+ mergeMaterializedCashCounters(total, block);
41
+ const drawerBlock = byDrawer.get(drawerId) ?? freshCashCounters();
42
+ mergeMaterializedCashCounters(drawerBlock, block);
43
+ byDrawer.set(drawerId, drawerBlock);
44
+ for (const [refType, flow] of Object.entries(block.movements.by_ref ?? {})) {
45
+ const bucket = byRef.get(refType) ?? { in_amount: 0, out_amount: 0, count: 0 };
46
+ bucket.in_amount += Number(flow?.in_amount) || 0;
47
+ bucket.out_amount += Number(flow?.out_amount) || 0;
48
+ bucket.count += (Number(flow?.in_count) || 0) + (Number(flow?.out_count) || 0);
49
+ byRef.set(refType, bucket);
50
+ }
51
+ daySessions.variance += Number(block.sessions?.variance_amount) || 0;
52
+ daySessions.counted += Number(block.sessions?.counted_close_amount) || 0;
53
+ daySessions.ledger += Number(block.movements?.ledger_net) || 0;
54
+ }
55
+ if (isDayScope(doc.scope_context)) {
56
+ trend.push({
57
+ scope_field: String(doc.scope_field),
58
+ variance: toDecimal(daySessions.variance),
59
+ counted_close: toDecimal(daySessions.counted),
60
+ });
61
+ const weekdayKey = doc.day_index == null ? null : String(doc.day_index);
62
+ if (weekdayKey != null) {
63
+ const bucket = weekday.get(weekdayKey) ?? { variance: 0, ledger_net: 0 };
64
+ bucket.variance += daySessions.variance;
65
+ bucket.ledger_net += daySessions.ledger;
66
+ weekday.set(weekdayKey, bucket);
67
+ }
68
+ }
69
+ }
70
+ const movements = total.movements;
71
+ const sessions = total.sessions;
72
+ return {
73
+ tenant_ids: tenantIds,
74
+ summary: {
75
+ cash_in: toDecimal(movements.in_amount),
76
+ cash_out: toDecimal(movements.out_amount),
77
+ ledger_net: toDecimal(movements.ledger_net),
78
+ operator_net: toDecimal(movements.operator.net),
79
+ reopen_amount: toDecimal(movements.lifecycle.reopen_amount),
80
+ opening_float: toDecimal(movements.lifecycle.float_amount),
81
+ count_out: toDecimal(movements.lifecycle.countout_amount),
82
+ system_net: toDecimal(movements.system.net),
83
+ movement_count: movements.count,
84
+ expected_close: toDecimal(sessions.expected_close_amount),
85
+ counted_close: toDecimal(sessions.counted_close_amount),
86
+ variance: toDecimal(sessions.variance_amount),
87
+ over_count: sessions.variance_negative_count,
88
+ short_count: sessions.variance_positive_count,
89
+ open_sessions: sessions.open_sessions_count,
90
+ session_count: sessions.session_count,
91
+ reopen_count: sessions.reopen_count,
92
+ unmatched_close_count: sessions.unmatched_close_count,
93
+ },
94
+ by_drawer: [...byDrawer.entries()]
95
+ .map(([drawerId, block]) => ({
96
+ drawer_id: drawerId,
97
+ drawer_name: drawerNames.get(drawerId) ?? null,
98
+ cash_in: toDecimal(block.movements.in_amount),
99
+ cash_out: toDecimal(block.movements.out_amount),
100
+ ledger_net: toDecimal(block.movements.ledger_net),
101
+ variance: toDecimal(block.sessions.variance_amount),
102
+ session_count: block.sessions.session_count,
103
+ reopen_count: block.sessions.reopen_count,
104
+ }))
105
+ .sort((a, b) => b.ledger_net - a.ledger_net),
106
+ // Empty ref types are DROPPED: storage keeps all five enum members so a fold
107
+ // stays shape-stable, but a breakdown table must not show rows the filter
108
+ // excluded (or five zero rows for a day that only touched one).
109
+ by_ref: [...byRef.entries()]
110
+ .filter(([, flow]) => flow.count > 0 || flow.in_amount > 0 || flow.out_amount > 0)
111
+ .map(([refType, flow]) => ({
112
+ ref_type: refType,
113
+ in_amount: toDecimal(flow.in_amount),
114
+ out_amount: toDecimal(flow.out_amount),
115
+ count: flow.count,
116
+ }))
117
+ .sort((a, b) => b.in_amount + b.out_amount - (a.in_amount + a.out_amount)),
118
+ variance_trend: sawDayScope ? trend.sort((a, b) => (a.scope_field < b.scope_field ? -1 : 1)) : null,
119
+ weekday: sawDayScope
120
+ ? [...weekday.entries()].map(([dayIndex, bucket]) => ({
121
+ day_index: dayIndex,
122
+ variance: toDecimal(bucket.variance),
123
+ ledger_net: toDecimal(bucket.ledger_net),
124
+ }))
125
+ : null,
126
+ };
127
+ }
128
+ /**
129
+ * Formats cash documents into page data.
130
+ *
131
+ * `separate_view_per_tenant` yields one entry per tenant; otherwise every tenant is
132
+ * folded into a single brand view. Returns null on unusable input rather than an empty
133
+ * page, so the caller can tell "no data" from "malformed request".
134
+ */
135
+ export function getFormattedTenantCashInOutReporting(docs, filters, separate_view_per_tenant) {
136
+ if (!Array.isArray(docs) || docs.length === 0)
137
+ return null;
138
+ const usable = docs.filter((doc) => doc != null && doc.cash_counters != null);
139
+ if (usable.length === 0)
140
+ return null;
141
+ const resolvedFilters = filters ?? {};
142
+ if (separate_view_per_tenant === true) {
143
+ const byTenant = new Map();
144
+ for (const doc of usable) {
145
+ const tenantId = String(doc.tenant_id);
146
+ const bucket = byTenant.get(tenantId) ?? [];
147
+ bucket.push(doc);
148
+ byTenant.set(tenantId, bucket);
149
+ }
150
+ return [
151
+ [...byTenant.entries()].map(([tenantId, tenantDocs]) => buildPageForTenant([tenantId], tenantDocs, resolvedFilters)),
152
+ null,
153
+ ];
154
+ }
155
+ const tenantIds = [...new Set(usable.map((doc) => String(doc.tenant_id)))].sort();
156
+ return [[buildPageForTenant(tenantIds, usable, resolvedFilters)], null];
157
+ }
@@ -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, MATERIALIZED_REPORT_SCOPE_ENUM, } 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) === MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE;
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
+ }