@x12i/countex 1.5.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 (40) hide show
  1. package/README.md +57 -17
  2. package/dist/backup/manifest.d.ts +22 -1
  3. package/dist/backup/manifest.d.ts.map +1 -1
  4. package/dist/backup/manifest.js +34 -6
  5. package/dist/backup/manifest.js.map +1 -1
  6. package/dist/core/countex.d.ts +66 -1
  7. package/dist/core/countex.d.ts.map +1 -1
  8. package/dist/core/countex.js +113 -4
  9. package/dist/core/countex.js.map +1 -1
  10. package/dist/index.d.ts +4 -4
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +3 -1
  13. package/dist/index.js.map +1 -1
  14. package/dist/query/planner.d.ts +15 -1
  15. package/dist/query/planner.d.ts.map +1 -1
  16. package/dist/query/planner.js +136 -1
  17. package/dist/query/planner.js.map +1 -1
  18. package/dist/storage/coverage.d.ts +13 -0
  19. package/dist/storage/coverage.d.ts.map +1 -0
  20. package/dist/storage/coverage.js +37 -0
  21. package/dist/storage/coverage.js.map +1 -0
  22. package/dist/storage/memory.d.ts +20 -5
  23. package/dist/storage/memory.d.ts.map +1 -1
  24. package/dist/storage/memory.js +127 -3
  25. package/dist/storage/memory.js.map +1 -1
  26. package/dist/storage/redis.d.ts +36 -11
  27. package/dist/storage/redis.d.ts.map +1 -1
  28. package/dist/storage/redis.js +189 -41
  29. package/dist/storage/redis.js.map +1 -1
  30. package/dist/types/index.d.ts +114 -7
  31. package/dist/types/index.d.ts.map +1 -1
  32. package/docs/DEPLOYMENT.md +87 -3
  33. package/docs/guides/adapter-redis.md +40 -4
  34. package/docs/guides/backup-export.md +84 -32
  35. package/docs/guides/counter-maps.md +8 -0
  36. package/docs/guides/preview.md +92 -0
  37. package/docs/guides/querying.md +30 -0
  38. package/docs/internals/internal-storage-mongo.md +24 -4
  39. package/docs/internals/internal-storage-redis.md +41 -9
  40. package/package.json +1 -1
@@ -8,8 +8,9 @@
8
8
  * the process exits.
9
9
  */
10
10
  Object.defineProperty(exports, "__esModule", { value: true });
11
- exports.MemoryCache = exports.MemoryDurable = void 0;
11
+ exports.MemoryCache = exports.MEMORY_CACHE_SCHEMA_VERSION = exports.MemoryDurable = void 0;
12
12
  exports.createMemoryStorage = createMemoryStorage;
13
+ const coverage_js_1 = require("./coverage.js");
13
14
  const snapshot_encoding_js_1 = require("../backup/snapshot-encoding.js");
14
15
  const hash_js_1 = require("../utils/hash.js");
15
16
  const errors_js_1 = require("../utils/errors.js");
@@ -223,21 +224,129 @@ class MemoryDurable {
223
224
  }
224
225
  }
225
226
  exports.MemoryDurable = MemoryDurable;
