@managesome/eposmatic-toolkit 0.4.8 → 0.4.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (336) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +448 -0
  2. package/esm/constants/enums/communications.js +1 -0
  3. package/esm/helpers/index.js +3 -0
  4. package/esm/helpers/materialized-reports/index.js +32 -0
  5. package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
  6. package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +286 -0
  7. package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
  8. package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +244 -0
  9. package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
  10. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +426 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +372 -0
  12. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +214 -0
  13. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +318 -0
  14. package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
  15. package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
  16. package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
  17. package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
  18. package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
  19. package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +111 -0
  20. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +88 -0
  21. package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
  22. package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
  23. package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
  24. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +476 -0
  25. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
  26. package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +7 -0
  27. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
  28. package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +157 -0
  29. package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
  30. package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
  31. package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +156 -0
  32. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
  33. package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
  34. package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +237 -0
  35. package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +279 -0
  36. package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
  37. package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +343 -0
  38. package/esm/helpers/reporting-contract/index.js +2 -0
  39. package/esm/helpers/reporting-contract/overview-contract.js +122 -0
  40. package/esm/helpers/reporting-contract/report-contract.js +228 -0
  41. package/esm/helpers/rider-earnings/index.js +1 -0
  42. package/esm/helpers/rider-earnings/rider-earnings.js +59 -0
  43. package/esm/helpers/rider-reports/index.js +2 -0
  44. package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
  45. package/esm/helpers/rider-reports/rider-report.js +67 -0
  46. package/esm/schemas/models/deliveries.js +75 -0
  47. package/esm/schemas/models/index.js +15 -0
  48. package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
  49. package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
  50. package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
  51. package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
  52. package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
  53. package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
  54. package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
  55. package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
  56. package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
  57. package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
  58. package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
  59. package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
  60. package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
  61. package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
  62. package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
  63. package/esm/schemas/types/index.js +15 -0
  64. package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
  65. package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
  66. package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
  67. package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
  68. package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
  69. package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
  70. package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
  71. package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
  72. package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
  73. package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
  74. package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
  75. package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
  76. package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
  77. package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
  78. package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
  79. package/lib/constants/MATERIALIZED_REPORTS.d.ts +339 -2
  80. package/lib/constants/MATERIALIZED_REPORTS.js +450 -1
  81. package/lib/constants/enums/communications.d.ts +1 -0
  82. package/lib/constants/enums/communications.js +2 -1
  83. package/lib/helpers/index.d.ts +3 -0
  84. package/lib/helpers/index.js +3 -0
  85. package/lib/helpers/materialized-reports/index.d.ts +32 -0
  86. package/lib/helpers/materialized-reports/index.js +32 -0
  87. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
  88. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
  89. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +90 -0
  90. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +295 -0
  91. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +102 -0
  92. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
  93. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +72 -0
  94. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +251 -0
  95. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
  96. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
  97. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +84 -0
  98. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +438 -0
  99. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +97 -0
  100. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +385 -0
  101. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +40 -0
  102. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +218 -0
  103. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
  104. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +324 -0
  105. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
  106. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
  107. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
  108. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
  109. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
  110. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
  111. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
  112. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
  113. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
  114. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
  115. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
  116. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +116 -0
  117. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
  118. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +98 -0
  119. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
  120. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
  121. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
  122. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
  123. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +66 -0
  124. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
  125. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +128 -0
  126. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +490 -0
  127. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +46 -0
  128. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
  129. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
  130. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +8 -1
  131. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
  132. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
  133. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
  134. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +161 -0
  135. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
  136. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
  137. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
  138. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
  139. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
  140. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +159 -0
  141. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
  142. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
  143. package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
  144. package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
  145. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
  146. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +243 -0
  147. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
  148. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +286 -0
  149. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +97 -0
  150. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
  151. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
  152. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +349 -0
  153. package/lib/helpers/reporting-contract/index.d.ts +2 -0
  154. package/lib/helpers/reporting-contract/index.js +18 -0
  155. package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
  156. package/lib/helpers/reporting-contract/overview-contract.js +126 -0
  157. package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
  158. package/lib/helpers/reporting-contract/report-contract.js +239 -0
  159. package/lib/helpers/rider-earnings/index.d.ts +1 -0
  160. package/lib/helpers/rider-earnings/index.js +17 -0
  161. package/lib/helpers/rider-earnings/rider-earnings.d.ts +58 -0
  162. package/lib/helpers/rider-earnings/rider-earnings.js +64 -0
  163. package/lib/helpers/rider-reports/index.d.ts +2 -0
  164. package/lib/helpers/rider-reports/index.js +18 -0
  165. package/lib/helpers/rider-reports/rider-daily-report.d.ts +26 -0
  166. package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
  167. package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
  168. package/lib/helpers/rider-reports/rider-report.js +70 -0
  169. package/lib/helpers/types/materialized-reports-apis.d.ts +297 -1
  170. package/lib/schemas/models/deliveries.d.ts +54 -0
  171. package/lib/schemas/models/deliveries.js +75 -0
  172. package/lib/schemas/models/expense_details.d.ts +3 -3
  173. package/lib/schemas/models/index.d.ts +15 -0
  174. package/lib/schemas/models/index.js +15 -0
  175. package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
  176. package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
  177. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
  178. package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
  179. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
  180. package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
  181. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
  182. package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
  183. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
  184. package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
  185. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
  186. package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
  187. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
  188. package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
  189. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
  190. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
  191. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
  192. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
  193. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
  194. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
  195. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
  196. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
  197. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
  198. package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
  199. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
  200. package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
  201. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
  202. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
  203. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
  204. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
  205. package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
  206. package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
  207. package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
  208. package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
  209. package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
  210. package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
  211. package/lib/schemas/types/deliveries.d.ts +40 -1
  212. package/lib/schemas/types/index.d.ts +15 -0
  213. package/lib/schemas/types/index.js +15 -0
  214. package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
  215. package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
  216. package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
  217. package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
  218. package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
  219. package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
  220. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
  221. package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
  222. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
  223. package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
  224. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
  225. package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
  226. package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
  227. package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
  228. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
  229. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
  230. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
  231. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
  232. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
  233. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
  234. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
  235. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
  236. package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
  237. package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
  238. package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
  239. package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
  240. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
  241. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
  242. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
  243. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
  244. package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
  245. package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
  246. package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
  247. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  248. package/lib/tests/materialized-reports/fixtures.js +1 -0
  249. package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
  250. package/lib/tests/materialized-reports/materialized-cash-compile.test.js +196 -0
  251. package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
  252. package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
  253. package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
  254. package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +152 -0
  255. package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
  256. package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
  257. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
  258. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
  259. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
  260. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
  261. package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
  262. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +241 -0
  263. package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
  264. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
  265. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
  266. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +141 -0
  267. package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
  268. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
  269. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
  270. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
  271. package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
  272. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
  273. package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
  274. package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
  275. package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
  276. package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
  277. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
  278. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
  279. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
  280. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
  281. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
  282. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
  283. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
  284. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
  285. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
  286. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
  287. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
  288. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
  289. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
  290. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
  291. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
  292. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
  293. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
  294. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
  295. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
  296. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
  297. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
  298. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +270 -0
  299. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
  300. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
  301. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
  302. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
  303. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
  304. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
  305. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
  306. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
  307. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
  308. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +206 -0
  309. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
  310. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
  311. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
  312. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
  313. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
  314. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
  315. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
  316. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
  317. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
  318. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
  319. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
  320. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
  321. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
  322. package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
  323. package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
  324. package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
  325. package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
  326. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
  327. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
  328. package/lib/tests/reporting-contract.test.d.ts +1 -0
  329. package/lib/tests/reporting-contract.test.js +267 -0
  330. package/lib/tests/rider-daily-report.test.d.ts +1 -0
  331. package/lib/tests/rider-daily-report.test.js +86 -0
  332. package/lib/tests/rider-earnings.test.d.ts +1 -0
  333. package/lib/tests/rider-earnings.test.js +65 -0
  334. package/lib/tests/rider-report.test.d.ts +1 -0
  335. package/lib/tests/rider-report.test.js +98 -0
  336. package/package.json +10 -1
