@managesome/eposmatic-toolkit 0.4.26 → 0.4.28

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 (60) hide show
  1. package/esm/helpers/materialized-reports/index.js +1 -0
  2. package/esm/helpers/materialized-reports/materialized-credit-bills-helpers.js +9 -4
  3. package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +25 -9
  4. package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +8 -5
  5. package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +13 -1
  6. package/esm/helpers/materialized-reports/materialized-discount-source-helpers.js +0 -3
  7. package/esm/helpers/materialized-reports/materialized-integer-contract.js +142 -0
  8. package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +7 -1
  9. package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +9 -2
  10. package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +17 -7
  11. package/esm/helpers/materialized-reports/tenant-discount-source-formatter.js +29 -29
  12. package/esm/helpers/materialized-reports/tenant-sales-overview-helpers.js +4 -2
  13. package/esm/helpers/utils/duration-conversion.js +31 -0
  14. package/esm/helpers/utils/index.js +2 -0
  15. package/esm/helpers/utils/percentage-conversion.js +69 -0
  16. package/esm/schemas/models/materialized_tenant_discount_sources.js +5 -1
  17. package/lib/helpers/materialized-reports/index.d.ts +1 -0
  18. package/lib/helpers/materialized-reports/index.js +1 -0
  19. package/lib/helpers/materialized-reports/materialized-credit-bills-helpers.js +9 -4
  20. package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +25 -9
  21. package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +8 -5
  22. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +18 -0
  23. package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +14 -2
  24. package/lib/helpers/materialized-reports/materialized-discount-source-helpers.js +0 -3
  25. package/lib/helpers/materialized-reports/materialized-integer-contract.d.ts +68 -0
  26. package/lib/helpers/materialized-reports/materialized-integer-contract.js +147 -0
  27. package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +7 -1
  28. package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +9 -2
  29. package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +17 -7
  30. package/lib/helpers/materialized-reports/tenant-discount-source-formatter.d.ts +12 -30
  31. package/lib/helpers/materialized-reports/tenant-discount-source-formatter.js +29 -30
  32. package/lib/helpers/materialized-reports/tenant-sales-overview-helpers.js +4 -2
  33. package/lib/helpers/types/materialized-reports-apis.d.ts +11 -3
  34. package/lib/helpers/utils/duration-conversion.d.ts +19 -0
  35. package/lib/helpers/utils/duration-conversion.js +37 -0
  36. package/lib/helpers/utils/index.d.ts +2 -0
  37. package/lib/helpers/utils/index.js +2 -0
  38. package/lib/helpers/utils/percentage-conversion.d.ts +49 -0
  39. package/lib/helpers/utils/percentage-conversion.js +76 -0
  40. package/lib/schemas/models/materialized_tenant_discount_sources.d.ts +0 -3
  41. package/lib/schemas/models/materialized_tenant_discount_sources.js +5 -1
  42. package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +11 -4
  43. package/lib/schemas/types/materialized_tenant_discount_sources.d.ts +23 -4
  44. package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
  45. package/lib/tests/materialized-reports/fixtures.js +118 -8
  46. package/lib/tests/materialized-reports/materialized-discount-classification.test.js +34 -24
  47. package/lib/tests/materialized-reports/materialized-discount-scenarios.test.d.ts +1 -0
  48. package/lib/tests/materialized-reports/materialized-discount-scenarios.test.js +676 -0
  49. package/lib/tests/materialized-reports/materialized-discount-sources.test.js +148 -10
  50. package/lib/tests/materialized-reports/materialized-integer-contract.test.d.ts +1 -0
  51. package/lib/tests/materialized-reports/materialized-integer-contract.test.js +223 -0
  52. package/lib/tests/materialized-reports/materialized-write-paths-inventory.test.d.ts +1 -0
  53. package/lib/tests/materialized-reports/materialized-write-paths-inventory.test.js +58 -0
  54. package/lib/tests/materialized-reports/materialized-writers-integer-only.test.d.ts +1 -0
  55. package/lib/tests/materialized-reports/materialized-writers-integer-only.test.js +150 -0
  56. package/lib/tests/materialized-reports/real-discount-orders.test.d.ts +1 -0
  57. package/lib/tests/materialized-reports/real-discount-orders.test.js +110 -0
  58. package/lib/tests/materialized-reports/sales-overview-baseline.test.js +51 -51
  59. package/lib/tests/materialized-reports/tenant-discount-source-formatter.test.js +89 -41
  60. package/package.json +1 -1
