@scoutflo/alert-correlation 0.1.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 (86) hide show
  1. package/README.md +34 -0
  2. package/dist/src/contracts/alertRef.d.ts +21 -0
  3. package/dist/src/contracts/alertRef.js +12 -0
  4. package/dist/src/contracts/alertRef.js.map +1 -0
  5. package/dist/src/contracts/context.d.ts +37 -0
  6. package/dist/src/contracts/context.js +3 -0
  7. package/dist/src/contracts/context.js.map +1 -0
  8. package/dist/src/contracts/decision.d.ts +29 -0
  9. package/dist/src/contracts/decision.js +3 -0
  10. package/dist/src/contracts/decision.js.map +1 -0
  11. package/dist/src/contracts/facts.d.ts +32 -0
  12. package/dist/src/contracts/facts.js +3 -0
  13. package/dist/src/contracts/facts.js.map +1 -0
  14. package/dist/src/contracts/index.d.ts +5 -0
  15. package/dist/src/contracts/index.js +22 -0
  16. package/dist/src/contracts/index.js.map +1 -0
  17. package/dist/src/contracts/topology.d.ts +38 -0
  18. package/dist/src/contracts/topology.js +3 -0
  19. package/dist/src/contracts/topology.js.map +1 -0
  20. package/dist/src/decision/decideTarget.d.ts +3 -0
  21. package/dist/src/decision/decideTarget.js +50 -0
  22. package/dist/src/decision/decideTarget.js.map +1 -0
  23. package/dist/src/decision/reasonCodes.d.ts +10 -0
  24. package/dist/src/decision/reasonCodes.js +13 -0
  25. package/dist/src/decision/reasonCodes.js.map +1 -0
  26. package/dist/src/extractors/genericExtractor.d.ts +23 -0
  27. package/dist/src/extractors/genericExtractor.js +162 -0
  28. package/dist/src/extractors/genericExtractor.js.map +1 -0
  29. package/dist/src/extractors/prometheusExtractor.d.ts +4 -0
  30. package/dist/src/extractors/prometheusExtractor.js +114 -0
  31. package/dist/src/extractors/prometheusExtractor.js.map +1 -0
  32. package/dist/src/extractors/registry.d.ts +4 -0
  33. package/dist/src/extractors/registry.js +23 -0
  34. package/dist/src/extractors/registry.js.map +1 -0
  35. package/dist/src/extractors/sentryExtractor.d.ts +2 -0
  36. package/dist/src/extractors/sentryExtractor.js +114 -0
  37. package/dist/src/extractors/sentryExtractor.js.map +1 -0
  38. package/dist/src/extractors/types.d.ts +12 -0
  39. package/dist/src/extractors/types.js +3 -0
  40. package/dist/src/extractors/types.js.map +1 -0
  41. package/dist/src/extractors/victoriaMetricsExtractor.d.ts +2 -0
  42. package/dist/src/extractors/victoriaMetricsExtractor.js +12 -0
  43. package/dist/src/extractors/victoriaMetricsExtractor.js.map +1 -0
  44. package/dist/src/index.d.ts +18 -0
  45. package/dist/src/index.js +36 -0
  46. package/dist/src/index.js.map +1 -0
  47. package/dist/src/matchers/providerRelationshipMatcher.d.ts +4 -0
  48. package/dist/src/matchers/providerRelationshipMatcher.js +111 -0
  49. package/dist/src/matchers/providerRelationshipMatcher.js.map +1 -0
  50. package/dist/src/matchers/types.d.ts +10 -0
  51. package/dist/src/matchers/types.js +3 -0
  52. package/dist/src/matchers/types.js.map +1 -0
  53. package/dist/src/resolveAlertCorrelation.d.ts +13 -0
  54. package/dist/src/resolveAlertCorrelation.js +17 -0
  55. package/dist/src/resolveAlertCorrelation.js.map +1 -0
  56. package/dist/src/time/normalizeAlertTime.d.ts +9 -0
  57. package/dist/src/time/normalizeAlertTime.js +25 -0
  58. package/dist/src/time/normalizeAlertTime.js.map +1 -0
  59. package/dist/test/contracts.test.d.ts +1 -0
  60. package/dist/test/contracts.test.js +39 -0
  61. package/dist/test/contracts.test.js.map +1 -0
  62. package/dist/test/decision.test.d.ts +1 -0
  63. package/dist/test/decision.test.js +50 -0
  64. package/dist/test/decision.test.js.map +1 -0
  65. package/dist/test/generic-extractor.test.d.ts +1 -0
  66. package/dist/test/generic-extractor.test.js +28 -0
  67. package/dist/test/generic-extractor.test.js.map +1 -0
  68. package/dist/test/prometheus-extractor.test.d.ts +1 -0
  69. package/dist/test/prometheus-extractor.test.js +29 -0
  70. package/dist/test/prometheus-extractor.test.js.map +1 -0
  71. package/dist/test/resolve-alert-correlation.test.d.ts +1 -0
  72. package/dist/test/resolve-alert-correlation.test.js +38 -0
  73. package/dist/test/resolve-alert-correlation.test.js.map +1 -0
  74. package/dist/test/sentry-extractor.test.d.ts +1 -0
  75. package/dist/test/sentry-extractor.test.js +30 -0
  76. package/dist/test/sentry-extractor.test.js.map +1 -0
  77. package/dist/test/smoke.test.d.ts +1 -0
  78. package/dist/test/smoke.test.js +12 -0
  79. package/dist/test/smoke.test.js.map +1 -0
  80. package/dist/test/time.test.d.ts +1 -0
  81. package/dist/test/time.test.js +30 -0
  82. package/dist/test/time.test.js.map +1 -0
  83. package/dist/test/victoriametrics-extractor.test.d.ts +1 -0
  84. package/dist/test/victoriametrics-extractor.test.js +27 -0
  85. package/dist/test/victoriametrics-extractor.test.js.map +1 -0
  86. package/package.json +32 -0
