npm - @henriquecosta/chaos-api - Versions diffs - 1.0.0 - Mend

@henriquecosta/chaos-api 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (61) hide show

package/dist/adapters/express.d.ts +21 -0
package/dist/adapters/express.js +40 -0
package/dist/adapters/fastify.d.ts +12 -0
package/dist/adapters/fastify.js +44 -0
package/dist/adapters/koa.d.ts +12 -0
package/dist/adapters/koa.js +47 -0
package/dist/adapters/nestjs.d.ts +34 -0
package/dist/adapters/nestjs.js +52 -0
package/dist/bin/chaos-api.d.ts +2 -0
package/dist/bin/chaos-api.js +33 -0
package/dist/core/activity-log.d.ts +24 -0
package/dist/core/activity-log.js +26 -0
package/dist/core/scenario-engine.d.ts +12 -0
package/dist/core/scenario-engine.js +38 -0
package/dist/core/state-store.d.ts +26 -0
package/dist/core/state-store.js +69 -0
package/dist/core/types.d.ts +41 -0
package/dist/core/types.js +1 -0
package/dist/dashboard/server/control-api.d.ts +9 -0
package/dist/dashboard/server/control-api.js +140 -0
package/dist/dashboard/server/index.d.ts +10 -0
package/dist/dashboard/server/index.js +49 -0
package/dist/dashboard/ui/app.js +336 -0
package/dist/dashboard/ui/index.html +215 -0
package/dist/guardrail.d.ts +10 -0
package/dist/guardrail.js +20 -0
package/dist/index.d.ts +22 -0
package/dist/index.js +13 -0
package/dist/outbound/chaos-fetch.d.ts +13 -0
package/dist/outbound/chaos-fetch.js +50 -0
package/dist/outbound/index.d.ts +1 -0
package/dist/outbound/index.js +1 -0
package/dist/presets/catalog.d.ts +8 -0
package/dist/presets/catalog.js +157 -0
package/dist/presets/index.d.ts +15 -0
package/dist/presets/index.js +22 -0
package/dist/presets/types.d.ts +17 -0
package/dist/presets/types.js +1 -0
package/dist/scenarios/connection-reset.d.ts +7 -0
package/dist/scenarios/connection-reset.js +8 -0
package/dist/scenarios/delay.d.ts +6 -0
package/dist/scenarios/delay.js +9 -0
package/dist/scenarios/error-response.d.ts +9 -0
package/dist/scenarios/error-response.js +13 -0
package/dist/scenarios/index.d.ts +7 -0
package/dist/scenarios/index.js +7 -0
package/dist/scenarios/malformed-response.d.ts +11 -0
package/dist/scenarios/malformed-response.js +13 -0
package/dist/scenarios/random-error.d.ts +6 -0
package/dist/scenarios/random-error.js +7 -0
package/dist/scenarios/random-timeout.d.ts +7 -0
package/dist/scenarios/random-timeout.js +8 -0
package/dist/scenarios/registry.d.ts +12 -0
package/dist/scenarios/registry.js +20 -0
package/dist/scenarios/stale-response.d.ts +9 -0
package/dist/scenarios/stale-response.js +10 -0
package/dist/scenarios/unavailable-503.d.ts +5 -0
package/dist/scenarios/unavailable-503.js +9 -0
package/dist/scenarios/unavailable.d.ts +7 -0
package/dist/scenarios/unavailable.js +9 -0
package/package.json +59 -0

package/dist/dashboard/ui/index.html ADDED Viewed

