@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,89 @@
1
+ import { PAYMENT_TYPE_ENUM } from '../../constants/enums/payments';
2
+ import { buildMaterializedReportKey } from './key-helpers';
3
+ import { getMaterializedPaymentGross, isPaymentIncludedInMaterializedSalesOverview, normalizeMaterializedPaymentType, } from './tenant-sales-overview-helpers';
4
+ /**
5
+ * Payments Comparison counter accumulation.
6
+ *
7
+ * A payment row is included by the SAME rule as the overview's payment facet
8
+ * (`isPaymentIncludedInMaterializedSalesOverview`) and its money uses the SAME
9
+ * gross rule (`getMaterializedPaymentGross`, which handles refunds and card
10
+ * charges). `PAY_LATER` is reported as `UNPAID`, the existing one-place remap.
11
+ *
12
+ * The key is `<PAYMENT_METHOD>:<ORDER_STATUS>` (decision B). The method is an
13
+ * OPEN string; only reserved key characters make it un-keyable.
14
+ */
15
+ /** Coerces a source amount to a finite number (0 when absent/broken). */
16
+ const cents = (value) => {
17
+ const number = typeof value === 'number' ? value : Number(value);
18
+ return Number.isFinite(number) ? number : 0;
19
+ };
20
+ export function createEmptyPaymentsComparisonCounters() {
21
+ return {
22
+ payment_count: 0,
23
+ payment_amount: 0,
24
+ amount_due: 0,
25
+ amount_paid: 0,
26
+ amount_refunded: 0,
27
+ card_charges: 0,
28
+ refund_count: 0,
29
+ unpaid_count: 0,
30
+ };
31
+ }
32
+ /** The normalized payment type stored in the key (`PAY_LATER` → `UNPAID`). */
33
+ export function getPaymentsComparisonMethod(payment) {
34
+ return normalizeMaterializedPaymentType(String(payment.payment_type ?? ''));
35
+ }
36
+ /**
37
+ * The stable identity of a payment row: `payment_id` (fallback the payment
38
+ * subdocument `_id`). Returns null when the payment carries neither — the
39
+ * caller skips it rather than collapsing two rows.
40
+ */
41
+ export function getPaymentsComparisonPaymentId(payment) {
42
+ const id = payment.payment_id ?? payment._id;
43
+ const text = id == null ? '' : String(id);
44
+ return text === '' ? null : text;
45
+ }
46
+ /** `<METHOD>:<STATUS>` or null when a component cannot be a Mongo key. */
47
+ export function buildPaymentsComparisonKey(payment, orderStatus) {
48
+ return buildMaterializedReportKey([getPaymentsComparisonMethod(payment), orderStatus]);
49
+ }
50
+ /** Adds one INCLUDED payment's counters (mutates `target`). */
51
+ export function addPaymentToPaymentsComparisonCounters(target, payment) {
52
+ if (target == null || payment == null)
53
+ return;
54
+ const amountRefunded = cents(payment.amount_refunded);
55
+ target.payment_count += 1;
56
+ target.payment_amount += getMaterializedPaymentGross(payment);
57
+ target.amount_due += cents(payment.amount_due);
58
+ target.amount_paid += cents(payment.amount_paid);
59
+ target.amount_refunded += amountRefunded;
60
+ target.card_charges += cents(payment.card_details?.card_charges);
61
+ if (amountRefunded > 0)
62
+ target.refund_count += 1;
63
+ if (getPaymentsComparisonMethod(payment) === PAYMENT_TYPE_ENUM.UNPAID)
64
+ target.unpaid_count += 1;
65
+ }
66
+ /** Adds every counter of `source` into `target` (mutates `target`). */
67
+ export function addPaymentsComparisonCounters(target, source) {
68
+ if (target == null || source == null)
69
+ return;
70
+ for (const field of ALL_PAYMENTS_COMPARISON_COUNTER_FIELDS) {
71
+ target[field] += cents(source[field]);
72
+ }
73
+ }
74
+ export const ALL_PAYMENTS_COMPARISON_COUNTER_FIELDS = [
75
+ 'payment_count',
76
+ 'payment_amount',
77
+ 'amount_due',
78
+ 'amount_paid',
79
+ 'amount_refunded',
80
+ 'card_charges',
81
+ 'refund_count',
82
+ 'unpaid_count',
83
+ ];
84
+ /** True when the payment must appear in this report (the overview facet rule). */
85
+ export function isPaymentIncluded(payment) {
86
+ return isPaymentIncludedInMaterializedSalesOverview(payment);
87
+ }
88
+ /** Convenience re-export for the compile + tests. */
89
+ export { getMaterializedPaymentGross, normalizeMaterializedPaymentType };
@@ -0,0 +1,394 @@
1
+ import mongoose from 'mongoose';
2
+ import { MATERIALIZED_PAYMENTS_COMPARISON_REPORT_SCOPES, MATERIALIZED_REPORT_SCOPE_ENUM, MATERIALIZED_REPORT_TYPE_ENUM, MATERIALIZED_TENANT_PAYMENTS_COMPARISON_ENTRIES_SCHEMA_VERSION, MATERIALIZED_TENANT_PAYMENTS_COMPARISON_REPORTS_SCHEMA_VERSION, PAYMENTS_COMPARISON_KEY_FILTERS, } from '../../constants/MATERIALIZED_REPORTS';
3
+ import { buildMaterializedTenantReportIteration } from './materialized-tenant-reports-iterations-helpers';
4
+ import { getMaterializedPeriodScopeFields } from './scope-helpers';
5
+ import { addPaymentsComparisonCounters, createEmptyPaymentsComparisonCounters, } from './materialized-payments-comparison-accumulator-helpers';
6
+ import { getMaterializedSalesComparisonPeriodDayKeys, getMaterializedSalesComparisonScopeRefsForDay, } from './materialized-sales-comparison-close-day-helpers';
7
+ /**
8
+ * Payments Comparison close-day helpers.
9
+ *
10
+ * Mirrors Sales Comparison: the compile produces only the `localDate` pair, and
11
+ * every touched period is RE-FOLDED from its whole day set (never accumulated).
12
+ * Payment rows are de-duplicated by `(order_id, payment_id)` so a split bill is
13
+ * two rows but the same payment is never counted twice.
14
+ *
15
+ * The fetch contract is explicit (`getMaterializedPaymentsComparisonPeriodDayKeys`).
16
+ * The guard compares content when watermarks are equal, so a correction that
17
+ * removes a payment is written. Helpers never throw — invalid input returns null.
18
+ */
19
+ export const MATERIALIZED_PAYMENTS_COMPARISON_PERIOD_SCOPES = MATERIALIZED_PAYMENTS_COMPARISON_REPORT_SCOPES.filter((scope) => scope !== MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE);
20
+ export const isMaterializedPaymentsComparisonDayScope = (scopeContext) => String(scopeContext) === MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE;
21
+ export const getMaterializedPaymentsComparisonScopeRefsForDay = getMaterializedSalesComparisonScopeRefsForDay;
22
+ export const getMaterializedPaymentsComparisonPeriodDayKeys = getMaterializedSalesComparisonPeriodDayKeys;
23
+ const scopeKey = (doc) => String(doc.scope_context) + '|' + String(doc.scope_field);
24
+ /** Highest `source_watermark` across the day documents a fold used. */
25
+ function watermarkOfFoldedDays(dayDocuments, fallback) {
26
+ let latest = fallback.getTime();
27
+ for (const doc of dayDocuments ?? []) {
28
+ const time = new Date(doc?.source_watermark ?? 0).getTime();
29
+ if (!Number.isNaN(time) && time > latest)
30
+ latest = time;
31
+ }
32
+ return new Date(latest);
33
+ }
34
+ /** Canonical JSON (sorted object keys) for content comparison. */
35
+ function stableJson(value) {
36
+ const canonicalize = (input) => {
37
+ if (Array.isArray(input))
38
+ return input.map(canonicalize);
39
+ if (input != null && typeof input === 'object') {
40
+ const out = {};
41
+ for (const key of Object.keys(input).sort()) {
42
+ out[key] = canonicalize(input[key]);
43
+ }
44
+ return out;
45
+ }
46
+ return input;
47
+ };
48
+ return JSON.stringify(canonicalize(value ?? null));
49
+ }
50
+ export function needsMaterializedPaymentsComparisonReportWrite(existing, incoming, force = false) {
51
+ if (existing == null || incoming == null)
52
+ return true;
53
+ if (force)
54
+ return true;
55
+ if (Number(existing.schema_version) !== Number(incoming.schema_version) ||
56
+ Number.isNaN(Number(incoming.schema_version))) {
57
+ return true;
58
+ }
59
+ if ((existing.sale_type_key_filters ?? []).join(':') !== (incoming.sale_type_key_filters ?? []).join(':')) {
60
+ return true;
61
+ }
62
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
63
+ const next = new Date(incoming.source_watermark ?? 0).getTime();
64
+ if (Number.isNaN(stored) || Number.isNaN(next))
65
+ return true;
66
+ if (next > stored)
67
+ return true;
68
+ if (next < stored)
69
+ return false;
70
+ return stableJson(existing.payment_counters) !== stableJson(incoming.payment_counters);
71
+ }
72
+ export function needsMaterializedPaymentsComparisonEntriesWrite(existing, incoming, force = false) {
73
+ if (existing == null || incoming == null)
74
+ return true;
75
+ if (force)
76
+ return true;
77
+ if (Number(existing.schema_version) !== Number(incoming.schema_version) ||
78
+ Number.isNaN(Number(incoming.schema_version))) {
79
+ return true;
80
+ }
81
+ if ((existing.sale_type_key_filters ?? []).join(':') !== (incoming.sale_type_key_filters ?? []).join(':')) {
82
+ return true;
83
+ }
84
+ const stored = new Date(existing.source_watermark ?? 0).getTime();
85
+ const next = new Date(incoming.source_watermark ?? 0).getTime();
86
+ if (Number.isNaN(stored) || Number.isNaN(next))
87
+ return true;
88
+ if (next > stored)
89
+ return true;
90
+ if (next < stored)
91
+ return false;
92
+ return stableJson(existing.payment_entries) !== stableJson(incoming.payment_entries);
93
+ }
94
+ /** Folds the counters of every DAY document in one period. */
95
+ export function foldMaterializedPaymentsComparisonPeriodCounters(input) {
96
+ const folded = {};
97
+ for (const dayDocument of input?.dayDocuments ?? []) {
98
+ if (!isMaterializedPaymentsComparisonDayScope(String(dayDocument?.scope_context)))
99
+ continue;
100
+ const fields = getMaterializedPeriodScopeFields(String(dayDocument.scope_field));
101
+ if (fields == null)
102
+ continue;
103
+ if (fields[String(input.periodScope)] !== input.periodScopeField)
104
+ continue;
105
+ for (const [key, block] of Object.entries(dayDocument.payment_counters ?? {})) {
106
+ const target = folded[key] ?? createEmptyPaymentsComparisonCounters();
107
+ addPaymentsComparisonCounters(target, block);
108
+ folded[key] = target;
109
+ }
110
+ }
111
+ return folded;
112
+ }
113
+ const entryIdentity = (row) => String(row.order_id ?? '') + '|' + String(row.payment_id ?? '');
114
+ const compareRowsDescending = (a, b) => {
115
+ const byTime = new Date(b.time).getTime() - new Date(a.time).getTime();
116
+ if (byTime !== 0)
117
+ return byTime;
118
+ if (a.order_id !== b.order_id)
119
+ return a.order_id < b.order_id ? -1 : 1;
120
+ return a.payment_id < b.payment_id ? -1 : a.payment_id > b.payment_id ? 1 : 0;
121
+ };
122
+ export function mergeMaterializedPaymentsComparisonEntrySections(target, source) {
123
+ const rowsByKey = new Map();
124
+ const seenByKey = new Map();
125
+ const absorb = (input) => {
126
+ if (input == null)
127
+ return;
128
+ for (const [key, section] of Object.entries(input)) {
129
+ const rows = rowsByKey.get(key) ?? [];
130
+ const seen = seenByKey.get(key) ?? new Set();
131
+ for (const row of section?.rows ?? []) {
132
+ const identity = entryIdentity(row);
133
+ if (identity !== '|' && seen.has(identity))
134
+ continue;
135
+ seen.add(identity);
136
+ rows.push(row);
137
+ }
138
+ rowsByKey.set(key, rows);
139
+ seenByKey.set(key, seen);
140
+ }
141
+ };
142
+ absorb(target);
143
+ absorb(source);
144
+ const out = {};
145
+ for (const [key, rows] of rowsByKey) {
146
+ rows.sort(compareRowsDescending);
147
+ out[key] = { rows };
148
+ }
149
+ return out;
150
+ }
151
+ export function foldMaterializedPaymentsComparisonPeriodEntries(input) {
152
+ let merged = {};
153
+ for (const dayDocument of input?.dayDocuments ?? []) {
154
+ if (!isMaterializedPaymentsComparisonDayScope(String(dayDocument?.scope_context)))
155
+ continue;
156
+ const fields = getMaterializedPeriodScopeFields(String(dayDocument.scope_field));
157
+ if (fields == null)
158
+ continue;
159
+ if (fields[String(input.periodScope)] !== input.periodScopeField)
160
+ continue;
161
+ merged = mergeMaterializedPaymentsComparisonEntrySections(merged, dayDocument.payment_entries ?? null);
162
+ }
163
+ return merged;
164
+ }
165
+ export function buildTenantPaymentsComparisonCloseDayPlan(input) {
166
+ if (input == null)
167
+ return null;
168
+ const { tenantId, reason } = input;
169
+ if (typeof tenantId !== 'string' || tenantId.length === 0)
170
+ return null;
171
+ if (typeof reason !== 'string' || reason.length === 0)
172
+ return null;
173
+ const computedAt = input.computedAt ?? new Date();
174
+ if (Number.isNaN(computedAt.getTime()))
175
+ return null;
176
+ const compiledReports = (input.reports ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
177
+ const compiledEntries = (input.entries ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
178
+ const storedReports = (input.existing ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
179
+ const storedEntries = (input.existingEntries ?? []).filter((doc) => doc != null && String(doc.tenant_id) === tenantId);
180
+ const compiledDateDoc = compiledReports.find((doc) => isMaterializedPaymentsComparisonDayScope(String(doc.scope_context)));
181
+ const compiledDateEntries = compiledEntries.find((doc) => isMaterializedPaymentsComparisonDayScope(String(doc.scope_context)));
182
+ const localDate = input.localDate ?? compiledDateDoc?.scope_field ?? null;
183
+ if (localDate == null || localDate === '' || getMaterializedPaymentsComparisonScopeRefsForDay(localDate) == null) {
184
+ return null;
185
+ }
186
+ const writes = [];
187
+ const entryWrites = [];
188
+ const staleDocuments = [];
189
+ const staleEntryDocuments = [];
190
+ const skippedDocuments = [];
191
+ const skippedEntryDocuments = [];
192
+ const createdPeriodDocuments = [];
193
+ const storedReportsByScope = new Map();
194
+ for (const doc of storedReports)
195
+ storedReportsByScope.set(scopeKey(doc), doc);
196
+ const storedEntriesByScope = new Map();
197
+ for (const doc of storedEntries)
198
+ storedEntriesByScope.set(scopeKey(doc), doc);
199
+ const addWrite = (report) => {
200
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
201
+ const iteration = buildMaterializedTenantReportIteration(persisted, {
202
+ reportType: MATERIALIZED_REPORT_TYPE_ENUM.TENANT_PAYMENTS_COMPARISON_REPORTS,
203
+ reason,
204
+ computedAt,
205
+ });
206
+ if (iteration == null)
207
+ return false;
208
+ writes.push({ report: persisted, iteration: iteration });
209
+ return true;
210
+ };
211
+ const addEntryWrite = (report) => {
212
+ const persisted = report.iteration == null ? { ...report, iteration: 1 } : report;
213
+ const iteration = buildMaterializedTenantReportIteration(persisted, {
214
+ reportType: MATERIALIZED_REPORT_TYPE_ENUM.TENANT_PAYMENTS_COMPARISON_ENTRIES,
215
+ reason,
216
+ computedAt,
217
+ });
218
+ if (iteration == null)
219
+ return false;
220
+ entryWrites.push({ report: persisted, iteration: iteration });
221
+ return true;
222
+ };
223
+ const storedDateDoc = storedReportsByScope.get(MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE + '|' + localDate);
224
+ const storedDateEntries = storedEntriesByScope.get(MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE + '|' + localDate);
225
+ let effectiveDayDoc = null;
226
+ if (compiledDateDoc != null) {
227
+ const next = {
228
+ ...compiledDateDoc,
229
+ _id: storedDateDoc?._id ?? compiledDateDoc._id ?? new mongoose.Types.ObjectId().toHexString(),
230
+ iteration: Number(storedDateDoc?.iteration ?? 0) + 1,
231
+ };
232
+ if (needsMaterializedPaymentsComparisonReportWrite(storedDateDoc, next, input.force === true)) {
233
+ if (addWrite(next))
234
+ effectiveDayDoc = next;
235
+ }
236
+ else if (storedDateDoc != null) {
237
+ skippedDocuments.push(storedDateDoc);
238
+ effectiveDayDoc = storedDateDoc;
239
+ }
240
+ else {
241
+ effectiveDayDoc = next;
242
+ }
243
+ }
244
+ else if (storedDateDoc != null) {
245
+ staleDocuments.push(storedDateDoc);
246
+ }
247
+ let effectiveDayEntries = null;
248
+ if (compiledDateEntries != null) {
249
+ const next = {
250
+ ...compiledDateEntries,
251
+ _id: storedDateEntries?._id ?? compiledDateEntries._id ?? new mongoose.Types.ObjectId().toHexString(),
252
+ iteration: Number(storedDateEntries?.iteration ?? 0) + 1,
253
+ };
254
+ if (needsMaterializedPaymentsComparisonEntriesWrite(storedDateEntries, next, input.force === true)) {
255
+ if (addEntryWrite(next))
256
+ effectiveDayEntries = next;
257
+ }
258
+ else if (storedDateEntries != null) {
259
+ skippedEntryDocuments.push(storedDateEntries);
260
+ effectiveDayEntries = storedDateEntries;
261
+ }
262
+ else {
263
+ effectiveDayEntries = next;
264
+ }
265
+ }
266
+ else if (storedDateEntries != null) {
267
+ staleEntryDocuments.push(storedDateEntries);
268
+ }
269
+ const nextDayDocs = storedReports.filter((doc) => isMaterializedPaymentsComparisonDayScope(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
270
+ if (effectiveDayDoc != null)
271
+ nextDayDocs.push(effectiveDayDoc);
272
+ const nextDayEntryDocs = storedEntries.filter((doc) => isMaterializedPaymentsComparisonDayScope(String(doc.scope_context)) && String(doc.scope_field) !== localDate);
273
+ if (effectiveDayEntries != null)
274
+ nextDayEntryDocs.push(effectiveDayEntries);
275
+ const periodFields = getMaterializedPeriodScopeFields(localDate);
276
+ if (periodFields == null)
277
+ return null;
278
+ const touchedPeriods = [];
279
+ for (const scope of MATERIALIZED_PAYMENTS_COMPARISON_PERIOD_SCOPES) {
280
+ const field = periodFields[scope];
281
+ if (field == null || field === '')
282
+ return null;
283
+ touchedPeriods.push({ scope_context: scope, scope_field: field });
284
+ }
285
+ for (const period of touchedPeriods) {
286
+ const existing = storedReportsByScope.get(scopeKey(period));
287
+ const folded = foldMaterializedPaymentsComparisonPeriodCounters({
288
+ periodScope: period.scope_context,
289
+ periodScopeField: period.scope_field,
290
+ dayDocuments: nextDayDocs,
291
+ });
292
+ const keys = Object.keys(folded).sort();
293
+ if (keys.length === 0) {
294
+ if (existing != null && !staleDocuments.includes(existing))
295
+ staleDocuments.push(existing);
296
+ continue;
297
+ }
298
+ const paymentCounters = {};
299
+ const counterRows = [];
300
+ for (const key of keys) {
301
+ paymentCounters[key] = folded[key];
302
+ counterRows.push({ key, counters: folded[key] });
303
+ }
304
+ const contributingDays = nextDayDocs.filter((doc) => {
305
+ const fields = getMaterializedPeriodScopeFields(String(doc.scope_field));
306
+ return fields != null && fields[period.scope_context] === period.scope_field;
307
+ });
308
+ const report = {
309
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
310
+ tenant_id: tenantId,
311
+ brand_id: existing?.brand_id ?? effectiveDayDoc?.brand_id ?? compiledDateDoc?.brand_id ?? '',
312
+ scope_context: period.scope_context,
313
+ scope_field: period.scope_field,
314
+ day_index: null,
315
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...PAYMENTS_COMPARISON_KEY_FILTERS],
316
+ payment_counters: paymentCounters,
317
+ payment_counter_rows: counterRows,
318
+ iteration: existing?.iteration,
319
+ schema_version: existing?.schema_version ?? MATERIALIZED_TENANT_PAYMENTS_COMPARISON_REPORTS_SCHEMA_VERSION,
320
+ source_watermark: watermarkOfFoldedDays(contributingDays, existing?.source_watermark ?? computedAt),
321
+ computed_at: computedAt,
322
+ createdAt: existing?.createdAt ?? computedAt,
323
+ updatedAt: computedAt,
324
+ };
325
+ const next = {
326
+ ...report,
327
+ iteration: Number(existing?.iteration ?? 0) + 1,
328
+ };
329
+ if (needsMaterializedPaymentsComparisonReportWrite(existing, next, input.force === true)) {
330
+ if (addWrite(next) && existing == null) {
331
+ createdPeriodDocuments.push({
332
+ scope_context: period.scope_context,
333
+ scope_field: period.scope_field,
334
+ });
335
+ }
336
+ }
337
+ else if (existing != null) {
338
+ skippedDocuments.push(existing);
339
+ }
340
+ }
341
+ for (const period of touchedPeriods) {
342
+ const existing = storedEntriesByScope.get(scopeKey(period));
343
+ const sections = foldMaterializedPaymentsComparisonPeriodEntries({
344
+ periodScope: period.scope_context,
345
+ periodScopeField: period.scope_field,
346
+ dayDocuments: nextDayEntryDocs,
347
+ });
348
+ const keys = Object.keys(sections);
349
+ if (keys.length === 0) {
350
+ if (existing != null)
351
+ staleEntryDocuments.push(existing);
352
+ continue;
353
+ }
354
+ const contributingDays = nextDayEntryDocs.filter((doc) => {
355
+ const fields = getMaterializedPeriodScopeFields(String(doc.scope_field));
356
+ return fields != null && fields[period.scope_context] === period.scope_field;
357
+ });
358
+ const report = {
359
+ _id: existing?._id ?? new mongoose.Types.ObjectId().toHexString(),
360
+ tenant_id: tenantId,
361
+ brand_id: existing?.brand_id ?? effectiveDayEntries?.brand_id ?? compiledDateEntries?.brand_id ?? '',
362
+ scope_context: period.scope_context,
363
+ scope_field: period.scope_field,
364
+ day_index: null,
365
+ sale_type_key_filters: existing?.sale_type_key_filters ?? [...PAYMENTS_COMPARISON_KEY_FILTERS],
366
+ payment_entries: sections,
367
+ iteration: existing?.iteration,
368
+ schema_version: existing?.schema_version ?? MATERIALIZED_TENANT_PAYMENTS_COMPARISON_ENTRIES_SCHEMA_VERSION,
369
+ source_watermark: watermarkOfFoldedDays(contributingDays, existing?.source_watermark ?? computedAt),
370
+ computed_at: computedAt,
371
+ createdAt: existing?.createdAt ?? computedAt,
372
+ updatedAt: computedAt,
373
+ };
374
+ const next = {
375
+ ...report,
376
+ iteration: Number(existing?.iteration ?? 0) + 1,
377
+ };
378
+ if (needsMaterializedPaymentsComparisonEntriesWrite(existing, next, input.force === true)) {
379
+ addEntryWrite(next);
380
+ }
381
+ else if (existing != null) {
382
+ skippedEntryDocuments.push(existing);
383
+ }
384
+ }
385
+ return {
386
+ writes,
387
+ entryWrites,
388
+ staleDocuments,
389
+ staleEntryDocuments,
390
+ skippedDocuments,
391
+ skippedEntryDocuments,
392
+ createdPeriodDocuments,
393
+ };
394
+ }
@@ -0,0 +1,167 @@
1
+ import mongoose from 'mongoose';
2
+ import { MATERIALIZED_REPORT_SCOPE_ENUM, MATERIALIZED_TENANT_PAYMENTS_COMPARISON_ENTRIES_SCHEMA_VERSION, MATERIALIZED_TENANT_PAYMENTS_COMPARISON_REPORTS_SCHEMA_VERSION, PAYMENTS_COMPARISON_KEY_FILTERS, } from '../../constants/MATERIALIZED_REPORTS';
3
+ import { addPaymentToPaymentsComparisonCounters, buildPaymentsComparisonKey, createEmptyPaymentsComparisonCounters, getMaterializedPaymentGross, getPaymentsComparisonMethod, getPaymentsComparisonPaymentId, isPaymentIncluded, } from './materialized-payments-comparison-accumulator-helpers';
4
+ import { getSalesComparisonSettledLocalDate } from './materialized-sales-comparison-accumulator-helpers';
5
+ import { getDayIndexFromLocalDate } from './scope-helpers';
6
+ const compareEntryDescending = (a, b) => {
7
+ const byTime = new Date(b.time).getTime() - new Date(a.time).getTime();
8
+ if (byTime !== 0)
9
+ return byTime;
10
+ if (a.order_id !== b.order_id)
11
+ return a.order_id < b.order_id ? -1 : 1;
12
+ return a.payment_id < b.payment_id ? -1 : a.payment_id > b.payment_id ? 1 : 0;
13
+ };
14
+ const watermarkOf = (order, fallback) => {
15
+ const raw = order?.updatedAt;
16
+ const time = raw == null ? NaN : new Date(raw).getTime();
17
+ return Number.isNaN(time) ? fallback : new Date(time);
18
+ };
19
+ export function compileTenantPaymentsComparisonReports(input) {
20
+ if (input == null)
21
+ return null;
22
+ const { tenantId, brandId, localDate, orders, computedAt } = input;
23
+ if (typeof tenantId !== 'string' || tenantId.length === 0)
24
+ return null;
25
+ if (typeof brandId !== 'string' || brandId.length === 0)
26
+ return null;
27
+ if (typeof localDate !== 'string' || localDate.length === 0)
28
+ return null;
29
+ if (!Array.isArray(orders))
30
+ return null;
31
+ if (!(computedAt instanceof Date) || Number.isNaN(computedAt.getTime()))
32
+ return null;
33
+ const dayIndex = getDayIndexFromLocalDate(localDate);
34
+ if (dayIndex == null)
35
+ return null;
36
+ const countersByKey = new Map();
37
+ const rowsByKey = new Map();
38
+ let contributingPayments = 0;
39
+ let skippedForeignOrders = 0;
40
+ let skippedUnidentifiablePayments = 0;
41
+ let watermark = null;
42
+ for (const order of orders) {
43
+ if (order == null)
44
+ continue;
45
+ if (order.is_deleted === true)
46
+ continue;
47
+ if (order.tenant_id != null && String(order.tenant_id) !== tenantId)
48
+ continue;
49
+ const settledDay = getSalesComparisonSettledLocalDate(order, input.gmtOffset);
50
+ if (settledDay !== localDate) {
51
+ skippedForeignOrders += 1;
52
+ continue;
53
+ }
54
+ const settledAt = new Date(order.order_settled_at);
55
+ if (Number.isNaN(settledAt.getTime())) {
56
+ skippedForeignOrders += 1;
57
+ continue;
58
+ }
59
+ const orderStatus = String(order.order_status ?? '');
60
+ for (const payment of order.payments ?? []) {
61
+ if (payment == null || !isPaymentIncluded(payment))
62
+ continue;
63
+ const paymentId = getPaymentsComparisonPaymentId(payment);
64
+ if (paymentId == null) {
65
+ skippedUnidentifiablePayments += 1;
66
+ continue;
67
+ }
68
+ const key = buildPaymentsComparisonKey(payment, orderStatus);
69
+ if (key == null) {
70
+ skippedUnidentifiablePayments += 1;
71
+ continue;
72
+ }
73
+ let counters = countersByKey.get(key);
74
+ if (counters == null) {
75
+ counters = createEmptyPaymentsComparisonCounters();
76
+ countersByKey.set(key, counters);
77
+ }
78
+ addPaymentToPaymentsComparisonCounters(counters, payment);
79
+ const row = {
80
+ order_id: String(order._id ?? ''),
81
+ order_number: order.order_number == null ? null : Number(order.order_number),
82
+ payment_id: paymentId,
83
+ time: settledAt.toISOString(),
84
+ payment_type: getPaymentsComparisonMethod(payment),
85
+ order_status: orderStatus,
86
+ payment_amount: getMaterializedPaymentGross(payment),
87
+ amount_due: Number(payment.amount_due) || 0,
88
+ amount_paid: Number(payment.amount_paid) || 0,
89
+ amount_refunded: Number(payment.amount_refunded) || 0,
90
+ card_charges: Number(payment.card_details?.card_charges) || 0,
91
+ };
92
+ const rows = rowsByKey.get(key);
93
+ if (rows == null)
94
+ rowsByKey.set(key, [row]);
95
+ else
96
+ rows.push(row);
97
+ contributingPayments += 1;
98
+ const orderWatermark = watermarkOf(order, computedAt);
99
+ if (watermark == null || orderWatermark.getTime() > watermark.getTime()) {
100
+ watermark = orderWatermark;
101
+ }
102
+ }
103
+ }
104
+ if (countersByKey.size === 0) {
105
+ return {
106
+ reports: [],
107
+ entries: [],
108
+ contributingPayments,
109
+ skippedForeignOrders,
110
+ skippedUnidentifiablePayments,
111
+ };
112
+ }
113
+ const sourceWatermark = watermark ?? computedAt;
114
+ const paymentCounters = {};
115
+ const counterRows = [];
116
+ const entrySections = {};
117
+ for (const key of [...countersByKey.keys()].sort()) {
118
+ const counters = countersByKey.get(key);
119
+ paymentCounters[key] = counters;
120
+ counterRows.push({ key, counters });
121
+ const rows = (rowsByKey.get(key) ?? []).slice().sort(compareEntryDescending);
122
+ if (rows.length > 0)
123
+ entrySections[key] = { rows };
124
+ }
125
+ return {
126
+ reports: [
127
+ {
128
+ _id: new mongoose.Types.ObjectId().toHexString(),
129
+ tenant_id: tenantId,
130
+ brand_id: brandId,
131
+ scope_context: MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
132
+ scope_field: localDate,
133
+ day_index: dayIndex,
134
+ sale_type_key_filters: [...PAYMENTS_COMPARISON_KEY_FILTERS],
135
+ payment_counters: paymentCounters,
136
+ payment_counter_rows: counterRows,
137
+ schema_version: MATERIALIZED_TENANT_PAYMENTS_COMPARISON_REPORTS_SCHEMA_VERSION,
138
+ source_watermark: sourceWatermark,
139
+ computed_at: computedAt,
140
+ createdAt: computedAt,
141
+ updatedAt: computedAt,
142
+ iteration: 1,
143
+ },
144
+ ],
145
+ entries: [
146
+ {
147
+ _id: new mongoose.Types.ObjectId().toHexString(),
148
+ tenant_id: tenantId,
149
+ brand_id: brandId,
150
+ scope_context: MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
151
+ scope_field: localDate,
152
+ day_index: dayIndex,
153
+ sale_type_key_filters: [...PAYMENTS_COMPARISON_KEY_FILTERS],
154
+ payment_entries: entrySections,
155
+ schema_version: MATERIALIZED_TENANT_PAYMENTS_COMPARISON_ENTRIES_SCHEMA_VERSION,
156
+ source_watermark: sourceWatermark,
157
+ computed_at: computedAt,
158
+ createdAt: computedAt,
159
+ updatedAt: computedAt,
160
+ iteration: 1,
161
+ },
162
+ ],
163
+ contributingPayments,
164
+ skippedForeignOrders,
165
+ skippedUnidentifiablePayments,
166
+ };
167
+ }