playwright-posthog 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 playwright-posthog contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+# 🦔 playwright-posthog
+
+Playwright matchers for testing PostHog analytics events.
+
+## 📦 Installation
+
+```bash
+npm install --save-dev playwright-posthog
+```
+
+## 🚀 Setup
+
+Extend your Playwright test with PostHog tracking:
+
+```typescript
+// fixtures.ts
+import { test as base, expect as baseExpect } from '@playwright/test';
+import { withPostHogTracking, matchers } from 'playwright-posthog';
+
+export const test = withPostHogTracking(base);
+export const expect = baseExpect.extend(matchers);
+```
+
+Then use in your tests:
+
+```typescript
+// my-test.spec.ts
+import { test, expect } from './fixtures';
+
+test('user signup tracking works', async ({ page }) => {
+  await page.goto('/signup');
+  await page.getByLabel('Email').fill('user@example.com');
+  await page.getByText('Sign Up').click();
+
+  // ✅ Assert the event was fired
+  await expect(page).toHaveFiredEvent('user_signed_up', {
+    plan: 'pro',
+    source: 'web'
+  });
+});
+```
+
+## 📖 API Reference
+
+### `withPostHogTracking(test)`
+
+Extends a Playwright test instance with PostHog event tracking on the `page` fixture.
+
+```typescript
+import { test as base } from '@playwright/test';
+import { withPostHogTracking } from 'playwright-posthog';
+
+export const test = withPostHogTracking(base);
+```
+
+Works with already-extended tests too:
+
+```typescript
+const testWithAuth = base.extend({
+  authenticatedPage: async ({ page }, use) => {
+    // ... login logic
+    await use(page);
+  },
+});
+
+export const test = withPostHogTracking(testWithAuth);
+```
+
+### `matchers`
+
+Custom matchers to extend Playwright's `expect`:
+
+```typescript
+import { expect as baseExpect } from '@playwright/test';
+import { matchers } from 'playwright-posthog';
+
+export const expect = baseExpect.extend(matchers);
+```
+
+### 🎯 Matchers
+
+#### `toHaveFiredEvent(eventName, properties?, config?)`
+
+Asserts that a PostHog event was fired. Automatically polls for up to 2 seconds.
+
+```typescript
+// Basic usage
+await expect(page).toHaveFiredEvent('button_clicked');
+
+// With property matching (subset match)
+await expect(page).toHaveFiredEvent('purchase_completed', {
+  plan: 'pro',
+  amount: 99.99
+});
+
+// With custom timeout
+await expect(page).toHaveFiredEvent('slow_event', {}, {
+  timeout: 5000,      // Wait up to 5 seconds
+  pollInterval: 200   // Check every 200ms
+});
+```
+
+> 💡 **Properties Matching**: Uses subset matching - the event properties must *contain* the expected properties but can have additional ones.
+
+#### `notToHaveFiredEvent(eventName, properties?, config?)`
+
+Asserts that an event was NOT fired:
+
+```typescript
+await expect(page).notToHaveFiredEvent('error_occurred');
+```
+
+#### `toHaveCapturedEvents(count?)`
+
+Asserts that events were captured:
+
+```typescript
+// At least one event
+await expect(page).toHaveCapturedEvents();
+
+// Exactly 5 events
+await expect(page).toHaveCapturedEvents(5);
+```
+
+### 🐛 Debug Mode
+
+Enable debug mode via the `DEBUG` environment variable:
+
+```bash
+DEBUG=true npx playwright test
+```
+
+### 🛠️ Utility Functions
+
+```typescript
+import { getCapturedEvents, clearCapturedEvents } from 'playwright-posthog';
+
+test('advanced usage', async ({ page }) => {
+  await page.goto('/');
+
+  // Get all captured events
+  const events = getCapturedEvents(page);
+
+  // Clear events (useful for multi-step tests)
+  clearCapturedEvents(page);
+});
+```
+
+## 📚 Examples
+
+### Testing Event Properties
+
+```typescript
+test('tracks user preferences', async ({ page }) => {
+  await page.goto('/settings');
+  await page.getByLabel('Theme').selectOption('dark');
+  await page.getByText('Save').click();
+
+  await expect(page).toHaveFiredEvent('settings_updated', {
+    theme: 'dark',
+  });
+});
+```
+
+### Testing a Funnel
+
+```typescript
+test('tracks funnel events', async ({ page }) => {
+  await page.goto('/product');
+  await expect(page).toHaveFiredEvent('product_viewed');
+
+  await page.getByText('Add to Cart').click();
+  await expect(page).toHaveFiredEvent('add_to_cart');
+
+  await page.getByText('Checkout').click();
+  await expect(page).toHaveFiredEvent('checkout_started');
+});
+```
+
+## 📄 License
+
+MIT