@@ -0,0 +1,215 @@
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>Chaos API — Dashboard</title>
+  <style>
+    :root {
+      --bg: #0F1115;
+      --surface: #1A1D24;
+      --primary: #5B8CFF;
+      --active: #FF6B4A;
+      --text: #E6E8EC;
+      --text-muted: #8A8F98;
+      --error: #E5484D;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      font-family: Inter, system-ui, sans-serif;
+      background: var(--bg);
+      color: var(--text);
+      font-size: 14px;
+    }
+    header {
+      padding: 16px 24px;
+      border-bottom: 1px solid #262A33;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 16px;
+    }
+    h1 { font-size: 24px; font-weight: 600; margin: 0; }
+    #status-banner {
+      display: none;
+      background: var(--active);
+      color: #1A0A05;
+      padding: 8px 24px;
+      font-weight: 600;
+    }
+    main { padding: 24px; max-width: 720px; margin: 0 auto; }
+    .row { display: flex; gap: 8px; align-items: center; margin-bottom: 16px; }
+    input, select, button {
+      font-family: inherit;
+      font-size: 13px;
+      background: var(--surface);
+      color: var(--text);
+      border: 1px solid #262A33;
+      border-radius: 4px;
+      padding: 8px;
+    }
+    input[type="text"], input[type="number"] { font-family: "JetBrains Mono", monospace; }
+    button {
+      cursor: pointer;
+      background: var(--primary);
+      color: #0B1220;
+      border: none;
+      font-weight: 600;
+    }
+    button.danger { background: var(--error); color: #fff; }
+    #control-url { flex: 1; }
+    .card {
+      background: var(--surface);
+      border-radius: 8px;
+      padding: 16px;
+      margin-bottom: 12px;
+      display: flex;
+      align-items: center;
+      gap: 12px;
+    }
+    .card.on { border-left: 3px solid var(--active); }
+    .card .meta { flex: 1; }
+    .card .type { font-weight: 600; text-transform: capitalize; }
+    .card .scope { color: var(--text-muted); font-family: "JetBrains Mono", monospace; font-size: 12px; }
+    form.add-form {
+      background: var(--surface);
+      border-radius: 8px;
+      padding: 16px;
+      display: grid;
+      gap: 8px;
+      grid-template-columns: 1fr 1fr;
+    }
+    form.add-form .full { grid-column: 1 / -1; }
+    #error { color: var(--error); margin-bottom: 12px; }
+    h2 { font-size: 16px; margin: 24px 0 8px; }
+    #activity-list {
+      background: var(--surface);
+      border-radius: 8px;
+      max-height: 240px;
+      overflow-y: auto;
+      font-family: "JetBrains Mono", monospace;
+      font-size: 12px;
+    }
+    .activity-row {
+      display: flex;
+      gap: 12px;
+      padding: 8px 12px;
+      border-bottom: 1px solid #262A33;
+    }
+    .activity-row:last-child { border-bottom: none; }
+    .activity-time { color: var(--text-muted); flex-shrink: 0; }
+    .activity-type { color: var(--active); flex-shrink: 0; }
+    .activity-dir { color: var(--text-muted); flex-shrink: 0; }
+    .activity-path { color: var(--text); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    #preset-categories { display: flex; gap: 8px; flex-wrap: wrap; margin-bottom: 12px; }
+    #preset-categories button {
+      background: transparent;
+      color: var(--text-muted);
+      font-weight: 400;
+    }
+    #preset-categories button.active { background: var(--primary); color: #0B1220; font-weight: 600; }
+    .preset-card {
+      background: var(--surface);
+      border-radius: 8px;
+      padding: 12px 16px;
+      margin-bottom: 8px;
+      display: flex;
+      align-items: center;
+      gap: 12px;
+    }
+    .preset-card .meta { flex: 1; }
+    .preset-card .name { font-weight: 600; font-family: "JetBrains Mono", monospace; font-size: 13px; }
+    .preset-card .description { color: var(--text-muted); font-size: 12px; }
+    form.runner-form {
+      background: var(--surface);
+      border-radius: 8px;
+      padding: 16px;
+      display: grid;
+      gap: 8px;
+      grid-template-columns: 120px 1fr;
+    }
+    form.runner-form .full { grid-column: 1 / -1; }
+    form.runner-form textarea {
+      font-family: "JetBrains Mono", monospace;
+      font-size: 12px;
+      resize: vertical;
+      min-height: 60px;
+    }
+    #runner-response {
+      background: var(--surface);
+      border-radius: 8px;
+      padding: 12px 16px;
+      margin-top: 12px;
+      font-family: "JetBrains Mono", monospace;
+      font-size: 12px;
+      white-space: pre-wrap;
+      word-break: break-word;
+    }
+    #runner-response .status { font-weight: 600; margin-bottom: 8px; }
+    #runner-response .status.ok { color: #3DD68C; }
+    #runner-response .status.error { color: var(--error); }
+  </style>
+</head>
+<body>
+  <div id="status-banner"></div>
+  <header>
+    <h1>Chaos API</h1>
+    <div class="row">
+      <span style="color: var(--text-muted)">control API:</span>
+      <input id="control-url" type="text" value="http://localhost:51820" />
+      <button id="connect">Conectar</button>
+    </div>
+  </header>
+  <main>
+    <div id="error"></div>
+    <div id="scenario-list"></div>
+    <h2>Atividade recente</h2>
+    <div id="activity-list"></div>
+    <h2>Biblioteca de presets</h2>
+    <div id="preset-categories"></div>
+    <div id="preset-list"></div>
+    <h2>Import/export de config</h2>
+    <div class="row">
+      <button id="export-config" type="button">Exportar JSON</button>
+      <button id="import-config" type="button">Importar JSON</button>
+      <input id="import-file" type="file" accept="application/json" style="display: none" />
+    </div>
+    <h2>Runner de requisição de teste</h2>
+    <form class="runner-form" id="runner-form">
+      <select name="method" id="runner-method">
+        <option>GET</option>
+        <option>POST</option>
+        <option>PUT</option>
+        <option>PATCH</option>
+        <option>DELETE</option>
+      </select>
+      <input name="url" type="text" placeholder="http://localhost:3000/orders" required />
+      <textarea class="full" name="headers" placeholder='headers JSON (ex: {"Authorization":"Bearer ..."})'></textarea>
+      <textarea class="full" name="body" placeholder="body (JSON ou texto — ignorado em GET/DELETE)"></textarea>
+      <button class="full" type="submit">Enviar</button>
+    </form>
+    <div id="runner-response"></div>
+    <h2>Adicionar cenário</h2>
+    <form class="add-form" id="add-form">
+      <select name="type" id="type">
+        <option value="delay">delay</option>
+        <option value="error-response">error-response</option>
+        <option value="connection-reset">connection-reset</option>
+        <option value="unavailable">unavailable</option>
+        <option value="malformed-response">malformed-response</option>
+        <option value="stale-response">stale-response</option>
+      </select>
+      <input name="rate" type="number" min="0" max="1" step="0.1" value="1" placeholder="rate (0-1)" />
+      <input class="full" name="pattern" type="text" placeholder="rota (glob, ex: /orders/*) — vazio = global" />
+      <input class="full" name="options" type="text" placeholder='options JSON (ex: {"minMs":500,"maxMs":2000})' />
+      <button class="full" type="submit">Ativar cenário</button>
+    </form>
+  </main>
+  <script src="app.js"></script>
+</body>
+</html>

