@chaos-maker/playwright 0.3.0 → 0.5.0

package/README.md

@@ -59,6 +59,27 @@ test('handles slow network', async ({ page, chaos }) => {
 
 ### With Presets
 
+Drop a built-in preset by name with the declarative `presets` field:
+
+```ts
+await injectChaos(page, { presets: ['slow-api'] });
+```
+
+Register your own bundle inline via `customPresets`:
+
+```ts
+await injectChaos(page, {
+  customPresets: {
+    'team-flow': {
+      network: { failures: [{ urlPattern: '/checkout', statusCode: 503, probability: 1 }] },
+    },
+  },
+  presets: ['team-flow'],
+});
+```
+
+The legacy spread style still works for migration:
+
 ```ts
 import { test, expect } from '@playwright/test';
 import { presets } from '@chaos-maker/core';
@@ -90,6 +111,71 @@ test('checkout handles combined chaos', async ({ page }) => {
 });
 ```
 
+### Rule Groups
+
+Use Rule Groups to toggle a set of rules during a test without reinjecting chaos.
+
+```ts
+import { test, expect } from '@playwright/test';
+import { ChaosConfigBuilder } from '@chaos-maker/core';
+import {
+  injectChaos,
+  enableGroup,
+  disableGroup,
+  enableSWGroup,
+  disableSWGroup,
+} from '@chaos-maker/playwright';
+
+test('toggles checkout chaos', async ({ page }) => {
+  const config = new ChaosConfigBuilder()
+    .defineGroup('payments', { enabled: false })
+    .inGroup('payments')
+    .failRequests('/api/pay', 503, 1)
+    .build();
+
+  await injectChaos(page, config);
+  await page.goto('/checkout');
+
+  await enableGroup(page, 'payments');
+  await expect(page.getByText('Try again')).toBeVisible();
+
+  await disableGroup(page, 'payments');
+});
+```
+
+With the fixture, the same helpers are available as `chaos.enableGroup(name)` and `chaos.disableGroup(name)`.
+
+For Service Worker rules, use the SW helpers after `injectSWChaos`:
+
+```ts
+await enableSWGroup(page, 'payments');
+await disableSWGroup(page, 'payments');
+```
+
+Browser-side `enableGroup` and `disableGroup` affect page rules from `injectChaos`. `enableSWGroup` and `disableSWGroup` affect Service Worker rules from `injectSWChaos`.
+
+### SSE and GraphQL
+
+```ts
+await injectChaos(page, {
+  seed: 42,
+  sse: {
+    drops: [{ urlPattern: '/events', eventType: 'token', probability: 0.1 }],
+  },
+  network: {
+    failures: [{
+      urlPattern: '/graphql',
+      graphqlOperation: 'GetUser',
+      statusCode: 503,
+      probability: 1,
+    }],
+  },
+});
+await page.goto('/dashboard');
+```
+
+SSE chaos and GraphQL operation matching use the same pre-navigation `injectChaos()` timing as fetch, XHR, and WebSocket chaos.
+
 ## API
 
 ### `injectChaos(page, config, opts?)`
@@ -111,6 +197,14 @@ Stop chaos and restore original `fetch`/`XHR`/DOM behavior.
 
 Retrieve the chaos event log from the page. Returns `ChaosEvent[]` — every chaos check emitted since injection, with `applied: true/false`.
 
+### `enableGroup(page, name)` / `disableGroup(page, name)`
+
+Toggle a browser-side Rule Group at runtime.
+
+### `enableSWGroup(page, name, opts?)` / `disableSWGroup(page, name, opts?)`
+
+Toggle a Service Worker Rule Group at runtime. Pass `opts.timeoutMs` to override the Service Worker acknowledgement timeout.
+
 ### Fixture: `chaos`
 
 Available when importing `test` from `@chaos-maker/playwright/fixture`:
@@ -118,6 +212,29 @@ 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)`
+- `chaos.enableGroup(name)` — same as `enableGroup(page, name)`
+- `chaos.disableGroup(name)` — same as `disableGroup(page, name)`
+- `chaos.enableSWGroup(name, opts?)` — same as `enableSWGroup(page, name, opts)`
+- `chaos.disableSWGroup(name, opts?)` — same as `disableSWGroup(page, name, opts)`
+
+## Validation
+
+`injectChaos` validates the config from Node BEFORE any page touch. A malformed config throws `ChaosConfigError` synchronously from the test runner — your test fails before navigation, not in the browser console. `ChaosConfigError.issues` is a structured `ValidationIssue[]` with `path`, `code`, `ruleType`, and optional `expected` / `received`. See the [Rule Validation concept page](https://chaos-maker-dev.github.io/chaos-maker/concepts/validation/).
+
+```ts
+import { injectChaos, ChaosConfigError } from '@chaos-maker/playwright';
+
+try {
+  await injectChaos(page, config, {
+    validation: { unknownFields: 'warn' },
+  });
+} catch (e) {
+  if (e instanceof ChaosConfigError) {
+    for (const issue of e.issues) console.error(issue.path, issue.code, issue.message);
+  }
+  throw e;
+}
+```
 
 ## Debugging with trace
 
@@ -167,6 +284,49 @@ test('with direct API', async ({ page }, testInfo) => {
 });
 ```
 
+## Service Worker chaos
+
+Intercept SW-originated fetches. Requires one line in your service-worker script.
+
+```js
+// user's sw.js (classic)
+importScripts('/chaos-maker-sw.js');
+```
+
+```ts
+import {
+  injectSWChaos,
+  removeSWChaos,
+  getSWChaosLog,
+  enableSWGroup,
+  disableSWGroup,
+} from '@chaos-maker/playwright';
+
+test('SW-fetched /api returns 503', async ({ page }) => {
+  await page.goto('/app-with-sw/');
+  // wait for controller after your app's SW registration
+  await injectSWChaos(page, {
+    groups: [{ name: 'payments', enabled: false }],
+    network: {
+      failures: [{ urlPattern: '/api/data', statusCode: 503, probability: 1, group: 'payments' }],
+    },
+    seed: 1,
+  });
+  await enableSWGroup(page, 'payments');
+  await page.click('#trigger');
+  const log = await getSWChaosLog(page);
+  expect(log.some(e => e.type === 'network:failure' && e.applied)).toBe(true);
+  await disableSWGroup(page, 'payments');
+  await removeSWChaos(page);
+});
+```
+
+Two artifacts ship in `@chaos-maker/core`:
+- `dist/sw.js` — IIFE bundle for classic SWs (`importScripts('/chaos-maker-sw.js')`).
+- `dist/sw.mjs` — ESM bundle for module SWs (`import { installChaosSW } from '/chaos-maker-sw.mjs'`).
+
+Serve whichever your SW type uses at a URL reachable from the service-worker scope.
+
 ## License
 
 [MIT](../../LICENSE)

package/dist/{chunk-XVP3BFFM.js → chunk-IJDMHBUQ.js}

@@ -1,4 +1,5 @@
 // src/index.ts
+import { serializeForTransport, validateChaosConfig as validateChaosConfig2 } from "@chaos-maker/core";
 import { resolve, dirname } from "path";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
@@ -49,6 +50,7 @@ function truncate(s, max) {
   return `\u2026${s.slice(-(max - 1))}`;
 }
 function shouldEmitStep(event, verbose) {
+  if (event.type === "debug") return false;
   if (event.applied) return true;
   return verbose;
 }
@@ -107,6 +109,100 @@ async function createTraceReporter(page, testInfo, opts = {}) {
   };
 }
 
