sentinel-qa 0.0.1

package/dist/__tests__/test-status-store.test.js

@@ -0,0 +1,197 @@
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { parse } from 'yaml';
+import { TestStatusStore } from '../store/test-status-store.js';
+let tempDir;
+let store;
+describe('TestStatusStore', () => {
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), 'sentinel-test-'));
+        store = new TestStatusStore(tempDir);
+    });
+    afterEach(async () => {
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    describe('load', () => {
+        it('should return empty array for non-existent app', async () => {
+            const result = await store.load('non-existent');
+            assert.deepStrictEqual(result, []);
+        });
+    });
+    describe('save and load round-trip', () => {
+        it('should persist and retrieve statuses via YAML', async () => {
+            const statuses = [
+                {
+                    id: 'TC-001',
+                    status: 'stable',
+                    passRate: 1.0,
+                    runHistory: [true, true, true, true, true],
+                    lastRun: '2026-03-14T10:30:00.000Z',
+                },
+                {
+                    id: 'TC-002',
+                    status: 'quarantine',
+                    passRate: 0.6,
+                    runHistory: [true, false, true, true, false],
+                    lastRun: '2026-03-14T10:30:00.000Z',
+                    failureReason: 'Timing issue',
+                },
+            ];
+            await store.save('my-app', statuses);
+            const loaded = await store.load('my-app');
+            assert.equal(loaded.length, 2);
+            assert.equal(loaded[0].id, 'TC-001');
+            assert.equal(loaded[0].status, 'stable');
+            assert.equal(loaded[0].passRate, 1.0);
+            assert.deepStrictEqual(loaded[0].runHistory, [true, true, true, true, true]);
+            assert.equal(loaded[1].id, 'TC-002');
+            assert.equal(loaded[1].status, 'quarantine');
+            assert.equal(loaded[1].failureReason, 'Timing issue');
+        });
+        it('should write valid YAML to disk', async () => {
+            await store.save('my-app', [
+                { id: 'TC-001', status: 'new', passRate: 1, runHistory: [true], lastRun: '2026-01-01T00:00:00.000Z' },
+            ]);
+            const raw = await readFile(join(tempDir, 'my-app', 'status.yaml'), 'utf-8');
+            const parsed = parse(raw);
+            assert.equal(parsed.tests.length, 1);
+            assert.equal(parsed.tests[0].id, 'TC-001');
+        });
+    });
+    describe('getStatus', () => {
+        it('should return null for unknown test', async () => {
+            const result = await store.getStatus('my-app', 'TC-999');
+            assert.equal(result, null);
+        });
+        it('should return matching test status', async () => {
+            await store.save('my-app', [
+                { id: 'TC-001', status: 'stable', passRate: 1, runHistory: [true], lastRun: '2026-01-01T00:00:00.000Z' },
+            ]);
+            const result = await store.getStatus('my-app', 'TC-001');
+            assert.notEqual(result, null);
+            assert.equal(result.id, 'TC-001');
+            assert.equal(result.status, 'stable');
+        });
+    });
+    describe('recordRun', () => {
+        it('should create new entry on first run', async () => {
+            const result = await store.recordRun('my-app', 'TC-001', true);
+            assert.equal(result.id, 'TC-001');
+            assert.equal(result.status, 'new');
+            assert.deepStrictEqual(result.runHistory, [true]);
+            assert.equal(result.passRate, 1);
+        });
+        it('should accumulate run history', async () => {
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', false);
+            const result = await store.recordRun('my-app', 'TC-001', true);
+            assert.deepStrictEqual(result.runHistory, [true, false, true]);
+            assert.equal(result.passRate, 2 / 3);
+        });
+        it('should promote to stable after 5/5 passes', async () => {
+            for (let i = 0; i < 4; i++) {
+                await store.recordRun('my-app', 'TC-001', true);
+            }
+            const result = await store.recordRun('my-app', 'TC-001', true);
+            assert.equal(result.status, 'stable');
+            assert.equal(result.passRate, 1);
+            assert.equal(result.runHistory.length, 5);
+        });
+        it('should quarantine at 4/5 passes', async () => {
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', true);
+            const result = await store.recordRun('my-app', 'TC-001', false);
+            assert.equal(result.status, 'quarantine');
+            assert.equal(result.passRate, 0.8);
+        });
+        it('should quarantine at 3/5 passes', async () => {
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', false);
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', false);
+            const result = await store.recordRun('my-app', 'TC-001', true);
+            assert.equal(result.status, 'quarantine');
+            assert.equal(result.passRate, 0.6);
+        });
+        it('should reject at 2/5 passes', async () => {
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', false);
+            await store.recordRun('my-app', 'TC-001', false);
+            await store.recordRun('my-app', 'TC-001', false);
+            const result = await store.recordRun('my-app', 'TC-001', true);
+            assert.equal(result.status, 'rejected');
+            assert.equal(result.passRate, 0.4);
+        });
+        it('should reject at 0/5 passes', async () => {
+            for (let i = 0; i < 5; i++) {
+                await store.recordRun('my-app', 'TC-001', false);
+            }
+            const result = await store.getStatus('my-app', 'TC-001');
+            assert.equal(result.status, 'rejected');
+            assert.equal(result.passRate, 0);
+        });
+        it('should keep only last 5 runs', async () => {
+            // 5 failures → rejected
+            for (let i = 0; i < 5; i++) {
+                await store.recordRun('my-app', 'TC-001', false);
+            }
+            let result = await store.getStatus('my-app', 'TC-001');
+            assert.equal(result.status, 'rejected');
+            // Now 5 passes → should become stable (old failures dropped)
+            for (let i = 0; i < 5; i++) {
+                await store.recordRun('my-app', 'TC-001', true);
+            }
+            result = await store.getStatus('my-app', 'TC-001');
+            assert.equal(result.status, 'stable');
+            assert.equal(result.runHistory.length, 5);
+            assert.deepStrictEqual(result.runHistory, [true, true, true, true, true]);
+        });
+        it('should not promote/demote with fewer than 5 runs', async () => {
+            await store.recordRun('my-app', 'TC-001', false);
+            await store.recordRun('my-app', 'TC-001', false);
+            await store.recordRun('my-app', 'TC-001', false);
+            const result = await store.recordRun('my-app', 'TC-001', false);
+            // Only 4 runs — should still be 'new'
+            assert.equal(result.status, 'new');
+            assert.equal(result.runHistory.length, 4);
+        });
+        it('should calculate passRate correctly for partial history', async () => {
+            await store.recordRun('my-app', 'TC-001', true);
+            const result = await store.recordRun('my-app', 'TC-001', false);
+            assert.equal(result.passRate, 0.5);
+            assert.equal(result.runHistory.length, 2);
+        });
+        it('should set failureReason on quarantine', async () => {
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', false);
+            const result = await store.recordRun('my-app', 'TC-001', true);
+            assert.equal(result.status, 'quarantine');
+            assert.ok(result.failureReason);
+        });
+        it('should clear failureReason on promotion to stable', async () => {
+            // First get to quarantine
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', true);
+            await store.recordRun('my-app', 'TC-001', false);
+            await store.recordRun('my-app', 'TC-001', true);
+            let result = await store.getStatus('my-app', 'TC-001');
+            assert.equal(result.status, 'quarantine');
+            // Now push 5 passes
+            for (let i = 0; i < 5; i++) {
+                await store.recordRun('my-app', 'TC-001', true);
+            }
+            result = await store.getStatus('my-app', 'TC-001');
+            assert.equal(result.status, 'stable');
+            assert.equal(result.failureReason, undefined);
+        });
+    });
+});
+//# sourceMappingURL=test-status-store.test.js.map