package/dist/global.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Type declarations for playwright-posthog custom matchers
+ *
+ * This file extends Playwright's expect API to include PostHog-specific matchers.
+ */
+
+import type { Page } from '@playwright/test';
+import type { MatcherConfig } from '../src/matchers';
+
+declare global {
+  namespace PlaywrightTest {
+    interface Matchers<R, T = unknown> {
+      /**
+       * Assert that a PostHog event was fired with the given name and optional properties.
+       *
+       * This matcher polls for up to 2 seconds (configurable) to account for the
+       * asynchronous nature of analytics events.
+       *
+       * @param eventName - The name of the event to check for
+       * @param expectedProperties - Optional properties to match (subset matching)
+       * @param config - Optional configuration for timeout and polling interval
+       *
+       * @example
+       * ```typescript
+       * await expect(page).toHaveFiredEvent('user_signed_up');
+       * await expect(page).toHaveFiredEvent('purchase_completed', {
+       *   plan: 'pro',
+       *   amount: 99.99
+       * });
+       * await expect(page).toHaveFiredEvent('custom_event', {}, {
+       *   timeout: 5000,
+       *   pollInterval: 200
+       * });
+       * ```
+       */
+      toHaveFiredEvent(
+        eventName: string,
+        expectedProperties?: Record<string, any>,
+        config?: MatcherConfig
+      ): Promise<R>;
+
+      /**
+       * Assert that a PostHog event was NOT fired with the given name and optional properties.
+       *
+       * @param eventName - The name of the event to check for
+       * @param expectedProperties - Optional properties to match (subset matching)
+       * @param config - Optional configuration for timeout and polling interval
+       *
+       * @example
+       * ```typescript
+       * await expect(page).notToHaveFiredEvent('error_occurred');
+       * ```
+       */
+      notToHaveFiredEvent(
+        eventName: string,
+        expectedProperties?: Record<string, any>,
+        config?: MatcherConfig
+      ): Promise<R>;
+
+      /**
+       * Assert that the page has captured a specific number of events (or any events if count is not provided).
+       *
+       * @param count - Optional number of events to check for
+       *
+       * @example
+       * ```typescript
+       * await expect(page).toHaveCapturedEvents(); // At least one event
+       * await expect(page).toHaveCapturedEvents(5); // Exactly 5 events
+       * ```
+       */
+      toHaveCapturedEvents(count?: number): R;
+    }
+  }
+}
+
+// This export is necessary to make this a module
+export {};

package/dist/hog-watcher.d.ts

@@ -0,0 +1,6 @@
+import type { Request } from '@playwright/test';
+import { type CapturedEvent } from './symbols';
+export declare function isPostHogRequest(url: string): boolean;
+export declare function extractEventsFromRequest(request: Request): Promise<CapturedEvent[]>;
+export declare function matchesProperties(actual: Record<string, any> | undefined, expected: Record<string, any> | undefined): boolean;
+//# sourceMappingURL=hog-watcher.d.ts.map

package/dist/hog-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hog-watcher.d.ts","sourceRoot":"","sources":["../src/hog-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAM/D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrD;AAUD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAiD1B;AA0BD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GACxC,OAAO,CAkBT"}

