@managesome/eposmatic-toolkit 0.4.61 → 0.4.63

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 (122) hide show
  1. package/esm/constants/MATERIALIZED_REPORTS.js +77 -0
  2. package/esm/constants/MATERIALIZED_SCHEMA_VERSIONS.js +17 -0
  3. package/esm/constants/TENANT_ENUMS.js +15 -0
  4. package/esm/constants/WORKER_ENDPOINTS.js +14 -2
  5. package/esm/helpers/materialized-reports/index.js +4 -0
  6. package/esm/helpers/materialized-reports/materialized-credit-bills-helpers.js +3 -3
  7. package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +5 -5
  8. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +2 -2
  9. package/esm/helpers/materialized-reports/materialized-dialer-close-day-helpers.js +5 -5
  10. package/esm/helpers/materialized-reports/materialized-dialer-compile-helpers.js +2 -2
  11. package/esm/helpers/materialized-reports/materialized-dinein-close-day-helpers.js +5 -5
  12. package/esm/helpers/materialized-reports/materialized-dinein-compile-helpers.js +2 -2
  13. package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +3 -3
  14. package/esm/helpers/materialized-reports/materialized-document-size.js +2 -2
  15. package/esm/helpers/materialized-reports/materialized-index-bootstrap.js +3 -1
  16. package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +3 -3
  17. package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +3 -3
  18. package/esm/helpers/materialized-reports/materialized-report-runs.js +143 -0
  19. package/esm/helpers/materialized-reports/report-compile.js +38 -0
  20. package/esm/helpers/materialized-reports/tenant-sales-overview-bson.js +27 -0
  21. package/esm/helpers/materialized-reports/tenant-sales-overview-helpers.js +3 -22
  22. package/esm/schemas/models/index.js +1 -0
  23. package/esm/schemas/models/materialized_credit_bills.js +2 -1
  24. package/esm/schemas/models/materialized_tenant_delivery_entries.js +2 -1
  25. package/esm/schemas/models/materialized_tenant_delivery_reports.js +2 -1
  26. package/esm/schemas/models/materialized_tenant_dialer_entries.js +2 -1
  27. package/esm/schemas/models/materialized_tenant_dialer_reports.js +2 -1
  28. package/esm/schemas/models/materialized_tenant_dinein_entries.js +2 -1
  29. package/esm/schemas/models/materialized_tenant_dinein_reports.js +2 -1
  30. package/esm/schemas/models/materialized_tenant_report_runs.js +105 -0
  31. package/esm/schemas/models/materialized_tenant_sales_overview_reports.js +2 -1
  32. package/esm/schemas/models/tenant_active_jobs.js +19 -1
  33. package/esm/schemas/types/index.js +1 -0
  34. package/lib/constants/MATERIALIZED_REPORTS.d.ts +69 -0
  35. package/lib/constants/MATERIALIZED_REPORTS.js +78 -1
  36. package/lib/constants/MATERIALIZED_SCHEMA_VERSIONS.d.ts +17 -0
  37. package/lib/constants/MATERIALIZED_SCHEMA_VERSIONS.js +20 -0
  38. package/lib/constants/TENANT_ENUMS.d.ts +14 -0
  39. package/lib/constants/TENANT_ENUMS.js +16 -1
  40. package/lib/constants/WORKER_ENDPOINTS.d.ts +12 -2
  41. package/lib/constants/WORKER_ENDPOINTS.js +14 -2
  42. package/lib/helpers/materialized-reports/index.d.ts +3 -0
  43. package/lib/helpers/materialized-reports/index.js +27 -0
  44. package/lib/helpers/materialized-reports/materialized-credit-bills-helpers.js +4 -4
  45. package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +6 -6
  46. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +4 -4
  47. package/lib/helpers/materialized-reports/materialized-dialer-close-day-helpers.js +6 -6
  48. package/lib/helpers/materialized-reports/materialized-dialer-compile-helpers.js +6 -6
  49. package/lib/helpers/materialized-reports/materialized-dinein-close-day-helpers.js +6 -6
  50. package/lib/helpers/materialized-reports/materialized-dinein-compile-helpers.js +6 -6
  51. package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +3 -3
  52. package/lib/helpers/materialized-reports/materialized-document-size.js +2 -5
  53. package/lib/helpers/materialized-reports/materialized-index-bootstrap.js +2 -0
  54. package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +3 -3
  55. package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +3 -3
  56. package/lib/helpers/materialized-reports/materialized-report-runs.d.ts +105 -0
  57. package/lib/helpers/materialized-reports/materialized-report-runs.js +156 -0
  58. package/lib/helpers/materialized-reports/report-compile.d.ts +38 -0
  59. package/lib/helpers/materialized-reports/report-compile.js +87 -0
  60. package/lib/helpers/materialized-reports/tenant-sales-overview-bson.d.ts +12 -0
  61. package/lib/helpers/materialized-reports/tenant-sales-overview-bson.js +33 -0
  62. package/lib/helpers/materialized-reports/tenant-sales-overview-helpers.d.ts +1 -12
  63. package/lib/helpers/materialized-reports/tenant-sales-overview-helpers.js +4 -24
  64. package/lib/helpers/types/workers.d.ts +65 -0
  65. package/lib/schemas/models/index.d.ts +1 -0
  66. package/lib/schemas/models/index.js +1 -0
  67. package/lib/schemas/models/materialized_credit_bills.d.ts +29 -46
  68. package/lib/schemas/models/materialized_credit_bills.js +3 -2
  69. package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +9 -9
  70. package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +9 -9
  71. package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +11 -10
  72. package/lib/schemas/models/materialized_tenant_delivery_entries.js +3 -2
  73. package/lib/schemas/models/materialized_tenant_delivery_geo_cells.d.ts +9 -9
  74. package/lib/schemas/models/materialized_tenant_delivery_geo_scopes.d.ts +6 -6
  75. package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +11 -10
  76. package/lib/schemas/models/materialized_tenant_delivery_reports.js +3 -2
  77. package/lib/schemas/models/materialized_tenant_dialer_entries.d.ts +8 -7
  78. package/lib/schemas/models/materialized_tenant_dialer_entries.js +3 -2
  79. package/lib/schemas/models/materialized_tenant_dialer_reports.d.ts +11 -10
  80. package/lib/schemas/models/materialized_tenant_dialer_reports.js +3 -2
  81. package/lib/schemas/models/materialized_tenant_dinein_entries.d.ts +8 -7
  82. package/lib/schemas/models/materialized_tenant_dinein_entries.js +3 -2
  83. package/lib/schemas/models/materialized_tenant_dinein_reports.d.ts +11 -10
  84. package/lib/schemas/models/materialized_tenant_dinein_reports.js +3 -2
  85. package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +9 -9
  86. package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +9 -9
  87. package/lib/schemas/models/materialized_tenant_discount_sources.d.ts +9 -9
  88. package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +9 -9
  89. package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +9 -9
  90. package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +9 -9
  91. package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +9 -9
  92. package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +9 -9
  93. package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +9 -9
  94. package/lib/schemas/models/materialized_tenant_report_runs.d.ts +97 -0
  95. package/lib/schemas/models/materialized_tenant_report_runs.js +108 -0
  96. package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +9 -9
  97. package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +9 -9
  98. package/lib/schemas/models/materialized_tenant_sales_overview_reports.d.ts +11 -35
  99. package/lib/schemas/models/materialized_tenant_sales_overview_reports.js +3 -2
  100. package/lib/schemas/models/tenant_active_jobs.d.ts +12 -3
  101. package/lib/schemas/models/tenant_active_jobs.js +18 -0
  102. package/lib/schemas/types/index.d.ts +1 -0
  103. package/lib/schemas/types/index.js +1 -0
  104. package/lib/schemas/types/materialized_tenant_report_runs.d.ts +55 -0
  105. package/lib/schemas/types/tenant_active_jobs.d.ts +15 -1
  106. package/lib/tests/materialized-reports/materialized-report-runs.test.js +116 -0
  107. package/lib/tests/materialized-reports/tenant-dinein-formatter.test.js +159 -0
  108. package/lib/tests/materialized-reports/tenant-sales-overview-close-day-helpers.test.js +2 -1
  109. package/lib/tests/materialized-reports/tenant-sales-overview-helpers.test.js +5 -4
  110. package/lib/tests/reporting-contract/no-live-transport.test.js +106 -0
  111. package/package.json +2 -1
  112. package/lib/helpers/order/payment-collection.d.ts +0 -25
  113. package/lib/helpers/order/payment-collection.js +0 -51
  114. package/lib/schemas/models/applied_order_discounts.d.ts +0 -80
  115. package/lib/schemas/models/applied_order_discounts.js +0 -106
  116. package/lib/schemas/types/applied_order_discounts.d.ts +0 -22
  117. package/lib/tests/payment-collection-timestamps.test.d.ts +0 -1
  118. package/lib/tests/payment-collection-timestamps.test.js +0 -71
  119. /package/{lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts → esm/schemas/types/materialized_tenant_report_runs.js} +0 -0
  120. /package/lib/schemas/types/{applied_order_discounts.js → materialized_tenant_report_runs.js} +0 -0
  121. /package/lib/tests/materialized-reports/{analytics-overview-helpers.test.d.ts → materialized-report-runs.test.d.ts} +0 -0
  122. /package/lib/tests/{materialized-reports/analytics-performance-helpers.test.d.ts → reporting-contract/no-live-transport.test.d.ts} +0 -0