227
+ /** Cache layout schema version for the in-process adapter; aligned with Redis. */
228
+ exports.MEMORY_CACHE_SCHEMA_VERSION = 1;
229
+ function bucketIdKey(scope, counterId, tf, key) {
230
+ return `${scope}|${counterId}|${tf}|${key}`;
231
+ }
226
232
  class MemoryCache {
227
233
  state = { cells: new Map() };
228
234
  seen = new Map();
235
+ bucketCoverage = new Map();
236
+ ttlByTf;
237
+ mapVersion;
238
+ constructor(opts = {}) {
239
+ this.mapVersion = opts.mapVersion;
240
+ this.ttlByTf = { ...(opts.ttlSecondsByTimeframe ?? {}) };
241
+ }
242
+ setRetentionPolicy(policy) {
243
+ this.ttlByTf = { ...this.ttlByTf, ...policy };
244
+ }
245
+ ttlFor(tf) {
246
+ const v = this.ttlByTf[tf];
247
+ return v !== undefined && v > 0 ? v : undefined;
248
+ }
249
+ freshCoverage(id) {
250
+ const m = this.bucketCoverage.get(id);
251
+ if (!m)
252
+ return { status: "missing" };
253
+ if (m.expiresAt !== undefined && m.expiresAt <= Date.now()) {
254
+ this.bucketCoverage.delete(id);
255
+ return { status: "missing" };
256
+ }
257
+ const { expiresAt: _e, ...rest } = m;
258
+ return rest;
259
+ }
229
260
  async applyDeltas(deltas) {
230
261
  applyDeltasInternal(this.state, deltas);
262
+ const now = Date.now();
263
+ const touched = new Set();
264
+ for (const d of deltas) {
265
+ const id = d.identity;
266
+ const k = bucketIdKey(id.scopeId, id.counterId, id.timeframeType, id.timeframeKey);
267
+ if (touched.has(k))
268
+ continue;
269
+ touched.add(k);
270
+ const existing = this.freshCoverage(k);
271
+ const ttl = this.ttlFor(id.timeframeType);
272
+ const expiresAt = ttl !== undefined ? now + ttl * 1000 : undefined;
273
+ // Never downgrade `complete` or `rebuilding`. Only set `partial` when missing.
274
+ const status = existing.status === "missing" ? "partial" : existing.status;
275
+ this.bucketCoverage.set(k, {
276
+ ...existing,
277
+ status,
278
+ lastWarmAt: now,
279
+ expiresAt,
280
+ });
281
+ }
231
282
  }
232
- async readCells(spec) {
283
+ async readCells(spec, opts) {
233
284
  const cells = matchingCells(spec, this.state).map(cellForPresentation);
234
- return { cells, coverage: cells.length > 0 ? "full" : "miss" };
285
+ const buckets = Array.from(new Set(cells.map((c) => c.timeframeKey)));
286
+ // Use the timeframe range to know which buckets were requested.
287
+ // We re-derive via bucketRange so `coverage: "miss"` correctly reflects empty windows.
288
+ const requested = (0, timeframe_js_1.bucketRange)(spec.timeframe.type, spec.timeframe.from, spec.timeframe.to);
289
+ const coverage = {};
290
+ for (const b of requested) {
291
+ const id = bucketIdKey(spec.scope, spec.counterId, spec.timeframe.type, b);
292
+ const meta = this.freshCoverage(id);
293
+ coverage[b] = applyVersionExpectations(meta, opts);
294
+ }
295
+ // If the bucket has cells but missing meta (legacy), promote to partial.
296
+ for (const b of buckets) {
297
+ if (coverage[b]?.status === "missing") {
298
+ coverage[b] = { ...coverage[b], status: "partial" };
299
+ }
300
+ }
301
+ return {
302
+ cells,
303
+ coverage: (0, coverage_js_1.aggregateCoverage)(requested, coverage),
304
+ bucketCoverage: coverage,
305
+ };
235
306
  }
236
307
  async warm(cells) {
237
308
  const now = new Date();
309
+ const nowMs = now.getTime();
310
+ const byBucket = new Map();
238
311
  for (const c of cells) {
239
312
  this.state.cells.set((0, hash_js_1.cellKey)(c), { ...stripMeasureScalesForWarm(c), updatedAt: now });
313
+ const id = bucketIdKey(c.scopeId, c.counterId, c.timeframeType, c.timeframeKey);
314
+ const existing = byBucket.get(id) ?? { tf: c.timeframeType, cells: [] };
315
+ existing.cells.push(c);
316
+ byBucket.set(id, existing);
317
+ }
318
+ for (const [id, { tf, cells: bcells }] of byBucket) {
319
+ const ttl = this.ttlFor(tf);
320
+ const expiresAt = ttl !== undefined ? nowMs + ttl * 1000 : undefined;
321
+ this.bucketCoverage.set(id, {
322
+ status: "complete",
323
+ lastWarmAt: nowMs,
324
+ cellCount: bcells.length,
325
+ schemaVersion: exports.MEMORY_CACHE_SCHEMA_VERSION,
326
+ ...(this.mapVersion !== undefined ? { mapVersion: this.mapVersion } : {}),
327
+ expiresAt,
328
+ });
329
+ }
330
+ }
331
+ async probeBucketCoverage(scope, counterId, timeframeType, timeframeKeys) {
332
+ const out = {};
333
+ for (const k of timeframeKeys) {
334
+ out[k] = this.freshCoverage(bucketIdKey(scope, counterId, timeframeType, k));
240
335
  }
336
+ return out;
337
+ }
338
+ async markBucketRebuilding(scope, counterId, timeframeType, timeframeKey) {
339
+ const id = bucketIdKey(scope, counterId, timeframeType, timeframeKey);
340
+ const ttl = this.ttlFor(timeframeType);
341
+ const nowMs = Date.now();
342
+ const expiresAt = ttl !== undefined ? nowMs + ttl * 1000 : undefined;
343
+ const prev = this.freshCoverage(id);
344
+ this.bucketCoverage.set(id, {
345
+ ...prev,
346
+ status: "rebuilding",
347
+ lastWarmAt: nowMs,
348
+ expiresAt,
349
+ });
241
350
  }
242
351
  async markEventSeen(scopeId, eventId, ttlSeconds) {
243
352
  const k = `${scopeId}|${eventId}`;
@@ -250,6 +359,21 @@ class MemoryCache {
250
359
  }
251
360
  }
252
361
  exports.MemoryCache = MemoryCache;
362
+ function applyVersionExpectations(meta, opts) {
363
+ if (meta.status === "complete" &&
364
+ opts?.expectedMapVersion !== undefined &&
365
+ meta.mapVersion !== undefined &&
366
+ meta.mapVersion !== opts.expectedMapVersion) {
367
+ return { ...meta, status: "partial" };
368
+ }
369
+ if (meta.status === "complete" &&
370
+ opts?.expectedSchemaVersion !== undefined &&
371
+ meta.schemaVersion !== undefined &&
372
+ meta.schemaVersion !== opts.expectedSchemaVersion) {
373
+ return { ...meta, status: "partial" };
374
+ }
375
+ return meta;
376
+ }
253
377
  function dictKey(scopeId, kind, qualifier, sourceKey) {
254
378
  return `${scopeId}|${kind}|${qualifier ?? ""}|${sourceKey}`;
255
379
  }
@@ -1 +1 @@
1
- {"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"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"}
@@ -2,22 +2,34 @@
2
2
  * Redis cache adapter (ioredis).
3
3
  *
4
4
  * Storage layout:
5
- * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey} → HASH
5
+ * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey} → HASH (cells)
6
6
  * field = "{subjectType}|{subjectId}|{metricId}|{dimensionsHash}"
7
7
  * value = count (integer)
8
8
  * field = "{base}:m:{measureName}:sum" → float/int (measure sum)
9
9
  * field = "{base}:m:{measureName}:count" → int (measure event count)
10
- * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey}:meta:{baseField}
11
- * → JSON of dimensions
12
- * countex:{scope}:dedupe:{eventId} → "1" with TTL
10
+ *
11
+ * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey}:meta:{base}
12
+ * → JSON of dimensions
13
+ *
14
+ * countex:{scope}:{counterId}:{timeframeType}:{timeframeKey}:cov → HASH (coverage meta)
15
+ * status = "complete" | "partial" | "rebuilding"
16
+ * lastWarmAt = epoch ms (string)
17
+ * mapVersion = number string (optional)
18
+ * schemaVersion = number string (optional)
19
+ * cellCount = number string (optional, set on warm)
20
+ *
21
+ * countex:{scope}:dedupe:{eventId} → "1" with TTL
13
22
  *
