@x12i/countex 1.0.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 (81) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +520 -0
  3. package/dist/backup/export.d.ts +19 -0
  4. package/dist/backup/export.d.ts.map +1 -0
  5. package/dist/backup/export.js +36 -0
  6. package/dist/backup/export.js.map +1 -0
  7. package/dist/core/buffer.d.ts +27 -0
  8. package/dist/core/buffer.d.ts.map +1 -0
  9. package/dist/core/buffer.js +63 -0
  10. package/dist/core/buffer.js.map +1 -0
  11. package/dist/core/cardinality.d.ts +43 -0
  12. package/dist/core/cardinality.d.ts.map +1 -0
  13. package/dist/core/cardinality.js +93 -0
  14. package/dist/core/cardinality.js.map +1 -0
  15. package/dist/core/countex.d.ts +49 -0
  16. package/dist/core/countex.d.ts.map +1 -0
  17. package/dist/core/countex.js +331 -0
  18. package/dist/core/countex.js.map +1 -0
  19. package/dist/core/extraction.d.ts +39 -0
  20. package/dist/core/extraction.d.ts.map +1 -0
  21. package/dist/core/extraction.js +176 -0
  22. package/dist/core/extraction.js.map +1 -0
  23. package/dist/core/mapping.d.ts +8 -0
  24. package/dist/core/mapping.d.ts.map +1 -0
  25. package/dist/core/mapping.js +90 -0
  26. package/dist/core/mapping.js.map +1 -0
  27. package/dist/core/normalization.d.ts +15 -0
  28. package/dist/core/normalization.d.ts.map +1 -0
  29. package/dist/core/normalization.js +43 -0
  30. package/dist/core/normalization.js.map +1 -0
  31. package/dist/core/timeframe.d.ts +30 -0
  32. package/dist/core/timeframe.d.ts.map +1 -0
  33. package/dist/core/timeframe.js +151 -0
  34. package/dist/core/timeframe.js.map +1 -0
  35. package/dist/index.d.ts +17 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +28 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/query/formatter.d.ts +9 -0
  40. package/dist/query/formatter.d.ts.map +1 -0
  41. package/dist/query/formatter.js +119 -0
  42. package/dist/query/formatter.js.map +1 -0
  43. package/dist/query/planner.d.ts +14 -0
  44. package/dist/query/planner.d.ts.map +1 -0
  45. package/dist/query/planner.js +32 -0
  46. package/dist/query/planner.js.map +1 -0
  47. package/dist/storage/memory.d.ts +36 -0
  48. package/dist/storage/memory.d.ts.map +1 -0
  49. package/dist/storage/memory.js +150 -0
  50. package/dist/storage/memory.js.map +1 -0
  51. package/dist/storage/mongo.d.ts +56 -0
  52. package/dist/storage/mongo.d.ts.map +1 -0
  53. package/dist/storage/mongo.js +323 -0
  54. package/dist/storage/mongo.js.map +1 -0
  55. package/dist/storage/redis.d.ts +44 -0
  56. package/dist/storage/redis.d.ts.map +1 -0
  57. package/dist/storage/redis.js +193 -0
  58. package/dist/storage/redis.js.map +1 -0
  59. package/dist/types/index.d.ts +317 -0
  60. package/dist/types/index.d.ts.map +1 -0
  61. package/dist/types/index.js +9 -0
  62. package/dist/types/index.js.map +1 -0
  63. package/dist/utils/errors.d.ts +20 -0
  64. package/dist/utils/errors.d.ts.map +1 -0
  65. package/dist/utils/errors.js +44 -0
  66. package/dist/utils/errors.js.map +1 -0
  67. package/dist/utils/hash.d.ts +30 -0
  68. package/dist/utils/hash.d.ts.map +1 -0
  69. package/dist/utils/hash.js +61 -0
  70. package/dist/utils/hash.js.map +1 -0
  71. package/dist/utils/jsonpath.d.ts +40 -0
  72. package/dist/utils/jsonpath.d.ts.map +1 -0
  73. package/dist/utils/jsonpath.js +162 -0
  74. package/dist/utils/jsonpath.js.map +1 -0
  75. package/dist/utils/logger.d.ts +7 -0
  76. package/dist/utils/logger.d.ts.map +1 -0
  77. package/dist/utils/logger.js +24 -0
  78. package/dist/utils/logger.js.map +1 -0
  79. package/docs/DEPLOYMENT.md +244 -0
  80. package/docs/END_TO_END_EXAMPLE.md +316 -0
  81. package/package.json +91 -0
