@chaos-maker/playwright 0.4.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,49 @@ 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
@@ -133,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`:
@@ -140,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
 
@@ -199,18 +294,29 @@ importScripts('/chaos-maker-sw.js');
 ```
 
 ```ts
-import { injectSWChaos, removeSWChaos, getSWChaosLog } from '@chaos-maker/playwright';
+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, {
-    network: { failures: [{ urlPattern: '/api/data', statusCode: 503, probability: 1 }] },
+    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);
 });
 ```

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

@@ -1,5 +1,5 @@
 // src/index.ts
-import { serializeForTransport } from "@chaos-maker/core";
+import { serializeForTransport, validateChaosConfig as validateChaosConfig2 } from "@chaos-maker/core";
 import { resolve, dirname } from "path";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
@@ -50,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;
 }
@@ -108,9 +109,14 @@ 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 { validateConfig, SW_BRIDGE_SOURCE } from "@chaos-maker/core";
+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 });
@@ -120,7 +126,7 @@ async function ensurePageBridge(page) {
   });
 }
 async function injectSWChaos(page, config, opts = {}) {
-  const validated = validateConfig(config);
+  const validated = validateChaosConfig(config, opts.validation);
   const timeoutMs = opts.timeoutMs ?? 1e4;
   await ensurePageBridge(page);
   const result = await page.evaluate(
@@ -146,6 +152,38 @@ async function removeSWChaos(page, opts = {}) {
   ).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;
@@ -178,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) {
@@ -192,7 +231,7 @@ async function injectChaos(page, config, opts = {}) {
       page[TRACE_HANDLE_KEY] = handle;
     }
   }
-  const serialized = serializeForTransport(config);
+  const serialized = serializeForTransport(validated);
   await page.addInitScript((cfg) => {
     const win = globalThis;
     win.__CHAOS_CONFIG__ = cfg;
@@ -234,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;
@@ -247,10 +330,17 @@ 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

@@ -78,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;
 }
@@ -136,8 +137,54 @@ 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 = {};
@@ -153,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) {
@@ -167,7 +215,7 @@ async function injectChaos(page, config, opts = {}) {
       page[TRACE_HANDLE_KEY] = handle;
     }
   }
-  const serialized = (0, import_core2.serializeForTransport)(config);
+  const serialized = (0, import_core2.serializeForTransport)(validated);
   await page.addInitScript((cfg) => {
     const win = globalThis;
     win.__CHAOS_CONFIG__ = cfg;
@@ -209,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;
@@ -247,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-KHKPTES5.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,6 +20,12 @@ 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,
@@ -27,7 +33,8 @@ __export(index_exports, {
   injectChaos: () => injectChaos,
   injectSWChaos: () => injectSWChaos,
   removeChaos: () => removeChaos,
-  removeSWChaos: () => removeSWChaos
+  removeSWChaos: () => removeSWChaos,
+  validateChaosConfig: () => import_core4.validateChaosConfig
 });
 module.exports = __toCommonJS(index_exports);
 var import_core2 = require("@chaos-maker/core");
@@ -81,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;
 }
@@ -139,9 +147,14 @@ 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 });
@@ -151,7 +164,7 @@ async function ensurePageBridge(page) {
   });
 }
 async function injectSWChaos(page, config, opts = {}) {
-  const validated = (0, import_core.validateConfig)(config);
+  const validated = (0, import_core.validateChaosConfig)(config, opts.validation);
   const timeoutMs = opts.timeoutMs ?? 1e4;
   await ensurePageBridge(page);
   const result = await page.evaluate(
@@ -177,6 +190,38 @@ async function removeSWChaos(page, opts = {}) {
   ).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;
@@ -210,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) {
@@ -224,7 +270,7 @@ async function injectChaos(page, config, opts = {}) {
       page[TRACE_HANDLE_KEY] = handle;
     }
   }
-  const serialized = (0, import_core2.serializeForTransport)(config);
+  const serialized = (0, import_core2.serializeForTransport)(validated);
   await page.addInitScript((cfg) => {
     const win = globalThis;
     win.__CHAOS_CONFIG__ = cfg;
@@ -266,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;
@@ -277,6 +367,12 @@ 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,
@@ -284,5 +380,6 @@ async function getChaosSeed(page) {
   injectChaos,
   injectSWChaos,
   removeChaos,
-  removeSWChaos
+  removeSWChaos,
+  validateChaosConfig
 });

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { Page, TestInfo } from '@playwright/test';
-import { ChaosEvent, ChaosConfig } from '@chaos-maker/core';
-export { ChaosConfig, ChaosEvent, CorruptionStrategy, GraphQLOperationMatcher, NetworkAbortConfig, NetworkConfig, NetworkCorruptionConfig, NetworkCorsConfig, NetworkFailureConfig, NetworkLatencyConfig, NetworkRuleMatchers, SSECloseConfig, SSEConfig, SSECorruptConfig, SSECorruptionStrategy, SSEDelayConfig, SSEDropConfig, SSEEventTypeMatcher, WebSocketCloseConfig, WebSocketConfig, WebSocketCorruptConfig, WebSocketCorruptionStrategy, WebSocketDelayConfig, WebSocketDirection, WebSocketDropConfig } from '@chaos-maker/core';
+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.
@@ -28,6 +28,11 @@ interface SWChaosOptions {
      * 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. */
@@ -56,6 +61,14 @@ declare function injectSWChaos(page: Page, config: ChaosConfig, opts?: SWChaosOp
  * 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.
@@ -90,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
@@ -119,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 InjectSWChaosResult, type SWChaosOptions, type TraceReporterOptions, getChaosLog, getChaosSeed, getSWChaosLog, getSWChaosLogFromSW, injectChaos, injectSWChaos, removeChaos, removeSWChaos };
+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 { Page, TestInfo } from '@playwright/test';
-import { ChaosEvent, ChaosConfig } from '@chaos-maker/core';
-export { ChaosConfig, ChaosEvent, CorruptionStrategy, GraphQLOperationMatcher, NetworkAbortConfig, NetworkConfig, NetworkCorruptionConfig, NetworkCorsConfig, NetworkFailureConfig, NetworkLatencyConfig, NetworkRuleMatchers, SSECloseConfig, SSEConfig, SSECorruptConfig, SSECorruptionStrategy, SSEDelayConfig, SSEDropConfig, SSEEventTypeMatcher, WebSocketCloseConfig, WebSocketConfig, WebSocketCorruptConfig, WebSocketCorruptionStrategy, WebSocketDelayConfig, WebSocketDirection, WebSocketDropConfig } from '@chaos-maker/core';
+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.
@@ -28,6 +28,11 @@ interface SWChaosOptions {
      * 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. */
@@ -56,6 +61,14 @@ declare function injectSWChaos(page: Page, config: ChaosConfig, opts?: SWChaosOp
  * 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.
@@ -90,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
@@ -119,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 InjectSWChaosResult, type SWChaosOptions, type TraceReporterOptions, getChaosLog, getChaosSeed, getSWChaosLog, getSWChaosLogFromSW, injectChaos, injectSWChaos, removeChaos, removeSWChaos };
+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,4 +1,10 @@
 import {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
   getChaosLog,
   getChaosSeed,
   getSWChaosLog,
@@ -6,9 +12,16 @@ import {
   injectChaos,
   injectSWChaos,
   removeChaos,
-  removeSWChaos
-} from "./chunk-KHKPTES5.js";
+  removeSWChaos,
+  validateChaosConfig
+} from "./chunk-IJDMHBUQ.js";
 export {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
   getChaosLog,
   getChaosSeed,
   getSWChaosLog,
@@ -16,5 +29,6 @@ export {
   injectChaos,
   injectSWChaos,
   removeChaos,
-  removeSWChaos
+  removeSWChaos,
+  validateChaosConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaos-maker/playwright",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Playwright adapter for @chaos-maker/core — one-line chaos injection in E2E tests",
   "keywords": [
@@ -49,7 +49,7 @@
     "dist"
   ],
   "dependencies": {
-    "@chaos-maker/core": "0.4.0"
+    "@chaos-maker/core": "0.5.0"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.40.0"