@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,182 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.MATERIALIZED_SALES_COMPARISON_COMPILED_SCOPES = void 0;
|
|
7
|
+
exports.compileTenantSalesComparisonReports = compileTenantSalesComparisonReports;
|
|
8
|
+
const mongoose_1 = __importDefault(require("mongoose"));
|
|
9
|
+
const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
|
|
10
|
+
const materialized_sales_comparison_accumulator_helpers_1 = require("./materialized-sales-comparison-accumulator-helpers");
|
|
11
|
+
const key_helpers_1 = require("./key-helpers");
|
|
12
|
+
const scope_helpers_1 = require("./scope-helpers");
|
|
13
|
+
const watermarkOf = (order, fallback) => {
|
|
14
|
+
const raw = order?.updatedAt;
|
|
15
|
+
const time = raw == null ? NaN : new Date(raw).getTime();
|
|
16
|
+
return Number.isNaN(time) ? fallback : new Date(time);
|
|
17
|
+
};
|
|
18
|
+
/** Newest-first order of the drill-down rows (then by id for a stable page). */
|
|
19
|
+
function compareEntryDescending(a, b) {
|
|
20
|
+
const byTime = new Date(b.time).getTime() - new Date(a.time).getTime();
|
|
21
|
+
if (byTime !== 0)
|
|
22
|
+
return byTime;
|
|
23
|
+
// Same instant: `order_id` ASC, matching the page cursor.
|
|
24
|
+
return a.order_id < b.order_id ? -1 : a.order_id > b.order_id ? 1 : 0;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Compiles one settled tenant-day.
|
|
28
|
+
*
|
|
29
|
+
* Returns EMPTY arrays (never null) when the day has no settled orders: an
|
|
30
|
+
* emptied day must produce no day document, and the close-day plan deletes the
|
|
31
|
+
* stored one.
|
|
32
|
+
*/
|
|
33
|
+
function compileTenantSalesComparisonReports(input) {
|
|
34
|
+
if (input == null)
|
|
35
|
+
return null;
|
|
36
|
+
const { tenantId, brandId, localDate, orders, computedAt } = input;
|
|
37
|
+
if (typeof tenantId !== 'string' || tenantId.length === 0)
|
|
38
|
+
return null;
|
|
39
|
+
if (typeof brandId !== 'string' || brandId.length === 0)
|
|
40
|
+
return null;
|
|
41
|
+
if (typeof localDate !== 'string' || localDate.length === 0)
|
|
42
|
+
return null;
|
|
43
|
+
if (!Array.isArray(orders))
|
|
44
|
+
return null;
|
|
45
|
+
if (!(computedAt instanceof Date) || Number.isNaN(computedAt.getTime()))
|
|
46
|
+
return null;
|
|
47
|
+
const dayIndex = (0, scope_helpers_1.getDayIndexFromLocalDate)(localDate);
|
|
48
|
+
if (dayIndex == null)
|
|
49
|
+
return null;
|
|
50
|
+
const byKey = new Map();
|
|
51
|
+
const rowsByKey = new Map();
|
|
52
|
+
let watermark = null;
|
|
53
|
+
let contributingOrders = 0;
|
|
54
|
+
let skippedUnsettledOrders = 0;
|
|
55
|
+
let skippedForeignOrders = 0;
|
|
56
|
+
let skippedUnkeyableOrders = 0;
|
|
57
|
+
for (const order of orders) {
|
|
58
|
+
if (order == null)
|
|
59
|
+
continue;
|
|
60
|
+
// Soft-deleted orders are never materialized (they would reappear after a
|
|
61
|
+
// delete unless the close recompiles the day — which it does).
|
|
62
|
+
if (order.is_deleted === true)
|
|
63
|
+
continue;
|
|
64
|
+
// Foreign tenants never leak into this tenant's documents.
|
|
65
|
+
if (order.tenant_id != null && String(order.tenant_id) !== tenantId)
|
|
66
|
+
continue;
|
|
67
|
+
const settledLocalDate = (0, materialized_sales_comparison_accumulator_helpers_1.getSalesComparisonSettledLocalDate)(order, input.gmtOffset);
|
|
68
|
+
if (settledLocalDate == null) {
|
|
69
|
+
skippedUnsettledOrders += 1;
|
|
70
|
+
continue;
|
|
71
|
+
}
|
|
72
|
+
if (settledLocalDate !== localDate) {
|
|
73
|
+
skippedForeignOrders += 1;
|
|
74
|
+
continue;
|
|
75
|
+
}
|
|
76
|
+
const key = (0, key_helpers_1.buildMaterializedReportKey)([String(order.order_status ?? ''), String(order.platform ?? '')]);
|
|
77
|
+
// A key with a reserved character (or a missing component) cannot be a
|
|
78
|
+
// Mongo field name — the order is skipped rather than silently mis-keyed.
|
|
79
|
+
if (key == null) {
|
|
80
|
+
skippedUnkeyableOrders += 1;
|
|
81
|
+
continue;
|
|
82
|
+
}
|
|
83
|
+
let counters = byKey.get(key);
|
|
84
|
+
if (counters == null) {
|
|
85
|
+
counters = (0, materialized_sales_comparison_accumulator_helpers_1.createEmptySalesComparisonCounters)();
|
|
86
|
+
byKey.set(key, counters);
|
|
87
|
+
}
|
|
88
|
+
(0, materialized_sales_comparison_accumulator_helpers_1.addOrderToSalesComparisonCounters)(counters, order);
|
|
89
|
+
const settledAt = new Date(order.order_settled_at);
|
|
90
|
+
const gross = (0, materialized_sales_comparison_accumulator_helpers_1.getOrderGrossAmountCents)(order);
|
|
91
|
+
const discount = (0, materialized_sales_comparison_accumulator_helpers_1.getOrderDiscountAmountCents)(order);
|
|
92
|
+
const row = {
|
|
93
|
+
order_id: String(order._id ?? ''),
|
|
94
|
+
order_number: order.order_number == null ? null : Number(order.order_number),
|
|
95
|
+
time: settledAt.toISOString(),
|
|
96
|
+
order_status: String(order.order_status ?? ''),
|
|
97
|
+
platform: String(order.platform ?? ''),
|
|
98
|
+
net_amount: gross - discount,
|
|
99
|
+
discount_amount: discount,
|
|
100
|
+
item_count: (0, materialized_sales_comparison_accumulator_helpers_1.getOrderItemCount)(order),
|
|
101
|
+
};
|
|
102
|
+
const bucket = rowsByKey.get(key);
|
|
103
|
+
if (bucket == null)
|
|
104
|
+
rowsByKey.set(key, [row]);
|
|
105
|
+
else
|
|
106
|
+
bucket.push(row);
|
|
107
|
+
const orderWatermark = watermarkOf(order, computedAt);
|
|
108
|
+
if (watermark == null || orderWatermark.getTime() > watermark.getTime()) {
|
|
109
|
+
watermark = orderWatermark;
|
|
110
|
+
}
|
|
111
|
+
contributingOrders += 1;
|
|
112
|
+
}
|
|
113
|
+
if (byKey.size === 0) {
|
|
114
|
+
return {
|
|
115
|
+
reports: [],
|
|
116
|
+
entries: [],
|
|
117
|
+
contributingOrders,
|
|
118
|
+
skippedUnsettledOrders,
|
|
119
|
+
skippedForeignOrders,
|
|
120
|
+
skippedUnkeyableOrders,
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
const sourceWatermark = watermark ?? computedAt;
|
|
124
|
+
const salesCounters = {};
|
|
125
|
+
const counterRows = [];
|
|
126
|
+
const entrySections = {};
|
|
127
|
+
for (const key of [...byKey.keys()].sort()) {
|
|
128
|
+
const counters = byKey.get(key);
|
|
129
|
+
salesCounters[key] = counters;
|
|
130
|
+
counterRows.push({ key, counters });
|
|
131
|
+
const rows = (rowsByKey.get(key) ?? []).slice().sort(compareEntryDescending);
|
|
132
|
+
if (rows.length > 0)
|
|
133
|
+
entrySections[key] = { rows };
|
|
134
|
+
}
|
|
135
|
+
const reports = [
|
|
136
|
+
{
|
|
137
|
+
_id: new mongoose_1.default.Types.ObjectId().toHexString(),
|
|
138
|
+
tenant_id: tenantId,
|
|
139
|
+
brand_id: brandId,
|
|
140
|
+
scope_context: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
|
|
141
|
+
scope_field: localDate,
|
|
142
|
+
day_index: dayIndex,
|
|
143
|
+
sale_type_key_filters: [...MATERIALIZED_REPORTS_1.SALES_COMPARISON_KEY_FILTERS],
|
|
144
|
+
sales_counters: salesCounters,
|
|
145
|
+
sales_counter_rows: counterRows,
|
|
146
|
+
schema_version: MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_SALES_COMPARISON_REPORTS_SCHEMA_VERSION,
|
|
147
|
+
source_watermark: sourceWatermark,
|
|
148
|
+
computed_at: computedAt,
|
|
149
|
+
createdAt: computedAt,
|
|
150
|
+
updatedAt: computedAt,
|
|
151
|
+
iteration: 1,
|
|
152
|
+
},
|
|
153
|
+
];
|
|
154
|
+
const entries = [
|
|
155
|
+
{
|
|
156
|
+
_id: new mongoose_1.default.Types.ObjectId().toHexString(),
|
|
157
|
+
tenant_id: tenantId,
|
|
158
|
+
brand_id: brandId,
|
|
159
|
+
scope_context: MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE,
|
|
160
|
+
scope_field: localDate,
|
|
161
|
+
day_index: dayIndex,
|
|
162
|
+
sale_type_key_filters: [...MATERIALIZED_REPORTS_1.SALES_COMPARISON_KEY_FILTERS],
|
|
163
|
+
sales_entries: entrySections,
|
|
164
|
+
schema_version: MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_SALES_COMPARISON_ENTRIES_SCHEMA_VERSION,
|
|
165
|
+
source_watermark: sourceWatermark,
|
|
166
|
+
computed_at: computedAt,
|
|
167
|
+
createdAt: computedAt,
|
|
168
|
+
updatedAt: computedAt,
|
|
169
|
+
iteration: 1,
|
|
170
|
+
},
|
|
171
|
+
];
|
|
172
|
+
return {
|
|
173
|
+
reports,
|
|
174
|
+
entries,
|
|
175
|
+
contributingOrders,
|
|
176
|
+
skippedUnsettledOrders,
|
|
177
|
+
skippedForeignOrders,
|
|
178
|
+
skippedUnkeyableOrders,
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
/** The scopes this report materializes — exported for the close plan + tests. */
|
|
182
|
+
exports.MATERIALIZED_SALES_COMPARISON_COMPILED_SCOPES = [MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_DATE];
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { DAY_INDEX_ENUM } from '../../constants/ENUMS';
|
|
2
|
+
import { CASH_IN_OUT_REF_ENUM } from '../../constants/enums/cash';
|
|
3
|
+
import { IMaterializedTenantCashReport } from '../../schemas/types/materialized_tenant_cash_reports';
|
|
4
|
+
/**
|
|
5
|
+
* Frontend formatter for `materialized_tenant_cash_in_out_reports` (M3).
|
|
6
|
+
*
|
|
7
|
+
* RECONCILIATION-FIRST BY CONSTRUCTION. Ledger net is deliberately NOT equal to the
|
|
8
|
+
* operator movement total: it also contains the opening float, every reopen
|
|
9
|
+
* re-baseline and every over/short sweep. That is the single most likely source of a
|
|
10
|
+
* "the report is wrong" report, so the summary publishes all three nets AND the
|
|
11
|
+
* pieces that reconcile them, and the page renders the banner rather than leaving the
|
|
12
|
+
* reader to discover the difference.
|
|
13
|
+
*
|
|
14
|
+
* SIGN: `variance` is `expected - counted` per the write path, so POSITIVE = SHORT
|
|
15
|
+
* (under). `over_count` counts NEGATIVE variances ("over"). Getting this backwards
|
|
16
|
+
* inverts the meaning of the whole report, so it is stated here and in the schema.
|
|
17
|
+
*
|
|
18
|
+
* SCOPE: pass the documents for ONE scope level. The summary sums their counters, and
|
|
19
|
+
* the trend/weekday sections are built only from DAY documents - a period document has
|
|
20
|
+
* no single weekday, so those sections are null rather than guessed.
|
|
21
|
+
*/
|
|
22
|
+
/** Request-level filters. Scope selection itself is resolved server-side. */
|
|
23
|
+
export interface IFormattedCashInOutFilters {
|
|
24
|
+
/** Restrict to these drawers (matches the DRAWER_ID component of a key). */
|
|
25
|
+
drawer_ids?: string[] | null;
|
|
26
|
+
/** Restrict to these ref types (matches the REF_TYPE component of a key). */
|
|
27
|
+
ref_types?: CASH_IN_OUT_REF_ENUM[] | null;
|
|
28
|
+
/** When true, only rows/flows for reopens are counted in the breakdowns. */
|
|
29
|
+
reopens_only?: boolean | null;
|
|
30
|
+
}
|
|
31
|
+
export interface IFormattedCashInOutSummary {
|
|
32
|
+
cash_in: number;
|
|
33
|
+
cash_out: number;
|
|
34
|
+
ledger_net: number;
|
|
35
|
+
operator_net: number;
|
|
36
|
+
/** The reconciliation delta: the reopen re-baselines included in the ledger. */
|
|
37
|
+
reopen_amount: number;
|
|
38
|
+
opening_float: number;
|
|
39
|
+
count_out: number;
|
|
40
|
+
system_net: number;
|
|
41
|
+
movement_count: number;
|
|
42
|
+
expected_close: number;
|
|
43
|
+
counted_close: number;
|
|
44
|
+
/** SIGNED, `expected - counted`: POSITIVE = SHORT. */
|
|
45
|
+
variance: number;
|
|
46
|
+
/** Variance NEGATIVE = counted above expected. */
|
|
47
|
+
over_count: number;
|
|
48
|
+
/** Variance POSITIVE = counted below expected. */
|
|
49
|
+
short_count: number;
|
|
50
|
+
open_sessions: number;
|
|
51
|
+
session_count: number;
|
|
52
|
+
reopen_count: number;
|
|
53
|
+
unmatched_close_count: number;
|
|
54
|
+
}
|
|
55
|
+
export interface IFormattedCashInOutDrawerRow {
|
|
56
|
+
drawer_id: string;
|
|
57
|
+
drawer_name: string | null;
|
|
58
|
+
cash_in: number;
|
|
59
|
+
cash_out: number;
|
|
60
|
+
ledger_net: number;
|
|
61
|
+
variance: number;
|
|
62
|
+
session_count: number;
|
|
63
|
+
reopen_count: number;
|
|
64
|
+
}
|
|
65
|
+
export interface IFormattedCashInOutRefRow {
|
|
66
|
+
ref_type: CASH_IN_OUT_REF_ENUM;
|
|
67
|
+
in_amount: number;
|
|
68
|
+
out_amount: number;
|
|
69
|
+
count: number;
|
|
70
|
+
}
|
|
71
|
+
export interface IFormattedCashInOutTrendRow {
|
|
72
|
+
scope_field: string;
|
|
73
|
+
variance: number;
|
|
74
|
+
counted_close: number;
|
|
75
|
+
}
|
|
76
|
+
export interface IFormattedCashInOutWeekdayRow {
|
|
77
|
+
day_index: DAY_INDEX_ENUM;
|
|
78
|
+
variance: number;
|
|
79
|
+
ledger_net: number;
|
|
80
|
+
}
|
|
81
|
+
export interface IFormattedCashInOutPageData {
|
|
82
|
+
tenant_ids: string[];
|
|
83
|
+
summary: IFormattedCashInOutSummary;
|
|
84
|
+
by_drawer: IFormattedCashInOutDrawerRow[];
|
|
85
|
+
by_ref: IFormattedCashInOutRefRow[];
|
|
86
|
+
/** Per-day variance across the selection; null when no DAY documents were passed. */
|
|
87
|
+
variance_trend: IFormattedCashInOutTrendRow[] | null;
|
|
88
|
+
/** Per-weekday totals; null, like the trend, without DAY documents. */
|
|
89
|
+
weekday: IFormattedCashInOutWeekdayRow[] | null;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Formats cash documents into page data.
|
|
93
|
+
*
|
|
94
|
+
* `separate_view_per_tenant` yields one entry per tenant; otherwise every tenant is
|
|
95
|
+
* folded into a single brand view. Returns null on unusable input rather than an empty
|
|
96
|
+
* page, so the caller can tell "no data" from "malformed request".
|
|
97
|
+
*/
|
|
98
|
+
export declare function getFormattedTenantCashInOutReporting(docs: IMaterializedTenantCashReport[] | null | undefined, filters?: IFormattedCashInOutFilters | null, separate_view_per_tenant?: boolean): [IFormattedCashInOutPageData[], null] | null;
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.getFormattedTenantCashInOutReporting = getFormattedTenantCashInOutReporting;
|
|
4
|
+
const price_conversion_1 = require("../utils/price-conversion");
|
|
5
|
+
const materialized_cash_compile_helpers_1 = require("./materialized-cash-compile-helpers");
|
|
6
|
+
const materialized_cash_classification_helpers_1 = require("./materialized-cash-classification-helpers");
|
|
7
|
+
const materialized_cash_accumulator_helpers_1 = require("./materialized-cash-accumulator-helpers");
|
|
8
|
+
const toDecimal = (cents) => (0, price_conversion_1.convertPriceFromCents)(cents ?? 0);
|
|
9
|
+
const isDayScope = (scopeContext) => String(scopeContext) === 'localDate';
|
|
10
|
+
/** True when a key passes the caller-supplied drawer / ref-type filters. */
|
|
11
|
+
function keyPassesFilters(key, filters) {
|
|
12
|
+
const parsed = (0, materialized_cash_compile_helpers_1.parseMaterializedCashKey)(key);
|
|
13
|
+
if (parsed == null)
|
|
14
|
+
return true; // never hide a row we cannot parse
|
|
15
|
+
const drawers = filters.drawer_ids;
|
|
16
|
+
if (drawers != null && drawers.length > 0 && !drawers.includes(parsed.drawerId))
|
|
17
|
+
return false;
|
|
18
|
+
const refs = filters.ref_types;
|
|
19
|
+
if (refs != null && refs.length > 0 && !refs.includes(parsed.refType))
|
|
20
|
+
return false;
|
|
21
|
+
return true;
|
|
22
|
+
}
|
|
23
|
+
/** Accumulates one page of data for ONE tenant (or the folded brand view). */
|
|
24
|
+
function buildPageForTenant(tenantIds, docs, filters) {
|
|
25
|
+
const total = (0, materialized_cash_classification_helpers_1.freshCashCounters)();
|
|
26
|
+
const byDrawer = new Map();
|
|
27
|
+
const byRef = new Map();
|
|
28
|
+
const trend = [];
|
|
29
|
+
const weekday = new Map();
|
|
30
|
+
let sawDayScope = false;
|
|
31
|
+
const drawerNames = new Map();
|
|
32
|
+
for (const doc of docs) {
|
|
33
|
+
if (isDayScope(doc.scope_context))
|
|
34
|
+
sawDayScope = true;
|
|
35
|
+
const counters = doc.cash_counters ?? {};
|
|
36
|
+
const daySessions = { variance: 0, counted: 0, ledger: 0 };
|
|
37
|
+
for (const [key, block] of Object.entries(counters)) {
|
|
38
|
+
if (!keyPassesFilters(key, filters))
|
|
39
|
+
continue;
|
|
40
|
+
const parsed = (0, materialized_cash_compile_helpers_1.parseMaterializedCashKey)(key);
|
|
41
|
+
const drawerId = parsed?.drawerId ?? key;
|
|
42
|
+
(0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(total, block);
|
|
43
|
+
const drawerBlock = byDrawer.get(drawerId) ?? (0, materialized_cash_classification_helpers_1.freshCashCounters)();
|
|
44
|
+
(0, materialized_cash_accumulator_helpers_1.mergeMaterializedCashCounters)(drawerBlock, block);
|
|
45
|
+
byDrawer.set(drawerId, drawerBlock);
|
|
46
|
+
for (const [refType, flow] of Object.entries(block.movements.by_ref ?? {})) {
|
|
47
|
+
const bucket = byRef.get(refType) ?? { in_amount: 0, out_amount: 0, count: 0 };
|
|
48
|
+
bucket.in_amount += Number(flow?.in_amount) || 0;
|
|
49
|
+
bucket.out_amount += Number(flow?.out_amount) || 0;
|
|
50
|
+
bucket.count += (Number(flow?.in_count) || 0) + (Number(flow?.out_count) || 0);
|
|
51
|
+
byRef.set(refType, bucket);
|
|
52
|
+
}
|
|
53
|
+
daySessions.variance += Number(block.sessions?.variance_amount) || 0;
|
|
54
|
+
daySessions.counted += Number(block.sessions?.counted_close_amount) || 0;
|
|
55
|
+
daySessions.ledger += Number(block.movements?.ledger_net) || 0;
|
|
56
|
+
}
|
|
57
|
+
if (isDayScope(doc.scope_context)) {
|
|
58
|
+
trend.push({
|
|
59
|
+
scope_field: String(doc.scope_field),
|
|
60
|
+
variance: toDecimal(daySessions.variance),
|
|
61
|
+
counted_close: toDecimal(daySessions.counted),
|
|
62
|
+
});
|
|
63
|
+
const weekdayKey = doc.day_index == null ? null : String(doc.day_index);
|
|
64
|
+
if (weekdayKey != null) {
|
|
65
|
+
const bucket = weekday.get(weekdayKey) ?? { variance: 0, ledger_net: 0 };
|
|
66
|
+
bucket.variance += daySessions.variance;
|
|
67
|
+
bucket.ledger_net += daySessions.ledger;
|
|
68
|
+
weekday.set(weekdayKey, bucket);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
const movements = total.movements;
|
|
73
|
+
const sessions = total.sessions;
|
|
74
|
+
return {
|
|
75
|
+
tenant_ids: tenantIds,
|
|
76
|
+
summary: {
|
|
77
|
+
cash_in: toDecimal(movements.in_amount),
|
|
78
|
+
cash_out: toDecimal(movements.out_amount),
|
|
79
|
+
ledger_net: toDecimal(movements.ledger_net),
|
|
80
|
+
operator_net: toDecimal(movements.operator.net),
|
|
81
|
+
reopen_amount: toDecimal(movements.lifecycle.reopen_amount),
|
|
82
|
+
opening_float: toDecimal(movements.lifecycle.float_amount),
|
|
83
|
+
count_out: toDecimal(movements.lifecycle.countout_amount),
|
|
84
|
+
system_net: toDecimal(movements.system.net),
|
|
85
|
+
movement_count: movements.count,
|
|
86
|
+
expected_close: toDecimal(sessions.expected_close_amount),
|
|
87
|
+
counted_close: toDecimal(sessions.counted_close_amount),
|
|
88
|
+
variance: toDecimal(sessions.variance_amount),
|
|
89
|
+
over_count: sessions.variance_negative_count,
|
|
90
|
+
short_count: sessions.variance_positive_count,
|
|
91
|
+
open_sessions: sessions.open_sessions_count,
|
|
92
|
+
session_count: sessions.session_count,
|
|
93
|
+
reopen_count: sessions.reopen_count,
|
|
94
|
+
unmatched_close_count: sessions.unmatched_close_count,
|
|
95
|
+
},
|
|
96
|
+
by_drawer: [...byDrawer.entries()]
|
|
97
|
+
.map(([drawerId, block]) => ({
|
|
98
|
+
drawer_id: drawerId,
|
|
99
|
+
drawer_name: drawerNames.get(drawerId) ?? null,
|
|
100
|
+
cash_in: toDecimal(block.movements.in_amount),
|
|
101
|
+
cash_out: toDecimal(block.movements.out_amount),
|
|
102
|
+
ledger_net: toDecimal(block.movements.ledger_net),
|
|
103
|
+
variance: toDecimal(block.sessions.variance_amount),
|
|
104
|
+
session_count: block.sessions.session_count,
|
|
105
|
+
reopen_count: block.sessions.reopen_count,
|
|
106
|
+
}))
|
|
107
|
+
.sort((a, b) => b.ledger_net - a.ledger_net),
|
|
108
|
+
// Empty ref types are DROPPED: storage keeps all five enum members so a fold
|
|
109
|
+
// stays shape-stable, but a breakdown table must not show rows the filter
|
|
110
|
+
// excluded (or five zero rows for a day that only touched one).
|
|
111
|
+
by_ref: [...byRef.entries()]
|
|
112
|
+
.filter(([, flow]) => flow.count > 0 || flow.in_amount > 0 || flow.out_amount > 0)
|
|
113
|
+
.map(([refType, flow]) => ({
|
|
114
|
+
ref_type: refType,
|
|
115
|
+
in_amount: toDecimal(flow.in_amount),
|
|
116
|
+
out_amount: toDecimal(flow.out_amount),
|
|
117
|
+
count: flow.count,
|
|
118
|
+
}))
|
|
119
|
+
.sort((a, b) => b.in_amount + b.out_amount - (a.in_amount + a.out_amount)),
|
|
120
|
+
variance_trend: sawDayScope ? trend.sort((a, b) => (a.scope_field < b.scope_field ? -1 : 1)) : null,
|
|
121
|
+
weekday: sawDayScope
|
|
122
|
+
? [...weekday.entries()].map(([dayIndex, bucket]) => ({
|
|
123
|
+
day_index: dayIndex,
|
|
124
|
+
variance: toDecimal(bucket.variance),
|
|
125
|
+
ledger_net: toDecimal(bucket.ledger_net),
|
|
126
|
+
}))
|
|
127
|
+
: null,
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Formats cash documents into page data.
|
|
132
|
+
*
|
|
133
|
+
* `separate_view_per_tenant` yields one entry per tenant; otherwise every tenant is
|
|
134
|
+
* folded into a single brand view. Returns null on unusable input rather than an empty
|
|
135
|
+
* page, so the caller can tell "no data" from "malformed request".
|
|
136
|
+
*/
|
|
137
|
+
function getFormattedTenantCashInOutReporting(docs, filters, separate_view_per_tenant) {
|
|
138
|
+
if (!Array.isArray(docs) || docs.length === 0)
|
|
139
|
+
return null;
|
|
140
|
+
const usable = docs.filter((doc) => doc != null && doc.cash_counters != null);
|
|
141
|
+
if (usable.length === 0)
|
|
142
|
+
return null;
|
|
143
|
+
const resolvedFilters = filters ?? {};
|
|
144
|
+
if (separate_view_per_tenant === true) {
|
|
145
|
+
const byTenant = new Map();
|
|
146
|
+
for (const doc of usable) {
|
|
147
|
+
const tenantId = String(doc.tenant_id);
|
|
148
|
+
const bucket = byTenant.get(tenantId) ?? [];
|
|
149
|
+
bucket.push(doc);
|
|
150
|
+
byTenant.set(tenantId, bucket);
|
|
151
|
+
}
|
|
152
|
+
return [
|
|
153
|
+
[...byTenant.entries()].map(([tenantId, tenantDocs]) => buildPageForTenant([tenantId], tenantDocs, resolvedFilters)),
|
|
154
|
+
null,
|
|
155
|
+
];
|
|
156
|
+
}
|
|
157
|
+
const tenantIds = [...new Set(usable.map((doc) => String(doc.tenant_id)))].sort();
|
|
158
|
+
return [[buildPageForTenant(tenantIds, usable, resolvedFilters)], null];
|
|
159
|
+
}
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
import { IMaterializedTenantDeliveryReport } from '../../schemas/types/materialized_tenant_delivery_reports';
|
|
2
|
+
/**
|
|
3
|
+
* Frontend formatter for `materialized_tenant_delivery_reports` (M4).
|
|
4
|
+
*
|
|
5
|
+
* ADOPTION FIRST, BY CONSTRUCTION. The `deliveries` collection is written only by the
|
|
6
|
+
* rider app, so for a tenant that does not use it the collection is EMPTY - and an empty
|
|
7
|
+
* collection renders as "no deliveries" rather than "no visibility". The page shape
|
|
8
|
+
* therefore leads with `adoption` (how much of the operation the app can SEE) and treats
|
|
9
|
+
* every delivery metric as conditional on it.
|
|
10
|
+
*
|
|
11
|
+
* MONEY IS DECIMALS HERE, cents in storage. Distances are reported in KILOMETRES.
|
|
12
|
+
*
|
|
13
|
+
* SCOPE: pass the documents for ONE scope level. The weekday section is built only from
|
|
14
|
+
* DAY documents, so it is null for a period selection rather than guessed.
|
|
15
|
+
*/
|
|
16
|
+
/** Request-level filters. Scope selection itself is resolved server-side. */
|
|
17
|
+
export interface IFormattedDeliveryFilters {
|
|
18
|
+
/** Restrict to these platforms (the PLATFORM component of a key). */
|
|
19
|
+
platforms?: string[] | null;
|
|
20
|
+
/** Restrict to these cities (the CITY component of a key). */
|
|
21
|
+
cities?: string[] | null;
|
|
22
|
+
/** Restrict to these rider ids. Applied to the rider leaderboard AND the totals. */
|
|
23
|
+
rider_ids?: string[] | null;
|
|
24
|
+
}
|
|
25
|
+
export interface IFormattedDeliveryAdoption {
|
|
26
|
+
delivery_orders: number;
|
|
27
|
+
via_app: number;
|
|
28
|
+
off_app: number;
|
|
29
|
+
adoption_percent: number | null;
|
|
30
|
+
tracking_enabled: number;
|
|
31
|
+
with_pickup_proof: number;
|
|
32
|
+
with_dropoff_proof: number;
|
|
33
|
+
}
|
|
34
|
+
export interface IFormattedDeliverySummary {
|
|
35
|
+
deliveries: number;
|
|
36
|
+
completed: number;
|
|
37
|
+
cancelled: number;
|
|
38
|
+
in_progress: number;
|
|
39
|
+
rider_revenue: number;
|
|
40
|
+
net_sale: number;
|
|
41
|
+
collected: number;
|
|
42
|
+
charges_levied: number;
|
|
43
|
+
total_distance_km: number;
|
|
44
|
+
average_distance_km: number | null;
|
|
45
|
+
average_rider_revenue: number | null;
|
|
46
|
+
average_dispatch_lag_minutes: number | null;
|
|
47
|
+
average_complete_minutes: number | null;
|
|
48
|
+
average_total_minutes: number | null;
|
|
49
|
+
tips: number;
|
|
50
|
+
discounts: number;
|
|
51
|
+
refunds: number;
|
|
52
|
+
tax: number;
|
|
53
|
+
average_assignment_minutes: number | null;
|
|
54
|
+
average_pickup_wait_minutes: number | null;
|
|
55
|
+
average_transit_minutes: number | null;
|
|
56
|
+
average_cancel_minutes: number | null;
|
|
57
|
+
average_status_updates: number | null;
|
|
58
|
+
cancelled_after_pickup: number;
|
|
59
|
+
promise_known: number;
|
|
60
|
+
on_time: number;
|
|
61
|
+
on_time_percent: number | null;
|
|
62
|
+
late: number;
|
|
63
|
+
late_minutes: number;
|
|
64
|
+
}
|
|
65
|
+
export interface IFormattedDeliveryPlatformRow {
|
|
66
|
+
platform: string;
|
|
67
|
+
deliveries: number;
|
|
68
|
+
completed: number;
|
|
69
|
+
net_sale: number;
|
|
70
|
+
charges_levied: number;
|
|
71
|
+
rider_revenue: number;
|
|
72
|
+
avg_distance_km: number | null;
|
|
73
|
+
}
|
|
74
|
+
export interface IFormattedDeliveryAreaRow {
|
|
75
|
+
city: string;
|
|
76
|
+
deliveries: number;
|
|
77
|
+
completed: number;
|
|
78
|
+
net_sale: number;
|
|
79
|
+
charges_levied: number;
|
|
80
|
+
rider_revenue: number;
|
|
81
|
+
avg_distance_km: number | null;
|
|
82
|
+
}
|
|
83
|
+
export interface IFormattedDeliveryRiderRow {
|
|
84
|
+
rider_id: string;
|
|
85
|
+
rider_name: string | null;
|
|
86
|
+
deliveries: number;
|
|
87
|
+
completed: number;
|
|
88
|
+
cancelled: number;
|
|
89
|
+
rider_revenue: number;
|
|
90
|
+
avg_distance_km: number | null;
|
|
91
|
+
last_delivery_at: Date | null;
|
|
92
|
+
}
|
|
93
|
+
export interface IFormattedDeliveryDistanceBucket {
|
|
94
|
+
label: string;
|
|
95
|
+
count: number;
|
|
96
|
+
percent: number;
|
|
97
|
+
}
|
|
98
|
+
export interface IFormattedDeliveryHotArea {
|
|
99
|
+
city: string;
|
|
100
|
+
hour: number;
|
|
101
|
+
deliveries: number;
|
|
102
|
+
}
|
|
103
|
+
export interface IFormattedDeliveryWeekdayRow {
|
|
104
|
+
day_index: string;
|
|
105
|
+
deliveries: number;
|
|
106
|
+
completed: number;
|
|
107
|
+
rider_revenue: number;
|
|
108
|
+
}
|
|
109
|
+
export interface IFormattedDeliveryPageData {
|
|
110
|
+
tenant_ids: string[];
|
|
111
|
+
adoption: IFormattedDeliveryAdoption;
|
|
112
|
+
summary: IFormattedDeliverySummary;
|
|
113
|
+
by_platform: IFormattedDeliveryPlatformRow[];
|
|
114
|
+
by_area: IFormattedDeliveryAreaRow[];
|
|
115
|
+
by_rider: IFormattedDeliveryRiderRow[];
|
|
116
|
+
distance_buckets: IFormattedDeliveryDistanceBucket[];
|
|
117
|
+
hot_areas: IFormattedDeliveryHotArea[] | null;
|
|
118
|
+
weekday: IFormattedDeliveryWeekdayRow[] | null;
|
|
119
|
+
/**
|
|
120
|
+
* True when at least one completion time came from the `updatedAt` PROXY rather than an
|
|
121
|
+
* exact `delivered_at`. The page must label those averages as approximate: `updatedAt`
|
|
122
|
+
* moves on any later mutation, so the figure can drift.
|
|
123
|
+
*/
|
|
124
|
+
timing_approximate: boolean;
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* Formats delivery documents into page data.
|
|
128
|
+
*
|
|
129
|
+
* `separate_view_per_tenant` yields one entry per tenant; otherwise every tenant folds
|
|
130
|
+
* into a single brand view. Returns null on unusable input rather than an empty page, so
|
|
131
|
+
* the caller can tell "no data" from "malformed request".
|
|
132
|
+
*/
|
|
133
|
+
export declare function getFormattedTenantDeliveryReporting(docs: IMaterializedTenantDeliveryReport[] | null | undefined, filters?: IFormattedDeliveryFilters | null, separate_view_per_tenant?: boolean): [IFormattedDeliveryPageData[], null] | null;
|