@chaos-maker/playwright 0.4.0 → 0.6.0

package/dist/index.cjs

@@ -20,6 +20,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ChaosConfigError: () => import_core6.ChaosConfigError,
+  Logger: () => import_core5.Logger,
+  disableGroup: () => disableGroup,
+  disableSWGroup: () => disableSWGroup,
+  enableGroup: () => enableGroup,
+  enableSWGroup: () => enableSWGroup,
+  formatSeedReproduction: () => import_core6.formatSeedReproduction,
   getChaosLog: () => getChaosLog,
   getChaosSeed: () => getChaosSeed,
   getSWChaosLog: () => getSWChaosLog,
@@ -27,100 +34,70 @@ __export(index_exports, {
   injectChaos: () => injectChaos,
   injectSWChaos: () => injectSWChaos,
   removeChaos: () => removeChaos,
-  removeSWChaos: () => removeSWChaos
+  removeSWChaos: () => removeSWChaos,
+  validateChaosConfig: () => import_core6.validateChaosConfig
 });
 module.exports = __toCommonJS(index_exports);
-var import_core2 = require("@chaos-maker/core");
+var import_core4 = require("@chaos-maker/core");
 var import_path = require("path");
 var import_module = require("module");
 var import_url = require("url");
 
 // src/trace.ts
 var import_test = require("@playwright/test");
+var import_core = require("@chaos-maker/core");
+var import_core2 = require("@chaos-maker/core");
 var CHAOS_BINDING = "__chaosMakerReport";
