@x12i/countex 1.8.5 → 1.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +867 -860
- package/dist/cli.js +6 -6
- package/dist/core/countex.d.ts +61 -1
- package/dist/core/countex.d.ts.map +1 -1
- package/dist/core/countex.js +241 -0
- package/dist/core/countex.js.map +1 -1
- package/dist/core/managed.d.ts +200 -0
- package/dist/core/managed.d.ts.map +1 -0
- package/dist/core/managed.js +431 -0
- package/dist/core/managed.js.map +1 -0
- package/dist/core/timeframe.d.ts +5 -0
- package/dist/core/timeframe.d.ts.map +1 -1
- package/dist/core/timeframe.js +36 -0
- package/dist/core/timeframe.js.map +1 -1
- package/dist/index.d.ts +6 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/insights/advisors/resource-advisor.d.ts.map +1 -1
- package/dist/insights/advisors/resource-advisor.js +5 -1
- package/dist/insights/advisors/resource-advisor.js.map +1 -1
- package/dist/insights/types.d.ts +4 -0
- package/dist/insights/types.d.ts.map +1 -1
- package/dist/storage/managed-memory.d.ts +33 -0
- package/dist/storage/managed-memory.d.ts.map +1 -0
- package/dist/storage/managed-memory.js +211 -0
- package/dist/storage/managed-memory.js.map +1 -0
- package/dist/storage/memory.d.ts +7 -4
- package/dist/storage/memory.d.ts.map +1 -1
- package/dist/storage/memory.js.map +1 -1
- package/dist/storage/postgres.d.ts +123 -0
- package/dist/storage/postgres.d.ts.map +1 -0
- package/dist/storage/postgres.js +1325 -0
- package/dist/storage/postgres.js.map +1 -0
- package/dist/storage/redis.d.ts +6 -0
- package/dist/storage/redis.d.ts.map +1 -1
- package/dist/storage/redis.js +21 -0
- package/dist/storage/redis.js.map +1 -1
- package/dist/types/index.d.ts +63 -5
- package/dist/types/index.d.ts.map +1 -1
- package/dist/utils/errors.d.ts +12 -0
- package/dist/utils/errors.d.ts.map +1 -1
- package/dist/utils/errors.js +22 -1
- package/dist/utils/errors.js.map +1 -1
- package/docs/DEPLOYMENT.md +399 -375
- package/docs/END_TO_END_EXAMPLE.md +316 -316
- package/docs/INSIGHTS.md +59 -59
- package/docs/INSIGHTS_ANOMALY_DETECTION.md +33 -33
- package/docs/INSIGHTS_LLM_COST_AND_TOKENS.md +26 -26
- package/docs/INSIGHTS_RESOURCE_ADVISOR.md +33 -31
- package/docs/countex_gap_analysis_complete_checklist.md +1340 -1340
- package/docs/guides/README.md +37 -34
- package/docs/guides/adapter-memory.md +60 -60
- package/docs/guides/adapter-mongo.md +64 -62
- package/docs/guides/adapter-postgres.md +92 -0
- package/docs/guides/adapter-redis.md +89 -89
- package/docs/guides/backup-export.md +135 -135
- package/docs/guides/cardinality.md +50 -50
- package/docs/guides/cli.md +53 -53
- package/docs/guides/client-events.md +65 -65
- package/docs/guides/counter-maps.md +160 -160
- package/docs/guides/idempotency.md +39 -39
- package/docs/guides/ingestion-and-flush.md +67 -67
- package/docs/guides/insights-advisors-and-optimization.md +39 -39
- package/docs/guides/insights-anomalies-and-rules.md +48 -48
- package/docs/guides/insights-comparison-and-trends.md +47 -47
- package/docs/guides/insights-forecasting-and-budget.md +61 -61
- package/docs/guides/insights-overview.md +82 -82
- package/docs/guides/insights-ranking.md +81 -81
- package/docs/guides/managed-commit.md +119 -0
- package/docs/guides/measures.md +72 -71
- package/docs/guides/migrating-mongo-to-postgres.md +127 -0
- package/docs/guides/preview.md +92 -92
- package/docs/guides/querying.md +178 -178
- package/docs/guides/simulation-profiles.md +33 -33
- package/docs/guides/simulation-resource-estimation.md +31 -30
- package/docs/guides/simulation.md +36 -36
- package/docs/guides/timeframes-and-bucketing.md +55 -55
- package/docs/internals/README.md +21 -21
- package/docs/internals/internal-architecture-overview.md +65 -65
- package/docs/internals/internal-backup-stream.md +23 -23
- package/docs/internals/internal-buffer-merge-and-flush.md +51 -51
- package/docs/internals/internal-cardinality.md +30 -30
- package/docs/internals/internal-dimension-hash.md +34 -34
- package/docs/internals/internal-idempotency.md +36 -36
- package/docs/internals/internal-ingest-pipeline.md +52 -52
- package/docs/internals/internal-insights-layer.md +36 -36
- package/docs/internals/internal-mapping-validation-and-extraction.md +59 -59
- package/docs/internals/internal-measures-and-scales.md +35 -35
- package/docs/internals/internal-query-path.md +46 -46
- package/docs/internals/internal-storage-memory.md +13 -13
- package/docs/internals/internal-storage-mongo.md +44 -44
- package/docs/internals/internal-storage-postgres.md +32 -0
- package/docs/internals/internal-storage-redis.md +63 -63
- package/docs/internals/internal-timeframe-bucketing.md +33 -33
- package/docs/use-cases/README.md +56 -56
- package/docs/use-cases/audit-security-log-counts.md +550 -550
- package/docs/use-cases/llm-cost-and-token-metering.md +255 -255
- package/docs/use-cases/multi-tenant-isolation.md +203 -203
- package/docs/use-cases/ops-dashboard-daily-rollups.md +255 -255
- package/docs/use-cases/processing-workflow-activity.md +165 -165
- package/docs/use-cases/product-feature-usage.md +240 -240
- package/docs/use-cases/webhook-idempotent-ingestion.md +188 -188
- package/package.json +190 -170
package/package.json
CHANGED
|
@@ -1,170 +1,190 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@x12i/countex",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "Generic sparse counter matrices for JSON events. Dynamic counting, aggregation, and retrieval from mapped JSON inputs.",
|
|
5
|
-
"repository": {
|
|
6
|
-
"type": "git",
|
|
7
|
-
"url": "git+https://github.com/x12i/countex-mono-repo.git",
|
|
8
|
-
"directory": "packages/countex"
|
|
9
|
-
},
|
|
10
|
-
"bugs": {
|
|
11
|
-
"url": "https://github.com/x12i/countex/issues"
|
|
12
|
-
},
|
|
13
|
-
"homepage": "https://github.com/x12i/countex#readme",
|
|
14
|
-
"publishConfig": {
|
|
15
|
-
"access": "public",
|
|
16
|
-
"registry": "https://registry.npmjs.org/"
|
|
17
|
-
},
|
|
18
|
-
"keywords": [
|
|
19
|
-
"counters",
|
|
20
|
-
"aggregation",
|
|
21
|
-
"analytics",
|
|
22
|
-
"metrics",
|
|
23
|
-
"sparse-matrix",
|
|
24
|
-
"mongo",
|
|
25
|
-
"
|
|
26
|
-
"
|
|
27
|
-
"
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
"
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
"
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
"
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
"
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
"
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
"
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
"
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
"
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
"
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
"
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
"./
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
"./
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
"./docs/
|
|
100
|
-
"./docs/
|
|
101
|
-
"./docs/guides
|
|
102
|
-
"./docs/guides/
|
|
103
|
-
"./docs/guides/
|
|
104
|
-
"./docs/guides/
|
|
105
|
-
"./docs/guides/
|
|
106
|
-
"./docs/guides/
|
|
107
|
-
"./docs/guides/
|
|
108
|
-
"./docs/guides/
|
|
109
|
-
"./docs/guides/
|
|
110
|
-
"./docs/guides/
|
|
111
|
-
"./docs/guides/
|
|
112
|
-
"./docs/
|
|
113
|
-
"./docs/
|
|
114
|
-
"./docs/
|
|
115
|
-
"./docs/
|
|
116
|
-
"./docs/
|
|
117
|
-
"./docs/
|
|
118
|
-
"./docs/
|
|
119
|
-
"./docs/
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
"
|
|
123
|
-
"docs",
|
|
124
|
-
"
|
|
125
|
-
"
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
"
|
|
129
|
-
"
|
|
130
|
-
"
|
|
131
|
-
"
|
|
132
|
-
"
|
|
133
|
-
"
|
|
134
|
-
"
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
"
|
|
138
|
-
"
|
|
139
|
-
"
|
|
140
|
-
"
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
"
|
|
144
|
-
"
|
|
145
|
-
"
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
"
|
|
149
|
-
"
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
"
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
"
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
"
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
"
|
|
164
|
-
"
|
|
165
|
-
"
|
|
166
|
-
},
|
|
167
|
-
"
|
|
168
|
-
"
|
|
169
|
-
|
|
170
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "@x12i/countex",
|
|
3
|
+
"version": "1.10.0",
|
|
4
|
+
"description": "Generic sparse counter matrices for JSON events. Dynamic counting, aggregation, and retrieval from mapped JSON inputs.",
|
|
5
|
+
"repository": {
|
|
6
|
+
"type": "git",
|
|
7
|
+
"url": "git+https://github.com/x12i/countex-mono-repo.git",
|
|
8
|
+
"directory": "packages/countex"
|
|
9
|
+
},
|
|
10
|
+
"bugs": {
|
|
11
|
+
"url": "https://github.com/x12i/countex/issues"
|
|
12
|
+
},
|
|
13
|
+
"homepage": "https://github.com/x12i/countex#readme",
|
|
14
|
+
"publishConfig": {
|
|
15
|
+
"access": "public",
|
|
16
|
+
"registry": "https://registry.npmjs.org/"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"counters",
|
|
20
|
+
"aggregation",
|
|
21
|
+
"analytics",
|
|
22
|
+
"metrics",
|
|
23
|
+
"sparse-matrix",
|
|
24
|
+
"mongo",
|
|
25
|
+
"postgres",
|
|
26
|
+
"postgresql",
|
|
27
|
+
"redis",
|
|
28
|
+
"events",
|
|
29
|
+
"timeseries"
|
|
30
|
+
],
|
|
31
|
+
"license": "MIT",
|
|
32
|
+
"author": "x12i",
|
|
33
|
+
"main": "dist/index.js",
|
|
34
|
+
"types": "dist/index.d.ts",
|
|
35
|
+
"bin": {
|
|
36
|
+
"countex": "./dist/cli.js"
|
|
37
|
+
},
|
|
38
|
+
"exports": {
|
|
39
|
+
".": {
|
|
40
|
+
"types": "./dist/index.d.ts",
|
|
41
|
+
"import": "./dist/index.js",
|
|
42
|
+
"require": "./dist/index.js"
|
|
43
|
+
},
|
|
44
|
+
"./adapters/mongo": {
|
|
45
|
+
"types": "./dist/storage/mongo.d.ts",
|
|
46
|
+
"import": "./dist/storage/mongo.js",
|
|
47
|
+
"require": "./dist/storage/mongo.js"
|
|
48
|
+
},
|
|
49
|
+
"./adapters/postgres": {
|
|
50
|
+
"types": "./dist/storage/postgres.d.ts",
|
|
51
|
+
"import": "./dist/storage/postgres.js",
|
|
52
|
+
"require": "./dist/storage/postgres.js"
|
|
53
|
+
},
|
|
54
|
+
"./adapters/managed-memory": {
|
|
55
|
+
"types": "./dist/storage/managed-memory.d.ts",
|
|
56
|
+
"import": "./dist/storage/managed-memory.js",
|
|
57
|
+
"require": "./dist/storage/managed-memory.js"
|
|
58
|
+
},
|
|
59
|
+
"./adapters/redis": {
|
|
60
|
+
"types": "./dist/storage/redis.d.ts",
|
|
61
|
+
"import": "./dist/storage/redis.js",
|
|
62
|
+
"require": "./dist/storage/redis.js"
|
|
63
|
+
},
|
|
64
|
+
"./adapters/memory": {
|
|
65
|
+
"types": "./dist/storage/memory.d.ts",
|
|
66
|
+
"import": "./dist/storage/memory.js",
|
|
67
|
+
"require": "./dist/storage/memory.js"
|
|
68
|
+
},
|
|
69
|
+
"./adapters/durable-cache": {
|
|
70
|
+
"types": "./dist/storage/durable-cache.d.ts",
|
|
71
|
+
"import": "./dist/storage/durable-cache.js",
|
|
72
|
+
"require": "./dist/storage/durable-cache.js"
|
|
73
|
+
},
|
|
74
|
+
"./insights": {
|
|
75
|
+
"types": "./dist/insights/index.d.ts",
|
|
76
|
+
"import": "./dist/insights/index.js",
|
|
77
|
+
"require": "./dist/insights/index.js"
|
|
78
|
+
},
|
|
79
|
+
"./insights/anomaly": {
|
|
80
|
+
"types": "./dist/insights/anomaly-subpath.d.ts",
|
|
81
|
+
"import": "./dist/insights/anomaly-subpath.js",
|
|
82
|
+
"require": "./dist/insights/anomaly-subpath.js"
|
|
83
|
+
},
|
|
84
|
+
"./insights/llm": {
|
|
85
|
+
"types": "./dist/insights/llm-subpath.d.ts",
|
|
86
|
+
"import": "./dist/insights/llm-subpath.js",
|
|
87
|
+
"require": "./dist/insights/llm-subpath.js"
|
|
88
|
+
},
|
|
89
|
+
"./insights/advisors": {
|
|
90
|
+
"types": "./dist/insights/advisors-subpath.d.ts",
|
|
91
|
+
"import": "./dist/insights/advisors-subpath.js",
|
|
92
|
+
"require": "./dist/insights/advisors-subpath.js"
|
|
93
|
+
},
|
|
94
|
+
"./simulation": {
|
|
95
|
+
"types": "./dist/simulation/index.d.ts",
|
|
96
|
+
"import": "./dist/simulation/index.js",
|
|
97
|
+
"require": "./dist/simulation/index.js"
|
|
98
|
+
},
|
|
99
|
+
"./docs/deployment": "./docs/DEPLOYMENT.md",
|
|
100
|
+
"./docs/end-to-end-example": "./docs/END_TO_END_EXAMPLE.md",
|
|
101
|
+
"./docs/guides": "./docs/guides/README.md",
|
|
102
|
+
"./docs/guides/counter-maps": "./docs/guides/counter-maps.md",
|
|
103
|
+
"./docs/guides/ingestion-and-flush": "./docs/guides/ingestion-and-flush.md",
|
|
104
|
+
"./docs/guides/timeframes-and-bucketing": "./docs/guides/timeframes-and-bucketing.md",
|
|
105
|
+
"./docs/guides/measures": "./docs/guides/measures.md",
|
|
106
|
+
"./docs/guides/querying": "./docs/guides/querying.md",
|
|
107
|
+
"./docs/guides/adapter-memory": "./docs/guides/adapter-memory.md",
|
|
108
|
+
"./docs/guides/adapter-mongo": "./docs/guides/adapter-mongo.md",
|
|
109
|
+
"./docs/guides/adapter-postgres": "./docs/guides/adapter-postgres.md",
|
|
110
|
+
"./docs/guides/migrating-mongo-to-postgres": "./docs/guides/migrating-mongo-to-postgres.md",
|
|
111
|
+
"./docs/guides/adapter-redis": "./docs/guides/adapter-redis.md",
|
|
112
|
+
"./docs/guides/cardinality": "./docs/guides/cardinality.md",
|
|
113
|
+
"./docs/guides/idempotency": "./docs/guides/idempotency.md",
|
|
114
|
+
"./docs/guides/managed-commit": "./docs/guides/managed-commit.md",
|
|
115
|
+
"./docs/guides/backup-export": "./docs/guides/backup-export.md",
|
|
116
|
+
"./docs/guides/client-events": "./docs/guides/client-events.md",
|
|
117
|
+
"./docs/guides/insights-overview": "./docs/guides/insights-overview.md",
|
|
118
|
+
"./docs/guides/insights-ranking": "./docs/guides/insights-ranking.md",
|
|
119
|
+
"./docs/guides/insights-comparison-and-trends": "./docs/guides/insights-comparison-and-trends.md",
|
|
120
|
+
"./docs/guides/insights-anomalies-and-rules": "./docs/guides/insights-anomalies-and-rules.md",
|
|
121
|
+
"./docs/guides/insights-forecasting-and-budget": "./docs/guides/insights-forecasting-and-budget.md",
|
|
122
|
+
"./docs/guides/insights-advisors-and-optimization": "./docs/guides/insights-advisors-and-optimization.md",
|
|
123
|
+
"./docs/guides/cli": "./docs/guides/cli.md",
|
|
124
|
+
"./docs/guides/simulation": "./docs/guides/simulation.md",
|
|
125
|
+
"./docs/guides/simulation-profiles": "./docs/guides/simulation-profiles.md",
|
|
126
|
+
"./docs/guides/simulation-resource-estimation": "./docs/guides/simulation-resource-estimation.md",
|
|
127
|
+
"./docs/use-cases": "./docs/use-cases/README.md",
|
|
128
|
+
"./docs/use-cases/audit-security-log-counts": "./docs/use-cases/audit-security-log-counts.md",
|
|
129
|
+
"./docs/use-cases/product-feature-usage": "./docs/use-cases/product-feature-usage.md",
|
|
130
|
+
"./docs/use-cases/llm-cost-and-token-metering": "./docs/use-cases/llm-cost-and-token-metering.md",
|
|
131
|
+
"./docs/use-cases/multi-tenant-isolation": "./docs/use-cases/multi-tenant-isolation.md",
|
|
132
|
+
"./docs/use-cases/webhook-idempotent-ingestion": "./docs/use-cases/webhook-idempotent-ingestion.md",
|
|
133
|
+
"./docs/use-cases/ops-dashboard-daily-rollups": "./docs/use-cases/ops-dashboard-daily-rollups.md",
|
|
134
|
+
"./docs/use-cases/processing-workflow-activity": "./docs/use-cases/processing-workflow-activity.md"
|
|
135
|
+
},
|
|
136
|
+
"files": [
|
|
137
|
+
"dist",
|
|
138
|
+
"docs",
|
|
139
|
+
"README.md",
|
|
140
|
+
"LICENSE"
|
|
141
|
+
],
|
|
142
|
+
"scripts": {
|
|
143
|
+
"build": "tsc",
|
|
144
|
+
"clean": "node scripts/clean-dist.mjs",
|
|
145
|
+
"test": "node --test --import=tsx tests/unit/*.test.ts",
|
|
146
|
+
"docker:up": "docker compose -f docker/docker-compose.integration.yml up -d mongo postgres redis minio minio-setup",
|
|
147
|
+
"docker:down": "docker compose -f docker/docker-compose.integration.yml down",
|
|
148
|
+
"docker:reset": "docker compose -f docker/docker-compose.integration.yml down -v && docker compose -f docker/docker-compose.integration.yml up -d mongo postgres redis minio minio-setup",
|
|
149
|
+
"test:integration": "tsx tests/integration/run.ts",
|
|
150
|
+
"test:integration:exec": "tsx tests/integration/exec-integration-tests.ts",
|
|
151
|
+
"integration:up": "tsx scripts/integration-up.ts",
|
|
152
|
+
"integration:down": "tsx scripts/integration-down.ts",
|
|
153
|
+
"integration:reset": "tsx scripts/integration-reset.ts",
|
|
154
|
+
"integration:run": "tsx scripts/integration-run.ts",
|
|
155
|
+
"integration:report": "tsx scripts/integration-report.ts",
|
|
156
|
+
"test:integration:docker": "docker compose -f docker/docker-compose.integration.yml run --rm test-runner",
|
|
157
|
+
"test:e2e": "tsx scripts/integration-e2e.ts",
|
|
158
|
+
"simulation:docker": "bash scripts/simulation-with-docker.sh",
|
|
159
|
+
"simulation:docker:full": "bash scripts/simulation-with-docker.sh --full",
|
|
160
|
+
"prepublishOnly": "npm run clean && tsc"
|
|
161
|
+
},
|
|
162
|
+
"peerDependencies": {
|
|
163
|
+
"ioredis": "^5.10.1",
|
|
164
|
+
"mongodb": "^7.2.0",
|
|
165
|
+
"pg": "^8.13.1"
|
|
166
|
+
},
|
|
167
|
+
"peerDependenciesMeta": {
|
|
168
|
+
"mongodb": {
|
|
169
|
+
"optional": true
|
|
170
|
+
},
|
|
171
|
+
"ioredis": {
|
|
172
|
+
"optional": true
|
|
173
|
+
},
|
|
174
|
+
"pg": {
|
|
175
|
+
"optional": true
|
|
176
|
+
}
|
|
177
|
+
},
|
|
178
|
+
"devDependencies": {
|
|
179
|
+
"@aws-sdk/client-s3": "^3.787.0",
|
|
180
|
+
"@types/node": "^20.19.40",
|
|
181
|
+
"ioredis": "^5.10.1",
|
|
182
|
+
"mongodb": "^7.2.0",
|
|
183
|
+
"pg": "^8.13.1",
|
|
184
|
+
"tsx": "^4.21.0",
|
|
185
|
+
"typescript": "^5.9.3"
|
|
186
|
+
},
|
|
187
|
+
"engines": {
|
|
188
|
+
"node": ">=18"
|
|
189
|
+
}
|
|
190
|
+
}
|