@@ -0,0 +1,372 @@
1
+ import mongoose from 'mongoose';
2
+ import { DELIVERY_KEY_FILTERS, MATERIALIZED_DELIVERY_REPORT_SCOPES, MATERIALIZED_REPORT_TYPE_ENUM, } from '../../constants/MATERIALIZED_REPORTS';
3
+ import { buildMaterializedTenantReportIteration } from './materialized-tenant-reports-iterations-helpers';
4
+ import { getMaterializedPeriodScopeFields } from './scope-helpers';
5
+ import { freshDeliveryCounters } from './materialized-delivery-classification-helpers';
6
+ import { mergeMaterializedDeliveryCounters } from './materialized-delivery-accumulator-helpers';
7
+ /**
8
+ * M4 close-day helpers.
9
+ *
10
+ * ## Period counters are RE-FOLDED, never patched
11
+ *
12
+ * The delivery fold is not a pure sum: the rider leaderboard carries MIN/MAX TENURE
13
+ * BOUNDS (`first_delivery_at`, `last_delivery_at`). You cannot subtract a minimum, so
14
+ * removing a day by decrementing its contribution is impossible - every touched period is
15
+ * rebuilt from its whole day set, exactly as in the prep time and cash reports.
16
+ *
17
+ * ## The watermark comes from the FOLDED DAYS
18
+ *
19
+ * A folded document that inherited the STORED document watermark would look unchanged to
20
+ * the write guard and be skipped forever, freezing the period at its first closed day.
21
+ * That bug shipped once in the prep time report; it is designed out here from the start.
22
+ */
23
+ /** Period scopes this report materializes (everything but the day scope). */
24
+ export const MATERIALIZED_DELIVERY_PERIOD_SCOPES = MATERIALIZED_DELIVERY_REPORT_SCOPES.filter((scope) => String(scope) !== 'localDate');
25
+ /** True when the scope is the plain day scope. */
26
+ export const isMaterializedDeliveryDayScope = (scopeContext) => String(scopeContext) === 'localDate';
27
+ const deliveryScopeKey = (doc) => String(doc.scope_context) + '|' + String(doc.scope_field);
28
+ /**
29
+ * Merges TWO period entry sections, keyed on `entry_key`.
30
+ *
31
+ * Rows are deduplicated by identity: a source delivery belongs to exactly one day, so the
32
+ * same `entry_key` twice means the fold saw it twice.
33
+ */
34
+ export function mergeMaterializedDeliveryEntrySections(target, source) {
35
+ const rowsByKey = new Map();
36
+ const seenByKey = new Map();
37
+ const absorb = (input) => {
38
+ if (input == null)
39
+ return;
40
+ for (const [key, section] of Object.entries(input)) {
41
+ const rows = rowsByKey.get(key) ?? [];
42
+ const seen = seenByKey.get(key) ?? new Set();
43
+ for (const row of section?.rows ?? []) {
44
+ const identity = String(row.entry_key ?? row.delivery_id ?? '');
45
+ if (identity !== '') {
46
+ if (seen.has(identity))
47
+ continue;
48
+ seen.add(identity);
49
+ }
50
+ rows.push(row);
51
+ }
52
+ rowsByKey.set(key, rows);
53
+ seenByKey.set(key, seen);
54
+ }
55
+ };
56
+ absorb(target);
57
+ absorb(source);
58
+ const out = {};
59
+ for (const [key, rows] of rowsByKey) {
60
+ rows.sort((a, b) => new Date(b.delivered_at ?? b.created_at).getTime() - new Date(a.delivered_at ?? a.created_at).getTime() ||
61
+ (String(a.delivery_id) < String(b.delivery_id) ? 1 : -1));
62
+ out[key] = { rows };
63
+ }
64
+ return out;
65
+ }
66
+ /** True when the stored document already carries this exact content. */
67
+ export function needsMaterializedDeliveryReportWrite(existing, next) {
68
+ if (existing == null)
69
+ return true;
70
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
71
+ const incoming = new Date(next.source_watermark ?? 0).getTime();
72
+ if (Number.isNaN(stored) || Number.isNaN(incoming))
73
+ return true;
74
+ return incoming > stored;
75
+ }
76
+ /** True when the stored entry document already carries these exact rows. */
77
+ export function needsMaterializedDeliveryEntriesWrite(existing, next) {
78
+ if (existing == null)
79
+ return true;
80
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
81
+ const incoming = new Date(next.source_watermark ?? 0).getTime();
82
+ if (Number.isNaN(stored) || Number.isNaN(incoming))
83
+ return true;
84
+ return incoming > stored;
85
+ }
86
+ /** Folds the counters of every day document belonging to one period scope. */
87
+ export function foldMaterializedDeliveryPeriodCounters(input) {
88
+ const { periodScope, periodScopeField, dayDocuments } = input;
89
+ const folded = {};
90
+ for (const dayDocument of dayDocuments ?? []) {
91
+ if (!isMaterializedDeliveryDayScope(String(dayDocument?.scope_context)))
92
+ continue;
93
+ const fields = getMaterializedPeriodScopeFields(String(dayDocument.scope_field));
94
+ if (fields == null)
95
+ continue;
96
+ if (fields[periodScope] !== periodScopeField)
97
+ continue;
98
+ for (const [key, block] of Object.entries(dayDocument.delivery_counters ?? {})) {
99
+ folded[key] = mergeMaterializedDeliveryCounters(folded[key] ?? freshDeliveryCounters(), block);
100
+ }
101
+ }
102
+ return folded;
103
+ }
104
+ /** Folds the statement rows of every day document belonging to one period scope. */
105
+ export function foldMaterializedDeliveryPeriodRows(input) {
106
+ const { periodScope, periodScopeField, dayDocuments } = input;
107
+ let merged = {};
108
+ let offApp = 0;
109
+ for (const dayDocument of dayDocuments ?? []) {
110
+ if (!isMaterializedDeliveryDayScope(String(dayDocument?.scope_context)))
111
+ continue;
112
+ const fields = getMaterializedPeriodScopeFields(String(dayDocument.scope_field));
113
+ if (fields == null)
114
+ continue;
115
+ if (fields[periodScope] !== periodScopeField)
116
+ continue;
117
+ merged = mergeMaterializedDeliveryEntrySections(merged, dayDocument.delivery_entries ?? null);
118
+ // Off-app orders cannot be rows, so the period total is a SUM of the day counts.
119
+ offApp += Number(dayDocument.off_app_order_count) || 0;
120
+ }
121
+ return { sections: merged, offApp };
122
+ }
123
+ /**
124
+ * Builds the close-day plan for ONE tenant-day.
125
+ *
126
+ * The DAY scope comes from the compile. Every PERIOD scope the day touches is RE-FOLDED
127
+ * from its whole day set, and the touched set is the union of the closed day periods AND
128
+ * every removed day periods - emptying a day must clear it from the periods it used to
129
+ * belong to.
130
+ */
131
+ export function buildTenantDeliveryCloseDayPlan(input) {
132
+ if (input == null)
133
+ return null;
134
+ const { tenantId, reports, entries, reason } = input;
135
+ if (typeof tenantId !== 'string' || tenantId.length === 0)
136
+ return null;
137
+ if (typeof reason !== 'string' || reason.length === 0)
138
+ return null;
139
+ const computedAt = input.computedAt ?? new Date();
140
+ const compiledReports = (reports ?? []).filter((doc) => String(doc?.tenant_id) === tenantId);
141
+ const compiledEntries = (entries ?? []).filter((doc) => String(doc?.tenant_id) === tenantId);
142
+ const storedReports = (input.existing ?? []).filter((doc) => String(doc?.tenant_id) === tenantId);
143
+ const storedEntries = (input.existingEntries ?? []).filter((doc) => String(doc?.tenant_id) === tenantId);
144
+ const compiledDateDoc = compiledReports.find((doc) => isMaterializedDeliveryDayScope(String(doc.scope_context)));
145
+ const localDate = input.localDate ?? (compiledDateDoc == null ? null : String(compiledDateDoc.scope_field));
146
+ if (localDate == null || localDate === '')
147
+ return null;
148
+ const writes = [];
149
+ const entryWrites = [];
150
+ const staleDocuments = [];
151
+ const staleEntryDocuments = [];
152
+ const skippedDocuments = [];
153
+ const skippedEntryDocuments = [];
154
+ const storedReportsByScope = new Map();
155
+ for (const doc of storedReports)
156
+ storedReportsByScope.set(deliveryScopeKey(doc), doc);
157
+ const storedEntriesByScope = new Map();
158
+ for (const doc of storedEntries)
159
+ storedEntriesByScope.set(deliveryScopeKey(doc), doc);
160
+ const addWrite = (report) => {
161
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
162
+ const iteration = buildMaterializedTenantReportIteration(persisted, {
163
+ reportType: MATERIALIZED_REPORT_TYPE_ENUM.TENANT_DELIVERY_REPORTS,
164
+ reason,
165
+ computedAt,
166
+ });
167
+ if (iteration == null)
168
+ return false;
169
+ writes.push({ report: persisted, iteration: iteration });
170
+ return true;
171
+ };
172
+ const addEntryWrite = (report) => {
173
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
174
+ const iteration = buildMaterializedTenantReportIteration(persisted, {
175
+ reportType: MATERIALIZED_REPORT_TYPE_ENUM.TENANT_DELIVERY_ENTRIES,
176
+ reason,
177
+ computedAt,
178
+ });
179
+ if (iteration == null)
180
+ return false;
181
+ entryWrites.push({ report: persisted, iteration: iteration });
182
+ return true;
183
+ };
184
+ // ---- the DAY scope, straight from the compile ----
185
+ if (compiledDateDoc != null) {
186
+ const existing = storedReportsByScope.get(deliveryScopeKey(compiledDateDoc));
187
+ const next = {
188
+ ...compiledDateDoc,
189
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
190
+ iteration: Number(existing?.iteration ?? 0) + 1,
191
+ };
192
+ if (needsMaterializedDeliveryReportWrite(existing, next))
193
+ addWrite(next);
194
+ else
195
+ skippedDocuments.push(existing);
196
+ }
197
+ const compiledDateEntries = compiledEntries.find((doc) => isMaterializedDeliveryDayScope(String(doc.scope_context)));
198
+ if (compiledDateEntries != null) {
199
+ const existing = storedEntriesByScope.get(deliveryScopeKey(compiledDateEntries));
200
+ const next = {
201
+ ...compiledDateEntries,
202
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
203
+ iteration: Number(existing?.iteration ?? 0) + 1,
204
+ };
205
+ if (needsMaterializedDeliveryEntriesWrite(existing, next))
206
+ addEntryWrite(next);
207
+ else
208
+ skippedEntryDocuments.push(existing);
209
+ }
210
+ // ---- DAY deletion: a stored day doc that no longer compiled ----
211
+ const compiledDateKeys = new Set(compiledReports
212
+ .filter((doc) => isMaterializedDeliveryDayScope(String(doc.scope_context)))
213
+ .map((doc) => deliveryScopeKey(doc)));
214
+ const removedDates = [];
215
+ for (const doc of storedReports) {
216
+ if (!isMaterializedDeliveryDayScope(String(doc.scope_context)))
217
+ continue;
218
+ if (String(doc.scope_field) !== localDate)
219
+ continue;
220
+ if (compiledDateKeys.has(deliveryScopeKey(doc)))
221
+ continue;
222
+ staleDocuments.push(doc);
223
+ removedDates.push(String(doc.scope_field));
224
+ }
225
+ const compiledDateEntryKeys = new Set(compiledEntries
226
+ .filter((doc) => isMaterializedDeliveryDayScope(String(doc.scope_context)))
227
+ .map((doc) => deliveryScopeKey(doc)));
228
+ for (const doc of storedEntries) {
229
+ if (!isMaterializedDeliveryDayScope(String(doc.scope_context)))
230
+ continue;
231
+ if (String(doc.scope_field) !== localDate)
232
+ continue;
233
+ if (compiledDateEntryKeys.has(deliveryScopeKey(doc)))
234
+ continue;
235
+ staleEntryDocuments.push(doc);
236
+ }
237
+ // ---- PERIOD re-fold ----
238
+ const nextDayDocs = storedReports.filter((doc) => isMaterializedDeliveryDayScope(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
239
+ if (compiledDateDoc != null) {
240
+ nextDayDocs.push(writes.find((w) => isMaterializedDeliveryDayScope(String(w.report.scope_context)))?.report ??
241
+ compiledDateDoc);
242
+ }
243
+ const nextDayEntryDocs = storedEntries.filter((doc) => isMaterializedDeliveryDayScope(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
244
+ const compiledDateEntryDoc = entryWrites.find((w) => isMaterializedDeliveryDayScope(String(w.report.scope_context)))?.report;
245
+ if (compiledDateEntryDoc != null)
246
+ nextDayEntryDocs.push(compiledDateEntryDoc);
247
+ const touchedPeriods = new Map();
248
+ const noteDay = (day) => {
249
+ const fields = getMaterializedPeriodScopeFields(day);
250
+ if (fields == null)
251
+ return;
252
+ for (const scope of MATERIALIZED_DELIVERY_PERIOD_SCOPES) {
253
+ const field = fields[String(scope)];
254
+ if (field == null || field === '')
255
+ continue;
256
+ touchedPeriods.set(String(scope) + '|' + field, { scope: String(scope), field });
257
+ }
258
+ };
259
+ noteDay(localDate);
260
+ for (const day of removedDates)
261
+ noteDay(day);
262
+ for (const { scope, field } of touchedPeriods.values()) {
263
+ const folded = foldMaterializedDeliveryPeriodCounters({
264
+ periodScope: scope,
265
+ periodScopeField: field,
266
+ dayDocuments: nextDayDocs,
267
+ });
268
+ const existing = storedReportsByScope.get(scope + '|' + field);
269
+ const keys = Object.keys(folded).sort();
270
+ if (keys.length === 0) {
271
+ if (existing != null)
272
+ staleDocuments.push(existing);
273
+ continue;
274
+ }
275
+ const counters = {};
276
+ const counterRows = [];
277
+ for (const key of keys) {
278
+ counters[key] = folded[key];
279
+ counterRows.push({ key, counters: folded[key] });
280
+ }
281
+ const report = {
282
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
283
+ tenant_id: tenantId,
284
+ brand_id: existing?.brand_id ?? compiledDateDoc?.brand_id ?? '',
285
+ scope_context: scope,
286
+ scope_field: field,
287
+ day_index: null,
288
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...DELIVERY_KEY_FILTERS],
289
+ delivery_counters: counters,
290
+ delivery_counter_rows: counterRows,
291
+ iteration: existing?.iteration,
292
+ schema_version: existing?.schema_version ?? 1,
293
+ // FROM THE FOLDED DAYS - never the stored watermark.
294
+ source_watermark: watermarkOfDays(nextDayDocs, existing?.source_watermark ?? computedAt),
295
+ computed_at: computedAt,
296
+ createdAt: existing?.createdAt ?? computedAt,
297
+ updatedAt: computedAt,
298
+ };
299
+ const next = { ...report, iteration: Number(existing?.iteration ?? 0) + 1 };
300
+ if (needsMaterializedDeliveryReportWrite(existing, next))
301
+ addWrite(next);
302
+ else
303
+ skippedDocuments.push(existing);
304
+ }
305
+ for (const { scope, field } of touchedPeriods.values()) {
306
+ const { sections, offApp } = foldMaterializedDeliveryPeriodRows({
307
+ periodScope: scope,
308
+ periodScopeField: field,
309
+ dayDocuments: nextDayEntryDocs,
310
+ });
311
+ const existing = storedEntriesByScope.get(scope + '|' + field);
312
+ const keys = Object.keys(sections);
313
+ if (keys.length === 0 && offApp === 0) {
314
+ if (existing != null)
315
+ staleEntryDocuments.push(existing);
316
+ continue;
317
+ }
318
+ let watermark = existing?.source_watermark ?? null;
319
+ for (const dayDoc of nextDayEntryDocs) {
320
+ const fields = getMaterializedPeriodScopeFields(String(dayDoc.scope_field));
321
+ if (fields == null)
322
+ continue;
323
+ if (fields[scope] !== field)
324
+ continue;
325
+ const time = new Date(dayDoc.source_watermark ?? 0).getTime();
326
+ if (Number.isNaN(time))
327
+ continue;
328
+ if (watermark == null || time > new Date(watermark).getTime())
329
+ watermark = new Date(time);
330
+ }
331
+ const report = {
332
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
333
+ tenant_id: tenantId,
334
+ brand_id: existing?.brand_id ?? compiledDateEntries?.brand_id ?? '',
335
+ scope_context: scope,
336
+ scope_field: field,
337
+ day_index: null,
338
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...DELIVERY_KEY_FILTERS],
339
+ delivery_entries: Object.keys(sections).length === 0 ? null : sections,
340
+ off_app_order_count: offApp,
341
+ iteration: existing?.iteration,
342
+ schema_version: existing?.schema_version ?? 1,
343
+ source_watermark: watermark ?? computedAt,
344
+ computed_at: computedAt,
345
+ createdAt: existing?.createdAt ?? computedAt,
346
+ updatedAt: computedAt,
347
+ };
348
+ const next = { ...report, iteration: Number(existing?.iteration ?? 0) + 1 };
349
+ if (needsMaterializedDeliveryEntriesWrite(existing, next))
350
+ addEntryWrite(next);
351
+ else
352
+ skippedEntryDocuments.push(existing);
353
+ }
354
+ return {
355
+ writes,
356
+ entryWrites,
357
+ staleDocuments,
358
+ staleEntryDocuments,
359
+ skippedDocuments,
360
+ skippedEntryDocuments,
361
+ };
362
+ }
363
+ /** Max watermark across the day documents that feed a fold. */
364
+ function watermarkOfDays(dayDocs, fallback) {
365
+ let latest = fallback.getTime();
366
+ for (const doc of dayDocs) {
367
+ const time = new Date(doc?.source_watermark ?? 0).getTime();
368
+ if (!Number.isNaN(time) && time > latest)
369
+ latest = time;
370
+ }
371
+ return new Date(latest);
372
+ }
@@ -0,0 +1,214 @@
1
+ import { DELIVERY_KEY_FILTERS } from '../../constants/MATERIALIZED_REPORTS';
2
+ import { MATERIALIZED_TENANT_DELIVERY_ENTRIES_SCHEMA_VERSION } from '../../schemas/models/materialized_tenant_delivery_entries';
3
+ import { MATERIALIZED_TENANT_DELIVERY_REPORTS_SCHEMA_VERSION } from '../../schemas/models/materialized_tenant_delivery_reports';
4
+ import { addDelivery, addDeliveryOrder, buildMaterializedDeliveryKey, finalizeDeliveryAccumulator, freshDeliveryAccumulator, isDeliveryOrder, } from './materialized-delivery-classification-helpers';
5
+ const watermarkOf = (row, fallback) => {
6
+ const raw = row?.updatedAt ?? row?.createdAt;
7
+ const time = raw == null ? NaN : new Date(raw).getTime();
8
+ return Number.isNaN(time) ? fallback : new Date(time);
9
+ };
10
+ const minutesBetween = (from, to) => {
11
+ const a = from == null ? NaN : new Date(from).getTime();
12
+ const b = to == null ? NaN : new Date(to).getTime();
13
+ if (Number.isNaN(a) || Number.isNaN(b))
14
+ return null;
15
+ return Math.round((b - a) / 60000);
16
+ };
17
+ const hourLabelOf = (row) => {
18
+ const hour = row?.localHour;
19
+ if (typeof hour === 'number' && Number.isFinite(hour)) {
20
+ const day = String(row?.localDate ?? '');
21
+ if (day === '')
22
+ return null;
23
+ return day + ' ' + String(hour).padStart(2, '0');
24
+ }
25
+ const raw = row?.createdAt;
26
+ if (raw == null)
27
+ return null;
28
+ const date = new Date(raw);
29
+ if (Number.isNaN(date.getTime()))
30
+ return null;
31
+ return date.toISOString().slice(0, 13).replace('T', ' ');
32
+ };
33
+ /** The key of an ORDER - platform and city, both from the order itself. */
34
+ export function deliveryKeyOfOrder(order) {
35
+ return buildMaterializedDeliveryKey(order?.platform, order?.delivery_details?.city ?? order?.delivery_details?.state ?? null);
36
+ }
37
+ /**
38
+ * Compiles one business day into the DATE report document plus the DATE entries document.
39
+ *
40
+ * Returns null when the day has NEITHER a delivery order NOR a delivery - an emptied day
41
+ * writes nothing, and the close-day planner deletes what is left over.
42
+ */
43
+ export function compileTenantDeliveryReports(input) {
44
+ if (input == null)
45
+ return null;
46
+ const { tenantId, brandId, localDate } = input;
47
+ if (typeof tenantId !== 'string' ||
48
+ tenantId === '' ||
49
+ typeof brandId !== 'string' ||
50
+ brandId === '' ||
51
+ typeof localDate !== 'string' ||
52
+ localDate === '') {
53
+ return null;
54
+ }
55
+ const computedAt = input.computedAt ?? new Date();
56
+ const orders = (Array.isArray(input.orders) ? input.orders : []).filter((row) => String(row?.tenant_id ?? tenantId) === tenantId && isDeliveryOrder(row));
57
+ const deliveries = (Array.isArray(input.deliveries) ? input.deliveries : []).filter((row) => String(row?.tenant_id ?? tenantId) === tenantId);
58
+ if (orders.length === 0 && deliveries.length === 0)
59
+ return null;
60
+ const ordersById = new Map();
61
+ for (const order of orders)
62
+ ordersById.set(String(order._id), order);
63
+ const accumulators = new Map();
64
+ const accumulatorFor = (key) => {
65
+ const existing = accumulators.get(key);
66
+ if (existing != null)
67
+ return existing;
68
+ const created = freshDeliveryAccumulator();
69
+ accumulators.set(key, created);
70
+ return created;
71
+ };
72
+ const watermarks = [];
73
+ // The ORDERS stage first: adoption is a property of the order population, and a
74
+ // delivery that arrives for an unseen order must not invent one.
75
+ for (const order of orders) {
76
+ addDeliveryOrder(accumulatorFor(deliveryKeyOfOrder(order)), order);
77
+ watermarks.push(watermarkOf(order, computedAt));
78
+ }
79
+ const rowsByKey = new Map();
80
+ for (const delivery of deliveries) {
81
+ const orderId = delivery?.order_id == null ? null : String(delivery.order_id);
82
+ const order = orderId == null ? null : (ordersById.get(orderId) ?? null);
83
+ // A delivery whose order was NOT staged keys on its own (absent) dimensions, so it
84
+ // lands in UNKNOWN rather than being dropped or attributed to a neighbouring city.
85
+ const key = order == null ? buildMaterializedDeliveryKey(null, null) : deliveryKeyOfOrder(order);
86
+ addDelivery(accumulatorFor(key), delivery, order, key);
87
+ watermarks.push(watermarkOf(delivery, computedAt));
88
+ const details = order?.delivery_details ?? {};
89
+ const row = buildEntryRow(delivery, order, details);
90
+ const bucket = rowsByKey.get(key);
91
+ if (bucket == null)
92
+ rowsByKey.set(key, [row]);
93
+ else
94
+ bucket.push(row);
95
+ }
96
+ const deliveryCounters = {};
97
+ const deliveryCounterRows = [];
98
+ for (const key of [...accumulators.keys()].sort()) {
99
+ const counters = finalizeDeliveryAccumulator(accumulators.get(key));
100
+ deliveryCounters[key] = counters;
101
+ deliveryCounterRows.push({ key, counters });
102
+ }
103
+ const sections = {};
104
+ for (const key of [...rowsByKey.keys()].sort()) {
105
+ const rows = rowsByKey.get(key);
106
+ rows.sort((a, b) => (b.delivered_at ?? b.created_at).getTime() - (a.delivered_at ?? a.created_at).getTime() ||
107
+ (String(a.delivery_id) < String(b.delivery_id) ? 1 : -1));
108
+ sections[key] = { rows };
109
+ }
110
+ // Off-app orders cannot be ROWS - there is no delivery to describe - so the count
111
+ // travels on the document and the OFF_APP view answers from it.
112
+ let offAppCount = 0;
113
+ for (const counters of Object.values(deliveryCounters)) {
114
+ offAppCount += Number(counters?.adoption?.off_app_count) || 0;
115
+ }
116
+ const watermark = watermarks.reduce((latest, current) => (current.getTime() > latest.getTime() ? current : latest), computedAt);
117
+ return {
118
+ reports: [
119
+ {
120
+ _id: undefined,
121
+ tenant_id: tenantId,
122
+ brand_id: brandId,
123
+ scope_context: 'localDate',
124
+ scope_field: localDate,
125
+ day_index: dayIndexOf(localDate),
126
+ sale_type_key_filters: [...DELIVERY_KEY_FILTERS],
127
+ delivery_counters: deliveryCounters,
128
+ delivery_counter_rows: deliveryCounterRows,
129
+ schema_version: MATERIALIZED_TENANT_DELIVERY_REPORTS_SCHEMA_VERSION,
130
+ source_watermark: watermark,
131
+ computed_at: computedAt,
132
+ createdAt: computedAt,
133
+ updatedAt: computedAt,
134
+ },
135
+ ],
136
+ entries: [
137
+ {
138
+ _id: undefined,
139
+ tenant_id: tenantId,
140
+ brand_id: brandId,
141
+ scope_context: 'localDate',
142
+ scope_field: localDate,
143
+ day_index: dayIndexOf(localDate),
144
+ sale_type_key_filters: [...DELIVERY_KEY_FILTERS],
145
+ delivery_entries: Object.keys(sections).length === 0 ? null : sections,
146
+ off_app_order_count: offAppCount,
147
+ schema_version: MATERIALIZED_TENANT_DELIVERY_ENTRIES_SCHEMA_VERSION,
148
+ source_watermark: watermark,
149
+ computed_at: computedAt,
150
+ createdAt: computedAt,
151
+ updatedAt: computedAt,
152
+ },
153
+ ],
154
+ };
155
+ }
156
+ /** Builds one statement row from a delivery plus its joined order. */
157
+ function buildEntryRow(delivery, order, details) {
158
+ const createdAt = new Date(delivery?.createdAt ?? Date.now());
159
+ const orderCreatedAt = order?.createdAt == null ? null : new Date(order.createdAt);
160
+ const deliveredAt = delivery?.delivered_at == null ? null : new Date(delivery.delivered_at);
161
+ const exact = deliveredAt != null;
162
+ const completedAt = exact ? deliveredAt : delivery?.updatedAt == null ? null : new Date(delivery.updatedAt);
163
+ const status = String(delivery?.status ?? '');
164
+ return {
165
+ delivery_id: String(delivery?._id ?? ''),
166
+ entry_key: String(delivery?.order_id ?? '') + '|' + String(delivery?.rider_id ?? ''),
167
+ order_id: String(delivery?.order_id ?? ''),
168
+ order_number: order?.order_number == null ? null : Number(order.order_number) || 0,
169
+ rider_id: String(delivery?.rider_id ?? ''),
170
+ rider_name: delivery?.rider_name == null ? null : String(delivery.rider_name),
171
+ status: status,
172
+ cancel_reason: delivery?.cancel_reason == null ? null : String(delivery.cancel_reason),
173
+ distance_meters: Number(delivery?.distance_in_meters_from_store) || 0,
174
+ rider_revenue: delivery?.rider_earnings != null
175
+ ? delivery.rider_earnings.status === 'FINAL'
176
+ ? Number(delivery.rider_earnings.amount) || 0
177
+ : null
178
+ : delivery?.rider_revenue == null
179
+ ? null
180
+ : Number(delivery.rider_revenue) || 0,
181
+ tracking_enabled: delivery?.tracking_enabled === true,
182
+ has_pickup_proof: delivery?.pickup_food_image_url != null,
183
+ has_dropoff_proof: delivery?.dropoff_food_image_url != null,
184
+ polyline_point_count: Array.isArray(delivery?.polyline) ? delivery.polyline.length : 0,
185
+ platform: order?.platform == null ? 'UNKNOWN' : String(order.platform),
186
+ city: details?.city == null ? null : String(details.city),
187
+ state: details?.state == null ? null : String(details.state),
188
+ street: details?.street == null ? null : String(details.street),
189
+ net_sale_amount: Number(order?.net_sale_amount ?? order?.amount_earned) || 0,
190
+ collected_amount: Number(order?.amount_collected) || 0,
191
+ delivery_charge: Number(details?.delivery_cost) || 0,
192
+ order_created_at: orderCreatedAt ?? createdAt,
193
+ assigned_at: delivery?.assigned_at == null ? null : new Date(delivery.assigned_at),
194
+ picked_up_at: delivery?.picked_up_at == null ? null : new Date(delivery.picked_up_at),
195
+ delivered_at: deliveredAt,
196
+ cancelled_at: delivery?.cancelled_at == null ? null : new Date(delivery.cancelled_at),
197
+ dispatch_lag_minutes: minutesBetween(orderCreatedAt, createdAt),
198
+ complete_minutes: status === 'COMPLETED' ? minutesBetween(createdAt, completedAt) : null,
199
+ // The proxy is NOT exact: `updatedAt` moves on ANY later mutation, which is why the
200
+ // metrics capture exists. The row says which one it used.
201
+ completion_is_exact: exact,
202
+ status_updated_count: delivery?.status_updated_count == null ? null : Number(delivery.status_updated_count) || 0,
203
+ created_at: createdAt,
204
+ created_at_mins: delivery?.createdAt_mins == null ? null : Number(delivery.createdAt_mins) || 0,
205
+ local_hour: hourLabelOf(delivery),
206
+ };
207
+ }
208
+ /** Weekday denormalization for a date document. */
209
+ function dayIndexOf(localDate) {
210
+ const date = new Date(localDate + 'T00:00:00.000Z');
211
+ if (Number.isNaN(date.getTime()))
212
+ return null;
213
+ return ['SUNDAY', 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY'][date.getUTCDay()];
214
+ }