-function formatStepTitle(event) {
-  const prefix = `chaos:${event.type}`;
-  const d = event.detail ?? {};
-  const parts = [];
-  const subject = d.url ?? d.selector;
-  if (subject) parts.push(truncate(subject, 48));
-  const outcome = formatOutcome(event);
-  if (outcome) parts.push(`\u2192 ${outcome}`);
-  if (!event.applied) parts.push("(skipped)");
-  return parts.length > 0 ? `${prefix} ${parts.join(" ")}` : prefix;
-}
-function formatOutcome(event) {
-  const d = event.detail ?? {};
-  switch (event.type) {
-    case "network:failure":
-      return d.statusCode != null ? String(d.statusCode) : null;
-    case "network:latency":
-      return d.delayMs != null ? `+${d.delayMs}ms` : null;
-    case "network:abort":
-      return "abort";
-    case "network:corruption":
-      return d.strategy ?? "corrupted";
-    case "network:cors":
-      return "cors-block";
-    case "ui:assault":
-      return d.action ?? null;
-    case "websocket:drop":
-      return d.direction ? `drop ${d.direction}` : "drop";
-    case "websocket:delay":
-      return d.delayMs != null ? `delay ${d.direction ?? ""} +${d.delayMs}ms` : "delay";
-    case "websocket:corrupt":
-      return d.strategy ?? "corrupt";
-    case "websocket:close":
-      return d.closeCode != null ? `close ${d.closeCode}` : "close";
-    default:
-      return null;
-  }
-}
-function truncate(s, max) {
-  if (s.length <= max) return s;
-  return `\u2026${s.slice(-(max - 1))}`;
-}
-function shouldEmitStep(event, verbose) {
-  if (event.applied) return true;
-  return verbose;
-}
+var TRACE_HANDLE_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.traceHandle");
+var TRACE_BINDING_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.traceBinding");
 async function createTraceReporter(page, testInfo, opts = {}) {
+  const existing = page[TRACE_HANDLE_KEY];
+  if (existing) return existing;
   const verbose = opts.verbose ?? false;
   const attachmentName = opts.attachmentName ?? "chaos-log.json";
   const events = [];
   const handler = (_source, event) => {
     events.push(event);
-    if (!shouldEmitStep(event, verbose)) return;
-    const title = formatStepTitle(event);
+    if (!(0, import_core.shouldEmitStep)(event, verbose)) return;
+    const title = (0, import_core.formatStepTitle)(event);
     import_test.test.step(title, async () => {
     }).catch(() => {
     });
   };
-  await page.exposeBinding(CHAOS_BINDING, handler);
-  await page.addInitScript((bindingName) => {
-    const win = globalThis;
-    const attach = () => {
-      const utils = win.chaosUtils;
-      if (!utils || !utils.instance) return false;
-      if (utils.__chaosMakerTraceBound === utils.instance) return true;
-      utils.__chaosMakerTraceBound = utils.instance;
-      utils.instance.on("*", (event) => {
-        try {
-          if (typeof win[bindingName] === "function") {
-            win[bindingName](event);
+  let state = page[TRACE_BINDING_KEY];
+  if (!state) {
+    state = { handler };
+    page[TRACE_BINDING_KEY] = state;
+    await page.exposeBinding(CHAOS_BINDING, (source, event) => {
+      state.handler(source, event);
+    });
+    await page.addInitScript((bindingName) => {
+      const win = globalThis;
+      const attach = () => {
+        const utils = win.chaosUtils;
+        if (!utils || !utils.instance) return false;
+        if (utils.__chaosMakerTraceBound === utils.instance) return true;
+        utils.__chaosMakerTraceBound = utils.instance;
+        utils.instance.on("*", (event) => {
+          try {
+            if (typeof win[bindingName] === "function") {
+              win[bindingName](event);
+            }
+          } catch {
           }
-        } catch {
-        }
-      });
-      return true;
-    };
-    if (attach()) return;
-    const intervalId = setInterval(() => {
-      if (attach()) clearInterval(intervalId);
-    }, 10);
-    setTimeout(() => clearInterval(intervalId), 5e3);
-  }, CHAOS_BINDING);
-  return {
+        });
+        return true;
+      };
+      if (attach()) return;
+      const intervalId = setInterval(() => {
+        if (attach()) clearInterval(intervalId);
+      }, 10);
+      setTimeout(() => clearInterval(intervalId), 5e3);
+    }, CHAOS_BINDING);
+  } else {
+    state.handler = handler;
+  }
+  const handle = {
     events,
     dispose: async (seed = null) => {
       const payload = {
@@ -135,23 +112,33 @@ async function createTraceReporter(page, testInfo, opts = {}) {
         });
       } catch {
       }
+      if (page[TRACE_HANDLE_KEY] === handle) {
+        delete page[TRACE_HANDLE_KEY];
+      }
     }
   };
+  page[TRACE_HANDLE_KEY] = handle;
+  return handle;
 }
 
+// src/index.ts
+var import_core5 = require("@chaos-maker/core");
+var import_core6 = require("@chaos-maker/core");
+
 // src/sw.ts
-var import_core = require("@chaos-maker/core");
+var import_core3 = 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 });
+    await page.addInitScript({ content: import_core3.SW_BRIDGE_SOURCE });
     page[BRIDGE_INIT_KEY] = true;
   }