+// src/index.ts
+import { Logger } from "@chaos-maker/core";
+import { validateChaosConfig as validateChaosConfig3, ChaosConfigError } from "@chaos-maker/core";
+
+// src/sw.ts
+import { validateChaosConfig, SW_BRIDGE_SOURCE } from "@chaos-maker/core";
+var BRIDGE_INIT_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.sw.bridgeInit");
+var DEFAULT_SW_TOGGLE_TIMEOUT = 2e3;
+async function ensurePageBridge(page) {
+  if (!page[BRIDGE_INIT_KEY]) {
+    await page.addInitScript({ content: SW_BRIDGE_SOURCE });
+    page[BRIDGE_INIT_KEY] = true;
+  }
+  await page.evaluate(SW_BRIDGE_SOURCE).catch(() => {
+  });
+}
+async function injectSWChaos(page, config, opts = {}) {
+  const validated = validateChaosConfig(config, opts.validation);
+  const timeoutMs = opts.timeoutMs ?? 1e4;
+  await ensurePageBridge(page);
+  const result = await page.evaluate(
+    async ({ cfg, timeoutMs: timeoutMs2 }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) throw new Error("[chaos-maker] SW bridge missing from page \u2014 ensurePageBridge failed");
+      return await bridge.apply(cfg, timeoutMs2);
+    },
+    { cfg: validated, timeoutMs }
+  );
+  return result;
+}
+async function removeSWChaos(page, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5e3;
+  await page.evaluate(
+    async ({ timeoutMs: timeoutMs2 }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) return;
+      await bridge.stop(timeoutMs2);
+      bridge.clearLocalLog();
+    },
+    { timeoutMs }
+  ).catch(() => {
+  });
+}
+async function enableSWGroup(page, name, opts = {}) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await toggleSWGroup(page, nameNorm, true, opts);
+}
+async function disableSWGroup(page, name, opts = {}) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await toggleSWGroup(page, nameNorm, false, opts);
+}
+async function toggleSWGroup(page, name, enabled, opts) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_SW_TOGGLE_TIMEOUT;
+  await ensurePageBridge(page);
+  await page.evaluate(
+    async ({ n, e, t }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) throw new Error("[chaos-maker] SW bridge missing \u2014 ensurePageBridge failed");
+      await bridge.toggleGroup(n, e, t);
+    },
+    { n: name, e: enabled, t: timeoutMs }
+  );
+}
+async function getSWChaosLog(page) {
+  return page.evaluate(() => {
+    const bridge = globalThis.__chaosMakerSWBridge;
+    if (!bridge) return [];
+    return bridge.getLocalLog();
+  });
+}
+async function getSWChaosLogFromSW(page, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5e3;
+  return page.evaluate(
+    async ({ timeoutMs: timeoutMs2 }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) return [];
+      return bridge.getRemoteLog(timeoutMs2);
+    },
+    { timeoutMs }
+  );
+}
+
 // src/index.ts
 var cachedUmdPath = null;
 function getCoreUmdPath() {
@@ -120,6 +216,7 @@ function getCoreUmdPath() {
 }
 var TRACE_HANDLE_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.traceHandle");
 async function injectChaos(page, config, opts = {}) {
+  const validated = validateChaosConfig2(config, opts.validation);
   const umdPath = getCoreUmdPath();
   const tracingEnabled = resolveTracing(opts);
   if (tracingEnabled) {
@@ -134,10 +231,11 @@ async function injectChaos(page, config, opts = {}) {
       page[TRACE_HANDLE_KEY] = handle;
     }
   }
+  const serialized = serializeForTransport(validated);
   await page.addInitScript((cfg) => {
     const win = globalThis;
     win.__CHAOS_CONFIG__ = cfg;
-  }, config);
+  }, serialized);
   await page.addInitScript({ path: umdPath });
 }
 function resolveTracing(opts) {
@@ -175,6 +273,50 @@ async function getChaosLog(page) {
     return [];
   });
 }
