@x12i/countex 1.2.0 → 1.6.0

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 (112) hide show
  1. package/README.md +80 -18
  2. package/dist/backup/manifest.d.ts +70 -0
  3. package/dist/backup/manifest.d.ts.map +1 -0
  4. package/dist/backup/manifest.js +131 -0
  5. package/dist/backup/manifest.js.map +1 -0
  6. package/dist/backup/snapshot-encoding.d.ts +8 -0
  7. package/dist/backup/snapshot-encoding.d.ts.map +1 -0
  8. package/dist/backup/snapshot-encoding.js +27 -0
  9. package/dist/backup/snapshot-encoding.js.map +1 -0
  10. package/dist/cli.js +16 -0
  11. package/dist/cli.js.map +1 -1
  12. package/dist/core/countex.d.ts +79 -1
  13. package/dist/core/countex.d.ts.map +1 -1
  14. package/dist/core/countex.js +254 -49
  15. package/dist/core/countex.js.map +1 -1
  16. package/dist/core/extraction.d.ts +1 -5
  17. package/dist/core/extraction.d.ts.map +1 -1
  18. package/dist/core/extraction.js.map +1 -1
  19. package/dist/core/mapping.d.ts +5 -0
  20. package/dist/core/mapping.d.ts.map +1 -1
  21. package/dist/core/mapping.js +27 -0
  22. package/dist/core/mapping.js.map +1 -1
  23. package/dist/index.d.ts +5 -2
  24. package/dist/index.d.ts.map +1 -1
  25. package/dist/index.js +15 -1
  26. package/dist/index.js.map +1 -1
  27. package/dist/query/formatter.d.ts +2 -2
  28. package/dist/query/formatter.d.ts.map +1 -1
  29. package/dist/query/formatter.js +9 -6
  30. package/dist/query/formatter.js.map +1 -1
  31. package/dist/query/planner.d.ts +15 -1
  32. package/dist/query/planner.d.ts.map +1 -1
  33. package/dist/query/planner.js +152 -3
  34. package/dist/query/planner.js.map +1 -1
  35. package/dist/simulation/context.d.ts +5 -0
  36. package/dist/simulation/context.d.ts.map +1 -0
  37. package/dist/simulation/context.js +56 -0
  38. package/dist/simulation/context.js.map +1 -0
  39. package/dist/simulation/events.d.ts +3 -0
  40. package/dist/simulation/events.d.ts.map +1 -0
  41. package/dist/simulation/events.js +67 -0
  42. package/dist/simulation/events.js.map +1 -0
  43. package/dist/simulation/index.d.ts +7 -0
  44. package/dist/simulation/index.d.ts.map +1 -0
  45. package/dist/simulation/index.js +16 -0
  46. package/dist/simulation/index.js.map +1 -0
  47. package/dist/simulation/prng.d.ts +4 -0
  48. package/dist/simulation/prng.d.ts.map +1 -0
  49. package/dist/simulation/prng.js +18 -0
  50. package/dist/simulation/prng.js.map +1 -0
  51. package/dist/simulation/resource-estimate.d.ts +6 -0
  52. package/dist/simulation/resource-estimate.d.ts.map +1 -0
  53. package/dist/simulation/resource-estimate.js +11 -0
  54. package/dist/simulation/resource-estimate.js.map +1 -0
  55. package/dist/simulation/simulator.d.ts +15 -0
  56. package/dist/simulation/simulator.d.ts.map +1 -0
  57. package/dist/simulation/simulator.js +67 -0
  58. package/dist/simulation/simulator.js.map +1 -0
  59. package/dist/simulation/tracker.d.ts +8 -0
  60. package/dist/simulation/tracker.d.ts.map +1 -0
  61. package/dist/simulation/tracker.js +18 -0
  62. package/dist/simulation/tracker.js.map +1 -0
  63. package/dist/simulation/types.d.ts +49 -0
  64. package/dist/simulation/types.d.ts.map +1 -0
  65. package/dist/simulation/types.js +21 -0
  66. package/dist/simulation/types.js.map +1 -0
  67. package/dist/storage/coverage.d.ts +13 -0
  68. package/dist/storage/coverage.d.ts.map +1 -0
  69. package/dist/storage/coverage.js +37 -0
  70. package/dist/storage/coverage.js.map +1 -0
  71. package/dist/storage/memory.d.ts +23 -5
  72. package/dist/storage/memory.d.ts.map +1 -1
  73. package/dist/storage/memory.js +162 -3
  74. package/dist/storage/memory.js.map +1 -1
  75. package/dist/storage/mongo.d.ts +5 -0
  76. package/dist/storage/mongo.d.ts.map +1 -1
  77. package/dist/storage/mongo.js +68 -1
  78. package/dist/storage/mongo.js.map +1 -1
  79. package/dist/storage/redis.d.ts +40 -11
  80. package/dist/storage/redis.d.ts.map +1 -1
  81. package/dist/storage/redis.js +202 -44
  82. package/dist/storage/redis.js.map +1 -1
  83. package/dist/types/index.d.ts +165 -7
  84. package/dist/types/index.d.ts.map +1 -1
  85. package/docs/DEPLOYMENT.md +125 -3
  86. package/docs/countex_gap_analysis_complete_checklist.md +1340 -0
  87. package/docs/guides/README.md +5 -0
  88. package/docs/guides/adapter-mongo.md +12 -0
  89. package/docs/guides/adapter-redis.md +46 -4
  90. package/docs/guides/backup-export.md +106 -10
  91. package/docs/guides/cli.md +8 -0
  92. package/docs/guides/counter-maps.md +14 -0
  93. package/docs/guides/insights-overview.md +6 -0
  94. package/docs/guides/measures.md +4 -0
  95. package/docs/guides/preview.md +92 -0
  96. package/docs/guides/querying.md +70 -0
  97. package/docs/guides/simulation-profiles.md +33 -0
  98. package/docs/guides/simulation-resource-estimation.md +30 -0
  99. package/docs/guides/simulation.md +36 -0
  100. package/docs/internals/README.md +1 -0
  101. package/docs/internals/internal-dimension-hash.md +34 -0
  102. package/docs/internals/internal-storage-mongo.md +24 -4
  103. package/docs/internals/internal-storage-redis.md +41 -9
  104. package/docs/use-cases/README.md +56 -0
  105. package/docs/use-cases/audit-security-log-counts.md +550 -0
  106. package/docs/use-cases/llm-cost-and-token-metering.md +255 -0
  107. package/docs/use-cases/multi-tenant-isolation.md +203 -0
  108. package/docs/use-cases/ops-dashboard-daily-rollups.md +255 -0
  109. package/docs/use-cases/processing-workflow-activity.md +165 -0
  110. package/docs/use-cases/product-feature-usage.md +240 -0
  111. package/docs/use-cases/webhook-idempotent-ingestion.md +188 -0
  112. package/package.json +18 -2