@@ -0,0 +1,156 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.materializedReportRunKey = materializedReportRunKey;
4
+ exports.buildMaterializedReportRunFilter = buildMaterializedReportRunFilter;
5
+ exports.isMaterializedReportRunStatus = isMaterializedReportRunStatus;
6
+ exports.isMaterializedReportRunInFlight = isMaterializedReportRunInFlight;
7
+ exports.isMaterializedReportRunCommitOutcomeUnknown = isMaterializedReportRunCommitOutcomeUnknown;
8
+ exports.isMaterializedReadinessOwnedByRun = isMaterializedReadinessOwnedByRun;
9
+ exports.isMaterializedReportRunTerminal = isMaterializedReportRunTerminal;
10
+ exports.materializedReportRunStartedAt = materializedReportRunStartedAt;
11
+ exports.isMaterializedReportRunStale = isMaterializedReportRunStale;
12
+ exports.canRetryMaterializedReportRun = canRetryMaterializedReportRun;
13
+ exports.sanitizeMaterializedReportRunError = sanitizeMaterializedReportRunError;
14
+ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
15
+ /** Stable string key of one run row (Map keys / log correlation). */
16
+ function materializedReportRunKey(parts) {
17
+ return [
18
+ String(parts.tenantId),
19
+ String(parts.localDate),
20
+ String(parts.reportKey),
21
+ String(parts.schemaVersion ?? MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUNS_SCHEMA_VERSION),
22
+ ].join('|');
23
+ }
24
+ /** The Mongo filter of the ONE run row of a report. */
25
+ function buildMaterializedReportRunFilter(parts) {
26
+ return {
27
+ tenant_id: String(parts.tenantId),
28
+ localDate: String(parts.localDate),
29
+ report_key: String(parts.reportKey),
30
+ schema_version: parts.schemaVersion ?? MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUNS_SCHEMA_VERSION,
31
+ };
32
+ }
33
+ function isMaterializedReportRunStatus(value) {
34
+ return Object.values(MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STATUS_ENUM).includes(value);
35
+ }
36
+ /**
37
+ * Is the report CURRENTLY being executed?
38
+ *
39
+ * Only a run that owns the report may be in this state; the retry API refuses
40
+ * it (409) instead of racing the executor.
41
+ */
42
+ function isMaterializedReportRunInFlight(status) {
43
+ return (status === MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STATUS_ENUM.PENDING ||
44
+ status === MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STATUS_ENUM.RUNNING ||
45
+ status === MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STATUS_ENUM.RETRYING);
46
+ }
47
+ /**
48
+ * Does this run carry the UNKNOWN-COMMIT marker?
49
+ *
50
+ * Such a run MUST stay non-terminal until recovery settles it from
51
+ * ownership-checked readiness (a ledger error alone must never decide it).
52
+ */
53
+ function isMaterializedReportRunCommitOutcomeUnknown(run) {
54
+ return String(run?.last_error ?? '') === MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_RUN_COMMIT_OUTCOME_UNKNOWN_ERROR;
55
+ }
56
+ /**
57
+ * Proves that a readiness row belongs to the run that owns this report.
58
+ *
59
+ * The row identity is the tenant/day/report/schema; ownership is the RUN
60
+ * identity. A row written by an OLDER close/re-close carries a DIFFERENT
61
+ * `run_id` and therefore proves nothing about the current run: it must keep the
62
+ * old report readable while the current run is recorded as FAILED
63
+ * (`INTERRUPTED_RUN`) and stays retryable. Never delete that older row.
64
+ */
65
+ function isMaterializedReadinessOwnedByRun(args) {
66
+ const readinessRun = args.readiness?.run_id;
67
+ const currentRun = args.run?.run_id;
68
+ return readinessRun != null && currentRun != null && String(readinessRun) === String(currentRun);
69
+ }
70
+ /** COMMITTED / FAILED: the execution reached a terminal state. */
71
+ function isMaterializedReportRunTerminal(status) {
72
+ return (status === MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STATUS_ENUM.COMMITTED ||
73
+ status === MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STATUS_ENUM.FAILED);
74
+ }
75
+ /**
76
+ * The instant a run started (its `started_at`, or `updatedAt` when a legacy /
77
+ * partial row has none).
78
+ */
79
+ function materializedReportRunStartedAt(run) {
80
+ const candidate = run.started_at ?? run.updatedAt ?? null;
81
+ if (candidate == null)
82
+ return null;
83
+ const date = candidate instanceof Date ? candidate : new Date(candidate);
84
+ return Number.isNaN(date.getTime()) ? null : date;
85
+ }
86
+ /**
87
+ * Is an IN-FLIGHT run old enough that an interruption is plausible?
88
+ *
89
+ * AGE ALONE IS NEVER ENOUGH: recovery must also observe a STALE
90
+ * `tenant_active_jobs` heartbeat, otherwise a healthy long-running report would
91
+ * be taken over. This helper only answers the age question.
92
+ */
93
+ function isMaterializedReportRunStale(args) {
94
+ if (!isMaterializedReportRunInFlight(args.run?.status))
95
+ return false;
96
+ const startedAt = materializedReportRunStartedAt(args.run);
97
+ if (startedAt == null)
98
+ return false;
99
+ const now = args.now ?? new Date();
100
+ const staleAfterMs = Number.isFinite(args.staleAfterMs) && args.staleAfterMs > 0
101
+ ? args.staleAfterMs
102
+ : MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STALE_MS;
103
+ return now.getTime() - startedAt.getTime() >= staleAfterMs;
104
+ }
105
+ /**
106
+ * May this report be retried?
107
+ *
108
+ * A MISSING row is retryable (the report never ran: a failed day, a crash
109
+ * before the first attempt, or a pre-ledger day). A FAILED row is retryable.
110
+ * A COMMITTED row is NOT (the retry would be a no-op), and an in-flight row is
111
+ * NOT (the executor owns it).
112
+ */
113
+ function canRetryMaterializedReportRun(status) {
114
+ if (status == null)
115
+ return true;
116
+ return status === MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_STATUS_ENUM.FAILED;
117
+ }
118
+ /* ------------------------------ PII safety ------------------------------ */
119
+ /**
120
+ * Patterns that must NEVER reach `last_error` (operator-visible, may be logged
121
+ * or exported): e-mail addresses, long digit runs (phone numbers / card-like
122
+ * values) and bearer/basic credentials.
123
+ */
124
+ const PII_PATTERNS = [
125
+ [/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g, '[redacted-email]'],
126
+ // 7+ digits with common separators (phone numbers, card fragments).
127
+ [/(?:\+?\d[\s().-]?){7,}\d/g, '[redacted-number]'],
128
+ [/\b(?:bearer|basic)\s+[A-Za-z0-9._~+/-]+=*/gi, '[redacted-credential]'],
129
+ [/\b(?:password|secret|token|api[_-]?key)\s*[:=]\s*\S+/gi, '[redacted-credential]'],
130
+ ];
131
+ /**
132
+ * Sanitizes an execution error for durable storage / API output.
133
+ *
134
+ * Deliberately conservative: the message is single-lined, PII-redacted and
135
+ * bounded. The ERROR STACK and raw driver payload are never stored.
136
+ */
137
+ function sanitizeMaterializedReportRunError(error) {
138
+ if (error == null)
139
+ return null;
140
+ const raw = typeof error === 'string'
141
+ ? error
142
+ : typeof error.message === 'string'
143
+ ? String(error.message)
144
+ : '';
145
+ let message = raw.replace(/\s+/g, ' ').trim();
146
+ if (message === '') {
147
+ message =
148
+ typeof error.name === 'string'
149
+ ? String(error.name)
150
+ : 'UNKNOWN_ERROR';
151
+ }
152
+ for (const [pattern, replacement] of PII_PATTERNS) {
153
+ message = message.replace(pattern, replacement);
154
+ }
155
+ return message.slice(0, MATERIALIZED_REPORTS_1.MATERIALIZED_TENANT_REPORT_RUN_ERROR_MAX_LENGTH);
156
+ }
@@ -0,0 +1,38 @@
1
+ /**
2
+ * PURE materialized-report COMPILE entrypoint.
3
+ *
4
+ * This module is the workers-service Piscina worker's toolkit surface. Its
5
+ * transitive import graph contains NO mongoose, NO schema model, NO DB
6
+ * initializer and NO model registration: every close-day plan/compile helper
7
+ * was moved to pure modules (schema-version constants live in
8
+ * `constants/MATERIALIZED_SCHEMA_VERSIONS`, ObjectIds are generated with
9
+ * `bson-objectid`, document size uses the `bson` calculator).
10
+ *
11
+ * Import the ROOT toolkit barrel for the service-facing API; import THIS module
12
+ * (or its built `lib/helpers/materialized-reports/report-compile.js` path) from
13
+ * a worker.
14
+ */
15
+ export { MATERIALIZED_DINEIN_ORIGIN_ENUM, MATERIALIZED_DINEIN_REPORT_SCOPES, MATERIALIZED_DINEIN_SPLIT_PARENT_DELETE_REASON, MATERIALIZED_DINEIN_UNKNOWN_TOKEN, MATERIALIZED_PREP_TIME_ITEM_SCOPES, MATERIALIZED_PREP_TIME_REPORT_SCOPES, MATERIALIZED_REPORT_SCOPE_ENUM, } from '../../constants/MATERIALIZED_REPORTS';
16
+ export { MATERIALIZED_CREDIT_BILLS_SCHEMA_VERSION, MATERIALIZED_TENANT_DINEIN_ENTRIES_SCHEMA_VERSION, MATERIALIZED_TENANT_DINEIN_REPORTS_SCHEMA_VERSION, } from '../../constants/MATERIALIZED_SCHEMA_VERSIONS';
17
+ export { SALES_OVERVIEW_KEY_FILTERS } from '../../constants/MATERIALIZED_REPORTS';
18
+ export { REPORT_SALE_TYPE_ENUM } from '../../constants/ANALYTICS';
19
+ export { compileTenantPrepTimeReports } from './materialized-prep-time-compile-helpers';
20
+ export { buildTenantPrepTimeCloseDayPlan, getMaterializedPrepTimePeriodDayScopeFields, getMaterializedPrepTimeReportPeriodDayScopeFields, } from './materialized-prep-time-close-day-helpers';
21
+ export { compileTenantDiscountReports } from './materialized-discount-compile-helpers';
22
+ export { buildTenantDiscountCloseDayPlan } from './materialized-discount-close-day-helpers';
23
+ export { compileTenantDeliveryReports } from './materialized-delivery-compile-helpers';
24
+ export { buildTenantDeliveryCloseDayPlan } from './materialized-delivery-close-day-helpers';
25
+ export { compileTenantDeliveryGeoCellsWithStats } from './materialized-tenant-delivery-geo-helpers';
26
+ export { compileTenantDialerReports } from './materialized-dialer-compile-helpers';
27
+ export { buildTenantDialerCloseDayPlan } from './materialized-dialer-close-day-helpers';
28
+ export { compileTenantDineinReports } from './materialized-dinein-compile-helpers';
29
+ export { buildTenantDineinCloseDayPlan, foldMaterializedDineinPeriodCounters, } from './materialized-dinein-close-day-helpers';
30
+ export { pruneDocumentDineinMaps } from './materialized-dinein-accumulator-helpers';
31
+ export { dineinKeyPassesFilters } from './materialized-dinein-key-helpers';
32
+ export { mergeMaterializedDineinEntryPages } from './materialized-dinein-entry-pages';
33
+ export { getMaterializedPeriodScopeFields, parseMaterializedLocalDate } from './scope-helpers';
34
+ export { REPORT_KEY_ENUM, REPORT_MODE_ENUM, buildReportDetailsResponse, buildReportMeta, buildReportResponse, } from '../reporting-contract/report-contract';
35
+ export { convertOrdersToMaterializedTenantSalesOverviewReports, sumMaterializedTenantSalesOverviewReports, } from './tenant-sales-overview-helpers';
36
+ export { buildTenantSalesOverviewCloseDayPlan } from './tenant-sales-overview-close-day-helpers';
37
+ export { applyCreditResolutionToReportDocuments, buildMaterializedCreditBillSelectionFromScopeGroups, computeMaterializedCreditBillTotalsFromReportsByKey, getMaterializedCreditBillScopeRefsForDay, getMaterializedCreditBillScopeRefsForIssue, resolveCreditBillDay, } from './materialized-credit-bills-helpers';
38
+ export { normalizeOverviewAggregatedShape } from '../reporting-contract/overview-contract';
@@ -0,0 +1,87 @@
1
+ "use strict";
2
+ /**
3
+ * PURE materialized-report COMPILE entrypoint.
4
+ *
5
+ * This module is the workers-service Piscina worker's toolkit surface. Its
6
+ * transitive import graph contains NO mongoose, NO schema model, NO DB
7
+ * initializer and NO model registration: every close-day plan/compile helper
8
+ * was moved to pure modules (schema-version constants live in
9
+ * `constants/MATERIALIZED_SCHEMA_VERSIONS`, ObjectIds are generated with
10
+ * `bson-objectid`, document size uses the `bson` calculator).
11
+ *
12
+ * Import the ROOT toolkit barrel for the service-facing API; import THIS module
13
+ * (or its built `lib/helpers/materialized-reports/report-compile.js` path) from
14
+ * a worker.
15
+ */
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.normalizeOverviewAggregatedShape = exports.resolveCreditBillDay = exports.getMaterializedCreditBillScopeRefsForIssue = exports.getMaterializedCreditBillScopeRefsForDay = exports.computeMaterializedCreditBillTotalsFromReportsByKey = exports.buildMaterializedCreditBillSelectionFromScopeGroups = exports.applyCreditResolutionToReportDocuments = exports.buildTenantSalesOverviewCloseDayPlan = exports.sumMaterializedTenantSalesOverviewReports = exports.convertOrdersToMaterializedTenantSalesOverviewReports = exports.buildReportResponse = exports.buildReportMeta = exports.buildReportDetailsResponse = exports.REPORT_MODE_ENUM = exports.REPORT_KEY_ENUM = exports.parseMaterializedLocalDate = exports.getMaterializedPeriodScopeFields = exports.mergeMaterializedDineinEntryPages = exports.dineinKeyPassesFilters = exports.pruneDocumentDineinMaps = exports.foldMaterializedDineinPeriodCounters = exports.buildTenantDineinCloseDayPlan = exports.compileTenantDineinReports = exports.buildTenantDialerCloseDayPlan = exports.compileTenantDialerReports = exports.compileTenantDeliveryGeoCellsWithStats = exports.buildTenantDeliveryCloseDayPlan = exports.compileTenantDeliveryReports = exports.buildTenantDiscountCloseDayPlan = exports.compileTenantDiscountReports = exports.getMaterializedPrepTimeReportPeriodDayScopeFields = exports.getMaterializedPrepTimePeriodDayScopeFields = exports.buildTenantPrepTimeCloseDayPlan = exports.compileTenantPrepTimeReports = exports.REPORT_SALE_TYPE_ENUM = exports.SALES_OVERVIEW_KEY_FILTERS = exports.MATERIALIZED_TENANT_DINEIN_REPORTS_SCHEMA_VERSION = exports.MATERIALIZED_TENANT_DINEIN_ENTRIES_SCHEMA_VERSION = exports.MATERIALIZED_CREDIT_BILLS_SCHEMA_VERSION = exports.MATERIALIZED_REPORT_SCOPE_ENUM = exports.MATERIALIZED_PREP_TIME_REPORT_SCOPES = exports.MATERIALIZED_PREP_TIME_ITEM_SCOPES = exports.MATERIALIZED_DINEIN_UNKNOWN_TOKEN = exports.MATERIALIZED_DINEIN_SPLIT_PARENT_DELETE_REASON = exports.MATERIALIZED_DINEIN_REPORT_SCOPES = exports.MATERIALIZED_DINEIN_ORIGIN_ENUM = void 0;
18
+ var MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
19
+ Object.defineProperty(exports, "MATERIALIZED_DINEIN_ORIGIN_ENUM", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_1.MATERIALIZED_DINEIN_ORIGIN_ENUM; } });
20
+ Object.defineProperty(exports, "MATERIALIZED_DINEIN_REPORT_SCOPES", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_1.MATERIALIZED_DINEIN_REPORT_SCOPES; } });
21
+ Object.defineProperty(exports, "MATERIALIZED_DINEIN_SPLIT_PARENT_DELETE_REASON", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_1.MATERIALIZED_DINEIN_SPLIT_PARENT_DELETE_REASON; } });
22
+ Object.defineProperty(exports, "MATERIALIZED_DINEIN_UNKNOWN_TOKEN", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_1.MATERIALIZED_DINEIN_UNKNOWN_TOKEN; } });
23
+ Object.defineProperty(exports, "MATERIALIZED_PREP_TIME_ITEM_SCOPES", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_1.MATERIALIZED_PREP_TIME_ITEM_SCOPES; } });
24
+ Object.defineProperty(exports, "MATERIALIZED_PREP_TIME_REPORT_SCOPES", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_1.MATERIALIZED_PREP_TIME_REPORT_SCOPES; } });
25
+ Object.defineProperty(exports, "MATERIALIZED_REPORT_SCOPE_ENUM", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_1.MATERIALIZED_REPORT_SCOPE_ENUM; } });
26
+ var MATERIALIZED_SCHEMA_VERSIONS_1 = require("../../constants/MATERIALIZED_SCHEMA_VERSIONS");
27
+ Object.defineProperty(exports, "MATERIALIZED_CREDIT_BILLS_SCHEMA_VERSION", { enumerable: true, get: function () { return MATERIALIZED_SCHEMA_VERSIONS_1.MATERIALIZED_CREDIT_BILLS_SCHEMA_VERSION; } });
28
+ Object.defineProperty(exports, "MATERIALIZED_TENANT_DINEIN_ENTRIES_SCHEMA_VERSION", { enumerable: true, get: function () { return MATERIALIZED_SCHEMA_VERSIONS_1.MATERIALIZED_TENANT_DINEIN_ENTRIES_SCHEMA_VERSION; } });
29
+ Object.defineProperty(exports, "MATERIALIZED_TENANT_DINEIN_REPORTS_SCHEMA_VERSION", { enumerable: true, get: function () { return MATERIALIZED_SCHEMA_VERSIONS_1.MATERIALIZED_TENANT_DINEIN_REPORTS_SCHEMA_VERSION; } });
30
+ var MATERIALIZED_REPORTS_2 = require("../../constants/MATERIALIZED_REPORTS");
31
+ Object.defineProperty(exports, "SALES_OVERVIEW_KEY_FILTERS", { enumerable: true, get: function () { return MATERIALIZED_REPORTS_2.SALES_OVERVIEW_KEY_FILTERS; } });
32
+ var ANALYTICS_1 = require("../../constants/ANALYTICS");
33
+ Object.defineProperty(exports, "REPORT_SALE_TYPE_ENUM", { enumerable: true, get: function () { return ANALYTICS_1.REPORT_SALE_TYPE_ENUM; } });
34
+ var materialized_prep_time_compile_helpers_1 = require("./materialized-prep-time-compile-helpers");
35
+ Object.defineProperty(exports, "compileTenantPrepTimeReports", { enumerable: true, get: function () { return materialized_prep_time_compile_helpers_1.compileTenantPrepTimeReports; } });
36
+ var materialized_prep_time_close_day_helpers_1 = require("./materialized-prep-time-close-day-helpers");
37
+ Object.defineProperty(exports, "buildTenantPrepTimeCloseDayPlan", { enumerable: true, get: function () { return materialized_prep_time_close_day_helpers_1.buildTenantPrepTimeCloseDayPlan; } });
38
+ Object.defineProperty(exports, "getMaterializedPrepTimePeriodDayScopeFields", { enumerable: true, get: function () { return materialized_prep_time_close_day_helpers_1.getMaterializedPrepTimePeriodDayScopeFields; } });
39
+ Object.defineProperty(exports, "getMaterializedPrepTimeReportPeriodDayScopeFields", { enumerable: true, get: function () { return materialized_prep_time_close_day_helpers_1.getMaterializedPrepTimeReportPeriodDayScopeFields; } });
40
+ var materialized_discount_compile_helpers_1 = require("./materialized-discount-compile-helpers");
41
+ Object.defineProperty(exports, "compileTenantDiscountReports", { enumerable: true, get: function () { return materialized_discount_compile_helpers_1.compileTenantDiscountReports; } });
42
+ var materialized_discount_close_day_helpers_1 = require("./materialized-discount-close-day-helpers");
43
+ Object.defineProperty(exports, "buildTenantDiscountCloseDayPlan", { enumerable: true, get: function () { return materialized_discount_close_day_helpers_1.buildTenantDiscountCloseDayPlan; } });
44
+ var materialized_delivery_compile_helpers_1 = require("./materialized-delivery-compile-helpers");
45
+ Object.defineProperty(exports, "compileTenantDeliveryReports", { enumerable: true, get: function () { return materialized_delivery_compile_helpers_1.compileTenantDeliveryReports; } });
46
+ var materialized_delivery_close_day_helpers_1 = require("./materialized-delivery-close-day-helpers");
47
+ Object.defineProperty(exports, "buildTenantDeliveryCloseDayPlan", { enumerable: true, get: function () { return materialized_delivery_close_day_helpers_1.buildTenantDeliveryCloseDayPlan; } });
48
+ var materialized_tenant_delivery_geo_helpers_1 = require("./materialized-tenant-delivery-geo-helpers");
49
+ Object.defineProperty(exports, "compileTenantDeliveryGeoCellsWithStats", { enumerable: true, get: function () { return materialized_tenant_delivery_geo_helpers_1.compileTenantDeliveryGeoCellsWithStats; } });
50
+ var materialized_dialer_compile_helpers_1 = require("./materialized-dialer-compile-helpers");
51
+ Object.defineProperty(exports, "compileTenantDialerReports", { enumerable: true, get: function () { return materialized_dialer_compile_helpers_1.compileTenantDialerReports; } });
52
+ var materialized_dialer_close_day_helpers_1 = require("./materialized-dialer-close-day-helpers");
53
+ Object.defineProperty(exports, "buildTenantDialerCloseDayPlan", { enumerable: true, get: function () { return materialized_dialer_close_day_helpers_1.buildTenantDialerCloseDayPlan; } });
54
+ var materialized_dinein_compile_helpers_1 = require("./materialized-dinein-compile-helpers");
55
+ Object.defineProperty(exports, "compileTenantDineinReports", { enumerable: true, get: function () { return materialized_dinein_compile_helpers_1.compileTenantDineinReports; } });
56
+ var materialized_dinein_close_day_helpers_1 = require("./materialized-dinein-close-day-helpers");
57
+ Object.defineProperty(exports, "buildTenantDineinCloseDayPlan", { enumerable: true, get: function () { return materialized_dinein_close_day_helpers_1.buildTenantDineinCloseDayPlan; } });
58
+ Object.defineProperty(exports, "foldMaterializedDineinPeriodCounters", { enumerable: true, get: function () { return materialized_dinein_close_day_helpers_1.foldMaterializedDineinPeriodCounters; } });
59
+ var materialized_dinein_accumulator_helpers_1 = require("./materialized-dinein-accumulator-helpers");
60
+ Object.defineProperty(exports, "pruneDocumentDineinMaps", { enumerable: true, get: function () { return materialized_dinein_accumulator_helpers_1.pruneDocumentDineinMaps; } });
61
+ var materialized_dinein_key_helpers_1 = require("./materialized-dinein-key-helpers");
62
+ Object.defineProperty(exports, "dineinKeyPassesFilters", { enumerable: true, get: function () { return materialized_dinein_key_helpers_1.dineinKeyPassesFilters; } });
63
+ var materialized_dinein_entry_pages_1 = require("./materialized-dinein-entry-pages");
64
+ Object.defineProperty(exports, "mergeMaterializedDineinEntryPages", { enumerable: true, get: function () { return materialized_dinein_entry_pages_1.mergeMaterializedDineinEntryPages; } });
65
+ var scope_helpers_1 = require("./scope-helpers");
66
+ Object.defineProperty(exports, "getMaterializedPeriodScopeFields", { enumerable: true, get: function () { return scope_helpers_1.getMaterializedPeriodScopeFields; } });
67
+ Object.defineProperty(exports, "parseMaterializedLocalDate", { enumerable: true, get: function () { return scope_helpers_1.parseMaterializedLocalDate; } });
68
+ var report_contract_1 = require("../reporting-contract/report-contract");
69
+ Object.defineProperty(exports, "REPORT_KEY_ENUM", { enumerable: true, get: function () { return report_contract_1.REPORT_KEY_ENUM; } });
70
+ Object.defineProperty(exports, "REPORT_MODE_ENUM", { enumerable: true, get: function () { return report_contract_1.REPORT_MODE_ENUM; } });
71
+ Object.defineProperty(exports, "buildReportDetailsResponse", { enumerable: true, get: function () { return report_contract_1.buildReportDetailsResponse; } });
72
+ Object.defineProperty(exports, "buildReportMeta", { enumerable: true, get: function () { return report_contract_1.buildReportMeta; } });
73
+ Object.defineProperty(exports, "buildReportResponse", { enumerable: true, get: function () { return report_contract_1.buildReportResponse; } });
74
+ var tenant_sales_overview_helpers_1 = require("./tenant-sales-overview-helpers");
75
+ Object.defineProperty(exports, "convertOrdersToMaterializedTenantSalesOverviewReports", { enumerable: true, get: function () { return tenant_sales_overview_helpers_1.convertOrdersToMaterializedTenantSalesOverviewReports; } });
76
+ Object.defineProperty(exports, "sumMaterializedTenantSalesOverviewReports", { enumerable: true, get: function () { return tenant_sales_overview_helpers_1.sumMaterializedTenantSalesOverviewReports; } });
77
+ var tenant_sales_overview_close_day_helpers_1 = require("./tenant-sales-overview-close-day-helpers");
78
+ Object.defineProperty(exports, "buildTenantSalesOverviewCloseDayPlan", { enumerable: true, get: function () { return tenant_sales_overview_close_day_helpers_1.buildTenantSalesOverviewCloseDayPlan; } });
79
+ var materialized_credit_bills_helpers_1 = require("./materialized-credit-bills-helpers");
80
+ Object.defineProperty(exports, "applyCreditResolutionToReportDocuments", { enumerable: true, get: function () { return materialized_credit_bills_helpers_1.applyCreditResolutionToReportDocuments; } });
81
+ Object.defineProperty(exports, "buildMaterializedCreditBillSelectionFromScopeGroups", { enumerable: true, get: function () { return materialized_credit_bills_helpers_1.buildMaterializedCreditBillSelectionFromScopeGroups; } });
82
+ Object.defineProperty(exports, "computeMaterializedCreditBillTotalsFromReportsByKey", { enumerable: true, get: function () { return materialized_credit_bills_helpers_1.computeMaterializedCreditBillTotalsFromReportsByKey; } });
83
+ Object.defineProperty(exports, "getMaterializedCreditBillScopeRefsForDay", { enumerable: true, get: function () { return materialized_credit_bills_helpers_1.getMaterializedCreditBillScopeRefsForDay; } });
84
+ Object.defineProperty(exports, "getMaterializedCreditBillScopeRefsForIssue", { enumerable: true, get: function () { return materialized_credit_bills_helpers_1.getMaterializedCreditBillScopeRefsForIssue; } });
85
+ Object.defineProperty(exports, "resolveCreditBillDay", { enumerable: true, get: function () { return materialized_credit_bills_helpers_1.resolveCreditBillDay; } });
86
+ var overview_contract_1 = require("../reporting-contract/overview-contract");
87
+ Object.defineProperty(exports, "normalizeOverviewAggregatedShape", { enumerable: true, get: function () { return overview_contract_1.normalizeOverviewAggregatedShape; } });
@@ -0,0 +1,12 @@
1
+ import mongoose from 'mongoose';
2
+ import type { IMaterializedTenantSalesOverviewReport } from '../../schemas/types/materialized_tenant_sales_overview_reports';
3
+ /**
4
+ * Casts a JSON materialized report through the collection's mongoose schema,
5
+ * returning a hydrated document ready to be saved / bulk-written (the
6
+ * `sale_type_metrics` plain object becomes a `Map`, date strings become
7
+ * `Date` instances, etc.).
8
+ *
9
+ * The document is NOT validated here — `save()` / `Model.validate()` still
10
+ * runs the schema validators.
11
+ */
12
+ export declare function convertMaterializedTenantSalesOverviewReportJsonToBson(report: IMaterializedTenantSalesOverviewReport): mongoose.HydratedDocument<IMaterializedTenantSalesOverviewReport>;
@@ -0,0 +1,33 @@
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.convertMaterializedTenantSalesOverviewReportJsonToBson = convertMaterializedTenantSalesOverviewReportJsonToBson;
7
+ const mongoose_1 = __importDefault(require("mongoose"));
8
+ const materialized_tenant_sales_overview_reports_1 = require("../../schemas/models/materialized_tenant_sales_overview_reports");
9
+ /**
10
+ * MAIN-THREAD-ONLY Overview persistence adapter.
11
+ *
12
+ * Deliberately SPLIT from `tenant-sales-overview-helpers.ts`: the compile
13
+ * helpers must stay mongoose-free for the workers-service Piscina compile
14
+ * graph, while the BSON casting step needs the mongoose schema. Importing this
15
+ * file is the ONLY way to pull mongoose into the Overview compile path — and
16
+ * the worker never imports it.
17
+ */
18
+ function getMaterializedTenantSalesOverviewReportModel() {
19
+ return (mongoose_1.default.models[materialized_tenant_sales_overview_reports_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME] ??
20
+ mongoose_1.default.model(materialized_tenant_sales_overview_reports_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME, materialized_tenant_sales_overview_reports_1.MaterializedTenantSalesOverviewReportSchema, materialized_tenant_sales_overview_reports_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME));
21
+ }
22
+ /**
23
+ * Casts a JSON materialized report through the collection's mongoose schema,
24
+ * returning a hydrated document ready to be saved / bulk-written (the
25
+ * `sale_type_metrics` plain object becomes a `Map`, date strings become
26
+ * `Date` instances, etc.).
27
+ *
28
+ * The document is NOT validated here — `save()` / `Model.validate()` still
29
+ * runs the schema validators.
30
+ */
31
+ function convertMaterializedTenantSalesOverviewReportJsonToBson(report) {
32
+ return new (getMaterializedTenantSalesOverviewReportModel())(report);
33
+ }
@@ -1,5 +1,4 @@
1
- import mongoose from 'mongoose';
2
- import { IOrder, IOrderPayment } from '../../schemas';
1
+ import type { IOrder, IOrderPayment } from '../../schemas/types/orders';
3
2
  import { IMaterializedReportKeyMetrics, IMaterializedTenantSalesOverviewReport } from '../../schemas/types/materialized_tenant_sales_overview_reports';