@@ -0,0 +1,39 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('alertRefSchema requires timestamp', () => {
10
+ const parsed = src_1.alertRefSchema.safeParse({
11
+ integrationId: 'int-prom',
12
+ provider: 'prometheus',
13
+ alertKey: 'prometheus:abc',
14
+ selectedAt: '2026-06-14T10:00:00.000Z',
15
+ });
16
+ strict_1.default.equal(parsed.success, false);
17
+ });
18
+ (0, node_test_1.default)('AlertCorrelationDecision supports degraded context', () => {
19
+ const decision = {
20
+ status: 'degraded',
21
+ target: null,
22
+ candidates: [],
23
+ evidence: [],
24
+ confidence: 0,
25
+ reasonCodes: ['source_resource_missing'],
26
+ };
27
+ strict_1.default.equal(decision.status, 'degraded');
28
+ });
29
+ (0, node_test_1.default)('AlertRef type includes selectedAt separately from timestamp', () => {
30
+ const ref = {
31
+ integrationId: 'int-sentry',
32
+ provider: 'sentry',
33
+ alertKey: 'sentry:issue-1',
34
+ timestamp: '2026-06-14T09:55:00.000Z',
35
+ selectedAt: '2026-06-14T10:00:00.000Z',
36
+ };
37
+ strict_1.default.notEqual(ref.timestamp, ref.selectedAt);
38
+ });
39
+ //# sourceMappingURL=contracts.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.test.js","sourceRoot":"","sources":["../../test/contracts.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAIgB;AAEhB,IAAA,mBAAI,EAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,MAAM,MAAM,GAAG,oBAAc,CAAC,SAAS,CAAC;QACtC,aAAa,EAAE,UAAU;QACzB,QAAQ,EAAE,YAAY;QACtB,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,0BAA0B;KACvC,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,QAAQ,GAA6B;QACzC,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC,yBAAyB,CAAC;KACzC,CAAC;IAEF,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,GAAG,GAAa;QACpB,aAAa,EAAE,YAAY;QAC3B,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE,0BAA0B;QACrC,UAAU,EAAE,0BAA0B;KACvC,CAAC;IAEF,gBAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,50 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('resolves single topology-scoped high confidence service', () => {
10
+ const decision = (0, src_1.decideTarget)([
11
+ {
12
+ target: { type: 'service', id: 'svc-checkout' },
13
+ name: 'checkout',
14
+ confidence: 10,
15
+ evidence: [
16
+ {
17
+ kind: 'relationship_attribute',
18
+ factKey: 'service',
19
+ factValue: 'checkout',
20
+ relationshipId: 'rel-1',
21
+ reason: 'serviceLabel exact match',
22
+ },
23
+ ],
24
+ reasonCodes: ['relationship_attribute_match'],
25
+ },
26
+ ]);
27
+ strict_1.default.equal(decision.status, 'resolved');
28
+ strict_1.default.deepEqual(decision.target, { type: 'service', id: 'svc-checkout' });
29
+ });
30
+ (0, node_test_1.default)('keeps multiple high confidence services ambiguous', () => {
31
+ const decision = (0, src_1.decideTarget)([
32
+ { target: { type: 'service', id: 'svc-a' }, confidence: 9, evidence: [], reasonCodes: [] },
33
+ { target: { type: 'service', id: 'svc-b' }, confidence: 9, evidence: [], reasonCodes: [] },
34
+ ]);
35
+ strict_1.default.equal(decision.status, 'ambiguous');
36
+ strict_1.default.equal(decision.target, null);
37
+ });
38
+ (0, node_test_1.default)('does not deterministically resolve weak raw-name evidence', () => {
39
+ const decision = (0, src_1.decideTarget)([
40
+ {
41
+ target: { type: 'service', id: 'svc-checkout' },
42
+ confidence: 5,
43
+ evidence: [{ kind: 'raw_alert_field', factKey: 'service', factValue: 'checkout', reason: 'raw label only' }],
44
+ reasonCodes: ['raw_label_candidate'],
45
+ },
46
+ ]);
47
+ strict_1.default.equal(decision.status, 'ambiguous');
48
+ strict_1.default.equal(decision.target, null);
49
+ });
50
+ //# sourceMappingURL=decision.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decision.test.js","sourceRoot":"","sources":["../../test/decision.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAAsC;AAEtC,IAAA,mBAAI,EAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,QAAQ,GAAG,IAAA,kBAAY,EAAC;QAC5B;YACE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE;YAC/C,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,UAAU;oBACrB,cAAc,EAAE,OAAO;oBACvB,MAAM,EAAE,0BAA0B;iBACnC;aACF;YACD,WAAW,EAAE,CAAC,8BAA8B,CAAC;SAC9C;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,gBAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AAC7E,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,QAAQ,GAAG,IAAA,kBAAY,EAAC;QAC5B,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1F,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;KAC3F,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,QAAQ,GAAG,IAAA,kBAAY,EAAC;QAC5B;YACE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE;YAC/C,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;YAC5G,WAAW,EAAE,CAAC,qBAAqB,CAAC;SACrC;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,28 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('generic extractor finds common labels and summary fields', () => {
10
+ const facts = (0, src_1.extractAlertFacts)({
11
+ alertRef: {
12
+ integrationId: 'int-generic',
13
+ provider: 'unknown',
14
+ alertKey: 'unknown:1',
15
+ timestamp: '2026-06-14T09:55:00.000Z',
16
+ selectedAt: '2026-06-14T10:00:00.000Z',
17
+ },
18
+ raw: {
19
+ title: 'High CPU',
20
+ labels: { service: 'payments', namespace: 'prod' },
21
+ severity: 'critical',
22
+ },
23
+ });
24
+ strict_1.default.equal(facts.provider, 'unknown');
25
+ strict_1.default.equal(facts.title?.value, 'High CPU');
26
+ strict_1.default.ok(facts.labels.some((fact) => fact.key === 'service' && fact.value === 'payments'));
27
+ });
28
+ //# sourceMappingURL=generic-extractor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generic-extractor.test.js","sourceRoot":"","sources":["../../test/generic-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,aAAa;YAC5B,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;YAClD,QAAQ,EAAE,UAAU;SACrB;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxC,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7C,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;AAC9F,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('prometheus extractor merges labels from alertmanager shapes', () => {
10
+ const facts = (0, src_1.extractAlertFacts)({
11
+ alertRef: {
12
+ integrationId: 'int-prom',
13
+ provider: 'prometheus',
14
+ alertKey: 'prometheus:fingerprint',
15
+ timestamp: '2026-06-14T09:55:00.000Z',
16
+ selectedAt: '2026-06-14T10:00:00.000Z',
17
+ },
18
+ raw: {
19
+ commonLabels: { alertname: 'HighLatency', service: 'checkout' },
20
+ alerts: [{ labels: { namespace: 'prod', pod: 'checkout-abc-12345' } }],
21
+ startsAt: '2026-06-14T09:50:00.000Z',
22
+ },
23
+ });
24
+ strict_1.default.equal(facts.extractor.name, 'prometheus-extractor');
25
+ strict_1.default.ok(facts.labels.some((fact) => fact.key === 'service' && fact.value === 'checkout'));
26
+ strict_1.default.ok(facts.labels.some((fact) => fact.key === 'namespace' && fact.value === 'prod'));
27
+ strict_1.default.equal(facts.time.startsAt, '2026-06-14T09:50:00.000Z');
28
+ });
29
+ //# sourceMappingURL=prometheus-extractor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prometheus-extractor.test.js","sourceRoot":"","sources":["../../test/prometheus-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,UAAU;YACzB,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,wBAAwB;YAClC,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,YAAY,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE;YAC/D,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,CAAC;YACtE,QAAQ,EAAE,0BAA0B;SACrC;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;IAC3D,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;IAC5F,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC;IAC1F,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,38 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('extracts facts and resolves service from topology relationship', () => {
10
+ const result = (0, src_1.resolveAlertCorrelation)({
11
+ alertRef: {
12
+ integrationId: 'int-prom',
13
+ provider: 'prometheus',
14
+ alertKey: 'prometheus:abc',
15
+ timestamp: '2026-06-14T09:55:00.000Z',
16
+ selectedAt: '2026-06-14T10:00:00.000Z',
17
+ },
18
+ rawAlert: { labels: { service: 'checkout' } },
19
+ topology: {
20
+ sourceResource: { id: 'res-prom', name: 'Prometheus', provider: 'prometheus' },
21
+ monitoredByRelationships: [
22
+ {
23
+ id: 'rel-1',
24
+ relation: 'MONITORED_BY',
25
+ from: { type: 'service', id: 'svc-checkout' },
26
+ to: { type: 'resource', id: 'res-prom' },
27
+ attributes: { serviceLabel: 'checkout' },
28
+ },
29
+ ],
30
+ deployedAsRelationships: [],
31
+ services: [{ id: 'svc-checkout', name: 'checkout' }],
32
+ resources: [],
33
+ },
34
+ });
35
+ strict_1.default.equal(result.decision.status, 'resolved');
36
+ strict_1.default.deepEqual(result.decision.target, { type: 'service', id: 'svc-checkout' });
37
+ });
38
+ //# sourceMappingURL=resolve-alert-correlation.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-alert-correlation.test.js","sourceRoot":"","sources":["../../test/resolve-alert-correlation.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAAiD;AAEjD,IAAA,mBAAI,EAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,MAAM,GAAG,IAAA,6BAAuB,EAAC;QACrC,QAAQ,EAAE;YACR,aAAa,EAAE,UAAU;YACzB,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,gBAAgB;YAC1B,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;QAC7C,QAAQ,EAAE;YACR,cAAc,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE;YAC9E,wBAAwB,EAAE;gBACxB;oBACE,EAAE,EAAE,OAAO;oBACX,QAAQ,EAAE,cAAc;oBACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE;oBAC7C,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE;oBACxC,UAAU,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE;iBACzC;aACF;YACD,uBAAuB,EAAE,EAAE;YAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACpD,SAAS,EAAE,EAAE;SACd;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjD,gBAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('sentry extractor pulls project, release package, and microservice tag', () => {
10
+ const facts = (0, src_1.extractAlertFacts)({
11
+ alertRef: {
12
+ integrationId: 'int-sentry',
13
+ provider: 'sentry',
14
+ alertKey: 'sentry:issue-1',
15
+ timestamp: '2026-06-14T09:55:00.000Z',
16
+ selectedAt: '2026-06-14T10:00:00.000Z',
17
+ },
18
+ raw: {
19
+ title: 'TypeError',
20
+ project: { slug: 'checkout-api' },
21
+ firstRelease: { versionInfo: { package: 'checkout' } },
22
+ tags: [{ key: 'microservice', value: 'checkout' }],
23
+ },
24
+ });
25
+ strict_1.default.equal(facts.extractor.name, 'sentry-extractor');
26
+ strict_1.default.ok(facts.identifiers.some((fact) => fact.key === 'projectSlug' && fact.value === 'checkout-api'));
27
+ strict_1.default.ok(facts.identifiers.some((fact) => fact.key === 'releasePackage' && fact.value === 'checkout'));
28
+ strict_1.default.ok(facts.labels.some((fact) => fact.key === 'microservice' && fact.value === 'checkout'));
29
+ });
30
+ //# sourceMappingURL=sentry-extractor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sentry-extractor.test.js","sourceRoot":"","sources":["../../test/sentry-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,uEAAuE,EAAE,GAAG,EAAE;IACjF,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,YAAY;YAC3B,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,gBAAgB;YAC1B,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;YACjC,YAAY,EAAE,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;YACtD,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;SACnD;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACvD,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC;IACzG,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,gBAAgB,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;IACxG,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,cAAc,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;AACnG,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('exports package marker', () => {
10
+ strict_1.default.equal(src_1.ALERT_CORRELATION_PACKAGE, '@scoutflo/alert-correlation');
11
+ });
12
+ //# sourceMappingURL=smoke.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"smoke.test.js","sourceRoot":"","sources":["../../test/smoke.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAAmD;AAEnD,IAAA,mBAAI,EAAC,wBAAwB,EAAE,GAAG,EAAE;IAClC,gBAAM,CAAC,KAAK,CAAC,+BAAyB,EAAE,6BAA6B,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ const ref = {
10
+ integrationId: 'int-prom',
11
+ provider: 'prometheus',
12
+ alertKey: 'prometheus:abc',
13
+ timestamp: '2026-06-14T09:55:00.000Z',
14
+ selectedAt: '2026-06-14T10:00:00.000Z',
15
+ };
16
+ (0, node_test_1.default)('uses provider startsAt before alertRef timestamp', () => {
17
+ const time = (0, src_1.normalizeAlertTime)(ref, {
18
+ startsAt: '2026-06-14T09:50:00.000Z',
19
+ endsAt: '2026-06-14T09:59:00.000Z',
20
+ });
21
+ strict_1.default.equal(time.startsAt, '2026-06-14T09:50:00.000Z');
22
+ strict_1.default.equal(time.endsAt, '2026-06-14T09:59:00.000Z');
23
+ strict_1.default.equal(time.isOpenEnded, false);
24
+ });
25
+ (0, node_test_1.default)('falls back to alertRef timestamp when provider time is absent', () => {
26
+ const time = (0, src_1.normalizeAlertTime)(ref, {});
27
+ strict_1.default.equal(time.startsAt, ref.timestamp);
28
+ strict_1.default.equal(time.isOpenEnded, true);
29
+ });
30
+ //# sourceMappingURL=time.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"time.test.js","sourceRoot":"","sources":["../../test/time.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA4C;AAE5C,MAAM,GAAG,GAAG;IACV,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,0BAA0B;IACrC,UAAU,EAAE,0BAA0B;CACvC,CAAC;AAEF,IAAA,mBAAI,EAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,MAAM,IAAI,GAAG,IAAA,wBAAkB,EAAC,GAAG,EAAE;QACnC,QAAQ,EAAE,0BAA0B;QACpC,MAAM,EAAE,0BAA0B;KACnC,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;IACxD,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IACtD,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,IAAI,GAAG,IAAA,wBAAkB,EAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACzC,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const src_1 = require("../src");
9
+ (0, node_test_1.default)('victoriametrics extractor keeps VM provider identity', () => {
10
+ const facts = (0, src_1.extractAlertFacts)({
11
+ alertRef: {
12
+ integrationId: 'int-vm',
13
+ provider: 'victoriametrics',
14
+ alertKey: 'victoriametrics:abc',
15
+ timestamp: '2026-06-14T09:55:00.000Z',
16
+ selectedAt: '2026-06-14T10:00:00.000Z',
17
+ },
18
+ raw: {
19
+ metric: { alertname: 'HighCPU', service: 'payments' },
20
+ rule: { labels: { namespace: 'prod' } },
21
+ },
22
+ });
23
+ strict_1.default.equal(facts.provider, 'victoriametrics');
24
+ strict_1.default.equal(facts.extractor.name, 'victoriametrics-extractor');
25
+ strict_1.default.ok(facts.labels.some((fact) => fact.key === 'service' && fact.value === 'payments'));
26
+ });
27
+ //# sourceMappingURL=victoriametrics-extractor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"victoriametrics-extractor.test.js","sourceRoot":"","sources":["../../test/victoriametrics-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,QAAQ;YACvB,QAAQ,EAAE,iBAAiB;YAC3B,QAAQ,EAAE,qBAAqB;YAC/B,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE;YACrD,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;SACxC;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAChD,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAChE,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;AAC9F,CAAC,CAAC,CAAC"}
package/package.json ADDED
@@ -0,0 +1,32 @@
1
+ {
2
+ "name": "@scoutflo/alert-correlation",
3
+ "version": "0.1.0",
4
+ "description": "Pure alert-to-topology correlation contracts and policies for Scoutflo alert investigation workflows.",
5
+ "main": "dist/src/index.js",
6
+ "types": "dist/src/index.d.ts",
7
+ "files": [
8
+ "dist/"
9
+ ],
10
+ "scripts": {
11
+ "build": "tsc -p tsconfig.json",
12
+ "test": "npm run build && node --test dist/test/*.test.js"
13
+ },
14
+ "keywords": [
15
+ "scoutflo",
16
+ "alert-correlation",
17
+ "topology"
18
+ ],
19
+ "author": "Scoutflo",
20
+ "license": "MIT",
21
+ "dependencies": {
22
+ "zod": "^3.23.8"
23
+ },
24
+ "devDependencies": {
25
+ "@types/node": "^20.14.10",
26
+ "typescript": "^5.5.3"
27
+ },
28
+ "publishConfig": {
29
+ "registry": "https://registry.npmjs.org",
30
+ "access": "public"
31
+ }
32
+ }