@@ -3,37 +3,70 @@
3
3
  * Redis cache adapter (ioredis).
4
4
  *
5
5
  * Storage layout:
6
- * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey} → HASH
6
+ * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey} → HASH (cells)
7
7
  * field = "{subjectType}|{subjectId}|{metricId}|{dimensionsHash}"
8
8
  * value = count (integer)
9
9
  * field = "{base}:m:{measureName}:sum" → float/int (measure sum)
10
10
  * field = "{base}:m:{measureName}:count" → int (measure event count)
11
- * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey}:meta:{baseField}
12
- * → JSON of dimensions
13
- * countex:{scope}:dedupe:{eventId} → "1" with TTL
11
+ *
12
+ * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey}:meta:{base}
13
+ * → JSON of dimensions
14
+ *
15
+ * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey}:cov → HASH (coverage meta)
16
+ * status = "complete" | "partial" | "rebuilding"
17
+ * lastWarmAt = epoch ms (string)
18
+ * mapVersion = number string (optional)
19
+ * schemaVersion = number string (optional)
20
+ * cellCount = number string (optional, set on warm)
21
+ *
22
+ * countex:{scope}:dedupe:{eventId} → "1" with TTL
14
23
  *
15
24
  * Min/max aggregates are durable-only; the cache holds sum and count per measure.
16
25
  *
17
26
  * One hash per (scope, counterId, timeframe-bucket) keeps key count tiny while
18
- * remaining cheap to read/write.
27
+ * remaining cheap to read/write. The `:cov` hash gives the planner authoritative
28
+ * per-bucket coverage rather than guessing from "did HGETALL return anything?".
19
29
  */
20
30
  Object.defineProperty(exports, "__esModule", { value: true });
21
- exports.RedisCache = void 0;
31
+ exports.RedisCache = exports.REDIS_CACHE_SCHEMA_VERSION = void 0;
22
32
  const timeframe_js_1 = require("../core/timeframe.js");
33
+ const coverage_js_1 = require("./coverage.js");
23
34
  const MEASURE_SEP = ":m:";
