@managesome/eposmatic-toolkit 0.4.51 → 0.4.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +106 -2
  2. package/esm/constants/enums/delivery.js +13 -0
  3. package/esm/helpers/materialized-reports/index.js +5 -0
  4. package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +8 -62
  5. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +95 -73
  6. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +118 -146
  7. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +304 -71
  8. package/esm/helpers/materialized-reports/materialized-delivery-entry-pages.js +307 -0
  9. package/esm/helpers/materialized-reports/materialized-delivery-index-migration.js +103 -0
  10. package/esm/helpers/materialized-reports/materialized-delivery-rows.js +109 -0
  11. package/esm/helpers/materialized-reports/materialized-delivery-wipe-targets.js +32 -0
  12. package/esm/helpers/materialized-reports/materialized-document-size.js +65 -0
  13. package/esm/helpers/materialized-reports/materialized-index-bootstrap.js +31 -16
  14. package/esm/helpers/materialized-reports/materialized-integer-contract.js +10 -1
  15. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +3 -91
  16. package/esm/helpers/materialized-reports/materialized-tenant-delivery-geo-helpers.js +597 -0
  17. package/esm/helpers/materialized-reports/scope-helpers.js +98 -0
  18. package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +70 -20
  19. package/esm/helpers/utils/offer-item-resolution.js +39 -0
  20. package/esm/schemas/models/index.js +12 -10
  21. package/esm/schemas/models/materialized_tenant_delivery_entries.js +33 -12
  22. package/esm/schemas/models/materialized_tenant_delivery_geo_cells.js +83 -0
  23. package/esm/schemas/models/materialized_tenant_delivery_geo_scopes.js +35 -0
  24. package/esm/schemas/models/materialized_tenant_delivery_reports.js +10 -1
  25. package/esm/schemas/types/index.js +14 -12
  26. package/esm/schemas/types/materialized_tenant_delivery_geo_cells.js +1 -0
  27. package/esm/schemas/types/materialized_tenant_delivery_geo_scopes.js +1 -0
  28. package/lib/constants/MATERIALIZED_REPORTS.d.ts +95 -1
  29. package/lib/constants/MATERIALIZED_REPORTS.js +108 -4
  30. package/lib/constants/enums/delivery.d.ts +9 -0
  31. package/lib/constants/enums/delivery.js +14 -1
  32. package/lib/helpers/materialized-reports/index.d.ts +5 -0
  33. package/lib/helpers/materialized-reports/index.js +5 -0
  34. package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +8 -62
  35. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +36 -9
  36. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +94 -72
  37. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +23 -26
  38. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +121 -150
  39. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +44 -5
  40. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +306 -69
  41. package/lib/helpers/materialized-reports/materialized-delivery-entry-pages.d.ts +128 -0
  42. package/lib/helpers/materialized-reports/materialized-delivery-entry-pages.js +322 -0
  43. package/lib/helpers/materialized-reports/materialized-delivery-index-migration.d.ts +48 -0
  44. package/lib/helpers/materialized-reports/materialized-delivery-index-migration.js +108 -0
  45. package/lib/helpers/materialized-reports/materialized-delivery-rows.d.ts +15 -0
  46. package/lib/helpers/materialized-reports/materialized-delivery-rows.js +115 -0
  47. package/lib/helpers/materialized-reports/materialized-delivery-wipe-targets.d.ts +17 -0
  48. package/lib/helpers/materialized-reports/materialized-delivery-wipe-targets.js +35 -0
  49. package/lib/helpers/materialized-reports/materialized-document-size.d.ts +47 -0
  50. package/lib/helpers/materialized-reports/materialized-document-size.js +73 -0
  51. package/lib/helpers/materialized-reports/materialized-index-bootstrap.js +28 -13
  52. package/lib/helpers/materialized-reports/materialized-integer-contract.js +10 -1
  53. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +2 -90
  54. package/lib/helpers/materialized-reports/materialized-tenant-delivery-geo-helpers.d.ts +186 -0
  55. package/lib/helpers/materialized-reports/materialized-tenant-delivery-geo-helpers.js +620 -0
  56. package/lib/helpers/materialized-reports/scope-helpers.d.ts +8 -0
  57. package/lib/helpers/materialized-reports/scope-helpers.js +99 -0
  58. package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +41 -0
  59. package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +70 -20
  60. package/lib/helpers/utils/offer-item-resolution.d.ts +28 -0
  61. package/lib/helpers/utils/offer-item-resolution.js +41 -0
  62. package/lib/schemas/models/index.d.ts +12 -10
  63. package/lib/schemas/models/index.js +12 -10
  64. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +31 -9
  65. package/lib/schemas/models/materialized_tenant_delivery_entries.js +32 -11
  66. package/lib/schemas/models/materialized_tenant_delivery_geo_cells.d.ts +129 -0
  67. package/lib/schemas/models/materialized_tenant_delivery_geo_cells.js +86 -0
  68. package/lib/schemas/models/materialized_tenant_delivery_geo_scopes.d.ts +71 -0
  69. package/lib/schemas/models/materialized_tenant_delivery_geo_scopes.js +38 -0
  70. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +10 -1
  71. package/lib/schemas/models/materialized_tenant_delivery_reports.js +10 -1
  72. package/lib/schemas/models/materialized_tenant_discount_sources.d.ts +15 -15
  73. package/lib/schemas/types/index.d.ts +14 -12
  74. package/lib/schemas/types/index.js +14 -12
  75. package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +36 -4
  76. package/lib/schemas/types/materialized_tenant_delivery_geo_cells.d.ts +178 -0
  77. package/lib/schemas/types/materialized_tenant_delivery_geo_cells.js +2 -0
  78. package/lib/schemas/types/materialized_tenant_delivery_geo_scopes.d.ts +21 -0
  79. package/lib/schemas/types/materialized_tenant_delivery_geo_scopes.js +2 -0
  80. package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +49 -7
  81. package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +56 -19
  82. package/lib/tests/materialized-reports/materialized-delivery-budgets.test.d.ts +1 -0
  83. package/lib/tests/materialized-reports/materialized-delivery-budgets.test.js +91 -0
  84. package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +271 -15
  85. package/lib/tests/materialized-reports/materialized-delivery-final-audit.test.d.ts +1 -0
  86. package/lib/tests/materialized-reports/materialized-delivery-final-audit.test.js +128 -0
  87. package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +42 -5
  88. package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +13 -1
  89. package/lib/tests/materialized-reports/materialized-delivery-geo.test.d.ts +1 -0
  90. package/lib/tests/materialized-reports/materialized-delivery-geo.test.js +446 -0
  91. package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +117 -25
  92. package/lib/tests/materialized-reports/materialized-delivery-practical.test.d.ts +1 -0
  93. package/lib/tests/materialized-reports/materialized-delivery-practical.test.js +344 -0
  94. package/lib/tests/materialized-reports/materialized-integer-contract.test.js +14 -0
  95. package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +1 -1
  96. package/lib/tests/offer-item-resolution.test.js +57 -0
  97. package/package.json +4 -2
