@chaos-maker/playwright 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+# @chaos-maker/playwright
+
+Playwright adapter for [`@chaos-maker/core`](../core/). One-line chaos injection in E2E tests.
+
+## Install
+
+```bash
+npm install @chaos-maker/core @chaos-maker/playwright
+```
+
+Both packages are required — `@chaos-maker/playwright` loads the core UMD bundle into the browser page.
+
+## Usage
+
+### Direct API
+
+```ts
+import { test, expect } from '@playwright/test';
+import { injectChaos, removeChaos, getChaosLog } from '@chaos-maker/playwright';
+
+test('shows error when API fails', async ({ page }) => {
+  await injectChaos(page, {
+    network: {
+      failures: [{ urlPattern: '/api/data', statusCode: 503, probability: 1.0 }]
+    }
+  });
+
+  await page.goto('/dashboard');
+  await expect(page.getByText('Something went wrong')).toBeVisible();
+
+  // Check what chaos was applied
+  const log = await getChaosLog(page);
+  expect(log.some(e => e.type === 'network:failure' && e.applied)).toBe(true);
+});
+```
+
+### Test Fixture
+
+For automatic cleanup, use the built-in fixture:
+
+```ts
+import { test, expect } from '@chaos-maker/playwright/fixture';
+
+test('handles slow network', async ({ page, chaos }) => {
+  await chaos.inject({
+    network: {
+      latencies: [{ urlPattern: '/api/', delayMs: 3000, probability: 1.0 }]
+    }
+  });
+
+  await page.goto('/');
+  await expect(page.getByText('Loading')).toBeVisible();
+
+  const log = await chaos.getLog();
+  expect(log.some(e => e.type === 'network:latency' && e.applied)).toBe(true);
+});
+// chaos.remove() is called automatically after each test
+```
+
+### With Presets
+
+```ts
+import { test, expect } from '@playwright/test';
+import { presets } from '@chaos-maker/core';
+import { injectChaos } from '@chaos-maker/playwright';
+
+test('app works offline', async ({ page }) => {
+  await injectChaos(page, presets.offlineMode);
+  await page.goto('/');
+  await expect(page.getByText('No connection')).toBeVisible();
+});
+```
+
+### With Config Builder
+
+```ts
+import { test } from '@playwright/test';
+import { ChaosConfigBuilder } from '@chaos-maker/core';
+import { injectChaos } from '@chaos-maker/playwright';
+
+const config = new ChaosConfigBuilder()
+  .failRequests('/api/checkout', 500, 0.5)
+  .addLatency('/api/', 2000, 1.0)
+  .build();
+
+test('checkout handles combined chaos', async ({ page }) => {
+  await injectChaos(page, config);
+  await page.goto('/checkout');
+  // ...
+});
+```
+
+## API
+
+### `injectChaos(page, config)`
+
+Inject chaos into a Playwright page. **Call before `page.goto()`** to ensure all network requests are intercepted from the start.
+
+- `page` — Playwright `Page` instance
+- `config` — `ChaosConfig` object (see [@chaos-maker/core](../core/) for full config reference)
+
+### `removeChaos(page)`
+
+Stop chaos and restore original `fetch`/`XHR`/DOM behavior.
+
+### `getChaosLog(page)`
+
+Retrieve the chaos event log from the page. Returns `ChaosEvent[]` — every chaos check emitted since injection, with `applied: true/false`.
+
+### Fixture: `chaos`
+
+Available when importing `test` from `@chaos-maker/playwright/fixture`:
+
+- `chaos.inject(config)` — same as `injectChaos(page, config)`
+- `chaos.remove()` — same as `removeChaos(page)` (also called automatically after each test)
+- `chaos.getLog()` — same as `getChaosLog(page)`
+
+## License
+
+[MIT](../../LICENSE)

package/dist/chunk-BZSMGQHL.js

