@managesome/eposmatic-toolkit 0.4.9 → 0.4.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (333) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +448 -0
  2. package/esm/helpers/index.js +3 -0
  3. package/esm/helpers/materialized-reports/index.js +32 -0
  4. package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
  5. package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +286 -0
  6. package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
  7. package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +244 -0
  8. package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
  9. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +426 -0
  10. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +372 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +214 -0
  12. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +318 -0
  13. package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
  14. package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
  15. package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
  16. package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
  17. package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
  18. package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +111 -0
  19. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +88 -0
  20. package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
  21. package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
  22. package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
  23. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +476 -0
  24. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
  25. package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +7 -0
  26. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
  27. package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +157 -0
  28. package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
  29. package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
  30. package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +156 -0
  31. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
  32. package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
  33. package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +237 -0
  34. package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +279 -0
  35. package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
  36. package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +343 -0
  37. package/esm/helpers/reporting-contract/index.js +2 -0
  38. package/esm/helpers/reporting-contract/overview-contract.js +122 -0
  39. package/esm/helpers/reporting-contract/report-contract.js +228 -0
  40. package/esm/helpers/rider-earnings/index.js +1 -0
  41. package/esm/helpers/rider-earnings/rider-earnings.js +59 -0
  42. package/esm/helpers/rider-reports/index.js +2 -0
  43. package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
  44. package/esm/helpers/rider-reports/rider-report.js +67 -0
  45. package/esm/schemas/models/deliveries.js +75 -0
  46. package/esm/schemas/models/index.js +15 -0
  47. package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
  48. package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
  49. package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
  50. package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
  51. package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
  52. package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
  53. package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
  54. package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
  55. package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
  56. package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
  57. package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
  58. package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
  59. package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
  60. package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
  61. package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
  62. package/esm/schemas/types/index.js +15 -0
  63. package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
  64. package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
  65. package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
  66. package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
  67. package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
  68. package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
  69. package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
  70. package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
  71. package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
  72. package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
  73. package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
  74. package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
  75. package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
  76. package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
  77. package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
  78. package/lib/constants/MATERIALIZED_REPORTS.d.ts +339 -2
  79. package/lib/constants/MATERIALIZED_REPORTS.js +450 -1
  80. package/lib/helpers/index.d.ts +3 -0
  81. package/lib/helpers/index.js +3 -0
  82. package/lib/helpers/materialized-reports/index.d.ts +32 -0
  83. package/lib/helpers/materialized-reports/index.js +32 -0
  84. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
  85. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
  86. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +90 -0
  87. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +295 -0
  88. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +102 -0
  89. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
  90. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +72 -0
  91. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +251 -0
  92. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
  93. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
  94. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +84 -0
  95. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +438 -0
  96. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +97 -0
  97. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +385 -0
  98. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +40 -0
  99. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +218 -0
  100. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
  101. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +324 -0
  102. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
  103. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
  104. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
  105. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
  106. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
  107. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
  108. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
  109. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
  110. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
  111. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
  112. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
  113. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +116 -0
  114. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
  115. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +98 -0
  116. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
  117. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
  118. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
  119. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
  120. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +66 -0
  121. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
  122. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +128 -0
  123. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +490 -0
  124. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +46 -0
  125. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
  126. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
  127. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +8 -1
  128. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
  129. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
  130. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
  131. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +161 -0
  132. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
  133. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
  134. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
  135. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
  136. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
  137. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +159 -0
  138. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
  139. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
  140. package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
  141. package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
  142. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
  143. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +243 -0
  144. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
  145. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +286 -0
  146. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +97 -0
  147. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
  148. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
  149. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +349 -0
  150. package/lib/helpers/reporting-contract/index.d.ts +2 -0
  151. package/lib/helpers/reporting-contract/index.js +18 -0
  152. package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
  153. package/lib/helpers/reporting-contract/overview-contract.js +126 -0
  154. package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
  155. package/lib/helpers/reporting-contract/report-contract.js +239 -0
  156. package/lib/helpers/rider-earnings/index.d.ts +1 -0
  157. package/lib/helpers/rider-earnings/index.js +17 -0
  158. package/lib/helpers/rider-earnings/rider-earnings.d.ts +58 -0
  159. package/lib/helpers/rider-earnings/rider-earnings.js +64 -0
  160. package/lib/helpers/rider-reports/index.d.ts +2 -0
  161. package/lib/helpers/rider-reports/index.js +18 -0
  162. package/lib/helpers/rider-reports/rider-daily-report.d.ts +26 -0
  163. package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
  164. package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
  165. package/lib/helpers/rider-reports/rider-report.js +70 -0
  166. package/lib/helpers/types/materialized-reports-apis.d.ts +297 -1
  167. package/lib/schemas/models/deliveries.d.ts +54 -0
  168. package/lib/schemas/models/deliveries.js +75 -0
  169. package/lib/schemas/models/expense_details.d.ts +3 -3
  170. package/lib/schemas/models/index.d.ts +15 -0
  171. package/lib/schemas/models/index.js +15 -0
  172. package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
  173. package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
  174. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
  175. package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
  176. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
  177. package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
  178. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
  179. package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
  180. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
  181. package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
  182. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
  183. package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
  184. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
  185. package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
  186. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
  187. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
  188. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
  189. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
  190. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
  191. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
  192. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
  193. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
  194. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
  195. package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
  196. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
  197. package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
  198. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
  199. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
  200. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
  201. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
  202. package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
  203. package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
  204. package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
  205. package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
  206. package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
  207. package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
  208. package/lib/schemas/types/deliveries.d.ts +40 -1
  209. package/lib/schemas/types/index.d.ts +15 -0
  210. package/lib/schemas/types/index.js +15 -0
  211. package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
  212. package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
  213. package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
  214. package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
  215. package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
  216. package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
  217. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
  218. package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
  219. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
  220. package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
  221. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
  222. package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
  223. package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
  224. package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
  225. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
  226. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
  227. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
  228. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
  229. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
  230. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
  231. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
  232. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
  233. package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
  234. package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
  235. package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
  236. package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
  237. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
  238. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
  239. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
  240. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
  241. package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
  242. package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
  243. package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
  244. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  245. package/lib/tests/materialized-reports/fixtures.js +1 -0
  246. package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
  247. package/lib/tests/materialized-reports/materialized-cash-compile.test.js +196 -0
  248. package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
  249. package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
  250. package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
  251. package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +152 -0
  252. package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
  253. package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
  254. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
  255. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
  256. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
  257. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
  258. package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
  259. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +241 -0
  260. package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
  261. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
  262. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
  263. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +141 -0
  264. package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
  265. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
  266. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
  267. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
  268. package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
  269. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
  270. package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
  271. package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
  272. package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
  273. package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
  274. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
  275. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
  276. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
  277. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
  278. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
  279. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
  280. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
  281. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
  282. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
  283. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
  284. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
  285. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
  286. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
  287. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
  288. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
  289. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
  290. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
  291. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
  292. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
  293. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
  294. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
  295. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +270 -0
  296. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
  297. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
  298. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
  299. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
  300. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
  301. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
  302. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
  303. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
  304. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
  305. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +206 -0
  306. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
  307. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
  308. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
  309. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
  310. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
  311. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
  312. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
  313. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
  314. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
  315. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
  316. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
  317. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
  318. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
  319. package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
  320. package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
  321. package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
  322. package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
  323. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
  324. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
  325. package/lib/tests/reporting-contract.test.d.ts +1 -0
  326. package/lib/tests/reporting-contract.test.js +267 -0
  327. package/lib/tests/rider-daily-report.test.d.ts +1 -0
  328. package/lib/tests/rider-daily-report.test.js +86 -0
  329. package/lib/tests/rider-earnings.test.d.ts +1 -0
  330. package/lib/tests/rider-earnings.test.js +65 -0
  331. package/lib/tests/rider-report.test.d.ts +1 -0
  332. package/lib/tests/rider-report.test.js +98 -0
  333. package/package.json +10 -1