+async function enableGroup(page, name) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await page.evaluate(({ n }) => {
+    const utils = globalThis.chaosUtils;
+    if (!utils || !utils.instance) {
+      throw new Error("[chaos-maker] no chaos instance on page \u2014 call injectChaos first");
+    }
+    if (typeof utils.enableGroup !== "function") {
+      throw new Error("[chaos-maker] enableGroup API unavailable");
+    }
+    const result = utils.enableGroup(n);
+    if (result && result.success === false) {
+      throw new Error(`[chaos-maker] enableGroup('${n}') failed: ${result.message}`);
+    }
+  }, { n: nameNorm });
+}
+async function disableGroup(page, name) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await page.evaluate(({ n }) => {
+    const utils = globalThis.chaosUtils;
+    if (!utils || !utils.instance) {
+      throw new Error("[chaos-maker] no chaos instance on page \u2014 call injectChaos first");
+    }
+    if (typeof utils.disableGroup !== "function") {
+      throw new Error("[chaos-maker] disableGroup API unavailable");
+    }
+    const result = utils.disableGroup(n);
+    if (result && result.success === false) {
+      throw new Error(`[chaos-maker] disableGroup('${n}') failed: ${result.message}`);
+    }
+  }, { n: nameNorm });
+}
 async function getChaosSeed(page) {
   return page.evaluate(() => {
     const win = globalThis;
@@ -186,8 +328,19 @@ async function getChaosSeed(page) {
 }
 
 export {
+  injectSWChaos,
+  removeSWChaos,
+  enableSWGroup,
+  disableSWGroup,
+  getSWChaosLog,
+  getSWChaosLogFromSW,
   injectChaos,
   removeChaos,
   getChaosLog,
-  getChaosSeed
+  enableGroup,
+  disableGroup,
+  getChaosSeed,
+  Logger,
+  validateChaosConfig3 as validateChaosConfig,
+  ChaosConfigError
 };

package/dist/fixture.cjs

@@ -27,6 +27,7 @@ module.exports = __toCommonJS(fixture_exports);
 var import_test2 = require("@playwright/test");
 
 // src/index.ts
+var import_core2 = require("@chaos-maker/core");
 var import_path = require("path");
 var import_module = require("module");
 var import_url = require("url");
@@ -77,6 +78,7 @@ function truncate(s, max) {
   return `\u2026${s.slice(-(max - 1))}`;
 }
 function shouldEmitStep(event, verbose) {
+  if (event.type === "debug") return false;
   if (event.applied) return true;
   return verbose;
 }
@@ -135,6 +137,55 @@ async function createTraceReporter(page, testInfo, opts = {}) {
   };
 }
 
+// src/index.ts
+var import_core3 = require("@chaos-maker/core");
+var import_core4 = require("@chaos-maker/core");
+
+// src/sw.ts
+var import_core = require("@chaos-maker/core");
+var BRIDGE_INIT_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.sw.bridgeInit");
+var DEFAULT_SW_TOGGLE_TIMEOUT = 2e3;
+async function ensurePageBridge(page) {
+  if (!page[BRIDGE_INIT_KEY]) {
+    await page.addInitScript({ content: import_core.SW_BRIDGE_SOURCE });
+    page[BRIDGE_INIT_KEY] = true;
+  }
+  await page.evaluate(import_core.SW_BRIDGE_SOURCE).catch(() => {
+  });
+}
+async function enableSWGroup(page, name, opts = {}) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await toggleSWGroup(page, nameNorm, true, opts);
+}
+async function disableSWGroup(page, name, opts = {}) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await toggleSWGroup(page, nameNorm, false, opts);
+}
+async function toggleSWGroup(page, name, enabled, opts) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_SW_TOGGLE_TIMEOUT;
+  await ensurePageBridge(page);
+  await page.evaluate(
+    async ({ n, e, t }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) throw new Error("[chaos-maker] SW bridge missing \u2014 ensurePageBridge failed");
+      await bridge.toggleGroup(n, e, t);
+    },
+    { n: name, e: enabled, t: timeoutMs }
+  );
+}
+
 // src/index.ts
 var import_meta = {};
 var cachedUmdPath = null;
@@ -149,6 +200,7 @@ function getCoreUmdPath() {
 }
 var TRACE_HANDLE_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.traceHandle");
 async function injectChaos(page, config, opts = {}) {
+  const validated = (0, import_core2.validateChaosConfig)(config, opts.validation);
   const umdPath = getCoreUmdPath();
   const tracingEnabled = resolveTracing(opts);
   if (tracingEnabled) {
@@ -163,10 +215,11 @@ async function injectChaos(page, config, opts = {}) {
       page[TRACE_HANDLE_KEY] = handle;
     }
   }
+  const serialized = (0, import_core2.serializeForTransport)(validated);
   await page.addInitScript((cfg) => {
     const win = globalThis;
     win.__CHAOS_CONFIG__ = cfg;
-  }, config);
+  }, serialized);
   await page.addInitScript({ path: umdPath });
 }
 function resolveTracing(opts) {
@@ -204,6 +257,50 @@ async function getChaosLog(page) {
     return [];
   });
 }
