@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,317 @@
1
+ /**
2
+ * Public types for @x12i/countex.
3
+ *
4
+ * These define every contract a consumer of the library will see:
5
+ * the shape of mappings, events, cells, queries, results, and storage adapters.
6
+ */
7
+ export type DimensionValue = string | number | boolean | null;
8
+ export type Dimensions = Record<string, DimensionValue>;
9
+ export type TimeframeType = "day" | "week" | "month" | "quarter" | "year" | "all";
10
+ export type JsonValue = string | number | boolean | null | JsonValue[] | {
11
+ [key: string]: JsonValue;
12
+ };
13
+ export type JsonObject = {
14
+ [key: string]: JsonValue;
15
+ };
16
+ /**
17
+ * A path expression. Subset of JSONPath:
18
+ * $ root
19
+ * .name property
20
+ * ['name'] property (bracket form)
21
+ * [0] array index
22
+ * [*] all array elements (fanout)
23
+ * Chained, e.g. $.a.b[*].c or $['actor']['id']
24
+ */
25
+ export type PathExpr = string;
26
+ /** A subject extractor — the "thing being counted against". */
27
+ export interface SubjectMapping {
28
+ /** A label for this subject extractor (e.g. "actor", "target"). Becomes part of the cell identity. */
29
+ type: string;
30
+ path: PathExpr;
31
+ required?: boolean;
32
+ }
33
+ /** A metric extractor — the "category/label/measure". */
34
+ export interface MetricMapping {
35
+ /** Optional name; if your map has multiple metric extractors you can label them. */
36
+ name?: string;
37
+ path: PathExpr;
38
+ required?: boolean;
39
+ }
40
+ /** A dimension extractor — extra breakdowns. */
41
+ export interface DimensionMapping {
42
+ name: string;
43
+ path: PathExpr;
44
+ /** If true, missing values cause the whole increment to be skipped. Default false (skip just this dimension). */
45
+ required?: boolean;
46
+ }
47
+ /** Delta extraction — how many to add (or subtract). */
48
+ export interface DeltaMapping {
49
+ path?: PathExpr;
50
+ default?: number;
51
+ }
52
+ export interface CardinalityPolicy {
53
+ maxDimensionValuesPerScope?: number;
54
+ maxDimensionValuesPerName?: number;
55
+ maxSubjectsPerScope?: number;
56
+ /** Replacement value when a limit is hit (only meaningful when onLimit === "overflow"). */
57
+ overflowValue?: string;
58
+ onLimit?: "overflow" | "drop" | "error";
59
+ highCardinalityWarnings?: boolean;
60
+ }
61
+ export interface IdempotencyPolicy {
62
+ enabled: boolean;
63
+ /** JSONPath to a unique event id. */
64
+ eventIdPath?: PathExpr;
65
+ /** TTL of the dedupe marker in seconds. */
66
+ ttlSeconds?: number;
67
+ }
68
+ export interface MappingOptions {
69
+ /** Default true. If a non-required dimension is missing, do not include it in the cell. */
70
+ skipMissingOptionalDimensions?: boolean;
71
+ /** Default true. Trim, lowercase, etc. for string values used as dictionary keys. */
72
+ normalizeValues?: boolean;
73
+ }
74
+ /**
75
+ * The heart of Countex. A counter map declares how to project a JSON event
76
+ * into one or many counter increments. Countex never knows what the input means;
77
+ * the map says where to find scope, subjects, metrics, dimensions, time, delta.
78
+ */
79
+ export interface CounterMap {
80
+ /** A stable identifier for this counter family (e.g. "access_by_subject_metric"). */
81
+ counterId: string;
82
+ scope: {
83
+ path: PathExpr;
84
+ };
85
+ eventTime: {
86
+ path: PathExpr;
87
+ };
88
+ subjects: SubjectMapping[];
89
+ metrics: MetricMapping[];
90
+ dimensions: DimensionMapping[];
91
+ delta?: DeltaMapping;
92
+ timeframes: TimeframeType[];
93
+ options?: MappingOptions;
94
+ cardinality?: CardinalityPolicy;
95
+ idempotency?: IdempotencyPolicy;
96
+ }
97
+ /**
98
+ * A sparse counter cell. This is the unit of aggregation — every increment
99
+ * targets exactly one cell, identified by the tuple
100
+ * (counterId, scopeId, timeframeType, timeframeKey, subjectType, subjectId, metricId, dimensionsHash).
101
+ */
102
+ export interface CounterCell {
103
+ scopeId: string;
104
+ counterId: string;
105
+ timeframeType: TimeframeType;
106
+ /** Deterministic bucket key — e.g. "2026-05-08", "2026-W19", "2026-Q2", "all". */
107
+ timeframeKey: string;
108
+ /** Subject type label (e.g. "actor"); part of the cell identity for multi-subject maps. */
109
+ subjectType: string;
110
+ subjectId: number;
111
+ metricId: number;
112
+ /** Short stable hash over the (sorted, normalized) dimensions. */
113
+ dimensionsHash: string;
114
+ /** Materialized dimension values keyed by dimension name. */
115
+ dimensions: Dimensions;
116
+ count: number;
117
+ /** Optional metadata stored alongside the cell. */
118
+ createdAt?: Date;
119
+ updatedAt?: Date;
120
+ }
121
+ /** Identifying tuple of a cell, without the count. */
122
+ export type CellIdentity = Omit<CounterCell, "count" | "createdAt" | "updatedAt">;
123
+ /**
124
+ * A pending delta — what Countex writes during a flush. Cells are addressed
125
+ * by their full identity; storage applies +delta atomically.
126
+ */
127
+ export interface PendingDelta {
128
+ identity: CellIdentity;
129
+ delta: number;
130
+ }
131
+ export interface TimeframeRange {
132
+ type: TimeframeType;
133
+ /** Inclusive lower bound, in the bucket's natural string form (e.g. "2026-05-01"). */
134
+ from: string;
135
+ /** Inclusive upper bound. */
136
+ to: string;
137
+ }
138
+ export interface SubjectFilter {
139
+ type?: string;
140
+ ids?: Array<string | number>;
141
+ }
142
+ export type DimensionFilter = Record<string, DimensionValue[]>;
143
+ export type GroupByField = "subject" | "metric" | "timeframeKey" | `dim:${string}`;
144
+ export type ResultFormat = "cells" | "table" | "matrix" | "timeseries";
145
+ export interface QuerySpec {
146
+ scope: string;
147
+ counterId: string;
148
+ timeframe: TimeframeRange;
149
+ subject?: SubjectFilter;
150
+ /** Filter by metric source-key (e.g. "PCI") or numeric id. */
151
+ metrics?: Array<string | number>;
152
+ dimensions?: DimensionFilter;
153
+ groupBy?: GroupByField[];
154
+ /** Output shape. Defaults to "cells". */
155
+ format?: ResultFormat;
156
+ /** Sort by aggregated count by default. Use "-count" for descending. */
157
+ orderBy?: "count" | "-count";
158
+ limit?: number;
159
+ /** If true, force read from durable storage (skip cache). */
160
+ bypassCache?: boolean;
161
+ signal?: AbortSignal;
162
+ }
163
+ /** A grouped row — keys depend on `groupBy`. */
164
+ export interface QueryRow {
165
+ keys: Record<string, string | number>;
166
+ count: number;
167
+ }
168
+ /** Generic time-series row. */
169
+ export interface TimeseriesPoint {
170
+ timeframeKey: string;
171
+ count: number;
172
+ /** Present when other groupings are also active. */
173
+ keys?: Record<string, string | number>;
174
+ }
175
+ export interface QueryResult {
176
+ format: ResultFormat;
177
+ rows: QueryRow[] | CounterCell[] | TimeseriesPoint[];
178
+ total: number;
179
+ /** Diagnostics: how the query was answered. */
180
+ source: "cache" | "durable" | "merged";
181
+ partial?: boolean;
182
+ }
183
+ /**
184
+ * The dictionary maps arbitrary source keys (UUIDs, emails, names, paths, ...)
185
+ * to compact internal numeric ids, scoped per-tenant.
186
+ */
187
+ export type DictionaryKind = "subject" | "metric" | "dimensionValue";
188
+ export interface DictionaryLookup {
189
+ scopeId: string;
190
+ kind: DictionaryKind;
191
+ /** For subjects: the subject type. For dimension values: the dimension name. Otherwise undefined. */
192
+ qualifier?: string;
193
+ sourceKey: string;
194
+ }
195
+ /**
196
+ * Durable storage. Source of truth. Must support atomic per-cell delta application.
197
+ */
198
+ export interface DurableStorage {
199
+ /** Apply a batch of deltas atomically per-cell ($inc-equivalent). */
200
+ applyDeltas(deltas: PendingDelta[], opts?: {
201
+ signal?: AbortSignal;
202
+ }): Promise<void>;
203
+ /** Read cells matching a query. */
204
+ readCells(spec: QuerySpec, opts?: {
205
+ signal?: AbortSignal;
206
+ }): Promise<CounterCell[]>;
207
+ /**
208
+ * Resolve (and create if missing) internal numeric ids for a batch of dictionary lookups.
209
+ * Returning a Map keyed by a stable lookup key.
210
+ */
211
+ resolveIds(lookups: DictionaryLookup[], opts?: {
212
+ signal?: AbortSignal;
213
+ }): Promise<Map<string, number>>;
214
+ /** Stream all cells matching a filter — used for export and rebuild. */
215
+ streamCells(filter: Pick<QuerySpec, "scope" | "counterId" | "timeframe">, opts?: {
216
+ signal?: AbortSignal;
217
+ }): AsyncIterable<CounterCell>;
218
+ /** Lifecycle hooks. */
219
+ init?(): Promise<void>;
220
+ close?(): Promise<void>;
221
+ }
222
+ /**
223
+ * Hot cache. Best-effort, can be lossy. Reads should be answerable from here
224
+ * for hot timeframes; misses fall back to durable.
225
+ */
226
+ export interface CacheStorage {
227
+ applyDeltas(deltas: PendingDelta[], opts?: {
228
+ signal?: AbortSignal;
229
+ }): Promise<void>;
230
+ /**
231
+ * Read cells matching a query from cache. Return an empty array when the cache
232
+ * has nothing covering the query — the query layer will fall through to durable.
233
+ */
234
+ readCells(spec: QuerySpec, opts?: {
235
+ signal?: AbortSignal;
236
+ }): Promise<{
237
+ cells: CounterCell[];
238
+ coverage: "full" | "partial" | "miss";
239
+ }>;
240
+ /** Warm cache from a batch of cells (after a durable read). */
241
+ warm(cells: CounterCell[], opts?: {
242
+ signal?: AbortSignal;
243
+ }): Promise<void>;
244
+ /**
245
+ * Idempotency dedupe — atomically records that an event id was seen.
246
+ * Returns true when the event is new (proceed), false when it's a duplicate (skip).
247
+ */
248
+ markEventSeen?(scopeId: string, eventId: string, ttlSeconds: number, opts?: {
249
+ signal?: AbortSignal;
250
+ }): Promise<boolean>;
251
+ init?(): Promise<void>;
252
+ close?(): Promise<void>;
253
+ }
254
+ export interface FlushPolicy {
255
+ everyMs?: number;
256
+ maxBufferedCells?: number;
257
+ maxBufferedEvents?: number;
258
+ flushOnShutdown?: boolean;
259
+ /** When the buffer is full, drop new events instead of blocking. Default: block via Promise. */
260
+ onOverflow?: "block" | "drop";
261
+ }
262
+ export interface CachePolicy {
263
+ /** Per-timeframe-type retention windows. Entries older than this become cache-misses. */
264
+ hotTimeframes?: Partial<Record<TimeframeType, number>>;
265
+ }
266
+ export interface CountexLogger {
267
+ debug?(msg: string, meta?: Record<string, unknown>): void;
268
+ info?(msg: string, meta?: Record<string, unknown>): void;
269
+ warn?(msg: string, meta?: Record<string, unknown>): void;
270
+ error?(msg: string, meta?: Record<string, unknown>): void;
271
+ }
272
+ export interface CountexConfig {
273
+ maps: CounterMap[];
274
+ durable: DurableStorage;
275
+ cache?: CacheStorage;
276
+ flush?: FlushPolicy;
277
+ cachePolicy?: CachePolicy;
278
+ /** Default idempotency policy applied when a map doesn't override. */
279
+ idempotency?: IdempotencyPolicy;
280
+ /** Default cardinality policy applied when a map doesn't override. */
281
+ cardinality?: CardinalityPolicy;
282
+ logger?: CountexLogger;
283
+ /** Now-provider for testability. */
284
+ now?: () => Date;
285
+ }
286
+ export interface CountexEvents {
287
+ flush: {
288
+ cells: number;
289
+ events: number;
290
+ durationMs: number;
291
+ };
292
+ flush_error: {
293
+ error: Error;
294
+ };
295
+ cardinality_warning: {
296
+ scopeId: string;
297
+ kind: DictionaryKind;
298
+ qualifier?: string;
299
+ count: number;
300
+ limit: number;
301
+ };
302
+ overflow: {
303
+ scopeId: string;
304
+ kind: DictionaryKind;
305
+ qualifier?: string;
306
+ sourceKey: string;
307
+ };
308
+ dropped: {
309
+ reason: string;
310
+ event?: unknown;
311
+ };
312
+ duplicate: {
313
+ scopeId: string;
314
+ eventId: string;
315
+ };
316
+ }
317
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ /**
3
+ * Public types for @x12i/countex.
4
+ *
5
+ * These define every contract a consumer of the library will see:
6
+ * the shape of mappings, events, cells, queries, results, and storage adapters.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Typed errors. Caller code can `instanceof` to react specifically.
3
+ */
4
+ export declare class CountexError extends Error {
5
+ readonly meta?: Record<string, unknown> | undefined;
6
+ constructor(message: string, meta?: Record<string, unknown> | undefined);
7
+ }
8
+ export declare class MappingError extends CountexError {
9
+ constructor(message: string, meta?: Record<string, unknown>);
10
+ }
11
+ export declare class ExtractionError extends CountexError {
12
+ constructor(message: string, meta?: Record<string, unknown>);
13
+ }
14
+ export declare class CardinalityLimitError extends CountexError {
15
+ constructor(message: string, meta?: Record<string, unknown>);
16
+ }
17
+ export declare class StorageError extends CountexError {
18
+ constructor(message: string, meta?: Record<string, unknown>);
19
+ }
20
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,YAAa,SAAQ,KAAK;aACQ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAA/D,OAAO,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAI5E;AAED,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D"}
@@ -0,0 +1,44 @@
1
+ "use strict";
2
+ /**
3
+ * Typed errors. Caller code can `instanceof` to react specifically.
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.StorageError = exports.CardinalityLimitError = exports.ExtractionError = exports.MappingError = exports.CountexError = void 0;
7
+ class CountexError extends Error {
8
+ meta;
9
+ constructor(message, meta) {
10
+ super(message);
11
+ this.meta = meta;
12
+ this.name = "CountexError";
13
+ }
14
+ }
15
+ exports.CountexError = CountexError;
16
+ class MappingError extends CountexError {
17
+ constructor(message, meta) {
18
+ super(message, meta);
19
+ this.name = "MappingError";
20
+ }
21
+ }
22
+ exports.MappingError = MappingError;
23
+ class ExtractionError extends CountexError {
24
+ constructor(message, meta) {
25
+ super(message, meta);
26
+ this.name = "ExtractionError";
27
+ }
28
+ }
29
+ exports.ExtractionError = ExtractionError;
30
+ class CardinalityLimitError extends CountexError {
31
+ constructor(message, meta) {
32
+ super(message, meta);
33
+ this.name = "CardinalityLimitError";
34
+ }
35
+ }
36
+ exports.CardinalityLimitError = CardinalityLimitError;
37
+ class StorageError extends CountexError {
38
+ constructor(message, meta) {
39
+ super(message, meta);
40
+ this.name = "StorageError";
41
+ }
42
+ }
43
+ exports.StorageError = StorageError;
44
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,MAAa,YAAa,SAAQ,KAAK;IACQ;IAA7C,YAAY,OAAe,EAAkB,IAA8B;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,SAAI,GAAJ,IAAI,CAA0B;QAEzE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,MAAa,YAAa,SAAQ,YAAY;IAC5C,YAAY,OAAe,EAAE,IAA8B;QACzD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAE,IAA8B;QACzD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAe,EAAE,IAA8B;QACzD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,YAAa,SAAQ,YAAY;IAC5C,YAAY,OAAe,EAAE,IAA8B;QACzD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Stable, fast-enough hash for cell identity. We use SHA-1 truncated to 12 hex
3
+ * chars (48 bits). Collisions are negligible at the cardinalities Countex
4
+ * targets, the hash is per-(scope, counterId) anyway, and it's a built-in.
5
+ *
6
+ * If a user wants a faster non-crypto hash they can swap this module via DI in
7
+ * the future; for now zero-dep correctness wins.
8
+ */
9
+ import type { Dimensions } from "../types/index.js";
10
+ /**
11
+ * Canonical serialization of a dimensions object: keys sorted, values
12
+ * normalized to a small grammar that round-trips unambiguously.
13
+ */
14
+ export declare function canonicalizeDimensions(dims: Dimensions): string;
15
+ export declare function dimensionsHash(dims: Dimensions): string;
16
+ /**
17
+ * A short stable string id for any cell, suitable as a Map key in the
18
+ * local delta buffer.
19
+ */
20
+ export declare function cellKey(parts: {
21
+ scopeId: string;
22
+ counterId: string;
23
+ timeframeType: string;
24
+ timeframeKey: string;
25
+ subjectType: string;
26
+ subjectId: number;
27
+ metricId: number;
28
+ dimensionsHash: string;
29
+ }): string;
30
+ //# sourceMappingURL=hash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,mBAAmB,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAO/D;AAaD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIvD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAWT"}
@@ -0,0 +1,61 @@
1
+ "use strict";
2
+ /**
3
+ * Stable, fast-enough hash for cell identity. We use SHA-1 truncated to 12 hex
4
+ * chars (48 bits). Collisions are negligible at the cardinalities Countex
5
+ * targets, the hash is per-(scope, counterId) anyway, and it's a built-in.
6
+ *
7
+ * If a user wants a faster non-crypto hash they can swap this module via DI in
8
+ * the future; for now zero-dep correctness wins.
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.canonicalizeDimensions = canonicalizeDimensions;
12
+ exports.dimensionsHash = dimensionsHash;
13
+ exports.cellKey = cellKey;
14
+ const node_crypto_1 = require("node:crypto");
15
+ /**
16
+ * Canonical serialization of a dimensions object: keys sorted, values
17
+ * normalized to a small grammar that round-trips unambiguously.
18
+ */
19
+ function canonicalizeDimensions(dims) {
20
+ const keys = Object.keys(dims).sort();
21
+ const parts = [];
22
+ for (const k of keys) {
23
+ parts.push(`${escape(k)}=${encodeValue(dims[k])}`);
24
+ }
25
+ return parts.join("&");
26
+ }
27
+ function escape(s) {
28
+ return s.replace(/[\\=&]/g, (c) => `\\${c}`);
29
+ }
30
+ function encodeValue(v) {
31
+ if (v === null)
32
+ return "n:";
33
+ if (typeof v === "boolean")
34
+ return v ? "b:1" : "b:0";
35
+ if (typeof v === "number")
36
+ return Number.isFinite(v) ? `i:${v}` : "n:";
37
+ return `s:${escape(v)}`;
38
+ }
39
+ function dimensionsHash(dims) {
40
+ if (Object.keys(dims).length === 0)
41
+ return "0";
42
+ const canon = canonicalizeDimensions(dims);
43
+ return (0, node_crypto_1.createHash)("sha1").update(canon).digest("hex").slice(0, 12);
44
+ }
45
+ /**
46
+ * A short stable string id for any cell, suitable as a Map key in the
47
+ * local delta buffer.
48
+ */
49
+ function cellKey(parts) {
50
+ return [
51
+ parts.scopeId,
52
+ parts.counterId,
53
+ parts.timeframeType,
54
+ parts.timeframeKey,
55
+ parts.subjectType,
56
+ parts.subjectId,
57
+ parts.metricId,
58
+ parts.dimensionsHash,
59
+ ].join("|");
60
+ }
61
+ //# sourceMappingURL=hash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AASH,wDAOC;AAaD,wCAIC;AAMD,0BAoBC;AAzDD,6CAAyC;AAGzC;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,IAAgB;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,WAAW,CAAC,CAAiB;IACpC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACrD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED,SAAgB,cAAc,CAAC,IAAgB;IAC7C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/C,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,IAAA,wBAAU,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,SAAgB,OAAO,CAAC,KASvB;IACC,OAAO;QACL,KAAK,CAAC,OAAO;QACb,KAAK,CAAC,SAAS;QACf,KAAK,CAAC,aAAa;QACnB,KAAK,CAAC,YAAY;QAClB,KAAK,CAAC,WAAW;QACjB,KAAK,CAAC,SAAS;QACf,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,cAAc;KACrB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Minimal JSONPath subset.
3
+ *
4
+ * Supported syntax:
5
+ * $ root
6
+ * .name property
7
+ * ['name'] / ["name"] property (bracket form, allows arbitrary chars)
8
+ * [N] array index (N integer)
9
+ * [*] wildcard — fanout: returns all elements/values
10
+ *
11
+ * Path evaluation always returns an array of values.
12
+ * - Wildcards or fanout from arrays of arrays produce multiple values.
13
+ * - Missing paths return [].
14
+ * - For a single-value extraction, callers take result[0].
15
+ *
16
+ * Examples:
17
+ * "$.tenant.id" → [tenantId] or []
18
+ * "$.labels[*]" → ["PCI", "PII", "Financial"] or []
19
+ * "$.actor.id" → [actorId] or []
20
+ * "$['actor.with.dots']" → [...]
21
+ */
22
+ type Segment = {
23
+ type: "prop";
24
+ name: string;
25
+ } | {
26
+ type: "index";
27
+ index: number;
28
+ } | {
29
+ type: "wildcard";
30
+ };
31
+ export declare function parsePath(expr: string): Segment[];
32
+ /**
33
+ * Evaluate a parsed path against a JSON value. Always returns an array.
34
+ * Short-circuits to [] when an intermediate access fails.
35
+ */
36
+ export declare function evaluate(segments: Segment[], root: unknown): unknown[];
37
+ /** Convenience: parse + evaluate. */
38
+ export declare function extract(expr: string, root: unknown): unknown[];
39
+ export {};
40
+ //# sourceMappingURL=jsonpath.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jsonpath.d.ts","sourceRoot":"","sources":["../../src/utils/jsonpath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,KAAK,OAAO,GACR;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAIzB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAsFjD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAwCtE;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAE9D"}