@@ -7,16 +7,29 @@ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
7
7
  /**
8
8
  * Mongoose schema for `materialized_tenant_delivery_entries` (M4).
9
9
  *
10
- * `delivery_entries` is `Mixed` on purpose: it is a key-addressed map of
11
- * bounded sub-documents (rider / area leaderboards with an hour heat map), which Mongoose
12
- * cannot type precisely without a fixed key set - the keys ARE the data.
10
+ * PAGE-PARTITIONED by source day, exactly like the discounts entries: the day scope uses
11
+ * `page='all'`, and every period entry scope (week / ISO week / month) uses
12
+ * `page=<source localDate>`, so a document is bounded by ONE day's rows. Quarter /
13
+ * semester / year entry documents do not exist.
14
+ *
15
+ * `delivery_entries` is `Mixed` on purpose: it is a key-addressed map of rows whose keys
16
+ * are the report's `ORDER_STATUS:PLATFORM:CITY` grammar, which Mongoose cannot type precisely without
17
+ * a fixed key set - the keys ARE the data.
18
+ */
19
+ /**
20
+ * v3 - PAGE-PARTITIONED entry documents (one page per source day, max scope
21
+ * `localMonth`). v2 was one document per period scope, which made a month an unbounded
22
+ * document. Historical v2 documents are not readable by the page-aware read layer and
23
+ * must be re-materialized (re-close the days); the writer deletes the pages it owns.
13
24
  */