@@ -0,0 +1,119 @@
1
+ "use strict";
2
+ /**
3
+ * Query result formatting.
4
+ *
5
+ * The query layer fetches a flat list of cells, then this module reshapes
6
+ * them according to the requested groupBy / format.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.formatResult = formatResult;
10
+ function formatResult(cells, spec, source, partial) {
11
+ const fmt = spec.format ?? "cells";
12
+ if (fmt === "cells" && (!spec.groupBy || spec.groupBy.length === 0)) {
13
+ const sorted = sortAndLimitCells(cells, spec);
14
+ return {
15
+ format: "cells",
16
+ rows: sorted,
17
+ total: sumCount(sorted),
18
+ source,
19
+ partial,
20
+ };
21
+ }
22
+ if (fmt === "timeseries") {
23
+ const grouped = groupBy(cells, ["timeframeKey", ...(spec.groupBy ?? [])]);
24
+ const rows = grouped
25
+ .map(({ keys, count }) => {
26
+ const tk = keys["timeframeKey"];
27
+ const rest = { ...keys };
28
+ delete rest["timeframeKey"];
29
+ return {
30
+ timeframeKey: String(tk),
31
+ count,
32
+ keys: Object.keys(rest).length > 0 ? rest : undefined,
33
+ };
34
+ })
35
+ .sort((a, b) => (a.timeframeKey < b.timeframeKey ? -1 : 1));
36
+ return { format: "timeseries", rows, total: sumPoints(rows), source, partial };
37
+ }
38
+ // table / matrix / grouped cells
39
+ const grouped = groupBy(cells, spec.groupBy ?? []);
40
+ const sorted = sortAndLimitRows(grouped, spec);
41
+ if (fmt === "matrix" || fmt === "table") {
42
+ return { format: fmt, rows: sorted, total: sumRowCounts(sorted), source, partial };
43
+ }
44
+ return { format: "cells", rows: sorted, total: sumRowCounts(sorted), source, partial };
45
+ }
46
+ function groupBy(cells, by) {
47
+ if (by.length === 0) {
48
+ return [{ keys: {}, count: sumCount(cells) }];
49
+ }
50
+ const acc = new Map();
51
+ for (const c of cells) {
52
+ const keys = {};
53
+ for (const field of by) {
54
+ keys[field] = keyFor(c, field);
55
+ }
56
+ const k = JSON.stringify(keys);
57
+ const cur = acc.get(k);
58
+ if (cur)
59
+ cur.count += c.count;
60
+ else
61
+ acc.set(k, { keys, count: c.count });
62
+ }
63
+ return Array.from(acc.values());
64
+ }
65
+ function keyFor(c, field) {
66
+ if (field === "subject")
67
+ return c.subjectId;
68
+ if (field === "metric")
69
+ return c.metricId;
70
+ if (field === "timeframeKey")
71
+ return c.timeframeKey;
72
+ if (field.startsWith("dim:")) {
73
+ const dn = field.slice(4);
74
+ const v = c.dimensions[dn];
75
+ if (v === null || v === undefined)
76
+ return "";
77
+ return typeof v === "number" ? v : String(v);
78
+ }
79
+ return "";
80
+ }
81
+ function sortAndLimitCells(cells, spec) {
82
+ let out = cells;
83
+ if (spec.orderBy) {
84
+ const dir = spec.orderBy === "-count" ? -1 : 1;
85
+ out = [...out].sort((a, b) => (a.count - b.count) * dir);
86
+ }
87
+ if (spec.limit)
88
+ out = out.slice(0, spec.limit);
89
+ return out;
90
+ }
91
+ function sortAndLimitRows(rows, spec) {
92
+ let out = rows;
93
+ if (spec.orderBy) {
94
+ const dir = spec.orderBy === "-count" ? -1 : 1;
95
+ out = [...out].sort((a, b) => (a.count - b.count) * dir);
96
+ }
97
+ if (spec.limit)
98
+ out = out.slice(0, spec.limit);
99
+ return out;
100
+ }
101
+ function sumCount(cells) {
102
+ let s = 0;
103
+ for (const c of cells)
104
+ s += c.count;
105
+ return s;
106
+ }
107
+ function sumRowCounts(rows) {
108
+ let s = 0;
109
+ for (const r of rows)
110
+ s += r.count;
111
+ return s;
112
+ }
113
+ function sumPoints(pts) {
114
+ let s = 0;
115
+ for (const p of pts)
116
+ s += p.count;
117
+ return s;
118
+ }
119
+ //# sourceMappingURL=formatter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/query/formatter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Query planner.
3
+ *
4
+ * 1. Try cache (if configured & not bypassed).
5
+ * 2. If "full" coverage → return.
6
+ * 3. Otherwise read from durable.
7
+ * 4. If durable returned cells & cache was a "miss" or "partial", warm cache.
8
+ * 5. Format the result.
9
+ */
10
+ import type { CacheStorage, CounterCell, DurableStorage, QueryResult, QuerySpec } from "../types/index.js";
11
+ export declare function executeQuery(spec: QuerySpec, durable: DurableStorage, cache: CacheStorage | undefined): Promise<QueryResult>;
12
+ /** Unused export kept for downstream imports if needed. */
13
+ export type CellList = CounterCell[];
14
+ //# sourceMappingURL=planner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/query/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,SAAS,EACV,MAAM,mBAAmB,CAAC;AAG3B,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,GAAG,SAAS,GAC9B,OAAO,CAAC,WAAW,CAAC,CAqBtB;AAED,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC"}
@@ -0,0 +1,32 @@
1
+ "use strict";
2
+ /**
3
+ * Query planner.
4
+ *
5
+ * 1. Try cache (if configured & not bypassed).
6
+ * 2. If "full" coverage → return.
7
+ * 3. Otherwise read from durable.
8
+ * 4. If durable returned cells & cache was a "miss" or "partial", warm cache.
9
+ * 5. Format the result.
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.executeQuery = executeQuery;
13
+ const formatter_js_1 = require("./formatter.js");
14
+ async function executeQuery(spec, durable, cache) {
15
+ const opts = spec.signal ? { signal: spec.signal } : undefined;
16
+ if (cache && !spec.bypassCache) {
17
+ const cached = await cache.readCells(spec, opts);
18
+ if (cached.coverage === "full") {
19
+ return (0, formatter_js_1.formatResult)(cached.cells, spec, "cache", false);
20
+ }
21
+ // Partial / miss → fall through to durable. We could merge cache + missing
22
+ // buckets from durable, but that complicates correctness; simpler is:
23
+ // if not full coverage, durable is authoritative for this query.
24
+ }
25
+ const cells = await durable.readCells(spec, opts);
26
+ // Warm the cache with whatever durable returned, best-effort.
27
+ if (cache && cells.length > 0 && !spec.bypassCache) {
28
+ cache.warm(cells, opts).catch(() => { });
29
+ }
30
+ return (0, formatter_js_1.formatResult)(cells, spec, cache && !spec.bypassCache ? "merged" : "durable", false);
31
+ }
32
+ //# sourceMappingURL=planner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/query/planner.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAWH,oCAyBC;AA3BD,iDAA8C;AAEvC,KAAK,UAAU,YAAY,CAChC,IAAe,EACf,OAAuB,EACvB,KAA+B;IAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,IAAA,2BAAY,EAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;QACD,2EAA2E;QAC3E,sEAAsE;QACtE,iEAAiE;IACnE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAElD,8DAA8D;IAC9D,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAA6C,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,IAAA,2BAAY,EAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC7F,CAAC"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * In-memory storage adapter.
3
+ *
4
+ * Two classes — MemoryDurable and MemoryCache — that implement DurableStorage
5
+ * and CacheStorage respectively. Useful for tests, local development, and as a
6
+ * reference of what the contracts mean. Not for production: state is lost when
7
+ * the process exits.
8
+ */
9
+ import type { CacheStorage, CounterCell, DictionaryLookup, DurableStorage, PendingDelta, QuerySpec } from "../types/index.js";
10
+ export declare class MemoryDurable implements DurableStorage {
11
+ private state;
12
+ private dict;
13
+ private nextId;
14
+ applyDeltas(deltas: PendingDelta[]): Promise<void>;
15
+ readCells(spec: QuerySpec): Promise<CounterCell[]>;
16
+ resolveIds(lookups: DictionaryLookup[]): Promise<Map<string, number>>;
17
+ streamCells(filter: Pick<QuerySpec, "scope" | "counterId" | "timeframe">): AsyncIterable<CounterCell>;
18
+ /** Test helper. */
19
+ _getCells(): CounterCell[];
20
+ }
21
+ export declare class MemoryCache implements CacheStorage {
22
+ private state;
23
+ private seen;
24
+ applyDeltas(deltas: PendingDelta[]): Promise<void>;
25
+ readCells(spec: QuerySpec): Promise<{
26
+ cells: CounterCell[];
27
+ coverage: "full" | "partial" | "miss";
28
+ }>;
29
+ warm(cells: CounterCell[]): Promise<void>;
30
+ markEventSeen(scopeId: string, eventId: string, ttlSeconds: number): Promise<boolean>;
31
+ }
32
+ export declare function createMemoryStorage(): {
33
+ durable: MemoryDurable;
34
+ cache: MemoryCache;
35
+ };
36
+ //# sourceMappingURL=memory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAEX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,SAAS,EACV,MAAM,mBAAmB,CAAC;AA8D3B,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,MAAM,CAAK;IAEb,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIlD,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAcpE,WAAW,CAChB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC,GAC3D,aAAa,CAAC,WAAW,CAAC;IAa7B,mBAAmB;IACnB,SAAS,IAAI,WAAW,EAAE;CAG3B;AAED,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,IAAI,CAAkC;IAExC,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,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;IAKI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ5F;AAWD,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAEpF"}
@@ -0,0 +1,150 @@
1
+ "use strict";
2
+ /**
3
+ * In-memory storage adapter.
4
+ *
5
+ * Two classes — MemoryDurable and MemoryCache — that implement DurableStorage
6
+ * and CacheStorage respectively. Useful for tests, local development, and as a
7
+ * reference of what the contracts mean. Not for production: state is lost when
8
+ * the process exits.
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.MemoryCache = exports.MemoryDurable = void 0;
12
+ exports.createMemoryStorage = createMemoryStorage;
13
+ const hash_js_1 = require("../utils/hash.js");
14
+ const timeframe_js_1 = require("../core/timeframe.js");
15
+ function matchingCells(spec, state) {
16
+ const buckets = new Set((0, timeframe_js_1.bucketRange)(spec.timeframe.type, spec.timeframe.from, spec.timeframe.to));
17
+ const out = [];
18
+ for (const cell of state.cells.values()) {
19
+ if (cell.scopeId !== spec.scope)
20
+ continue;
21
+ if (cell.counterId !== spec.counterId)
22
+ continue;
23
+ if (cell.timeframeType !== spec.timeframe.type)
24
+ continue;
25
+ if (!buckets.has(cell.timeframeKey))
26
+ continue;
27
+ if (spec.subject?.type && cell.subjectType !== spec.subject.type)
28
+ continue;
29
+ if (spec.subject?.ids) {
30
+ const ids = spec.subject.ids.map((x) => Number(x));
31
+ if (!ids.includes(cell.subjectId))
32
+ continue;
33
+ }
34
+ if (spec.metrics) {
35
+ const mIds = spec.metrics.map((x) => Number(x)).filter((n) => Number.isFinite(n));
36
+ if (mIds.length && !mIds.includes(cell.metricId))
37
+ continue;
38
+ }
39
+ if (spec.dimensions) {
40
+ let ok = true;
41
+ for (const [dn, allowed] of Object.entries(spec.dimensions)) {
42
+ const v = cell.dimensions[dn];
43
+ if (!allowed.includes(v)) {
44
+ ok = false;
45
+ break;
46
+ }
47
+ }
48
+ if (!ok)
49
+ continue;
50
+ }
51
+ out.push(cell);
52
+ }
53
+ return out;
54
+ }
55
+ function applyDeltasInternal(state, deltas) {
56
+ const now = new Date();
57
+ for (const d of deltas) {
58
+ const key = (0, hash_js_1.cellKey)(d.identity);
59
+ const existing = state.cells.get(key);
60
+ if (existing) {
61
+ existing.count += d.delta;
62
+ existing.updatedAt = now;
63
+ }
64
+ else {
65
+ state.cells.set(key, {
66
+ ...d.identity,
67
+ count: d.delta,
68
+ createdAt: now,
69
+ updatedAt: now,
70
+ });
71
+ }
72
+ }
73
+ }
74
+ class MemoryDurable {
75
+ state = { cells: new Map() };
76
+ dict = new Map();
77
+ nextId = 1;
78
+ async applyDeltas(deltas) {
79
+ applyDeltasInternal(this.state, deltas);
80
+ }
81
+ async readCells(spec) {
82
+ return matchingCells(spec, this.state);
83
+ }
84
+ async resolveIds(lookups) {
85
+ const out = new Map();
86
+ for (const l of lookups) {
87
+ const k = dictKey(l.scopeId, l.kind, l.qualifier, l.sourceKey);
88
+ let id = this.dict.get(k);
89
+ if (id === undefined) {
90
+ id = this.nextId++;
91
+ this.dict.set(k, id);
92
+ }
93
+ out.set(k, id);
94
+ }
95
+ return out;
96
+ }
97
+ async *streamCells(filter) {
98
+ const buckets = new Set((0, timeframe_js_1.bucketRange)(filter.timeframe.type, filter.timeframe.from, filter.timeframe.to));
99
+ for (const cell of this.state.cells.values()) {
100
+ if (cell.scopeId !== filter.scope)
101
+ continue;
102
+ if (cell.counterId !== filter.counterId)
103
+ continue;
104
+ if (cell.timeframeType !== filter.timeframe.type)
105
+ continue;
106
+ if (!buckets.has(cell.timeframeKey))
107
+ continue;
108
+ yield cell;
109
+ }
110
+ }
111
+ /** Test helper. */
112
+ _getCells() {
113
+ return Array.from(this.state.cells.values());
114
+ }
115
+ }
116
+ exports.MemoryDurable = MemoryDurable;
117
+ class MemoryCache {
118
+ state = { cells: new Map() };
119
+ seen = new Map();
120
+ async applyDeltas(deltas) {
121
+ applyDeltasInternal(this.state, deltas);
122
+ }
123
+ async readCells(spec) {
124
+ const cells = matchingCells(spec, this.state);
125
+ return { cells, coverage: cells.length > 0 ? "full" : "miss" };
126
+ }
127
+ async warm(cells) {
128
+ const now = new Date();
129
+ for (const c of cells) {
130
+ this.state.cells.set((0, hash_js_1.cellKey)(c), { ...c, updatedAt: now });
131
+ }
132
+ }
133
+ async markEventSeen(scopeId, eventId, ttlSeconds) {
134
+ const k = `${scopeId}|${eventId}`;
135
+ const now = Date.now();
136
+ const existing = this.seen.get(k);
137
+ if (existing && existing > now)
138
+ return false;
139
+ this.seen.set(k, now + ttlSeconds * 1000);
140
+ return true;
141
+ }
142
+ }
143
+ exports.MemoryCache = MemoryCache;
144
+ function dictKey(scopeId, kind, qualifier, sourceKey) {
145
+ return `${scopeId}|${kind}|${qualifier ?? ""}|${sourceKey}`;
146
+ }
147
+ function createMemoryStorage() {
148
+ return { durable: new MemoryDurable(), cache: new MemoryCache() };
149
+ }
150
+ //# sourceMappingURL=memory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * MongoDB durable adapter.
3
+ *
4
+ * One generic collection per database (default `countex_cells`), plus a
5
+ * dictionary collection (`countex_dict`) and a counters collection
6
+ * (`countex_seq`) for monotonic id allocation. The mongodb driver is a
7
+ * peer dependency — installed by the host app, not bundled here.
8
+ *
9
+ * Schema (countex_cells):
10
+ * {
11
+ * counterId, scopeId,
12
+ * timeframeType, timeframeKey,
13
+ * subjectType, subjectId,
14
+ * metricId,
15
+ * dimensionsHash, dimensions,
16
+ * count,
17
+ * createdAt, updatedAt
18
+ * }
19
+ *
20
+ * Unique composite index on the identity tuple. All writes are upsert with
21
+ * $inc — atomic per document, safe under concurrent writers.
22
+ */
23
+ import type { MongoClient } from "mongodb";
24
+ import type { CounterCell, DictionaryLookup, DurableStorage, PendingDelta, QuerySpec } from "../types/index.js";
25
+ export interface MongoAdapterOptions {
26
+ client: MongoClient;
27
+ /** Resolve which DB to use for a given scope. Defaults to a single shared DB. */
28
+ dbResolver?: (ctx: {
29
+ scope: string;
30
+ }) => string;
31
+ /** Default DB name when no resolver. */
32
+ defaultDb?: string;
33
+ /** Collection names. */
34
+ cellsCollection?: string;
35
+ dictCollection?: string;
36
+ seqCollection?: string;
37
+ /** Skip ensureIndexes (e.g. when migrations are managed externally). */
38
+ skipIndexInit?: boolean;
39
+ }
40
+ export declare class MongoDurable implements DurableStorage {
41
+ private readonly opts;
42
+ private initialized;
43
+ constructor(opts: MongoAdapterOptions);
44
+ init(): Promise<void>;
45
+ close(): Promise<void>;
46
+ applyDeltas(deltas: PendingDelta[]): Promise<void>;
47
+ readCells(spec: QuerySpec): Promise<CounterCell[]>;
48
+ resolveIds(lookups: DictionaryLookup[]): Promise<Map<string, number>>;
49
+ streamCells(filter: Pick<QuerySpec, "scope" | "counterId" | "timeframe">): AsyncIterable<CounterCell>;
50
+ private resolveDb;
51
+ private cellsCollection;
52
+ private dictCollection;
53
+ private ensureIndexes;
54
+ private allocateIds;
55
+ }
56
+ //# sourceMappingURL=mongo.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mongo.d.ts","sourceRoot":"","sources":["../../src/storage/mongo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAIV,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EACV,WAAW,EAEX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,SAAS,EACV,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,iFAAiF;IACjF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IAChD,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA8BD,qBAAa,YAAa,YAAW,cAAc;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAGnB;IACF,OAAO,CAAC,WAAW,CAAqB;gBAE5B,IAAI,EAAE,mBAAmB;IAY/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6ClD,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IASlD,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA6EpE,WAAW,CAChB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC,GAC3D,aAAa,CAAC,WAAW,CAAC;IAgB7B,OAAO,CAAC,SAAS;YAKH,eAAe;YAQf,cAAc;YAQd,aAAa;YA2Cb,WAAW;CAe1B"}