14
23
  * Min/max aggregates are durable-only; the cache holds sum and count per measure.
15
24
  *
16
25
  * One hash per (scope, counterId, timeframe-bucket) keeps key count tiny while
17
- * remaining cheap to read/write.
26
+ * remaining cheap to read/write. The `:cov` hash gives the planner authoritative
27
+ * per-bucket coverage rather than guessing from "did HGETALL return anything?".
18
28
  */
19
29
  import type { Redis as IORedis } from "ioredis";
20
- import type { CacheStorage, CounterCell, PendingDelta, QuerySpec, TimeframeType } from "../types/index.js";
30
+ import type { BucketCoverageMeta, CacheReadOptions, CacheReadResult, CacheStorage, CounterCell, PendingDelta, QuerySpec, TimeframeType } from "../types/index.js";
31
+ /** Cache layout schema version. Bump when the on-wire shape changes. */
32
+ export declare const REDIS_CACHE_SCHEMA_VERSION = 1;
21
33
  export interface RedisAdapterOptions {
22
34
  client: IORedis;
23
35
  /** Optional key prefix; default "countex". */
@@ -26,22 +38,35 @@ export interface RedisAdapterOptions {
26
38
  ttlSeconds?: number;
27
39
  /** Override TTL per timeframe (e.g. short minute/hour, long day/month). */
28
40
  ttlSecondsByTimeframe?: Partial<Record<TimeframeType, number>>;
41
+ /**
42
+ * Map version that warm() stamps onto bucket coverage. Reads compare to
43
+ * `expectedMapVersion` (when supplied by planner) and treat mismatches as
44
+ * partial. Optional; when undefined, version checks are skipped.
45
+ */
46
+ mapVersion?: number;
29
47
  }
30
48
  export declare class RedisCache implements CacheStorage {
31
49
  private readonly client;
32
50
  private readonly prefix;
33
51
  private readonly defaultTtl;
34
- private readonly ttlByTf;
52
+ private ttlByTf;
53
+ private readonly mapVersion?;
35
54
  constructor(opts: RedisAdapterOptions);
55
+ /**
56
+ * Engine calls this to forward unified retention config. Per-timeframe TTLs
57
+ * here override constructor defaults (constructor `ttlSecondsByTimeframe`
58
+ * remains the floor for adapters constructed without engine retention).
59
+ */
60
+ setRetentionPolicy(policy: Partial<Record<TimeframeType, number>>): void;
36
61
  private ttlFor;
37
62
  applyDeltas(deltas: PendingDelta[]): Promise<void>;
38
- readCells(spec: QuerySpec): Promise<{
39
- cells: CounterCell[];
40
- coverage: "full" | "partial" | "miss";
41
- }>;
63
+ readCells(spec: QuerySpec, opts?: CacheReadOptions): Promise<CacheReadResult>;
42
64
  warm(cells: CounterCell[]): Promise<void>;
65
+ probeBucketCoverage(scope: string, counterId: string, timeframeType: TimeframeType, timeframeKeys: string[]): Promise<Record<string, BucketCoverageMeta>>;
66
+ markBucketRebuilding(scope: string, counterId: string, timeframeType: TimeframeType, timeframeKey: string): Promise<void>;
43
67
  markEventSeen(scopeId: string, eventId: string, ttlSeconds: number): Promise<boolean>;
44
68
  private bucketKey;
69
+ private coverageKey;
45
70
  private fieldKey;
46
71
  }
47
72
  //# sourceMappingURL=redis.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/storage/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGX,YAAY,EACZ,SAAS,EACT,aAAa,EACd,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE;AAED,qBAAa,UAAW,YAAW,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;gBAErD,IAAI,EAAE,mBAAmB;IAOrC,OAAO,CAAC,MAAM;IAMR,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuClD,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QACxC,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;KACvC,CAAC;IA2GI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BzC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM3F,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;CAGjB"}
1
+ {"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/storage/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EACV,kBAAkB,EAElB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,WAAW,EAGX,YAAY,EACZ,SAAS,EACT,aAAa,EACd,MAAM,mBAAmB,CAAC;AAK3B,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,UAAW,YAAW,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,IAAI,EAAE,mBAAmB;IAQrC;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAIxE,OAAO,CAAC,MAAM;IAMR,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDlD,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6G7E,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DzC,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAoBxC,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IASV,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM3F,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;CAGjB"}
@@ -3,34 +3,57 @@
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
40
  defaultTtl;
28
41
  ttlByTf;
42
+ mapVersion;
29
43
  constructor(opts) {
30
44
  this.client = opts.client;
31
45
  this.prefix = opts.keyPrefix ?? "countex";
32
46
  this.defaultTtl = opts.ttlSeconds ?? 0;
33
- this.ttlByTf = opts.ttlSecondsByTimeframe ?? {};
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 };
34
57
  }
