@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.
- package/README.md +80 -18
- package/dist/backup/manifest.d.ts +70 -0
- package/dist/backup/manifest.d.ts.map +1 -0
- package/dist/backup/manifest.js +131 -0
- package/dist/backup/manifest.js.map +1 -0
- package/dist/backup/snapshot-encoding.d.ts +8 -0
- package/dist/backup/snapshot-encoding.d.ts.map +1 -0
- package/dist/backup/snapshot-encoding.js +27 -0
- package/dist/backup/snapshot-encoding.js.map +1 -0
- package/dist/cli.js +16 -0
- package/dist/cli.js.map +1 -1
- package/dist/core/countex.d.ts +79 -1
- package/dist/core/countex.d.ts.map +1 -1
- package/dist/core/countex.js +254 -49
- package/dist/core/countex.js.map +1 -1
- package/dist/core/extraction.d.ts +1 -5
- package/dist/core/extraction.d.ts.map +1 -1
- package/dist/core/extraction.js.map +1 -1
- package/dist/core/mapping.d.ts +5 -0
- package/dist/core/mapping.d.ts.map +1 -1
- package/dist/core/mapping.js +27 -0
- package/dist/core/mapping.js.map +1 -1
- package/dist/index.d.ts +5 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +15 -1
- package/dist/index.js.map +1 -1
- package/dist/query/formatter.d.ts +2 -2
- package/dist/query/formatter.d.ts.map +1 -1
- package/dist/query/formatter.js +9 -6
- package/dist/query/formatter.js.map +1 -1
- package/dist/query/planner.d.ts +15 -1
- package/dist/query/planner.d.ts.map +1 -1
- package/dist/query/planner.js +152 -3
- package/dist/query/planner.js.map +1 -1
- package/dist/simulation/context.d.ts +5 -0
- package/dist/simulation/context.d.ts.map +1 -0
- package/dist/simulation/context.js +56 -0
- package/dist/simulation/context.js.map +1 -0
- package/dist/simulation/events.d.ts +3 -0
- package/dist/simulation/events.d.ts.map +1 -0
- package/dist/simulation/events.js +67 -0
- package/dist/simulation/events.js.map +1 -0
- package/dist/simulation/index.d.ts +7 -0
- package/dist/simulation/index.d.ts.map +1 -0
- package/dist/simulation/index.js +16 -0
- package/dist/simulation/index.js.map +1 -0
- package/dist/simulation/prng.d.ts +4 -0
- package/dist/simulation/prng.d.ts.map +1 -0
- package/dist/simulation/prng.js +18 -0
- package/dist/simulation/prng.js.map +1 -0
- package/dist/simulation/resource-estimate.d.ts +6 -0
- package/dist/simulation/resource-estimate.d.ts.map +1 -0
- package/dist/simulation/resource-estimate.js +11 -0
- package/dist/simulation/resource-estimate.js.map +1 -0
- package/dist/simulation/simulator.d.ts +15 -0
- package/dist/simulation/simulator.d.ts.map +1 -0
- package/dist/simulation/simulator.js +67 -0
- package/dist/simulation/simulator.js.map +1 -0
- package/dist/simulation/tracker.d.ts +8 -0
- package/dist/simulation/tracker.d.ts.map +1 -0
- package/dist/simulation/tracker.js +18 -0
- package/dist/simulation/tracker.js.map +1 -0
- package/dist/simulation/types.d.ts +49 -0
- package/dist/simulation/types.d.ts.map +1 -0
- package/dist/simulation/types.js +21 -0
- package/dist/simulation/types.js.map +1 -0
- package/dist/storage/coverage.d.ts +13 -0
- package/dist/storage/coverage.d.ts.map +1 -0
- package/dist/storage/coverage.js +37 -0
- package/dist/storage/coverage.js.map +1 -0
- package/dist/storage/memory.d.ts +23 -5
- package/dist/storage/memory.d.ts.map +1 -1
- package/dist/storage/memory.js +162 -3
- package/dist/storage/memory.js.map +1 -1
- package/dist/storage/mongo.d.ts +5 -0
- package/dist/storage/mongo.d.ts.map +1 -1
- package/dist/storage/mongo.js +68 -1
- package/dist/storage/mongo.js.map +1 -1
- package/dist/storage/redis.d.ts +40 -11
- package/dist/storage/redis.d.ts.map +1 -1
- package/dist/storage/redis.js +202 -44
- package/dist/storage/redis.js.map +1 -1
- package/dist/types/index.d.ts +165 -7
- package/dist/types/index.d.ts.map +1 -1
- package/docs/DEPLOYMENT.md +125 -3
- package/docs/countex_gap_analysis_complete_checklist.md +1340 -0
- package/docs/guides/README.md +5 -0
- package/docs/guides/adapter-mongo.md +12 -0
- package/docs/guides/adapter-redis.md +46 -4
- package/docs/guides/backup-export.md +106 -10
- package/docs/guides/cli.md +8 -0
- package/docs/guides/counter-maps.md +14 -0
- package/docs/guides/insights-overview.md +6 -0
- package/docs/guides/measures.md +4 -0
- package/docs/guides/preview.md +92 -0
- package/docs/guides/querying.md +70 -0
- package/docs/guides/simulation-profiles.md +33 -0
- package/docs/guides/simulation-resource-estimation.md +30 -0
- package/docs/guides/simulation.md +36 -0
- package/docs/internals/README.md +1 -0
- package/docs/internals/internal-dimension-hash.md +34 -0
- package/docs/internals/internal-storage-mongo.md +24 -4
- package/docs/internals/internal-storage-redis.md +41 -9
- package/docs/use-cases/README.md +56 -0
- package/docs/use-cases/audit-security-log-counts.md +550 -0
- package/docs/use-cases/llm-cost-and-token-metering.md +255 -0
- package/docs/use-cases/multi-tenant-isolation.md +203 -0
- package/docs/use-cases/ops-dashboard-daily-rollups.md +255 -0
- package/docs/use-cases/processing-workflow-activity.md +165 -0
- package/docs/use-cases/product-feature-usage.md +240 -0
- package/docs/use-cases/webhook-idempotent-ingestion.md +188 -0
- package/package.json +18 -2
package/dist/storage/redis.js
CHANGED
|
@@ -3,37 +3,70 @@
|
|
|
3
3
|
* Redis cache adapter (ioredis).
|
|
4
4
|
*
|
|
5
5
|
* Storage layout:
|
|
6
|
-
* countex:{scope}:{counterId}:{timeframeType}:{timeframeKey}
|
|
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
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
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
|
-
|
|
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.
|
|
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
|
-
|
|
61
|
-
|
|
62
|
-
pipeline.expire(
|
|
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
|
-
|
|
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
|
-
|
|
89
|
-
const
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
const
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
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
|
-
|
|
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 =
|
|
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
|
-
|
|
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
|
|
184
|
-
const
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
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
|
-
|
|
191
|
-
|
|
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
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
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":"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"}
|
|
1
|
+
{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/storage/redis.ts"],"names":[],"mappings":"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"}
|
package/dist/types/index.d.ts
CHANGED
|
@@ -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
|
-
/**
|
|
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. */
|