4
3
  import { ICreditBillEventCandidate, ICreditBillIssuedCandidate, isMaterializedCreditBillPayment } from './materialized-credit-bills-helpers';
5
4
  /**
@@ -133,16 +132,6 @@ export declare function normalizeMaterializedSaleTypeMetrics(metrics: IMateriali
133
132
  * missing or containing reserved characters) — `null` means a data issue.
134
133
  */
135
134
  export declare function convertOrdersToMaterializedTenantSalesOverviewReports(localDate: string, orders: IOrder[], options?: IConvertOrdersToMaterializedReportsOptions): IConvertOrdersToMaterializedReportsResult | null;
136
- /**
137
- * Casts a JSON materialized report through the collection's mongoose schema,
138
- * returning a hydrated document ready to be saved / bulk-written (the
139
- * `sale_type_metrics` plain object becomes a `Map`, date strings become
140
- * `Date` instances, etc.).
141
- *
142
- * The document is NOT validated here — `save()` / `Model.validate()` still
143
- * runs the schema validators.
144
- */
145
- export declare function convertMaterializedTenantSalesOverviewReportJsonToBson(report: IMaterializedTenantSalesOverviewReport): mongoose.HydratedDocument<IMaterializedTenantSalesOverviewReport>;
146
135
  /**
147
136
  * Sums materialized reports that share the same tenant, brand, key filters and
148
137
  * `schema_version` — the period accumulation path. The scope MAY differ: pass
@@ -9,14 +9,13 @@ exports.isPaymentIncludedInMaterializedSalesOverview = isPaymentIncludedInMateri
9
9
  exports.getMaterializedPaymentGross = getMaterializedPaymentGross;
10
10
  exports.normalizeMaterializedSaleTypeMetrics = normalizeMaterializedSaleTypeMetrics;
11
11
  exports.convertOrdersToMaterializedTenantSalesOverviewReports = convertOrdersToMaterializedTenantSalesOverviewReports;
12
- exports.convertMaterializedTenantSalesOverviewReportJsonToBson = convertMaterializedTenantSalesOverviewReportJsonToBson;
13
12
  exports.sumMaterializedTenantSalesOverviewReports = sumMaterializedTenantSalesOverviewReports;
14
13
  exports.subtractMaterializedTenantSalesOverviewReports = subtractMaterializedTenantSalesOverviewReports;
15
14
  exports.updateMaterializedTenantSalesOverviewReport = updateMaterializedTenantSalesOverviewReport;
16
- const mongoose_1 = __importDefault(require("mongoose"));
15
+ const bson_objectid_1 = __importDefault(require("bson-objectid"));
16
+ const MATERIALIZED_SCHEMA_VERSIONS_1 = require("../../constants/MATERIALIZED_SCHEMA_VERSIONS");
17
17
  const constants_1 = require("../../constants");
18
18
  const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
19
- const materialized_tenant_sales_overview_reports_1 = require("../../schemas/models/materialized_tenant_sales_overview_reports");
20
19
  const key_helpers_1 = require("./key-helpers");
21
20
  const materialized_day_input_signature_1 = require("./materialized-day-input-signature");
22
21
  const materialized_credit_bills_helpers_1 = require("./materialized-credit-bills-helpers");
@@ -341,7 +340,7 @@ const createEmptyReportDocument = (args) => {
341
340
  ? (0, scope_helpers_1.getDayIndexFromLocalDate)(scopeField.split(' ')[0])
342
341
  : null;
343
342
  return {
344
- _id: new mongoose_1.default.Types.ObjectId().toString(),
343
+ _id: new bson_objectid_1.default().toHexString(),
345
344
  tenant_id: tenantId,
346
345
  brand_id: brandId,
347
346
  scope_context: scopeContext,
@@ -353,7 +352,7 @@ const createEmptyReportDocument = (args) => {
353
352
  // does not run mongoose defaults) persists a schema-conformant document
354
353
  // matching its history row.
355
354
  iteration: 1,
356
- schema_version: materialized_tenant_sales_overview_reports_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_SCHEMA_VERSION,
355
+ schema_version: MATERIALIZED_SCHEMA_VERSIONS_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_SCHEMA_VERSION,
357
356
  source_watermark: now,
358
357
  computed_at: now,
359
358
  createdAt: now,
@@ -546,25 +545,6 @@ function convertOrdersToMaterializedTenantSalesOverviewReports(localDate, orders
546
545
  return { materializedReports, credit_bill_issues: creditBillIssues, credit_bill_events: creditEventCandidates };
547
546
  }
548
547
  /* ------------------------------------------------------------------------ */