35
58
  ttlFor(tf) {
36
59
  const v = this.ttlByTf[tf];
@@ -42,6 +65,8 @@ class RedisCache {
42
65
  if (deltas.length === 0)
43
66
  return;
44
67
  const pipeline = this.client.pipeline();
68
+ const now = Date.now();
69
+ const touchedBuckets = new Set();
45
70
  for (const d of deltas) {
46
71
  const id = d.identity;
47
72
  const hashKey = this.bucketKey(id.scopeId, id.counterId, id.timeframeType, id.timeframeKey);
@@ -70,16 +95,27 @@ class RedisCache {
70
95
  pipeline.expire(hashKey, ttl);
71
96
  pipeline.expire(metaKey, ttl);
72
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);
107
+ }
73
108
  }
74
109
  await pipeline.exec();
75
110
  }
76
- async readCells(spec) {
111
+ async readCells(spec, opts) {
77
112
  const buckets = (0, timeframe_js_1.bucketRange)(spec.timeframe.type, spec.timeframe.from, spec.timeframe.to);
78
113
  if (buckets.length === 0)
79
114
  return { cells: [], coverage: "miss" };
80
115
  const pipeline = this.client.pipeline();
81
116
  for (const b of buckets) {
82
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));
83
119
  }
84
120
  const results = await pipeline.exec();