+async function enableGroup(page, name) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await page.evaluate(({ n }) => {
+    const utils = globalThis.chaosUtils;
+    if (!utils || !utils.instance) {
+      throw new Error("[chaos-maker] no chaos instance on page \u2014 call injectChaos first");
+    }
+    if (typeof utils.enableGroup !== "function") {
+      throw new Error("[chaos-maker] enableGroup API unavailable");
+    }
+    const result = utils.enableGroup(n);
+    if (result && result.success === false) {
+      throw new Error(`[chaos-maker] enableGroup('${n}') failed: ${result.message}`);
+    }
+  }, { n: nameNorm });
+}
+async function disableGroup(page, name) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await page.evaluate(({ n }) => {
+    const utils = globalThis.chaosUtils;
+    if (!utils || !utils.instance) {
+      throw new Error("[chaos-maker] no chaos instance on page \u2014 call injectChaos first");
+    }
+    if (typeof utils.disableGroup !== "function") {
+      throw new Error("[chaos-maker] disableGroup API unavailable");
+    }
+    const result = utils.disableGroup(n);
+    if (result && result.success === false) {
+      throw new Error(`[chaos-maker] disableGroup('${n}') failed: ${result.message}`);
+    }
+  }, { n: nameNorm });
+}
 async function getChaosSeed(page) {
   return page.evaluate(() => {
     const win = globalThis;
@@ -242,7 +339,11 @@ var test2 = import_test2.test.extend({
       },
       remove: () => removeChaos(page),
       getLog: () => getChaosLog(page),
-      getSeed: () => getChaosSeed(page)
+      getSeed: () => getChaosSeed(page),
+      enableGroup: (name) => enableGroup(page, name),
+      disableGroup: (name) => disableGroup(page, name),
+      enableSWGroup: (name, opts) => enableSWGroup(page, name, opts),
+      disableSWGroup: (name, opts) => disableSWGroup(page, name, opts)
     };
     await use(fixture);
     await removeChaos(page);

package/dist/fixture.d.cts

@@ -2,13 +2,17 @@ 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';
-import { InjectChaosOptions } from './index.cjs';
+import { InjectChaosOptions, SWChaosOptions } from './index.cjs';
 
 interface ChaosFixture {
     inject: (config: ChaosConfig, opts?: InjectChaosOptions) => Promise<void>;
     remove: () => Promise<void>;
     getLog: () => Promise<ChaosEvent[]>;
     getSeed: () => Promise<number | null>;
+    enableGroup: (name: string) => Promise<void>;
+    disableGroup: (name: string) => Promise<void>;
+    enableSWGroup: (name: string, opts?: SWChaosOptions) => Promise<void>;
+    disableSWGroup: (name: string, opts?: SWChaosOptions) => Promise<void>;
 }
 /**
  * Extended Playwright test with a `chaos` fixture.

package/dist/fixture.d.ts

@@ -2,13 +2,17 @@ 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';
-import { InjectChaosOptions } from './index.js';
+import { InjectChaosOptions, SWChaosOptions } from './index.js';
 
 interface ChaosFixture {
     inject: (config: ChaosConfig, opts?: InjectChaosOptions) => Promise<void>;
     remove: () => Promise<void>;
     getLog: () => Promise<ChaosEvent[]>;
     getSeed: () => Promise<number | null>;
+    enableGroup: (name: string) => Promise<void>;
+    disableGroup: (name: string) => Promise<void>;
+    enableSWGroup: (name: string, opts?: SWChaosOptions) => Promise<void>;
+    disableSWGroup: (name: string, opts?: SWChaosOptions) => Promise<void>;
 }
 /**
  * Extended Playwright test with a `chaos` fixture.

package/dist/fixture.js

@@ -1,9 +1,13 @@
 import {
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
   getChaosLog,
   getChaosSeed,
   injectChaos,
   removeChaos
-} from "./chunk-XVP3BFFM.js";
+} from "./chunk-IJDMHBUQ.js";
 
 // src/fixture.ts
 import { test as base } from "@playwright/test";
@@ -34,7 +38,11 @@ var test = base.extend({
       },
       remove: () => removeChaos(page),
       getLog: () => getChaosLog(page),
-      getSeed: () => getChaosSeed(page)
+      getSeed: () => getChaosSeed(page),
+      enableGroup: (name) => enableGroup(page, name),
+      disableGroup: (name) => disableGroup(page, name),
+      enableSWGroup: (name, opts) => enableSWGroup(page, name, opts),
+      disableSWGroup: (name, opts) => disableSWGroup(page, name, opts)
     };
     await use(fixture);
     await removeChaos(page);

package/dist/index.cjs

@@ -20,12 +20,24 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ChaosConfigError: () => import_core4.ChaosConfigError,
+  Logger: () => import_core3.Logger,
+  disableGroup: () => disableGroup,
+  disableSWGroup: () => disableSWGroup,
+  enableGroup: () => enableGroup,
+  enableSWGroup: () => enableSWGroup,
   getChaosLog: () => getChaosLog,
   getChaosSeed: () => getChaosSeed,
+  getSWChaosLog: () => getSWChaosLog,
+  getSWChaosLogFromSW: () => getSWChaosLogFromSW,
   injectChaos: () => injectChaos,
-  removeChaos: () => removeChaos
+  injectSWChaos: () => injectSWChaos,
+  removeChaos: () => removeChaos,
+  removeSWChaos: () => removeSWChaos,
+  validateChaosConfig: () => import_core4.validateChaosConfig
 });
 module.exports = __toCommonJS(index_exports);
+var import_core2 = require("@chaos-maker/core");
 var import_path = require("path");
 var import_module = require("module");
 var import_url = require("url");
@@ -76,6 +88,7 @@ function truncate(s, max) {
   return `\u2026${s.slice(-(max - 1))}`;
 }
 function shouldEmitStep(event, verbose) {
+  if (event.type === "debug") return false;
   if (event.applied) return true;
   return verbose;
 }
@@ -134,6 +147,100 @@ async function createTraceReporter(page, testInfo, opts = {}) {
   };
 }
 
+// src/index.ts
+var import_core3 = require("@chaos-maker/core");
+var import_core4 = require("@chaos-maker/core");
+
+// src/sw.ts
+var import_core = require("@chaos-maker/core");
+var BRIDGE_INIT_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.sw.bridgeInit");
+var DEFAULT_SW_TOGGLE_TIMEOUT = 2e3;
+async function ensurePageBridge(page) {
+  if (!page[BRIDGE_INIT_KEY]) {
+    await page.addInitScript({ content: import_core.SW_BRIDGE_SOURCE });
+    page[BRIDGE_INIT_KEY] = true;
+  }
+  await page.evaluate(import_core.SW_BRIDGE_SOURCE).catch(() => {
+  });
+}
+async function injectSWChaos(page, config, opts = {}) {
+  const validated = (0, import_core.validateChaosConfig)(config, opts.validation);
+  const timeoutMs = opts.timeoutMs ?? 1e4;
+  await ensurePageBridge(page);
+  const result = await page.evaluate(
+    async ({ cfg, timeoutMs: timeoutMs2 }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) throw new Error("[chaos-maker] SW bridge missing from page \u2014 ensurePageBridge failed");
+      return await bridge.apply(cfg, timeoutMs2);
+    },
+    { cfg: validated, timeoutMs }
+  );
+  return result;
+}
+async function removeSWChaos(page, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5e3;
+  await page.evaluate(
+    async ({ timeoutMs: timeoutMs2 }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) return;
+      await bridge.stop(timeoutMs2);
+      bridge.clearLocalLog();
+    },
+    { timeoutMs }
+  ).catch(() => {
+  });
+}
+async function enableSWGroup(page, name, opts = {}) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await toggleSWGroup(page, nameNorm, true, opts);
+}
+async function disableSWGroup(page, name, opts = {}) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await toggleSWGroup(page, nameNorm, false, opts);
+}
+async function toggleSWGroup(page, name, enabled, opts) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_SW_TOGGLE_TIMEOUT;
+  await ensurePageBridge(page);
+  await page.evaluate(
+    async ({ n, e, t }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) throw new Error("[chaos-maker] SW bridge missing \u2014 ensurePageBridge failed");
+      await bridge.toggleGroup(n, e, t);
+    },
+    { n: name, e: enabled, t: timeoutMs }
+  );
+}
+async function getSWChaosLog(page) {
+  return page.evaluate(() => {
+    const bridge = globalThis.__chaosMakerSWBridge;
+    if (!bridge) return [];
+    return bridge.getLocalLog();
+  });
+}
+async function getSWChaosLogFromSW(page, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5e3;
+  return page.evaluate(
+    async ({ timeoutMs: timeoutMs2 }) => {
+      const bridge = globalThis.__chaosMakerSWBridge;
+      if (!bridge) return [];
+      return bridge.getRemoteLog(timeoutMs2);
+    },
+    { timeoutMs }
+  );
+}
+
 // src/index.ts
 var import_meta = {};
 var cachedUmdPath = null;
@@ -148,6 +255,7 @@ function getCoreUmdPath() {
 }
 var TRACE_HANDLE_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.traceHandle");
 async function injectChaos(page, config, opts = {}) {
+  const validated = (0, import_core2.validateChaosConfig)(config, opts.validation);
   const umdPath = getCoreUmdPath();
   const tracingEnabled = resolveTracing(opts);
   if (tracingEnabled) {
@@ -162,10 +270,11 @@ async function injectChaos(page, config, opts = {}) {
       page[TRACE_HANDLE_KEY] = handle;
     }
   }
+  const serialized = (0, import_core2.serializeForTransport)(validated);
   await page.addInitScript((cfg) => {
     const win = globalThis;
     win.__CHAOS_CONFIG__ = cfg;
-  }, config);
+  }, serialized);
   await page.addInitScript({ path: umdPath });
 }
 function resolveTracing(opts) {
@@ -203,6 +312,50 @@ async function getChaosLog(page) {
     return [];
   });
 }
+async function enableGroup(page, name) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await page.evaluate(({ n }) => {
+    const utils = globalThis.chaosUtils;
+    if (!utils || !utils.instance) {
+      throw new Error("[chaos-maker] no chaos instance on page \u2014 call injectChaos first");
+    }
+    if (typeof utils.enableGroup !== "function") {
+      throw new Error("[chaos-maker] enableGroup API unavailable");
+    }
+    const result = utils.enableGroup(n);
+    if (result && result.success === false) {
+      throw new Error(`[chaos-maker] enableGroup('${n}') failed: ${result.message}`);
+    }
+  }, { n: nameNorm });
+}
+async function disableGroup(page, name) {
+  if (typeof name !== "string") {
+    throw new Error("[chaos-maker] group name must be a string");
+  }
+  const nameNorm = name.trim();
+  if (!nameNorm) {
+    throw new Error("[chaos-maker] group name cannot be empty");
+  }
+  await page.evaluate(({ n }) => {
+    const utils = globalThis.chaosUtils;
+    if (!utils || !utils.instance) {
+      throw new Error("[chaos-maker] no chaos instance on page \u2014 call injectChaos first");
+    }
+    if (typeof utils.disableGroup !== "function") {
+      throw new Error("[chaos-maker] disableGroup API unavailable");
+    }
+    const result = utils.disableGroup(n);
+    if (result && result.success === false) {
+      throw new Error(`[chaos-maker] disableGroup('${n}') failed: ${result.message}`);
+    }
+  }, { n: nameNorm });
+}
 async function getChaosSeed(page) {
   return page.evaluate(() => {
     const win = globalThis;
@@ -214,8 +367,19 @@ async function getChaosSeed(page) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
   getChaosLog,
   getChaosSeed,
+  getSWChaosLog,
+  getSWChaosLogFromSW,
   injectChaos,
-  removeChaos
+  injectSWChaos,
+  removeChaos,
+  removeSWChaos,
+  validateChaosConfig
 });

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { TestInfo, Page } from '@playwright/test';
-import { ChaosEvent, ChaosConfig } from '@chaos-maker/core';
-export { ChaosConfig, ChaosEvent, WebSocketCloseConfig, WebSocketConfig, WebSocketCorruptConfig, WebSocketCorruptionStrategy, WebSocketDelayConfig, WebSocketDirection, WebSocketDropConfig } from '@chaos-maker/core';
+import { Page, TestInfo } from '@playwright/test';
+import { ChaosEvent, ValidateChaosConfigOptions, ChaosConfig } from '@chaos-maker/core';
+export { ChaosConfig, ChaosConfigError, ChaosDebugStage, ChaosEvent, ChaosLifecyclePhase, CorruptionStrategy, CustomRuleValidator, CustomValidatorMap, DebugOptions, GraphQLOperationMatcher, Logger, NetworkAbortConfig, NetworkConfig, NetworkCorruptionConfig, NetworkCorsConfig, NetworkFailureConfig, NetworkLatencyConfig, NetworkRuleMatchers, RuleType, SSECloseConfig, SSEConfig, SSECorruptConfig, SSECorruptionStrategy, SSEDelayConfig, SSEDropConfig, SSEEventTypeMatcher, ValidateChaosConfigOptions, ValidationIssue, ValidationIssueCode, WebSocketCloseConfig, WebSocketConfig, WebSocketCorruptConfig, WebSocketCorruptionStrategy, WebSocketDelayConfig, WebSocketDirection, WebSocketDropConfig, validateChaosConfig } from '@chaos-maker/core';
 
 /**
  * Shape of the JSON attachment written to `testInfo.attachments` on teardown.
@@ -17,6 +17,70 @@ interface TraceReporterOptions {
     attachmentName?: string;
 }
 
+/**
+ * Options accepted by {@link injectSWChaos} / {@link removeSWChaos} /
+ * {@link getSWChaosLog}.
+ */
+interface SWChaosOptions {
+    /**
+     * Maximum milliseconds to wait for `navigator.serviceWorker.controller` and
+     * the SW's ack message. Defaults to `10000`. Raise for slow CI workers or
+     * SWs that do heavy work during `install`.
+     */
+    timeoutMs?: number;
+    /**
+     * Forwarded to `validateChaosConfig` before the config is posted
+     * to the SW. Malformed configs throw a `ChaosConfigError` from Node.
+     */
+    validation?: ValidateChaosConfigOptions;
+}
+interface InjectSWChaosResult {
+    /** Seed used by the PRNG inside the SW. `null` if the ack did not carry one. */
+    seed: number | null;
+}
+/**
+ * Configure Service-Worker chaos for a Playwright page. Call **after**
+ * `page.goto(...)` so there is a SW registration + controller to target.
+ *
+ * Requires the user's service worker to load the chaos SW bundle — typically
+ * via `importScripts('/path/to/chaos-maker-sw.js')` (classic SW) or
+ * `import { installChaosSW } from '@chaos-maker/core/sw'; installChaosSW();`
+ * (module SW).
+ *
+ * @example
+ * ```ts
+ * await page.goto('/');
+ * await injectSWChaos(page, {
+ *   network: { failures: [{ urlPattern: '/api', statusCode: 503, probability: 1 }] },
+ * });
+ * ```
+ */
+declare function injectSWChaos(page: Page, config: ChaosConfig, opts?: SWChaosOptions): Promise<InjectSWChaosResult>;
+/**
+ * Stop Service-Worker chaos for a Playwright page. Posts `__chaosMakerStop` to
+ * the current controller and clears the page's in-memory log buffer.
+ */
+declare function removeSWChaos(page: Page, opts?: SWChaosOptions): Promise<void>;
+/**
+ * Enable a rule group inside the active SW chaos engine. Posts
+ * `__chaosMakerToggleGroup` over MessageChannel and resolves only after the SW
+ * acks. Engine state and request counters are preserved (no restart).
+ */
+declare function enableSWGroup(page: Page, name: string, opts?: SWChaosOptions): Promise<void>;
+/** Disable a rule group inside the active SW chaos engine. */
+declare function disableSWGroup(page: Page, name: string, opts?: SWChaosOptions): Promise<void>;
+/**
+ * Read the chaos event log buffered on the page side. Every event emitted by
+ * the SW is broadcast to all controlled clients and captured here.
+ */
+declare function getSWChaosLog(page: Page): Promise<ChaosEvent[]>;
+/**
+ * Ask the SW for its in-memory log. Useful when debugging a race where the
+ * page-side listener missed an early broadcast (e.g. first-paint navigation).
+ * Prefer {@link getSWChaosLog} in normal assertions.
+ */
+declare function getSWChaosLogFromSW(page: Page, opts?: SWChaosOptions): Promise<ChaosEvent[]>;
+
 /**
  * Options for `injectChaos`. Most callers can omit this entirely; defaults
  * preserve backward compatibility with the v0.1.x signature.
@@ -39,6 +103,13 @@ interface InjectChaosOptions {
     testInfo?: TestInfo;
     /** Pass through to the trace reporter. */
     traceOptions?: TraceReporterOptions;
+    /**
+     * Forwarded to `validateChaosConfig` before the config is
+     * serialized for the page. Use to relax unknown-field handling, hook
+     * deprecation events, or run custom per-`RuleType` validators. Malformed
+     * configs throw a `ChaosConfigError` synchronously from Node.
+     */
+    validation?: ValidateChaosConfigOptions;
 }
 /**
  * Inject chaos into a Playwright page. Call before `page.goto()` to ensure
@@ -68,10 +139,18 @@ declare function removeChaos(page: Page): Promise<void>;
  * Returns all events emitted since chaos was injected.
  */
 declare function getChaosLog(page: Page): Promise<ChaosEvent[]>;
+/**
+ * Enable a rule group at runtime in the page-side chaos engine. Resolves once
+ * `page.evaluate` round-trips so the call is safe to await before triggering
+ * the assertion that depends on the group being live.
+ */
+declare function enableGroup(page: Page, name: string): Promise<void>;
+/** Disable a rule group at runtime in the page-side chaos engine. */
+declare function disableGroup(page: Page, name: string): Promise<void>;
 /**
  * Retrieve the PRNG seed from a Playwright page.
  * Log this value on test failure to replay exact chaos decisions.
  */
 declare function getChaosSeed(page: Page): Promise<number | null>;
 
-export { type ChaosTraceAttachment, type InjectChaosOptions, type TraceReporterOptions, getChaosLog, getChaosSeed, injectChaos, removeChaos };
+export { type ChaosTraceAttachment, type InjectChaosOptions, type InjectSWChaosResult, type SWChaosOptions, type TraceReporterOptions, disableGroup, disableSWGroup, enableGroup, enableSWGroup, getChaosLog, getChaosSeed, getSWChaosLog, getSWChaosLogFromSW, injectChaos, injectSWChaos, removeChaos, removeSWChaos };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { TestInfo, Page } from '@playwright/test';
-import { ChaosEvent, ChaosConfig } from '@chaos-maker/core';
-export { ChaosConfig, ChaosEvent, WebSocketCloseConfig, WebSocketConfig, WebSocketCorruptConfig, WebSocketCorruptionStrategy, WebSocketDelayConfig, WebSocketDirection, WebSocketDropConfig } from '@chaos-maker/core';
+import { Page, TestInfo } from '@playwright/test';
+import { ChaosEvent, ValidateChaosConfigOptions, ChaosConfig } from '@chaos-maker/core';
+export { ChaosConfig, ChaosConfigError, ChaosDebugStage, ChaosEvent, ChaosLifecyclePhase, CorruptionStrategy, CustomRuleValidator, CustomValidatorMap, DebugOptions, GraphQLOperationMatcher, Logger, NetworkAbortConfig, NetworkConfig, NetworkCorruptionConfig, NetworkCorsConfig, NetworkFailureConfig, NetworkLatencyConfig, NetworkRuleMatchers, RuleType, SSECloseConfig, SSEConfig, SSECorruptConfig, SSECorruptionStrategy, SSEDelayConfig, SSEDropConfig, SSEEventTypeMatcher, ValidateChaosConfigOptions, ValidationIssue, ValidationIssueCode, WebSocketCloseConfig, WebSocketConfig, WebSocketCorruptConfig, WebSocketCorruptionStrategy, WebSocketDelayConfig, WebSocketDirection, WebSocketDropConfig, validateChaosConfig } from '@chaos-maker/core';
 
 /**
  * Shape of the JSON attachment written to `testInfo.attachments` on teardown.
@@ -17,6 +17,70 @@ interface TraceReporterOptions {
     attachmentName?: string;
 }
 
+/**
+ * Options accepted by {@link injectSWChaos} / {@link removeSWChaos} /
+ * {@link getSWChaosLog}.
+ */
+interface SWChaosOptions {
+    /**
+     * Maximum milliseconds to wait for `navigator.serviceWorker.controller` and
+     * the SW's ack message. Defaults to `10000`. Raise for slow CI workers or
+     * SWs that do heavy work during `install`.
+     */
+    timeoutMs?: number;
+    /**
+     * Forwarded to `validateChaosConfig` before the config is posted
+     * to the SW. Malformed configs throw a `ChaosConfigError` from Node.
+     */
+    validation?: ValidateChaosConfigOptions;
+}
+interface InjectSWChaosResult {
+    /** Seed used by the PRNG inside the SW. `null` if the ack did not carry one. */
+    seed: number | null;
+}
+/**
+ * Configure Service-Worker chaos for a Playwright page. Call **after**
+ * `page.goto(...)` so there is a SW registration + controller to target.
+ *
+ * Requires the user's service worker to load the chaos SW bundle — typically
+ * via `importScripts('/path/to/chaos-maker-sw.js')` (classic SW) or
+ * `import { installChaosSW } from '@chaos-maker/core/sw'; installChaosSW();`
+ * (module SW).
+ *
+ * @example
+ * ```ts
+ * await page.goto('/');
+ * await injectSWChaos(page, {
+ *   network: { failures: [{ urlPattern: '/api', statusCode: 503, probability: 1 }] },
+ * });
+ * ```
+ */
+declare function injectSWChaos(page: Page, config: ChaosConfig, opts?: SWChaosOptions): Promise<InjectSWChaosResult>;
+/**
+ * Stop Service-Worker chaos for a Playwright page. Posts `__chaosMakerStop` to
+ * the current controller and clears the page's in-memory log buffer.
+ */
+declare function removeSWChaos(page: Page, opts?: SWChaosOptions): Promise<void>;
+/**
+ * Enable a rule group inside the active SW chaos engine. Posts
+ * `__chaosMakerToggleGroup` over MessageChannel and resolves only after the SW
+ * acks. Engine state and request counters are preserved (no restart).
+ */
+declare function enableSWGroup(page: Page, name: string, opts?: SWChaosOptions): Promise<void>;
+/** Disable a rule group inside the active SW chaos engine. */
+declare function disableSWGroup(page: Page, name: string, opts?: SWChaosOptions): Promise<void>;
+/**
+ * Read the chaos event log buffered on the page side. Every event emitted by
+ * the SW is broadcast to all controlled clients and captured here.
+ */
+declare function getSWChaosLog(page: Page): Promise<ChaosEvent[]>;
+/**
+ * Ask the SW for its in-memory log. Useful when debugging a race where the
+ * page-side listener missed an early broadcast (e.g. first-paint navigation).
+ * Prefer {@link getSWChaosLog} in normal assertions.
+ */
+declare function getSWChaosLogFromSW(page: Page, opts?: SWChaosOptions): Promise<ChaosEvent[]>;
+
 /**
  * Options for `injectChaos`. Most callers can omit this entirely; defaults
  * preserve backward compatibility with the v0.1.x signature.
@@ -39,6 +103,13 @@ interface InjectChaosOptions {
     testInfo?: TestInfo;
     /** Pass through to the trace reporter. */
     traceOptions?: TraceReporterOptions;
+    /**
+     * Forwarded to `validateChaosConfig` before the config is
+     * serialized for the page. Use to relax unknown-field handling, hook
+     * deprecation events, or run custom per-`RuleType` validators. Malformed
+     * configs throw a `ChaosConfigError` synchronously from Node.
+     */
+    validation?: ValidateChaosConfigOptions;
 }
 /**
  * Inject chaos into a Playwright page. Call before `page.goto()` to ensure
@@ -68,10 +139,18 @@ declare function removeChaos(page: Page): Promise<void>;
  * Returns all events emitted since chaos was injected.
  */
 declare function getChaosLog(page: Page): Promise<ChaosEvent[]>;
+/**
+ * Enable a rule group at runtime in the page-side chaos engine. Resolves once
+ * `page.evaluate` round-trips so the call is safe to await before triggering
+ * the assertion that depends on the group being live.
+ */
+declare function enableGroup(page: Page, name: string): Promise<void>;
+/** Disable a rule group at runtime in the page-side chaos engine. */
+declare function disableGroup(page: Page, name: string): Promise<void>;
 /**
  * Retrieve the PRNG seed from a Playwright page.
  * Log this value on test failure to replay exact chaos decisions.
  */
 declare function getChaosSeed(page: Page): Promise<number | null>;
 
-export { type ChaosTraceAttachment, type InjectChaosOptions, type TraceReporterOptions, getChaosLog, getChaosSeed, injectChaos, removeChaos };
+export { type ChaosTraceAttachment, type InjectChaosOptions, type InjectSWChaosResult, type SWChaosOptions, type TraceReporterOptions, disableGroup, disableSWGroup, enableGroup, enableSWGroup, getChaosLog, getChaosSeed, getSWChaosLog, getSWChaosLogFromSW, injectChaos, injectSWChaos, removeChaos, removeSWChaos };

package/dist/index.js

@@ -1,12 +1,34 @@
 import {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
   getChaosLog,
   getChaosSeed,
+  getSWChaosLog,
+  getSWChaosLogFromSW,
   injectChaos,
-  removeChaos
-} from "./chunk-XVP3BFFM.js";
+  injectSWChaos,
+  removeChaos,
+  removeSWChaos,
+  validateChaosConfig
+} from "./chunk-IJDMHBUQ.js";
 export {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
   getChaosLog,
   getChaosSeed,
+  getSWChaosLog,
+  getSWChaosLogFromSW,
   injectChaos,
-  removeChaos
+  injectSWChaos,
+  removeChaos,
+  removeSWChaos,
+  validateChaosConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaos-maker/playwright",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Playwright adapter for @chaos-maker/core — one-line chaos injection in E2E tests",
   "keywords": [
@@ -13,10 +13,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jvjithin/chaos-maker.git",
+    "url": "https://github.com/chaos-maker-dev/chaos-maker.git",
     "directory": "packages/playwright"
   },
-  "homepage": "https://github.com/jvjithin/chaos-maker",
+  "homepage": "https://github.com/chaos-maker-dev/chaos-maker",
   "engines": {
     "node": ">=18"
   },
@@ -49,7 +49,7 @@
     "dist"
   ],
   "dependencies": {
-    "@chaos-maker/core": "0.3.0"
+    "@chaos-maker/core": "0.5.0"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.40.0"