@managesome/eposmatic-toolkit 0.4.9 → 0.4.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/esm/constants/MATERIALIZED_REPORTS.js +448 -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/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,161 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.getSalesComparisonBaselineRange = getSalesComparisonBaselineRange;
|
|
4
|
+
exports.buildSalesComparisonBaselineScopeGroups = buildSalesComparisonBaselineScopeGroups;
|
|
5
|
+
const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
|
|
6
|
+
const materialized_reports_scope_group_helpers_1 = require("./materialized-reports-scope-group-helpers");
|
|
7
|
+
const materialized_reports_selection_helpers_1 = require("./materialized-reports-selection-helpers");
|
|
8
|
+
/**
|
|
9
|
+
* Sales Comparison baseline derivation (concept §7).
|
|
10
|
+
*
|
|
11
|
+
* The user picks ONE range (`selection`); the comparison range is DERIVED:
|
|
12
|
+
*
|
|
13
|
+
* - `PREVIOUS_PERIOD` — the EQUAL-LENGTH window immediately preceding the
|
|
14
|
+
* primary range. A 30-day month compares against the preceding 30 days,
|
|
15
|
+
* never against "the previous calendar month" (the classic off-by-one-day
|
|
16
|
+
* bug). Formally: `[min − span, min − 1]` where `span = max − min + 1`.
|
|
17
|
+
* - `PREVIOUS_YEAR` — the primary window shifted back 12 months, SAME length.
|
|
18
|
+
* The start is shifted one calendar year (Feb 29 clamps to Feb 28) and the
|
|
19
|
+
* end is `start + span − 1`, so a leap-year primary still compares against an
|
|
20
|
+
* equally long window.
|
|
21
|
+
*
|
|
22
|
+
* The selection's REFINEMENTS are re-applied to the derived window:
|
|
23
|
+
* - the weekday filter, so "every Monday in September" compares against
|
|
24
|
+
* Mondays inside the preceding equal-length window;
|
|
25
|
+
* - the time-of-day window, with the SAME window kind the primary decode uses
|
|
26
|
+
* (a range-like selection's toggle is a CONTINUOUS SPAN; discrete / weekday
|
|
27
|
+
* selections repeat the same hours each day).
|
|
28
|
+
*
|
|
29
|
+
* This lives in the toolkit because the server derives the pairing and both
|
|
30
|
+
* sides must agree on it — the CLIENT never builds the comparison selection.
|
|
31
|
+
*
|
|
32
|
+
* Returns `null` when the baseline is `NONE` or the selection cannot be
|
|
33
|
+
* decoded, and an EMPTY group list when the derived window legitimately
|
|
34
|
+
* contains no day matching the refinements (a real "zero" comparison, not an
|
|
35
|
+
* error).
|
|
36
|
+
*/
|
|
37
|
+
/** `'YYYY-MM-DD'` → UTC date (timezone-less key math). */
|
|
38
|
+
const keyToUtcDate = (key) => {
|
|
39
|
+
const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(key);
|
|
40
|
+
if (match == null)
|
|
41
|
+
return null;
|
|
42
|
+
const year = Number(match[1]);
|
|
43
|
+
const month = Number(match[2]);
|
|
44
|
+
const day = Number(match[3]);
|
|
45
|
+
const date = new Date(Date.UTC(year, month - 1, day));
|
|
46
|
+
if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) {
|
|
47
|
+
return null;
|
|
48
|
+
}
|
|
49
|
+
return date;
|
|
50
|
+
};
|
|
51
|
+
const utcDateToKey = (date) => date.toISOString().slice(0, 10);
|
|
52
|
+
const addUtcDays = (date, amount) => new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() + amount));
|
|
53
|
+
/** Shifts a key back one calendar year; Feb 29 clamps to Feb 28. */
|
|
54
|
+
const shiftKeyOneYearBack = (key) => {
|
|
55
|
+
const date = keyToUtcDate(key);
|
|
56
|
+
if (date == null)
|
|
57
|
+
return null;
|
|
58
|
+
const year = date.getUTCFullYear() - 1;
|
|
59
|
+
const month = date.getUTCMonth();
|
|
60
|
+
const lastDayOfMonth = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
|
|
61
|
+
const day = Math.min(date.getUTCDate(), lastDayOfMonth);
|
|
62
|
+
return utcDateToKey(new Date(Date.UTC(year, month, day)));
|
|
63
|
+
};
|
|
64
|
+
// `DAY_INDEX_ENUM` values are the three-letter keys (`MON`), not full names.
|
|
65
|
+
const DAY_INDEX_KEYS = ['SUN', 'MON', 'TUE', 'WED', 'THU', 'FRI', 'SAT'];
|
|
66
|
+
const dayIndexKeyOf = (key) => {
|
|
67
|
+
const date = keyToUtcDate(key);
|
|
68
|
+
return date == null ? null : (DAY_INDEX_KEYS[date.getUTCDay()] ?? null);
|
|
69
|
+
};
|
|
70
|
+
/** `'HH:mm'` → whole hour, or null (mirrors the decoder's whole-hour rule). */
|
|
71
|
+
const hourOf = (time) => {
|
|
72
|
+
if (time == null)
|
|
73
|
+
return null;
|
|
74
|
+
const match = /^(\d{2}):00$/.exec(time);
|
|
75
|
+
if (match == null)
|
|
76
|
+
return null;
|
|
77
|
+
const hour = Number(match[1]);
|
|
78
|
+
return hour >= 0 && hour <= 23 ? hour : null;
|
|
79
|
+
};
|
|
80
|
+
/**
|
|
81
|
+
* Derives the comparison window from a decoded selection.
|
|
82
|
+
*
|
|
83
|
+
* Returns `null` for `NONE` / an unservable selection; an entry with an empty
|
|
84
|
+
* `days` array means the window is valid but no day matches the refinement.
|
|
85
|
+
*/
|
|
86
|
+
function getSalesComparisonBaselineRange(selection, baseline) {
|
|
87
|
+
if (selection == null || typeof selection !== 'object')
|
|
88
|
+
return null;
|
|
89
|
+
if (baseline === MATERIALIZED_REPORTS_1.SALES_COMPARISON_BASELINE_ENUM.NONE)
|
|
90
|
+
return null;
|
|
91
|
+
if (baseline !== MATERIALIZED_REPORTS_1.SALES_COMPARISON_BASELINE_ENUM.PREVIOUS_PERIOD &&
|
|
92
|
+
baseline !== MATERIALIZED_REPORTS_1.SALES_COMPARISON_BASELINE_ENUM.PREVIOUS_YEAR) {
|
|
93
|
+
return null;
|
|
94
|
+
}
|
|
95
|
+
// The window's LENGTH comes from the SELECTION's own range, not from the
|
|
96
|
+
// days that survive the weekday refinement: "every Monday in September" is a
|
|
97
|
+
// 30-day selection whose baseline is the preceding 30 days (then the same
|
|
98
|
+
// weekday filter applies), not the 22 days between its first and last Monday.
|
|
99
|
+
const rawSelection = { ...selection, weekdays: [] };
|
|
100
|
+
const primaryDays = (0, materialized_reports_selection_helpers_1.getDayKeysFromCalendarSelection)(rawSelection);
|
|
101
|
+
if (primaryDays.length === 0)
|
|
102
|
+
return null;
|
|
103
|
+
const sorted = [...primaryDays].sort();
|
|
104
|
+
const firstKey = sorted[0];
|
|
105
|
+
const lastKey = sorted[sorted.length - 1];
|
|
106
|
+
const first = keyToUtcDate(firstKey);
|
|
107
|
+
const last = keyToUtcDate(lastKey);
|
|
108
|
+
if (first == null || last == null)
|
|
109
|
+
return null;
|
|
110
|
+
const span = Math.round((last.getTime() - first.getTime()) / 86400000) + 1;
|
|
111
|
+
if (span < 1)
|
|
112
|
+
return null;
|
|
113
|
+
const startKey = baseline === MATERIALIZED_REPORTS_1.SALES_COMPARISON_BASELINE_ENUM.PREVIOUS_YEAR
|
|
114
|
+
? shiftKeyOneYearBack(firstKey)
|
|
115
|
+
: utcDateToKey(addUtcDays(first, -span));
|
|
116
|
+
if (startKey == null)
|
|
117
|
+
return null;
|
|
118
|
+
const start = keyToUtcDate(startKey);
|
|
119
|
+
if (start == null)
|
|
120
|
+
return null;
|
|
121
|
+
const endKey = utcDateToKey(addUtcDays(start, span - 1));
|
|
122
|
+
const weekdayFilter = new Set(selection.weekdays ?? []);
|
|
123
|
+
const days = [];
|
|
124
|
+
for (let cursor = start; utcDateToKey(cursor) <= endKey; cursor = addUtcDays(cursor, 1)) {
|
|
125
|
+
const key = utcDateToKey(cursor);
|
|
126
|
+
if (weekdayFilter.size > 0) {
|
|
127
|
+
const weekday = dayIndexKeyOf(key);
|
|
128
|
+
if (weekday == null || !weekdayFilter.has(weekday))
|
|
129
|
+
continue;
|
|
130
|
+
}
|
|
131
|
+
days.push(key);
|
|
132
|
+
}
|
|
133
|
+
return { start: startKey, end: endKey, days };
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* Builds the comparison read's scope groups. Empty array = a valid baseline
|
|
137
|
+
* whose window contains no matching day (the read then folds to zero).
|
|
138
|
+
*/
|
|
139
|
+
function buildSalesComparisonBaselineScopeGroups(selection, baseline) {
|
|
140
|
+
const range = getSalesComparisonBaselineRange(selection, baseline);
|
|
141
|
+
if (range == null)
|
|
142
|
+
return null;
|
|
143
|
+
if (range.days.length === 0)
|
|
144
|
+
return [];
|
|
145
|
+
const fromHour = hourOf(selection.timeStart);
|
|
146
|
+
const toHour = hourOf(selection.timeEnd);
|
|
147
|
+
const hasWindow = fromHour != null && toHour != null && (0, materialized_reports_selection_helpers_1.isValidBusinessHourWindow)(fromHour, toHour);
|
|
148
|
+
const spec = { days: range.days };
|
|
149
|
+
if (hasWindow) {
|
|
150
|
+
// Mirror the primary decoder's window kind: a range-like selection's
|
|
151
|
+
// toggle is CONTINUOUS, everything else repeats the same hours per day.
|
|
152
|
+
const weekdayRefined = (selection.weekdays ?? []).length > 0;
|
|
153
|
+
const span = !weekdayRefined && materialized_reports_selection_helpers_1.MATERIALIZED_REPORT_SPAN_VIEW_MODES.has(selection.view);
|
|
154
|
+
spec.window = {
|
|
155
|
+
fromHour: fromHour,
|
|
156
|
+
toHour: toHour,
|
|
157
|
+
kind: span ? materialized_reports_scope_group_helpers_1.MATERIALIZED_REPORT_WINDOW_KIND.SPAN : materialized_reports_scope_group_helpers_1.MATERIALIZED_REPORT_WINDOW_KIND.RECURRING,
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
return (0, materialized_reports_scope_group_helpers_1.buildMaterializedReportScopeGroups)(spec);
|
|
161
|
+
}
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
import { MATERIALIZED_REPORT_SCOPE_ENUM } from '../../constants/MATERIALIZED_REPORTS';
|
|
2
|
+
import { IMaterializedSalesComparisonEntry, IMaterializedTenantSalesComparisonEntries } from '../../schemas/types/materialized_tenant_sales_comparison_entries';
|
|
3
|
+
import { IMaterializedSalesComparisonCounters, IMaterializedTenantSalesComparisonReport } from '../../schemas/types/materialized_tenant_sales_comparison_reports';
|
|
4
|
+
/**
|
|
5
|
+
* Sales Comparison close-day helpers.
|
|
6
|
+
*
|
|
7
|
+
* ## Period counters are RE-FOLDED, never patched
|
|
8
|
+
*
|
|
9
|
+
* The discount report accumulates period deltas forward and subtracts a day
|
|
10
|
+
* delta on re-close. That design produced defects 4–6 in the handoff (emptied
|
|
11
|
+
* days, corrections that REMOVE rows, and a missing period document rebuilt
|
|
12
|
+
* from one day). This report mirrors CASH instead: every touched period is
|
|
13
|
+
* rebuilt from its whole day set, so a correction cannot leave residue and a
|
|
14
|
+
* missing period document is rebuilt from the days still on hand.
|
|
15
|
+
*
|
|
16
|
+
* ## The watermark comes from the FOLDED DAYS
|
|
17
|
+
*
|
|
18
|
+
* A folded document that inherited the STORED document watermark would look
|
|
19
|
+
* unchanged to the write guard, so the write would be skipped forever and the
|
|
20
|
+
* period would freeze at its first closed day. This bug shipped once in the
|
|
21
|
+
* prep time report; it is designed out here from the start.
|
|
22
|
+
*
|
|
23
|
+
* ## Close-day fetch contract — UNDER-FETCHING IS SILENT
|
|
24
|
+
*
|
|
25
|
+
* `existing` / `existingEntries` must contain:
|
|
26
|
+
* 1. the closing day's own range document (and the period documents it rolls
|
|
27
|
+
* into), and
|
|
28
|
+
* 2. **every stored `localDate` document inside those periods** — the sibling
|
|
29
|
+
* days are the fold's input. `getMaterializedSalesComparisonPeriodDayKeys`
|
|
30
|
+
* returns exactly the day keys a caller must fetch (`scope_field: { $in }`).
|
|
31
|
+
*
|
|
32
|
+
* Passing only (1) still handles emptied days and corrections on the closing
|
|
33
|
+
* day, but a period document is then rebuilt from the closing day alone and
|
|
34
|
+
* every sibling day silently disappears. That is why (2) is part of the
|
|
35
|
+
* contract, exactly like the discount entries contract.
|
|
36
|
+
*
|
|
37
|
+
* Helpers never throw — invalid input returns `null`.
|
|
38
|
+
*/
|
|
39
|
+
/** Period scopes this report materializes (everything except the day scope). */
|
|
40
|
+
export declare const MATERIALIZED_SALES_COMPARISON_PERIOD_SCOPES: (MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_HOUR | MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_WEEK | MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_WEEK_OF_YEAR | MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_MONTH | MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_QUARTER | MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_SEMESTER | MATERIALIZED_REPORT_SCOPE_ENUM.LOCAL_YEAR)[];
|
|
41
|
+
/** True when the scope is the plain day scope. */
|
|
42
|
+
export declare const isMaterializedSalesComparisonDayScope: (scopeContext: string) => boolean;
|
|
43
|
+
/** One `(scope_context, scope_field)` pair. */
|
|
44
|
+
export interface IMaterializedSalesComparisonScopeRef {
|
|
45
|
+
scope_context: MATERIALIZED_REPORT_SCOPE_ENUM;
|
|
46
|
+
scope_field: string;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* The stored scope references one settled day's plan needs: its `localDate`
|
|
50
|
+
* document plus the five period documents it rolls into. NO hour scope — this
|
|
51
|
+
* report has none.
|
|
52
|
+
*/
|
|
53
|
+
export declare function getMaterializedSalesComparisonScopeRefsForDay(localDate: string): IMaterializedSalesComparisonScopeRef[] | null;
|
|
54
|
+
/**
|
|
55
|
+
* Every `localDate` scope value a caller must fetch to re-fold the periods one
|
|
56
|
+
* settled day touches — the union of the day's week/month/quarter/semester/year
|
|
57
|
+
* ranges (≤ 366 keys). Sorted, deduped.
|
|
58
|
+
*/
|
|
59
|
+
export declare function getMaterializedSalesComparisonPeriodDayKeys(localDate: string): string[] | null;
|
|
60
|
+
/**
|
|
61
|
+
* Folds the counters of every DAY document that belongs to one period scope.
|
|
62
|
+
* Pure; the caller supplies the whole day set.
|
|
63
|
+
*/
|
|
64
|
+
export declare function foldMaterializedSalesComparisonPeriodCounters(input: {
|
|
65
|
+
periodScope: MATERIALIZED_REPORT_SCOPE_ENUM | string;
|
|
66
|
+
periodScopeField: string;
|
|
67
|
+
dayDocuments: IMaterializedTenantSalesComparisonReport[];
|
|
68
|
+
}): Record<string, IMaterializedSalesComparisonCounters>;
|
|
69
|
+
/**
|
|
70
|
+
* Merges two entry sections, de-duplicating rows by `order_id`.
|
|
71
|
+
*
|
|
72
|
+
* A row belongs to exactly one settled day, so the same order id twice means
|
|
73
|
+
* the fold saw it twice; money and rows must never double-count.
|
|
74
|
+
*/
|
|
75
|
+
export declare function mergeMaterializedSalesComparisonEntrySections(target: Record<string, {
|
|
76
|
+
rows: IMaterializedSalesComparisonEntry[];
|
|
77
|
+
}> | null, source: Record<string, {
|
|
78
|
+
rows: IMaterializedSalesComparisonEntry[];
|
|
79
|
+
}> | null): Record<string, {
|
|
80
|
+
rows: IMaterializedSalesComparisonEntry[];
|
|
81
|
+
}>;
|
|
82
|
+
/**
|
|
83
|
+
* Folds the itemized rows of every DAY entry document that belongs to one
|
|
84
|
+
* period scope, de-duplicated by `order_id`.
|
|
85
|
+
*/
|
|
86
|
+
export declare function foldMaterializedSalesComparisonPeriodEntries(input: {
|
|
87
|
+
periodScope: MATERIALIZED_REPORT_SCOPE_ENUM | string;
|
|
88
|
+
periodScopeField: string;
|
|
89
|
+
dayDocuments: IMaterializedTenantSalesComparisonEntries[];
|
|
90
|
+
}): Record<string, {
|
|
91
|
+
rows: IMaterializedSalesComparisonEntry[];
|
|
92
|
+
}>;
|
|
93
|
+
/**
|
|
94
|
+
* Write guard: does the stored document need a structural write?
|
|
95
|
+
*
|
|
96
|
+
* - `force` bypasses the guard (repairs / schema rollouts);
|
|
97
|
+
* - a schema-version or key-grammar change forces the write;
|
|
98
|
+
* - a NEWER watermark forces the write;
|
|
99
|
+
* - an OLDER watermark is a stale replay and is skipped;
|
|
100
|
+
* - an EQUAL watermark still writes when the CONTENT differs. This is the
|
|
101
|
+
* correction case: removing an order can leave the day's max `updatedAt`
|
|
102
|
+
* unchanged, and a watermark-only guard would then leave the period at its
|
|
103
|
+
* pre-correction figures forever.
|
|
104
|
+
*/
|
|
105
|
+
export declare function needsMaterializedSalesComparisonReportWrite(existing: IMaterializedTenantSalesComparisonReport | null | undefined, incoming: IMaterializedTenantSalesComparisonReport | null | undefined, force?: boolean): boolean;
|
|
106
|
+
/** True when the stored entry document already carries these exact rows. */
|
|
107
|
+
export declare function needsMaterializedSalesComparisonEntriesWrite(existing: IMaterializedTenantSalesComparisonEntries | null | undefined, incoming: IMaterializedTenantSalesComparisonEntries | null | undefined, force?: boolean): boolean;
|
|
108
|
+
/** One plan write: the document plus its iteration history row. */
|
|
109
|
+
export interface IMaterializedSalesComparisonCloseDayWrite<T> {
|
|
110
|
+
report: T;
|
|
111
|
+
iteration: {
|
|
112
|
+
report_type: string;
|
|
113
|
+
report_id: string;
|
|
114
|
+
iteration: number;
|
|
115
|
+
schema_version: number;
|
|
116
|
+
reason: string;
|
|
117
|
+
snapshot: unknown;
|
|
118
|
+
createdAt: Date;
|
|
119
|
+
updatedAt: Date;
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
export interface ITenantSalesComparisonCloseDayPlan {
|
|
123
|
+
writes: IMaterializedSalesComparisonCloseDayWrite<IMaterializedTenantSalesComparisonReport>[];
|
|
124
|
+
entryWrites: IMaterializedSalesComparisonCloseDayWrite<IMaterializedTenantSalesComparisonEntries>[];
|
|
125
|
+
/** DAY-scoped counter docs no longer backed by settled orders — delete by `_id`. */
|
|
126
|
+
staleDocuments: IMaterializedTenantSalesComparisonReport[];
|
|
127
|
+
/** DAY-scoped entry docs no longer backed by rows — delete by `_id`. */
|
|
128
|
+
staleEntryDocuments: IMaterializedTenantSalesComparisonEntries[];
|
|
129
|
+
skippedDocuments: IMaterializedTenantSalesComparisonReport[];
|
|
130
|
+
skippedEntryDocuments: IMaterializedTenantSalesComparisonEntries[];
|
|
131
|
+
/** Period documents this close CREATED because they were absent. */
|
|
132
|
+
createdPeriodDocuments: IMaterializedSalesComparisonScopeRef[];
|
|
133
|
+
}
|
|
134
|
+
export interface IBuildTenantSalesComparisonCloseDayPlanInput {
|
|
135
|
+
tenantId: string;
|
|
136
|
+
/** The compiled settled day. Required when the day has no compiled document. */
|
|
137
|
+
localDate?: string | null;
|
|
138
|
+
/** The day's compiled counter documents (`compileTenantSalesComparisonReports`). */
|
|
139
|
+
reports: IMaterializedTenantSalesComparisonReport[];
|
|
140
|
+
/** The day's compiled entry documents (same pass). */
|
|
141
|
+
entries: IMaterializedTenantSalesComparisonEntries[];
|
|
142
|
+
/**
|
|
143
|
+
* Stored documents: the day's range document, its period documents AND every
|
|
144
|
+
* stored `localDate` document in those periods (see the module docblock).
|
|
145
|
+
*/
|
|
146
|
+
existing?: IMaterializedTenantSalesComparisonReport[];
|
|
147
|
+
/** Stored entry documents, same fetch contract as `existing`. */
|
|
148
|
+
existingEntries?: IMaterializedTenantSalesComparisonEntries[];
|
|
149
|
+
/** Why this close is applied — stored as every history row's `reason`. */
|
|
150
|
+
reason: string;
|
|
151
|
+
/** Force structural writes even when the watermarks are up to date. */
|
|
152
|
+
force?: boolean;
|
|
153
|
+
/** Override for write timestamps (tests, replays). */
|
|
154
|
+
computedAt?: Date;
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* Builds the close-day plan for ONE settled tenant-day.
|
|
158
|
+
*
|
|
159
|
+
* The DAY scope is written from the compile. Every touched PERIOD scope is
|
|
160
|
+
* re-folded from its whole day set (stored siblings + the freshly compiled
|
|
161
|
+
* day). Returns `null` on malformed input.
|
|
162
|
+
*/
|
|
163
|
+
export declare function buildTenantSalesComparisonCloseDayPlan(input: IBuildTenantSalesComparisonCloseDayPlanInput | null | undefined): ITenantSalesComparisonCloseDayPlan | null;
|