package/dist/guardrail.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+export interface GuardrailOptions {
+    allowInProduction?: boolean;
+}
+/**
+ * Blocks chaos scenarios when NODE_ENV=production unless explicitly overridden.
+ * See docs/PRD.md "Riscos" — an activated scenario leaking to prod breaks real clients.
+ */
+export declare function isBlockedByGuardrail(options?: GuardrailOptions): boolean;
+/** Test-only: resets the one-time warning so guardrail tests can assert on it repeatedly. */
+export declare function resetGuardrailWarning(): void;

package/dist/guardrail.js ADDED Viewed

@@ -0,0 +1,20 @@
+let warned = false;
+/**
+ * Blocks chaos scenarios when NODE_ENV=production unless explicitly overridden.
+ * See docs/PRD.md "Riscos" — an activated scenario leaking to prod breaks real clients.
+ */
+export function isBlockedByGuardrail(options = {}) {
+    const isProduction = process.env.NODE_ENV === "production";
+    if (!isProduction || options.allowInProduction)
+        return false;
+    if (!warned) {
+        warned = true;
+        console.warn("[chaos-api] NODE_ENV=production detected — chaos scenarios disabled. " +
+            "Pass { allowInProduction: true } to chaos() to override (not recommended).");
+    }
+    return true;
+}
+/** Test-only: resets the one-time warning so guardrail tests can assert on it repeatedly. */
+export function resetGuardrailWarning() {
+    warned = false;
+}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,22 @@
+export { chaos } from "./adapters/express.js";
+export type { ChaosOptions, ChaosInstance } from "./adapters/express.js";
+export { chaosFastifyPlugin } from "./adapters/fastify.js";
+export type { ChaosFastifyPlugin } from "./adapters/fastify.js";
+export { createChaosNestMiddleware } from "./adapters/nestjs.js";
+export type { ChaosNestMiddleware, NestLikeRequest, NestLikeResponse, NestMiddlewareFn } from "./adapters/nestjs.js";
+export { chaosKoaMiddleware } from "./adapters/koa.js";
+export type { ChaosKoaMiddleware } from "./adapters/koa.js";
+export { StateStore, globToRegex } from "./core/state-store.js";
+export type { RegisterScenarioInput, UpdateScenarioInput } from "./core/state-store.js";
+export { ActivityLog } from "./core/activity-log.js";
+export type { ActivityEvent, RecordActivityInput } from "./core/activity-log.js";
+export { ScenarioEngine } from "./core/scenario-engine.js";
+export type { ChaosRequestInfo, ChaosResponseController, LegacyScenarioType, ScenarioConfig, ScenarioDirection, ScenarioHandler, ScenarioResult, ScenarioScope, ScenarioType, } from "./core/types.js";
+export * from "./scenarios/index.js";
+export { PRESET_CATALOG, applyPreset, findPreset, listPresets } from "./presets/index.js";
+export type { ApplyPresetOverrides, PresetCategory, PresetDefinition } from "./presets/index.js";
+export { createChaosFetch } from "./outbound/index.js";
+export type { ChaosFetchOptions } from "./outbound/index.js";
+export { createControlApi } from "./dashboard/server/control-api.js";
+export { startDashboard } from "./dashboard/server/index.js";
+export { isBlockedByGuardrail, resetGuardrailWarning } from "./guardrail.js";

