@managesome/eposmatic-toolkit 0.4.9 → 0.4.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (333) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +448 -0
  2. package/esm/helpers/index.js +3 -0
  3. package/esm/helpers/materialized-reports/index.js +32 -0
  4. package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
  5. package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +286 -0
  6. package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
  7. package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +244 -0
  8. package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
  9. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +426 -0
  10. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +372 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +214 -0
  12. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +318 -0
  13. package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
  14. package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
  15. package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
  16. package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
  17. package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
  18. package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +111 -0
  19. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +88 -0
  20. package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
  21. package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
  22. package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
  23. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +476 -0
  24. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
  25. package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +7 -0
  26. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
  27. package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +157 -0
  28. package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
  29. package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
  30. package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +156 -0
  31. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
  32. package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
  33. package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +237 -0
  34. package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +279 -0
  35. package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
  36. package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +343 -0
  37. package/esm/helpers/reporting-contract/index.js +2 -0
  38. package/esm/helpers/reporting-contract/overview-contract.js +122 -0
  39. package/esm/helpers/reporting-contract/report-contract.js +228 -0
  40. package/esm/helpers/rider-earnings/index.js +1 -0
  41. package/esm/helpers/rider-earnings/rider-earnings.js +59 -0
  42. package/esm/helpers/rider-reports/index.js +2 -0
  43. package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
  44. package/esm/helpers/rider-reports/rider-report.js +67 -0
  45. package/esm/schemas/models/deliveries.js +75 -0
  46. package/esm/schemas/models/index.js +15 -0
  47. package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
  48. package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
  49. package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
  50. package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
  51. package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
  52. package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
  53. package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
  54. package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
  55. package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
  56. package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
  57. package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
  58. package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
  59. package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
  60. package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
  61. package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
  62. package/esm/schemas/types/index.js +15 -0
  63. package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
  64. package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
  65. package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
  66. package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
  67. package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
  68. package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
  69. package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
  70. package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
  71. package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
  72. package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
  73. package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
  74. package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
  75. package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
  76. package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
  77. package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
  78. package/lib/constants/MATERIALIZED_REPORTS.d.ts +339 -2
  79. package/lib/constants/MATERIALIZED_REPORTS.js +450 -1
  80. package/lib/helpers/index.d.ts +3 -0
  81. package/lib/helpers/index.js +3 -0
  82. package/lib/helpers/materialized-reports/index.d.ts +32 -0
  83. package/lib/helpers/materialized-reports/index.js +32 -0
  84. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
  85. package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
  86. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +90 -0
  87. package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +295 -0
  88. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +102 -0
  89. package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
  90. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +72 -0
  91. package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +251 -0
  92. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
  93. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
  94. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +84 -0
  95. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +438 -0
  96. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +97 -0
  97. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +385 -0
  98. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +40 -0
  99. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +218 -0
  100. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
  101. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +324 -0
  102. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
  103. package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
  104. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
  105. package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
  106. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
  107. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
  108. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
  109. package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
  110. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
  111. package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
  112. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
  113. package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +116 -0
  114. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
  115. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +98 -0
  116. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
  117. package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
  118. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
  119. package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
  120. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +66 -0
  121. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
  122. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +128 -0
  123. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +490 -0
  124. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +46 -0
  125. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
  126. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
  127. package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +8 -1
  128. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
  129. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
  130. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
  131. package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +161 -0
  132. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
  133. package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
  134. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
  135. package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
  136. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
  137. package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +159 -0
  138. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
  139. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
  140. package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
  141. package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
  142. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
  143. package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +243 -0
  144. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
  145. package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +286 -0
  146. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +97 -0
  147. package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
  148. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
  149. package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +349 -0
  150. package/lib/helpers/reporting-contract/index.d.ts +2 -0
  151. package/lib/helpers/reporting-contract/index.js +18 -0
  152. package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
  153. package/lib/helpers/reporting-contract/overview-contract.js +126 -0
  154. package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
  155. package/lib/helpers/reporting-contract/report-contract.js +239 -0
  156. package/lib/helpers/rider-earnings/index.d.ts +1 -0
  157. package/lib/helpers/rider-earnings/index.js +17 -0
  158. package/lib/helpers/rider-earnings/rider-earnings.d.ts +58 -0
  159. package/lib/helpers/rider-earnings/rider-earnings.js +64 -0
  160. package/lib/helpers/rider-reports/index.d.ts +2 -0
  161. package/lib/helpers/rider-reports/index.js +18 -0
  162. package/lib/helpers/rider-reports/rider-daily-report.d.ts +26 -0
  163. package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
  164. package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
  165. package/lib/helpers/rider-reports/rider-report.js +70 -0
  166. package/lib/helpers/types/materialized-reports-apis.d.ts +297 -1
  167. package/lib/schemas/models/deliveries.d.ts +54 -0
  168. package/lib/schemas/models/deliveries.js +75 -0
  169. package/lib/schemas/models/expense_details.d.ts +3 -3
  170. package/lib/schemas/models/index.d.ts +15 -0
  171. package/lib/schemas/models/index.js +15 -0
  172. package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
  173. package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
  174. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
  175. package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
  176. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
  177. package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
  178. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
  179. package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
  180. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
  181. package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
  182. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
  183. package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
  184. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
  185. package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
  186. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
  187. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
  188. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
  189. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
  190. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
  191. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
  192. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
  193. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
  194. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
  195. package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
  196. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
  197. package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
  198. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
  199. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
  200. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
  201. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
  202. package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
  203. package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
  204. package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
  205. package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
  206. package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
  207. package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
  208. package/lib/schemas/types/deliveries.d.ts +40 -1
  209. package/lib/schemas/types/index.d.ts +15 -0
  210. package/lib/schemas/types/index.js +15 -0
  211. package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
  212. package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
  213. package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
  214. package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
  215. package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
  216. package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
  217. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
  218. package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
  219. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
  220. package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
  221. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
  222. package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
  223. package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
  224. package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
  225. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
  226. package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
  227. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
  228. package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
  229. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
  230. package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
  231. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
  232. package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
  233. package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
  234. package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
  235. package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
  236. package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
  237. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
  238. package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
  239. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
  240. package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
  241. package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
  242. package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
  243. package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
  244. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  245. package/lib/tests/materialized-reports/fixtures.js +1 -0
  246. package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
  247. package/lib/tests/materialized-reports/materialized-cash-compile.test.js +196 -0
  248. package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
  249. package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
  250. package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
  251. package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +152 -0
  252. package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
  253. package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
  254. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
  255. package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
  256. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
  257. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
  258. package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
  259. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +241 -0
  260. package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
  261. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
  262. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
  263. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +141 -0
  264. package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
  265. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
  266. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
  267. package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
  268. package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
  269. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
  270. package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
  271. package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
  272. package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
  273. package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
  274. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
  275. package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
  276. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
  277. package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
  278. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
  279. package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
  280. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
  281. package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
  282. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
  283. package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
  284. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
  285. package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
  286. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
  287. package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
  288. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
  289. package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
  290. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
  291. package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
  292. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
  293. package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
  294. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
  295. package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +270 -0
  296. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
  297. package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
  298. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
  299. package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
  300. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
  301. package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
  302. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
  303. package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
  304. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
  305. package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +206 -0
  306. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
  307. package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
  308. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
  309. package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
  310. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
  311. package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
  312. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
  313. package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
  314. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
  315. package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
  316. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
  317. package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
  318. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
  319. package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
  320. package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
  321. package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
  322. package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
  323. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
  324. package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
  325. package/lib/tests/reporting-contract.test.d.ts +1 -0
  326. package/lib/tests/reporting-contract.test.js +267 -0
  327. package/lib/tests/rider-daily-report.test.d.ts +1 -0
  328. package/lib/tests/rider-daily-report.test.js +86 -0
  329. package/lib/tests/rider-earnings.test.d.ts +1 -0
  330. package/lib/tests/rider-earnings.test.js +65 -0
  331. package/lib/tests/rider-report.test.d.ts +1 -0
  332. package/lib/tests/rider-report.test.js +98 -0
  333. package/package.json +10 -1
