@managesome/eposmatic-toolkit 0.4.8 → 0.4.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/esm/constants/MATERIALIZED_REPORTS.js +448 -0
- package/esm/constants/enums/communications.js +1 -0
- package/esm/helpers/index.js +3 -0
- package/esm/helpers/materialized-reports/index.js +32 -0
- package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
- package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +286 -0
- package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
- package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +244 -0
- package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
- package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +426 -0
- package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +372 -0
- package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +214 -0
- package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +318 -0
- package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
- package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
- package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
- package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
- package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
- package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +111 -0
- package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +88 -0
- package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
- package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
- package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
- package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +476 -0
- package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
- package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +7 -0
- package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
- package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +157 -0
- package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
- package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
- package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +156 -0
- package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
- package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
- package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +237 -0
- package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +279 -0
- package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
- package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +343 -0
- package/esm/helpers/reporting-contract/index.js +2 -0
- package/esm/helpers/reporting-contract/overview-contract.js +122 -0
- package/esm/helpers/reporting-contract/report-contract.js +228 -0
- package/esm/helpers/rider-earnings/index.js +1 -0
- package/esm/helpers/rider-earnings/rider-earnings.js +59 -0
- package/esm/helpers/rider-reports/index.js +2 -0
- package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
- package/esm/helpers/rider-reports/rider-report.js +67 -0
- package/esm/schemas/models/deliveries.js +75 -0
- package/esm/schemas/models/index.js +15 -0
- package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
- package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
- package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
- package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
- package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
- package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
- package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
- package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
- package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
- package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
- package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
- package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
- package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
- package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
- package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
- package/esm/schemas/types/index.js +15 -0
- package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
- package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
- package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
- package/lib/constants/MATERIALIZED_REPORTS.d.ts +339 -2
- package/lib/constants/MATERIALIZED_REPORTS.js +450 -1
- package/lib/constants/enums/communications.d.ts +1 -0
- package/lib/constants/enums/communications.js +2 -1
- package/lib/helpers/index.d.ts +3 -0
- package/lib/helpers/index.js +3 -0
- package/lib/helpers/materialized-reports/index.d.ts +32 -0
- package/lib/helpers/materialized-reports/index.js +32 -0
- package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
- package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
- package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +90 -0
- package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +295 -0
- package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +102 -0
- package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
- package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +72 -0
- package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +251 -0
- package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
- package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
- package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +84 -0
- package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +438 -0
- package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +97 -0
- package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +385 -0
- package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +40 -0
- package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +218 -0
- package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
- package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +324 -0
- package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
- package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
- package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
- package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
- package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
- package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +116 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +98 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +66 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +128 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +490 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +46 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
- package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
- package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +8 -1
- package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +161 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
- package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
- package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +159 -0
- package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
- package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
- package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
- package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
- package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
- package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +243 -0
- package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
- package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +286 -0
- package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +97 -0
- package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
- package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
- package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +349 -0
- package/lib/helpers/reporting-contract/index.d.ts +2 -0
- package/lib/helpers/reporting-contract/index.js +18 -0
- package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
- package/lib/helpers/reporting-contract/overview-contract.js +126 -0
- package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
- package/lib/helpers/reporting-contract/report-contract.js +239 -0
- package/lib/helpers/rider-earnings/index.d.ts +1 -0
- package/lib/helpers/rider-earnings/index.js +17 -0
- package/lib/helpers/rider-earnings/rider-earnings.d.ts +58 -0
- package/lib/helpers/rider-earnings/rider-earnings.js +64 -0
- package/lib/helpers/rider-reports/index.d.ts +2 -0
- package/lib/helpers/rider-reports/index.js +18 -0
- package/lib/helpers/rider-reports/rider-daily-report.d.ts +26 -0
- package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
- package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
- package/lib/helpers/rider-reports/rider-report.js +70 -0
- package/lib/helpers/types/materialized-reports-apis.d.ts +297 -1
- package/lib/schemas/models/deliveries.d.ts +54 -0
- package/lib/schemas/models/deliveries.js +75 -0
- package/lib/schemas/models/expense_details.d.ts +3 -3
- package/lib/schemas/models/index.d.ts +15 -0
- package/lib/schemas/models/index.js +15 -0
- package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
- package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
- package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
- package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
- package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
- package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
- package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
- package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
- package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
- package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
- package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
- package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
- package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
- package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
- package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
- package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
- package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
- package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
- package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
- package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
- package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
- package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
- package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
- package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
- package/lib/schemas/types/deliveries.d.ts +40 -1
- package/lib/schemas/types/index.d.ts +15 -0
- package/lib/schemas/types/index.js +15 -0
- package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
- package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
- package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
- package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
- package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
- package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
- package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
- package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
- package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
- package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
- package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
- package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
- package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
- package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
- package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
- package/lib/tests/materialized-reports/fixtures.js +1 -0
- package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-compile.test.js +196 -0
- package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
- package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +152 -0
- package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
- package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
- package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
- package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +241 -0
- package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
- package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +141 -0
- package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
- package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
- package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
- package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
- package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
- package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
- package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
- package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
- package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +270 -0
- package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
- package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
- package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +206 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
- package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
- package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
- package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
- package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
- package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
- package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
- package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
- package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
- package/lib/tests/reporting-contract.test.d.ts +1 -0
- package/lib/tests/reporting-contract.test.js +267 -0
- package/lib/tests/rider-daily-report.test.d.ts +1 -0
- package/lib/tests/rider-daily-report.test.js +86 -0
- package/lib/tests/rider-earnings.test.d.ts +1 -0
- package/lib/tests/rider-earnings.test.js +65 -0
- package/lib/tests/rider-report.test.d.ts +1 -0
- package/lib/tests/rider-report.test.js +98 -0
- package/package.json +10 -1
|
@@ -0,0 +1,438 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.MATERIALIZED_DELIVERY_KEY_SEPARATOR = exports.DELIVERY_UNKNOWN_TOKEN = void 0;
|
|
4
|
+
exports.buildMaterializedDeliveryKey = buildMaterializedDeliveryKey;
|
|
5
|
+
exports.parseMaterializedDeliveryKey = parseMaterializedDeliveryKey;
|
|
6
|
+
exports.freshDeliveryCounters = freshDeliveryCounters;
|
|
7
|
+
exports.deliveryDistanceBucketKey = deliveryDistanceBucketKey;
|
|
8
|
+
exports.freshDeliveryAccumulator = freshDeliveryAccumulator;
|
|
9
|
+
exports.isDeliveryOrder = isDeliveryOrder;
|
|
10
|
+
exports.addDeliveryOrder = addDeliveryOrder;
|
|
11
|
+
exports.addDelivery = addDelivery;
|
|
12
|
+
exports.finalizeDeliveryAccumulator = finalizeDeliveryAccumulator;
|
|
13
|
+
const delivery_1 = require("../../constants/enums/delivery");
|
|
14
|
+
const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
|
|
15
|
+
/**
|
|
16
|
+
* M4 delivery - key grammar, the order join, and the accumulators.
|
|
17
|
+
*
|
|
18
|
+
* ## Adoption is the headline, and it needs BOTH populations
|
|
19
|
+
*
|
|
20
|
+
* The `deliveries` collection is written ONLY by the rider app, so for a tenant that does
|
|
21
|
+
* not use it the collection is EMPTY. An empty collection renders as "no deliveries"
|
|
22
|
+
* rather than "no visibility" - which is why the counters always carry
|
|
23
|
+
* `delivery_order_count` (from the ORDERS stage) beside `delivered_via_app_count` (from the
|
|
24
|
+
* DELIVERIES stage). Neither stage alone can compute `off_app_count`.
|
|
25
|
+
*
|
|
26
|
+
* `off_app_count` is NOT an error state: it is the pool the rider app can win.
|
|
27
|
+
*
|
|
28
|
+
* ## The join
|
|
29
|
+
*
|
|
30
|
+
* A delivery document carries neither the platform nor the city, so the key
|
|
31
|
+
* `<PLATFORM>:<CITY>` and every order-derived money figure come from joining by
|
|
32
|
+
* `order_id`. An order with no platform/city details falls into an explicit UNKNOWN
|
|
33
|
+
* bucket rather than being dropped silently - a missing dimension must still show up in
|
|
34
|
+
* the totals.
|
|
35
|
+
*
|
|
36
|
+
* ## One order, N attempts
|
|
37
|
+
*
|
|
38
|
+
* The unique `order_id + rider_id` index allows a re-assignment to create a SECOND
|
|
39
|
+
* delivery for the same order. `deliveries.count` therefore counts ATTEMPTS while
|
|
40
|
+
* `delivery_order_count` counts ORDERS, and the two are deliberately not expected to
|
|
41
|
+
* match. `off_app_count` is computed from a SET difference so a reassigned order is never
|
|
42
|
+
* counted as off-app.
|
|
43
|
+
*/
|
|
44
|
+
/** The key token used when a dimension is missing, so nothing is silently dropped. */
|
|
45
|
+
exports.DELIVERY_UNKNOWN_TOKEN = 'UNKNOWN';
|
|
46
|
+
exports.MATERIALIZED_DELIVERY_KEY_SEPARATOR = ':';
|
|
47
|
+
/** Builds `<PLATFORM>:<CITY>`, substituting UNKNOWN for missing dimensions. */
|
|
48
|
+
function buildMaterializedDeliveryKey(platform, city) {
|
|
49
|
+
return normalizeDimension(platform) + exports.MATERIALIZED_DELIVERY_KEY_SEPARATOR + normalizeDimension(city);
|
|
50
|
+
}
|
|
51
|
+
function normalizeDimension(value) {
|
|
52
|
+
if (value == null)
|
|
53
|
+
return exports.DELIVERY_UNKNOWN_TOKEN;
|
|
54
|
+
const text = String(value).trim();
|
|
55
|
+
if (text === '')
|
|
56
|
+
return exports.DELIVERY_UNKNOWN_TOKEN;
|
|
57
|
+
// The separator must never appear inside a component, or the key is ambiguous;
|
|
58
|
+
// collapsing it to a dash keeps the row rather than dropping it.
|
|
59
|
+
return text.split(exports.MATERIALIZED_DELIVERY_KEY_SEPARATOR).join('-');
|
|
60
|
+
}
|
|
61
|
+
/** Splits a key back into its parts, or null when it is malformed. */
|
|
62
|
+
function parseMaterializedDeliveryKey(key) {
|
|
63
|
+
if (key == null)
|
|
64
|
+
return null;
|
|
65
|
+
const parts = String(key).split(exports.MATERIALIZED_DELIVERY_KEY_SEPARATOR);
|
|
66
|
+
if (parts.length !== 2)
|
|
67
|
+
return null;
|
|
68
|
+
const [platform, city] = parts;
|
|
69
|
+
if (platform === '' || city === '')
|
|
70
|
+
return null;
|
|
71
|
+
return { platform, city };
|
|
72
|
+
}
|
|
73
|
+
const emptyRiderRow = (name) => ({
|
|
74
|
+
rider_name: name,
|
|
75
|
+
count: 0,
|
|
76
|
+
completed_count: 0,
|
|
77
|
+
cancelled_count: 0,
|
|
78
|
+
in_progress_count: 0,
|
|
79
|
+
rider_revenue_amount: 0,
|
|
80
|
+
distance_sum_meters: 0,
|
|
81
|
+
first_delivery_at: null,
|
|
82
|
+
last_delivery_at: null,
|
|
83
|
+
});
|
|
84
|
+
const emptyAreaRow = () => ({
|
|
85
|
+
count: 0,
|
|
86
|
+
completed_count: 0,
|
|
87
|
+
cancelled_count: 0,
|
|
88
|
+
rider_revenue_amount: 0,
|
|
89
|
+
distance_sum_meters: 0,
|
|
90
|
+
by_hour: {},
|
|
91
|
+
});
|
|
92
|
+
/** A zeroed counter block. */
|
|
93
|
+
function freshDeliveryCounters() {
|
|
94
|
+
const distance = { sum_meters: 0, count: 0 };
|
|
95
|
+
for (const bucket of MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_DISTANCE_BUCKETS)
|
|
96
|
+
distance[bucket.key] = 0;
|
|
97
|
+
return {
|
|
98
|
+
adoption: {
|
|
99
|
+
delivery_order_count: 0,
|
|
100
|
+
delivered_via_app_count: 0,
|
|
101
|
+
off_app_count: 0,
|
|
102
|
+
tracking_enabled_count: 0,
|
|
103
|
+
proof_pickup_count: 0,
|
|
104
|
+
proof_dropoff_count: 0,
|
|
105
|
+
},
|
|
106
|
+
deliveries: {
|
|
107
|
+
count: 0,
|
|
108
|
+
pending_count: 0,
|
|
109
|
+
assigned_count: 0,
|
|
110
|
+
in_progress_count: 0,
|
|
111
|
+
completed_count: 0,
|
|
112
|
+
cancelled_count: 0,
|
|
113
|
+
cancel_reason_count: 0,
|
|
114
|
+
},
|
|
115
|
+
money: {
|
|
116
|
+
rider_revenue_amount: 0,
|
|
117
|
+
rider_revenue_count: 0,
|
|
118
|
+
net_sale_amount: 0,
|
|
119
|
+
collected_amount: 0,
|
|
120
|
+
delivery_charge_amount: 0,
|
|
121
|
+
delivery_charge_count: 0,
|
|
122
|
+
tip_amount: 0,
|
|
123
|
+
discount_amount: 0,
|
|
124
|
+
refund_amount: 0,
|
|
125
|
+
tax_amount: 0,
|
|
126
|
+
},
|
|
127
|
+
distance: distance,
|
|
128
|
+
riders: {},
|
|
129
|
+
areas: {},
|
|
130
|
+
timing: {
|
|
131
|
+
graded_count: 0,
|
|
132
|
+
dispatch_lag_sum_minutes: 0,
|
|
133
|
+
complete_sum_minutes: 0,
|
|
134
|
+
total_sum_minutes: 0,
|
|
135
|
+
exact_completion_count: 0,
|
|
136
|
+
assignment_sum_minutes: 0,
|
|
137
|
+
assignment_count: 0,
|
|
138
|
+
pickup_wait_sum_minutes: 0,
|
|
139
|
+
pickup_wait_count: 0,
|
|
140
|
+
transit_sum_minutes: 0,
|
|
141
|
+
transit_count: 0,
|
|
142
|
+
cancel_sum_minutes: 0,
|
|
143
|
+
cancel_count: 0,
|
|
144
|
+
cancelled_after_pickup_count: 0,
|
|
145
|
+
status_updates_sum: 0,
|
|
146
|
+
status_updates_count: 0,
|
|
147
|
+
promise_known_count: 0,
|
|
148
|
+
on_time_count: 0,
|
|
149
|
+
late_count: 0,
|
|
150
|
+
late_minutes_sum: 0,
|
|
151
|
+
},
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
/** Which fixed distance bucket a metre value falls in. */
|
|
155
|
+
function deliveryDistanceBucketKey(meters) {
|
|
156
|
+
const value = Math.abs(Number(meters) || 0);
|
|
157
|
+
for (const bucket of MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_DISTANCE_BUCKETS) {
|
|
158
|
+
if (value >= bucket.min && (bucket.max == null || value < bucket.max))
|
|
159
|
+
return bucket.key;
|
|
160
|
+
}
|
|
161
|
+
const last = MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_DISTANCE_BUCKETS[MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_DISTANCE_BUCKETS.length - 1];
|
|
162
|
+
return last.key;
|
|
163
|
+
}
|
|
164
|
+
/** A fresh buffer. */
|
|
165
|
+
function freshDeliveryAccumulator() {
|
|
166
|
+
return {
|
|
167
|
+
counters: freshDeliveryCounters(),
|
|
168
|
+
deliveryOrderIds: new Set(),
|
|
169
|
+
deliveredOrderIds: new Set(),
|
|
170
|
+
watermark: null,
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
const minutesBetween = (from, to) => {
|
|
174
|
+
const a = from == null ? NaN : new Date(from).getTime();
|
|
175
|
+
const b = to == null ? NaN : new Date(to).getTime();
|
|
176
|
+
if (Number.isNaN(a) || Number.isNaN(b))
|
|
177
|
+
return null;
|
|
178
|
+
return Math.round((b - a) / 60000);
|
|
179
|
+
};
|
|
180
|
+
const laterOf = (current, candidate) => {
|
|
181
|
+
const time = candidate == null ? NaN : new Date(candidate).getTime();
|
|
182
|
+
if (Number.isNaN(time))
|
|
183
|
+
return current;
|
|
184
|
+
if (current == null || time > current.getTime())
|
|
185
|
+
return new Date(time);
|
|
186
|
+
return current;
|
|
187
|
+
};
|
|
188
|
+
const earlierOf = (current, candidate) => {
|
|
189
|
+
const time = candidate == null ? NaN : new Date(candidate).getTime();
|
|
190
|
+
if (Number.isNaN(time))
|
|
191
|
+
return current;
|
|
192
|
+
if (current == null || time < current.getTime())
|
|
193
|
+
return new Date(time);
|
|
194
|
+
return current;
|
|
195
|
+
};
|
|
196
|
+
/** True when an order is a DELIVERY order (it has delivery details). */
|
|
197
|
+
function isDeliveryOrder(order) {
|
|
198
|
+
return order?.delivery_details != null;
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Consumes ONE delivery ORDER - the ADOPTION half of the join.
|
|
202
|
+
*
|
|
203
|
+
* Order-side money is counted HERE rather than on the delivery, because a cancelled
|
|
204
|
+
* delivery must not lose the order figures the operator recognises.
|
|
205
|
+
*/
|
|
206
|
+
function addDeliveryOrder(acc, order) {
|
|
207
|
+
if (acc == null || order == null)
|
|
208
|
+
return;
|
|
209
|
+
const orderId = order._id == null ? null : String(order._id);
|
|
210
|
+
if (orderId == null)
|
|
211
|
+
return;
|
|
212
|
+
if (acc.deliveryOrderIds.has(orderId))
|
|
213
|
+
return;
|
|
214
|
+
acc.deliveryOrderIds.add(orderId);
|
|
215
|
+
const counters = acc.counters;
|
|
216
|
+
counters.adoption.delivery_order_count += 1;
|
|
217
|
+
const details = order.delivery_details ?? {};
|
|
218
|
+
counters.money.net_sale_amount += Number(order.net_sale_amount ?? order.amount_earned) || 0;
|
|
219
|
+
counters.money.collected_amount += Number(order.amount_collected) || 0;
|
|
220
|
+
counters.money.tip_amount += Number(order.tip_amount) || 0;
|
|
221
|
+
counters.money.discount_amount += Number(order.total_discount_applied) || 0;
|
|
222
|
+
counters.money.refund_amount += Number(order.amount_refunded) || 0;
|
|
223
|
+
counters.money.tax_amount += (Number(order.gst_amount) || 0) + (Number(order.tax_amount) || 0);
|
|
224
|
+
// `delivery_cost` is the field IOrderDeliveryDetails ACTUALLY declares; the other two
|
|
225
|
+
// names are tolerated fallbacks. Reading the wrong one silently reported every charge
|
|
226
|
+
// as ZERO while the statement row (which used the right field) showed the real value -
|
|
227
|
+
// an inconsistency the formatter test caught.
|
|
228
|
+
const charge = Number(details.delivery_cost ?? details.delivery_charge ?? details.delivery_charge_amount) || 0;
|
|
229
|
+
if (charge !== 0) {
|
|
230
|
+
counters.money.delivery_charge_amount += charge;
|
|
231
|
+
counters.money.delivery_charge_count += 1;
|
|
232
|
+
}
|
|
233
|
+
acc.watermark = laterOf(acc.watermark, order.updatedAt ?? order.createdAt);
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
236
|
+
* Consumes ONE delivery document - the APP-SIDE half of the join.
|
|
237
|
+
*
|
|
238
|
+
* `order` may be null (the order was not staged): the delivery still counts toward
|
|
239
|
+
* adoption and its own fields, but the order-derived money and the area cannot be
|
|
240
|
+
* attributed, so it lands in the UNKNOWN bucket.
|
|
241
|
+
*/
|
|
242
|
+
function addDelivery(acc, delivery, order, key) {
|
|
243
|
+
var _a, _b;
|
|
244
|
+
if (acc == null || delivery == null)
|
|
245
|
+
return;
|
|
246
|
+
const counters = acc.counters;
|
|
247
|
+
const orderId = delivery.order_id == null ? null : String(delivery.order_id);
|
|
248
|
+
if (orderId != null)
|
|
249
|
+
acc.deliveredOrderIds.add(orderId);
|
|
250
|
+
counters.deliveries.count += 1;
|
|
251
|
+
const status = String(delivery.status ?? '');
|
|
252
|
+
if (status === delivery_1.DELIVERY_STATUS_ENUM.PENDING)
|
|
253
|
+
counters.deliveries.pending_count += 1;
|
|
254
|
+
else if (status === delivery_1.DELIVERY_STATUS_ENUM.ASSIGNED)
|
|
255
|
+
counters.deliveries.assigned_count += 1;
|
|
256
|
+
else if (status === delivery_1.DELIVERY_STATUS_ENUM.IN_PROGRESS)
|
|
257
|
+
counters.deliveries.in_progress_count += 1;
|
|
258
|
+
else if (status === delivery_1.DELIVERY_STATUS_ENUM.COMPLETED)
|
|
259
|
+
counters.deliveries.completed_count += 1;
|
|
260
|
+
else if (status === delivery_1.DELIVERY_STATUS_ENUM.CANCELLED)
|
|
261
|
+
counters.deliveries.cancelled_count += 1;
|
|
262
|
+
if (status === delivery_1.DELIVERY_STATUS_ENUM.CANCELLED && delivery.cancel_reason != null) {
|
|
263
|
+
counters.deliveries.cancel_reason_count += 1;
|
|
264
|
+
}
|
|
265
|
+
if (delivery.tracking_enabled === true)
|
|
266
|
+
counters.adoption.tracking_enabled_count += 1;
|
|
267
|
+
if (delivery.pickup_food_image_url != null)
|
|
268
|
+
counters.adoption.proof_pickup_count += 1;
|
|
269
|
+
if (delivery.dropoff_food_image_url != null)
|
|
270
|
+
counters.adoption.proof_dropoff_count += 1;
|
|
271
|
+
// Only a FINAL snapshot is payout. A PENDING snapshot is an estimate shown to
|
|
272
|
+
// the rider before completion and must not inflate the materialized report.
|
|
273
|
+
const earnings = delivery.rider_earnings;
|
|
274
|
+
const revenue = Number(earnings != null ? (earnings.status === 'FINAL' ? earnings.amount : 0) : delivery.rider_revenue);
|
|
275
|
+
const hasRevenue = Number.isFinite(revenue);
|
|
276
|
+
if (hasRevenue) {
|
|
277
|
+
counters.money.rider_revenue_amount += revenue;
|
|
278
|
+
counters.money.rider_revenue_count += 1;
|
|
279
|
+
}
|
|
280
|
+
const meters = Number(delivery.distance_in_meters_from_store) || 0;
|
|
281
|
+
counters.distance.sum_meters += meters;
|
|
282
|
+
counters.distance.count += 1;
|
|
283
|
+
const bucketKey = deliveryDistanceBucketKey(meters);
|
|
284
|
+
const distanceRecord = counters.distance;
|
|
285
|
+
distanceRecord[bucketKey] = (distanceRecord[bucketKey] ?? 0) + 1;
|
|
286
|
+
// ---- the bounded rider leaderboard ----
|
|
287
|
+
const riderId = delivery.rider_id == null ? null : String(delivery.rider_id);
|
|
288
|
+
if (riderId != null) {
|
|
289
|
+
counters.riders ?? (counters.riders = {});
|
|
290
|
+
const row = ((_a = counters.riders)[riderId] ?? (_a[riderId] = emptyRiderRow(delivery.rider_name == null ? null : String(delivery.rider_name))));
|
|
291
|
+
row.count += 1;
|
|
292
|
+
if (status === delivery_1.DELIVERY_STATUS_ENUM.COMPLETED)
|
|
293
|
+
row.completed_count += 1;
|
|
294
|
+
else if (status === delivery_1.DELIVERY_STATUS_ENUM.CANCELLED)
|
|
295
|
+
row.cancelled_count += 1;
|
|
296
|
+
else if (status === delivery_1.DELIVERY_STATUS_ENUM.IN_PROGRESS)
|
|
297
|
+
row.in_progress_count += 1;
|
|
298
|
+
if (hasRevenue)
|
|
299
|
+
row.rider_revenue_amount += revenue;
|
|
300
|
+
row.distance_sum_meters += meters;
|
|
301
|
+
row.first_delivery_at = earlierOf(row.first_delivery_at, delivery.createdAt);
|
|
302
|
+
row.last_delivery_at = laterOf(row.last_delivery_at, delivery.createdAt);
|
|
303
|
+
}
|
|
304
|
+
// ---- the bounded area heat map (city from the JOIN) ----
|
|
305
|
+
const parsed = parseMaterializedDeliveryKey(key);
|
|
306
|
+
const city = parsed == null ? exports.DELIVERY_UNKNOWN_TOKEN : parsed.city;
|
|
307
|
+
counters.areas ?? (counters.areas = {});
|
|
308
|
+
const area = ((_b = counters.areas)[city] ?? (_b[city] = emptyAreaRow()));
|
|
309
|
+
area.count += 1;
|
|
310
|
+
if (status === delivery_1.DELIVERY_STATUS_ENUM.COMPLETED)
|
|
311
|
+
area.completed_count += 1;
|
|
312
|
+
else if (status === delivery_1.DELIVERY_STATUS_ENUM.CANCELLED)
|
|
313
|
+
area.cancelled_count += 1;
|
|
314
|
+
if (hasRevenue)
|
|
315
|
+
area.rider_revenue_amount += revenue;
|
|
316
|
+
area.distance_sum_meters += meters;
|
|
317
|
+
const hour = hourKeyOf(delivery);
|
|
318
|
+
if (hour != null)
|
|
319
|
+
area.by_hour[hour] = (area.by_hour[hour] ?? 0) + 1;
|
|
320
|
+
// ---- timing ----
|
|
321
|
+
const timing = (counters.timing ?? (counters.timing = freshDeliveryCounters().timing));
|
|
322
|
+
let graded = false;
|
|
323
|
+
const orderCreatedAt = order?.createdAt ?? null;
|
|
324
|
+
const dispatchLag = minutesBetween(orderCreatedAt, delivery.createdAt);
|
|
325
|
+
if (dispatchLag != null) {
|
|
326
|
+
timing.dispatch_lag_sum_minutes += dispatchLag;
|
|
327
|
+
graded = true;
|
|
328
|
+
}
|
|
329
|
+
if (status === delivery_1.DELIVERY_STATUS_ENUM.COMPLETED) {
|
|
330
|
+
// `delivered_at` is EXACT once the capture has run; before that the only available
|
|
331
|
+
// instant is `updatedAt`, which moves on ANY later mutation - so the report records
|
|
332
|
+
// WHICH one it used rather than presenting a proxy as exact.
|
|
333
|
+
const exact = delivery.delivered_at != null;
|
|
334
|
+
const completedAt = exact ? delivery.delivered_at : delivery.updatedAt;
|
|
335
|
+
const complete = minutesBetween(delivery.createdAt, completedAt);
|
|
336
|
+
if (complete != null) {
|
|
337
|
+
timing.complete_sum_minutes += complete;
|
|
338
|
+
graded = true;
|
|
339
|
+
if (exact)
|
|
340
|
+
timing.exact_completion_count += 1;
|
|
341
|
+
}
|
|
342
|
+
const total = minutesBetween(orderCreatedAt, completedAt);
|
|
343
|
+
if (total != null)
|
|
344
|
+
timing.total_sum_minutes += total;
|
|
345
|
+
// Explicit ETA only. ASAP orders need tenant settings the compile does not
|
|
346
|
+
// receive, so they stay UNMEASURED rather than being given an invented promise.
|
|
347
|
+
const expectedRaw = delivery.expected_delivery_at ?? order?.delivery_details?.estimated_delivery_time;
|
|
348
|
+
const deliveredRaw = delivery.delivered_at;
|
|
349
|
+
if (expectedRaw != null && deliveredRaw != null) {
|
|
350
|
+
const expected = new Date(expectedRaw).getTime();
|
|
351
|
+
const delivered = new Date(deliveredRaw).getTime();
|
|
352
|
+
if (!Number.isNaN(expected) && !Number.isNaN(delivered)) {
|
|
353
|
+
timing.promise_known_count += 1;
|
|
354
|
+
if (delivered <= expected) {
|
|
355
|
+
timing.on_time_count += 1;
|
|
356
|
+
}
|
|
357
|
+
else {
|
|
358
|
+
timing.late_count += 1;
|
|
359
|
+
timing.late_minutes_sum += Math.round((delivered - expected) / 60000);
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
if (graded)
|
|
365
|
+
timing.graded_count += 1;
|
|
366
|
+
// ---- captured stage timings / churn ----
|
|
367
|
+
const assignment = minutesBetween(delivery.createdAt, delivery.assigned_at);
|
|
368
|
+
if (assignment != null) {
|
|
369
|
+
timing.assignment_sum_minutes += assignment;
|
|
370
|
+
timing.assignment_count += 1;
|
|
371
|
+
}
|
|
372
|
+
const pickupWait = minutesBetween(delivery.assigned_at, delivery.picked_up_at);
|
|
373
|
+
if (pickupWait != null) {
|
|
374
|
+
timing.pickup_wait_sum_minutes += pickupWait;
|
|
375
|
+
timing.pickup_wait_count += 1;
|
|
376
|
+
}
|
|
377
|
+
const transit = minutesBetween(delivery.picked_up_at, delivery.delivered_at);
|
|
378
|
+
if (transit != null) {
|
|
379
|
+
timing.transit_sum_minutes += transit;
|
|
380
|
+
timing.transit_count += 1;
|
|
381
|
+
}
|
|
382
|
+
const cancel = minutesBetween(delivery.createdAt, delivery.cancelled_at);
|
|
383
|
+
if (cancel != null) {
|
|
384
|
+
timing.cancel_sum_minutes += cancel;
|
|
385
|
+
timing.cancel_count += 1;
|
|
386
|
+
}
|
|
387
|
+
if (status === delivery_1.DELIVERY_STATUS_ENUM.CANCELLED && delivery.picked_up_at != null) {
|
|
388
|
+
timing.cancelled_after_pickup_count += 1;
|
|
389
|
+
}
|
|
390
|
+
if (delivery.status_updated_count != null) {
|
|
391
|
+
timing.status_updates_sum += Number(delivery.status_updated_count) || 0;
|
|
392
|
+
timing.status_updates_count += 1;
|
|
393
|
+
}
|
|
394
|
+
acc.watermark = laterOf(acc.watermark, delivery.updatedAt ?? delivery.createdAt);
|
|
395
|
+
}
|
|
396
|
+
/** `HH` of a delivery, from the local hour when present. */
|
|
397
|
+
function hourKeyOf(delivery) {
|
|
398
|
+
const explicit = delivery.localHour;
|
|
399
|
+
if (typeof explicit === 'number' && Number.isFinite(explicit)) {
|
|
400
|
+
return String(Math.max(0, Math.min(23, Math.floor(explicit)))).padStart(2, '0');
|
|
401
|
+
}
|
|
402
|
+
const raw = delivery.createdAt;
|
|
403
|
+
if (raw == null)
|
|
404
|
+
return null;
|
|
405
|
+
const date = new Date(raw);
|
|
406
|
+
if (Number.isNaN(date.getTime()))
|
|
407
|
+
return null;
|
|
408
|
+
return String(date.getHours()).padStart(2, '0');
|
|
409
|
+
}
|
|
410
|
+
/**
|
|
411
|
+
* Computes the DERIVED adoption figures and prunes the bounded maps.
|
|
412
|
+
*
|
|
413
|
+
* Call ONCE per key, after both stages have been consumed. `off_app_count` is a set
|
|
414
|
+
* difference, so an order reassigned to a second rider is NOT counted as off-app even
|
|
415
|
+
* though there are more deliveries than orders.
|
|
416
|
+
*/
|
|
417
|
+
function finalizeDeliveryAccumulator(acc) {
|
|
418
|
+
const counters = acc.counters;
|
|
419
|
+
const deliveredOrders = [...acc.deliveredOrderIds].filter((id) => acc.deliveryOrderIds.has(id)).length;
|
|
420
|
+
counters.adoption.delivered_via_app_count = deliveredOrders;
|
|
421
|
+
counters.adoption.off_app_count = Math.max(0, acc.deliveryOrderIds.size - deliveredOrders);
|
|
422
|
+
counters.riders = pruneMap(counters.riders, MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_RIDER_LIMIT, (row) => Number(row.count) || 0);
|
|
423
|
+
counters.areas = pruneMap(counters.areas, MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_AREA_LIMIT, (row) => Number(row.count) || 0);
|
|
424
|
+
return counters;
|
|
425
|
+
}
|
|
426
|
+
/** Keeps the N busiest entries, so a document stays bounded. */
|
|
427
|
+
function pruneMap(source, limit, weightOf) {
|
|
428
|
+
if (source == null)
|
|
429
|
+
return null;
|
|
430
|
+
const entries = Object.entries(source);
|
|
431
|
+
if (entries.length <= limit)
|
|
432
|
+
return source;
|
|
433
|
+
entries.sort((a, b) => weightOf(b[1]) - weightOf(a[1]));
|
|
434
|
+
const kept = {};
|
|
435
|
+
for (const [key, value] of entries.slice(0, limit))
|
|
436
|
+
kept[key] = value;
|
|
437
|
+
return kept;
|
|
438
|
+
}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { IMaterializedDeliveryEntry, IMaterializedTenantDeliveryEntries } from '../../schemas/types/materialized_tenant_delivery_entries';
|
|
2
|
+
import { IMaterializedDeliveryCounters, IMaterializedTenantDeliveryReport } from '../../schemas/types/materialized_tenant_delivery_reports';
|
|
3
|
+
/**
|
|
4
|
+
* M4 close-day helpers.
|
|
5
|
+
*
|
|
6
|
+
* ## Period counters are RE-FOLDED, never patched
|
|
7
|
+
*
|
|
8
|
+
* The delivery fold is not a pure sum: the rider leaderboard carries MIN/MAX TENURE
|
|
9
|
+
* BOUNDS (`first_delivery_at`, `last_delivery_at`). You cannot subtract a minimum, so
|
|
10
|
+
* removing a day by decrementing its contribution is impossible - every touched period is
|
|
11
|
+
* rebuilt from its whole day set, exactly as in the prep time and cash reports.
|
|
12
|
+
*
|
|
13
|
+
* ## The watermark comes from the FOLDED DAYS
|
|
14
|
+
*
|
|
15
|
+
* A folded document that inherited the STORED document watermark would look unchanged to
|
|
16
|
+
* the write guard and be skipped forever, freezing the period at its first closed day.
|
|
17
|
+
* That bug shipped once in the prep time report; it is designed out here from the start.
|
|
18
|
+
*/
|
|
19
|
+
/** Period scopes this report materializes (everything but the day scope). */
|
|
20
|
+
export declare const MATERIALIZED_DELIVERY_PERIOD_SCOPES: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_REPORT_SCOPE_ENUM[];
|
|
21
|
+
/** True when the scope is the plain day scope. */
|
|
22
|
+
export declare const isMaterializedDeliveryDayScope: (scopeContext: string) => boolean;
|
|
23
|
+
/**
|
|
24
|
+
* Merges TWO period entry sections, keyed on `entry_key`.
|
|
25
|
+
*
|
|
26
|
+
* Rows are deduplicated by identity: a source delivery belongs to exactly one day, so the
|
|
27
|
+
* same `entry_key` twice means the fold saw it twice.
|
|
28
|
+
*/
|
|
29
|
+
export declare function mergeMaterializedDeliveryEntrySections(target: Record<string, {
|
|
30
|
+
rows: IMaterializedDeliveryEntry[];
|
|
31
|
+
}> | null, source: Record<string, {
|
|
32
|
+
rows: IMaterializedDeliveryEntry[];
|
|
33
|
+
}> | null): Record<string, {
|
|
34
|
+
rows: IMaterializedDeliveryEntry[];
|
|
35
|
+
}>;
|
|
36
|
+
/** True when the stored document already carries this exact content. */
|
|
37
|
+
export declare function needsMaterializedDeliveryReportWrite(existing: IMaterializedTenantDeliveryReport | null | undefined, next: IMaterializedTenantDeliveryReport): boolean;
|
|
38
|
+
/** True when the stored entry document already carries these exact rows. */
|
|
39
|
+
export declare function needsMaterializedDeliveryEntriesWrite(existing: IMaterializedTenantDeliveryEntries | null | undefined, next: IMaterializedTenantDeliveryEntries): boolean;
|
|
40
|
+
/** Folds the counters of every day document belonging to one period scope. */
|
|
41
|
+
export declare function foldMaterializedDeliveryPeriodCounters(input: {
|
|
42
|
+
periodScope: string;
|
|
43
|
+
periodScopeField: string;
|
|
44
|
+
dayDocuments: IMaterializedTenantDeliveryReport[];
|
|
45
|
+
}): Record<string, IMaterializedDeliveryCounters>;
|
|
46
|
+
/** Folds the statement rows of every day document belonging to one period scope. */
|
|
47
|
+
export declare function foldMaterializedDeliveryPeriodRows(input: {
|
|
48
|
+
periodScope: string;
|
|
49
|
+
periodScopeField: string;
|
|
50
|
+
dayDocuments: IMaterializedTenantDeliveryEntries[];
|
|
51
|
+
}): {
|
|
52
|
+
sections: Record<string, {
|
|
53
|
+
rows: IMaterializedDeliveryEntry[];
|
|
54
|
+
}>;
|
|
55
|
+
offApp: number;
|
|
56
|
+
};
|
|
57
|
+
/** One plan write: the document plus its iteration history row. */
|
|
58
|
+
export interface IMaterializedDeliveryCloseDayWrite<T> {
|
|
59
|
+
report: T;
|
|
60
|
+
iteration: {
|
|
61
|
+
report_type: string;
|
|
62
|
+
report_id: string;
|
|
63
|
+
iteration: number;
|
|
64
|
+
schema_version: number;
|
|
65
|
+
reason: string;
|
|
66
|
+
snapshot: unknown;
|
|
67
|
+
createdAt: Date;
|
|
68
|
+
updatedAt: Date;
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
export interface ITenantDeliveryCloseDayPlan {
|
|
72
|
+
writes: IMaterializedDeliveryCloseDayWrite<IMaterializedTenantDeliveryReport>[];
|
|
73
|
+
entryWrites: IMaterializedDeliveryCloseDayWrite<IMaterializedTenantDeliveryEntries>[];
|
|
74
|
+
staleDocuments: IMaterializedTenantDeliveryReport[];
|
|
75
|
+
staleEntryDocuments: IMaterializedTenantDeliveryEntries[];
|
|
76
|
+
skippedDocuments: IMaterializedTenantDeliveryReport[];
|
|
77
|
+
skippedEntryDocuments: IMaterializedTenantDeliveryEntries[];
|
|
78
|
+
}
|
|
79
|
+
export interface IBuildTenantDeliveryCloseDayPlanInput {
|
|
80
|
+
tenantId: string;
|
|
81
|
+
reports: IMaterializedTenantDeliveryReport[];
|
|
82
|
+
entries: IMaterializedTenantDeliveryEntries[];
|
|
83
|
+
localDate?: string | null;
|
|
84
|
+
existing?: IMaterializedTenantDeliveryReport[];
|
|
85
|
+
existingEntries?: IMaterializedTenantDeliveryEntries[];
|
|
86
|
+
reason: string;
|
|
87
|
+
computedAt?: Date;
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Builds the close-day plan for ONE tenant-day.
|
|
91
|
+
*
|
|
92
|
+
* The DAY scope comes from the compile. Every PERIOD scope the day touches is RE-FOLDED
|
|
93
|
+
* from its whole day set, and the touched set is the union of the closed day periods AND
|
|
94
|
+
* every removed day periods - emptying a day must clear it from the periods it used to
|
|
95
|
+
* belong to.
|
|
96
|
+
*/
|
|
97
|
+
export declare function buildTenantDeliveryCloseDayPlan(input: IBuildTenantDeliveryCloseDayPlanInput | null | undefined): ITenantDeliveryCloseDayPlan | null;
|