@@ -22,23 +22,30 @@ const CONTEXT = {
22
22
  local_hour: 18,
23
23
  local_hour_label: '2026-09-15 18',
24
24
  };
25
- /** Independently measured (analyze-discount-parity) — basha: 2931 orders. */
25
+ /**
26
+ * Independently measured (analyze-discount-parity) — basha: 2931 orders.
27
+ *
28
+ * RE-MEASURED on the integer storage contract (2026-10-22): the fixtures are
29
+ * upgraded to the contract on load (money → integer cents, a percentage rate →
30
+ * integer basis points), so every money anchor is an integer and every RAW
31
+ * slot anchor is in basis points for a percentage row.
32
+ */
26
33
  const BASHA = {
27
34
  totalCount: 28,
28
- headline: 68811.5,
29
- orderLevel: 49485.5,
35
+ headline: 68813,
36
+ orderLevel: 49487,
30
37
  itemLevel: 19326,
31
38
  itemDiscountRows: 22,
32
39
  unattributed: 0,
33
- orderSpecialRaw: 2459,
34
- orderSpecialResolved: 49485.5,
40
+ orderSpecialRaw: 21269,
41
+ orderSpecialResolved: 49487,
35
42
  orderSpecialCount: 11,
36
43
  orderLoyaltyRaw: 0,
37
44
  orderLoyaltyResolved: 0,
38
45
  orderLoyaltyCount: 0,
39
46
  orderVoucherRaw: 0,
40
47
  orderVoucherResolved: 0,
41
- itemSpecialRaw: 5400,
48
+ itemSpecialRaw: 130140,
42
49
  itemSpecialResolved: 19326,
43
50
  itemSpecialCount: 22,
44
51
  itemSpecialCollectionRaw: 0,
@@ -51,24 +58,24 @@ const BASHA = {
51
58
  complimentaryAmount: 2980,
52
59
  complimentaryNotes: 0,
53
60
  };
54
- /** Independently measured — bruzo: 2166 orders. */
61
+ /** Independently measured — bruzo: 2166 orders. RE-MEASURED on the integer contract. */
55
62
  const BRUZO = {
56
63
  totalCount: 336,
57
- headline: 108576.96,
58
- orderLevel: 8139.81,
59
- itemLevel: 100437.15,
64
+ headline: 108581,
65
+ orderLevel: 8144,
66
+ itemLevel: 100437,
60
67
  itemDiscountRows: 304,
61
68
  unattributed: 0,
62
69
  orderSpecialRaw: 0,
63
70
  orderSpecialResolved: 0,
64
71
  orderSpecialCount: 0,
65
- orderLoyaltyRaw: 200.57,
66
- orderLoyaltyResolved: 7389.81,
72
+ orderLoyaltyRaw: 15914,
73
+ orderLoyaltyResolved: 7394,
67
74
  orderLoyaltyCount: 22,
68
75
  orderVoucherRaw: 750,
69
76
  orderVoucherResolved: 750,
70
- itemSpecialRaw: 100328,
71
- itemSpecialResolved: 100437.15,
77
+ itemSpecialRaw: 103793,
78
+ itemSpecialResolved: 100437,
72
79
  itemSpecialCount: 304,
73
80
  itemSpecialCollectionRaw: 0,
74
81
  itemSpecialCollectionResolved: 0,
@@ -172,9 +179,9 @@ describe('materialized discounts — accumulator vs the independent analysis', (
172
179
  // Anchor F: order + item == headline (holds exactly in both stores)
173
180
  expect(round2(counters.order_level_amount + counters.item_level_amount)).toBe(round2(counters.amount));
174
181
  // RAW slot counters — the overview-parity values (anchors B/C/D)
175
- expect(round2(counters.order_special.amount)).toBe(expected.orderSpecialRaw);
182
+ expect(counters.order_special.amount).toBe(expected.orderSpecialRaw);
176
183
  expect(round2(counters.order_special.count)).toBe(expected.orderSpecialCount);
177
- expect(round2(counters.order_loyalty.amount)).toBe(expected.orderLoyaltyRaw);
184
+ expect(counters.order_loyalty.amount).toBe(expected.orderLoyaltyRaw);
178
185
  expect(round2(counters.order_loyalty.count)).toBe(expected.orderLoyaltyCount);
179
186
  expect(round2(counters.order_voucher.amount)).toBe(expected.orderVoucherRaw);
180
187
  // RESOLVED money — anchors H/J: the slots explain the order/item totals
@@ -186,15 +193,15 @@ describe('materialized discounts — accumulator vs the independent analysis', (
186
193
  counters.order_voucher.resolved_amount +
187
194
  counters.unattributed_amount)).toBe(round2(counters.order_level_amount));
188
195
  // Item-level raw + resolved
189
- expect(round2(counters.item_special.amount)).toBe(expected.itemSpecialRaw);
196
+ expect(counters.item_special.amount).toBe(expected.itemSpecialRaw);
190
197
  expect(round2(counters.item_special.resolved_amount)).toBe(expected.itemSpecialResolved);
191
198
  expect(round2(counters.item_special.count)).toBe(expected.itemSpecialCount);
192
- expect(round2(counters.item_special.collection_amount)).toBe(expected.itemSpecialCollectionRaw);
199
+ expect(counters.item_special.collection_amount).toBe(expected.itemSpecialCollectionRaw);
193
200
  expect(round2(counters.item_special.collection_resolved_amount)).toBe(expected.itemSpecialCollectionResolved);
194
201
  // Catalog-auto rows write the CATALOG ITEM id, which is a 24-hex ObjectId.
195
202
  // They used to be booked as COLLECTION; the caller now supplies the item
196
203
  // ids so the two are separated (bruzo: 302 rows / 100_293).
197
- expect(round2(counters.item_special.catalog_item_amount)).toBe(expected.itemSpecialCatalogRaw);
204
+ expect(counters.item_special.catalog_item_amount).toBe(expected.itemSpecialCatalogRaw);
198
205
  expect(round2(counters.item_special.catalog_item_resolved_amount)).toBe(expected.itemSpecialCatalogResolved);
199
206
  expect(round2(counters.item_special.resolved_amount)).toBe(round2(counters.item_level_amount));
200
207
  // Free items are a SUBSET of the item rows (anchor G), never added to them
@@ -235,15 +242,17 @@ describe('materialized discounts — sub-kind classifier (synthesized coverage)'
235
242
  })).toBe(K.GIFT_CARD);
236
243
  });