@@ -0,0 +1,45 @@
+// src/index.ts
+import { resolve, dirname } from "path";
+import { createRequire } from "module";
+import { fileURLToPath } from "url";
+var cachedUmdPath = null;
+function getCoreUmdPath() {
+  if (cachedUmdPath) return cachedUmdPath;
+  const currentDir = typeof __dirname !== "undefined" ? __dirname : dirname(fileURLToPath(import.meta.url));
+  const req = createRequire(resolve(currentDir, "package.json"));
+  const coreEntry = req.resolve("@chaos-maker/core");
+  const coreDistDir = dirname(coreEntry);
+  cachedUmdPath = resolve(coreDistDir, "chaos-maker.umd.js");
+  return cachedUmdPath;
+}
+async function injectChaos(page, config) {
+  const umdPath = getCoreUmdPath();
+  await page.addInitScript((cfg) => {
+    const win = globalThis;
+    win.__CHAOS_CONFIG__ = cfg;
+  }, config);
+  await page.addInitScript({ path: umdPath });
+}
+async function removeChaos(page) {
+  await page.evaluate(() => {
+    const win = globalThis;
+    if (win.chaosUtils) {
+      win.chaosUtils.stop();
+    }
+  });
+}
+async function getChaosLog(page) {
+  return page.evaluate(() => {
+    const win = globalThis;
+    if (win.chaosUtils) {
+      return win.chaosUtils.getLog();
+    }
+    return [];
+  });
+}
+
+export {
+  injectChaos,
+  removeChaos,
+  getChaosLog
+};