@@ -0,0 +1,279 @@
1
+ import { MATERIALIZED_REPORT_KEY_FILTER_ENUM, PAYMENTS_COMPARISON_METRIC_ENUM, } from '../../constants/MATERIALIZED_REPORTS';
2
+ import { parseMaterializedReportKey } from './key-helpers';
3
+ import { convertPriceFromCents } from '../utils/price-conversion';
4
+ const METRICS = [
5
+ PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_AMOUNT,
6
+ PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_COUNT,
7
+ PAYMENTS_COMPARISON_METRIC_ENUM.AVERAGE_PAYMENT,
8
+ PAYMENTS_COMPARISON_METRIC_ENUM.CARD_CHARGES,
9
+ PAYMENTS_COMPARISON_METRIC_ENUM.REFUNDED_AMOUNT,
10
+ PAYMENTS_COMPARISON_METRIC_ENUM.AMOUNT_DUE,
11
+ ];
12
+ const toDecimal = (cents) => convertPriceFromCents(cents ?? 0);
13
+ export const createEmptyPaymentsComparisonFormattedCounters = () => ({
14
+ payment_count: 0,
15
+ payment_amount: 0,
16
+ amount_due: 0,
17
+ amount_paid: 0,
18
+ amount_refunded: 0,
19
+ card_charges: 0,
20
+ refund_count: 0,
21
+ unpaid_count: 0,
22
+ });
23
+ const formatCounters = (counters) => ({
24
+ payment_count: counters?.payment_count ?? 0,
25
+ payment_amount: toDecimal(counters?.payment_amount),
26
+ amount_due: toDecimal(counters?.amount_due),
27
+ amount_paid: toDecimal(counters?.amount_paid),
28
+ amount_refunded: toDecimal(counters?.amount_refunded),
29
+ card_charges: toDecimal(counters?.card_charges),
30
+ refund_count: counters?.refund_count ?? 0,
31
+ unpaid_count: counters?.unpaid_count ?? 0,
32
+ });
33
+ export const formatPaymentsComparisonSeries = (counters) => {
34
+ const formatted = formatCounters(counters);
35
+ return {
36
+ counters: formatted,
37
+ average_payment: formatted.payment_count > 0 ? formatted.payment_amount / formatted.payment_count : null,
38
+ };
39
+ };
40
+ const seriesMetric = (series, metric) => {
41
+ switch (metric) {
42
+ case PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_AMOUNT:
43
+ return series.counters.payment_amount;
44
+ case PAYMENTS_COMPARISON_METRIC_ENUM.PAYMENT_COUNT:
45
+ return series.counters.payment_count;
46
+ case PAYMENTS_COMPARISON_METRIC_ENUM.AVERAGE_PAYMENT:
47
+ return series.average_payment;
48
+ case PAYMENTS_COMPARISON_METRIC_ENUM.CARD_CHARGES:
49
+ return series.counters.card_charges;
50
+ case PAYMENTS_COMPARISON_METRIC_ENUM.REFUNDED_AMOUNT:
51
+ return series.counters.amount_refunded;
52
+ case PAYMENTS_COMPARISON_METRIC_ENUM.AMOUNT_DUE:
53
+ return series.counters.amount_due;
54
+ default:
55
+ return null;
56
+ }
57
+ };
58
+ const percentDelta = (current, comparison) => {
59
+ if (current == null || comparison == null)
60
+ return null;
61
+ if (comparison === 0)
62
+ return current === 0 ? 0 : null;
63
+ return ((current - comparison) / Math.abs(comparison)) * 100;
64
+ };
65
+ export function buildPaymentsComparisonMetrics(current, comparison) {
66
+ const metrics = {};
67
+ for (const metric of METRICS) {
68
+ const currentValue = seriesMetric(current, metric);
69
+ const comparisonValue = comparison == null ? null : seriesMetric(comparison, metric);
70
+ metrics[metric] = {
71
+ current: currentValue,
72
+ comparison: comparisonValue,
73
+ delta: currentValue == null || comparisonValue == null ? null : currentValue - comparisonValue,
74
+ delta_percent: percentDelta(currentValue, comparisonValue),
75
+ };
76
+ }
77
+ return metrics;
78
+ }
79
+ const parseKey = (key, keyFilters) => {
80
+ const components = parseMaterializedReportKey(key);
81
+ if (components == null || components.length !== keyFilters.length)
82
+ return null;
83
+ let paymentMethod = null;
84
+ let orderStatus = null;
85
+ for (let index = 0; index < keyFilters.length; index += 1) {
86
+ if (keyFilters[index] === MATERIALIZED_REPORT_KEY_FILTER_ENUM.PAYMENT_METHOD) {
87
+ paymentMethod = components[index];
88
+ }
89
+ else if (keyFilters[index] === MATERIALIZED_REPORT_KEY_FILTER_ENUM.ORDER_STATUS) {
90
+ orderStatus = components[index];
91
+ }
92
+ }
93
+ return { payment_method: paymentMethod, order_status: orderStatus };
94
+ };
95
+ const isCancelled = (orderStatus) => orderStatus === 'CANCELLED';
96
+ const includesCancelled = (filters) => Array.isArray(filters.order_statuses) && filters.order_statuses.includes('CANCELLED');
97
+ const matchesFilters = (parsed, filters) => {
98
+ if (filters.payment_methods != null &&
99
+ filters.payment_methods.length > 0 &&
100
+ (parsed.payment_method == null || !filters.payment_methods.includes(parsed.payment_method))) {
101
+ return false;
102
+ }
103
+ if (filters.order_statuses != null &&
104
+ filters.order_statuses.length > 0 &&
105
+ (parsed.order_status == null || !filters.order_statuses.includes(parsed.order_status))) {
106
+ return false;
107
+ }
108
+ return true;
109
+ };
110
+ const buildPage = (group, filters) => {
111
+ const keyFilters = (group.currentDocs[0]?.sale_type_key_filters ?? []);
112
+ const includeCancelled = includesCancelled(filters);
113
+ const fold = (docs) => {
114
+ const byKey = new Map();
115
+ const total = createEmptyPaymentsComparisonFormattedCountersRaw();
116
+ const cancelled = createEmptyPaymentsComparisonFormattedCountersRaw();
117
+ let matchedDocuments = 0;
118
+ let maxUpdatedAt = null;
119
+ for (const doc of docs ?? []) {
120
+ if (doc == null)
121
+ continue;
122
+ matchedDocuments += Number(doc.matched_documents ?? 1) || 0;
123
+ const updatedAt = doc.max_updated_at ?? doc.updatedAt ?? null;
124
+ if (updatedAt != null) {
125
+ const date = new Date(updatedAt);
126
+ if (!Number.isNaN(date.getTime()) && (maxUpdatedAt == null || date.getTime() > maxUpdatedAt.getTime())) {
127
+ maxUpdatedAt = date;
128
+ }
129
+ }
130
+ for (const [key, counters] of Object.entries(doc.payment_counters ?? {})) {
131
+ const parsed = parseKey(key, keyFilters);
132
+ if (parsed == null || !matchesFilters(parsed, filters))
133
+ continue;
134
+ const target = byKey.get(key) ?? createEmptyPaymentsComparisonFormattedCountersRaw();
135
+ addRaw(target, counters);
136
+ byKey.set(key, target);
137
+ if (isCancelled(parsed.order_status) && !includeCancelled) {
138
+ addRaw(cancelled, counters);
139
+ }
140
+ else {
141
+ addRaw(total, counters);
142
+ }
143
+ }
144
+ }
145
+ return { byKey, total, cancelled, matchedDocuments, maxUpdatedAt };
146
+ };
147
+ const currentFold = fold(group.currentDocs);
148
+ const comparisonFold = group.comparisonDocs == null ? null : fold(group.comparisonDocs);
149
+ const rows = [];
150
+ for (const key of currentFold.byKey.keys()) {
151
+ const parsed = parseKey(key, keyFilters);
152
+ if (parsed == null)
153
+ continue;
154
+ const current = formatPaymentsComparisonSeries(currentFold.byKey.get(key));
155
+ const comparison = comparisonFold == null ? null : formatPaymentsComparisonSeries(comparisonFold.byKey.get(key));
156
+ rows.push({
157
+ key,
158
+ payment_method: parsed.payment_method,
159
+ order_status: parsed.order_status,
160
+ current,
161
+ comparison,
162
+ metrics: buildPaymentsComparisonMetrics(current, comparison),
163
+ });
164
+ }
165
+ rows.sort((a, b) => b.current.counters.payment_amount - a.current.counters.payment_amount || a.key.localeCompare(b.key));
166
+ const methodRows = new Map();
167
+ for (const row of rows) {
168
+ if (row.payment_method == null)
169
+ continue;
170
+ if (isCancelled(row.order_status) && !includeCancelled)
171
+ continue;
172
+ const existing = methodRows.get(row.payment_method) ?? {
173
+ payment_method: row.payment_method,
174
+ current: formatPaymentsComparisonSeries(undefined),
175
+ comparison: comparisonFold == null ? null : formatPaymentsComparisonSeries(undefined),
176
+ metrics: {},
177
+ };
178
+ existing.current = sumFormattedSeries(existing.current, row.current);
179
+ if (existing.comparison != null && row.comparison != null) {
180
+ existing.comparison = sumFormattedSeries(existing.comparison, row.comparison);
181
+ }
182
+ methodRows.set(row.payment_method, existing);
183
+ }
184
+ for (const methodRow of methodRows.values()) {
185
+ methodRow.metrics = buildPaymentsComparisonMetrics(methodRow.current, methodRow.comparison);
186
+ }
187
+ const current = formatPaymentsComparisonSeries(currentFold.total);
188
+ const comparison = comparisonFold == null ? null : formatPaymentsComparisonSeries(comparisonFold.total);
189
+ return {
190
+ tenant_ids: [...group.tenantIds].sort(),
191
+ filters: {
192
+ payment_methods: filters.payment_methods != null && filters.payment_methods.length > 0 ? [...filters.payment_methods] : null,
193
+ order_statuses: filters.order_statuses != null && filters.order_statuses.length > 0 ? [...filters.order_statuses] : null,
194
+ },
195
+ current,
196
+ comparison,
197
+ metrics: buildPaymentsComparisonMetrics(current, comparison),
198
+ cancelled: formatPaymentsComparisonSeries(currentFold.cancelled),
199
+ rows,
200
+ by_method: [...methodRows.values()].sort((a, b) => b.current.counters.payment_amount - a.current.counters.payment_amount ||
201
+ a.payment_method.localeCompare(b.payment_method)),
202
+ matched_documents: currentFold.matchedDocuments,
203
+ max_updated_at: currentFold.maxUpdatedAt,
204
+ };
205
+ };
206
+ function createEmptyPaymentsComparisonFormattedCountersRaw() {
207
+ return {
208
+ payment_count: 0,
209
+ payment_amount: 0,
210
+ amount_due: 0,
211
+ amount_paid: 0,
212
+ amount_refunded: 0,
213
+ card_charges: 0,
214
+ refund_count: 0,
215
+ unpaid_count: 0,
216
+ };
217
+ }
218
+ function addRaw(target, source) {
219
+ target.payment_count += source.payment_count ?? 0;
220
+ target.payment_amount += source.payment_amount ?? 0;
221
+ target.amount_due += source.amount_due ?? 0;
222
+ target.amount_paid += source.amount_paid ?? 0;
223
+ target.amount_refunded += source.amount_refunded ?? 0;
224
+ target.card_charges += source.card_charges ?? 0;
225
+ target.refund_count += source.refund_count ?? 0;
226
+ target.unpaid_count += source.unpaid_count ?? 0;
227
+ }
228
+ function sumFormattedSeries(a, b) {
229
+ const counters = {
230
+ payment_count: a.counters.payment_count + b.counters.payment_count,
231
+ payment_amount: a.counters.payment_amount + b.counters.payment_amount,
232
+ amount_due: a.counters.amount_due + b.counters.amount_due,
233
+ amount_paid: a.counters.amount_paid + b.counters.amount_paid,
234
+ amount_refunded: a.counters.amount_refunded + b.counters.amount_refunded,
235
+ card_charges: a.counters.card_charges + b.counters.card_charges,
236
+ refund_count: a.counters.refund_count + b.counters.refund_count,
237
+ unpaid_count: a.counters.unpaid_count + b.counters.unpaid_count,
238
+ };
239
+ return {
240
+ counters,
241
+ average_payment: counters.payment_count > 0 ? counters.payment_amount / counters.payment_count : null,
242
+ };
243
+ }
244
+ export function getFormattedTenantPaymentsComparisonReporting(currentDocs, comparisonDocs, filters = null, separate_view_per_tenant = false) {
245
+ if (!Array.isArray(currentDocs) || currentDocs.length === 0)
246
+ return null;
247
+ if (currentDocs.some((doc) => doc == null))
248
+ return null;
249
+ if (comparisonDocs != null && !Array.isArray(comparisonDocs))
250
+ return null;
251
+ if (filters != null) {
252
+ if (filters.payment_methods != null && !Array.isArray(filters.payment_methods))
253
+ return null;
254
+ if (filters.order_statuses != null && !Array.isArray(filters.order_statuses))
255
+ return null;
256
+ }
257
+ const resolvedFilters = filters ?? {};
258
+ const signature = (currentDocs[0].sale_type_key_filters ?? []).join(':');
259
+ for (const doc of [...currentDocs, ...(comparisonDocs ?? [])]) {
260
+ if ((doc.sale_type_key_filters ?? []).join(':') !== signature)
261
+ return null;
262
+ }
263
+ const usableCurrent = currentDocs.filter((doc) => doc.payment_counters != null);
264
+ if (usableCurrent.length === 0)
265
+ return null;
266
+ const allTenantIds = [...new Set(usableCurrent.map((doc) => String(doc.tenant_id)))].sort();
267
+ const scopes = separate_view_per_tenant ? allTenantIds.map((tenantId) => [tenantId]) : [allTenantIds];
268
+ const pages = [];
269
+ for (const scope of scopes) {
270
+ const currentForScope = usableCurrent.filter((doc) => scope.includes(String(doc.tenant_id)));
271
+ if (currentForScope.length === 0)
272
+ continue;
273
+ const comparisonForScope = comparisonDocs == null ? null : comparisonDocs.filter((doc) => scope.includes(String(doc.tenant_id)));
274
+ const page = buildPage({ tenantIds: scope, currentDocs: currentForScope, comparisonDocs: comparisonForScope }, resolvedFilters);
275
+ if (page != null)
276
+ pages.push(page);
277
+ }
278
+ return pages.length === 0 ? null : [pages, null];
279
+ }
@@ -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
+ }