package/dist/hog-watcher.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPostHogRequest = isPostHogRequest;
+exports.extractEventsFromRequest = extractEventsFromRequest;
+exports.matchesProperties = matchesProperties;
+const symbols_1 = require("./symbols");
+function isPostHogRequest(url) {
+    return (url.includes('/e/') ||
+        url.includes('/capture') ||
+        url.includes('/batch') ||
+        url.includes('/s/'));
+}
+async function extractEventsFromRequest(request) {
+    const events = [];
+    const debug = (0, symbols_1.isDebugEnabled)();
+    try {
+        const body = request.postDataJSON();
+        if (!body) {
+            if (debug) {
+                console.log('[playwright-posthog] No POST data found in request');
+            }
+            return events;
+        }
+        if (debug) {
+            console.log('[playwright-posthog] Request body:', JSON.stringify(body, null, 2));
+        }
+        if (body.batch && Array.isArray(body.batch)) {
+            for (const event of body.batch) {
+                events.push(normalizeEvent(event));
+            }
+        }
+        else if (Array.isArray(body)) {
+            for (const event of body) {
+                events.push(normalizeEvent(event));
+            }
+        }
+        else if (body.event || body.e) {
+            events.push(normalizeEvent(body));
+        }
+        else if (body.data) {
+            if (Array.isArray(body.data)) {
+                for (const event of body.data) {
+                    events.push(normalizeEvent(event));
+                }
+            }
+            else {
+                events.push(normalizeEvent(body.data));
+            }
+        }
+        if (debug && events.length > 0) {
+            console.log(`[playwright-posthog] Extracted ${events.length} event(s):`, events.map((e) => e.event).join(', '));
+        }
+    }
+    catch (error) {
+        if (debug) {
+            console.error('[playwright-posthog] Error parsing PostHog request:', error);
+        }
+    }
+    return events;
+}
+function normalizeEvent(rawEvent) {
+    const event = {
+        event: rawEvent.event || rawEvent.e || 'unknown',
+        properties: rawEvent.properties || rawEvent.p || {},
+        timestamp: rawEvent.timestamp || rawEvent.ts || Date.now(),
+        distinct_id: rawEvent.distinct_id || rawEvent.d,
+    };
+    for (const [key, value] of Object.entries(rawEvent)) {
+        if (!['event', 'e', 'properties', 'p', 'timestamp', 'ts', 'distinct_id', 'd'].includes(key)) {
+            event[key] = value;
+        }
+    }
+    return event;
+}
+function matchesProperties(actual, expected) {
+    if (!expected || Object.keys(expected).length === 0) {
+        return true;
+    }
+    if (!actual) {
+        return false;
+    }
+    for (const [key, expectedValue] of Object.entries(expected)) {
+        const actualValue = actual[key];
+        if (!deepEqual(actualValue, expectedValue)) {
+            return false;
+        }
+    }
+    return true;
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return a === b;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== 'object')
+        return a === b;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, index) => deepEqual(val, b[index]));
+    }
+    if (Array.isArray(a) || Array.isArray(b))
+        return false;
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    return keysA.every(key => deepEqual(a[key], b[key]));
+}
+//# sourceMappingURL=hog-watcher.js.map