237
244
  it('resolves a PERCENTAGE slot to the row money, never to the percent', () => {
245
+ // A percentage RATE is stored in integer BASIS POINTS (1% = 100 bps) and the
246
+ // row money in integer CENTS.
238
247
  const details = {
239
- special_discount: 25,
248
+ special_discount: 2500,
240
249
  special_discount_id: 'MANUAL_25%',
241
250
  special_discount_name: 'Discount',
242
251
  is_special_discount_percentage: true,
243
- total_discount: 8717.5,
252
+ total_discount: 8718,
244
253
  };
245
- const resolved = (0, materialized_discount_classification_helpers_1.resolveRowMoney)(details, 8717.5);
246
- expect(resolved.perSlot.get(MATERIALIZED_REPORTS_1.MATERIALIZED_DISCOUNT_SLOT_ENUM.SPECIAL)).toBe(8717.5);
254
+ const resolved = (0, materialized_discount_classification_helpers_1.resolveRowMoney)(details, 8718);
255
+ expect(resolved.perSlot.get(MATERIALIZED_REPORTS_1.MATERIALIZED_DISCOUNT_SLOT_ENUM.SPECIAL)).toBe(8718);
247
256
  expect(resolved.unallocated).toBe(0);
248
257
  });
249
258
  it('resolves a FIXED slot to its own value', () => {
@@ -300,7 +309,8 @@ describe('materialized discounts — accumulator edge cases (synthesized)', () =
300
309
  _net_amount: 0,
301
310
  _gross_amount: 220,
302
311
  item_discount_details: {
303
- loyalty_discount: 100,
312
+ // 100% off = 10000 basis points.
313
+ loyalty_discount: 10000,
304
314
  loyalty_discount_id: '6aa472763689e5f08dd0599f',
305
315
  is_loyalty_discount_percentage: true,
306
316
  total_discount: 220,