@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,107 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
4
+ const materialized_discount_close_day_helpers_1 = require("../../helpers/materialized-reports/materialized-discount-close-day-helpers");
5
+ const materialized_discount_compile_helpers_1 = require("../../helpers/materialized-reports/materialized-discount-compile-helpers");
6
+ const fixtures_1 = require("./fixtures");
7
+ /**
8
+ * Discounts counter ROWS contract (M1).
9
+ *
10
+ * \`discount_counter_rows\` exists so the read can \`$unwind\` + \`$group\` with direct
11
+ * sums instead of navigating a dynamic-key map inside an aggregation. The rows
12
+ * and the map are written from ONE accumulator pass and the close-day fold
13
+ * REBUILDS the rows from the map — so these tests assert the invariant that
14
+ * matters: for every key, the row's counters EQUAL the map's counters, at every
15
+ * stage (fresh compile, re-close, correction, emptied day).
16
+ */
17
+ const TENANT = 'basha-istanbul-f7';
18
+ const BRAND = 'brand-basha';
19
+ const AT = new Date('2026-10-01T00:00:00.000Z');
20
+ const ordersForDay = (localDate) => (0, fixtures_1.loadOrdersDataset)('basha').filter((order) => order.localDate === localDate);
21
+ const compileDay = (localDate) => (0, materialized_discount_compile_helpers_1.compileTenantDiscountReports)({
22
+ tenantId: TENANT,
23
+ brandId: BRAND,
24
+ localDate,
25
+ orders: ordersForDay(localDate),
26
+ gmtOffset: 5,
27
+ computedAt: AT,
28
+ });
29
+ /** Asserts rows and map agree in BOTH directions for every document. */
30
+ function expectRowsMatchMap(reports) {
31
+ for (const report of reports) {
32
+ const map = report.discount_counters ?? {};
33
+ const rows = report.discount_counter_rows ?? [];
34
+ expect(new Set(rows.map((row) => row.key))).toEqual(new Set(Object.keys(map)));
35
+ for (const row of rows) {
36
+ expect(row.counters).toEqual(map[row.key]);
37
+ }
38
+ }
39
+ }
40
+ describe('materialized discounts — counter rows mirror the counter map', () => {
41
+ it('a fresh compile emits rows that equal the map, key for key', () => {
42
+ const compiled = compileDay('2026-09-13');
43
+ expect(compiled.reports.length).toBeGreaterThan(0);
44
+ expectRowsMatchMap(compiled.reports);
45
+ // At least one document must actually carry rows (else this test is vacuous)
46
+ expect(compiled.reports.some((doc) => (doc.discount_counter_rows ?? []).length > 0)).toBe(true);
47
+ });
48
+ it('a day with no discounts carries NEITHER map nor rows', () => {
49
+ const compiled = (0, materialized_discount_compile_helpers_1.compileTenantDiscountReports)({
50
+ tenantId: TENANT,
51
+ brandId: BRAND,
52
+ localDate: '2026-01-01',
53
+ orders: [],
54
+ gmtOffset: 5,
55
+ computedAt: AT,
56
+ });
57
+ expect(compiled.reports).toHaveLength(0);
58
+ });
59
+ it('the close-day fold rebuilds rows from the map after an accumulation', () => {
60
+ const compiled = compileDay('2026-09-13');
61
+ const plan = (0, materialized_discount_close_day_helpers_1.buildTenantDiscountCloseDayPlan)({
62
+ tenantId: TENANT,
63
+ reports: compiled.reports,
64
+ entries: compiled.entries,
65
+ reason: 'NEW_DAY',
66
+ computedAt: AT,
67
+ });
68
+ const monthWrite = plan.writes.find((write) => write.report.scope_context === MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_MONTH);
69
+ // Accumulated into a stored doc: rows must follow the summed map.
70
+ const stored = { ...monthWrite.report, iteration: 1 };
71
+ const updated = (0, materialized_discount_close_day_helpers_1.updateMaterializedDiscountReport)(stored, { additions: [monthWrite.report] }, { computedAt: AT });
72
+ expect(updated).not.toBeNull();
73
+ expectRowsMatchMap([updated]);
74
+ });
75
+ it('the fold drops emptied keys from BOTH the map and the rows', () => {
76
+ const compiled = compileDay('2026-09-13');
77
+ const dateDoc = compiled.reports.find((doc) => doc.scope_context === MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE);
78
+ const base = { ...dateDoc, iteration: 1 };
79
+ const zeroed = (0, materialized_discount_close_day_helpers_1.updateMaterializedDiscountReport)(base, { subtract: [dateDoc] }, { computedAt: AT });
80
+ expect(zeroed.discount_counters).toBeNull();
81
+ expect(zeroed.discount_counter_rows).toBeNull();
82
+ });
83
+ it('a re-close through the plan keeps rows and map in step', () => {
84
+ const compiled = compileDay('2026-09-13');
85
+ const first = (0, materialized_discount_close_day_helpers_1.buildTenantDiscountCloseDayPlan)({
86
+ tenantId: TENANT,
87
+ reports: compiled.reports,
88
+ entries: compiled.entries,
89
+ reason: 'NEW_DAY',
90
+ computedAt: AT,
91
+ });
92
+ const persisted = first.writes.map((write) => write.report);
93
+ expectRowsMatchMap(persisted);
94
+ // Forced re-close: the period documents are corrected by subtraction.
95
+ const second = (0, materialized_discount_close_day_helpers_1.buildTenantDiscountCloseDayPlan)({
96
+ tenantId: TENANT,
97
+ reports: compiled.reports,
98
+ entries: compiled.entries,
99
+ existing: persisted,
100
+ existingEntries: first.entryWrites.map((write) => write.report),
101
+ reason: 'RECLOSE',
102
+ force: true,
103
+ computedAt: AT,
104
+ });
105
+ expectRowsMatchMap(second.writes.map((write) => write.report));
106
+ });
107
+ });
@@ -0,0 +1,125 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
4
+ const materialized_discount_close_day_helpers_1 = require("../../helpers/materialized-reports/materialized-discount-close-day-helpers");
5
+ /**
6
+ * PERIOD-scope entry accumulation (M1).
7
+ *
8
+ * The close compiles ONE day of rows. A DAY scope (localHour / localDate) is
9
+ * replaced wholesale, but a PERIOD scope (localWeek / localWeekOfYear /
10
+ * localMonth) must ACCUMULATE - otherwise the period document ends up holding
11
+ * only its final closed day. That was the measured symptom: a localMonth entry
12
+ * document carried 9 rows where the equivalent credit-ledger month document
13
+ * carried the whole month (20).
14
+ *
15
+ * The merge key is (order_id, entry_key), which is globally unique per row, so
16
+ * re-closing the same day replaces its own rows instead of duplicating them.
17
+ */
18
+ const row = (over = {}) => ({
19
+ kind: 'DISCOUNT',
20
+ slot: 'ORDER_SPECIAL',
21
+ sub_kind: 'MANUAL',
22
+ level: 'ORDER',
23
+ entry_key: 'order:special',
24
+ order_id: 'order-1',
25
+ amount: 500,
26
+ rate: 10,
27
+ is_percentage: true,
28
+ discount_id: 'd1',
29
+ name: 'Staff 10%',
30
+ staff_id: null,
31
+ staff_name: null,
32
+ order_taker_id: null,
33
+ order_taker_name: null,
34
+ order_status: 'COMPLETED',
35
+ platform: 'POS_WALK-IN',
36
+ created_at: new Date('2026-09-13T10:00:00.000Z'),
37
+ local_hour: '2026-09-13 15',
38
+ ...over,
39
+ });
40
+ const section = (...rows) => ({ rows });
41
+ const KEY = 'COMPLETED:POS_WALK-IN';
42
+ const entriesDoc = (over = {}) => ({
43
+ _id: 'e1',
44
+ tenant_id: 'tenant-a',
45
+ brand_id: 'brand-a',
46
+ scope_context: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_MONTH,
47
+ scope_field: '2026-09',
48
+ day_index: null,
49
+ sale_type_key_filters: ['ORDER_STATUS', 'PLATFORM'],
50
+ discount_entries: { [KEY]: section(row()) },
51
+ iteration: 1,
52
+ schema_version: 1,
53
+ source_watermark: new Date('2026-09-13T23:00:00.000Z'),
54
+ computed_at: new Date('2026-09-13T23:00:00.000Z'),
55
+ createdAt: new Date('2026-09-13T23:00:00.000Z'),
56
+ updatedAt: new Date('2026-09-13T23:00:00.000Z'),
57
+ ...over,
58
+ });
59
+ describe('mergeMaterializedDiscountEntrySections', () => {
60
+ it('ADDS a new day of rows to the stored period rows', () => {
61
+ const stored = { [KEY]: section(row({ order_id: 'day1', entry_key: 'order:special' })) };
62
+ const fresh = { [KEY]: section(row({ order_id: 'day2', entry_key: 'order:special' })) };
63
+ const merged = (0, materialized_discount_close_day_helpers_1.mergeMaterializedDiscountEntrySections)(stored, fresh);
64
+ expect(merged[KEY].rows).toHaveLength(2);
65
+ expect(merged[KEY].rows.map((r) => r.order_id).sort()).toEqual(['day1', 'day2']);
66
+ });
67
+ it('is IDEMPOTENT: re-merging the same day replaces, never duplicates', () => {
68
+ const day = { [KEY]: section(row({ amount: 500 })) };
69
+ const once = (0, materialized_discount_close_day_helpers_1.mergeMaterializedDiscountEntrySections)({}, day);
70
+ const twice = (0, materialized_discount_close_day_helpers_1.mergeMaterializedDiscountEntrySections)(once, day);
71
+ const thrice = (0, materialized_discount_close_day_helpers_1.mergeMaterializedDiscountEntrySections)(twice, day);
72
+ expect(twice[KEY].rows).toHaveLength(1);
73
+ expect(thrice[KEY].rows).toHaveLength(1);
74
+ });
75
+ it('lets the FRESH row win on the same (order_id, entry_key)', () => {
76
+ const stored = { [KEY]: section(row({ amount: 111 })) };
77
+ const fresh = { [KEY]: section(row({ amount: 999 })) };
78
+ const merged = (0, materialized_discount_close_day_helpers_1.mergeMaterializedDiscountEntrySections)(stored, fresh);
79
+ expect(merged[KEY].rows).toHaveLength(1);
80
+ expect(merged[KEY].rows[0].amount).toBe(999);
81
+ });
82
+ it('keeps DIFFERENT keys apart', () => {
83
+ const stored = { 'A:POS': section(row()) };
84
+ const fresh = { 'B:WEB': section(row({ order_id: 'order-2' })) };
85
+ const merged = (0, materialized_discount_close_day_helpers_1.mergeMaterializedDiscountEntrySections)(stored, fresh);
86
+ expect(Object.keys(merged).sort()).toEqual(['A:POS', 'B:WEB']);
87
+ });
88
+ it('drops a key whose stored rows are all superseded and none remain', () => {
89
+ const merged = (0, materialized_discount_close_day_helpers_1.mergeMaterializedDiscountEntrySections)({}, {});
90
+ expect(merged).toEqual({});
91
+ });
92
+ });
93
+ describe('updateMaterializedDiscountEntries — period vs day semantics', () => {
94
+ it('REPLACES for a DAY scope (the day is the whole truth)', () => {
95
+ const existing = entriesDoc({
96
+ scope_context: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
97
+ scope_field: '2026-09-13',
98
+ });
99
+ const compiled = entriesDoc({
100
+ scope_context: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
101
+ scope_field: '2026-09-13',
102
+ discount_entries: { [KEY]: section(row({ order_id: 'fresh' })) },
103
+ });
104
+ const updated = (0, materialized_discount_close_day_helpers_1.updateMaterializedDiscountEntries)(existing, compiled, {
105
+ mergePeriodRows: false,
106
+ });
107
+ expect(updated.discount_entries[KEY].rows.map((r) => r.order_id)).toEqual(['fresh']);
108
+ });
109
+ it('MERGES for a PERIOD scope (the month keeps every day)', () => {
110
+ const existing = entriesDoc();
111
+ const compiled = entriesDoc({
112
+ discount_entries: { [KEY]: section(row({ order_id: 'day2' })) },
113
+ });
114
+ const updated = (0, materialized_discount_close_day_helpers_1.updateMaterializedDiscountEntries)(existing, compiled, {
115
+ mergePeriodRows: true,
116
+ });
117
+ expect(updated.discount_entries[KEY].rows.map((r) => r.order_id).sort()).toEqual(['day2', 'order-1']);
118
+ expect(updated.iteration).toBe(2);
119
+ });
120
+ it('still REFUSES documents that disagree on scope (data issue)', () => {
121
+ const existing = entriesDoc();
122
+ const compiled = entriesDoc({ scope_field: '2026-10' });
123
+ expect((0, materialized_discount_close_day_helpers_1.updateMaterializedDiscountEntries)(existing, compiled, { mergePeriodRows: true })).toBeNull();
124
+ });
125
+ });
@@ -0,0 +1,146 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const materialized_hourly_comparison_compile_helpers_1 = require("../../helpers/materialized-reports/materialized-hourly-comparison-compile-helpers");
4
+ const materialized_sales_comparison_accumulator_helpers_1 = require("../../helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers");
5
+ /**
6
+ * Hourly Comparison — the day compile.
7
+ *
8
+ * Two invariants:
9
+ * 1. the anchor is the SETTLED day AND hour (never the punch day/hour);
10
+ * 2. every settled order lands in exactly ONE hour bucket, and the bucket
11
+ * counters use the same eleven-counter contract as Sales Comparison.
12
+ */
13
+ const TENANT = 'tenant-1';
14
+ const BRAND = 'brand-1';
15
+ const DAY = '2026-09-14';
16
+ const OFFSET = 5;
17
+ const order = (id, over = {}) => ({
18
+ _id: id,
19
+ tenant_id: TENANT,
20
+ platform: 'POS_DINE-IN',
21
+ order_status: 'COMPLETED',
22
+ order_number: 100,
23
+ price: 1000,
24
+ total_discount_applied: 0,
25
+ gst_amount: 0,
26
+ tax_amount: 0,
27
+ tip_amount: 0,
28
+ amount_earned: 1000,
29
+ order_settled_at: new Date('2026-09-14T13:00:00.000Z'), // 18:00 at +05
30
+ createdAt: new Date('2026-09-14T12:00:00.000Z'),
31
+ updatedAt: new Date('2026-09-14T13:00:00.000Z'),
32
+ localDate: DAY,
33
+ categories: [{ category_id: 'c', items: [{ _id: 'i', quantity: 1, subtotal: 1000, _gross_amount: 1000 }] }],
34
+ payments: [],
35
+ ...over,
36
+ });
37
+ const compile = (over = {}) => (0, materialized_hourly_comparison_compile_helpers_1.compileTenantHourlyComparisonReports)({
38
+ tenantId: TENANT,
39
+ brandId: BRAND,
40
+ localDate: DAY,
41
+ orders: [],
42
+ gmtOffset: OFFSET,
43
+ computedAt: new Date('2026-09-14T23:00:00.000Z'),
44
+ ...over,
45
+ });
46
+ describe('hourly comparison day compile', () => {
47
+ it('writes one document per ACTIVE settled hour', () => {
48
+ const compiled = compile({
49
+ orders: [
50
+ order('a'),
51
+ order('b', { order_settled_at: new Date('2026-09-14T13:30:00.000Z') }), // 18:30
52
+ order('c', { order_settled_at: new Date('2026-09-14T14:05:00.000Z') }), // 19:05
53
+ ],
54
+ });
55
+ expect(compiled.reports.map((doc) => doc.scope_field)).toEqual(['2026-09-14 18', '2026-09-14 19']);
56
+ expect(compiled.reports.every((doc) => doc.scope_context === 'localHour')).toBe(true);
57
+ expect(compiled.reports[0].sales_counters['COMPLETED:POS_DINE-IN'].order_count).toBe(2);
58
+ expect(compiled.reports[1].sales_counters['COMPLETED:POS_DINE-IN'].order_count).toBe(1);
59
+ // The profile sums back to the day.
60
+ const total = compiled.reports.reduce((sum, doc) => sum + (doc.sales_counters['COMPLETED:POS_DINE-IN'].order_count ?? 0), 0);
61
+ expect(total).toBe(3);
62
+ });
63
+ it('anchors on the SETTLED hour, never the punch hour', () => {
64
+ // Punched 18:00 local, settled 2026-09-14 20:30Z = 2026-09-15 01:30 +05.
65
+ const late = order('late', {
66
+ localDate: '2026-09-14',
67
+ order_settled_at: new Date('2026-09-14T20:30:00.000Z'),
68
+ });
69
+ expect((0, materialized_sales_comparison_accumulator_helpers_1.getSalesComparisonSettledLocalDate)(late, OFFSET)).toBe('2026-09-15');
70
+ expect((0, materialized_hourly_comparison_compile_helpers_1.getHourlyComparisonSettledLocalHour)(late, OFFSET)).toBe(1);
71
+ const onPunchDay = compile({ orders: [late] });
72
+ expect(onPunchDay.reports).toHaveLength(0);
73
+ expect(onPunchDay.skippedForeignOrders).toBe(1);
74
+ const onSettledDay = compile({ localDate: '2026-09-15', orders: [late] });
75
+ expect(onSettledDay.reports[0].scope_field).toBe('2026-09-15 01');
76
+ });
77
+ it('partitions the counters per hour and per key', () => {
78
+ const compiled = compile({
79
+ orders: [
80
+ order('a', { price: 1000, total_discount_applied: 100 }),
81
+ order('b', {
82
+ order_settled_at: new Date('2026-09-14T14:00:00.000Z'),
83
+ price: 4000,
84
+ order_status: 'CANCELLED',
85
+ platform: 'POS_TAKE-AWAY',
86
+ amount_earned: 4000,
87
+ }),
88
+ ],
89
+ });
90
+ const hour18 = compiled.reports.find((doc) => doc.scope_field.endsWith('18'));
91
+ const hour19 = compiled.reports.find((doc) => doc.scope_field.endsWith('19'));
92
+ expect(hour18.sales_counters['COMPLETED:POS_DINE-IN'].net_amount).toBe(900);
93
+ expect(hour19.sales_counters['CANCELLED:POS_TAKE-AWAY'].void_amount).toBe(4000);
94
+ });
95
+ it('writes map and read-path rows with identical content', () => {
96
+ const compiled = compile({ orders: [order('a'), order('b')] });
97
+ for (const doc of compiled.reports) {
98
+ const map = doc.sales_counters;
99
+ const rows = doc.sales_counter_rows;
100
+ expect(rows.map((row) => row.key)).toEqual(Object.keys(map));
101
+ for (const row of rows)
102
+ expect(row.counters).toEqual(map[row.key]);
103
+ }
104
+ });
105
+ it('writes one drill-down row per order in its hour, newest-first', () => {
106
+ const compiled = compile({
107
+ orders: [
108
+ order('older', { order_settled_at: new Date('2026-09-14T13:05:00.000Z') }),
109
+ order('newer', { order_settled_at: new Date('2026-09-14T13:55:00.000Z') }),
110
+ ],
111
+ });
112
+ const rows = compiled.entries[0].sales_entries['COMPLETED:POS_DINE-IN'].rows;
113
+ expect(rows.map((row) => row.order_id)).toEqual(['newer', 'older']);
114
+ });
115
+ it('skips unsettled, deleted, foreign and unkeyable orders', () => {
116
+ const compiled = compile({
117
+ orders: [
118
+ order('ok'),
119
+ order('unsettled', { order_settled_at: null }),
120
+ order('deleted', { is_deleted: true }),
121
+ order('foreign', { tenant_id: 'other' }),
122
+ order('bad', { order_status: null }),
123
+ ],
124
+ });
125
+ expect(compiled.contributingOrders).toBe(1);
126
+ expect(compiled.skippedUnsettledOrders).toBe(1);
127
+ expect(compiled.skippedUnkeyableOrders).toBe(1);
128
+ });
129
+ it('returns EMPTY arrays for an order-less day', () => {
130
+ const compiled = compile();
131
+ expect(compiled.reports).toEqual([]);
132
+ expect(compiled.entries).toEqual([]);
133
+ });
134
+ it('returns null on malformed input', () => {
135
+ expect((0, materialized_hourly_comparison_compile_helpers_1.compileTenantHourlyComparisonReports)(null)).toBeNull();
136
+ expect(compile({ tenantId: '' })).toBeNull();
137
+ expect(compile({ brandId: '' })).toBeNull();
138
+ expect(compile({ localDate: 'not-a-date' })).toBeNull();
139
+ expect(compile({ orders: null })).toBeNull();
140
+ });
141
+ it('builds the hour label from the day + hour', () => {
142
+ expect((0, materialized_hourly_comparison_compile_helpers_1.getHourlyComparisonScopeField)('2026-09-14', 6)).toBe('2026-09-14 06');
143
+ expect((0, materialized_hourly_comparison_compile_helpers_1.getHourlyComparisonScopeField)('2026-09-14', 0)).toBe('2026-09-14 00');
144
+ expect((0, materialized_hourly_comparison_compile_helpers_1.getHourlyComparisonScopeField)('not-a-date', 6)).toBeNull();
145
+ });
146
+ });
@@ -0,0 +1,127 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const tenant_hourly_comparison_formatter_1 = require("../../helpers/materialized-reports/tenant-hourly-comparison-formatter");
4
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
5
+ /**
6
+ * Hourly Comparison formatter.
7
+ *
8
+ * The profile is always 24 entries in BUSINESS-HOUR order (06…23, 00…05), with
9
+ * current / comparison / delta per hour and the range totals. Cancelled revenue
10
+ * is split out; filters and the metric switch stay client-side.
11
+ */
12
+ const counters = (over = {}) => ({
13
+ order_count: 0,
14
+ gross_amount: 0,
15
+ discount_amount: 0,
16
+ net_amount: 0,
17
+ tax_amount: 0,
18
+ service_charge_amount: 0,
19
+ tip_amount: 0,
20
+ refund_amount: 0,
21
+ void_amount: 0,
22
+ item_count: 0,
23
+ guest_count: 0,
24
+ ...over,
25
+ });
26
+ const record = (hourCounters, tenantId = 'tenant-1') => ({
27
+ tenant_id: tenantId,
28
+ brand_id: 'brand-1',
29
+ matched_documents: 24,
30
+ max_iteration: 1,
31
+ max_updated_at: new Date('2026-09-30T23:00:00.000Z'),
32
+ sale_type_key_filters: ['ORDER_STATUS', 'PLATFORM'],
33
+ hour_counters: hourCounters,
34
+ first_scope_field: null,
35
+ last_scope_field: null,
36
+ });
37
+ const current = record({
38
+ '18': {
39
+ 'COMPLETED:POS_DINE-IN': counters({ order_count: 2, net_amount: 9000, gross_amount: 10000, item_count: 4 }),
40
+ 'CANCELLED:POS_TAKE-AWAY': counters({ order_count: 1, net_amount: 1000, void_amount: 1000 }),
41
+ },
42
+ '23': { 'COMPLETED:POS_DINE-IN': counters({ order_count: 1, net_amount: 3000 }) },
43
+ '0': { 'COMPLETED:POS_TAKE-AWAY': counters({ order_count: 1, net_amount: 2000 }) },
44
+ });
45
+ const comparison = record({
46
+ '18': { 'COMPLETED:POS_DINE-IN': counters({ order_count: 1, net_amount: 5000 }) },
47
+ '0': { 'COMPLETED:POS_TAKE-AWAY': counters({ order_count: 2, net_amount: 3000 }) },
48
+ });
49
+ const format = (filters = null, split = false) => (0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([current], [comparison], filters, split);
50
+ describe('hourly comparison formatter', () => {
51
+ it('emits 24 hours in BUSINESS-HOUR order 06…23, 00…05', () => {
52
+ const page = format()[0][0];
53
+ expect(page.hours).toHaveLength(24);
54
+ expect(page.hours.map((entry) => entry.hour)).toEqual([
55
+ 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 0, 1, 2, 3, 4, 5,
56
+ ]);
57
+ expect(page.hours[0].business_index).toBe(0);
58
+ expect(page.hours[18].hour).toBe(0);
59
+ expect(page.hours[17].hour).toBe(23);
60
+ });
61
+ it('labels an hour end-exclusively and wraps at midnight', () => {
62
+ expect((0, tenant_hourly_comparison_formatter_1.getHourlyComparisonHourLabel)(18)).toBe('18:00–19:00');
63
+ expect((0, tenant_hourly_comparison_formatter_1.getHourlyComparisonHourLabel)(23)).toBe('23:00–00:00');
64
+ expect((0, tenant_hourly_comparison_formatter_1.getHourlyComparisonHourLabel)(0)).toBe('00:00–01:00');
65
+ expect((0, tenant_hourly_comparison_formatter_1.getHourlyComparisonBusinessIndex)(6)).toBe(0);
66
+ expect((0, tenant_hourly_comparison_formatter_1.getHourlyComparisonBusinessIndex)(0)).toBe(18);
67
+ expect((0, tenant_hourly_comparison_formatter_1.getHourlyComparisonBusinessIndex)(5)).toBe(23);
68
+ });
69
+ it('subtracts the baseline per hour and derives the average ticket', () => {
70
+ const page = format()[0][0];
71
+ const hour18 = page.hours.find((entry) => entry.hour === 18);
72
+ expect(hour18.current.counters.net_amount).toBe(90);
73
+ expect(hour18.comparison.counters.net_amount).toBe(50);
74
+ expect(hour18.metrics[MATERIALIZED_REPORTS_1.SALES_COMPARISON_METRIC_ENUM.NET_SALES]).toEqual({
75
+ current: 90,
76
+ comparison: 50,
77
+ delta: 40,
78
+ delta_percent: 80,
79
+ });
80
+ expect(hour18.current.average_ticket).toBe(45); // 9000 / 2 cents -> 45.00
81
+ expect(hour18.comparison.average_ticket).toBe(50);
82
+ });
83
+ it('totals the profile and splits cancelled revenue out', () => {
84
+ const page = format()[0][0];
85
+ // 9000 + 3000 + 2000 cents = 140.00; the cancelled order is NOT included.
86
+ expect(page.current.counters.net_amount).toBe(140);
87
+ expect(page.current.counters.order_count).toBe(4);
88
+ expect(page.cancelled.counters.order_count).toBe(1);
89
+ expect(page.cancelled.counters.void_amount).toBe(10);
90
+ expect(page.hours_with_data).toBe(3);
91
+ expect(page.metrics[MATERIALIZED_REPORTS_1.SALES_COMPARISON_METRIC_ENUM.NET_SALES].current).toBe(140);
92
+ expect(page.metrics[MATERIALIZED_REPORTS_1.SALES_COMPARISON_METRIC_ENUM.NET_SALES].comparison).toBe(80);
93
+ });
94
+ it('filters platforms and statuses client-side', () => {
95
+ const page = format({ platforms: ['POS_TAKE-AWAY'] })[0][0];
96
+ expect(page.current.counters.net_amount).toBe(20); // only hour 0
97
+ expect(page.hours.find((entry) => entry.hour === 18).current.counters.order_count).toBe(0);
98
+ expect(page.hours.find((entry) => entry.hour === 0).current.counters.order_count).toBe(1);
99
+ const cancelledOnly = format({ order_statuses: ['CANCELLED'] })[0][0];
100
+ expect(cancelledOnly.current.counters.order_count).toBe(1);
101
+ expect(cancelledOnly.current.counters.void_amount).toBe(10);
102
+ });
103
+ it('distinguishes no baseline (null) from a zero baseline ([])', () => {
104
+ const none = (0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([current], null, null, false)[0][0];
105
+ expect(none.comparison).toBeNull();
106
+ expect(none.hours.every((entry) => entry.comparison === null)).toBe(true);
107
+ const empty = (0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([current], [], null, false)[0][0];
108
+ expect(empty.comparison).not.toBeNull();
109
+ expect(empty.comparison.counters.net_amount).toBe(0);
110
+ expect(empty.hours[0].comparison.counters.net_amount).toBe(0);
111
+ });
112
+ it('folds multiple tenants into one profile, or splits on request', () => {
113
+ const other = record({ '18': { 'COMPLETED:POS_KIOSK': counters({ order_count: 1, net_amount: 1000 }) } }, 'tenant-2');
114
+ const combined = (0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([current, other], null, null, false)[0];
115
+ expect(combined).toHaveLength(1);
116
+ expect(combined[0].tenant_ids).toEqual(['tenant-1', 'tenant-2']);
117
+ expect(combined[0].hours.find((entry) => entry.hour === 18).current.counters.net_amount).toBe(100);
118
+ const split = (0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([current, other], null, null, true)[0];
119
+ expect(split).toHaveLength(2);
120
+ });
121
+ it('returns null on invalid input', () => {
122
+ expect((0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([], null)).toBeNull();
123
+ expect((0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)(null, null)).toBeNull();
124
+ expect((0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([current], null, { platforms: 'X' })).toBeNull();
125
+ expect((0, tenant_hourly_comparison_formatter_1.getFormattedTenantHourlyComparisonReporting)([record({})], null, null, false)).not.toBeNull();
126
+ });
127
+ });
@@ -0,0 +1,138 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const materialized_hourly_comparison_close_day_helpers_1 = require("../../helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers");
4
+ const materialized_hourly_comparison_compile_helpers_1 = require("../../helpers/materialized-reports/materialized-hourly-comparison-compile-helpers");
5
+ /**
6
+ * Hourly Comparison close-day plan.
7
+ *
8
+ * It writes/retires HOUR documents only. An unchanged replay must write nothing,
9
+ * an emptied day must retire every stored hour, and a correction that removes an
10
+ * order must be written even when the watermark did not advance.
11
+ */
12
+ const TENANT = 'tenant-1';
13
+ const BRAND = 'brand-1';
14
+ const DAY = '2026-09-14';
15
+ const order = (id, over = {}) => ({
16
+ _id: id,
17
+ tenant_id: TENANT,
18
+ platform: 'POS_DINE-IN',
19
+ order_status: 'COMPLETED',
20
+ order_number: 100,
21
+ price: 1000,
22
+ total_discount_applied: 0,
23
+ amount_earned: 1000,
24
+ order_settled_at: new Date('2026-09-14T13:00:00.000Z'), // 18:00 at +05
25
+ createdAt: new Date('2026-09-14T12:00:00.000Z'),
26
+ updatedAt: new Date('2026-09-14T13:00:00.000Z'),
27
+ localDate: DAY,
28
+ categories: [{ category_id: 'c', items: [{ _id: 'i', quantity: 1, subtotal: 1000 }] }],
29
+ payments: [],
30
+ ...over,
31
+ });
32
+ const compileDay = (ids, stamp) => (0, materialized_hourly_comparison_compile_helpers_1.compileTenantHourlyComparisonReports)({
33
+ tenantId: TENANT,
34
+ brandId: BRAND,
35
+ localDate: DAY,
36
+ orders: ids.map((entry) => (typeof entry === 'string' ? order(entry) : order(String(entry._id), entry))),
37
+ gmtOffset: 5,
38
+ computedAt: new Date(stamp),
39
+ });
40
+ const emptyState = () => ({ reports: [], entries: [] });
41
+ const planFor = (compiled, state, computedAt, force = false) => (0, materialized_hourly_comparison_close_day_helpers_1.buildTenantHourlyComparisonCloseDayPlan)({
42
+ tenantId: TENANT,
43
+ localDate: DAY,
44
+ reports: compiled.reports,
45
+ entries: compiled.entries,
46
+ existing: state.reports,
47
+ existingEntries: state.entries,
48
+ reason: 'NEW_DAY',
49
+ computedAt: new Date(computedAt),
50
+ force,
51
+ });
52
+ const apply = (state, plan) => {
53
+ const reports = new Map(state.reports.map((doc) => [doc.scope_field, doc]));
54
+ const entries = new Map(state.entries.map((doc) => [doc.scope_field, doc]));
55
+ for (const write of plan.writes)
56
+ reports.set(write.report.scope_field, write.report);
57
+ for (const write of plan.entryWrites)
58
+ entries.set(write.report.scope_field, write.report);
59
+ for (const doc of plan.staleDocuments)
60
+ reports.delete(doc.scope_field);
61
+ for (const doc of plan.staleEntryDocuments)
62
+ entries.delete(doc.scope_field);
63
+ return { reports: [...reports.values()], entries: [...entries.values()] };
64
+ };
65
+ describe('hourly comparison close-day plan', () => {
66
+ it('writes the active hours and NO period documents', () => {
67
+ const compiled = compileDay(['a'], '2026-09-14T23:00:00.000Z');
68
+ const plan = planFor(compiled, emptyState(), '2026-09-14T23:00:00.000Z');
69
+ expect(plan.writes.map((write) => write.report.scope_field)).toEqual(['2026-09-14 18']);
70
+ expect(plan.entryWrites).toHaveLength(1);
71
+ expect(plan.writes.every((write) => write.report.scope_context === 'localHour')).toBe(true);
72
+ expect(plan.writes.every((write) => write.report.iteration === 1)).toBe(true);
73
+ });
74
+ it('does not write an unchanged replay', () => {
75
+ const first = planFor(compileDay(['a'], '2026-09-14T23:00:00.000Z'), emptyState(), '2026-09-14T23:00:00.000Z');
76
+ const state = apply(emptyState(), first);
77
+ const replay = planFor(compileDay(['a'], '2026-09-14T23:00:00.000Z'), state, '2026-09-14T23:05:00.000Z');
78
+ expect(replay.writes).toHaveLength(0);
79
+ expect(replay.entryWrites).toHaveLength(0);
80
+ });
81
+ it('corrects an hour whose order was removed, without force', () => {
82
+ const first = planFor(compileDay(['a', 'b'], '2026-09-14T23:00:00.000Z'), emptyState(), '2026-09-14T23:00:00.000Z');
83
+ const state = apply(emptyState(), first);
84
+ expect(state.reports[0].sales_counters['COMPLETED:POS_DINE-IN'].order_count).toBe(2);
85
+ const correction = planFor(compileDay(['a'], '2026-09-14T23:00:00.000Z'), state, '2026-09-14T23:30:00.000Z');
86
+ const corrected = apply(state, correction);
87
+ expect(corrected.reports[0].sales_counters['COMPLETED:POS_DINE-IN'].order_count).toBe(1);
88
+ });
89
+ it('retires every stored hour when the day is emptied', () => {
90
+ const first = planFor(compileDay([{ _id: 'a' }, { _id: 'b', order_settled_at: new Date('2026-09-14T14:00:00.000Z') }], '2026-09-14T23:00:00.000Z'), emptyState(), '2026-09-14T23:00:00.000Z');
91
+ const state = apply(emptyState(), first);
92
+ expect(state.reports).toHaveLength(2);
93
+ const emptied = planFor(compileDay([], '2026-09-14T23:30:00.000Z'), state, '2026-09-14T23:30:00.000Z');
94
+ const after = apply(state, emptied);
95
+ expect(emptied.staleDocuments).toHaveLength(2);
96
+ expect(emptied.staleEntryDocuments).toHaveLength(2);
97
+ expect(after.reports).toHaveLength(0);
98
+ expect(after.entries).toHaveLength(0);
99
+ });
100
+ it('leaves OTHER hours of the day alone', () => {
101
+ const first = planFor(compileDay([{ _id: 'a' }, { _id: 'b', order_settled_at: new Date('2026-09-14T14:00:00.000Z') }], '2026-09-14T23:00:00.000Z'), emptyState(), '2026-09-14T23:00:00.000Z');
102
+ const state = apply(emptyState(), first);
103
+ // The 19:00 hour's order is emptied; 18:00 stays.
104
+ const plan = planFor(compileDay([{ _id: 'a' }], '2026-09-14T23:00:00.000Z'), state, '2026-09-14T23:30:00.000Z');
105
+ expect(plan.staleDocuments.map((doc) => doc.scope_field)).toEqual(['2026-09-14 19']);
106
+ // 18:00 is unchanged, so it is SKIPPED rather than rewritten.
107
+ expect(plan.writes).toHaveLength(0);
108
+ expect(plan.skippedDocuments.map((doc) => doc.scope_field)).toEqual(['2026-09-14 18']);
109
+ });
110
+ it('lists exactly the 24 hour refs of a day', () => {
111
+ const refs = (0, materialized_hourly_comparison_close_day_helpers_1.getMaterializedHourlyComparisonScopeRefsForDay)(DAY);
112
+ expect(refs).toHaveLength(24);
113
+ expect(refs[0].scope_field).toBe('2026-09-14 00');
114
+ expect(refs[23].scope_field).toBe('2026-09-14 23');
115
+ expect((0, materialized_hourly_comparison_close_day_helpers_1.getMaterializedHourlyComparisonScopeRefsForDay)('bad')).toBeNull();
116
+ });
117
+ it('returns null on malformed input', () => {
118
+ expect((0, materialized_hourly_comparison_close_day_helpers_1.buildTenantHourlyComparisonCloseDayPlan)(null)).toBeNull();
119
+ expect((0, materialized_hourly_comparison_close_day_helpers_1.buildTenantHourlyComparisonCloseDayPlan)({
120
+ tenantId: '',
121
+ reports: [],
122
+ entries: [],
123
+ reason: 'NEW_DAY',
124
+ })).toBeNull();
125
+ expect((0, materialized_hourly_comparison_close_day_helpers_1.buildTenantHourlyComparisonCloseDayPlan)({
126
+ tenantId: TENANT,
127
+ reports: [],
128
+ entries: [],
129
+ reason: '',
130
+ })).toBeNull();
131
+ expect((0, materialized_hourly_comparison_close_day_helpers_1.buildTenantHourlyComparisonCloseDayPlan)({
132
+ tenantId: TENANT,
133
+ reports: [],
134
+ entries: [],
135
+ reason: 'NEW_DAY',
136
+ })).toBeNull();
137
+ });
138
+ });