-  await page.evaluate(import_core.SW_BRIDGE_SOURCE).catch(() => {
+  await page.evaluate(import_core3.SW_BRIDGE_SOURCE).catch(() => {
   });
 }
 async function injectSWChaos(page, config, opts = {}) {
-  const validated = (0, import_core.validateConfig)(config);
+  const validated = (0, import_core3.validateChaosConfig)(config, opts.validation);
   const timeoutMs = opts.timeoutMs ?? 1e4;
   await ensurePageBridge(page);
   const result = await page.evaluate(
@@ -170,13 +157,49 @@ async function removeSWChaos(page, opts = {}) {
     async ({ timeoutMs: timeoutMs2 }) => {
       const bridge = globalThis.__chaosMakerSWBridge;
       if (!bridge) return;
-      await bridge.stop(timeoutMs2);
-      bridge.clearLocalLog();
+      try {
+        await bridge.stop(timeoutMs2);
+      } finally {
+        bridge.clearLocalLog();
+        await bridge.clearRemoteLog?.(timeoutMs2).catch(() => void 0);
+      }
     },
     { 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;
@@ -208,8 +231,9 @@ function getCoreUmdPath() {
   cachedUmdPath = (0, import_path.resolve)(coreDistDir, "chaos-maker.umd.js");
   return cachedUmdPath;
 }
-var TRACE_HANDLE_KEY = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.traceHandle");
+var TRACE_HANDLE_KEY2 = /* @__PURE__ */ Symbol.for("chaos-maker.playwright.traceHandle");
 async function injectChaos(page, config, opts = {}) {
+  const validated = (0, import_core4.validateChaosConfig)(config, opts.validation);
   const umdPath = getCoreUmdPath();
   const tracingEnabled = resolveTracing(opts);
   if (tracingEnabled) {
@@ -218,13 +242,13 @@ async function injectChaos(page, config, opts = {}) {
         "[chaos-maker] tracing requires a `testInfo` in InjectChaosOptions. Use the fixture (`@chaos-maker/playwright/fixture`) or pass testInfo explicitly."
       );
     }
-    const existing = page[TRACE_HANDLE_KEY];
+    const existing = page[TRACE_HANDLE_KEY2];
     if (!existing) {
       const handle = await createTraceReporter(page, opts.testInfo, opts.traceOptions);
-      page[TRACE_HANDLE_KEY] = handle;
+      page[TRACE_HANDLE_KEY2] = handle;
     }
   }
-  const serialized = (0, import_core2.serializeForTransport)(config);
+  const serialized = (0, import_core4.serializeForTransport)(validated);
   await page.addInitScript((cfg) => {
     const win = globalThis;
     win.__CHAOS_CONFIG__ = cfg;
@@ -237,7 +261,7 @@ function resolveTracing(opts) {
   return false;
 }
 async function removeChaos(page) {
-  const handle = page[TRACE_HANDLE_KEY];
+  const handle = page[TRACE_HANDLE_KEY2];
   let seed = null;
   if (handle) {
     try {
@@ -254,7 +278,7 @@ async function removeChaos(page) {
   });
   if (handle) {
     await handle.dispose(seed);
-    delete page[TRACE_HANDLE_KEY];
+    delete page[TRACE_HANDLE_KEY2];
   }
 }
 async function getChaosLog(page) {
@@ -266,6 +290,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 +345,13 @@ async function getChaosSeed(page) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
+  formatSeedReproduction,
   getChaosLog,
   getChaosSeed,
   getSWChaosLog,
@@ -284,5 +359,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, formatSeedReproduction, validateChaosConfig } from '@chaos-maker/core';
 
 /**
  * Shape of the JSON attachment written to `testInfo.attachments` on teardown.
@@ -10,6 +10,7 @@ interface ChaosTraceAttachment {
     eventCount: number;
     events: ChaosEvent[];
 }
+
 interface TraceReporterOptions {
     /** Emit `test.step` for `applied:false` diagnostic events too. Default false. */
     verbose?: boolean;
@@ -28,6 +29,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 +62,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 +104,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 +140,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, formatSeedReproduction, validateChaosConfig } from '@chaos-maker/core';
 
 /**
  * Shape of the JSON attachment written to `testInfo.attachments` on teardown.
@@ -10,6 +10,7 @@ interface ChaosTraceAttachment {
     eventCount: number;
     events: ChaosEvent[];
 }
+
 interface TraceReporterOptions {
     /** Emit `test.step` for `applied:false` diagnostic events too. Default false. */
     verbose?: boolean;
@@ -28,6 +29,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 +62,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 +104,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 +140,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,11 @@
 import {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
+  formatSeedReproduction,
   getChaosLog,
   getChaosSeed,
   getSWChaosLog,
@@ -6,9 +13,17 @@ import {
   injectChaos,
   injectSWChaos,
   removeChaos,
-  removeSWChaos
-} from "./chunk-KHKPTES5.js";
+  removeSWChaos,
+  validateChaosConfig
+} from "./chunk-ZJZRSTXG.js";
 export {
+  ChaosConfigError,
+  Logger,
+  disableGroup,
+  disableSWGroup,
+  enableGroup,
+  enableSWGroup,
+  formatSeedReproduction,
   getChaosLog,
   getChaosSeed,
   getSWChaosLog,
@@ -16,5 +31,6 @@ export {
   injectChaos,
   injectSWChaos,
   removeChaos,
-  removeSWChaos
+  removeSWChaos,
+  validateChaosConfig
 };

package/package.json

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