@managesome/eposmatic-toolkit 0.4.9 → 0.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (351) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +455 -0
  2. package/esm/constants/enums/delivery.js +8 -0
  3. package/esm/helpers/index.js +3 -0
  4. package/esm/helpers/materialized-reports/index.js +32 -0
  5. package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
  6. package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +248 -0
  7. package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
  8. package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +245 -0
  9. package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
  10. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +430 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +373 -0
  12. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +216 -0
  13. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +319 -0
  14. package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
  15. package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
  16. package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
  17. package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
  18. package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
  19. package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +115 -0
  20. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +89 -0
  21. package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
  22. package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
  23. package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
  24. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +477 -0
  25. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
  26. package/esm/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +9 -6
  27. package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +11 -4
  28. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
  29. package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +156 -0
  30. package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
  31. package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
  32. package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +157 -0
  33. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
  34. package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
  35. package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +238 -0
  36. package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +282 -0
  37. package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
  38. package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +346 -0
  39. package/esm/helpers/reporting-contract/index.js +2 -0
  40. package/esm/helpers/reporting-contract/overview-contract.js +123 -0
  41. package/esm/helpers/reporting-contract/report-contract.js +228 -0
  42. package/esm/helpers/rider-earnings/index.js +1 -0
  43. package/esm/helpers/rider-earnings/rider-earnings.js +53 -0
  44. package/esm/helpers/rider-reports/index.js +2 -0
  45. package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
  46. package/esm/helpers/rider-reports/rider-report.js +67 -0
  47. package/esm/helpers/store/common-order-actions.js +3 -2
  48. package/esm/schemas/models/deliveries.js +82 -1
  49. package/esm/schemas/models/index.js +15 -0
  50. package/esm/schemas/models/materialized_credit_bills.js +1 -1
  51. package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
  52. package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
  53. package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
  54. package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
  55. package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
  56. package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
  57. package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
  58. package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
  59. package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
  60. package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
  61. package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
  62. package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
  63. package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
  64. package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
  65. package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
  66. package/esm/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
  67. package/esm/schemas/types/index.js +15 -0
  68. package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
  69. package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
  70. package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
  71. package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
  72. package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
  73. package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
  74. package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
  75. package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
  76. package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
  77. package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
  78. package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
  79. package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
  80. package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
  81. package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
  82. package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
  83. package/lib/constants/MATERIALIZED_REPORTS.d.ts +345 -2
  84. package/lib/constants/MATERIALIZED_REPORTS.js +457 -1
  85. package/lib/constants/enums/delivery.d.ts +7 -0
  86. package/lib/constants/enums/delivery.js +9 -1
  87. package/lib/helpers/index.d.ts +3 -0
  88. package/lib/helpers/index.js +3 -0
  89. package/lib/helpers/materialized-reports/index.d.ts +32 -0
  90. package/lib/helpers/materialized-reports/index.js +32 -0
  91. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
  92. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
  93. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +142 -0
  94. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +257 -0
  95. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +103 -0
  96. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
  97. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +73 -0
  98. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +252 -0
  99. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
  100. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
  101. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +113 -0
  102. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +442 -0
  103. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +98 -0
  104. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +386 -0
  105. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +41 -0
  106. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +220 -0
  107. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
  108. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +325 -0
  109. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
  110. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
  111. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
  112. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
  113. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
  114. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
  115. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
  116. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
  117. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
  118. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
  119. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
  120. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +120 -0
  121. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
  122. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +99 -0
  123. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
  124. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
  125. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
  126. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
  127. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +98 -0
  128. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
  129. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +130 -0
  130. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +491 -0
  131. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +47 -0
  132. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
  133. package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.d.ts +6 -3
  134. package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +8 -5
  135. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
  136. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +10 -3
  137. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
  138. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
  139. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
  140. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +160 -0
  141. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
  142. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
  143. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
  144. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
  145. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
  146. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +160 -0
  147. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
  148. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
  149. package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
  150. package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
  151. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
  152. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +244 -0
  153. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
  154. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +289 -0
  155. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +98 -0
  156. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
  157. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
  158. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +352 -0
  159. package/lib/helpers/reporting-contract/index.d.ts +2 -0
  160. package/lib/helpers/reporting-contract/index.js +18 -0
  161. package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
  162. package/lib/helpers/reporting-contract/overview-contract.js +127 -0
  163. package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
  164. package/lib/helpers/reporting-contract/report-contract.js +239 -0
  165. package/lib/helpers/rider-earnings/index.d.ts +1 -0
  166. package/lib/helpers/rider-earnings/index.js +17 -0
  167. package/lib/helpers/rider-earnings/rider-earnings.d.ts +51 -0
  168. package/lib/helpers/rider-earnings/rider-earnings.js +57 -0
  169. package/lib/helpers/rider-reports/index.d.ts +2 -0
  170. package/lib/helpers/rider-reports/index.js +18 -0
  171. package/lib/helpers/rider-reports/rider-daily-report.d.ts +28 -0
  172. package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
  173. package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
  174. package/lib/helpers/rider-reports/rider-report.js +70 -0
  175. package/lib/helpers/store/common-order-actions.js +3 -2
  176. package/lib/helpers/types/materialized-reports-apis.d.ts +300 -1
  177. package/lib/schemas/models/deliveries.d.ts +58 -1
  178. package/lib/schemas/models/deliveries.js +81 -0
  179. package/lib/schemas/models/expense_details.d.ts +3 -3
  180. package/lib/schemas/models/index.d.ts +15 -0
  181. package/lib/schemas/models/index.js +15 -0
  182. package/lib/schemas/models/materialized_credit_bills.d.ts +3 -3
  183. package/lib/schemas/models/materialized_credit_bills.js +1 -1
  184. package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
  185. package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
  186. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
  187. package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
  188. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
  189. package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
  190. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
  191. package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
  192. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
  193. package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
  194. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
  195. package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
  196. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
  197. package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
  198. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
  199. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
  200. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
  201. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
  202. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
  203. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
  204. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
  205. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
  206. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
  207. package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
  208. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
  209. package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
  210. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
  211. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
  212. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
  213. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
  214. package/lib/schemas/models/materialized_tenant_sales_overview_reports.d.ts +3 -3
  215. package/lib/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
  216. package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
  217. package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
  218. package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
  219. package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
  220. package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
  221. package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
  222. package/lib/schemas/types/deliveries.d.ts +40 -1
  223. package/lib/schemas/types/index.d.ts +15 -0
  224. package/lib/schemas/types/index.js +15 -0
  225. package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
  226. package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
  227. package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
  228. package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
  229. package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
  230. package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
  231. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
  232. package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
  233. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
  234. package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
  235. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
  236. package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
  237. package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
  238. package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
  239. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
  240. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
  241. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
  242. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
  243. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
  244. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
  245. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
  246. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
  247. package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
  248. package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
  249. package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
  250. package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
  251. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
  252. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
  253. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
  254. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
  255. package/lib/schemas/types/materialized_tenant_sales_overview_reports.d.ts +7 -0
  256. package/lib/tests/deliveries-schema.test.d.ts +1 -0
  257. package/lib/tests/deliveries-schema.test.js +70 -0
  258. package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
  259. package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
  260. package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
  261. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  262. package/lib/tests/materialized-reports/fixtures.js +1 -0
  263. package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
  264. package/lib/tests/materialized-reports/materialized-cash-compile.test.js +197 -0
  265. package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
  266. package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
  267. package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
  268. package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +153 -0
  269. package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
  270. package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
  271. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
  272. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
  273. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
  274. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
  275. package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
  276. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +242 -0
  277. package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
  278. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
  279. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
  280. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +142 -0
  281. package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
  282. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
  283. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
  284. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
  285. package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
  286. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
  287. package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
  288. package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
  289. package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
  290. package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
  291. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
  292. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
  293. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
  294. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
  295. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
  296. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
  297. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
  298. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
  299. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
  300. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
  301. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
  302. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
  303. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
  304. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
  305. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
  306. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
  307. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
  308. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
  309. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
  310. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
  311. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
  312. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +271 -0
  313. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
  314. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
  315. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
  316. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
  317. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
  318. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
  319. package/lib/tests/materialized-reports/materialized-reports-scope-group-helpers.test.js +13 -13
  320. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
  321. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
  322. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
  323. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +207 -0
  324. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
  325. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
  326. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
  327. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
  328. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
  329. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
  330. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
  331. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
  332. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
  333. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
  334. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
  335. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
  336. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
  337. package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
  338. package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
  339. package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
  340. package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
  341. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
  342. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
  343. package/lib/tests/reporting-contract.test.d.ts +1 -0
  344. package/lib/tests/reporting-contract.test.js +267 -0
  345. package/lib/tests/rider-daily-report.test.d.ts +1 -0
  346. package/lib/tests/rider-daily-report.test.js +86 -0
  347. package/lib/tests/rider-earnings.test.d.ts +1 -0
  348. package/lib/tests/rider-earnings.test.js +65 -0
  349. package/lib/tests/rider-report.test.d.ts +1 -0
  350. package/lib/tests/rider-report.test.js +98 -0
  351. package/package.json +10 -1