@@ -0,0 +1,407 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.getMaterializedPaymentsComparisonPeriodDayKeys = exports.getMaterializedPaymentsComparisonScopeRefsForDay = exports.isMaterializedPaymentsComparisonDayScope = exports.MATERIALIZED_PAYMENTS_COMPARISON_PERIOD_SCOPES = void 0;
7
+ exports.needsMaterializedPaymentsComparisonReportWrite = needsMaterializedPaymentsComparisonReportWrite;
8
+ exports.needsMaterializedPaymentsComparisonEntriesWrite = needsMaterializedPaymentsComparisonEntriesWrite;
9
+ exports.foldMaterializedPaymentsComparisonPeriodCounters = foldMaterializedPaymentsComparisonPeriodCounters;
10
+ exports.mergeMaterializedPaymentsComparisonEntrySections = mergeMaterializedPaymentsComparisonEntrySections;
11
+ exports.foldMaterializedPaymentsComparisonPeriodEntries = foldMaterializedPaymentsComparisonPeriodEntries;
12
+ exports.buildTenantPaymentsComparisonCloseDayPlan = buildTenantPaymentsComparisonCloseDayPlan;
13
+ const mongoose_1 = __importDefault(require("mongoose"));
14
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
15
+ const materialized_tenant_reports_iterations_helpers_1 = require("./materialized-tenant-reports-iterations-helpers");
16
+ const scope_helpers_1 = require("./scope-helpers");
17
+ const materialized_payments_comparison_accumulator_helpers_1 = require("./materialized-payments-comparison-accumulator-helpers");
18
+ const materialized_sales_comparison_close_day_helpers_1 = require("./materialized-sales-comparison-close-day-helpers");
19
+ /**
20
+ * Payments Comparison close-day helpers.
21
+ *
22
+ * Mirrors Sales Comparison: the compile produces only the `localDate` pair, and
23
+ * every touched period is RE-FOLDED from its whole day set (never accumulated).
24
+ * Payment rows are de-duplicated by `(order_id, payment_id)` so a split bill is
25
+ * two rows but the same payment is never counted twice.
26
+ *
27
+ * The fetch contract is explicit (`getMaterializedPaymentsComparisonPeriodDayKeys`).
28
+ * The guard compares content when watermarks are equal, so a correction that
29
+ * removes a payment is written. Helpers never throw — invalid input returns null.
30
+ */
31
+ exports.MATERIALIZED_PAYMENTS_COMPARISON_PERIOD_SCOPES = MATERIALIZED_REPORTS_1.MATERIALIZED_PAYMENTS_COMPARISON_REPORT_SCOPES.filter((scope) => scope !== MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE);
32
+ const isMaterializedPaymentsComparisonDayScope = (scopeContext) => String(scopeContext) === MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE;
33
+ exports.isMaterializedPaymentsComparisonDayScope = isMaterializedPaymentsComparisonDayScope;
34
+ exports.getMaterializedPaymentsComparisonScopeRefsForDay = materialized_sales_comparison_close_day_helpers_1.getMaterializedSalesComparisonScopeRefsForDay;
35
+ exports.getMaterializedPaymentsComparisonPeriodDayKeys = materialized_sales_comparison_close_day_helpers_1.getMaterializedSalesComparisonPeriodDayKeys;
36
+ const scopeKey = (doc) => String(doc.scope_context) + '|' + String(doc.scope_field);
37
+ /** Highest `source_watermark` across the day documents a fold used. */
38
+ function watermarkOfFoldedDays(dayDocuments, fallback) {
39
+ let latest = fallback.getTime();
40
+ for (const doc of dayDocuments ?? []) {
41
+ const time = new Date(doc?.source_watermark ?? 0).getTime();
42
+ if (!Number.isNaN(time) && time > latest)
43
+ latest = time;
44
+ }
45
+ return new Date(latest);
46
+ }
47
+ /** Canonical JSON (sorted object keys) for content comparison. */
48
+ function stableJson(value) {
49
+ const canonicalize = (input) => {
50
+ if (Array.isArray(input))
51
+ return input.map(canonicalize);
52
+ if (input != null && typeof input === 'object') {
53
+ const out = {};
54
+ for (const key of Object.keys(input).sort()) {
55
+ out[key] = canonicalize(input[key]);
56
+ }
57
+ return out;
58
+ }
59
+ return input;
60
+ };
61
+ return JSON.stringify(canonicalize(value ?? null));
62
+ }
63
+ function needsMaterializedPaymentsComparisonReportWrite(existing, incoming, force = false) {
64
+ if (existing == null || incoming == null)
65
+ return true;
66
+ if (force)
67
+ return true;
68
+ if (Number(existing.schema_version) !== Number(incoming.schema_version) ||
69
+ Number.isNaN(Number(incoming.schema_version))) {
70
+ return true;
71
+ }
72
+ if ((existing.sale_type_key_filters ?? []).join(':') !== (incoming.sale_type_key_filters ?? []).join(':')) {
73
+ return true;
74
+ }
75
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
76
+ const next = new Date(incoming.source_watermark ?? 0).getTime();
77
+ if (Number.isNaN(stored) || Number.isNaN(next))
78
+ return true;
79
+ if (next > stored)
80
+ return true;
81
+ if (next < stored)
82
+ return false;
83
+ return stableJson(existing.payment_counters) !== stableJson(incoming.payment_counters);
84
+ }
85
+ function needsMaterializedPaymentsComparisonEntriesWrite(existing, incoming, force = false) {
86
+ if (existing == null || incoming == null)
87
+ return true;
88
+ if (force)
89
+ return true;
90
+ if (Number(existing.schema_version) !== Number(incoming.schema_version) ||
91
+ Number.isNaN(Number(incoming.schema_version))) {
92
+ return true;
93
+ }
94
+ if ((existing.sale_type_key_filters ?? []).join(':') !== (incoming.sale_type_key_filters ?? []).join(':')) {
95
+ return true;
96
+ }
97
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
98
+ const next = new Date(incoming.source_watermark ?? 0).getTime();
99
+ if (Number.isNaN(stored) || Number.isNaN(next))
100
+ return true;
101
+ if (next > stored)
102
+ return true;
103
+ if (next < stored)
104
+ return false;
105
+ return stableJson(existing.payment_entries) !== stableJson(incoming.payment_entries);
106
+ }
107
+ /** Folds the counters of every DAY document in one period. */
108
+ function foldMaterializedPaymentsComparisonPeriodCounters(input) {
109
+ const folded = {};
110
+ for (const dayDocument of input?.dayDocuments ?? []) {
111
+ if (!(0, exports.isMaterializedPaymentsComparisonDayScope)(String(dayDocument?.scope_context)))
112
+ continue;
113
+ const fields = (0, scope_helpers_1.getMaterializedPeriodScopeFields)(String(dayDocument.scope_field));
114
+ if (fields == null)
115
+ continue;
116
+ if (fields[String(input.periodScope)] !== input.periodScopeField)
117
+ continue;
118
+ for (const [key, block] of Object.entries(dayDocument.payment_counters ?? {})) {
119
+ const target = folded[key] ?? (0, materialized_payments_comparison_accumulator_helpers_1.createEmptyPaymentsComparisonCounters)();
120
+ (0, materialized_payments_comparison_accumulator_helpers_1.addPaymentsComparisonCounters)(target, block);
121
+ folded[key] = target;
122
+ }
123
+ }
124
+ return folded;
125
+ }
126
+ const entryIdentity = (row) => String(row.order_id ?? '') + '|' + String(row.payment_id ?? '');
127
+ const compareRowsDescending = (a, b) => {
128
+ const byTime = new Date(b.time).getTime() - new Date(a.time).getTime();
129
+ if (byTime !== 0)
130
+ return byTime;
131
+ if (a.order_id !== b.order_id)
132
+ return a.order_id < b.order_id ? -1 : 1;
133
+ return a.payment_id < b.payment_id ? -1 : a.payment_id > b.payment_id ? 1 : 0;
134
+ };
135
+ function mergeMaterializedPaymentsComparisonEntrySections(target, source) {
136
+ const rowsByKey = new Map();
137
+ const seenByKey = new Map();
138
+ const absorb = (input) => {
139
+ if (input == null)
140
+ return;
141
+ for (const [key, section] of Object.entries(input)) {
142
+ const rows = rowsByKey.get(key) ?? [];
143
+ const seen = seenByKey.get(key) ?? new Set();
144
+ for (const row of section?.rows ?? []) {
145
+ const identity = entryIdentity(row);
146
+ if (identity !== '|' && seen.has(identity))
147
+ continue;
148
+ seen.add(identity);
149
+ rows.push(row);
150
+ }
151
+ rowsByKey.set(key, rows);
152
+ seenByKey.set(key, seen);
153
+ }
154
+ };
155
+ absorb(target);
156
+ absorb(source);
157
+ const out = {};
158
+ for (const [key, rows] of rowsByKey) {
159
+ rows.sort(compareRowsDescending);
160
+ out[key] = { rows };
161
+ }
162
+ return out;
163
+ }
164
+ function foldMaterializedPaymentsComparisonPeriodEntries(input) {
165
+ let merged = {};
166
+ for (const dayDocument of input?.dayDocuments ?? []) {
167
+ if (!(0, exports.isMaterializedPaymentsComparisonDayScope)(String(dayDocument?.scope_context)))
168
+ continue;
169
+ const fields = (0, scope_helpers_1.getMaterializedPeriodScopeFields)(String(dayDocument.scope_field));
170
+ if (fields == null)
171
+ continue;
172
+ if (fields[String(input.periodScope)] !== input.periodScopeField)
173
+ continue;
174
+ merged = mergeMaterializedPaymentsComparisonEntrySections(merged, dayDocument.payment_entries ?? null);
175
+ }
176
+ return merged;
177
+ }
178
+ function buildTenantPaymentsComparisonCloseDayPlan(input) {
179
+ if (input == null)
180
+ return null;
181
+ const { tenantId, reason } = input;
182
+ if (typeof tenantId !== 'string' || tenantId.length === 0)
183
+ return null;
184
+ if (typeof reason !== 'string' || reason.length === 0)
185
+ return null;
186
+ const computedAt = input.computedAt ?? new Date();
187
+ if (Number.isNaN(computedAt.getTime()))
188
+ return null;
189
+ const compiledReports = (input.reports ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
190
+ const compiledEntries = (input.entries ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
191
+ const storedReports = (input.existing ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
192
+ const storedEntries = (input.existingEntries ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
193
+ const compiledDateDoc = compiledReports.find((doc) => (0, exports.isMaterializedPaymentsComparisonDayScope)(String(doc.scope_context)));
194
+ const compiledDateEntries = compiledEntries.find((doc) => (0, exports.isMaterializedPaymentsComparisonDayScope)(String(doc.scope_context)));
195
+ const localDate = input.localDate ?? compiledDateDoc?.scope_field ?? null;
196
+ if (localDate == null || localDate === '' || (0, exports.getMaterializedPaymentsComparisonScopeRefsForDay)(localDate) == null) {
197
+ return null;
198
+ }
199
+ const writes = [];
200
+ const entryWrites = [];
201
+ const staleDocuments = [];
202
+ const staleEntryDocuments = [];
203
+ const skippedDocuments = [];
204
+ const skippedEntryDocuments = [];
205
+ const createdPeriodDocuments = [];
206
+ const storedReportsByScope = new Map();
207
+ for (const doc of storedReports)
208
+ storedReportsByScope.set(scopeKey(doc), doc);
209
+ const storedEntriesByScope = new Map();
210
+ for (const doc of storedEntries)
211
+ storedEntriesByScope.set(scopeKey(doc), doc);
212
+ const addWrite = (report) => {
213
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
214
+ const iteration = (0, materialized_tenant_reports_iterations_helpers_1.buildMaterializedTenantReportIteration)(persisted, {
215
+ reportType: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_TYPE_ENUM.TENANT_PAYMENTS_COMPARISON_REPORTS,
216
+ reason,
217
+ computedAt,
218
+ });
219
+ if (iteration == null)
220
+ return false;
221
+ writes.push({ report: persisted, iteration: iteration });
222
+ return true;
223
+ };
224
+ const addEntryWrite = (report) => {
225
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
226
+ const iteration = (0, materialized_tenant_reports_iterations_helpers_1.buildMaterializedTenantReportIteration)(persisted, {
227
+ reportType: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_TYPE_ENUM.TENANT_PAYMENTS_COMPARISON_ENTRIES,
228
+ reason,
229
+ computedAt,
230
+ });
231
+ if (iteration == null)
232
+ return false;
233
+ entryWrites.push({ report: persisted, iteration: iteration });
234
+ return true;
235
+ };
236
+ const storedDateDoc = storedReportsByScope.get(MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE + '|' + localDate);
237
+ const storedDateEntries = storedEntriesByScope.get(MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE + '|' + localDate);
238
+ let effectiveDayDoc = null;
239
+ if (compiledDateDoc != null) {
240
+ const next = {
241
+ ...compiledDateDoc,
242
+ _id: storedDateDoc?._id ?? compiledDateDoc._id ?? new mongoose_1.default.Types.ObjectId().toHexString(),
243
+ iteration: Number(storedDateDoc?.iteration ?? 0) + 1,
244
+ };
245
+ if (needsMaterializedPaymentsComparisonReportWrite(storedDateDoc, next, input.force === true)) {
246
+ if (addWrite(next))
247
+ effectiveDayDoc = next;
248
+ }
249
+ else if (storedDateDoc != null) {
250
+ skippedDocuments.push(storedDateDoc);
251
+ effectiveDayDoc = storedDateDoc;
252
+ }
253
+ else {
254
+ effectiveDayDoc = next;
255
+ }
256
+ }
257
+ else if (storedDateDoc != null) {
258
+ staleDocuments.push(storedDateDoc);
259
+ }
260
+ let effectiveDayEntries = null;
261
+ if (compiledDateEntries != null) {
262
+ const next = {
263
+ ...compiledDateEntries,
264
+ _id: storedDateEntries?._id ?? compiledDateEntries._id ?? new mongoose_1.default.Types.ObjectId().toHexString(),
265
+ iteration: Number(storedDateEntries?.iteration ?? 0) + 1,
266
+ };
267
+ if (needsMaterializedPaymentsComparisonEntriesWrite(storedDateEntries, next, input.force === true)) {
268
+ if (addEntryWrite(next))
269
+ effectiveDayEntries = next;
270
+ }
271
+ else if (storedDateEntries != null) {
272
+ skippedEntryDocuments.push(storedDateEntries);
273
+ effectiveDayEntries = storedDateEntries;
274
+ }
275
+ else {
276
+ effectiveDayEntries = next;
277
+ }
278
+ }
279
+ else if (storedDateEntries != null) {
280
+ staleEntryDocuments.push(storedDateEntries);
281
+ }
282
+ const nextDayDocs = storedReports.filter((doc) => (0, exports.isMaterializedPaymentsComparisonDayScope)(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
283
+ if (effectiveDayDoc != null)
284
+ nextDayDocs.push(effectiveDayDoc);
285
+ const nextDayEntryDocs = storedEntries.filter((doc) => (0, exports.isMaterializedPaymentsComparisonDayScope)(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
286
+ if (effectiveDayEntries != null)
287
+ nextDayEntryDocs.push(effectiveDayEntries);
288
+ const periodFields = (0, scope_helpers_1.getMaterializedPeriodScopeFields)(localDate);
289
+ if (periodFields == null)
290
+ return null;
291
+ const touchedPeriods = [];
292
+ for (const scope of exports.MATERIALIZED_PAYMENTS_COMPARISON_PERIOD_SCOPES) {
293
+ const field = periodFields[scope];
294
+ if (field == null || field === '')
295
+ return null;
296
+ touchedPeriods.push({ scope_context: scope, scope_field: field });
297
+ }
298
+ for (const period of touchedPeriods) {
299
+ const existing = storedReportsByScope.get(scopeKey(period));
300
+ const folded = foldMaterializedPaymentsComparisonPeriodCounters({
301
+ periodScope: period.scope_context,
302
+ periodScopeField: period.scope_field,
303
+ dayDocuments: nextDayDocs,
304
+ });
305
+ const keys = Object.keys(folded).sort();
306
+ if (keys.length === 0) {
307
+ if (existing != null && !staleDocuments.includes(existing))
308
+ staleDocuments.push(existing);
309
+ continue;
310
+ }
311
+ const paymentCounters = {};
312
+ const counterRows = [];
313
+ for (const key of keys) {
314
+ paymentCounters[key] = folded[key];
315
+ counterRows.push({ key, counters: folded[key] });
316
+ }
317
+ const contributingDays = nextDayDocs.filter((doc) => {
318
+ const fields = (0, scope_helpers_1.getMaterializedPeriodScopeFields)(String(doc.scope_field));
319
+ return fields != null && fields[period.scope_context] === period.scope_field;
320
+ });
321
+ const report = {
322
+ _id: existing?._id ?? new mongoose_1.default.Types.ObjectId().toHexString(),
323
+ tenant_id: tenantId,
324
+ brand_id: existing?.brand_id ?? effectiveDayDoc?.brand_id ?? compiledDateDoc?.brand_id ?? '',
325
+ scope_context: period.scope_context,
326
+ scope_field: period.scope_field,
327
+ day_index: null,
328
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...MATERIALIZED_REPORTS_1.PAYMENTS_COMPARISON_KEY_FILTERS],
329
+ payment_counters: paymentCounters,
330
+ payment_counter_rows: counterRows,
331
+ iteration: existing?.iteration,
332
+ schema_version: existing?.schema_version ?? MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_PAYMENTS_COMPARISON_REPORTS_SCHEMA_VERSION,
333
+ source_watermark: watermarkOfFoldedDays(contributingDays, existing?.source_watermark ?? computedAt),
334
+ computed_at: computedAt,
335
+ createdAt: existing?.createdAt ?? computedAt,
336
+ updatedAt: computedAt,
337
+ };
338
+ const next = {
339
+ ...report,
340
+ iteration: Number(existing?.iteration ?? 0) + 1,
341
+ };
342
+ if (needsMaterializedPaymentsComparisonReportWrite(existing, next, input.force === true)) {
343
+ if (addWrite(next) && existing == null) {
344
+ createdPeriodDocuments.push({
345
+ scope_context: period.scope_context,
346
+ scope_field: period.scope_field,
347
+ });
348
+ }
349
+ }
350
+ else if (existing != null) {
351
+ skippedDocuments.push(existing);
352
+ }
353
+ }
354
+ for (const period of touchedPeriods) {
355
+ const existing = storedEntriesByScope.get(scopeKey(period));
356
+ const sections = foldMaterializedPaymentsComparisonPeriodEntries({
357
+ periodScope: period.scope_context,
358
+ periodScopeField: period.scope_field,
359
+ dayDocuments: nextDayEntryDocs,
360
+ });
361
+ const keys = Object.keys(sections);
362
+ if (keys.length === 0) {
363
+ if (existing != null)
364
+ staleEntryDocuments.push(existing);
365
+ continue;
366
+ }
367
+ const contributingDays = nextDayEntryDocs.filter((doc) => {
368
+ const fields = (0, scope_helpers_1.getMaterializedPeriodScopeFields)(String(doc.scope_field));
369
+ return fields != null && fields[period.scope_context] === period.scope_field;
370
+ });
371
+ const report = {
372
+ _id: existing?._id ?? new mongoose_1.default.Types.ObjectId().toHexString(),
373
+ tenant_id: tenantId,
374
+ brand_id: existing?.brand_id ?? effectiveDayEntries?.brand_id ?? compiledDateEntries?.brand_id ?? '',
375
+ scope_context: period.scope_context,
376
+ scope_field: period.scope_field,
377
+ day_index: null,
378
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...MATERIALIZED_REPORTS_1.PAYMENTS_COMPARISON_KEY_FILTERS],
379
+ payment_entries: sections,
380
+ iteration: existing?.iteration,
381
+ schema_version: existing?.schema_version ?? MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_PAYMENTS_COMPARISON_ENTRIES_SCHEMA_VERSION,
382
+ source_watermark: watermarkOfFoldedDays(contributingDays, existing?.source_watermark ?? computedAt),
383
+ computed_at: computedAt,
384
+ createdAt: existing?.createdAt ?? computedAt,
385
+ updatedAt: computedAt,
386
+ };
387
+ const next = {
388
+ ...report,
389
+ iteration: Number(existing?.iteration ?? 0) + 1,
390
+ };
391
+ if (needsMaterializedPaymentsComparisonEntriesWrite(existing, next, input.force === true)) {
392
+ addEntryWrite(next);
393
+ }
394
+ else if (existing != null) {
395
+ skippedEntryDocuments.push(existing);
396
+ }
397
+ }
398
+ return {
399
+ writes,
400
+ entryWrites,
401
+ staleDocuments,
402
+ staleEntryDocuments,
403
+ skippedDocuments,
404
+ skippedEntryDocuments,
405
+ createdPeriodDocuments,
406
+ };
407
+ }
@@ -0,0 +1,35 @@
1
+ import { IOrder } from '../../schemas/types/orders';
2
+ import { IMaterializedTenantPaymentsComparisonEntries } from '../../schemas/types/materialized_tenant_payments_comparison_entries';
3
+ import { IMaterializedTenantPaymentsComparisonReport } from '../../schemas/types/materialized_tenant_payments_comparison_reports';
4
+ /**
5
+ * Payments Comparison compile — one settled tenant-day of orders into the day's
6
+ * `materialized_tenant_payments_comparison_reports` document and its payment
7
+ * entries document.
8
+ *
9
+ * One counter block per `<PAYMENT_METHOD>:<ORDER_STATUS>`; one row per INCLUDED
10
+ * payment (a split bill is two rows). The compile produces only the `localDate`
11
+ * pair — the close-day plan RE-FOLDS every period from its day documents.
12
+ *
13
+ * Pure and total: `null` on malformed input, never a throw.
14
+ */
15
+ export interface ICompileTenantPaymentsComparisonReportsInput {
16
+ tenantId: string;
17
+ brandId: string;
18
+ /** The compiled settled day, tenant-local `'YYYY-MM-DD'`. */
19
+ localDate: string;
20
+ orders: IOrder[];
21
+ /** Tenant GST offset in hours used to derive the settled local date. */
22
+ gmtOffset?: number;
23
+ computedAt: Date;
24
+ }
25
+ export interface ICompileTenantPaymentsComparisonReportsResult {
26
+ reports: IMaterializedTenantPaymentsComparisonReport[];
27
+ entries: IMaterializedTenantPaymentsComparisonEntries[];
28
+ /** Payments that produced a row. */
29
+ contributingPayments: number;
30
+ /** Orders skipped because they were never settled / are not of this day. */
31
+ skippedForeignOrders: number;
32
+ /** Included payments skipped because they had no usable identity. */
33
+ skippedUnidentifiablePayments: number;
34
+ }
35
+ export declare function compileTenantPaymentsComparisonReports(input: ICompileTenantPaymentsComparisonReportsInput | null | undefined): ICompileTenantPaymentsComparisonReportsResult | null;
@@ -0,0 +1,173 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.compileTenantPaymentsComparisonReports = compileTenantPaymentsComparisonReports;
7
+ const mongoose_1 = __importDefault(require("mongoose"));
8
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
9
+ const materialized_payments_comparison_accumulator_helpers_1 = require("./materialized-payments-comparison-accumulator-helpers");
10
+ const materialized_sales_comparison_accumulator_helpers_1 = require("./materialized-sales-comparison-accumulator-helpers");
11
+ const scope_helpers_1 = require("./scope-helpers");
12
+ const compareEntryDescending = (a, b) => {
13
+ const byTime = new Date(b.time).getTime() - new Date(a.time).getTime();
14
+ if (byTime !== 0)
15
+ return byTime;
16
+ if (a.order_id !== b.order_id)
17
+ return a.order_id < b.order_id ? -1 : 1;
18
+ return a.payment_id < b.payment_id ? -1 : a.payment_id > b.payment_id ? 1 : 0;
19
+ };
20
+ const watermarkOf = (order, fallback) => {
21
+ const raw = order?.updatedAt;
22
+ const time = raw == null ? NaN : new Date(raw).getTime();
23
+ return Number.isNaN(time) ? fallback : new Date(time);
24
+ };
25
+ function compileTenantPaymentsComparisonReports(input) {
26
+ if (input == null)
27
+ return null;
28
+ const { tenantId, brandId, localDate, orders, computedAt } = input;
29
+ if (typeof tenantId !== 'string' || tenantId.length === 0)
30
+ return null;
31
+ if (typeof brandId !== 'string' || brandId.length === 0)
32
+ return null;
33
+ if (typeof localDate !== 'string' || localDate.length === 0)
34
+ return null;
35
+ if (!Array.isArray(orders))
36
+ return null;
37
+ if (!(computedAt instanceof Date) || Number.isNaN(computedAt.getTime()))
38
+ return null;
39
+ const dayIndex = (0, scope_helpers_1.getDayIndexFromLocalDate)(localDate);
40
+ if (dayIndex == null)
41
+ return null;
42
+ const countersByKey = new Map();
43
+ const rowsByKey = new Map();
44
+ let contributingPayments = 0;
45
+ let skippedForeignOrders = 0;
46
+ let skippedUnidentifiablePayments = 0;
47
+ let watermark = null;
48
+ for (const order of orders) {
49
+ if (order == null)
50
+ continue;
51
+ if (order.is_deleted === true)
52
+ continue;
53
+ if (order.tenant_id != null && String(order.tenant_id) !== tenantId)
54
+ continue;
55
+ const settledDay = (0, materialized_sales_comparison_accumulator_helpers_1.getSalesComparisonSettledLocalDate)(order, input.gmtOffset);
56
+ if (settledDay !== localDate) {
57
+ skippedForeignOrders += 1;
58
+ continue;
59
+ }
60
+ const settledAt = new Date(order.order_settled_at);
61
+ if (Number.isNaN(settledAt.getTime())) {
62
+ skippedForeignOrders += 1;
63
+ continue;
64
+ }
65
+ const orderStatus = String(order.order_status ?? '');
66
+ for (const payment of order.payments ?? []) {
67
+ if (payment == null || !(0, materialized_payments_comparison_accumulator_helpers_1.isPaymentIncluded)(payment))
68
+ continue;
69
+ const paymentId = (0, materialized_payments_comparison_accumulator_helpers_1.getPaymentsComparisonPaymentId)(payment);
70
+ if (paymentId == null) {
71
+ skippedUnidentifiablePayments += 1;
72
+ continue;
73
+ }
74
+ const key = (0, materialized_payments_comparison_accumulator_helpers_1.buildPaymentsComparisonKey)(payment, orderStatus);
75
+ if (key == null) {
76
+ skippedUnidentifiablePayments += 1;
77
+ continue;
78
+ }
79
+ let counters = countersByKey.get(key);
80
+ if (counters == null) {
81
+ counters = (0, materialized_payments_comparison_accumulator_helpers_1.createEmptyPaymentsComparisonCounters)();
82
+ countersByKey.set(key, counters);
83
+ }
84
+ (0, materialized_payments_comparison_accumulator_helpers_1.addPaymentToPaymentsComparisonCounters)(counters, payment);
85
+ const row = {
86
+ order_id: String(order._id ?? ''),
87
+ order_number: order.order_number == null ? null : Number(order.order_number),
88
+ payment_id: paymentId,
89
+ time: settledAt.toISOString(),
90
+ payment_type: (0, materialized_payments_comparison_accumulator_helpers_1.getPaymentsComparisonMethod)(payment),
91
+ order_status: orderStatus,
92
+ payment_amount: (0, materialized_payments_comparison_accumulator_helpers_1.getMaterializedPaymentGross)(payment),
93
+ amount_due: Number(payment.amount_due) || 0,
94
+ amount_paid: Number(payment.amount_paid) || 0,
95
+ amount_refunded: Number(payment.amount_refunded) || 0,
96
+ card_charges: Number(payment.card_details?.card_charges) || 0,
97
+ };
98
+ const rows = rowsByKey.get(key);
99
+ if (rows == null)
100
+ rowsByKey.set(key, [row]);
101
+ else
102
+ rows.push(row);
103
+ contributingPayments += 1;
104
+ const orderWatermark = watermarkOf(order, computedAt);
105
+ if (watermark == null || orderWatermark.getTime() > watermark.getTime()) {
106
+ watermark = orderWatermark;
107
+ }
108
+ }
109
+ }
110
+ if (countersByKey.size === 0) {
111
+ return {
112
+ reports: [],
113
+ entries: [],
114
+ contributingPayments,
115
+ skippedForeignOrders,
116
+ skippedUnidentifiablePayments,
117
+ };
118
+ }
119
+ const sourceWatermark = watermark ?? computedAt;
120
+ const paymentCounters = {};
121
+ const counterRows = [];
122
+ const entrySections = {};
123
+ for (const key of [...countersByKey.keys()].sort()) {
124
+ const counters = countersByKey.get(key);
125
+ paymentCounters[key] = counters;
126
+ counterRows.push({ key, counters });
127
+ const rows = (rowsByKey.get(key) ?? []).slice().sort(compareEntryDescending);
128
+ if (rows.length > 0)
129
+ entrySections[key] = { rows };
130
+ }
131
+ return {
132
+ reports: [
133
+ {
134
+ _id: new mongoose_1.default.Types.ObjectId().toHexString(),
135
+ tenant_id: tenantId,
136
+ brand_id: brandId,
137
+ scope_context: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
138
+ scope_field: localDate,
139
+ day_index: dayIndex,
140
+ sale_type_key_filters: [...MATERIALIZED_REPORTS_1.PAYMENTS_COMPARISON_KEY_FILTERS],
141
+ payment_counters: paymentCounters,
142
+ payment_counter_rows: counterRows,
143
+ schema_version: MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_PAYMENTS_COMPARISON_REPORTS_SCHEMA_VERSION,
144
+ source_watermark: sourceWatermark,
145
+ computed_at: computedAt,
146
+ createdAt: computedAt,
147
+ updatedAt: computedAt,
148
+ iteration: 1,
149
+ },
150
+ ],
151
+ entries: [
152
+ {
153
+ _id: new mongoose_1.default.Types.ObjectId().toHexString(),
154
+ tenant_id: tenantId,
155
+ brand_id: brandId,
156
+ scope_context: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
157
+ scope_field: localDate,
158
+ day_index: dayIndex,
159
+ sale_type_key_filters: [...MATERIALIZED_REPORTS_1.PAYMENTS_COMPARISON_KEY_FILTERS],
160
+ payment_entries: entrySections,
161
+ schema_version: MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_PAYMENTS_COMPARISON_ENTRIES_SCHEMA_VERSION,
162
+ source_watermark: sourceWatermark,
163
+ computed_at: computedAt,
164
+ createdAt: computedAt,
165
+ updatedAt: computedAt,
166
+ iteration: 1,
167
+ },
168
+ ],
169
+ contributingPayments,
170
+ skippedForeignOrders,
171
+ skippedUnidentifiablePayments,
172
+ };
173
+ }
@@ -0,0 +1,66 @@
1
+ import { MATERIALIZED_PREP_TIME_ANCHOR_ENUM, MATERIALIZED_PREP_TIME_TARGET_ENUM } from '../../constants/MATERIALIZED_REPORTS';
2
+ import { IMaterializedPrepTimeEntry } from '../../schemas/types/materialized_tenant_prep_time_entries';
3
+ import { IMaterializedPrepTimeCounters } from '../../schemas/types/materialized_tenant_prep_time_reports';
4
+ /**
5
+ * M2 prep time - provenance classifier + accumulator.
6
+ *
7
+ * THE RULE (concept doc section 3.2.1, decision b2): `ready_minutes` is written
8
+ * from the chain `prep_started_at ?? order_status_updated_at ?? createdAt`, and
9
+ * the two populations behave completely differently. Only an item whose anchor is
10
+ * its OWN prep clock yields a real prep time; a fallback-anchored value is
11
+ * degenerate (measured: avg 0.0, 99.8% zeros in one store). Blending them
12
+ * under-reports the average by ~13x, so UNMEASURED items are counted in coverage
13
+ * and EXCLUDED from every duration statistic.
14
+ *
15
+ * The field shapes here are verified against the live fixtures: items live at
16
+ * `order.categories[].items[]` (NOT `order.items[]`), and the estimate fields are
17
+ * absolute ISO timestamps.
18
+ */
19
+ /** Context of one order's local time (mirrors the other report accumulators). */
20
+ export interface IPrepTimeOrderContext {
21
+ local_date: string;
22
+ local_hour_label: string | null;
23
+ }
24
+ /**
25
+ * Histogram bucket label of a duration. Total by construction: the top bucket is
26
+ * open-ended, so every finite duration lands in exactly one bucket.
27
+ */
28
+ export declare function resolveMaterializedPrepTimeBucket(minutes: number): string;
29
+ /**
30
+ * Provenance of ONE item (decision b2).
31
+ *
32
+ * MEASURED requires BOTH `prep_started_at` and `ready_minutes`: the item owns its
33
+ * prep clock, so the ready instant is reconstructible. Anything else - including
34
+ * `ready_minutes` with no `prep_started_at` - is UNMEASURED.
35
+ */
36
+ export declare function classifyMaterializedPrepTimeAnchor(item: {
37
+ prep_started_at?: unknown;
38
+ ready_minutes?: unknown;
39
+ }): MATERIALIZED_PREP_TIME_ANCHOR_ENUM;
40
+ /** A zeroed counter block. */
41
+ export declare function freshMaterializedPrepTimeCounters(): IMaterializedPrepTimeCounters;
42
+ /** The on-time target of one order, and where it came from (decision e2). */
43
+ export declare function resolveMaterializedPrepTimeTarget(order: any, tenantDefaultMinutes?: number | null): {
44
+ target_at: Date | null;
45
+ target_source: MATERIALIZED_PREP_TIME_TARGET_ENUM;
46
+ };
47
+ /** Stable identity of a row inside its order - part of the page cursor. */
48
+ export declare const buildMaterializedPrepTimeEntryKey: (itemId: string | null) => string;
49
+ export interface IAccumulateOrderPrepTimeResult {
50
+ counters: IMaterializedPrepTimeCounters;
51
+ entries: IMaterializedPrepTimeEntry[];
52
+ /** Orders with at least one TRACKED item - the coverage numerator. */
53
+ has_tracked: boolean;
54
+ }
55
+ /**
56
+ * Accumulates ONE order's items into the prep counters + drill-down rows.
57
+ *
58
+ * Items are read from `order.categories[].items[]` (the verified shape). Every
59
+ * item counts toward coverage; only MEASURED items reach the duration statistics,
60
+ * and only MEASURED items with a target are graded on time.
61
+ */
62
+ export declare function accumulateOrderPrepTime({ order, context, tenantDefaultMinutes, }: {
63
+ order: any;
64
+ context: IPrepTimeOrderContext;
65
+ tenantDefaultMinutes?: number | null;
66
+ }): IAccumulateOrderPrepTimeResult;