85
121
  if (!results)
@@ -87,24 +123,25 @@ class RedisCache {
87
123
  const cellMap = new Map();
88
124
  const metaToFetch = [];
89
125
  const metaQueued = new Set();
90
- let bucketsHit = 0;
126
+ const bucketCoverage = {};
91
127
  const queueMeta = (hashKey, baseField, composite, cell) => {
92
128
  if (metaQueued.has(composite))
93
129
  return;
94
130
  metaQueued.add(composite);
95
131
  metaToFetch.push({ key: `${hashKey}:meta:${baseField}`, cell });
96
132
  };
97
- results.forEach((entry, idx) => {
98
- const [err, raw] = entry;
99
- if (err || !raw)
100
- return;
101
- const hash = raw;
102
- if (Object.keys(hash).length === 0)
103
- return;
104
- bucketsHit++;
105
- 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);
106
141
  const hashKey = this.bucketKey(spec.scope, spec.counterId, spec.timeframe.type, bucket);
107
- 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)) {
108
145
  const mi = field.indexOf(MEASURE_SEP);
109
146
  if (mi === -1) {
110
147
  const parsed = parseBaseField(field);
@@ -152,15 +189,12 @@ class RedisCache {
152
189
  queueMeta(hashKey, baseField, composite, cell);
153
190
  }
154
191
  }
155
- });
192
+ }
156
193
  const cells = Array.from(cellMap.values());
157
194
  for (const c of cells) {
158
195
  if (c.measures && Object.keys(c.measures).length === 0)
159
196
  delete c.measures;
160
197
  }
161
- if (cells.length === 0) {
162
- return { cells, coverage: "miss" };
163
- }
164
198
  if (metaToFetch.length > 0) {
165
199
  const metaPipeline = this.client.pipeline();
166
200
  for (const m of metaToFetch)
@@ -181,33 +215,93 @@ class RedisCache {
181
215
  }
182
216
  }
183
217
  const filtered = cells.filter((c) => matchesSpec(c, spec));
184
- const coverage = bucketsHit === buckets.length ? "full" : bucketsHit > 0 ? "partial" : "miss";
185
- return { cells: filtered, coverage };
218
+ const coverage = (0, coverage_js_1.aggregateCoverage)(buckets, bucketCoverage);
219
+ return { cells: filtered, coverage, bucketCoverage };
186
220
  }
187
221
  async warm(cells) {
188
222
  if (cells.length === 0)
189
223
  return;
190
- 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();
191
227
  for (const c of cells) {
192
- const hashKey = this.bucketKey(c.scopeId, c.counterId, c.timeframeType, c.timeframeKey);
193
- const field = this.fieldKey(c.subjectType, c.subjectId, c.metricId, c.dimensionsHash);
194
- pipeline.hset(hashKey, field, c.count);
195
- for (const [name, mv] of Object.entries(c.measures ?? {})) {
196
- if (mv.sum !== undefined) {
197
- 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
+ }
198
253
  }
199
- if (mv.count !== undefined) {
200
- 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);
201
260
  }
202
261
  }
203
- const metaKey = `${hashKey}:meta:${field}`;
204
- pipeline.set(metaKey, JSON.stringify(c.dimensions));
205
- const ttl = this.ttlFor(c.timeframeType);
206
- if (ttl > 0) {
207
- pipeline.expire(hashKey, ttl);
208
- pipeline.expire(metaKey, ttl);
209
- }
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);
275
+ }
276
+ await pipeline.exec();
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));
210
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);
211
305
  await pipeline.exec();
212
306
  }
213
307
  async markEventSeen(scopeId, eventId, ttlSeconds) {
@@ -218,11 +312,65 @@ class RedisCache {
218
312
  bucketKey(scopeId, counterId, type, key) {
219
313
  return `${this.prefix}:${scopeId}:${counterId}:${type}:${key}`;
220
314
  }
315
+ coverageKey(scopeId, counterId, type, key) {
316
+ return `${this.bucketKey(scopeId, counterId, type, key)}:cov`;
317
+ }
221
318
  fieldKey(subjectType, subjectId, metricId, dimsHash) {
222
319
  return `${subjectType}|${subjectId}|${metricId}|${dimsHash}`;
223
320
  }
224
321
  }
225
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
+ }
226
374
  function parseBaseField(field) {
227
375
  const parts = field.split("|");
228
376
  if (parts.length !== 4)