@@ -0,0 +1,588 @@
1
+ import mongoose from 'mongoose';
2
+ import { MATERIALIZED_REPORT_SCOPE_ENUM, MATERIALIZED_REPORT_TYPE_ENUM, MATERIALIZED_SALES_COMPARISON_REPORT_SCOPES, MATERIALIZED_TENANT_SALES_COMPARISON_ENTRIES_SCHEMA_VERSION, MATERIALIZED_TENANT_SALES_COMPARISON_REPORTS_SCHEMA_VERSION, SALES_COMPARISON_KEY_FILTERS, } from '../../constants/MATERIALIZED_REPORTS';
3
+ import { buildMaterializedTenantReportIteration } from './materialized-tenant-reports-iterations-helpers';
4
+ import { getMaterializedPeriodScopeFields } from './scope-helpers';
5
+ import { addSalesComparisonCounters, createEmptySalesComparisonCounters, } from './materialized-sales-comparison-accumulator-helpers';
6
+ /**
7
+ * Sales Comparison close-day helpers.
8
+ *
9
+ * ## Period counters are RE-FOLDED, never patched
10
+ *
11
+ * The discount report accumulates period deltas forward and subtracts a day
12
+ * delta on re-close. That design produced defects 4–6 in the handoff (emptied
13
+ * days, corrections that REMOVE rows, and a missing period document rebuilt
14
+ * from one day). This report mirrors CASH instead: every touched period is
15
+ * rebuilt from its whole day set, so a correction cannot leave residue and a
16
+ * missing period document is rebuilt from the days still on hand.
17
+ *
18
+ * ## The watermark comes from the FOLDED DAYS
19
+ *
20
+ * A folded document that inherited the STORED document watermark would look
21
+ * unchanged to the write guard, so the write would be skipped forever and the
22
+ * period would freeze at its first closed day. This bug shipped once in the
23
+ * prep time report; it is designed out here from the start.
24
+ *
25
+ * ## Close-day fetch contract — UNDER-FETCHING IS SILENT
26
+ *
27
+ * `existing` / `existingEntries` must contain:
28
+ * 1. the closing day's own range document (and the period documents it rolls
29
+ * into), and
30
+ * 2. **every stored `localDate` document inside those periods** — the sibling
31
+ * days are the fold's input. `getMaterializedSalesComparisonPeriodDayKeys`
32
+ * returns exactly the day keys a caller must fetch (`scope_field: { $in }`).
33
+ *
34
+ * Passing only (1) still handles emptied days and corrections on the closing
35
+ * day, but a period document is then rebuilt from the closing day alone and
36
+ * every sibling day silently disappears. That is why (2) is part of the
37
+ * contract, exactly like the discount entries contract.
38
+ *
39
+ * Helpers never throw — invalid input returns `null`.
40
+ */
41
+ /** Period scopes this report materializes (everything except the day scope). */
42
+ export const MATERIALIZED_SALES_COMPARISON_PERIOD_SCOPES = MATERIALIZED_SALES_COMPARISON_REPORT_SCOPES.filter((scope) => scope !== MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE);
43
+ /** True when the scope is the plain day scope. */
44
+ export const isMaterializedSalesComparisonDayScope = (scopeContext) => String(scopeContext) === MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE;
45
+ const scopeKey = (doc) => String(doc.scope_context) + '|' + String(doc.scope_field);
46
+ /**
47
+ * The stored scope references one settled day's plan needs: its `localDate`
48
+ * document plus the five period documents it rolls into. NO hour scope — this
49
+ * report has none.
50
+ */
51
+ export function getMaterializedSalesComparisonScopeRefsForDay(localDate) {
52
+ const periodFields = getMaterializedPeriodScopeFields(localDate);
53
+ if (periodFields == null)
54
+ return null;
55
+ const refs = [
56
+ {
57
+ scope_context: MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
58
+ scope_field: localDate,
59
+ },
60
+ ];
61
+ for (const scope of MATERIALIZED_SALES_COMPARISON_PERIOD_SCOPES) {
62
+ const field = periodFields[scope];
63
+ if (field == null || field === '')
64
+ return null;
65
+ refs.push({ scope_context: scope, scope_field: field });
66
+ }
67
+ return refs;
68
+ }
69
+ /* ------------------------------------------------------------------------ */
70
+ /* Period day-key ranges */
71
+ /* ------------------------------------------------------------------------ */
72
+ const KEY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
73
+ const keyToUtcDate = (key) => {
74
+ if (typeof key !== 'string' || !KEY_PATTERN.test(key))
75
+ return null;
76
+ const [year, month, day] = key.split('-').map(Number);
77
+ const date = new Date(Date.UTC(year, month - 1, day));
78
+ if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) {
79
+ return null;
80
+ }
81
+ return date;
82
+ };
83
+ const utcDateToKey = (date) => date.toISOString().slice(0, 10);
84
+ const addUtcDays = (date, amount) => new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() + amount));
85
+ /** Inclusive [start, end] day keys of one period scope value. */
86
+ function periodDayRange(periodScope, periodField) {
87
+ switch (periodScope) {
88
+ case MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_WEEK: {
89
+ const startDate = keyToUtcDate(periodField);
90
+ if (startDate == null)
91
+ return null;
92
+ return { start: periodField, end: utcDateToKey(addUtcDays(startDate, 6)) };
93
+ }
94
+ case MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_MONTH: {
95
+ const match = /^(\d{4})-(\d{2})$/.exec(periodField);
96
+ if (match == null)
97
+ return null;
98
+ const year = Number(match[1]);
99
+ const month = Number(match[2]);
100
+ if (month < 1 || month > 12)
101
+ return null;
102
+ const first = new Date(Date.UTC(year, month - 1, 1));
103
+ const last = new Date(Date.UTC(year, month, 0));
104
+ return { start: utcDateToKey(first), end: utcDateToKey(last) };
105
+ }
106
+ case MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_QUARTER: {
107
+ const match = /^(\d{4})-Q([1-4])$/.exec(periodField);
108
+ if (match == null)
109
+ return null;
110
+ const year = Number(match[1]);
111
+ const quarter = Number(match[2]);
112
+ const first = new Date(Date.UTC(year, (quarter - 1) * 3, 1));
113
+ const last = new Date(Date.UTC(year, quarter * 3, 0));
114
+ return { start: utcDateToKey(first), end: utcDateToKey(last) };
115
+ }
116
+ case MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_SEMESTER: {
117
+ const match = /^(\d{4})-S([12])$/.exec(periodField);
118
+ if (match == null)
119
+ return null;
120
+ const year = Number(match[1]);
121
+ const semester = Number(match[2]);
122
+ const first = new Date(Date.UTC(year, semester === 1 ? 0 : 6, 1));
123
+ const last = new Date(Date.UTC(year, semester === 1 ? 6 : 12, 0));
124
+ return { start: utcDateToKey(first), end: utcDateToKey(last) };
125
+ }
126
+ case MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_YEAR: {
127
+ const match = /^(\d{4})$/.exec(periodField);
128
+ if (match == null)
129
+ return null;
130
+ const year = Number(match[1]);
131
+ return { start: `${year}-01-01`, end: `${year}-12-31` };
132
+ }
133
+ default:
134
+ return null;
135
+ }
136
+ }
137
+ /**
138
+ * Every `localDate` scope value a caller must fetch to re-fold the periods one
139
+ * settled day touches — the union of the day's week/month/quarter/semester/year
140
+ * ranges (≤ 366 keys). Sorted, deduped.
141
+ */
142
+ export function getMaterializedSalesComparisonPeriodDayKeys(localDate) {
143
+ const periodFields = getMaterializedPeriodScopeFields(localDate);
144
+ if (periodFields == null)
145
+ return null;
146
+ const keys = new Set();
147
+ for (const scope of MATERIALIZED_SALES_COMPARISON_PERIOD_SCOPES) {
148
+ const field = periodFields[scope];
149
+ if (field == null || field === '')
150
+ return null;
151
+ const range = periodDayRange(scope, field);
152
+ if (range == null)
153
+ return null;
154
+ const start = keyToUtcDate(range.start);
155
+ const end = keyToUtcDate(range.end);
156
+ if (start == null || end == null)
157
+ return null;
158
+ for (let cursor = start; cursor.getTime() <= end.getTime(); cursor = addUtcDays(cursor, 1)) {
159
+ keys.add(utcDateToKey(cursor));
160
+ }
161
+ }
162
+ return [...keys].sort();
163
+ }
164
+ /* ------------------------------------------------------------------------ */
165
+ /* Folds */
166
+ /* ------------------------------------------------------------------------ */
167
+ /** Highest `source_watermark` across the day documents a fold actually used. */
168
+ function watermarkOfFoldedDays(dayDocuments, fallback) {
169
+ let latest = fallback.getTime();
170
+ for (const doc of dayDocuments ?? []) {
171
+ const time = new Date(doc?.source_watermark ?? 0).getTime();
172
+ if (!Number.isNaN(time) && time > latest)
173
+ latest = time;
174
+ }
175
+ return new Date(latest);
176
+ }
177
+ /**
178
+ * Folds the counters of every DAY document that belongs to one period scope.
179
+ * Pure; the caller supplies the whole day set.
180
+ */
181
+ export function foldMaterializedSalesComparisonPeriodCounters(input) {
182
+ const folded = {};
183
+ for (const dayDocument of input?.dayDocuments ?? []) {
184
+ if (!isMaterializedSalesComparisonDayScope(String(dayDocument?.scope_context)))
185
+ continue;
186
+ const fields = getMaterializedPeriodScopeFields(String(dayDocument.scope_field));
187
+ if (fields == null)
188
+ continue;
189
+ if (fields[String(input.periodScope)] !== input.periodScopeField)
190
+ continue;
191
+ for (const [key, block] of Object.entries(dayDocument.sales_counters ?? {})) {
192
+ const target = folded[key] ?? createEmptySalesComparisonCounters();
193
+ addSalesComparisonCounters(target, block);
194
+ folded[key] = target;
195
+ }
196
+ }
197
+ return folded;
198
+ }
199
+ /** Newest-first row order, then stable id order. */
200
+ function compareRowsDescending(a, b) {
201
+ const byTime = new Date(b.time).getTime() - new Date(a.time).getTime();
202
+ if (byTime !== 0)
203
+ return byTime;
204
+ // Same instant: `order_id` ASC, matching the page cursor.
205
+ return a.order_id < b.order_id ? -1 : a.order_id > b.order_id ? 1 : 0;
206
+ }
207
+ /**
208
+ * Merges two entry sections, de-duplicating rows by `order_id`.
209
+ *
210
+ * A row belongs to exactly one settled day, so the same order id twice means
211
+ * the fold saw it twice; money and rows must never double-count.
212
+ */
213
+ export function mergeMaterializedSalesComparisonEntrySections(target, source) {
214
+ const rowsByKey = new Map();
215
+ const seenByKey = new Map();
216
+ const absorb = (input) => {
217
+ if (input == null)
218
+ return;
219
+ for (const [key, section] of Object.entries(input)) {
220
+ const rows = rowsByKey.get(key) ?? [];
221
+ const seen = seenByKey.get(key) ?? new Set();
222
+ for (const row of section?.rows ?? []) {
223
+ const identity = String(row.order_id ?? '');
224
+ if (identity !== '') {
225
+ if (seen.has(identity))
226
+ continue;
227
+ seen.add(identity);
228
+ }
229
+ rows.push(row);
230
+ }
231
+ rowsByKey.set(key, rows);
232
+ seenByKey.set(key, seen);
233
+ }
234
+ };
235
+ absorb(target);
236
+ absorb(source);
237
+ const out = {};
238
+ for (const [key, rows] of rowsByKey) {
239
+ rows.sort(compareRowsDescending);
240
+ out[key] = { rows };
241
+ }
242
+ return out;
243
+ }
244
+ /**
245
+ * Folds the itemized rows of every DAY entry document that belongs to one
246
+ * period scope, de-duplicated by `order_id`.
247
+ */
248
+ export function foldMaterializedSalesComparisonPeriodEntries(input) {
249
+ let merged = {};
250
+ for (const dayDocument of input?.dayDocuments ?? []) {
251
+ if (!isMaterializedSalesComparisonDayScope(String(dayDocument?.scope_context)))
252
+ continue;
253
+ const fields = getMaterializedPeriodScopeFields(String(dayDocument.scope_field));
254
+ if (fields == null)
255
+ continue;
256
+ if (fields[String(input.periodScope)] !== input.periodScopeField)
257
+ continue;
258
+ merged = mergeMaterializedSalesComparisonEntrySections(merged, dayDocument.sales_entries ?? null);
259
+ }
260
+ return merged;
261
+ }
262
+ /* ------------------------------------------------------------------------ */
263
+ /* Write guards */
264
+ /* ------------------------------------------------------------------------ */
265
+ /**
266
+ * Canonical JSON of a counter/row tree (object keys sorted) so a content
267
+ * comparison cannot be fooled by insertion order — e.g. a document reloaded
268
+ * from Mongo with its map keys in a different order.
269
+ */
270
+ function stableJson(value) {
271
+ const canonicalize = (input) => {
272
+ if (Array.isArray(input))
273
+ return input.map(canonicalize);
274
+ if (input != null && typeof input === 'object') {
275
+ const out = {};
276
+ for (const key of Object.keys(input).sort()) {
277
+ out[key] = canonicalize(input[key]);
278
+ }
279
+ return out;
280
+ }
281
+ return input;
282
+ };
283
+ return JSON.stringify(canonicalize(value ?? null));
284
+ }
285
+ /**
286
+ * Write guard: does the stored document need a structural write?
287
+ *
288
+ * - `force` bypasses the guard (repairs / schema rollouts);
289
+ * - a schema-version or key-grammar change forces the write;
290
+ * - a NEWER watermark forces the write;
291
+ * - an OLDER watermark is a stale replay and is skipped;
292
+ * - an EQUAL watermark still writes when the CONTENT differs. This is the
293
+ * correction case: removing an order can leave the day's max `updatedAt`
294
+ * unchanged, and a watermark-only guard would then leave the period at its
295
+ * pre-correction figures forever.
296
+ */
297
+ export function needsMaterializedSalesComparisonReportWrite(existing, incoming, force = false) {
298
+ if (existing == null || incoming == null)
299
+ return true;
300
+ if (force)
301
+ return true;
302
+ if (Number(existing.schema_version) !== Number(incoming.schema_version) ||
303
+ Number.isNaN(Number(incoming.schema_version))) {
304
+ return true;
305
+ }
306
+ if ((existing.sale_type_key_filters ?? []).join(':') !== (incoming.sale_type_key_filters ?? []).join(':')) {
307
+ return true;
308
+ }
309
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
310
+ const next = new Date(incoming.source_watermark ?? 0).getTime();
311
+ if (Number.isNaN(stored) || Number.isNaN(next))
312
+ return true;
313
+ if (next > stored)
314
+ return true;
315
+ if (next < stored)
316
+ return false;
317
+ return stableJson(existing.sales_counters) !== stableJson(incoming.sales_counters);
318
+ }
319
+ /** True when the stored entry document already carries these exact rows. */
320
+ export function needsMaterializedSalesComparisonEntriesWrite(existing, incoming, force = false) {
321
+ if (existing == null || incoming == null)
322
+ return true;
323
+ if (force)
324
+ return true;
325
+ if (Number(existing.schema_version) !== Number(incoming.schema_version) ||
326
+ Number.isNaN(Number(incoming.schema_version))) {
327
+ return true;
328
+ }
329
+ if ((existing.sale_type_key_filters ?? []).join(':') !== (incoming.sale_type_key_filters ?? []).join(':')) {
330
+ return true;
331
+ }
332
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
333
+ const next = new Date(incoming.source_watermark ?? 0).getTime();
334
+ if (Number.isNaN(stored) || Number.isNaN(next))
335
+ return true;
336
+ if (next > stored)
337
+ return true;
338
+ if (next < stored)
339
+ return false;
340
+ return stableJson(existing.sales_entries) !== stableJson(incoming.sales_entries);
341
+ }
342
+ /**
343
+ * Builds the close-day plan for ONE settled tenant-day.
344
+ *
345
+ * The DAY scope is written from the compile. Every touched PERIOD scope is
346
+ * re-folded from its whole day set (stored siblings + the freshly compiled
347
+ * day). Returns `null` on malformed input.
348
+ */
349
+ export function buildTenantSalesComparisonCloseDayPlan(input) {
350
+ if (input == null)
351
+ return null;
352
+ const { tenantId, reason } = input;
353
+ if (typeof tenantId !== 'string' || tenantId.length === 0)
354
+ return null;
355
+ if (typeof reason !== 'string' || reason.length === 0)
356
+ return null;
357
+ const computedAt = input.computedAt ?? new Date();
358
+ if (Number.isNaN(computedAt.getTime()))
359
+ return null;
360
+ const compiledReports = (input.reports ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
361
+ const compiledEntries = (input.entries ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
362
+ const storedReports = (input.existing ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
363
+ const storedEntries = (input.existingEntries ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
364
+ const compiledDateDoc = compiledReports.find((doc) => isMaterializedSalesComparisonDayScope(String(doc.scope_context)));
365
+ const compiledDateEntries = compiledEntries.find((doc) => isMaterializedSalesComparisonDayScope(String(doc.scope_context)));
366
+ const localDate = input.localDate ?? compiledDateDoc?.scope_field ?? null;
367
+ if (localDate == null || localDate === '' || getMaterializedSalesComparisonScopeRefsForDay(localDate) == null) {
368
+ return null;
369
+ }
370
+ const writes = [];
371
+ const entryWrites = [];
372
+ const staleDocuments = [];
373
+ const staleEntryDocuments = [];
374
+ const skippedDocuments = [];
375
+ const skippedEntryDocuments = [];
376
+ const createdPeriodDocuments = [];
377
+ const storedReportsByScope = new Map();
378
+ for (const doc of storedReports)
379
+ storedReportsByScope.set(scopeKey(doc), doc);
380
+ const storedEntriesByScope = new Map();
381
+ for (const doc of storedEntries)
382
+ storedEntriesByScope.set(scopeKey(doc), doc);
383
+ const addWrite = (report) => {
384
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
385
+ const iteration = buildMaterializedTenantReportIteration(persisted, {
386
+ reportType: MATERIALIZED_REPORT_TYPE_ENUM.TENANT_SALES_COMPARISON_REPORTS,
387
+ reason,
388
+ computedAt,
389
+ });
390
+ if (iteration == null)
391
+ return false;
392
+ writes.push({ report: persisted, iteration: iteration });
393
+ return true;
394
+ };
395
+ const addEntryWrite = (report) => {
396
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
397
+ const iteration = buildMaterializedTenantReportIteration(persisted, {
398
+ reportType: MATERIALIZED_REPORT_TYPE_ENUM.TENANT_SALES_COMPARISON_ENTRIES,
399
+ reason,
400
+ computedAt,
401
+ });
402
+ if (iteration == null)
403
+ return false;
404
+ entryWrites.push({ report: persisted, iteration: iteration });
405
+ return true;
406
+ };
407
+ const storedDateDoc = storedReportsByScope.get(MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE + '|' + localDate);
408
+ const storedDateEntries = storedEntriesByScope.get(MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE + '|' + localDate);
409
+ // ---- the DAY scope, straight from the compile ----
410
+ let effectiveDayDoc = null;
411
+ if (compiledDateDoc != null) {
412
+ const next = {
413
+ ...compiledDateDoc,
414
+ _id: storedDateDoc?._id ?? compiledDateDoc._id ?? new mongoose.Types.ObjectId().toHexString(),
415
+ iteration: Number(storedDateDoc?.iteration ?? 0) + 1,
416
+ };
417
+ if (needsMaterializedSalesComparisonReportWrite(storedDateDoc, next, input.force === true)) {
418
+ if (addWrite(next))
419
+ effectiveDayDoc = next;
420
+ }
421
+ else if (storedDateDoc != null) {
422
+ skippedDocuments.push(storedDateDoc);
423
+ effectiveDayDoc = storedDateDoc;
424
+ }
425
+ else {
426
+ effectiveDayDoc = next;
427
+ }
428
+ }
429
+ else if (storedDateDoc != null) {
430
+ // A day that no longer has settled orders is retired; the period re-fold
431
+ // below removes its contribution.
432
+ staleDocuments.push(storedDateDoc);
433
+ }
434
+ let effectiveDayEntries = null;
435
+ if (compiledDateEntries != null) {
436
+ const next = {
437
+ ...compiledDateEntries,
438
+ _id: storedDateEntries?._id ?? compiledDateEntries._id ?? new mongoose.Types.ObjectId().toHexString(),
439
+ iteration: Number(storedDateEntries?.iteration ?? 0) + 1,
440
+ };
441
+ if (needsMaterializedSalesComparisonEntriesWrite(storedDateEntries, next, input.force === true)) {
442
+ if (addEntryWrite(next))
443
+ effectiveDayEntries = next;
444
+ }
445
+ else if (storedDateEntries != null) {
446
+ skippedEntryDocuments.push(storedDateEntries);
447
+ effectiveDayEntries = storedDateEntries;
448
+ }
449
+ else {
450
+ effectiveDayEntries = next;
451
+ }
452
+ }
453
+ else if (storedDateEntries != null) {
454
+ staleEntryDocuments.push(storedDateEntries);
455
+ }
456
+ // ---- the fold's day set: every OTHER stored day + this compiled day ----
457
+ const nextDayDocs = storedReports.filter((doc) => isMaterializedSalesComparisonDayScope(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
458
+ if (effectiveDayDoc != null)
459
+ nextDayDocs.push(effectiveDayDoc);
460
+ const nextDayEntryDocs = storedEntries.filter((doc) => isMaterializedSalesComparisonDayScope(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
461
+ if (effectiveDayEntries != null)
462
+ nextDayEntryDocs.push(effectiveDayEntries);
463
+ // ---- touched periods (the closing day's; one day cannot touch others) ----
464
+ const periodFields = getMaterializedPeriodScopeFields(localDate);
465
+ if (periodFields == null)
466
+ return null;
467
+ const touchedPeriods = [];
468
+ for (const scope of MATERIALIZED_SALES_COMPARISON_PERIOD_SCOPES) {
469
+ const field = periodFields[scope];
470
+ if (field == null || field === '')
471
+ return null;
472
+ touchedPeriods.push({ scope_context: scope, scope_field: field });
473
+ }
474
+ for (const period of touchedPeriods) {
475
+ const key = scopeKey(period);
476
+ const existing = storedReportsByScope.get(key);
477
+ const folded = foldMaterializedSalesComparisonPeriodCounters({
478
+ periodScope: period.scope_context,
479
+ periodScopeField: period.scope_field,
480
+ dayDocuments: nextDayDocs,
481
+ });
482
+ const keys = Object.keys(folded).sort();
483
+ if (keys.length === 0) {
484
+ if (existing != null && !staleDocuments.includes(existing)) {
485
+ staleDocuments.push(existing);
486
+ }
487
+ continue;
488
+ }
489
+ const salesCounters = {};
490
+ const counterRows = [];
491
+ for (const counterKey of keys) {
492
+ salesCounters[counterKey] = folded[counterKey];
493
+ counterRows.push({ key: counterKey, counters: folded[counterKey] });
494
+ }
495
+ const contributingDays = nextDayDocs.filter((doc) => {
496
+ const fields = getMaterializedPeriodScopeFields(String(doc.scope_field));
497
+ return fields != null && fields[period.scope_context] === period.scope_field;
498
+ });
499
+ const report = {
500
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
501
+ tenant_id: tenantId,
502
+ brand_id: existing?.brand_id ?? effectiveDayDoc?.brand_id ?? compiledDateDoc?.brand_id ?? '',
503
+ scope_context: period.scope_context,
504
+ scope_field: period.scope_field,
505
+ day_index: null,
506
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...SALES_COMPARISON_KEY_FILTERS],
507
+ sales_counters: salesCounters,
508
+ sales_counter_rows: counterRows,
509
+ iteration: existing?.iteration,
510
+ schema_version: existing?.schema_version ?? MATERIALIZED_TENANT_SALES_COMPARISON_REPORTS_SCHEMA_VERSION,
511
+ // FROM THE FOLDED DAYS - never the stored watermark, or the write would
512
+ // be skipped forever and the period would freeze at its first closed day.
513
+ source_watermark: watermarkOfFoldedDays(contributingDays, existing?.source_watermark ?? computedAt),
514
+ computed_at: computedAt,
515
+ createdAt: existing?.createdAt ?? computedAt,
516
+ updatedAt: computedAt,
517
+ };
518
+ const next = {
519
+ ...report,
520
+ iteration: Number(existing?.iteration ?? 0) + 1,
521
+ };
522
+ if (needsMaterializedSalesComparisonReportWrite(existing, next, input.force === true)) {
523
+ if (addWrite(next) && existing == null) {
524
+ createdPeriodDocuments.push({
525
+ scope_context: period.scope_context,
526
+ scope_field: period.scope_field,
527
+ });
528
+ }
529
+ }
530
+ else if (existing != null) {
531
+ skippedDocuments.push(existing);
532
+ }
533
+ }
534
+ for (const period of touchedPeriods) {
535
+ const key = scopeKey(period);
536
+ const existing = storedEntriesByScope.get(key);
537
+ const sections = foldMaterializedSalesComparisonPeriodEntries({
538
+ periodScope: period.scope_context,
539
+ periodScopeField: period.scope_field,
540
+ dayDocuments: nextDayEntryDocs,
541
+ });
542
+ const keys = Object.keys(sections);
543
+ if (keys.length === 0) {
544
+ if (existing != null)
545
+ staleEntryDocuments.push(existing);
546
+ continue;
547
+ }
548
+ const contributingDays = nextDayEntryDocs.filter((doc) => {
549
+ const fields = getMaterializedPeriodScopeFields(String(doc.scope_field));
550
+ return fields != null && fields[period.scope_context] === period.scope_field;
551
+ });
552
+ const report = {
553
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
554
+ tenant_id: tenantId,
555
+ brand_id: existing?.brand_id ?? effectiveDayEntries?.brand_id ?? compiledDateEntries?.brand_id ?? '',
556
+ scope_context: period.scope_context,
557
+ scope_field: period.scope_field,
558
+ day_index: null,
559
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...SALES_COMPARISON_KEY_FILTERS],
560
+ sales_entries: sections,
561
+ iteration: existing?.iteration,
562
+ schema_version: existing?.schema_version ?? MATERIALIZED_TENANT_SALES_COMPARISON_ENTRIES_SCHEMA_VERSION,
563
+ source_watermark: watermarkOfFoldedDays(contributingDays, existing?.source_watermark ?? computedAt),
564
+ computed_at: computedAt,
565
+ createdAt: existing?.createdAt ?? computedAt,
566
+ updatedAt: computedAt,
567
+ };
568
+ const next = {
569
+ ...report,
570
+ iteration: Number(existing?.iteration ?? 0) + 1,
571
+ };
572
+ if (needsMaterializedSalesComparisonEntriesWrite(existing, next, input.force === true)) {
573
+ addEntryWrite(next);
574
+ }
575
+ else if (existing != null) {
576
+ skippedEntryDocuments.push(existing);
577
+ }
578
+ }
579
+ return {
580
+ writes,
581
+ entryWrites,
582
+ staleDocuments,
583
+ staleEntryDocuments,
584
+ skippedDocuments,
585
+ skippedEntryDocuments,
586
+ createdPeriodDocuments,
587
+ };
588
+ }