@chaos-maker/core 0.5.0 → 0.6.0

package/dist/types/ChaosMaker.d.ts

@@ -51,6 +51,11 @@ export declare class ChaosMaker {
     private logger?;
     constructor(config: ChaosConfig, options?: ChaosMakerOptions);
     private seedGroupsFromRules;
+    private emitInvariant;
+    private emitStartInvariantDiagnostics;
+    private emitStopInvariantDiagnostics;
+    private emitPatchDiagnostic;
+    private runCleanupStep;
     /** Compute the set of group names currently referenced by any rule. Used by `removeGroup`. */
     private collectReferencedGroups;
     /** Get the seed used by this instance. Log this on failure to reproduce exact chaos decisions. */

package/dist/types/format-event.d.ts

@@ -0,0 +1,13 @@
+import type { ChaosEvent } from './events';
+/**
+ * Format a chaos event into a compact, human-readable trace step title.
+ * Keeps titles under about 80 chars; truncates long URLs from the left to
+ * preserve the distinguishing path/query tail.
+ */
+export declare function formatStepTitle(event: ChaosEvent): string;
+/**
+ * Decide whether an event should emit a live runner step or command-log entry.
+ * Skipped events only render live when verbose output is enabled. Debug events
+ * stay JSON-only because they are high-volume by design.
+ */
+export declare function shouldEmitStep(event: ChaosEvent, verbose: boolean): boolean;

package/dist/types/index.d.ts

@@ -6,6 +6,8 @@ import { ChaosEvent, ChaosEventType, ChaosEventListener, ChaosEventEmitter } fro
 import { ChaosConfigBuilder } from './builder';
 import { presets, PresetRegistry, BUILT_IN_PRESETS, expandPresets } from './presets';
 import { createPrng, generateSeed } from './prng';
+import { formatStepTitle, shouldEmitStep } from './format-event';
+import { formatSeedReproduction } from './seed-reporting';
 /** `validateChaosConfig` is the canonical structured validation entry. Layers
  *  schema-version gating, brand-cache short-circuit, deprecation walk, and
  *  custom validators on top of `prepareChaosConfig` (Zod pass 1 + preset
@@ -18,7 +20,7 @@ import { createPrng, generateSeed } from './prng';
  *
  *  `validateConfig` is the schema-only primitive — does NOT expand presets.
  *  Use only for unit-test structural assertions. */
-export { ChaosMaker, ChaosConfigError, validateConfig, prepareChaosConfig, validateChaosConfig, VALIDATOR_BRAND_VERSION, ChaosEventEmitter, ChaosConfigBuilder, presets, PresetRegistry, BUILT_IN_PRESETS, expandPresets, createPrng, generateSeed };
+export { ChaosMaker, ChaosConfigError, validateConfig, prepareChaosConfig, validateChaosConfig, VALIDATOR_BRAND_VERSION, ChaosEventEmitter, ChaosConfigBuilder, presets, PresetRegistry, BUILT_IN_PRESETS, expandPresets, createPrng, generateSeed, formatStepTitle, shouldEmitStep, formatSeedReproduction };
 /** Internal: prebuilt Zod schema variants. Exported so the JSON-schema build
  *  script can serialize the canonical strict variant. Application code should
  *  call `validateChaosConfig` instead — the schemas are not the public
@@ -28,6 +30,7 @@ export type { ValidateChaosConfigOptions, PrepareChaosConfigOptions };
 export type { ValidationIssue, ValidationIssueCode, RuleType, CustomRuleValidator, CustomValidatorMap, DeprecationEntry } from './validation-types';
 export type { Preset, PresetConfigSlice } from './presets';
 export { SW_BRIDGE_SOURCE } from './sw-bridge-source';
+export { isSessionTeardownError, SESSION_TEARDOWN_PATTERNS } from './session-errors';
 export { extractGraphQLOperation, parseOperationFromQueryString, operationNameMatches } from './graphql';
 export { serializeForTransport, deserializeForTransport } from './transport';
 export { DEFAULT_GROUP_NAME, RuleGroupRegistry } from './groups';

package/dist/types/runtime-state.d.ts

@@ -0,0 +1,6 @@
+export type RuntimePatchKind = 'fetch' | 'xhr-open' | 'xhr-send' | 'websocket' | 'eventsource';
+export declare function markRuntimePatch<T extends object>(value: T, kind: RuntimePatchKind): T;
+export declare function getRuntimePatchKind(value: unknown): RuntimePatchKind | undefined;
+export declare function getActiveRuntimeInstance(target: object): unknown;
+export declare function setActiveRuntimeInstance(target: object, instance: unknown): void;
+export declare function clearActiveRuntimeInstance(target: object, instance: unknown): void;

package/dist/types/seed-reporting.d.ts

@@ -0,0 +1 @@
+export declare function formatSeedReproduction(seed: number | null): string;

package/dist/types/session-errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Recognize errors thrown when a browser session, page, or websocket
+ * transport is gone — i.e. cases where adapter cleanup has nothing left to
+ * act on and should swallow the failure rather than surface it as a real
+ * teardown bug.
+ *
+ * The list intentionally covers patterns from Playwright, Puppeteer,
+ * WebdriverIO, Selenium, and Chrome DevTools Protocol. It is conservative:
+ * unknown errors still propagate. Extend only when a real teardown path
+ * surfaces a new shape.
+ */
+export declare const SESSION_TEARDOWN_PATTERNS: readonly RegExp[];
+/**
+ * Returns true when `err` looks like a session/page-teardown failure rather
+ * than a genuine runtime error. Adapters use this to make `removeChaos`
+ * best-effort during framework teardown without masking real cleanup bugs.
+ */
+export declare function isSessionTeardownError(err: unknown): boolean;

package/dist/types/sw-bridge-source.d.ts

@@ -12,9 +12,10 @@
  *  - `toggleGroup(name, enabled, timeoutMs)` — flip a rule group inside the SW
  *    via `__chaosMakerToggleGroup`; resolves on ack with no engine restart.
  *  - `getLocalLog()` / `clearLocalLog()` — page-side buffered event log.
- *  - `getRemoteLog(timeoutMs)` — fetch SW's in-memory log.
+ *  - `getRemoteLog(timeoutMs)` / `clearRemoteLog(timeoutMs)` - inspect or
+ *    clear the SW-side in-memory log.
  *
  * The bridge auto-wires a `controllerchange` listener so SW updates inherit
  * the most recent config. Install is idempotent.
  */
-export declare const SW_BRIDGE_SOURCE = "\n(function installChaosMakerSWBridge() {\n  if (typeof window === 'undefined') return;\n  if (window.__chaosMakerSWBridgeInstalled) return;\n  window.__chaosMakerSWBridgeInstalled = true;\n\n  var log = [];\n  var lastConfig = null;\n\n  function addSwListeners() {\n    if (!('serviceWorker' in navigator)) return;\n    navigator.serviceWorker.addEventListener('message', function (evt) {\n      var data = evt && evt.data;\n      if (data && data.__chaosMakerSWEvent && data.event) {\n        log.push(data.event);\n      }\n    });\n    navigator.serviceWorker.addEventListener('controllerchange', function () {\n      if (lastConfig) {\n        postConfig(lastConfig, 5000).catch(function (err) {\n          try { console.warn('[chaos-maker] re-apply after controllerchange failed', err); } catch (_) {}\n        });\n      }\n    });\n  }\n\n  function waitForController(timeoutMs) {\n    return new Promise(function (resolve, reject) {\n      if (!('serviceWorker' in navigator)) {\n        reject(new Error('[chaos-maker] service worker API not available on this page'));\n        return;\n      }\n      var start = Date.now();\n      (function poll() {\n        if (navigator.serviceWorker.controller) {\n          resolve(navigator.serviceWorker.controller);\n          return;\n        }\n        if (Date.now() - start >= timeoutMs) {\n          reject(new Error('[chaos-maker] no SW controller after ' + timeoutMs + 'ms \u2014 did you register the SW?'));\n          return;\n        }\n        setTimeout(poll, 50);\n      })();\n    });\n  }\n\n  function postViaPort(controller, message, timeoutMs) {\n    return new Promise(function (resolve, reject) {\n      var channel = new MessageChannel();\n      var settled = false;\n      var timer = setTimeout(function () {\n        if (settled) return;\n        settled = true;\n        try { channel.port1.close(); } catch (_) {}\n        reject(new Error('[chaos-maker] SW ack timeout after ' + timeoutMs + 'ms'));\n      }, timeoutMs);\n      channel.port1.onmessage = function (evt) {\n        if (settled) return;\n        settled = true;\n        clearTimeout(timer);\n        resolve(evt && evt.data);\n      };\n      controller.postMessage(message, [channel.port2]);\n    });\n  }\n\n  function postConfig(cfg, timeoutMs) {\n    return waitForController(timeoutMs).then(function (ctrl) {\n      return postViaPort(ctrl, { __chaosMakerConfig: cfg }, timeoutMs);\n    });\n  }\n\n  window.__chaosMakerSWBridge = {\n    apply: function (cfg, timeoutMs) {\n      // Defensive: page-side adapters validate before calling apply. The\n      // page-side bundle deliberately excludes Zod, so a null/primitive/\n      // array/wildly-wrong payload throws here instead of silently posting\n      // garbage to the SW. `typeof [] === 'object'` so reject arrays too.\n      if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg)) {\n        return Promise.reject(new Error('[chaos-maker] bridge.apply: config must be an object'));\n      }\n      // Stash cfg BEFORE awaiting ack \u2014 intentional. If the first ack times\n      // out (e.g. SW still installing), the controllerchange listener above\n      // will retry with this config once the new SW claims the page. Caller\n      // still sees the rejection from this attempt and can re-throw.\n      lastConfig = cfg;\n      return postConfig(cfg, timeoutMs).then(function (ack) {\n        return { seed: ack && typeof ack.seed === 'number' ? ack.seed : null };\n      });\n    },\n    stop: function (timeoutMs) {\n      lastConfig = null;\n      if (!('serviceWorker' in navigator) || !navigator.serviceWorker.controller) {\n        return Promise.resolve({ running: false });\n      }\n      return postViaPort(navigator.serviceWorker.controller, { __chaosMakerStop: true }, timeoutMs);\n    },\n    toggleGroup: function (name, enabled, timeoutMs) {\n      if (!('serviceWorker' in navigator) || !navigator.serviceWorker.controller) {\n        return Promise.reject(new Error('[chaos-maker] no SW controller \u2014 call injectSWChaos before toggleGroup'));\n      }\n      var t = (typeof timeoutMs === 'number' && timeoutMs > 0) ? timeoutMs : 2000;\n      return postViaPort(\n        navigator.serviceWorker.controller,\n        { __chaosMakerToggleGroup: { name: String(name), enabled: !!enabled } },\n        t,\n      );\n    },\n    getLocalLog: function () { return log.slice(); },\n    clearLocalLog: function () { log.length = 0; },\n    getRemoteLog: function (timeoutMs) {\n      if (!('serviceWorker' in navigator) || !navigator.serviceWorker.controller) {\n        return Promise.resolve([]);\n      }\n      return postViaPort(navigator.serviceWorker.controller, { __chaosMakerGetLog: true }, timeoutMs)\n        .then(function (reply) {\n          return (reply && Array.isArray(reply.log)) ? reply.log : [];\n        });\n    },\n  };\n\n  addSwListeners();\n})();\n";
+export declare const SW_BRIDGE_SOURCE = "\n(function installChaosMakerSWBridge() {\n  if (typeof window === 'undefined') return;\n  if (window.__chaosMakerSWBridgeInstalled) return;\n  window.__chaosMakerSWBridgeInstalled = true;\n\n  var log = [];\n  var lastConfig = null;\n\n  function addSwListeners() {\n    if (!('serviceWorker' in navigator)) return;\n    navigator.serviceWorker.addEventListener('message', function (evt) {\n      var data = evt && evt.data;\n      if (data && data.__chaosMakerSWEvent && data.event) {\n        log.push(data.event);\n      }\n    });\n    navigator.serviceWorker.addEventListener('controllerchange', function () {\n      if (lastConfig) {\n        postConfig(lastConfig, 5000).catch(function (err) {\n          try { console.warn('[chaos-maker] re-apply after controllerchange failed', err); } catch (_) {}\n        });\n      }\n    });\n  }\n\n  function waitForController(timeoutMs) {\n    return new Promise(function (resolve, reject) {\n      if (!('serviceWorker' in navigator)) {\n        reject(new Error('[chaos-maker] service worker API not available on this page'));\n        return;\n      }\n      var start = Date.now();\n      (function poll() {\n        if (navigator.serviceWorker.controller) {\n          resolve(navigator.serviceWorker.controller);\n          return;\n        }\n        if (Date.now() - start >= timeoutMs) {\n          reject(new Error('[chaos-maker] no SW controller after ' + timeoutMs + 'ms \u2014 did you register the SW?'));\n          return;\n        }\n        setTimeout(poll, 50);\n      })();\n    });\n  }\n\n  function postViaPort(controller, message, timeoutMs) {\n    return new Promise(function (resolve, reject) {\n      var channel = new MessageChannel();\n      var settled = false;\n      var timer = setTimeout(function () {\n        if (settled) return;\n        settled = true;\n        try { channel.port1.close(); } catch (_) {}\n        reject(new Error('[chaos-maker] SW ack timeout after ' + timeoutMs + 'ms'));\n      }, timeoutMs);\n      channel.port1.onmessage = function (evt) {\n        if (settled) return;\n        settled = true;\n        clearTimeout(timer);\n        resolve(evt && evt.data);\n      };\n      controller.postMessage(message, [channel.port2]);\n    });\n  }\n\n  function postConfig(cfg, timeoutMs) {\n    return waitForController(timeoutMs).then(function (ctrl) {\n      return postViaPort(ctrl, { __chaosMakerConfig: cfg }, timeoutMs);\n    });\n  }\n\n  window.__chaosMakerSWBridge = {\n    apply: function (cfg, timeoutMs) {\n      // Defensive: page-side adapters validate before calling apply. The\n      // page-side bundle deliberately excludes Zod, so a null/primitive/\n      // array/wildly-wrong payload throws here instead of silently posting\n      // garbage to the SW. `typeof [] === 'object'` so reject arrays too.\n      if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg)) {\n        return Promise.reject(new Error('[chaos-maker] bridge.apply: config must be an object'));\n      }\n      // Stash cfg BEFORE awaiting ack \u2014 intentional. If the first ack times\n      // out (e.g. SW still installing), the controllerchange listener above\n      // will retry with this config once the new SW claims the page. Caller\n      // still sees the rejection from this attempt and can re-throw.\n      lastConfig = cfg;\n      return postConfig(cfg, timeoutMs).then(function (ack) {\n        return { seed: ack && typeof ack.seed === 'number' ? ack.seed : null };\n      });\n    },\n    stop: function (timeoutMs) {\n      lastConfig = null;\n      if (!('serviceWorker' in navigator) || !navigator.serviceWorker.controller) {\n        return Promise.resolve({ running: false });\n      }\n      return postViaPort(navigator.serviceWorker.controller, { __chaosMakerStop: true }, timeoutMs);\n    },\n    toggleGroup: function (name, enabled, timeoutMs) {\n      if (!('serviceWorker' in navigator) || !navigator.serviceWorker.controller) {\n        return Promise.reject(new Error('[chaos-maker] no SW controller \u2014 call injectSWChaos before toggleGroup'));\n      }\n      var t = (typeof timeoutMs === 'number' && timeoutMs > 0) ? timeoutMs : 2000;\n      return postViaPort(\n        navigator.serviceWorker.controller,\n        { __chaosMakerToggleGroup: { name: String(name), enabled: !!enabled } },\n        t,\n      );\n    },\n    getLocalLog: function () { return log.slice(); },\n    clearLocalLog: function () { log.length = 0; },\n    getRemoteLog: function (timeoutMs) {\n      if (!('serviceWorker' in navigator) || !navigator.serviceWorker.controller) {\n        return Promise.resolve([]);\n      }\n      return postViaPort(navigator.serviceWorker.controller, { __chaosMakerGetLog: true }, timeoutMs)\n        .then(function (reply) {\n          return (reply && Array.isArray(reply.log)) ? reply.log : [];\n        });\n    },\n    clearRemoteLog: function (timeoutMs) {\n      if (!('serviceWorker' in navigator) || !navigator.serviceWorker.controller) {\n        return Promise.resolve();\n      }\n      return postViaPort(navigator.serviceWorker.controller, { __chaosMakerClearLog: true }, timeoutMs)\n        .then(function () { return undefined; });\n    },\n  };\n\n  addSwListeners();\n})();\n";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaos-maker/core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "A lightweight, framework-agnostic toolkit for injecting chaos into web applications to test frontend resilience",
   "keywords": [