package/dist/index.js ADDED Viewed

@@ -0,0 +1,13 @@
+export { chaos } from "./adapters/express.js";
+export { chaosFastifyPlugin } from "./adapters/fastify.js";
+export { createChaosNestMiddleware } from "./adapters/nestjs.js";
+export { chaosKoaMiddleware } from "./adapters/koa.js";
+export { StateStore, globToRegex } from "./core/state-store.js";
+export { ActivityLog } from "./core/activity-log.js";
+export { ScenarioEngine } from "./core/scenario-engine.js";
+export * from "./scenarios/index.js";
+export { PRESET_CATALOG, applyPreset, findPreset, listPresets } from "./presets/index.js";
+export { createChaosFetch } from "./outbound/index.js";
+export { createControlApi } from "./dashboard/server/control-api.js";
+export { startDashboard } from "./dashboard/server/index.js";
+export { isBlockedByGuardrail, resetGuardrailWarning } from "./guardrail.js";

package/dist/outbound/chaos-fetch.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import type { StateStore } from "../core/state-store.js";
+import { type GuardrailOptions } from "../guardrail.js";
+export interface ChaosFetchOptions extends GuardrailOptions {
+    /** Real fetch to call through to when no outbound scenario applies. Defaults to global `fetch`. */
+    baseFetch?: typeof fetch;
+}
+/**
+ * Wraps `fetch` so outbound calls can be intercepted by chaos scenarios scoped to a
+ * destination host (docs/PRD.md 6.4) — same `StateStore` the inbound middleware uses, scenarios
+ * registered with `{ direction: "outbound" }`. Fast-path: calls straight through to the real
+ * fetch when no outbound scenario matches the destination host, same no-op principle as inbound.
+ */
+export declare function createChaosFetch(store: StateStore, options?: ChaosFetchOptions): typeof fetch;

package/dist/outbound/chaos-fetch.js ADDED Viewed