549
- /* 2. JSON → BSON (mongoose document) */
550
- /* ------------------------------------------------------------------------ */
551
- function getMaterializedTenantSalesOverviewReportModel() {
552
- return (mongoose_1.default.models[materialized_tenant_sales_overview_reports_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME] ??
553
- mongoose_1.default.model(materialized_tenant_sales_overview_reports_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME, materialized_tenant_sales_overview_reports_1.MaterializedTenantSalesOverviewReportSchema, materialized_tenant_sales_overview_reports_1.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME));
554
- }
555
- /**
556
- * Casts a JSON materialized report through the collection's mongoose schema,
557
- * returning a hydrated document ready to be saved / bulk-written (the
558
- * `sale_type_metrics` plain object becomes a `Map`, date strings become
559
- * `Date` instances, etc.).
560
- *
561
- * The document is NOT validated here — `save()` / `Model.validate()` still
562
- * runs the schema validators.
563
- */
564
- function convertMaterializedTenantSalesOverviewReportJsonToBson(report) {
565
- return new (getMaterializedTenantSalesOverviewReportModel())(report);
566
- }
567
- /* ------------------------------------------------------------------------ */
568
548
  /* 3. Summing documents (period accumulation) */
569
549
  /* ------------------------------------------------------------------------ */