package/dist/fixture.cjs

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/fixture.ts
+var fixture_exports = {};
+__export(fixture_exports, {
+  expect: () => import_test2.expect,
+  test: () => test
+});
+module.exports = __toCommonJS(fixture_exports);
+var import_test = require("@playwright/test");
+
+// src/index.ts
+var import_path = require("path");
+var import_module = require("module");
+var import_url = require("url");
+var import_meta = {};
+var cachedUmdPath = null;
+function getCoreUmdPath() {
+  if (cachedUmdPath) return cachedUmdPath;
+  const currentDir = typeof __dirname !== "undefined" ? __dirname : (0, import_path.dirname)((0, import_url.fileURLToPath)(import_meta.url));
+  const req = (0, import_module.createRequire)((0, import_path.resolve)(currentDir, "package.json"));
+  const coreEntry = req.resolve("@chaos-maker/core");
+  const coreDistDir = (0, import_path.dirname)(coreEntry);
+  cachedUmdPath = (0, import_path.resolve)(coreDistDir, "chaos-maker.umd.js");
+  return cachedUmdPath;
+}
+async function injectChaos(page, config) {
+  const umdPath = getCoreUmdPath();
+  await page.addInitScript((cfg) => {
+    const win = globalThis;
+    win.__CHAOS_CONFIG__ = cfg;
+  }, config);
+  await page.addInitScript({ path: umdPath });
+}
+async function removeChaos(page) {
+  await page.evaluate(() => {
+    const win = globalThis;
+    if (win.chaosUtils) {
+      win.chaosUtils.stop();
+    }
+  });
+}
+async function getChaosLog(page) {
+  return page.evaluate(() => {
+    const win = globalThis;
+    if (win.chaosUtils) {
+      return win.chaosUtils.getLog();
+    }
+    return [];
+  });
+}
+
+// src/fixture.ts
+var import_test2 = require("@playwright/test");
+var test = import_test.test.extend({
+  chaos: async ({ page }, use) => {
+    const fixture = {
+      inject: (config) => injectChaos(page, config),
+      remove: () => removeChaos(page),
+      getLog: () => getChaosLog(page)
+    };
+    await use(fixture);
+    await removeChaos(page);
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  expect,
+  test
+});

package/dist/fixture.d.cts

@@ -0,0 +1,34 @@
+import * as _playwright_test from '@playwright/test';
+export { expect } from '@playwright/test';
+import { ChaosConfig, ChaosEvent } from '@chaos-maker/core';
+export { ChaosConfig, ChaosEvent } from '@chaos-maker/core';
+
+interface ChaosFixture {
+    inject: (config: ChaosConfig) => Promise<void>;
+    remove: () => Promise<void>;
+    getLog: () => Promise<ChaosEvent[]>;
+}
+/**
+ * Extended Playwright test with a `chaos` fixture.
+ *
+ * @example
+ * ```ts
+ * import { test, expect } from '@chaos-maker/playwright/fixture';
+ *
+ * test('handles API failure', async ({ page, chaos }) => {
+ *   await chaos.inject({
+ *     network: {
+ *       failures: [{ urlPattern: '/api', statusCode: 503, probability: 1.0 }]
+ *     }
+ *   });
+ *   await page.goto('/');
+ *   const log = await chaos.getLog();
+ *   expect(log.some(e => e.type === 'network:failure' && e.applied)).toBe(true);
+ * });
+ * ```
+ */
+declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & {
+    chaos: ChaosFixture;
+}, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
+
+export { type ChaosFixture, test };

package/dist/fixture.d.ts

@@ -0,0 +1,34 @@
+import * as _playwright_test from '@playwright/test';
+export { expect } from '@playwright/test';
+import { ChaosConfig, ChaosEvent } from '@chaos-maker/core';
+export { ChaosConfig, ChaosEvent } from '@chaos-maker/core';
+
+interface ChaosFixture {
+    inject: (config: ChaosConfig) => Promise<void>;
+    remove: () => Promise<void>;
+    getLog: () => Promise<ChaosEvent[]>;
+}
+/**
+ * Extended Playwright test with a `chaos` fixture.
+ *
+ * @example
+ * ```ts
+ * import { test, expect } from '@chaos-maker/playwright/fixture';
+ *
+ * test('handles API failure', async ({ page, chaos }) => {
+ *   await chaos.inject({
+ *     network: {
+ *       failures: [{ urlPattern: '/api', statusCode: 503, probability: 1.0 }]
+ *     }
+ *   });
+ *   await page.goto('/');
+ *   const log = await chaos.getLog();
+ *   expect(log.some(e => e.type === 'network:failure' && e.applied)).toBe(true);
+ * });
+ * ```
+ */
+declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & {
+    chaos: ChaosFixture;
+}, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
+
+export { type ChaosFixture, test };

package/dist/fixture.js

@@ -0,0 +1,24 @@
+import {
+  getChaosLog,
+  injectChaos,
+  removeChaos
+} from "./chunk-BZSMGQHL.js";
+
+// src/fixture.ts
+import { test as base } from "@playwright/test";
+import { expect } from "@playwright/test";
+var test = base.extend({
+  chaos: async ({ page }, use) => {
+    const fixture = {
+      inject: (config) => injectChaos(page, config),
+      remove: () => removeChaos(page),
+      getLog: () => getChaosLog(page)
+    };
+    await use(fixture);
+    await removeChaos(page);
+  }
+});
+export {
+  expect,
+  test
+};

package/dist/index.cjs

@@ -0,0 +1,72 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  getChaosLog: () => getChaosLog,
+  injectChaos: () => injectChaos,
+  removeChaos: () => removeChaos
+});
+module.exports = __toCommonJS(index_exports);
+var import_path = require("path");
+var import_module = require("module");
+var import_url = require("url");
+var import_meta = {};
+var cachedUmdPath = null;
+function getCoreUmdPath() {
+  if (cachedUmdPath) return cachedUmdPath;
+  const currentDir = typeof __dirname !== "undefined" ? __dirname : (0, import_path.dirname)((0, import_url.fileURLToPath)(import_meta.url));
+  const req = (0, import_module.createRequire)((0, import_path.resolve)(currentDir, "package.json"));
+  const coreEntry = req.resolve("@chaos-maker/core");
+  const coreDistDir = (0, import_path.dirname)(coreEntry);
+  cachedUmdPath = (0, import_path.resolve)(coreDistDir, "chaos-maker.umd.js");
+  return cachedUmdPath;
+}
+async function injectChaos(page, config) {
+  const umdPath = getCoreUmdPath();
+  await page.addInitScript((cfg) => {
+    const win = globalThis;
+    win.__CHAOS_CONFIG__ = cfg;
+  }, config);
+  await page.addInitScript({ path: umdPath });
+}
+async function removeChaos(page) {
+  await page.evaluate(() => {
+    const win = globalThis;
+    if (win.chaosUtils) {
+      win.chaosUtils.stop();
+    }
+  });
+}
+async function getChaosLog(page) {
+  return page.evaluate(() => {
+    const win = globalThis;
+    if (win.chaosUtils) {
+      return win.chaosUtils.getLog();
+    }
+    return [];
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getChaosLog,
+  injectChaos,
+  removeChaos
+});

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+import { Page } from '@playwright/test';
+import { ChaosEvent, ChaosConfig } from '@chaos-maker/core';
+export { ChaosConfig, ChaosEvent } from '@chaos-maker/core';
+
+/**
+ * Inject chaos into a Playwright page. Call before `page.goto()` to ensure
+ * all network requests are intercepted from the start.
+ *
+ * @example
+ * ```ts
+ * import { injectChaos } from '@chaos-maker/playwright';
+ *
+ * test('handles API failure', async ({ page }) => {
+ *   await injectChaos(page, {
+ *     network: {
+ *       failures: [{ urlPattern: '/api', statusCode: 503, probability: 1.0 }]
+ *     }
+ *   });
+ *   await page.goto('/');
+ * });
+ * ```
+ */
+declare function injectChaos(page: Page, config: ChaosConfig): Promise<void>;
+/**
+ * Remove chaos from a Playwright page. Restores original fetch/XHR/DOM behavior.
+ */
+declare function removeChaos(page: Page): Promise<void>;
+/**
+ * Retrieve the chaos event log from a Playwright page.
+ * Returns all events emitted since chaos was injected.
+ */
+declare function getChaosLog(page: Page): Promise<ChaosEvent[]>;
+
+export { getChaosLog, injectChaos, removeChaos };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { Page } from '@playwright/test';
+import { ChaosEvent, ChaosConfig } from '@chaos-maker/core';
+export { ChaosConfig, ChaosEvent } from '@chaos-maker/core';
+
+/**
+ * Inject chaos into a Playwright page. Call before `page.goto()` to ensure
+ * all network requests are intercepted from the start.
+ *
+ * @example
+ * ```ts
+ * import { injectChaos } from '@chaos-maker/playwright';
+ *
+ * test('handles API failure', async ({ page }) => {
+ *   await injectChaos(page, {
+ *     network: {
+ *       failures: [{ urlPattern: '/api', statusCode: 503, probability: 1.0 }]
+ *     }
+ *   });
+ *   await page.goto('/');
+ * });
+ * ```
+ */
+declare function injectChaos(page: Page, config: ChaosConfig): Promise<void>;
+/**
+ * Remove chaos from a Playwright page. Restores original fetch/XHR/DOM behavior.
+ */
+declare function removeChaos(page: Page): Promise<void>;
+/**
+ * Retrieve the chaos event log from a Playwright page.
+ * Returns all events emitted since chaos was injected.
+ */
+declare function getChaosLog(page: Page): Promise<ChaosEvent[]>;
+
+export { getChaosLog, injectChaos, removeChaos };

package/dist/index.js

@@ -0,0 +1,10 @@
+import {
+  getChaosLog,
+  injectChaos,
+  removeChaos
+} from "./chunk-BZSMGQHL.js";
+export {
+  getChaosLog,
+  injectChaos,
+  removeChaos
+};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@chaos-maker/playwright",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Playwright adapter for @chaos-maker/core — one-line chaos injection in E2E tests",
+  "keywords": [
+    "chaos-engineering",
+    "playwright",
+    "testing",
+    "e2e-testing",
+    "resilience"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jvjithin/chaos-maker.git",
+    "directory": "packages/playwright"
+  },
+  "homepage": "https://github.com/jvjithin/chaos-maker",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./fixture": {
+      "import": {
+        "types": "./dist/fixture.d.ts",
+        "default": "./dist/fixture.js"
+      },
+      "require": {
+        "types": "./dist/fixture.d.ts",
+        "default": "./dist/fixture.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@chaos-maker/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.45.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest"
+  }
+}