@chaos-maker/playwright 0.4.0 → 0.6.0

package/dist/fixture.cjs

@@ -27,97 +27,66 @@ module.exports = __toCommonJS(fixture_exports);
 var import_test2 = require("@playwright/test");
 
 // src/index.ts
-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 = {
@@ -132,12 +101,63 @@ 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_core3.SW_BRIDGE_SOURCE });
+    page[BRIDGE_INIT_KEY] = true;
+  }
+  await page.evaluate(import_core3.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 = {};
@@ -151,8 +171,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) {
@@ -161,13 +182,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;
@@ -180,7 +201,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 {
@@ -197,7 +218,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) {
@@ -209,6 +230,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 +312,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-ZJZRSTXG.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);