570
550
  const sumOrderMetrics = (target, source) => {
@@ -491,3 +491,68 @@ export interface IWorker_EndTenantDay {
491
491
  /** The business day being closed (tenant_day_sessions doc id). */
492
492
  day_session_id: string;
493
493
  }
494
+ /**
495
+ * INTERNAL report-scoped retry (one report of one tenant-day).
496
+ *
497
+ * The retry re-runs ONLY `report_key`: it writes that report's documents and
498
+ * that report's readiness, never any other report and never the calendar.
499
+ */
500
+ export interface IWorker_RetryMaterializedReport {
501
+ tenant_id: string;
502
+ /** Tenant-local business day, `YYYY-MM-DD` of an EXISTING CLOSED session. */
503
+ localDate: string;
504
+ report_key: string;
505
+ }
506
+ /**
507
+ * Answer of the internal retry endpoint (report-scoped, no PII).
508
+ *
509
+ * ASYNC contract: the endpoint validates + acquires the report lease
510
+ * synchronously and starts the retry in the background, so it answers
511
+ * `accepted: true` with `status: RUNNING` (operations maps it to HTTP 202).
512
+ * The terminal outcome lands in the run ledger and is read by polling.
513
+ */
514
+ export interface IWorker_RetryMaterializedReportResult {
515
+ tenant_id: string;
516
+ localDate: string;
517
+ report_key: string;
518
+ /** Identity of the retry run (its own report-scoped lease token). */
519
+ run_id: string;
520
+ /** `RUNNING` when the retry was accepted. */
521
+ status: string;
522
+ /** True when the retry was accepted and is executing in the background. */
523
+ accepted: boolean;
524
+ /** Latest execution attempts (present once the execution has started). */
525
+ attempts?: number;
526
+ /** Whether readiness was written (only known once the retry finished). */
527
+ readiness_written?: boolean;
528
+ /** Sanitized failure reason; `null` while running / on success. */
529
+ last_error?: string | null;
530
+ }
531
+ /**
532
+ * INTERNAL stale-run reconciliation (workers-owned).
533
+ *
534
+ * Operations calls it before listing runs / before rejecting a RUNNING retry so
535
+ * a crash-interrupted execution converges instead of looking running forever.
536
+ */
537
+ export interface IWorker_ReconcileMaterializedReportRuns {
538
+ tenant_id: string;
539
+ /** `YYYY-MM-DD`; omitted = every day of the tenant (bounded by the worker). */
540
+ localDate?: string;
541
+ /** Omitted = every in-flight report of the tenant/day. */
542
+ report_key?: string;
543
+ }
544
+ export interface IWorker_ReconciledMaterializedReportRun {
545
+ localDate: string;
546
+ report_key: string;
547
+ /** What recovery decided: COMMITTED / FAILED (or a no-op reason). */
548
+ status: string;
549
+ from_status: string;
550
+ reason: string;
551
+ }
552
+ export interface IWorker_ReconcileMaterializedReportRunsResult {
553
+ tenant_id: string;
554
+ /** Ordered decisions (empty = nothing to reconcile). */
555
+ reconciled: IWorker_ReconciledMaterializedReportRun[];
556
+ /** Rows inspected but deliberately left untouched (active/fresh/terminal). */
557
+ skipped: IWorker_ReconciledMaterializedReportRun[];
558
+ }
@@ -49,6 +49,7 @@ export * from './materialized_tenant_payments_comparison_entries';
49
49
  export * from './materialized_tenant_payments_comparison_reports';
50
50
  export * from './materialized_tenant_prep_time_entries';
51
51
  export * from './materialized_tenant_prep_time_reports';
52
+ export * from './materialized_tenant_report_runs';
52
53
  export * from './materialized_tenant_reports_iterations';
53
54
  export * from './materialized_tenant_sales_comparison_entries';
54
55
  export * from './materialized_tenant_sales_comparison_reports';
@@ -65,6 +65,7 @@ __exportStar(require("./materialized_tenant_payments_comparison_entries"), expor
65
65
  __exportStar(require("./materialized_tenant_payments_comparison_reports"), exports);
66
66
  __exportStar(require("./materialized_tenant_prep_time_entries"), exports);
67
67
  __exportStar(require("./materialized_tenant_prep_time_reports"), exports);
68
+ __exportStar(require("./materialized_tenant_report_runs"), exports);
68
69
  __exportStar(require("./materialized_tenant_reports_iterations"), exports);
69
70
  __exportStar(require("./materialized_tenant_sales_comparison_entries"), exports);
70
71
  __exportStar(require("./materialized_tenant_sales_comparison_reports"), exports);