@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 @@
1
+ {"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../src/core/extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,mBAAmB,CAAC;AAQ3B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAEhB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IAExB,8DAA8D;IAC9D,UAAU,EAAE,UAAU,CAAC;IAEvB,KAAK,EAAE,MAAM,CAAC;IAEd,UAAU,EAAE,aAAa,EAAE,CAAC;IAE5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,kFAAkF;IAClF,OAAO,EAAE,OAAO,CAAC;IACjB,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAqKnF"}
@@ -0,0 +1,176 @@
1
+ "use strict";
2
+ /**
3
+ * Extraction.
4
+ *
5
+ * Given a CounterMap and a JSON event, produce a list of "raw increments" — each
6
+ * raw increment carries the source-keys (not yet resolved to internal ids), the
7
+ * dimensions, the delta, and the event time. The dictionary stage then resolves
8
+ * source-keys → internal numeric ids, and the buffer stage groups by cell.
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.extractIncrements = extractIncrements;
12
+ const jsonpath_js_1 = require("../utils/jsonpath.js");
13
+ const normalization_js_1 = require("./normalization.js");
14
+ function extractIncrements(map, event) {
15
+ const warnings = [];
16
+ // ── Scope ────────────────────────────────────────────────────────────────
17
+ const scopeVals = (0, jsonpath_js_1.extract)(map.scope.path, event);
18
+ const scopeRaw = scopeVals[0];
19
+ if (!(0, normalization_js_1.isPlainScalar)(scopeRaw)) {
20
+ return {
21
+ increments: [],
22
+ warnings: [{ reason: "missing scope", meta: { path: map.scope.path } }],
23
+ skipped: true,
24
+ };
25
+ }
26
+ const scopeId = String(scopeRaw);
27
+ // ── Event time ───────────────────────────────────────────────────────────
28
+ const timeVals = (0, jsonpath_js_1.extract)(map.eventTime.path, event);
29
+ const timeRaw = timeVals[0];
30
+ let eventTime;
31
+ if (timeRaw instanceof Date) {
32
+ eventTime = timeRaw;
33
+ }
34
+ else if (typeof timeRaw === "string" || typeof timeRaw === "number") {
35
+ eventTime = new Date(timeRaw);
36
+ }
37
+ else {
38
+ return {
39
+ increments: [],
40
+ warnings: [{ reason: "missing eventTime", meta: { path: map.eventTime.path } }],
41
+ skipped: true,
42
+ };
43
+ }
44
+ if (Number.isNaN(eventTime.getTime())) {
45
+ return {
46
+ increments: [],
47
+ warnings: [{ reason: "invalid eventTime", meta: { value: timeRaw } }],
48
+ skipped: true,
49
+ };
50
+ }
51
+ // ── Idempotency event id ─────────────────────────────────────────────────
52
+ let eventId;
53
+ if (map.idempotency?.enabled && map.idempotency.eventIdPath) {
54
+ const idVals = (0, jsonpath_js_1.extract)(map.idempotency.eventIdPath, event);
55
+ const idRaw = idVals[0];
56
+ if ((0, normalization_js_1.isPlainScalar)(idRaw)) {
57
+ eventId = String(idRaw);
58
+ }
59
+ else {
60
+ warnings.push({ reason: "missing eventId for idempotency" });
61
+ }
62
+ }
63
+ // ── Delta ────────────────────────────────────────────────────────────────
64
+ let delta = map.delta?.default ?? 1;
65
+ if (map.delta?.path) {
66
+ const dVals = (0, jsonpath_js_1.extract)(map.delta.path, event);
67
+ const dRaw = dVals[0];
68
+ if (typeof dRaw === "number" && Number.isFinite(dRaw)) {
69
+ delta = Math.trunc(dRaw);
70
+ }
71
+ else if (typeof dRaw === "string" && !isNaN(Number(dRaw))) {
72
+ delta = Math.trunc(Number(dRaw));
73
+ }
74
+ else if (dRaw === undefined && map.delta.default !== undefined) {
75
+ delta = map.delta.default;
76
+ }
77
+ else if (dRaw !== undefined) {
78
+ warnings.push({ reason: "invalid delta value", meta: { value: dRaw } });
79
+ }
80
+ }
81
+ if (delta === 0) {
82
+ return { increments: [], warnings: [{ reason: "zero delta" }], skipped: true };
83
+ }
84
+ // ── Subjects ─────────────────────────────────────────────────────────────
85
+ const subjectFanout = [];
86
+ for (const s of map.subjects) {
87
+ const vals = (0, jsonpath_js_1.extract)(s.path, event);
88
+ const present = vals.filter(normalization_js_1.isPlainScalar);
89
+ if (present.length === 0) {
90
+ if (s.required) {
91
+ return {
92
+ increments: [],
93
+ warnings: [{ reason: `missing required subject '${s.type}'` }],
94
+ skipped: true,
95
+ };
96
+ }
97
+ continue;
98
+ }
99
+ for (const v of present) {
100
+ const norm = (0, normalization_js_1.normalizeKey)(v);
101
+ if (norm === "")
102
+ continue;
103
+ subjectFanout.push({ type: s.type, sourceKey: norm });
104
+ }
105
+ }
106
+ if (subjectFanout.length === 0) {
107
+ return { increments: [], warnings: [{ reason: "no subjects extracted" }], skipped: true };
108
+ }
109
+ // ── Metrics ──────────────────────────────────────────────────────────────
110
+ const metricFanout = [];
111
+ for (const m of map.metrics) {
112
+ const vals = (0, jsonpath_js_1.extract)(m.path, event);
113
+ const present = vals.filter(normalization_js_1.isPlainScalar);
114
+ if (present.length === 0) {
115
+ if (m.required) {
116
+ return {
117
+ increments: [],
118
+ warnings: [{ reason: "missing required metric" }],
119
+ skipped: true,
120
+ };
121
+ }
122
+ continue;
123
+ }
124
+ for (const v of present) {
125
+ const norm = (0, normalization_js_1.normalizeKey)(v);
126
+ if (norm === "")
127
+ continue;
128
+ metricFanout.push(norm);
129
+ }
130
+ }
131
+ if (metricFanout.length === 0) {
132
+ return { increments: [], warnings: [{ reason: "no metrics extracted" }], skipped: true };
133
+ }
134
+ // ── Dimensions ───────────────────────────────────────────────────────────
135
+ const skipMissingOpt = map.options?.skipMissingOptionalDimensions ?? true;
136
+ const normalize = map.options?.normalizeValues ?? true;
137
+ const dims = {};
138
+ for (const d of map.dimensions ?? []) {
139
+ const vals = (0, jsonpath_js_1.extract)(d.path, event);
140
+ const raw = vals[0];
141
+ if (raw === undefined) {
142
+ if (d.required) {
143
+ return {
144
+ increments: [],
145
+ warnings: [{ reason: `missing required dimension '${d.name}'` }],
146
+ skipped: true,
147
+ };
148
+ }
149
+ if (!skipMissingOpt) {
150
+ dims[d.name] = null;
151
+ }
152
+ continue;
153
+ }
154
+ dims[d.name] = (0, normalization_js_1.normalizeDimensionValue)(raw, normalize);
155
+ }
156
+ // ── Fanout ───────────────────────────────────────────────────────────────
157
+ const increments = [];
158
+ for (const subj of subjectFanout) {
159
+ for (const metricKey of metricFanout) {
160
+ increments.push({
161
+ scopeId,
162
+ counterId: map.counterId,
163
+ eventTime,
164
+ subjectType: subj.type,
165
+ subjectSourceKey: subj.sourceKey,
166
+ metricSourceKey: metricKey,
167
+ dimensions: { ...dims },
168
+ delta,
169
+ timeframes: map.timeframes,
170
+ eventId,
171
+ });
172
+ }
173
+ }
174
+ return { increments, warnings, skipped: false, eventId };
175
+ }
176
+ //# sourceMappingURL=extraction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extraction.js","sourceRoot":"","sources":["../../src/core/extraction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Mapping validation. Run once at engine startup so that misconfigurations
3
+ * are caught immediately instead of silently dropping events later.
4
+ */
5
+ import type { CounterMap } from "../types/index.js";
6
+ export declare function validateMap(map: CounterMap): void;
7
+ export declare function validateMaps(maps: CounterMap[]): void;
8
+ //# sourceMappingURL=mapping.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/core/mapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAgEjD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAYrD"}
@@ -0,0 +1,90 @@
1
+ "use strict";
2
+ /**
3
+ * Mapping validation. Run once at engine startup so that misconfigurations
4
+ * are caught immediately instead of silently dropping events later.
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.validateMap = validateMap;
8
+ exports.validateMaps = validateMaps;
9
+ const errors_js_1 = require("../utils/errors.js");
10
+ const jsonpath_js_1 = require("../utils/jsonpath.js");
11
+ const VALID_TIMEFRAMES = new Set(["day", "week", "month", "quarter", "year", "all"]);
12
+ function validateMap(map) {
13
+ if (!map.counterId || typeof map.counterId !== "string") {
14
+ throw new errors_js_1.MappingError("Map is missing counterId", { map });
15
+ }
16
+ if (!map.scope?.path) {
17
+ throw new errors_js_1.MappingError("Map is missing scope.path", { counterId: map.counterId });
18
+ }
19
+ (0, jsonpath_js_1.parsePath)(map.scope.path);
20
+ if (!map.eventTime?.path) {
21
+ throw new errors_js_1.MappingError("Map is missing eventTime.path", { counterId: map.counterId });
22
+ }
23
+ (0, jsonpath_js_1.parsePath)(map.eventTime.path);
24
+ if (!Array.isArray(map.subjects) || map.subjects.length === 0) {
25
+ throw new errors_js_1.MappingError("Map needs at least one subject", { counterId: map.counterId });
26
+ }
27
+ const subjectTypes = new Set();
28
+ for (const s of map.subjects) {
29
+ if (!s.type)
30
+ throw new errors_js_1.MappingError("Subject missing 'type'", { counterId: map.counterId });
31
+ if (subjectTypes.has(s.type)) {
32
+ throw new errors_js_1.MappingError(`Duplicate subject type '${s.type}'`, { counterId: map.counterId });
33
+ }
34
+ subjectTypes.add(s.type);
35
+ if (!s.path)
36
+ throw new errors_js_1.MappingError("Subject missing 'path'", { counterId: map.counterId });
37
+ (0, jsonpath_js_1.parsePath)(s.path);
38
+ }
39
+ if (!Array.isArray(map.metrics) || map.metrics.length === 0) {
40
+ throw new errors_js_1.MappingError("Map needs at least one metric", { counterId: map.counterId });
41
+ }
42
+ for (const m of map.metrics) {
43
+ if (!m.path)
44
+ throw new errors_js_1.MappingError("Metric missing 'path'", { counterId: map.counterId });
45
+ (0, jsonpath_js_1.parsePath)(m.path);
46
+ }
47
+ if (map.dimensions) {
48
+ const seen = new Set();
49
+ for (const d of map.dimensions) {
50
+ if (!d.name)
51
+ throw new errors_js_1.MappingError("Dimension missing 'name'", { counterId: map.counterId });
52
+ if (seen.has(d.name)) {
53
+ throw new errors_js_1.MappingError(`Duplicate dimension name '${d.name}'`, { counterId: map.counterId });
54
+ }
55
+ seen.add(d.name);
56
+ if (!d.path)
57
+ throw new errors_js_1.MappingError(`Dimension '${d.name}' missing 'path'`, { counterId: map.counterId });
58
+ (0, jsonpath_js_1.parsePath)(d.path);
59
+ }
60
+ }
61
+ if (!Array.isArray(map.timeframes) || map.timeframes.length === 0) {
62
+ throw new errors_js_1.MappingError("Map needs at least one timeframe", { counterId: map.counterId });
63
+ }
64
+ for (const t of map.timeframes) {
65
+ if (!VALID_TIMEFRAMES.has(t)) {
66
+ throw new errors_js_1.MappingError(`Invalid timeframe '${t}'`, { counterId: map.counterId });
67
+ }
68
+ }
69
+ if (map.delta?.path)
70
+ (0, jsonpath_js_1.parsePath)(map.delta.path);
71
+ if (map.idempotency?.enabled && !map.idempotency.eventIdPath) {
72
+ throw new errors_js_1.MappingError("idempotency.enabled requires eventIdPath", { counterId: map.counterId });
73
+ }
74
+ if (map.idempotency?.eventIdPath)
75
+ (0, jsonpath_js_1.parsePath)(map.idempotency.eventIdPath);
76
+ }
77
+ function validateMaps(maps) {
78
+ if (!Array.isArray(maps) || maps.length === 0) {
79
+ throw new errors_js_1.MappingError("At least one map is required");
80
+ }
81
+ const seen = new Set();
82
+ for (const m of maps) {
83
+ if (seen.has(m.counterId)) {
84
+ throw new errors_js_1.MappingError(`Duplicate counterId '${m.counterId}'`);
85
+ }
86
+ seen.add(m.counterId);
87
+ validateMap(m);
88
+ }
89
+ }
90
+ //# sourceMappingURL=mapping.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../src/core/mapping.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Value normalization. Two purposes:
3
+ *
4
+ * 1. Stable string keys for the dictionary (so " PCI " and "PCI" map to
5
+ * the same internal id).
6
+ * 2. Dimension value normalization for the cell identity hash.
7
+ *
8
+ * Conservative on purpose: trim + lowercase strings; pass numbers and booleans
9
+ * through; null is preserved. We do NOT coerce types — "1" stays "1", 1 stays 1.
10
+ */
11
+ import type { DimensionValue } from "../types/index.js";
12
+ export declare function normalizeKey(v: unknown): string;
13
+ export declare function normalizeDimensionValue(v: unknown, normalize: boolean): DimensionValue;
14
+ export declare function isPlainScalar(v: unknown): v is string | number | boolean;
15
+ //# sourceMappingURL=normalization.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../../src/core/normalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAO/C;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,cAAc,CAMtF;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,CAExE"}
@@ -0,0 +1,43 @@
1
+ "use strict";
2
+ /**
3
+ * Value normalization. Two purposes:
4
+ *
5
+ * 1. Stable string keys for the dictionary (so " PCI " and "PCI" map to
6
+ * the same internal id).
7
+ * 2. Dimension value normalization for the cell identity hash.
8
+ *
9
+ * Conservative on purpose: trim + lowercase strings; pass numbers and booleans
10
+ * through; null is preserved. We do NOT coerce types — "1" stays "1", 1 stays 1.
11
+ */
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.normalizeKey = normalizeKey;
14
+ exports.normalizeDimensionValue = normalizeDimensionValue;
15
+ exports.isPlainScalar = isPlainScalar;
16
+ function normalizeKey(v) {
17
+ if (v === null || v === undefined)
18
+ return "";
19
+ if (typeof v === "string")
20
+ return v.trim().toLowerCase();
21
+ if (typeof v === "number")
22
+ return String(v);
23
+ if (typeof v === "boolean")
24
+ return v ? "true" : "false";
25
+ if (typeof v === "object")
26
+ return JSON.stringify(v);
27
+ return String(v);
28
+ }
29
+ function normalizeDimensionValue(v, normalize) {
30
+ if (v === null || v === undefined)
31
+ return null;
32
+ if (typeof v === "boolean")
33
+ return v;
34
+ if (typeof v === "number")
35
+ return Number.isFinite(v) ? v : null;
36
+ if (typeof v === "string")
37
+ return normalize ? v.trim() : v;
38
+ return String(v);
39
+ }
40
+ function isPlainScalar(v) {
41
+ return typeof v === "string" || typeof v === "number" || typeof v === "boolean";
42
+ }
43
+ //# sourceMappingURL=normalization.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalization.js","sourceRoot":"","sources":["../../src/core/normalization.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAIH,oCAOC;AAED,0DAMC;AAED,sCAEC;AAnBD,SAAgB,YAAY,CAAC,CAAU;IACrC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACxD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,SAAgB,uBAAuB,CAAC,CAAU,EAAE,SAAkB;IACpE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,SAAgB,aAAa,CAAC,CAAU;IACtC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS,CAAC;AAClF,CAAC"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Timeframe bucketing.
3
+ *
4
+ * Each event time maps deterministically to a bucket key per timeframe type:
5
+ *
6
+ * day → "YYYY-MM-DD"
7
+ * week → "YYYY-Www" (ISO week)
8
+ * month → "YYYY-MM"
9
+ * quarter → "YYYY-QN"
10
+ * year → "YYYY"
11
+ * all → "all"
12
+ *
13
+ * Always UTC. The bucket comes from the event date, never the ingestion date,
14
+ * so late-arriving events go into the correct historical bucket.
15
+ */
16
+ import type { TimeframeType } from "../types/index.js";
17
+ export declare function bucketKey(type: TimeframeType, date: Date): string;
18
+ /**
19
+ * Bucket comparison: convert a bucket key to a sortable lexicographic value.
20
+ * Useful for range queries. ISO week keys (YYYY-Www) sort lexicographically,
21
+ * as do day/month/quarter/year keys.
22
+ */
23
+ export declare function bucketComparable(key: string): string;
24
+ /**
25
+ * Generate every bucket key in [from, to] inclusive for a given timeframe type.
26
+ * Returns an array of strings. Bounded — caller is responsible for not asking
27
+ * for absurd ranges.
28
+ */
29
+ export declare function bucketRange(type: TimeframeType, from: string, to: string): string[];
30
+ //# sourceMappingURL=timeframe.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"timeframe.d.ts","sourceRoot":"","sources":["../../src/core/timeframe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAejE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBnF"}
@@ -0,0 +1,151 @@
1
+ "use strict";
2
+ /**
3
+ * Timeframe bucketing.
4
+ *
5
+ * Each event time maps deterministically to a bucket key per timeframe type:
6
+ *
7
+ * day → "YYYY-MM-DD"
8
+ * week → "YYYY-Www" (ISO week)
9
+ * month → "YYYY-MM"
10
+ * quarter → "YYYY-QN"
11
+ * year → "YYYY"
12
+ * all → "all"
13
+ *
14
+ * Always UTC. The bucket comes from the event date, never the ingestion date,
15
+ * so late-arriving events go into the correct historical bucket.
16
+ */
17
+ Object.defineProperty(exports, "__esModule", { value: true });
18
+ exports.bucketKey = bucketKey;
19
+ exports.bucketComparable = bucketComparable;
20
+ exports.bucketRange = bucketRange;
21
+ function bucketKey(type, date) {
22
+ switch (type) {
23
+ case "day":
24
+ return formatDay(date);
25
+ case "week":
26
+ return formatIsoWeek(date);
27
+ case "month":
28
+ return formatMonth(date);
29
+ case "quarter":
30
+ return formatQuarter(date);
31
+ case "year":
32
+ return String(date.getUTCFullYear());
33
+ case "all":
34
+ return "all";
35
+ }
36
+ }
37
+ /**
38
+ * Bucket comparison: convert a bucket key to a sortable lexicographic value.
39
+ * Useful for range queries. ISO week keys (YYYY-Www) sort lexicographically,
40
+ * as do day/month/quarter/year keys.
41
+ */
42
+ function bucketComparable(key) {
43
+ return key;
44
+ }
45
+ /**
46
+ * Generate every bucket key in [from, to] inclusive for a given timeframe type.
47
+ * Returns an array of strings. Bounded — caller is responsible for not asking
48
+ * for absurd ranges.
49
+ */
50
+ function bucketRange(type, from, to) {
51
+ if (type === "all")
52
+ return ["all"];
53
+ const start = parseBucket(type, from);
54
+ const end = parseBucket(type, to);
55
+ if (start.getTime() > end.getTime())
56
+ return [];
57
+ const out = [];
58
+ let cursor = start;
59
+ // Hard safety cap.
60
+ const MAX = 10_000;
61
+ while (cursor.getTime() <= end.getTime() && out.length < MAX) {
62
+ out.push(bucketKey(type, cursor));
63
+ cursor = advance(type, cursor);
64
+ }
65
+ return out;
66
+ }
67
+ // ────────────────────────────────────────────────────────────────────────────
68
+ // Internals
69
+ // ────────────────────────────────────────────────────────────────────────────
70
+ function pad(n, w = 2) {
71
+ return String(n).padStart(w, "0");
72
+ }
73
+ function formatDay(d) {
74
+ return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
75
+ }
76
+ function formatMonth(d) {
77
+ return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}`;
78
+ }
79
+ function formatQuarter(d) {
80
+ const q = Math.floor(d.getUTCMonth() / 3) + 1;
81
+ return `${d.getUTCFullYear()}-Q${q}`;
82
+ }
83
+ /** ISO 8601 week. Week 1 is the week containing the first Thursday of the year. */
84
+ function formatIsoWeek(d) {
85
+ // Copy date and set to Thursday of the same ISO week.
86
+ const date = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
87
+ // Day-of-week with Monday=1 ... Sunday=7
88
+ const dayNum = (date.getUTCDay() + 6) % 7 + 1;
89
+ date.setUTCDate(date.getUTCDate() + 4 - dayNum);
90
+ const year = date.getUTCFullYear();
91
+ const yearStart = Date.UTC(year, 0, 1);
92
+ const week = Math.ceil(((date.getTime() - yearStart) / 86400000 + 1) / 7);
93
+ return `${year}-W${pad(week)}`;
94
+ }
95
+ function parseBucket(type, key) {
96
+ switch (type) {
97
+ case "day": {
98
+ const [y, m, d] = key.split("-").map(Number);
99
+ return new Date(Date.UTC(y, m - 1, d));
100
+ }
101
+ case "month": {
102
+ const [y, m] = key.split("-").map(Number);
103
+ return new Date(Date.UTC(y, m - 1, 1));
104
+ }
105
+ case "year":
106
+ return new Date(Date.UTC(Number(key), 0, 1));
107
+ case "quarter": {
108
+ const [yStr, qStr] = key.split("-Q");
109
+ const y = Number(yStr);
110
+ const q = Number(qStr);
111
+ return new Date(Date.UTC(y, (q - 1) * 3, 1));
112
+ }
113
+ case "week": {
114
+ const [yStr, wStr] = key.split("-W");
115
+ const y = Number(yStr);
116
+ const w = Number(wStr);
117
+ // Find the Monday of ISO week 1, then add (w-1) weeks.
118
+ const jan4 = new Date(Date.UTC(y, 0, 4));
119
+ const jan4Day = (jan4.getUTCDay() + 6) % 7 + 1; // Mon=1..Sun=7
120
+ const week1Mon = new Date(jan4);
121
+ week1Mon.setUTCDate(jan4.getUTCDate() - (jan4Day - 1));
122
+ week1Mon.setUTCDate(week1Mon.getUTCDate() + (w - 1) * 7);
123
+ return week1Mon;
124
+ }
125
+ case "all":
126
+ return new Date(0);
127
+ }
128
+ }
129
+ function advance(type, d) {
130
+ const r = new Date(d);
131
+ switch (type) {
132
+ case "day":
133
+ r.setUTCDate(r.getUTCDate() + 1);
134
+ return r;
135
+ case "week":
136
+ r.setUTCDate(r.getUTCDate() + 7);
137
+ return r;
138
+ case "month":
139
+ r.setUTCMonth(r.getUTCMonth() + 1);
140
+ return r;
141
+ case "quarter":
142
+ r.setUTCMonth(r.getUTCMonth() + 3);
143
+ return r;
144
+ case "year":
145
+ r.setUTCFullYear(r.getUTCFullYear() + 1);
146
+ return r;
147
+ case "all":
148
+ return new Date(d.getTime() + 1);
149
+ }
150
+ }
151
+ //# sourceMappingURL=timeframe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"timeframe.js","sourceRoot":"","sources":["../../src/core/timeframe.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * @x12i/countex
3
+ *
4
+ * Generic sparse counter matrices for JSON events.
5
+ *
6
+ * Public API:
7
+ *
8
+ * import { createCountex } from "@x12i/countex";
9
+ * import { MemoryDurable, MemoryCache } from "@x12i/countex/adapters/memory";
10
+ * import { MongoDurable } from "@x12i/countex/adapters/mongo";
11
+ * import { RedisCache } from "@x12i/countex/adapters/redis";
12
+ */
13
+ export { Countex, createCountex } from "./core/countex.js";
14
+ export { exportCells, rebuildCache } from "./backup/export.js";
15
+ export { CountexError, MappingError, ExtractionError, CardinalityLimitError, StorageError, } from "./utils/errors.js";
16
+ export type { CounterMap, SubjectMapping, MetricMapping, DimensionMapping, DeltaMapping, MappingOptions, CardinalityPolicy, IdempotencyPolicy, PathExpr, TimeframeType, Dimensions, DimensionValue, CounterCell, CellIdentity, PendingDelta, QuerySpec, QueryRow, QueryResult, TimeseriesPoint, TimeframeRange, SubjectFilter, DimensionFilter, GroupByField, ResultFormat, DurableStorage, CacheStorage, DictionaryKind, DictionaryLookup, CountexConfig, FlushPolicy, CachePolicy, CountexLogger, CountexEvents, JsonValue, JsonObject, } from "./types/index.js";
17
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAEV,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,UAAU,EACV,cAAc,EAGd,WAAW,EACX,YAAY,EACZ,YAAY,EAGZ,SAAS,EACT,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EAGZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,gBAAgB,EAGhB,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EAGb,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,28 @@
1
+ "use strict";
2
+ /**
3
+ * @x12i/countex
4
+ *
5
+ * Generic sparse counter matrices for JSON events.
6
+ *
7
+ * Public API:
8
+ *
9
+ * import { createCountex } from "@x12i/countex";
10
+ * import { MemoryDurable, MemoryCache } from "@x12i/countex/adapters/memory";
11
+ * import { MongoDurable } from "@x12i/countex/adapters/mongo";
12
+ * import { RedisCache } from "@x12i/countex/adapters/redis";
13
+ */
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.StorageError = exports.CardinalityLimitError = exports.ExtractionError = exports.MappingError = exports.CountexError = exports.rebuildCache = exports.exportCells = exports.createCountex = exports.Countex = void 0;
16
+ var countex_js_1 = require("./core/countex.js");
17
+ Object.defineProperty(exports, "Countex", { enumerable: true, get: function () { return countex_js_1.Countex; } });
18
+ Object.defineProperty(exports, "createCountex", { enumerable: true, get: function () { return countex_js_1.createCountex; } });
19
+ var export_js_1 = require("./backup/export.js");
20
+ Object.defineProperty(exports, "exportCells", { enumerable: true, get: function () { return export_js_1.exportCells; } });
21
+ Object.defineProperty(exports, "rebuildCache", { enumerable: true, get: function () { return export_js_1.rebuildCache; } });
22
+ var errors_js_1 = require("./utils/errors.js");
23
+ Object.defineProperty(exports, "CountexError", { enumerable: true, get: function () { return errors_js_1.CountexError; } });
24
+ Object.defineProperty(exports, "MappingError", { enumerable: true, get: function () { return errors_js_1.MappingError; } });
25
+ Object.defineProperty(exports, "ExtractionError", { enumerable: true, get: function () { return errors_js_1.ExtractionError; } });
26
+ Object.defineProperty(exports, "CardinalityLimitError", { enumerable: true, get: function () { return errors_js_1.CardinalityLimitError; } });
27
+ Object.defineProperty(exports, "StorageError", { enumerable: true, get: function () { return errors_js_1.StorageError; } });
28
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,gDAA2D;AAAlD,qGAAA,OAAO,OAAA;AAAE,2GAAA,aAAa,OAAA;AAC/B,gDAA+D;AAAtD,wGAAA,WAAW,OAAA;AAAE,yGAAA,YAAY,OAAA;AAClC,+CAM2B;AALzB,yGAAA,YAAY,OAAA;AACZ,yGAAA,YAAY,OAAA;AACZ,4GAAA,eAAe,OAAA;AACf,kHAAA,qBAAqB,OAAA;AACrB,yGAAA,YAAY,OAAA"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Query result formatting.
3
+ *
4
+ * The query layer fetches a flat list of cells, then this module reshapes
5
+ * them according to the requested groupBy / format.
6
+ */
7
+ import type { CounterCell, QueryResult, QuerySpec } from "../types/index.js";
8
+ export declare function formatResult(cells: CounterCell[], spec: QuerySpec, source: "cache" | "durable" | "merged", partial?: boolean): QueryResult;
9
+ //# sourceMappingURL=formatter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/query/formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EAEX,WAAW,EAEX,SAAS,EAEV,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,EACtC,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CAwCb"}