14
- exports.MATERIALIZED_TENANT_DELIVERY_ENTRIES_SCHEMA_VERSION = 1;
25
+ exports.MATERIALIZED_TENANT_DELIVERY_ENTRIES_SCHEMA_VERSION = 3;
15
26
  exports.MaterializedTenantDeliveryEntriesSchema = new mongoose_1.Schema({
16
27
  tenant_id: { type: String, required: true },
17
28
  brand_id: { type: String, required: true },
18
- scope_context: { type: String, required: true, enum: MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_REPORT_SCOPES },
29
+ scope_context: { type: String, required: true, enum: MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_ENTRY_SCOPES },
19
30
  scope_field: { type: String, required: true },
31
+ /** `'all'` for the day scope; the source `YYYY-MM-DD` for a period scope. */
32
+ page: { type: String, required: true, immutable: true },
20
33
  day_index: { type: String, default: null, enum: [...ENUMS_1.ALL_DAY_INDEX, null] },
21
34
  sale_type_key_filters: {
22
35
  type: [String],
@@ -45,22 +58,30 @@ exports.MaterializedTenantDeliveryEntriesSchema = new mongoose_1.Schema({
45
58
  }, { timestamps: true, versionKey: false, minimize: false });
46
59
  exports.MATERIALIZED_TENANT_DELIVERY_ENTRIES_COLLECTION_NAME = 'materialized_tenant_delivery_entries';
47
60
  /**
48
- * The single UNIQUE compound identity index, like every materialized collection. No
49
- * `brand_id` index - a brand's scopes are resolved before the read.
61
+ * ONE unique index per PAGE: `tenant_id + scope_context + scope_field + page`.
62
+ *
63
+ * The OLD index `{ tenant_id, scope_context, scope_field, day_index }` must NOT survive:
64
+ * period pages all carry `day_index: null`, so it would reject the second page of a
65
+ * month. The OWNER deploy step
66
+ * (`simulations/migrate-delivery-report-indexes.ts --apply`) drops the legacy index by
67
+ * name/key before creating this one. No service calls `ensureMaterializedReportIndexes`
68
+ * automatically; the discounts entry collection has the same migration posture.
69
+ *
70
+ * The same key also serves the multi-page read (tenant + scope prefix, then the pages).
50
71
  */
51
72
  exports.MATERIALIZED_TENANT_DELIVERY_ENTRIES_COLLECTION_INDEXES = {
52
73
  _id: { _id: 1 },
53
- tenant_id__scope_context__scope_field__day_index: {
74
+ tenant_id__scope_context__scope_field__page: {
54
75
  tenant_id: 1,
55
76
  scope_context: 1,
56
77
  scope_field: 1,
57
- day_index: 1,
78
+ page: 1,
58
79
  },
59
80
  };
60
81
  exports.MATERIALIZED_TENANT_DELIVERY_ENTRIES_INDEX_OPTIONS = [
61
82
  {
62
- key: { tenant_id: 1, scope_context: 1, scope_field: 1, day_index: 1 },
63
- name: 'tenant_id__scope_context__scope_field__day_index',
83
+ key: { tenant_id: 1, scope_context: 1, scope_field: 1, page: 1 },
84
+ name: 'tenant_id__scope_context__scope_field__page',
64
85
  unique: true,
65
86
  },
66
87
  ];
@@ -0,0 +1,129 @@
1
+ import { Schema } from 'mongoose';
2
+ /**
3
+ * Mongoose schema for `materialized_tenant_delivery_geo_cells`.
4
+ *
5
+ * `location` is `Mixed` and DELIBERATELY has no default: the unknown bucket must be
6
+ * written WITHOUT the field, because a 2dsphere index cannot extract a geo key from
7
+ * `null`. A missing field is simply not indexed, which is exactly the intent - the
8
+ * unknown aggregate must never be plottable.
9
+ *
10
+ * `city` is nullable: an order whose joined `delivery_details` has no city still
11
+ * counts in the cell (the position is what the heat map plots), it just carries no
12
+ * label.
13
+ */
14
+ export declare const MaterializedTenantDeliveryGeoCellSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, {
15
+ timestamps: true;
16
+ versionKey: false;
17
+ }, {
18
+ createdAt: NativeDate;
19
+ updatedAt: NativeDate;
20
+ } & {
21
+ createdAt: NativeDate;
22
+ updatedAt: NativeDate;
23
+ brand_id: string;
24
+ tenant_id: string;
25
+ city: string;
26
+ orders: number;
27
+ scope_context: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_REPORT_SCOPE_ENUM;
28
+ scope_field: string;
29
+ schema_version: number;
30
+ computed_at: NativeDate;
31
+ resolution: number;
32
+ h3_cell: string;
33
+ app_orders: number;
34
+ delivery_records: number;
35
+ completed: number;
36
+ cancelled: number;
37
+ net_sale_amount: number;
38
+ delivery_charge_amount: number;
39
+ rider_revenue_amount: number;
40
+ location?: any;
41
+ by_key?: any;
42
+ }, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
43
+ createdAt: NativeDate;
44
+ updatedAt: NativeDate;
45
+ } & {
46
+ createdAt: NativeDate;
47
+ updatedAt: NativeDate;
48
+ brand_id: string;
49
+ tenant_id: string;
50
+ city: string;
51
+ orders: number;
52
+ scope_context: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_REPORT_SCOPE_ENUM;
53
+ scope_field: string;
54
+ schema_version: number;
55
+ computed_at: NativeDate;
56
+ resolution: number;
57
+ h3_cell: string;
58
+ app_orders: number;
59
+ delivery_records: number;
60
+ completed: number;
61
+ cancelled: number;
62
+ net_sale_amount: number;
63
+ delivery_charge_amount: number;
64
+ rider_revenue_amount: number;
65
+ location?: any;
66
+ by_key?: any;
67
+ }>> & import("mongoose").FlatRecord<{
68
+ createdAt: NativeDate;
69
+ updatedAt: NativeDate;
70
+ } & {
71
+ createdAt: NativeDate;
72
+ updatedAt: NativeDate;
73
+ brand_id: string;
74
+ tenant_id: string;
75
+ city: string;
76
+ orders: number;
77
+ scope_context: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_REPORT_SCOPE_ENUM;
78
+ scope_field: string;
79
+ schema_version: number;
80
+ computed_at: NativeDate;
81
+ resolution: number;
82
+ h3_cell: string;
83
+ app_orders: number;
84
+ delivery_records: number;
85
+ completed: number;
86
+ cancelled: number;
87
+ net_sale_amount: number;
88
+ delivery_charge_amount: number;
89
+ rider_revenue_amount: number;
90
+ location?: any;
91
+ by_key?: any;
92
+ }> & {
93
+ _id: import("mongoose").Types.ObjectId;
94
+ } & {
95
+ __v: number;
96
+ }>;
97
+ export declare const MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_COLLECTION_NAME = "materialized_tenant_delivery_geo_cells";
98
+ /**
99
+ * The indexes the heat reads/writes assume:
100
+ * 1. the UNIQUE cell identity (one document per tenant/scope/cell);
101
+ * 2. the map's read path - a scope, busiest cells first;
102
+ * 3. the 2dsphere index a future viewport `$geoWithin` read needs.
103
+ *
104
+ * The unknown bucket has no `location`, so it is absent from (3) by design.
105
+ */
106
+ export declare const MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_COLLECTION_INDEXES: {
107
+ _id: {
108
+ _id: number;
109
+ };
110
+ tenant_id__scope_context__scope_field__h3_cell: {
111
+ tenant_id: number;
112
+ scope_context: number;
113
+ scope_field: number;
114
+ h3_cell: number;
115
+ };
116
+ scope_context__scope_field__orders: {
117
+ scope_context: number;
118
+ scope_field: number;
119
+ orders: number;
120
+ };
121
+ location__2dsphere: {
122
+ location: string;
123
+ };
124
+ };
125
+ export declare const MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_INDEX_OPTIONS: ReadonlyArray<{
126
+ key: Record<string, number | string>;
127
+ name: string;
128
+ unique?: boolean;
129
+ }>;
@@ -0,0 +1,86 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_INDEX_OPTIONS = exports.MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_COLLECTION_INDEXES = exports.MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_COLLECTION_NAME = exports.MaterializedTenantDeliveryGeoCellSchema = void 0;
4
+ const mongoose_1 = require("mongoose");
5
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
6
+ /**
7
+ * Mongoose schema for `materialized_tenant_delivery_geo_cells`.
8
+ *
9
+ * `location` is `Mixed` and DELIBERATELY has no default: the unknown bucket must be
10
+ * written WITHOUT the field, because a 2dsphere index cannot extract a geo key from
11
+ * `null`. A missing field is simply not indexed, which is exactly the intent - the
12
+ * unknown aggregate must never be plottable.
13
+ *
14
+ * `city` is nullable: an order whose joined `delivery_details` has no city still
15
+ * counts in the cell (the position is what the heat map plots), it just carries no
16
+ * label.
17
+ */
18
+ exports.MaterializedTenantDeliveryGeoCellSchema = new mongoose_1.Schema({
19
+ tenant_id: { type: String, required: true },
20
+ brand_id: { type: String, required: true },
21
+ scope_context: { type: String, required: true, enum: MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_GEO_SCOPES },
22
+ scope_field: { type: String, required: true },
23
+ city: { type: String, default: null },
24
+ h3_cell: { type: String, required: true },
25
+ resolution: { type: Number, required: true, min: 0, max: 15 },
26
+ location: { type: mongoose_1.Schema.Types.Mixed, required: false },
27
+ /** Bounded ORDER_STATUS:PLATFORM:CITY counters; sum equals the top-level counters. */
28
+ by_key: { type: mongoose_1.Schema.Types.Mixed, required: false, default: null },
29
+ // ---- counters (integer counts; money in CENTS) ----
30
+ orders: { type: Number, required: true, min: 0, default: 0 },
31
+ app_orders: { type: Number, required: true, min: 0, default: 0 },
32
+ delivery_records: { type: Number, required: true, min: 0, default: 0 },
33
+ completed: { type: Number, required: true, min: 0, default: 0 },
34
+ cancelled: { type: Number, required: true, min: 0, default: 0 },
35
+ net_sale_amount: { type: Number, required: true, default: 0 },
36
+ delivery_charge_amount: { type: Number, required: true, default: 0 },
37
+ rider_revenue_amount: { type: Number, required: true, default: 0 },
38
+ schema_version: {
39
+ type: Number,
40
+ required: true,
41
+ immutable: true,
42
+ default: MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_SCHEMA_VERSION,
43
+ },
44
+ computed_at: { type: mongoose_1.Schema.Types.Date, required: true },
45
+ createdAt: { type: mongoose_1.Schema.Types.Date, required: true, default: () => new Date(), immutable: true },
46
+ updatedAt: { type: mongoose_1.Schema.Types.Date, required: true, default: () => new Date() },
47
+ }, { timestamps: true, versionKey: false });
48
+ exports.MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_COLLECTION_NAME = 'materialized_tenant_delivery_geo_cells';
49
+ /**
50
+ * The indexes the heat reads/writes assume:
51
+ * 1. the UNIQUE cell identity (one document per tenant/scope/cell);
52
+ * 2. the map's read path - a scope, busiest cells first;
53
+ * 3. the 2dsphere index a future viewport `$geoWithin` read needs.
54
+ *
55
+ * The unknown bucket has no `location`, so it is absent from (3) by design.
56
+ */
57
+ exports.MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_COLLECTION_INDEXES = {
58
+ _id: { _id: 1 },
59
+ tenant_id__scope_context__scope_field__h3_cell: {
60
+ tenant_id: 1,
61
+ scope_context: 1,
62
+ scope_field: 1,
63
+ h3_cell: 1,
64
+ },
65
+ scope_context__scope_field__orders: {
66
+ scope_context: 1,
67
+ scope_field: 1,
68
+ orders: -1,
69
+ },
70
+ location__2dsphere: { location: '2dsphere' },
71
+ };
72
+ exports.MATERIALIZED_TENANT_DELIVERY_GEO_CELLS_INDEX_OPTIONS = [
73
+ {
74
+ key: { tenant_id: 1, scope_context: 1, scope_field: 1, h3_cell: 1 },
75
+ name: 'tenant_id__scope_context__scope_field__h3_cell',
76
+ unique: true,
77
+ },
78
+ {
79
+ key: { scope_context: 1, scope_field: 1, orders: -1 },
80
+ name: 'scope_context__scope_field__orders',
81
+ },
82
+ {
83
+ key: { location: '2dsphere' },
84
+ name: 'location__2dsphere',
85
+ },
86
+ ];
@@ -0,0 +1,71 @@
1
+ import { Schema } from 'mongoose';
2
+ /** Per-scope cap metadata; never one document per cell. */
3
+ export declare const MaterializedTenantDeliveryGeoScopeSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, {
4
+ timestamps: true;
5
+ versionKey: false;
6
+ }, {
7
+ createdAt: NativeDate;
8
+ updatedAt: NativeDate;
9
+ } & {
10
+ createdAt: NativeDate;
11
+ updatedAt: NativeDate;
12
+ brand_id: string;
13
+ tenant_id: string;
14
+ scope_context: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_REPORT_SCOPE_ENUM;
15
+ scope_field: string;
16
+ schema_version: number;
17
+ computed_at: NativeDate;
18
+ capped_cell_count: number;
19
+ capped_order_count: number;
20
+ }, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
21
+ createdAt: NativeDate;
22
+ updatedAt: NativeDate;
23
+ } & {
24
+ createdAt: NativeDate;
25
+ updatedAt: NativeDate;
26
+ brand_id: string;
27
+ tenant_id: string;
28
+ scope_context: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_REPORT_SCOPE_ENUM;
29
+ scope_field: string;
30
+ schema_version: number;
31
+ computed_at: NativeDate;
32
+ capped_cell_count: number;
33
+ capped_order_count: number;
34
+ }>> & import("mongoose").FlatRecord<{
35
+ createdAt: NativeDate;
36
+ updatedAt: NativeDate;
37
+ } & {
38
+ createdAt: NativeDate;
39
+ updatedAt: NativeDate;
40
+ brand_id: string;
41
+ tenant_id: string;
42
+ scope_context: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_REPORT_SCOPE_ENUM;
43
+ scope_field: string;
44
+ schema_version: number;
45
+ computed_at: NativeDate;
46
+ capped_cell_count: number;
47
+ capped_order_count: number;
48
+ }> & {
49
+ _id: import("mongoose").Types.ObjectId;
50
+ } & {
51
+ __v: number;
52
+ }>;
53
+ export declare const MATERIALIZED_TENANT_DELIVERY_GEO_SCOPES_COLLECTION_INDEXES: {
54
+ _id: {
55
+ _id: number;
56
+ };
57
+ tenant_id__scope_context__scope_field: {
58
+ tenant_id: number;
59
+ scope_context: number;
60
+ scope_field: number;
61
+ };
62
+ };
63
+ export declare const MATERIALIZED_TENANT_DELIVERY_GEO_SCOPES_INDEX_OPTIONS: {
64
+ key: {
65
+ tenant_id: number;
66
+ scope_context: number;
67
+ scope_field: number;
68
+ };
69
+ name: string;
70
+ unique: boolean;
71
+ }[];
@@ -0,0 +1,38 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.MATERIALIZED_TENANT_DELIVERY_GEO_SCOPES_INDEX_OPTIONS = exports.MATERIALIZED_TENANT_DELIVERY_GEO_SCOPES_COLLECTION_INDEXES = exports.MaterializedTenantDeliveryGeoScopeSchema = void 0;
4
+ const mongoose_1 = require("mongoose");
5
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
6
+ /** Per-scope cap metadata; never one document per cell. */
7
+ exports.MaterializedTenantDeliveryGeoScopeSchema = new mongoose_1.Schema({
8
+ tenant_id: { type: String, required: true },
9
+ brand_id: { type: String, required: true },
10
+ scope_context: { type: String, required: true, enum: MATERIALIZED_REPORTS_1.MATERIALIZED_DELIVERY_GEO_SCOPES },
11
+ scope_field: { type: String, required: true },
12
+ capped_cell_count: { type: Number, required: true, min: 0, default: 0 },
13
+ capped_order_count: { type: Number, required: true, min: 0, default: 0 },
14
+ schema_version: {
15
+ type: Number,
16
+ required: true,
17
+ immutable: true,
18
+ default: MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_DELIVERY_GEO_SCOPES_SCHEMA_VERSION,
19
+ },
20
+ computed_at: { type: mongoose_1.Schema.Types.Date, required: true },
21
+ createdAt: { type: mongoose_1.Schema.Types.Date, required: true, default: () => new Date(), immutable: true },
22
+ updatedAt: { type: mongoose_1.Schema.Types.Date, required: true, default: () => new Date() },
23
+ }, { timestamps: true, versionKey: false });
24
+ exports.MATERIALIZED_TENANT_DELIVERY_GEO_SCOPES_COLLECTION_INDEXES = {
25
+ _id: { _id: 1 },
26
+ tenant_id__scope_context__scope_field: {
27
+ tenant_id: 1,
28
+ scope_context: 1,
29
+ scope_field: 1,
30
+ },
31
+ };
32
+ exports.MATERIALIZED_TENANT_DELIVERY_GEO_SCOPES_INDEX_OPTIONS = [
33
+ {
34
+ key: { tenant_id: 1, scope_context: 1, scope_field: 1 },
35
+ name: 'tenant_id__scope_context__scope_field',
36
+ unique: true,
37
+ },
38
+ ];
@@ -6,7 +6,16 @@ import { Schema } from 'mongoose';
6
6
  * bounded sub-documents (rider / area leaderboards with an hour heat map), which Mongoose
7
7
  * cannot type precisely without a fixed key set - the keys ARE the data.
8
8
  */
9
- export declare const MATERIALIZED_TENANT_DELIVERY_REPORTS_SCHEMA_VERSION = 1;
9
+ /**
10
+ * v2 - the production day-close writer.
11
+ *
12
+ * v1 was the pre-production shape. v2 splits the AREA row into the ORDER-side
13
+ * (`delivery_orders`, net sale, fees) and the APP-side (`delivery_records`, payout)
14
+ * populations, keys the demand heat on the joined ORDER's `localHour`, and fixes the
15
+ * refund source to the payment rows. A v1 document is still readable: the formatter
16
+ * falls back to the old `count` field for the record total.
17
+ */
18
+ export declare const MATERIALIZED_TENANT_DELIVERY_REPORTS_SCHEMA_VERSION = 2;
10
19
  export declare const MaterializedTenantDeliveryReportSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, {
11
20
  timestamps: true;
12
21
  versionKey: false;
@@ -11,7 +11,16 @@ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
11
11
  * bounded sub-documents (rider / area leaderboards with an hour heat map), which Mongoose
12
12
  * cannot type precisely without a fixed key set - the keys ARE the data.
13
13
  */
14
- exports.MATERIALIZED_TENANT_DELIVERY_REPORTS_SCHEMA_VERSION = 1;
14
+ /**
15
+ * v2 - the production day-close writer.
16
+ *
17
+ * v1 was the pre-production shape. v2 splits the AREA row into the ORDER-side
18
+ * (`delivery_orders`, net sale, fees) and the APP-side (`delivery_records`, payout)
19
+ * populations, keys the demand heat on the joined ORDER's `localHour`, and fixes the
20
+ * refund source to the payment rows. A v1 document is still readable: the formatter
21
+ * falls back to the old `count` field for the record total.
22
+ */
23
+ exports.MATERIALIZED_TENANT_DELIVERY_REPORTS_SCHEMA_VERSION = 2;
15
24
  exports.MaterializedTenantDeliveryReportSchema = new mongoose_1.Schema({
16
25
  tenant_id: { type: String, required: true },
17
26
  brand_id: { type: String, required: true },
@@ -24,8 +24,8 @@ declare const DiscountSourceKeyMetricsSchema: Schema<any, import("mongoose").Mod
24
24
  discount_amount: number;
25
25
  order_count: number;
26
26
  key: string;
27
- covered_amount: number;
28
27
  row_count: number;
28
+ covered_amount: number;
29
29
  free_item_count: number;
30
30
  free_item_value: number;
31
31
  percentage_row_count: number;
@@ -35,8 +35,8 @@ declare const DiscountSourceKeyMetricsSchema: Schema<any, import("mongoose").Mod
35
35
  discount_amount: number;
36
36
  order_count: number;
37
37
  key: string;
38
- covered_amount: number;
39
38
  row_count: number;
39
+ covered_amount: number;
40
40
  free_item_count: number;
41
41
  free_item_value: number;
42
42
  percentage_row_count: number;
@@ -46,8 +46,8 @@ declare const DiscountSourceKeyMetricsSchema: Schema<any, import("mongoose").Mod
46
46
  discount_amount: number;
47
47
  order_count: number;
48
48
  key: string;
49
- covered_amount: number;
50
49
  row_count: number;
50
+ covered_amount: number;
51
51
  free_item_count: number;
52
52
  free_item_value: number;
53
53
  percentage_row_count: number;
@@ -83,12 +83,12 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
83
83
  schema_version: number;
84
84
  source_watermark: NativeDate;
85
85
  computed_at: NativeDate;
86
+ row_count: number;
86
87
  kind: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_ENTRY_KIND_ENUM;
87
88
  sub_kind: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_SUB_KIND_ENUM;
88
89
  level: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_LEVEL_ENUM;
89
90
  complimentary_full: boolean;
90
91
  covered_amount: number;
91
- row_count: number;
92
92
  free_item_count: number;
93
93
  free_item_value: number;
94
94
  percentage_row_count: number;
@@ -101,8 +101,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
101
101
  discount_amount: number;
102
102
  order_count: number;
103
103
  key: string;
104
- covered_amount: number;
105
104
  row_count: number;
105
+ covered_amount: number;
106
106
  free_item_count: number;
107
107
  free_item_value: number;
108
108
  percentage_row_count: number;
@@ -112,8 +112,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
112
112
  discount_amount: number;
113
113
  order_count: number;
114
114
  key: string;
115
- covered_amount: number;
116
115
  row_count: number;
116
+ covered_amount: number;
117
117
  free_item_count: number;
118
118
  free_item_value: number;
119
119
  percentage_row_count: number;
@@ -123,8 +123,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
123
123
  discount_amount: number;
124
124
  order_count: number;
125
125
  key: string;
126
- covered_amount: number;
127
126
  row_count: number;
127
+ covered_amount: number;
128
128
  free_item_count: number;
129
129
  free_item_value: number;
130
130
  percentage_row_count: number;
@@ -152,12 +152,12 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
152
152
  schema_version: number;
153
153
  source_watermark: NativeDate;
154
154
  computed_at: NativeDate;
155
+ row_count: number;
155
156
  kind: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_ENTRY_KIND_ENUM;
156
157
  sub_kind: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_SUB_KIND_ENUM;
157
158
  level: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_LEVEL_ENUM;
158
159
  complimentary_full: boolean;
159
160
  covered_amount: number;
160
- row_count: number;
161
161
  free_item_count: number;
162
162
  free_item_value: number;
163
163
  percentage_row_count: number;
@@ -170,8 +170,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
170
170
  discount_amount: number;
171
171
  order_count: number;
172
172
  key: string;
173
- covered_amount: number;
174
173
  row_count: number;
174
+ covered_amount: number;
175
175
  free_item_count: number;
176
176
  free_item_value: number;
177
177
  percentage_row_count: number;
@@ -181,8 +181,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
181
181
  discount_amount: number;
182
182
  order_count: number;
183
183
  key: string;
184
- covered_amount: number;
185
184
  row_count: number;
185
+ covered_amount: number;
186
186
  free_item_count: number;
187
187
  free_item_value: number;
188
188
  percentage_row_count: number;
@@ -192,8 +192,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
192
192
  discount_amount: number;
193
193
  order_count: number;
194
194
  key: string;
195
- covered_amount: number;
196
195
  row_count: number;
196
+ covered_amount: number;
197
197
  free_item_count: number;
198
198
  free_item_value: number;
199
199
  percentage_row_count: number;
@@ -221,12 +221,12 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
221
221
  schema_version: number;
222
222
  source_watermark: NativeDate;
223
223
  computed_at: NativeDate;
224
+ row_count: number;
224
225
  kind: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_ENTRY_KIND_ENUM;
225
226
  sub_kind: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_SUB_KIND_ENUM;
226
227
  level: import("../../constants/MATERIALIZED_REPORTS").MATERIALIZED_DISCOUNT_LEVEL_ENUM;
227
228
  complimentary_full: boolean;
228
229
  covered_amount: number;
229
- row_count: number;
230
230
  free_item_count: number;
231
231
  free_item_value: number;
232
232
  percentage_row_count: number;
@@ -239,8 +239,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
239
239
  discount_amount: number;
240
240
  order_count: number;
241
241
  key: string;
242
- covered_amount: number;
243
242
  row_count: number;
243
+ covered_amount: number;
244
244
  free_item_count: number;
245
245
  free_item_value: number;
246
246
  percentage_row_count: number;
@@ -250,8 +250,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
250
250
  discount_amount: number;
251
251
  order_count: number;
252
252
  key: string;
253
- covered_amount: number;
254
253
  row_count: number;
254
+ covered_amount: number;
255
255
  free_item_count: number;
256
256
  free_item_value: number;
257
257
  percentage_row_count: number;
@@ -261,8 +261,8 @@ export declare const MaterializedTenantDiscountSourceSchema: Schema<any, import(
261
261
  discount_amount: number;
262
262
  order_count: number;
263
263
  key: string;
264
- covered_amount: number;
265
264
  row_count: number;
265
+ covered_amount: number;
266
266
  free_item_count: number;
267
267
  free_item_value: number;
268
268
  percentage_row_count: number;
@@ -31,17 +31,26 @@ export * from './item_transactions';
31
31
  export * from './items';
32
32
  export * from './marketing_fingerprints';
33
33
  export * from './materialized_credit_bills';
34
- export * from './materialized_tenant_discount_entries';
35
- export * from './materialized_tenant_discount_reports';
36
- export * from './materialized_tenant_discount_sources';
34
+ export * from './materialized_report_drilldown_rows';
35
+ export * from './materialized_rider_daily_reports';
37
36
  export * from './materialized_tenant_cash_entries';
37
+ export * from './materialized_tenant_cash_reports';
38
38
  export * from './materialized_tenant_delivery_entries';
39
+ export * from './materialized_tenant_delivery_geo_cells';
40
+ export * from './materialized_tenant_delivery_geo_scopes';
39
41
  export * from './materialized_tenant_delivery_reports';
40
- export * from './materialized_rider_daily_reports';
41
- export * from './materialized_tenant_cash_reports';
42
+ export * from './materialized_tenant_discount_entries';
43
+ export * from './materialized_tenant_discount_reports';
44
+ export * from './materialized_tenant_discount_sources';
45
+ export * from './materialized_tenant_hourly_comparison_entries';
46
+ export * from './materialized_tenant_hourly_comparison_reports';
47
+ export * from './materialized_tenant_payments_comparison_entries';
48
+ export * from './materialized_tenant_payments_comparison_reports';
42
49
  export * from './materialized_tenant_prep_time_entries';
43
50
  export * from './materialized_tenant_prep_time_reports';
44
51
  export * from './materialized_tenant_reports_iterations';
52
+ export * from './materialized_tenant_sales_comparison_entries';
53
+ export * from './materialized_tenant_sales_comparison_reports';
45
54
  export * from './materialized_tenant_sales_overview_reports';
46
55
  export * from './menus';
47
56
  export * from './messaging_devices';
@@ -124,10 +133,3 @@ export * from './warehouse_vendors';
124
133
  export * from './warehouse_void_purchase_order_items';
125
134
  export * from './warehouse_void_sale_order_items';
126
135
  export * from './warehouses';
127
- export * from './materialized_tenant_sales_comparison_reports';
128
- export * from './materialized_tenant_sales_comparison_entries';
129
- export * from './materialized_tenant_hourly_comparison_reports';
130
- export * from './materialized_tenant_hourly_comparison_entries';
131
- export * from './materialized_tenant_payments_comparison_reports';
132
- export * from './materialized_tenant_payments_comparison_entries';
133
- export * from './materialized_report_drilldown_rows';