package/dist/hog-watcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { kHogEvents, type CapturedEvent } from './symbols';
+import type { Page, TestType } from '@playwright/test';
+export { matchers } from './matchers';
+export type HogPage = Page & {
+    [kHogEvents]: CapturedEvent[];
+};
+export declare function withPostHogTracking<T extends TestType<any, any>>(test: T): T;
+export declare function getCapturedEvents(page: Page): CapturedEvent[];
+export declare function clearCapturedEvents(page: Page): void;
+export type { CapturedEvent } from './symbols';
+export type { MatcherConfig } from './matchers';
+export { isPostHogRequest, extractEventsFromRequest, matchesProperties } from './hog-watcher';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,UAAU,EAAkB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3E,OAAO,KAAK,EAAE,IAAI,EAAkB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKtC,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG;IAC3B,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC/B,CAAC;AAiBF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CA2C5E;AAKD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,EAAE,CAG7D;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAKpD;AAKD,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesProperties = exports.extractEventsFromRequest = exports.isPostHogRequest = exports.matchers = void 0;
+exports.withPostHogTracking = withPostHogTracking;
+exports.getCapturedEvents = getCapturedEvents;
+exports.clearCapturedEvents = clearCapturedEvents;
+const symbols_1 = require("./symbols");
+const hog_watcher_1 = require("./hog-watcher");
+var matchers_1 = require("./matchers");
+Object.defineProperty(exports, "matchers", { enumerable: true, get: function () { return matchers_1.matchers; } });
+function withPostHogTracking(test) {
+    return test.extend({
+        page: async ({ page: originalPage }, use) => {
+            const hogPage = originalPage;
+            const debug = (0, symbols_1.isDebugEnabled)();
+            hogPage[symbols_1.kHogEvents] = [];
+            if (debug) {
+                console.log('[playwright-posthog] Initializing PostHog event capture');
+            }
+            await hogPage.route('**/*', async (route, request) => {
+                const url = request.url();
+                if ((0, hog_watcher_1.isPostHogRequest)(url)) {
+                    if (debug) {
+                        console.log(`[playwright-posthog] Intercepted PostHog request: ${url}`);
+                    }
+                    const events = await (0, hog_watcher_1.extractEventsFromRequest)(request);
+                    hogPage[symbols_1.kHogEvents].push(...events);
+                    if (debug && events.length > 0) {
+                        console.log(`[playwright-posthog] Total events captured: ${hogPage[symbols_1.kHogEvents].length}`);
+                        console.log(`[playwright-posthog] Latest events:`, events.map((e) => ({
+                            event: e.event,
+                            properties: e.properties,
+                        })));
+                    }
+                }
+                await route.continue();
+            });
+            await use(hogPage);
+            if (debug) {
+                console.log(`[playwright-posthog] Test complete. Total events captured: ${hogPage[symbols_1.kHogEvents].length}`);
+            }
+        },
+    });
+}
+function getCapturedEvents(page) {
+    const hogPage = page;
+    return hogPage[symbols_1.kHogEvents] || [];
+}
+function clearCapturedEvents(page) {
+    const hogPage = page;
+    if (hogPage[symbols_1.kHogEvents]) {
+        hogPage[symbols_1.kHogEvents] = [];
+    }
+}
+var hog_watcher_2 = require("./hog-watcher");
+Object.defineProperty(exports, "isPostHogRequest", { enumerable: true, get: function () { return hog_watcher_2.isPostHogRequest; } });
+Object.defineProperty(exports, "extractEventsFromRequest", { enumerable: true, get: function () { return hog_watcher_2.extractEventsFromRequest; } });
+Object.defineProperty(exports, "matchesProperties", { enumerable: true, get: function () { return hog_watcher_2.matchesProperties; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA6DA,kDA2CC;AAKD,8CAGC;AAKD,kDAKC;AAzFD,uCAA2E;AAC3E,+CAA2E;AAG3E,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAwBjB,SAAgB,mBAAmB,CAA+B,IAAO;IACvE,OAAO,IAAI,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAkB,EAAE,GAAqC,EAAE,EAAE;YAC5F,MAAM,OAAO,GAAG,YAAuB,CAAC;YACxC,MAAM,KAAK,GAAG,IAAA,wBAAc,GAAE,CAAC;YAE/B,OAAO,CAAC,oBAAU,CAAC,GAAG,EAAE,CAAC;YAEzB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAY,EAAE,OAAgB,EAAE,EAAE;gBACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;gBAE1B,IAAI,IAAA,8BAAgB,EAAC,GAAG,CAAC,EAAE,CAAC;oBAC1B,IAAI,KAAK,EAAE,CAAC;wBACV,OAAO,CAAC,GAAG,CAAC,qDAAqD,GAAG,EAAE,CAAC,CAAC;oBAC1E,CAAC;oBAED,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAwB,EAAC,OAAO,CAAC,CAAC;oBAEvD,OAAO,CAAC,oBAAU,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;oBAEpC,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC/B,OAAO,CAAC,GAAG,CAAC,+CAA+C,OAAO,CAAC,oBAAU,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;wBACzF,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC;4BACnF,KAAK,EAAE,CAAC,CAAC,KAAK;4BACd,UAAU,EAAE,CAAC,CAAC,UAAU;yBACzB,CAAC,CAAC,CAAC,CAAC;oBACP,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;YAEH,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YAEnB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,8DAA8D,OAAO,CAAC,oBAAU,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1G,CAAC;QACH,CAAC;KACF,CAAM,CAAC;AACV,CAAC;AAKD,SAAgB,iBAAiB,CAAC,IAAU;IAC1C,MAAM,OAAO,GAAG,IAAe,CAAC;IAChC,OAAO,OAAO,CAAC,oBAAU,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAKD,SAAgB,mBAAmB,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAG,IAAe,CAAC;IAChC,IAAI,OAAO,CAAC,oBAAU,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,oBAAU,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAOD,6CAA8F;AAArF,+GAAA,gBAAgB,OAAA;AAAE,uHAAA,wBAAwB,OAAA;AAAE,gHAAA,iBAAiB,OAAA"}

package/dist/matchers.d.ts

@@ -0,0 +1,24 @@
+import type { Page } from '@playwright/test';
+export interface MatcherConfig {
+    timeout?: number;
+    pollInterval?: number;
+}
+declare function toHaveFiredEvent(page: Page, eventName: string, expectedProperties?: Record<string, any>, config?: MatcherConfig): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function notToHaveFiredEvent(page: Page, eventName: string, expectedProperties?: Record<string, any>, config?: MatcherConfig): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toHaveCapturedEvents(page: Page, count?: number): {
+    pass: boolean;
+    message: () => string;
+};
+export declare const matchers: {
+    toHaveFiredEvent: typeof toHaveFiredEvent;
+    notToHaveFiredEvent: typeof notToHaveFiredEvent;
+    toHaveCapturedEvents: typeof toHaveCapturedEvents;
+};
+export {};
+//# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAQ7C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2DD,iBAAe,gBAAgB,CAC7B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxC,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC,CAwCnD;AAED,iBAAe,mBAAmB,CAChC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxC,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC,CAGnD;AAED,iBAAS,oBAAoB,CAC3B,IAAI,EAAE,IAAI,EACV,KAAK,CAAC,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,MAAM,CAAA;CAAE,CAkB1C;AAED,eAAO,MAAM,QAAQ;;;;CAIpB,CAAC"}

package/dist/matchers.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchers = void 0;
+const symbols_1 = require("./symbols");
+const hog_watcher_1 = require("./hog-watcher");
+const DEFAULT_CONFIG = {
+    timeout: 2000,
+    pollInterval: 100,
+};
+function formatProps(props) {
+    return props ? ` with properties ${JSON.stringify(props)}` : '';
+}
+function formatEventList(events) {
+    return events.map(e => e.event).join(', ');
+}
+function buildFailureMessage(eventName, expectedProperties, timeout, events) {
+    const lines = [
+        `Expected page to have fired event "${eventName}"${formatProps(expectedProperties)}, but it did not.`,
+        '',
+        `Waited ${timeout}ms and captured ${events.length} total event(s).`,
+        '',
+    ];
+    if (events.length === 0) {
+        lines.push('No PostHog events were captured at all. Possible reasons:', '  • PostHog is not initialized on the page', '  • The event is sent to a different endpoint', '  • Network interception is not working');
+    }
+    else {
+        const matchingEvents = events.filter(e => e.event === eventName);
+        if (matchingEvents.length > 0) {
+            lines.push(`Found ${matchingEvents.length} event(s) named "${eventName}" but properties didn't match:`, '');
+            matchingEvents.forEach((event, i) => {
+                lines.push(`  Event ${i + 1}: ${JSON.stringify(event.properties, null, 2)}`);
+            });
+            lines.push('', `Expected: ${JSON.stringify(expectedProperties, null, 2)}`);
+        }
+        else {
+            lines.push(`Events captured: [${formatEventList(events)}]`, '', 'The event name did not match any captured events.');
+        }
+    }
+    return lines.join('\n');
+}
+async function toHaveFiredEvent(page, eventName, expectedProperties, config) {
+    const hogPage = page;
+    const { timeout, pollInterval } = { ...DEFAULT_CONFIG, ...config };
+    const debug = (0, symbols_1.isDebugEnabled)();
+    if (debug) {
+        console.log(`[playwright-posthog] Looking for: "${eventName}"${formatProps(expectedProperties)}`);
+    }
+    const startTime = Date.now();
+    let foundEvent;
+    while (Date.now() - startTime < timeout) {
+        const events = hogPage[symbols_1.kHogEvents] || [];
+        foundEvent = events.find((event) => {
+            return event.event === eventName && (0, hog_watcher_1.matchesProperties)(event.properties, expectedProperties);
+        });
+        if (foundEvent) {
+            if (debug) {
+                console.log(`[playwright-posthog] ✓ Found after ${Date.now() - startTime}ms`);
+            }
+            break;
+        }
+        await new Promise(resolve => setTimeout(resolve, pollInterval));
+    }
+    const pass = !!foundEvent;
+    return {
+        pass,
+        message: () => {
+            if (pass) {
+                return `Expected page NOT to have fired event "${eventName}"${formatProps(expectedProperties)}, but it did.`;
+            }
+            return buildFailureMessage(eventName, expectedProperties, timeout, hogPage[symbols_1.kHogEvents] || []);
+        },
+    };
+}
+async function notToHaveFiredEvent(page, eventName, expectedProperties, config) {
+    const result = await toHaveFiredEvent(page, eventName, expectedProperties, config);
+    return { pass: !result.pass, message: result.message };
+}
+function toHaveCapturedEvents(page, count) {
+    const events = page[symbols_1.kHogEvents] || [];
+    const actual = events.length;
+    const pass = count === undefined ? actual > 0 : actual === count;
+    return {
+        pass,
+        message: () => {
+            if (count === undefined) {
+                return pass
+                    ? `Expected no events, but captured ${actual}.`
+                    : `Expected events, but none were captured.`;
+            }
+            return pass
+                ? `Expected NOT to capture ${count} event(s), but did.`
+                : `Expected ${count} event(s), got ${actual}. Events: [${formatEventList(events)}]`;
+        },
+    };
+}
+exports.matchers = {
+    toHaveFiredEvent,
+    notToHaveFiredEvent,
+    toHaveCapturedEvents,
+};
+//# sourceMappingURL=matchers.js.map

package/dist/matchers.js.map

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

package/dist/symbols.d.ts

@@ -0,0 +1,10 @@
+export declare const kHogEvents: unique symbol;
+export declare function isDebugEnabled(): boolean;
+export interface CapturedEvent {
+    event: string;
+    properties?: Record<string, any>;
+    timestamp?: string | number;
+    distinct_id?: string;
+    [key: string]: any;
+}
+//# sourceMappingURL=symbols.d.ts.map

package/dist/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,UAAU,eAAuB,CAAC;AAM/C,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAKD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/symbols.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kHogEvents = void 0;
+exports.isDebugEnabled = isDebugEnabled;
+exports.kHogEvents = Symbol('hog:events');
+function isDebugEnabled() {
+    const debug = process.env.DEBUG;
+    return debug === 'true' || debug === '1' || debug === 'playwright-posthog';
+}
+//# sourceMappingURL=symbols.js.map

package/dist/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":";;;AAeA,wCAGC;AATY,QAAA,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAM/C,SAAgB,cAAc;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;IAChC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,oBAAoB,CAAC;AAC7E,CAAC"}

package/examples/example.spec.ts

@@ -0,0 +1,126 @@
+/**
+ * Example test file demonstrating playwright-posthog usage
+ *
+ * This file shows various patterns for testing PostHog analytics
+ * events in your Playwright tests.
+ */
+
+import { test as base, expect as baseExpect } from '@playwright/test';
+import { withPostHogTracking, matchers } from 'playwright-posthog';
+
+// Setup: extend your test with PostHog tracking
+const test = withPostHogTracking(base);
+const expect = baseExpect.extend(matchers);
+
+test.describe('PostHog Analytics Tracking', () => {
+  test('basic event tracking', async ({ page }) => {
+    await page.goto('https://example.com');
+
+    await page.getByText('Sign Up').click();
+
+    await expect(page).toHaveFiredEvent('signup_clicked');
+  });
+
+  test('event with properties', async ({ page }) => {
+    await page.goto('https://example.com/pricing');
+
+    await page.getByTestId('plan-pro').click();
+
+    await expect(page).toHaveFiredEvent('plan_selected', {
+      plan: 'pro',
+      price: 99.99,
+    });
+  });
+
+  test('multiple events in sequence', async ({ page }) => {
+    await page.goto('https://example.com/product/123');
+
+    await expect(page).toHaveFiredEvent('product_viewed', {
+      product_id: '123',
+    });
+
+    await page.getByText('Add to Cart').click();
+
+    await expect(page).toHaveFiredEvent('add_to_cart', {
+      product_id: '123',
+    });
+
+    await page.getByText('Checkout').click();
+    await expect(page).toHaveFiredEvent('checkout_started');
+  });
+
+  test('negative assertion - event should NOT fire', async ({ page }) => {
+    await page.goto('https://example.com');
+
+    await page.getByText('About').click();
+
+    await expect(page).notToHaveFiredEvent('error_occurred');
+  });
+
+  test('custom timeout for slow events', async ({ page }) => {
+    await page.goto('https://example.com');
+
+    await page.getByText('Submit').click();
+
+    await expect(page).toHaveFiredEvent(
+      'form_submitted',
+      { form_type: 'contact' },
+      { timeout: 5000 }
+    );
+  });
+
+  test('partial property matching', async ({ page }) => {
+    await page.goto('https://example.com/settings');
+
+    await page.getByLabel('Theme').selectOption('dark');
+    await page.getByText('Save').click();
+
+    await expect(page).toHaveFiredEvent('settings_updated', {
+      theme: 'dark',
+    });
+  });
+
+  test('checking event count', async ({ page }) => {
+    await page.goto('https://example.com');
+
+    await expect(page).toHaveCapturedEvents();
+
+    await expect(page).toHaveCapturedEvents(3);
+  });
+});
+
+test.describe('Advanced Usage', () => {
+  test('using utility functions', async ({ page }) => {
+    const { getCapturedEvents, clearCapturedEvents } = await import('playwright-posthog');
+
+    await page.goto('https://example.com/step1');
+
+    let events = getCapturedEvents(page);
+    console.log('Step 1 events:', events);
+
+    clearCapturedEvents(page);
+
+    await page.goto('https://example.com/step2');
+
+    events = getCapturedEvents(page);
+    console.log('Step 2 events:', events);
+
+    await expect(page).toHaveFiredEvent('step2_viewed');
+  });
+
+  test('complex property matching', async ({ page }) => {
+    await page.goto('https://example.com/checkout');
+
+    await page.fill('[name=email]', 'user@example.com');
+    await page.fill('[name=card]', '4242424242424242');
+    await page.getByText('Pay').click();
+
+    await expect(page).toHaveFiredEvent('payment_submitted', {
+      email: 'user@example.com',
+      payment_method: 'card',
+      metadata: {
+        source: 'web',
+      },
+    });
+  });
+});

package/examples/playwright.config.ts

@@ -0,0 +1,69 @@
+/**
+ * Example Playwright configuration for playwright-posthog
+ *
+ * See https://playwright.dev/docs/test-configuration
+ */
+
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+
+  // Run tests in files in parallel
+  fullyParallel: true,
+
+  // Fail the build on CI if you accidentally left test.only in the source code
+  forbidOnly: !!process.env.CI,
+
+  // Retry on CI only
+  retries: process.env.CI ? 2 : 0,
+
+  // Opt out of parallel tests on CI
+  workers: process.env.CI ? 1 : undefined,
+
+  // Reporter to use
+  reporter: 'html',
+
+  use: {
+    // Base URL to use in actions like `await page.goto('/')`
+    baseURL: 'http://localhost:3000',
+
+    // Collect trace when retrying the failed test
+    trace: 'on-first-retry',
+  },
+
+  // Configure projects for major browsers
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+
+    // Test against mobile viewports
+    {
+      name: 'Mobile Chrome',
+      use: { ...devices['Pixel 5'] },
+    },
+    {
+      name: 'Mobile Safari',
+      use: { ...devices['iPhone 12'] },
+    },
+  ],
+
+  // Run your local dev server before starting the tests
+  webServer: {
+    command: 'npm run dev',
+    url: 'http://localhost:3000',
+    reuseExistingServer: !process.env.CI,
+  },
+});

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "playwright-posthog",
+  "version": "1.0.0",
+  "description": "Test PostHog analytics events in your Playwright tests with type-safe assertions and automatic event capture",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && cp src/global.d.ts dist/global.d.ts",
+    "clean": "rm -rf dist",
+    "rebuild": "npm run clean && npm run build",
+    "prepublishOnly": "npm run rebuild",
+    "test": "npm run build && playwright test",
+    "test:ui": "npm run build && playwright test --ui",
+    "test:debug": "npm run build && playwright test --debug",
+    "serve": "npx http-server test-app -p 8080"
+  },
+  "keywords": [
+    "playwright",
+    "posthog",
+    "analytics",
+    "testing",
+    "e2e",
+    "tracking",
+    "test",
+    "fixture",
+    "matcher",
+    "assertions",
+    "event-tracking",
+    "product-analytics",
+    "typescript"
+  ],
+  "author": "playwright-posthog contributors",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.40.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.40.0",
+    "@types/node": "^25.0.3",
+    "http-server": "^14.1.1",
+    "typescript": "^5.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yourusername/playwright-posthog.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/playwright-posthog/issues"
+  },
+  "homepage": "https://github.com/yourusername/playwright-posthog#readme"
+}