35
+ /** Cache layout schema version. Bump when the on-wire shape changes. */
36
+ exports.REDIS_CACHE_SCHEMA_VERSION = 1;
24
37
  class RedisCache {
25
38
  client;
26
39
  prefix;
27
- ttl;
40
+ defaultTtl;
41
+ ttlByTf;
42
+ mapVersion;
28
43
  constructor(opts) {
29
44
  this.client = opts.client;
30
45
  this.prefix = opts.keyPrefix ?? "countex";
31
- this.ttl = opts.ttlSeconds ?? 0;
46
+ this.defaultTtl = opts.ttlSeconds ?? 0;
47
+ this.ttlByTf = { ...(opts.ttlSecondsByTimeframe ?? {}) };
48
+ this.mapVersion = opts.mapVersion;
49
+ }
50
+ /**
51
+ * Engine calls this to forward unified retention config. Per-timeframe TTLs
52
+ * here override constructor defaults (constructor `ttlSecondsByTimeframe`
53
+ * remains the floor for adapters constructed without engine retention).
54
+ */
55
+ setRetentionPolicy(policy) {
56
+ this.ttlByTf = { ...this.ttlByTf, ...policy };
57
+ }
58
+ ttlFor(tf) {
59
+ const v = this.ttlByTf[tf];
60
+ if (v !== undefined && v > 0)
61
+ return v;
62
+ return this.defaultTtl;
32
63
  }
33
64
  async applyDeltas(deltas) {
34
65
  if (deltas.length === 0)
35
66
  return;
36
67
  const pipeline = this.client.pipeline();
68
+ const now = Date.now();
69
+ const touchedBuckets = new Set();
37
70
  for (const d of deltas) {
38
71
  const id = d.identity;
39
72
  const hashKey = this.bucketKey(id.scopeId, id.counterId, id.timeframeType, id.timeframeKey);
@@ -57,20 +90,32 @@ class RedisCache {
57
90
  }
58
91
  const metaKey = `${hashKey}:meta:${field}`;
59
92
  pipeline.set(metaKey, JSON.stringify(id.dimensions), "NX");
60
- if (this.ttl > 0) {
61
- pipeline.expire(hashKey, this.ttl);
62
- pipeline.expire(metaKey, this.ttl);
93
+ const ttl = this.ttlFor(id.timeframeType);
94
+ if (ttl > 0) {
95
+ pipeline.expire(hashKey, ttl);
96
+ pipeline.expire(metaKey, ttl);
97
+ }
98
+ // Coverage meta: mark partial only when no status already set, then
99
+ // update lastWarmAt. Never downgrades a `complete` or `rebuilding` bucket.
100
+ if (!touchedBuckets.has(hashKey)) {
101
+ touchedBuckets.add(hashKey);
102
+ const covKey = this.coverageKey(id.scopeId, id.counterId, id.timeframeType, id.timeframeKey);
103
+ pipeline.hsetnx(covKey, "status", "partial");
104
+ pipeline.hset(covKey, "lastWarmAt", String(now));
105
+ if (ttl > 0)
106
+ pipeline.expire(covKey, ttl);
63
107
  }
64
108
  }
65
109
  await pipeline.exec();
66
110
  }
67
- async readCells(spec) {
111
+ async readCells(spec, opts) {
68
112
  const buckets = (0, timeframe_js_1.bucketRange)(spec.timeframe.type, spec.timeframe.from, spec.timeframe.to);
69
113
  if (buckets.length === 0)
70
114
  return { cells: [], coverage: "miss" };
71
115
  const pipeline = this.client.pipeline();
72
116
  for (const b of buckets) {
73
117
  pipeline.hgetall(this.bucketKey(spec.scope, spec.counterId, spec.timeframe.type, b));
118
+ pipeline.hgetall(this.coverageKey(spec.scope, spec.counterId, spec.timeframe.type, b));
74
119
  }
75
120
  const results = await pipeline.exec();
76
121
  if (!results)
@@ -78,24 +123,25 @@ class RedisCache {
78
123
  const cellMap = new Map();
79
124
  const metaToFetch = [];
80
125
  const metaQueued = new Set();
81
- let bucketsHit = 0;
126
+ const bucketCoverage = {};
82
127
  const queueMeta = (hashKey, baseField, composite, cell) => {
83
128
  if (metaQueued.has(composite))
84
129
  return;
85
130
  metaQueued.add(composite);
86
131
  metaToFetch.push({ key: `${hashKey}:meta:${baseField}`, cell });
87
132
  };
88
- results.forEach((entry, idx) => {
89
- const [err, raw] = entry;
90
- if (err || !raw)
91
- return;
92
- const hash = raw;
93
- if (Object.keys(hash).length === 0)
94
- return;
95
- bucketsHit++;
96
- const bucket = buckets[idx];
133
+ for (let i = 0; i < buckets.length; i++) {
134
+ const bucket = buckets[i];
135
+ const cellsEntry = results[i * 2];
136
+ const covEntry = results[i * 2 + 1];
137
+ const cellsRaw = cellsEntry?.[1];
138
+ const covRaw = covEntry?.[1];
139
+ const meta = parseCoverageMeta(covRaw);
140
+ bucketCoverage[bucket] = effectiveBucketCoverage(meta, cellsRaw, opts);
97
141
  const hashKey = this.bucketKey(spec.scope, spec.counterId, spec.timeframe.type, bucket);
98
- for (const [field, val] of Object.entries(hash)) {
142
+ if (!cellsRaw || Object.keys(cellsRaw).length === 0)
143
+ continue;
144
+ for (const [field, val] of Object.entries(cellsRaw)) {
99
145
  const mi = field.indexOf(MEASURE_SEP);
100
146
  if (mi === -1) {
101
147
  const parsed = parseBaseField(field);
@@ -143,15 +189,12 @@ class RedisCache {
143
189
  queueMeta(hashKey, baseField, composite, cell);
144
190
  }
145
191
  }
146
- });
192
+ }
147
193
  const cells = Array.from(cellMap.values());
148
194
  for (const c of cells) {
149
195
  if (c.measures && Object.keys(c.measures).length === 0)
150
196
  delete c.measures;
151
197
  }
152
- if (cells.length === 0) {
153
- return { cells, coverage: "miss" };
154
- }
155
198
  if (metaToFetch.length > 0) {
156
199
  const metaPipeline = this.client.pipeline();
157
200
  for (const m of metaToFetch)
@@ -172,34 +215,95 @@ class RedisCache {
172
215
  }
173
216
  }
174
217
  const filtered = cells.filter((c) => matchesSpec(c, spec));
175
- const coverage = bucketsHit === buckets.length ? "full" : bucketsHit > 0 ? "partial" : "miss";
176
- return { cells: filtered, coverage };
218
+ const coverage = (0, coverage_js_1.aggregateCoverage)(buckets, bucketCoverage);
219
+ return { cells: filtered, coverage, bucketCoverage };
177
220
  }
178
221
  async warm(cells) {
179
222
  if (cells.length === 0)
180
223
  return;
181
- const pipeline = this.client.pipeline();
224
+ // Group cells by bucket so we can stamp coverage meta per bucket.
225
+ const cellsByBucket = new Map();
226
+ const bucketIdentity = new Map();
182
227
  for (const c of cells) {
183
- const hashKey = this.bucketKey(c.scopeId, c.counterId, c.timeframeType, c.timeframeKey);
184
- const field = this.fieldKey(c.subjectType, c.subjectId, c.metricId, c.dimensionsHash);
185
- pipeline.hset(hashKey, field, c.count);
186
- for (const [name, mv] of Object.entries(c.measures ?? {})) {
187
- if (mv.sum !== undefined) {
188
- pipeline.hset(hashKey, `${field}${MEASURE_SEP}${name}:sum`, String(mv.sum));
228
+ const k = this.bucketKey(c.scopeId, c.counterId, c.timeframeType, c.timeframeKey);
229
+ const arr = cellsByBucket.get(k) ?? [];
230
+ arr.push(c);
231
+ cellsByBucket.set(k, arr);
232
+ bucketIdentity.set(k, {
233
+ scope: c.scopeId,
234
+ counterId: c.counterId,
235
+ tf: c.timeframeType,
236
+ key: c.timeframeKey,
237
+ });
238
+ }
239
+ const now = Date.now();
240
+ const pipeline = this.client.pipeline();
241
+ for (const [hashKey, bucketCells] of cellsByBucket) {
242
+ const bucketId = bucketIdentity.get(hashKey);
243
+ for (const c of bucketCells) {
244
+ const field = this.fieldKey(c.subjectType, c.subjectId, c.metricId, c.dimensionsHash);
245
+ pipeline.hset(hashKey, field, c.count);
246
+ for (const [name, mv] of Object.entries(c.measures ?? {})) {
247
+ if (mv.sum !== undefined) {
248
+ pipeline.hset(hashKey, `${field}${MEASURE_SEP}${name}:sum`, String(mv.sum));
249
+ }
250
+ if (mv.count !== undefined) {
251
+ pipeline.hset(hashKey, `${field}${MEASURE_SEP}${name}:count`, String(mv.count));
252
+ }
189
253
  }
190
- if (mv.count !== undefined) {
191
- pipeline.hset(hashKey, `${field}${MEASURE_SEP}${name}:count`, String(mv.count));
254
+ const metaKey = `${hashKey}:meta:${field}`;
255
+ pipeline.set(metaKey, JSON.stringify(c.dimensions));
256
+ const ttl = this.ttlFor(c.timeframeType);
257
+ if (ttl > 0) {
258
+ pipeline.expire(hashKey, ttl);
259
+ pipeline.expire(metaKey, ttl);
192
260
  }
193
261
  }
194
- const metaKey = `${hashKey}:meta:${field}`;
195
- pipeline.set(metaKey, JSON.stringify(c.dimensions));
196
- if (this.ttl > 0) {
197
- pipeline.expire(hashKey, this.ttl);
198
- pipeline.expire(metaKey, this.ttl);
199
- }
262
+ const covKey = this.coverageKey(bucketId.scope, bucketId.counterId, bucketId.tf, bucketId.key);
263
+ const covFields = {
264
+ status: "complete",
265
+ lastWarmAt: String(now),
266
+ cellCount: String(bucketCells.length),
267
+ schemaVersion: String(exports.REDIS_CACHE_SCHEMA_VERSION),
268
+ };
269
+ if (this.mapVersion !== undefined)
270
+ covFields["mapVersion"] = String(this.mapVersion);
271
+ pipeline.hset(covKey, covFields);
272
+ const ttl = this.ttlFor(bucketId.tf);
273
+ if (ttl > 0)
274
+ pipeline.expire(covKey, ttl);
200
275
  }
201
276
  await pipeline.exec();
202
277
  }
278
+ async probeBucketCoverage(scope, counterId, timeframeType, timeframeKeys) {
279
+ const out = {};
280
+ if (timeframeKeys.length === 0)
281
+ return out;
282
+ const pipeline = this.client.pipeline();
283
+ for (const k of timeframeKeys) {
284
+ pipeline.hgetall(this.coverageKey(scope, counterId, timeframeType, k));
285
+ }
286
+ const results = await pipeline.exec();
287
+ if (!results) {
288
+ for (const k of timeframeKeys)
289
+ out[k] = { status: "missing" };
290
+ return out;
291
+ }
292
+ timeframeKeys.forEach((k, i) => {
293
+ const raw = results[i]?.[1];
294
+ out[k] = parseCoverageMeta(raw);
295
+ });
296
+ return out;
297
+ }
298
+ async markBucketRebuilding(scope, counterId, timeframeType, timeframeKey) {
299
+ const covKey = this.coverageKey(scope, counterId, timeframeType, timeframeKey);
300
+ const ttl = this.ttlFor(timeframeType);
301
+ const pipeline = this.client.pipeline();
302
+ pipeline.hset(covKey, "status", "rebuilding", "lastWarmAt", String(Date.now()));
303
+ if (ttl > 0)
304
+ pipeline.expire(covKey, ttl);
305
+ await pipeline.exec();
306
+ }
203
307
  async markEventSeen(scopeId, eventId, ttlSeconds) {
204
308
  const key = `${this.prefix}:${scopeId}:dedupe:${eventId}`;
205
309
  const res = await this.client.set(key, "1", "EX", Math.max(1, ttlSeconds), "NX");
@@ -208,11 +312,65 @@ class RedisCache {
208
312
  bucketKey(scopeId, counterId, type, key) {
209
313
  return `${this.prefix}:${scopeId}:${counterId}:${type}:${key}`;
210
314
  }
315
+ coverageKey(scopeId, counterId, type, key) {
316
+ return `${this.bucketKey(scopeId, counterId, type, key)}:cov`;
317
+ }
211
318
  fieldKey(subjectType, subjectId, metricId, dimsHash) {
212
319
  return `${subjectType}|${subjectId}|${metricId}|${dimsHash}`;
213
320
  }
214
321
  }
215
322
  exports.RedisCache = RedisCache;
323
+ function parseCoverageMeta(raw) {
324
+ if (!raw || Object.keys(raw).length === 0)
325
+ return { status: "missing" };
326
+ const status = raw["status"] ?? "missing";
327
+ const meta = { status };
328
+ const lw = Number(raw["lastWarmAt"]);
329
+ if (Number.isFinite(lw))
330
+ meta.lastWarmAt = lw;
331
+ const mv = Number(raw["mapVersion"]);
332
+ if (Number.isFinite(mv))
333
+ meta.mapVersion = mv;
334
+ const sv = Number(raw["schemaVersion"]);
335
+ if (Number.isFinite(sv))
336
+ meta.schemaVersion = sv;
337
+ const cc = Number(raw["cellCount"]);
338
+ if (Number.isFinite(cc))
339
+ meta.cellCount = cc;
340
+ return meta;
341
+ }
342
+ /**
343
+ * Reconcile stored coverage meta with what HGETALL actually returned and any
344
+ * version expectations from the caller. The cells hash is the "ground truth"
345
+ * for what is materialized in this read; coverage meta is the cache's own
346
+ * claim of authoritativeness.
347
+ */
348
+ function effectiveBucketCoverage(meta, cellsRaw, opts) {
349
+ const hasCells = cellsRaw && Object.keys(cellsRaw).length > 0;
350
+ if (meta.status === "missing" && hasCells) {
351
+ // Cells exist without coverage meta — treat as partial (legacy data).
352
+ return { ...meta, status: "partial" };
353
+ }
354
+ if (meta.status === "complete" && !hasCells) {
355
+ // Cells expired but coverage didn't (or genuinely empty bucket). The
356
+ // legitimate "complete with zero cells" case is rare; treat as partial
357
+ // so the planner falls through to durable. Cheap and correct.
358
+ return { ...meta, status: "partial" };
359
+ }
360
+ if (meta.status === "complete" &&
361
+ opts?.expectedMapVersion !== undefined &&
362
+ meta.mapVersion !== undefined &&
363
+ meta.mapVersion !== opts.expectedMapVersion) {
364
+ return { ...meta, status: "partial" };
365
+ }
366
+ if (meta.status === "complete" &&
367
+ opts?.expectedSchemaVersion !== undefined &&
368
+ meta.schemaVersion !== undefined &&
369
+ meta.schemaVersion !== opts.expectedSchemaVersion) {
370
+ return { ...meta, status: "partial" };
371
+ }
372
+ return meta;
373
+ }
216
374
  function parseBaseField(field) {
217
375
  const parts = field.split("|");
218
376
  if (parts.length !== 4)
@@ -1 +1 @@
1
- {"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/storage/redis.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAYH,uDAAmD;AAEnD,MAAM,WAAW,GAAG,KAAK,CAAC;AAU1B,MAAa,UAAU;IACJ,MAAM,CAAU;IAChB,MAAM,CAAS;IACf,GAAG,CAAS;IAE7B,YAAY,IAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAsB;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAExC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;YAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC;YAC1F,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAE1C,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACpD,IAAI,EAAE,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;wBACzB,MAAM,EAAE,GAAG,GAAG,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,CAAC;wBAC/C,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;4BAC7B,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;wBACxC,CAAC;6BAAM,CAAC;4BACN,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;wBAC7C,CAAC;oBACH,CAAC;oBACD,IAAI,EAAE,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBAC3B,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,WAAW,GAAG,IAAI,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;oBAC7E,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,GAAG,OAAO,SAAS,KAAK,EAAE,CAAC;YAC3C,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;YAE3D,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;gBACjB,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAe;QAI7B,MAAM,OAAO,GAAG,IAAA,0BAAW,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACzF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAEjE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAErD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC/C,MAAM,WAAW,GAA8C,EAAE,CAAC;QAClE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,SAAiB,EAAE,SAAiB,EAAE,IAAiB,EAAE,EAAE;YAC7F,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO;YACtC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;YACzB,IAAI,GAAG,IAAI,CAAC,GAAG;gBAAE,OAAO;YACxB,MAAM,IAAI,GAAG,GAA6B,CAAC;YAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC3C,UAAU,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAExF,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACtC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;oBACd,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;oBACrC,IAAI,CAAC,MAAM;wBAAE,SAAS;oBACtB,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;oBACvC,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAClC,IAAI,CAAC,IAAI,EAAE,CAAC;wBACV,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;wBACvC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;oBAC/B,CAAC;oBACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;oBAC1B,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;wBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;oBAC/C,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;gBAC7C,CAAC;qBAAM,CAAC;oBACN,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;oBACzC,IAAI,CAAC,MAAM;wBAAE,SAAS;oBACtB,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;oBAC3C,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAClC,IAAI,CAAC,IAAI,EAAE,CAAC;wBACV,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;wBACvC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;oBAC/B,CAAC;oBACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;oBAClD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;oBACjC,IAAI,EAAE,IAAI,CAAC;wBAAE,SAAS;oBACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;oBAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;oBACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;wBAAE,SAAS;oBACpC,IAAI,CAAC,IAAI,CAAC,QAAQ;wBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;oBACvC,MAAM,EAAE,GAAiB,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBAC7D,IAAI,GAAG,KAAK,KAAK;wBAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC;oBAChC,IAAI,GAAG,KAAK,OAAO;wBAAE,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC;oBACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBAC1B,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC,QAAQ,CAAC;QAC5E,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACrC,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5C,KAAK,MAAM,CAAC,IAAI,WAAW;gBAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,WAAW,EAAE,CAAC;gBAChB,WAAW,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;oBAC/B,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;oBACtB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;wBAC5B,IAAI,CAAC;4BACH,WAAW,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;wBAClE,CAAC;wBAAC,MAAM,CAAC;4BACP,SAAS;wBACX,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAE3D,MAAM,QAAQ,GACZ,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAE/E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAoB;QAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;YACxF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;YACtF,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC1D,IAAI,EAAE,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;oBACzB,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9E,CAAC;gBACD,IAAI,EAAE,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC3B,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,WAAW,GAAG,IAAI,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,OAAO,SAAS,KAAK,EAAE,CAAC;YAC3C,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;gBACjB,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,OAAe,EAAE,UAAkB;QACtE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,WAAW,OAAO,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QACjF,OAAO,GAAG,KAAK,IAAI,CAAC;IACtB,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,SAAiB,EAAE,IAAY,EAAE,GAAW;QAC7E,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,SAAS,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;IACjE,CAAC;IAEO,QAAQ,CAAC,WAAmB,EAAE,SAAiB,EAAE,QAAgB,EAAE,QAAgB;QACzF,OAAO,GAAG,WAAW,IAAI,SAAS,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;IAC/D,CAAC;CACF;AArMD,gCAqMC;AAED,SAAS,cAAc,CAAC,KAAa;IAGnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,EAAE,WAAW,EAAE,WAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAe,EAAE,CAAC;AAC7F,CAAC;AAED,SAAS,SAAS,CAChB,IAAe,EACf,MAAc,EACd,MAAsD;IAEtD,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;QAClC,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,UAAU,EAAE,EAAE;QACd,KAAK,EAAE,CAAC;KACT,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,CAAc,EAAE,IAAe;IAClD,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;IAC/C,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5D,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
1
+ {"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/storage/redis.ts"],"names":[],"mappings":"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"}
@@ -44,6 +44,11 @@ export interface MeasureValue {
44
44
  /** When fixed-point storage is used, present on reads from durable storage. */
45
45
  scale?: number;
46
46
  }
47
+ /** Non-fatal issues during JSON → raw increment extraction. */
48
+ export interface ExtractionWarning {
49
+ reason: string;
50
+ meta?: Record<string, unknown>;
51
+ }
47
52
  export type JsonValue = string | number | boolean | null | JsonValue[] | {
48
53
  [key: string]: JsonValue;
49
54
  };
@@ -249,6 +254,62 @@ export interface TimeseriesPoint {
249
254
  /** Present when other groupings are also active. */
250
255
  keys?: Record<string, string | number>;
251
256
  }
257
+ /** Cache read outcome when a cache adapter was consulted. */
258
+ export type CacheCoverage = "full" | "partial" | "miss";
259
+ /** Per-bucket coverage status reported by a cache adapter. */
260
+ export type BucketCoverageStatus = "complete" | "partial" | "rebuilding" | "missing";
261
+ /** Per-bucket coverage metadata maintained by cache adapters. */
262
+ export interface BucketCoverageMeta {
263
+ status: BucketCoverageStatus;
264
+ /** Epoch ms of the most recent write or warm into this bucket. */
265
+ lastWarmAt?: number;
266
+ /** Map version known to the cache for this bucket (opaque integer). */
267
+ mapVersion?: number;
268
+ /** Cell schema version known to the cache for this bucket. */
269
+ schemaVersion?: number;
270
+ /** Cell count last warmed into this bucket (if known). */
271
+ cellCount?: number;
272
+ }
273
+ /** Extra planner/read-path metadata for observability and tests. */
274
+ export interface QueryDiagnostics {
275
+ /** Present when query consulted cache (`bypassCache` false and cache configured). */
276
+ cacheCoverage?: CacheCoverage;
277
+ /** Whether the planner attempted a cache read before durable. */
278
+ cacheAttempted: boolean;
279
+ /** Counter cells materialized for this response (before grouping/formatting). */
280
+ cellsMaterialized: number;
281
+ /** Bucket keys requested by this query (after timeframe expansion). */
282
+ bucketsRequested?: string[];
283
+ /** Number of buckets that the cache reported as `complete`. */
284
+ cacheBucketsHit?: number;
285
+ /** True when the planner had to fall back to durable for some/all buckets. */
286
+ durableFallback?: boolean;
287
+ /** Heuristic estimate of cells before grouping (durable.readCells materialized count is authoritative). */
288
+ plannedCellsEstimate?: number;
289
+ /** Cost class of the groupBy stage. */
290
+ groupByCost?: "trivial" | "low" | "high";
291
+ /** True when the planner thinks this is an expensive query. */
292
+ expensive?: boolean;
293
+ }
294
+ /** Result of `Countex.explainQuery(spec)`: the plan without executing the query. */
295
+ export interface QueryPlan {
296
+ /** Bucket keys the query will read. */
297
+ bucketsRequested: string[];
298
+ /** Whether the cache is eligible to serve this query (cache configured, not bypassed, not min/max-bound). */
299
+ cacheEligible: boolean;
300
+ /** Reason cache is ineligible, when applicable. */
301
+ cacheReason?: string;
302
+ /** Buckets the cache currently reports `complete` (only filled when the cache was probed). */
303
+ cacheBucketsExpectedHit?: number;
304
+ /** True when the planner predicts a durable read will be needed. */
305
+ durableFallbackPredicted: boolean;
306
+ /** Heuristic cell count estimate based on cache meta `cellCount` summed across buckets, when available. */
307
+ plannedCellsEstimate?: number;
308
+ /** Cost class of the groupBy stage. */
309
+ groupByCost: "trivial" | "low" | "high";
310
+ /** True when the planner thinks this is an expensive query. */
311
+ expensive: boolean;
312
+ }
252
313
  export interface QueryResult {
253
314
  format: ResultFormat;
254
315
  rows: QueryRow[] | CounterCell[] | TimeseriesPoint[];
@@ -256,6 +317,34 @@ export interface QueryResult {
256
317
  /** Diagnostics: how the query was answered. */
257
318
  source: "cache" | "durable" | "merged";
258
319
  partial?: boolean;
320
+ /** Planner and storage path details. */
321
+ diagnostics?: QueryDiagnostics;
322
+ }
323
+ /** One logical buffered cell update after extraction + cardinality (no dictionary ids). */
324
+ export interface PreviewIncrementCell {
325
+ scopeId: string;
326
+ counterId: string;
327
+ timeframeType: TimeframeType;
328
+ timeframeKey: string;
329
+ subjectType: string;
330
+ subjectSourceKey: string;
331
+ metricSourceKey: string;
332
+ dimensions: Dimensions;
333
+ dimensionsHash: string;
334
+ delta: number;
335
+ measures: Record<string, {
336
+ value: number;
337
+ aggs: MeasureAgg[];
338
+ }>;
339
+ }
340
+ /** Dry-run extraction for one map and one event (no I/O, no buffer). */
341
+ export interface MapPreviewResult {
342
+ counterId: string;
343
+ skipped: boolean;
344
+ extractionWarnings: ExtractionWarning[];
345
+ cells: PreviewIncrementCell[];
346
+ /** Increments dropped by cardinality guard (preview runs silently — no `dropped` events). */
347
+ droppedAfterCardinality: number;
259
348
  }
260
349
  /**
261
350
  * The dictionary maps arbitrary source keys (UUIDs, emails, names, paths, ...)
@@ -292,10 +381,32 @@ export interface DurableStorage {
292
381
  streamCells(filter: Pick<QuerySpec, "scope" | "counterId" | "timeframe">, opts?: {
293
382
  signal?: AbortSignal;
294
383
  }): AsyncIterable<CounterCell>;
384
+ /**
385
+ * Optional absolute snapshot import (backup restore). Replaces or inserts cells
386
+ * to match exported presentation-valued cells; not used on the hot ingest path.
387
+ */
388
+ importSnapshotCells?(cells: CounterCell[], opts?: {
389
+ signal?: AbortSignal;
390
+ }): Promise<void>;
295
391
  /** Lifecycle hooks. */
296
392
  init?(): Promise<void>;
297
393
  close?(): Promise<void>;
298
394
  }
395
+ /** Options accepted by `CacheStorage.readCells` for coverage and version checks. */
396
+ export interface CacheReadOptions {
397
+ signal?: AbortSignal;
398
+ /** When set, buckets whose stored `mapVersion` differs are treated as `partial`. */
399
+ expectedMapVersion?: number;
400
+ /** When set, buckets whose stored `schemaVersion` differs are treated as `partial`. */
401
+ expectedSchemaVersion?: number;
402
+ }
403
+ /** Per-bucket coverage info returned alongside cells (optional, for diagnostics). */
404
+ export interface CacheReadResult {
405
+ cells: CounterCell[];
406
+ coverage: CacheCoverage;
407
+ /** Per-bucket meta if the adapter tracks it. Keyed by bucket. */
408
+ bucketCoverage?: Record<string, BucketCoverageMeta>;
409
+ }
299
410
  /**
300
411
  * Hot cache. Best-effort, can be lossy. Reads should be answerable from here
301
412
  * for hot timeframes; misses fall back to durable.
@@ -308,16 +419,32 @@ export interface CacheStorage {
308
419
  * Read cells matching a query from cache. Return an empty array when the cache
309
420
  * has nothing covering the query — the query layer will fall through to durable.
310
421
  */
311
- readCells(spec: QuerySpec, opts?: {
312
- signal?: AbortSignal;
313
- }): Promise<{
314
- cells: CounterCell[];
315
- coverage: "full" | "partial" | "miss";
316
- }>;
422
+ readCells(spec: QuerySpec, opts?: CacheReadOptions): Promise<CacheReadResult>;
317
423
  /** Warm cache from a batch of cells (after a durable read). */
318
424
  warm(cells: CounterCell[], opts?: {
319
425
  signal?: AbortSignal;
320
426
  }): Promise<void>;
427
+ /**
428
+ * Probe per-bucket coverage metadata for a planning pass without materializing cells.
429
+ * Adapters that do not track bucket meta return undefined or `{ status: "missing" }`.
430
+ */
431
+ probeBucketCoverage?(scope: string, counterId: string, timeframeType: TimeframeType, timeframeKeys: string[], opts?: {
432
+ signal?: AbortSignal;
433
+ }): Promise<Record<string, BucketCoverageMeta>>;
434
+ /**
435
+ * Mark a bucket as `rebuilding` so concurrent readers fall back to durable
436
+ * and concurrent applyDeltas does not downgrade the status. Called by
437
+ * `rebuildCache` before warming. After warm() completes the bucket flips
438
+ * back to `complete`.
439
+ */
440
+ markBucketRebuilding?(scope: string, counterId: string, timeframeType: TimeframeType, timeframeKey: string, opts?: {
441
+ signal?: AbortSignal;
442
+ }): Promise<void>;
443
+ /**
444
+ * Optional retention policy hook. Engine forwards configured per-timeframe
445
+ * TTLs (in seconds) so the adapter can apply them on writes.
446
+ */
447
+ setRetentionPolicy?(policy: Partial<Record<TimeframeType, number>>): void;
321
448
  /**
322
449
  * Idempotency dedupe — atomically records that an event id was seen.
323
450
  * Returns true when the event is new (proceed), false when it's a duplicate (skip).
@@ -337,9 +464,34 @@ export interface FlushPolicy {
337
464
  onOverflow?: "block" | "drop";
338
465
  }
339
466
  export interface CachePolicy {
340
- /** Per-timeframe-type retention windows. Entries older than this become cache-misses. */
467
+ /**
468
+ * @deprecated Use `CountexConfig.retention.redis` instead. Per-timeframe-type
469
+ * retention windows in seconds; kept for backwards compatibility.
470
+ */
341
471
  hotTimeframes?: Partial<Record<TimeframeType, number>>;
342
472
  }
473
+ /**
474
+ * Per-timeframe retention windows for cache and durable storage.
475
+ *
476
+ * Values are either:
477
+ * - a number (seconds), or
478
+ * - a duration string: `<number><unit>` where unit is `s|m|h|d|w|mo|q|y`,
479
+ * or `"forever"` for no expiry.
480
+ *
481
+ * Redis retention is applied by the engine to the cache adapter on every write.
482
+ * Mongo retention is currently a documented operator responsibility (TTL index
483
+ * on `updatedAt` or scheduled prune by `(counterId, timeframeType, timeframeKey)`).
484
+ */
485
+ export type RetentionDuration = number | string;
486
+ export interface RetentionPolicy {
487
+ /** Per-timeframe TTLs forwarded to the cache adapter (Redis today). */
488
+ redis?: Partial<Record<TimeframeType, RetentionDuration>>;
489
+ /**
490
+ * Per-timeframe windows for durable storage. Documented today; not enforced
491
+ * by the engine. Operators apply via Mongo TTL indexes or scheduled prune.
492
+ */
493
+ mongo?: Partial<Record<TimeframeType, RetentionDuration>>;
494
+ }
343
495
  export interface CountexLogger {
344
496
  debug?(msg: string, meta?: Record<string, unknown>): void;
345
497
  info?(msg: string, meta?: Record<string, unknown>): void;
@@ -352,6 +504,12 @@ export interface CountexConfig {
352
504
  cache?: CacheStorage;
353
505
  flush?: FlushPolicy;
354
506
  cachePolicy?: CachePolicy;
507
+ /**
508
+ * Unified retention policy. Engine resolves `retention.redis` and forwards
509
+ * per-timeframe TTLs (in seconds) to the cache adapter via
510
+ * `setRetentionPolicy`. Engine retention overrides any adapter default.
511
+ */
512
+ retention?: RetentionPolicy;
355
513
  /** Default idempotency policy applied when a map doesn't override. */
356
514
  idempotency?: IdempotencyPolicy;
357
515
  /** Default cardinality policy applied when a map doesn't override. */