package/dist/__tests__/test-status-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-status-store.test.js","sourceRoot":"","sources":["../../src/__tests__/test-status-store.test.ts"],"names":[],"mappings":"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"}

package/dist/event-validation/capture-patterns.d.ts

@@ -0,0 +1,26 @@
+/**
+ * URL patterns for known analytics SDK endpoints.
+ * Used by Playwright to intercept analytics network requests.
+ */
+export interface AnalyticsPattern {
+    /** Human-readable SDK name */
+    sdk: string;
+    /** URL patterns to match (supports glob-like matching) */
+    urlPatterns: string[];
+    /** Function to extract event name and params from request body/URL */
+    parseRequest: (url: string, body: string | null) => ParsedEvent[];
+}
+export interface ParsedEvent {
+    event_name: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Built-in analytics SDK patterns.
+ */
+export declare const ANALYTICS_PATTERNS: AnalyticsPattern[];
+/**
+ * Check if a URL matches any analytics pattern.
+ * Returns the matching pattern or null.
+ */
+export declare function matchAnalyticsUrl(url: string): AnalyticsPattern | null;
+//# sourceMappingURL=capture-patterns.d.ts.map

package/dist/event-validation/capture-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-patterns.d.ts","sourceRoot":"","sources":["../../src/event-validation/capture-patterns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sEAAsE;IACtE,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,WAAW,EAAE,CAAC;CACnE;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AA2FD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EAiChD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAYtE"}

package/dist/event-validation/capture-patterns.js

@@ -0,0 +1,152 @@
+/**
+ * URL patterns for known analytics SDK endpoints.
+ * Used by Playwright to intercept analytics network requests.
+ */
+/**
+ * Parse Google Analytics 4 (GA4) Measurement Protocol requests.
+ * Endpoint: google-analytics.com/g/collect
+ */
+function parseGA4Request(url, _body) {
+    const events = [];
+    try {
+        const urlObj = new URL(url);
+        const eventName = urlObj.searchParams.get('en');
+        if (eventName) {
+            const params = {};
+            for (const [key, value] of urlObj.searchParams.entries()) {
+                if (key !== 'en' && key !== 'v' && key !== 'tid') {
+                    params[key] = isNaN(Number(value)) ? value : Number(value);
+                }
+            }
+            events.push({ event_name: eventName, params });
+        }
+    }
+    catch { /* ignore parse errors */ }
+    return events;
+}
+/**
+ * Parse Firebase Analytics requests.
+ * Endpoint: firebase-installations.googleapis.com, firebaselogging
+ */
+function parseFirebaseRequest(_url, body) {
+    const events = [];
+    if (!body)
+        return events;
+    try {
+        const data = JSON.parse(body);
+        if (Array.isArray(data.events)) {
+            for (const event of data.events) {
+                events.push({
+                    event_name: event.name ?? event.event_name ?? 'unknown',
+                    params: event.params ?? {},
+                });
+            }
+        }
+    }
+    catch { /* ignore parse errors */ }
+    return events;
+}
+/**
+ * Parse Amplitude Analytics requests.
+ * Endpoint: api.amplitude.com
+ */
+function parseAmplitudeRequest(_url, body) {
+    const events = [];
+    if (!body)
+        return events;
+    try {
+        const data = JSON.parse(body);
+        const eventList = data.events ?? (Array.isArray(data) ? data : [data]);
+        for (const event of eventList) {
+            events.push({
+                event_name: event.event_type ?? event.event_name ?? 'unknown',
+                params: event.event_properties ?? event.user_properties ?? {},
+            });
+        }
+    }
+    catch { /* ignore parse errors */ }
+    return events;
+}
+/**
+ * Parse Mixpanel Analytics requests.
+ * Endpoint: api.mixpanel.com/track
+ */
+function parseMixpanelRequest(_url, body) {
+    const events = [];
+    if (!body)
+        return events;
+    try {
+        // Mixpanel sends base64-encoded data or JSON
+        let data;
+        try {
+            data = JSON.parse(body);
+        }
+        catch {
+            data = JSON.parse(Buffer.from(body, 'base64').toString());
+        }
+        const eventList = Array.isArray(data) ? data : [data];
+        for (const event of eventList) {
+            events.push({
+                event_name: event.event ?? 'unknown',
+                params: event.properties ?? {},
+            });
+        }
+    }
+    catch { /* ignore parse errors */ }
+    return events;
+}
+/**
+ * Built-in analytics SDK patterns.
+ */
+export const ANALYTICS_PATTERNS = [
+    {
+        sdk: 'Google Analytics 4',
+        urlPatterns: [
+            '**/google-analytics.com/g/collect**',
+            '**/analytics.google.com/g/collect**',
+        ],
+        parseRequest: parseGA4Request,
+    },
+    {
+        sdk: 'Firebase Analytics',
+        urlPatterns: [
+            '**/firebaselogging/**',
+            '**/firebase-installations.googleapis.com/**',
+            '**/app-measurement.com/**',
+        ],
+        parseRequest: parseFirebaseRequest,
+    },
+    {
+        sdk: 'Amplitude',
+        urlPatterns: [
+            '**/api.amplitude.com/**',
+            '**/api2.amplitude.com/**',
+        ],
+        parseRequest: parseAmplitudeRequest,
+    },
+    {
+        sdk: 'Mixpanel',
+        urlPatterns: [
+            '**/api.mixpanel.com/**',
+        ],
+        parseRequest: parseMixpanelRequest,
+    },
+];
+/**
+ * Check if a URL matches any analytics pattern.
+ * Returns the matching pattern or null.
+ */
+export function matchAnalyticsUrl(url) {
+    for (const pattern of ANALYTICS_PATTERNS) {
+        for (const urlPattern of pattern.urlPatterns) {
+            // Simple substring matching for URL patterns
+            // Strip leading ** and trailing ** for contains-style matching
+            const cleanPattern = urlPattern.replace(/^\*\*\//, '').replace(/\/?\*\*$/, '');
+            if (url.includes(cleanPattern)) {
+                return pattern;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=capture-patterns.js.map

package/dist/event-validation/capture-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-patterns.js","sourceRoot":"","sources":["../../src/event-validation/capture-patterns.ts"],"names":[],"mappings":"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"}

package/dist/event-validation/index.d.ts

@@ -0,0 +1,6 @@
+export { validateEvents } from './validator.js';
+export { matchAnalyticsUrl, ANALYTICS_PATTERNS } from './capture-patterns.js';
+export { validateEventSpec, eventSpecConfigSchema } from './schema.js';
+export type { CapturedEvent, EventValidationResult, EventMatchResult, ParamError, UnexpectedEvent, } from './types.js';
+export type { AnalyticsPattern, ParsedEvent } from './capture-patterns.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/event-validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/event-validation/index.js

@@ -0,0 +1,4 @@
+export { validateEvents } from './validator.js';
+export { matchAnalyticsUrl, ANALYTICS_PATTERNS } from './capture-patterns.js';
+export { validateEventSpec, eventSpecConfigSchema } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/event-validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/event-validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/event-validation/schema.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/**
+ * Zod schema for validating event spec YAML input.
+ */
+export declare const eventParamSchema: z.ZodRecord<z.ZodString, z.ZodEnum<["string", "number", "boolean"]>>;
+export declare const eventSpecEntrySchema: z.ZodObject<{
+    trigger: z.ZodString;
+    event_name: z.ZodString;
+    required_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["string", "number", "boolean"]>>>;
+    optional_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["string", "number", "boolean"]>>>;
+}, "strip", z.ZodTypeAny, {
+    trigger: string;
+    event_name: string;
+    required_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+    optional_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+}, {
+    trigger: string;
+    event_name: string;
+    required_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+    optional_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+}>;
+export declare const eventSpecConfigSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        trigger: z.ZodString;
+        event_name: z.ZodString;
+        required_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["string", "number", "boolean"]>>>;
+        optional_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["string", "number", "boolean"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        trigger: string;
+        event_name: string;
+        required_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+        optional_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+    }, {
+        trigger: string;
+        event_name: string;
+        required_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+        optional_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    events: {
+        trigger: string;
+        event_name: string;
+        required_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+        optional_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+    }[];
+}, {
+    events: {
+        trigger: string;
+        event_name: string;
+        required_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+        optional_params?: Record<string, "string" | "number" | "boolean"> | undefined;
+    }[];
+}>;
+/**
+ * Validate an event spec config object against the Zod schema.
+ * Returns the parsed result or throws on validation failure.
+ */
+export declare function validateEventSpec(data: unknown): z.infer<typeof eventSpecConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/event-validation/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/event-validation/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB,sEAG5B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAEtF"}

package/dist/event-validation/schema.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/**
+ * Zod schema for validating event spec YAML input.
+ */
+export const eventParamSchema = z.record(z.string(), z.enum(['string', 'number', 'boolean']));
+export const eventSpecEntrySchema = z.object({
+    trigger: z.string().describe('Description of what triggers this event'),
+    event_name: z.string().describe('Analytics event name'),
+    required_params: eventParamSchema.optional().describe('Required parameters with type'),
+    optional_params: eventParamSchema.optional().describe('Optional parameters with type'),
+});
+export const eventSpecConfigSchema = z.object({
+    events: z.array(eventSpecEntrySchema),
+});
+/**
+ * Validate an event spec config object against the Zod schema.
+ * Returns the parsed result or throws on validation failure.
+ */
+export function validateEventSpec(data) {
+    return eventSpecConfigSchema.parse(data);
+}
+//# sourceMappingURL=schema.js.map

package/dist/event-validation/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/event-validation/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACvE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACvD,eAAe,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACtF,eAAe,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CACvF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;CACtC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/event-validation/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A captured analytics event from network interception or device logs.
+ */
+export interface CapturedEvent {
+    event_name: string;
+    params: Record<string, unknown>;
+    timestamp?: string;
+    source_url?: string;
+}
+/**
+ * Result of comparing a single expected event against captured events.
+ */
+export interface EventMatchResult {
+    event_name: string;
+    trigger: string;
+    status: 'matched' | 'missing' | 'param_error';
+    param_errors?: ParamError[];
+}
+export interface ParamError {
+    param: string;
+    expected: string;
+    got: string;
+}
+/**
+ * An unexpected event that was captured but not in the spec.
+ */
+export interface UnexpectedEvent {
+    event_name: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Full validation result comparing spec vs captured events.
+ */
+export interface EventValidationResult {
+    total_expected: number;
+    matched: number;
+    missing: number;
+    param_errors: number;
+    unexpected_count: number;
+    results: EventMatchResult[];
+    unexpected: UnexpectedEvent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/event-validation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/event-validation/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;IAC9C,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B"}

package/dist/event-validation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/event-validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/event-validation/types.ts"],"names":[],"mappings":""}

package/dist/event-validation/validator.d.ts

@@ -0,0 +1,14 @@
+import type { EventSpecEntry } from '../registry/types.js';
+import type { CapturedEvent, EventValidationResult } from './types.js';
+/**
+ * Validate captured events against an event spec.
+ *
+ * For each expected event in the spec:
+ * - Check if a matching captured event exists (by event_name)
+ * - If found, validate required_params (presence + type)
+ * - If not found, mark as missing
+ *
+ * Any captured events not in the spec are listed as unexpected.
+ */
+export declare function validateEvents(spec: EventSpecEntry[], captured: CapturedEvent[]): EventValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/event-validation/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/event-validation/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EAItB,MAAM,YAAY,CAAC;AAkBpB;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,cAAc,EAAE,EACtB,QAAQ,EAAE,aAAa,EAAE,GACxB,qBAAqB,CA+EvB"}