@@ -0,0 +1,50 @@
+import { ScenarioEngine } from "../core/scenario-engine.js";
+import { isBlockedByGuardrail } from "../guardrail.js";
+function extractHost(input) {
+    const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    return new URL(url).host;
+}
+function bodyToString(body) {
+    return typeof body === "string" ? body : JSON.stringify(body ?? null);
+}
+/**
+ * Wraps `fetch` so outbound calls can be intercepted by chaos scenarios scoped to a
+ * destination host (docs/PRD.md 6.4) — same `StateStore` the inbound middleware uses, scenarios
+ * registered with `{ direction: "outbound" }`. Fast-path: calls straight through to the real
+ * fetch when no outbound scenario matches the destination host, same no-op principle as inbound.
+ */
+export function createChaosFetch(store, options = {}) {
+    const baseFetch = options.baseFetch ?? fetch;
+    const engine = new ScenarioEngine(store);
+    return (async (input, init) => {
+        const host = extractHost(input);
+        if (isBlockedByGuardrail(options) || store.getActiveOutbound(host).length === 0) {
+            return baseFetch(input, init);
+        }
+        const method = (init?.method ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
+        const recorded = { headers: {} };
+        const controller = {
+            status: (code) => {
+                recorded.status = code;
+            },
+            header: (name, value) => {
+                recorded.headers[name] = value;
+            },
+            send: (body) => {
+                recorded.body = body;
+            },
+        };
+        const result = await engine.resolveOutbound({ method, path: host }, controller);
+        if (result === "continue") {
+            return baseFetch(input, init);
+        }
+        if (recorded.status === undefined) {
+            // connection-reset: no response was ever written — simulate a dropped/failed connection.
+            throw new TypeError("chaos-api: simulated network failure (connection-reset)");
+        }
+        const headers = new Headers(recorded.headers);
+        if (!headers.has("Content-Type"))
+            headers.set("Content-Type", "application/json");
+        return new Response(bodyToString(recorded.body), { status: recorded.status, headers });
+    });
+}

package/dist/outbound/index.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { createChaosFetch, type ChaosFetchOptions } from "./chaos-fetch.js";

package/dist/outbound/index.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { createChaosFetch } from "./chaos-fetch.js";

package/dist/presets/catalog.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import type { PresetDefinition } from "./types.js";
+/**
+ * Subset of the ~85-item catalog (docs/PRD.md 6.3) shipped in this increment — the categories
+ * flagged HTTP-simulável in the "Next" roadmap that don't need chaos outbound (6.4) or a
+ * composed-preset design (erro humano/black swan) to be useful today. Each entry is metadata
+ * layered on top of the 6 primitives (6.2) — it does not add a new `ScenarioType`.
+ */
+export declare const PRESET_CATALOG: PresetDefinition[];

package/dist/presets/catalog.js ADDED Viewed

@@ -0,0 +1,157 @@
+/**
+ * Subset of the ~85-item catalog (docs/PRD.md 6.3) shipped in this increment — the categories
+ * flagged HTTP-simulável in the "Next" roadmap that don't need chaos outbound (6.4) or a
+ * composed-preset design (erro humano/black swan) to be useful today. Each entry is metadata
+ * layered on top of the 6 primitives (6.2) — it does not add a new `ScenarioType`.
+ */
+export const PRESET_CATALOG = [
+    // Segurança
+    {
+        name: "auth-service-down",
+        category: "seguranca",
+        description: "Serviço de autenticação/autorização indisponível",
+        type: "unavailable",
+        options: { statusCode: 503 },
+    },
+    {
+        name: "expired-credentials",
+        category: "seguranca",
+        description: "Credenciais/token expirados",
+        type: "error-response",
+        options: { statusCodes: [401] },
+    },
+    {
+        name: "authz-denied",
+        category: "seguranca",
+        description: "Autorização negada (permissão insuficiente)",
+        type: "error-response",
+        options: { statusCodes: [403] },
+    },
+    {
+        name: "secret-rotation-failure",
+        category: "seguranca",
+        description: "Falha na rotação de secret — serviço não consegue autenticar",
+        type: "error-response",
+        options: { statusCodes: [500], body: { error: "secret rotation failure" } },
+    },
+    // Dependências externas
+    {
+        name: "third-party-timeout",
+        category: "dependencias-externas",
+        description: "Dependência de terceiro (API externa) não responde",
+        type: "connection-reset",
+    },
+    {
+        name: "third-party-500",
+        category: "dependencias-externas",
+        description: "Dependência de terceiro retorna erro 5xx",
+        type: "error-response",
+        options: { statusCodes: [502] },
+    },
+    {
+        name: "third-party-rate-limit",
+        category: "dependencias-externas",
+        description: "Dependência de terceiro aplica rate limit (429)",
+        type: "error-response",
+        options: { statusCodes: [429], headers: { "Retry-After": "30" } },
+    },
+    {
+        name: "object-storage-down",
+        category: "dependencias-externas",
+        description: "Object storage externo (S3 e similares) indisponível",
+        type: "unavailable",
+        options: { statusCode: 503 },
+    },
+    {
+        name: "idp-down",
+        category: "dependencias-externas",
+        description: "Identity provider externo indisponível",
+        type: "unavailable",
+        options: { statusCode: 503 },
+    },
+    // Configuração
+    {
+        name: "missing-env-var",
+        category: "configuracao",
+        description: "Variável de ambiente obrigatória faltando",
+        type: "error-response",
+        options: { statusCodes: [500], body: { error: "missing required environment variable" } },
+    },
+    {
+        name: "invalid-config",
+        category: "configuracao",
+        description: "Configuração inválida detectada na inicialização",
+        type: "error-response",
+        options: { statusCodes: [500], body: { error: "invalid configuration" } },
+    },
+    {
+        name: "wrong-endpoint",
+        category: "configuracao",
+        description: "Endpoint de dependência configurado errado",
+        type: "unavailable",
+        options: { statusCode: 503 },
+    },
+    {
+        name: "feature-flag-misconfigured",
+        category: "configuracao",
+        description: "Feature flag com valor incorreto quebra o fluxo",
+        type: "error-response",
+        options: { statusCodes: [500], body: { error: "feature flag misconfigured" } },
+    },
+    // Resource Exhaustion
+    {
+        name: "thread-pool-exhausted",
+        category: "resource-exhaustion",
+        description: "Thread pool esgotado",
+        type: "unavailable",
+        options: { statusCode: 503, retryAfterSeconds: 5 },
+    },
+    {
+        name: "connection-pool-exhausted",
+        category: "resource-exhaustion",
+        description: "Connection pool (DB/HTTP) esgotado",
+        type: "unavailable",
+        options: { statusCode: 503, retryAfterSeconds: 5 },
+    },
+    {
+        name: "ephemeral-ports-exhausted",
+        category: "resource-exhaustion",
+        description: "Portas efêmeras esgotadas — novas conexões falham",
+        type: "connection-reset",
+    },
+    {
+        name: "disk-iops-exhausted",
+        category: "resource-exhaustion",
+        description: "IOPS de disco no limite — respostas fortemente lentas",
+        type: "delay",
+        options: { minMs: 3000, maxMs: 8000 },
+    },
+    // Filesystem
+    {
+        name: "permission-denied",
+        category: "filesystem",
+        description: "Permissão negada ao acessar arquivo/recurso",
+        type: "error-response",
+        options: { statusCodes: [403] },
+    },
+    {
+        name: "missing-tls-cert",
+        category: "filesystem",
+        description: "Certificado TLS ausente no filesystem",
+        type: "error-response",
+        options: { statusCodes: [495], body: { error: "TLS certificate not found" } },
+    },
+    {
+        name: "nfs-unavailable",
+        category: "filesystem",
+        description: "Volume NFS indisponível",
+        type: "unavailable",
+        options: { statusCode: 503 },
+    },
+    {
+        name: "filesystem-corruption",
+        category: "filesystem",
+        description: "Corrupção de dados no filesystem — resposta corrompida",
+        type: "malformed-response",
+    },
+];

package/dist/presets/index.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { StateStore } from "../core/state-store.js";
+import type { ScenarioConfig, ScenarioScope } from "../core/types.js";
+import type { PresetCategory, PresetDefinition } from "./types.js";
+export { PRESET_CATALOG } from "./catalog.js";
+export type { PresetCategory, PresetDefinition } from "./types.js";
+export declare function findPreset(name: string): PresetDefinition | undefined;
+export declare function listPresets(category?: PresetCategory): PresetDefinition[];
+export interface ApplyPresetOverrides {
+    scope?: ScenarioScope;
+    rate?: number;
+    enabled?: boolean;
+    options?: Record<string, unknown>;
+}
+/** Registers a preset by name on `store`, resolving it to its `{primitivo, options, scope}` (docs/PRD.md 6.3). */
+export declare function applyPreset(store: StateStore, name: string, overrides?: ApplyPresetOverrides): ScenarioConfig;

package/dist/presets/index.js ADDED Viewed

@@ -0,0 +1,22 @@
+import { PRESET_CATALOG } from "./catalog.js";
+export { PRESET_CATALOG } from "./catalog.js";
+export function findPreset(name) {
+    return PRESET_CATALOG.find((preset) => preset.name === name);
+}
+export function listPresets(category) {
+    return category ? PRESET_CATALOG.filter((preset) => preset.category === category) : [...PRESET_CATALOG];
+}
+/** Registers a preset by name on `store`, resolving it to its `{primitivo, options, scope}` (docs/PRD.md 6.3). */
+export function applyPreset(store, name, overrides = {}) {
+    const preset = findPreset(name);
+    if (!preset) {
+        throw new Error(`unknown preset "${name}"`);
+    }
+    return store.register({
+        type: preset.type,
+        scope: overrides.scope ?? preset.scope ?? "global",
+        rate: overrides.rate ?? preset.rate ?? 1,
+        enabled: overrides.enabled,
+        options: { ...preset.options, ...overrides.options },
+    });
+}

package/dist/presets/types.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import type { ScenarioScope, ScenarioType } from "../core/types.js";
+/**
+ * Category subset shipped in this increment (docs/PRD.md 6.3 "Next" roadmap): only the
+ * categories flagged HTTP-simulável that don't need chaos outbound (6.4) or a composed-preset
+ * design (erro humano/black swan) to be useful today.
+ */
+export type PresetCategory = "seguranca" | "dependencias-externas" | "configuracao" | "resource-exhaustion" | "filesystem";
+export interface PresetDefinition {
+    /** Stable kebab-case id, e.g. "auth-service-down". Unique within PRESET_CATALOG. */
+    name: string;
+    category: PresetCategory;
+    description: string;
+    type: ScenarioType;
+    options?: Record<string, unknown>;
+    scope?: ScenarioScope;
+    rate?: number;
+}

package/dist/presets/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/scenarios/connection-reset.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import type { ScenarioHandler } from "../core/types.js";
+/**
+ * Simulates a dropped connection / hung upstream: intentionally never writes a response.
+ * Adapters must not call `next()`/end the request when this scenario terminates the
+ * chain — the connection stays open until the client or server times out.
+ */
+export declare const connectionResetScenario: ScenarioHandler;

package/dist/scenarios/connection-reset.js ADDED Viewed

@@ -0,0 +1,8 @@
+/**
+ * Simulates a dropped connection / hung upstream: intentionally never writes a response.
+ * Adapters must not call `next()`/end the request when this scenario terminates the
+ * chain — the connection stays open until the client or server times out.
+ */
+export const connectionResetScenario = () => {
+    return "terminated";
+};

package/dist/scenarios/delay.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import type { ScenarioHandler } from "../core/types.js";
+export interface DelayOptions {
+    minMs?: number;
+    maxMs?: number;
+}
+export declare const delayScenario: ScenarioHandler;

package/dist/scenarios/delay.js ADDED Viewed

@@ -0,0 +1,9 @@
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export const delayScenario = async (_ctx, options) => {
+    const { minMs = 500, maxMs } = options;
+    const ms = maxMs !== undefined && maxMs > minMs ? minMs + Math.random() * (maxMs - minMs) : minMs;
+    await sleep(ms);
+    return "continue";
+};

package/dist/scenarios/error-response.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type { ScenarioHandler } from "../core/types.js";
+export interface ErrorResponseOptions {
+    statusCodes?: number[];
+    body?: unknown;
+    headers?: Record<string, string>;
+    /** Restrict to these HTTP methods (e.g. write verbs only). Omitted = all methods. */
+    methods?: string[];
+}
+export declare const errorResponseScenario: ScenarioHandler;

package/dist/scenarios/error-response.js ADDED Viewed

@@ -0,0 +1,13 @@
+export const errorResponseScenario = (ctx, options) => {
+    const { statusCodes = [500], body, headers, methods } = options;
+    if (methods && !methods.includes(ctx.req.method.toUpperCase()))
+        return "continue";
+    const code = statusCodes[Math.floor(Math.random() * statusCodes.length)];
+    if (headers) {
+        for (const [name, value] of Object.entries(headers))
+            ctx.res.header(name, value);
+    }
+    ctx.res.status(code);
+    ctx.res.send(body ?? { error: "chaos-api: injected error", status: code });
+    return "terminated";
+};

package/dist/scenarios/index.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export { delayScenario, type DelayOptions } from "./delay.js";
+export { errorResponseScenario, type ErrorResponseOptions } from "./error-response.js";
+export { connectionResetScenario } from "./connection-reset.js";
+export { unavailableScenario, type UnavailableOptions } from "./unavailable.js";
+export { malformedResponseScenario, type MalformedResponseOptions } from "./malformed-response.js";
+export { staleResponseScenario, type StaleResponseOptions } from "./stale-response.js";
+export { SCENARIO_REGISTRY, type ScenarioDefinition } from "./registry.js";