@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,282 @@
1
+ import { MATERIALIZED_REPORT_KEY_FILTER_ENUM, PAYMENTS_COMPARISON_METRIC_ENUM, } from '../../constants/MATERIALIZED_REPORTS';
2
+ import { ORDER_STATUS_ENUM } from '../../constants/ENUMS';
3
+ import { parseMaterializedReportKey } from './key-helpers';
4
+ import { convertPriceFromCents } from '../utils/price-conversion';
5
+ const matchedDocumentsOf = (doc) => ('matched_documents' in doc ? doc.matched_documents : 1);
6
+ const updatedAtOf = (doc) => 'max_updated_at' in doc ? doc.max_updated_at : doc.updatedAt;
7
+ const METRICS = [
8
+ PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_AMOUNT,
9
+ PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_COUNT,
10
+ PAYMENTS_COMPARISON_METRIC_ENUM.AVERAGE_PAYMENT,
11
+ PAYMENTS_COMPARISON_METRIC_ENUM.CARD_CHARGES,
12
+ PAYMENTS_COMPARISON_METRIC_ENUM.REFUNDED_AMOUNT,
13
+ PAYMENTS_COMPARISON_METRIC_ENUM.AMOUNT_DUE,
14
+ ];
15
+ const toDecimal = (cents) => convertPriceFromCents(cents ?? 0);
16
+ export const createEmptyPaymentsComparisonFormattedCounters = () => ({
17
+ payment_count: 0,
18
+ payment_amount: 0,
19
+ amount_due: 0,
20
+ amount_paid: 0,
21
+ amount_refunded: 0,
22
+ card_charges: 0,
23
+ refund_count: 0,
24
+ unpaid_count: 0,
25
+ });
26
+ const formatCounters = (counters) => ({
27
+ payment_count: counters?.payment_count ?? 0,
28
+ payment_amount: toDecimal(counters?.payment_amount),
29
+ amount_due: toDecimal(counters?.amount_due),
30
+ amount_paid: toDecimal(counters?.amount_paid),
31
+ amount_refunded: toDecimal(counters?.amount_refunded),
32
+ card_charges: toDecimal(counters?.card_charges),
33
+ refund_count: counters?.refund_count ?? 0,
34
+ unpaid_count: counters?.unpaid_count ?? 0,
35
+ });
36
+ export const formatPaymentsComparisonSeries = (counters) => {
37
+ const formatted = formatCounters(counters);
38
+ return {
39
+ counters: formatted,
40
+ average_payment: formatted.payment_count > 0 ? formatted.payment_amount / formatted.payment_count : null,
41
+ };
42
+ };
43
+ const seriesMetric = (series, metric) => {
44
+ switch (metric) {
45
+ case PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_AMOUNT:
46
+ return series.counters.payment_amount;
47
+ case PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_COUNT:
48
+ return series.counters.payment_count;
49
+ case PAYMENTS_COMPARISON_METRIC_ENUM.AVERAGE_PAYMENT:
50
+ return series.average_payment;
51
+ case PAYMENTS_COMPARISON_METRIC_ENUM.CARD_CHARGES:
52
+ return series.counters.card_charges;
53
+ case PAYMENTS_COMPARISON_METRIC_ENUM.REFUNDED_AMOUNT:
54
+ return series.counters.amount_refunded;
55
+ case PAYMENTS_COMPARISON_METRIC_ENUM.AMOUNT_DUE:
56
+ return series.counters.amount_due;
57
+ default:
58
+ return null;
59
+ }
60
+ };
61
+ const percentDelta = (current, comparison) => {
62
+ if (current == null || comparison == null)
63
+ return null;
64
+ if (comparison === 0)
65
+ return current === 0 ? 0 : null;
66
+ return ((current - comparison) / Math.abs(comparison)) * 100;
67
+ };
68
+ export function buildPaymentsComparisonMetrics(current, comparison) {
69
+ const metrics = {};
70
+ for (const metric of METRICS) {
71
+ const currentValue = seriesMetric(current, metric);
72
+ const comparisonValue = comparison == null ? null : seriesMetric(comparison, metric);
73
+ metrics[metric] = {
74
+ current: currentValue,
75
+ comparison: comparisonValue,
76
+ delta: currentValue == null || comparisonValue == null ? null : currentValue - comparisonValue,
77
+ delta_percent: percentDelta(currentValue, comparisonValue),
78
+ };
79
+ }
80
+ return metrics;
81
+ }
82
+ const parseKey = (key, keyFilters) => {
83
+ const components = parseMaterializedReportKey(key);
84
+ if (components == null || components.length !== keyFilters.length)
85
+ return null;
86
+ let paymentMethod = null;
87
+ let orderStatus = null;
88
+ for (let index = 0; index < keyFilters.length; index += 1) {
89
+ if (keyFilters[index] === MATERIALIZED_REPORT_KEY_FILTER_ENUM.PAYMENT_METHOD) {
90
+ paymentMethod = components[index];
91
+ }
92
+ else if (keyFilters[index] === MATERIALIZED_REPORT_KEY_FILTER_ENUM.ORDER_STATUS) {
93
+ orderStatus = components[index];
94
+ }
95
+ }
96
+ return { payment_method: paymentMethod, order_status: orderStatus };
97
+ };
98
+ const isCancelled = (orderStatus) => orderStatus === ORDER_STATUS_ENUM.CANCELLED;
99
+ const includesCancelled = (filters) => Array.isArray(filters.order_statuses) && filters.order_statuses.includes(ORDER_STATUS_ENUM.CANCELLED);
100
+ const matchesFilters = (parsed, filters) => {
101
+ if (filters.payment_methods != null &&
102
+ filters.payment_methods.length > 0 &&
103
+ (parsed.payment_method == null || !filters.payment_methods.includes(parsed.payment_method))) {
104
+ return false;
105
+ }
106
+ if (filters.order_statuses != null &&
107
+ filters.order_statuses.length > 0 &&
108
+ (parsed.order_status == null || !filters.order_statuses.includes(parsed.order_status))) {
109
+ return false;
110
+ }
111
+ return true;
112
+ };
113
+ const buildPage = (group, filters) => {
114
+ const keyFilters = (group.currentDocs[0]?.sale_type_key_filters ?? []);
115
+ const includeCancelled = includesCancelled(filters);
116
+ const fold = (docs) => {
117
+ const byKey = new Map();
118
+ const total = createEmptyPaymentsComparisonFormattedCountersRaw();
119
+ const cancelled = createEmptyPaymentsComparisonFormattedCountersRaw();
120
+ let matchedDocuments = 0;
121
+ let maxUpdatedAt = null;
122
+ for (const doc of docs ?? []) {
123
+ if (doc == null)
124
+ continue;
125
+ matchedDocuments += matchedDocumentsOf(doc);
126
+ const updatedAt = updatedAtOf(doc);
127
+ if (updatedAt != null) {
128
+ const date = new Date(updatedAt);
129
+ if (!Number.isNaN(date.getTime()) && (maxUpdatedAt == null || date.getTime() > maxUpdatedAt.getTime())) {
130
+ maxUpdatedAt = date;
131
+ }
132
+ }
133
+ for (const [key, counters] of Object.entries(doc.payment_counters ?? {})) {
134
+ const parsed = parseKey(key, keyFilters);
135
+ if (parsed == null || !matchesFilters(parsed, filters))
136
+ continue;
137
+ const target = byKey.get(key) ?? createEmptyPaymentsComparisonFormattedCountersRaw();
138
+ addRaw(target, counters);
139
+ byKey.set(key, target);
140
+ if (isCancelled(parsed.order_status) && !includeCancelled) {
141
+ addRaw(cancelled, counters);
142
+ }
143
+ else {
144
+ addRaw(total, counters);
145
+ }
146
+ }
147
+ }
148
+ return { byKey, total, cancelled, matchedDocuments, maxUpdatedAt };
149
+ };
150
+ const currentFold = fold(group.currentDocs);
151
+ const comparisonFold = group.comparisonDocs == null ? null : fold(group.comparisonDocs);
152
+ const rows = [];
153
+ for (const key of currentFold.byKey.keys()) {
154
+ const parsed = parseKey(key, keyFilters);
155
+ if (parsed == null)
156
+ continue;
157
+ const current = formatPaymentsComparisonSeries(currentFold.byKey.get(key));
158
+ const comparison = comparisonFold == null ? null : formatPaymentsComparisonSeries(comparisonFold.byKey.get(key));
159
+ rows.push({
160
+ key,
161
+ payment_method: parsed.payment_method,
162
+ order_status: parsed.order_status,
163
+ current,
164
+ comparison,
165
+ metrics: buildPaymentsComparisonMetrics(current, comparison),
166
+ });
167
+ }
168
+ rows.sort((a, b) => b.current.counters.payment_amount - a.current.counters.payment_amount || a.key.localeCompare(b.key));
169
+ const methodRows = new Map();
170
+ for (const row of rows) {
171
+ if (row.payment_method == null)
172
+ continue;
173
+ if (isCancelled(row.order_status) && !includeCancelled)
174
+ continue;
175
+ const existing = methodRows.get(row.payment_method) ?? {
176
+ payment_method: row.payment_method,
177
+ current: formatPaymentsComparisonSeries(undefined),
178
+ comparison: comparisonFold == null ? null : formatPaymentsComparisonSeries(undefined),
179
+ metrics: {},
180
+ };
181
+ existing.current = sumFormattedSeries(existing.current, row.current);
182
+ if (existing.comparison != null && row.comparison != null) {
183
+ existing.comparison = sumFormattedSeries(existing.comparison, row.comparison);
184
+ }
185
+ methodRows.set(row.payment_method, existing);
186
+ }
187
+ for (const methodRow of methodRows.values()) {
188
+ methodRow.metrics = buildPaymentsComparisonMetrics(methodRow.current, methodRow.comparison);
189
+ }
190
+ const current = formatPaymentsComparisonSeries(currentFold.total);
191
+ const comparison = comparisonFold == null ? null : formatPaymentsComparisonSeries(comparisonFold.total);
192
+ return {
193
+ tenant_ids: [...group.tenantIds].sort(),
194
+ filters: {
195
+ payment_methods: filters.payment_methods != null && filters.payment_methods.length > 0 ? [...filters.payment_methods] : null,
196
+ order_statuses: filters.order_statuses != null && filters.order_statuses.length > 0 ? [...filters.order_statuses] : null,
197
+ },
198
+ current,
199
+ comparison,
200
+ metrics: buildPaymentsComparisonMetrics(current, comparison),
201
+ cancelled: formatPaymentsComparisonSeries(currentFold.cancelled),
202
+ rows,
203
+ by_method: [...methodRows.values()].sort((a, b) => b.current.counters.payment_amount - a.current.counters.payment_amount ||
204
+ a.payment_method.localeCompare(b.payment_method)),
205
+ matched_documents: currentFold.matchedDocuments,
206
+ max_updated_at: currentFold.maxUpdatedAt,
207
+ };
208
+ };
209
+ function createEmptyPaymentsComparisonFormattedCountersRaw() {
210
+ return {
211
+ payment_count: 0,
212
+ payment_amount: 0,
213
+ amount_due: 0,
214
+ amount_paid: 0,
215
+ amount_refunded: 0,
216
+ card_charges: 0,
217
+ refund_count: 0,
218
+ unpaid_count: 0,
219
+ };
220
+ }
221
+ function addRaw(target, source) {
222
+ target.payment_count += source.payment_count ?? 0;
223
+ target.payment_amount += source.payment_amount ?? 0;
224
+ target.amount_due += source.amount_due ?? 0;
225
+ target.amount_paid += source.amount_paid ?? 0;
226
+ target.amount_refunded += source.amount_refunded ?? 0;
227
+ target.card_charges += source.card_charges ?? 0;
228
+ target.refund_count += source.refund_count ?? 0;
229
+ target.unpaid_count += source.unpaid_count ?? 0;
230
+ }
231
+ function sumFormattedSeries(a, b) {
232
+ const counters = {
233
+ payment_count: a.counters.payment_count + b.counters.payment_count,
234
+ payment_amount: a.counters.payment_amount + b.counters.payment_amount,
235
+ amount_due: a.counters.amount_due + b.counters.amount_due,
236
+ amount_paid: a.counters.amount_paid + b.counters.amount_paid,
237
+ amount_refunded: a.counters.amount_refunded + b.counters.amount_refunded,
238
+ card_charges: a.counters.card_charges + b.counters.card_charges,
239
+ refund_count: a.counters.refund_count + b.counters.refund_count,
240
+ unpaid_count: a.counters.unpaid_count + b.counters.unpaid_count,
241
+ };
242
+ return {
243
+ counters,
244
+ average_payment: counters.payment_count > 0 ? counters.payment_amount / counters.payment_count : null,
245
+ };
246
+ }
247
+ export function getFormattedTenantPaymentsComparisonReporting(currentDocs, comparisonDocs, filters = null, separate_view_per_tenant = false) {
248
+ if (!Array.isArray(currentDocs) || currentDocs.length === 0)
249
+ return null;
250
+ if (currentDocs.some((doc) => doc == null))
251
+ return null;
252
+ if (comparisonDocs != null && !Array.isArray(comparisonDocs))
253
+ return null;
254
+ if (filters != null) {
255
+ if (filters.payment_methods != null && !Array.isArray(filters.payment_methods))
256
+ return null;
257
+ if (filters.order_statuses != null && !Array.isArray(filters.order_statuses))
258
+ return null;
259
+ }
260
+ const resolvedFilters = filters ?? {};
261
+ const signature = (currentDocs[0].sale_type_key_filters ?? []).join(':');
262
+ for (const doc of [...currentDocs, ...(comparisonDocs ?? [])]) {
263
+ if ((doc.sale_type_key_filters ?? []).join(':') !== signature)
264
+ return null;
265
+ }
266
+ const usableCurrent = currentDocs.filter((doc) => doc.payment_counters != null);
267
+ if (usableCurrent.length === 0)
268
+ return null;
269
+ const allTenantIds = [...new Set(usableCurrent.map((doc) => String(doc.tenant_id)))].sort();
270
+ const scopes = separate_view_per_tenant ? allTenantIds.map((tenantId) => [tenantId]) : [allTenantIds];
271
+ const pages = [];
272
+ for (const scope of scopes) {
273
+ const currentForScope = usableCurrent.filter((doc) => scope.includes(String(doc.tenant_id)));
274
+ if (currentForScope.length === 0)
275
+ continue;
276
+ const comparisonForScope = comparisonDocs == null ? null : comparisonDocs.filter((doc) => scope.includes(String(doc.tenant_id)));
277
+ const page = buildPage({ tenantIds: scope, currentDocs: currentForScope, comparisonDocs: comparisonForScope }, resolvedFilters);
278
+ if (page != null)
279
+ pages.push(page);
280
+ }
281
+ return pages.length === 0 ? null : [pages, null];
282
+ }
@@ -0,0 +1,228 @@
1
+ import { MATERIALIZED_PREP_TIME_BUCKETS, MATERIALIZED_REPORT_SCOPE_ENUM, MATERIALIZED_REPORT_SCOPES_WITH_DAY_INDEX, } from '../../constants/MATERIALIZED_REPORTS';
2
+ import { parseMaterializedReportKey } from './key-helpers';
3
+ import { freshMaterializedPrepTimeCounters } from './materialized-prep-time-classification-helpers';
4
+ import { mergeMaterializedPrepTimeCounters } from './materialized-prep-time-compile-helpers';
5
+ const toPercent = (part, whole) => (whole > 0 ? Math.round((part / whole) * 1000) / 10 : 0);
6
+ /**
7
+ * Bucket-approximate percentile: the label of the bucket where the cumulative
8
+ * count first reaches the requested share. Percentiles from a histogram are
9
+ * approximate by nature - which is exactly why the UI renders the histogram.
10
+ */
11
+ const percentileBucket = (buckets, share) => {
12
+ const total = buckets.reduce((sum, bucket) => sum + bucket.count, 0);
13
+ if (total <= 0)
14
+ return null;
15
+ const target = total * share;
16
+ let cumulative = 0;
17
+ for (const bucket of buckets) {
18
+ cumulative += bucket.count;
19
+ if (cumulative >= target)
20
+ return bucket.label;
21
+ }
22
+ return buckets[buckets.length - 1]?.label ?? null;
23
+ };
24
+ /** Key -> its two components, so the platform rollup needs no second pass. */
25
+ const splitKey = (key) => {
26
+ const parsed = parseMaterializedReportKey(key);
27
+ const parts = Array.isArray(parsed) ? parsed : null;
28
+ if (parts == null || parts.length < 2)
29
+ return { status: '', platform: '' };
30
+ return { status: String(parts[0]), platform: String(parts[1]) };
31
+ };
32
+ const matchesFilters = (key, filters) => {
33
+ if (filters == null)
34
+ return true;
35
+ const { status, platform } = splitKey(key);
36
+ const platforms = filters.platforms;
37
+ if (platforms != null && platforms.length > 0 && !platforms.includes(platform))
38
+ return false;
39
+ const statuses = filters.order_statuses;
40
+ if (statuses != null && statuses.length > 0 && !statuses.includes(status))
41
+ return false;
42
+ return true;
43
+ };
44
+ const emptySummary = () => ({
45
+ items: 0,
46
+ ready_items: 0,
47
+ tracked_items: 0,
48
+ own_anchor_items: 0,
49
+ coverage_percent: 0,
50
+ own_coverage_percent: 0,
51
+ avg_minutes: null,
52
+ median_bucket: null,
53
+ p90_bucket: null,
54
+ instant_percent: null,
55
+ on_time_count: 0,
56
+ late_count: 0,
57
+ promise_baseline_count: 0,
58
+ default_baseline_count: 0,
59
+ unmeasurable_count: 0,
60
+ });
61
+ const buildBuckets = (counters) => {
62
+ const total = counters.duration.count;
63
+ return MATERIALIZED_PREP_TIME_BUCKETS.map((bucket) => {
64
+ const count = counters.duration.buckets[bucket.label] ?? 0;
65
+ return { label: bucket.label, count, percent: toPercent(count, total) };
66
+ });
67
+ };
68
+ const buildSummary = (counters) => {
69
+ const coverage = counters.coverage;
70
+ const duration = counters.duration;
71
+ const promise = counters.promise;
72
+ const buckets = buildBuckets(counters);
73
+ return {
74
+ items: coverage.item_count,
75
+ ready_items: coverage.ready_item_count,
76
+ tracked_items: coverage.tracked_count,
77
+ own_anchor_items: coverage.own_anchor_count,
78
+ coverage_percent: toPercent(coverage.tracked_count, coverage.item_count),
79
+ own_coverage_percent: toPercent(coverage.own_anchor_count, coverage.tracked_count),
80
+ // Exact, from the sum - never derived from the histogram.
81
+ avg_minutes: duration.count > 0 ? Math.round((duration.sum / duration.count) * 10) / 10 : null,
82
+ median_bucket: percentileBucket(buckets, 0.5),
83
+ p90_bucket: percentileBucket(buckets, 0.9),
84
+ instant_percent: duration.count > 0 ? toPercent(duration.instant_count, duration.count) : null,
85
+ on_time_count: promise.on_time_count,
86
+ late_count: promise.late_count,
87
+ promise_baseline_count: promise.promise_set_count,
88
+ default_baseline_count: promise.default_baseline_count,
89
+ unmeasurable_count: promise.no_target_count,
90
+ };
91
+ };
92
+ const emptyPage = (tenantIds) => {
93
+ const counters = freshMaterializedPrepTimeCounters();
94
+ return {
95
+ tenant_ids: tenantIds,
96
+ summary: emptySummary(),
97
+ buckets: buildBuckets(counters),
98
+ by_platform: [],
99
+ late: null,
100
+ weekday: null,
101
+ };
102
+ };
103
+ const freshGroup = (tenantId) => ({
104
+ tenantId,
105
+ counters: freshMaterializedPrepTimeCounters(),
106
+ platforms: new Map(),
107
+ weekday: new Map(),
108
+ sawDayIndex: false,
109
+ });
110
+ const addToGroup = (group, doc, filters) => {
111
+ const dayIndexScoped = MATERIALIZED_REPORT_SCOPES_WITH_DAY_INDEX.includes(doc.scope_context);
112
+ const dayIndex = (doc.day_index ?? null);
113
+ if (dayIndexScoped && dayIndex != null)
114
+ group.sawDayIndex = true;
115
+ for (const [key, counters] of Object.entries(doc.prep_time_counters ?? {})) {
116
+ if (!matchesFilters(key, filters))
117
+ continue;
118
+ mergeMaterializedPrepTimeCounters(group.counters, counters);
119
+ const platform = splitKey(key).platform;
120
+ const platformBucket = group.platforms.get(platform) ?? freshMaterializedPrepTimeCounters();
121
+ mergeMaterializedPrepTimeCounters(platformBucket, counters);
122
+ group.platforms.set(platform, platformBucket);
123
+ if (dayIndexScoped && dayIndex != null) {
124
+ const weekBucket = group.weekday.get(dayIndex) ?? freshMaterializedPrepTimeCounters();
125
+ mergeMaterializedPrepTimeCounters(weekBucket, counters);
126
+ group.weekday.set(dayIndex, weekBucket);
127
+ }
128
+ }
129
+ };
130
+ const buildPage = (group) => {
131
+ const byPlatform = [...group.platforms.entries()]
132
+ .map(([platform, counters]) => ({
133
+ platform,
134
+ tracked: counters.coverage.tracked_count,
135
+ own: counters.coverage.own_anchor_count,
136
+ avg_minutes: counters.duration.count > 0 ? Math.round((counters.duration.sum / counters.duration.count) * 10) / 10 : null,
137
+ median_bucket: percentileBucket(buildBuckets(counters), 0.5),
138
+ }))
139
+ .sort((a, b) => b.tracked - a.tracked || a.platform.localeCompare(b.platform));
140
+ const weekday = group.sawDayIndex && group.weekday.size > 0
141
+ ? [...group.weekday.entries()]
142
+ .map(([dayIndex, counters]) => ({
143
+ day_index: dayIndex,
144
+ tracked: counters.coverage.tracked_count,
145
+ own: counters.coverage.own_anchor_count,
146
+ avg_minutes: counters.duration.count > 0
147
+ ? Math.round((counters.duration.sum / counters.duration.count) * 10) / 10
148
+ : null,
149
+ }))
150
+ .sort((a, b) => String(a.day_index).localeCompare(String(b.day_index)))
151
+ : null;
152
+ const lateCount = group.counters.late_items.count;
153
+ const worst = group.counters.late_items.worst_delta;
154
+ return {
155
+ tenant_ids: [group.tenantId],
156
+ summary: buildSummary(group.counters),
157
+ buckets: buildBuckets(group.counters),
158
+ by_platform: byPlatform,
159
+ late: lateCount > 0 ? { count: lateCount, worst_delta_minutes: worst } : null,
160
+ weekday,
161
+ };
162
+ };
163
+ /**
164
+ * Formats materialized prep time documents into page-ready data - one entry per
165
+ * tenant (`separate_view_per_tenant`) or one combined entry. Returns null on
166
+ * unformattable input; an empty list yields a zero-filled page.
167
+ */
168
+ export function getFormattedTenantPrepTimeReporting(reports, filters = null, separate_view_per_tenant = false) {
169
+ if (!Array.isArray(reports) || reports.some((report) => report == null))
170
+ return null;
171
+ if (reports.length === 0)
172
+ return [[emptyPage([])], null];
173
+ const schemaVersion = reports[0].schema_version;
174
+ const keyFilterSignature = (reports[0].sale_type_key_filters ?? []).join(':');
175
+ for (const report of reports) {
176
+ if ((report.sale_type_key_filters ?? []).join(':') !== keyFilterSignature)
177
+ return null;
178
+ if (report.schema_version !== schemaVersion)
179
+ return null;
180
+ }
181
+ const groups = new Map();
182
+ for (const report of reports) {
183
+ const tenantId = String(report.tenant_id ?? '');
184
+ const key = separate_view_per_tenant ? tenantId : '__combined__';
185
+ const group = groups.get(key) ?? freshGroup(separate_view_per_tenant ? tenantId : '');
186
+ addToGroup(group, report, filters);
187
+ groups.set(key, group);
188
+ }
189
+ const pages = [...groups.values()].map(buildPage);
190
+ if (!separate_view_per_tenant && pages.length === 1) {
191
+ const all = reports.map((report) => String(report.tenant_id ?? ''));
192
+ pages[0].tenant_ids = [...new Set(all)].sort();
193
+ }
194
+ return [pages, null];
195
+ }
196
+ /**
197
+ * Entry point for the AGGREGATED read (one folded record per tenant, computed
198
+ * inside MongoDB). Delegates to the stored-document formatter after restoring the
199
+ * envelope fields it reads, so both paths share one shaping implementation.
200
+ *
201
+ * The folded record spans scope documents, so it has no single `day_index`;
202
+ * `weekday` therefore comes back null and a weekday filter is REFUSED rather than
203
+ * silently ignored (returning every weekday would be a wrong answer).
204
+ */
205
+ export function getFormattedTenantPrepTimeAggregatedReporting(reports, filters = null, separate_view_per_tenant = false) {
206
+ if (!Array.isArray(reports) || reports.some((report) => report == null))
207
+ return null;
208
+ if (filters != null && Array.isArray(filters.day_indexes) && filters.day_indexes.length > 0) {
209
+ return null;
210
+ }
211
+ const asStored = reports.map((report) => ({
212
+ _id: String(report.tenant_id) + '|aggregated',
213
+ tenant_id: report.tenant_id,
214
+ brand_id: report.brand_id,
215
+ scope_context: MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_MONTH,
216
+ scope_field: report.tenant_id,
217
+ day_index: null,
218
+ sale_type_key_filters: report.sale_type_key_filters,
219
+ prep_time_counters: report.prep_time_counters,
220
+ prep_time_counter_rows: report.prep_time_counter_rows ?? null,
221
+ schema_version: report.schema_version ?? 1,
222
+ source_watermark: report.max_updated_at ?? new Date(0),
223
+ computed_at: report.max_updated_at ?? new Date(0),
224
+ createdAt: report.max_updated_at ?? new Date(0),
225
+ updatedAt: report.max_updated_at ?? new Date(0),
226
+ }));
227
+ return getFormattedTenantPrepTimeReporting(asStored, filters, separate_view_per_tenant);
228
+ }