@henriquecosta/chaos-api 1.0.0

package/dist/scenarios/index.js

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

package/dist/scenarios/malformed-response.d.ts

@@ -0,0 +1,11 @@
+import type { ScenarioHandler } from "../core/types.js";
+export interface MalformedResponseOptions {
+    statusCode?: number;
+    /** Sent as-is; mismatched with the actual body on purpose (default: declares JSON, body is garbled text). */
+    contentType?: string;
+    /** JSON-serialized then truncated. Omitted = a built-in garbled JSON fragment. */
+    body?: unknown;
+    /** Fraction of the serialized body to keep, 0..1. Default 0.5 (cut mid-payload). */
+    truncateRatio?: number;
+}
+export declare const malformedResponseScenario: ScenarioHandler;

package/dist/scenarios/malformed-response.js

@@ -0,0 +1,13 @@
+const DEFAULT_GARBLED = '{"data": [{"id": 1, "nam';
+function truncate(text, ratio) {
+    const clamped = Math.min(1, Math.max(0, ratio));
+    return text.slice(0, Math.max(1, Math.floor(text.length * clamped)));
+}
+export const malformedResponseScenario = (ctx, options) => {
+    const { statusCode = 200, contentType = "application/json", body, truncateRatio = 0.5, } = options;
+    const payload = body !== undefined ? truncate(JSON.stringify(body), truncateRatio) : DEFAULT_GARBLED;
+    ctx.res.header("Content-Type", contentType);
+    ctx.res.status(statusCode);
+    ctx.res.send(payload);
+    return "terminated";
+};

package/dist/scenarios/random-error.d.ts

@@ -0,0 +1,6 @@
+import type { ScenarioHandler } from "../core/types.js";
+export interface RandomErrorOptions {
+    statusCodes?: number[];
+    body?: unknown;
+}
+export declare const randomErrorScenario: ScenarioHandler;

package/dist/scenarios/random-error.js

@@ -0,0 +1,7 @@
+export const randomErrorScenario = (ctx, options) => {
+    const { statusCodes = [500], body } = options;
+    const code = statusCodes[Math.floor(Math.random() * statusCodes.length)];
+    ctx.res.status(code);
+    ctx.res.send(body ?? { error: "chaos-api: injected error", status: code });
+    return "terminated";
+};

package/dist/scenarios/random-timeout.d.ts

@@ -0,0 +1,7 @@
+import type { ScenarioHandler } from "../core/types.js";
+/**
+ * Simulates a 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 randomTimeoutScenario: ScenarioHandler;

package/dist/scenarios/random-timeout.js

@@ -0,0 +1,8 @@
+/**
+ * Simulates a 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 randomTimeoutScenario = () => {
+    return "terminated";
+};

package/dist/scenarios/registry.d.ts

@@ -0,0 +1,12 @@
+import type { ScenarioHandler, ScenarioType } from "../core/types.js";
+export interface ScenarioDefinition {
+    type: ScenarioType;
+    handler: ScenarioHandler;
+}
+/**
+ * Single source of truth for the v2 primitives (docs/PRD.md 6.2): type, handler, and
+ * apply order for combined scenarios. Array order = fixed priority order.
+ * Adding a primitive only touches this file plus the new scenario module — the engine
+ * itself doesn't change (docs/PRD.md 6.1 "registry pattern").
+ */
+export declare const SCENARIO_REGISTRY: ScenarioDefinition[];

package/dist/scenarios/registry.js

@@ -0,0 +1,20 @@
+import { connectionResetScenario } from "./connection-reset.js";
+import { delayScenario } from "./delay.js";
+import { errorResponseScenario } from "./error-response.js";
+import { malformedResponseScenario } from "./malformed-response.js";
+import { staleResponseScenario } from "./stale-response.js";
+import { unavailableScenario } from "./unavailable.js";
+/**
+ * Single source of truth for the v2 primitives (docs/PRD.md 6.2): type, handler, and
+ * apply order for combined scenarios. Array order = fixed priority order.
+ * Adding a primitive only touches this file plus the new scenario module — the engine
+ * itself doesn't change (docs/PRD.md 6.1 "registry pattern").
+ */
+export const SCENARIO_REGISTRY = [
+    { type: "delay", handler: delayScenario },
+    { type: "error-response", handler: errorResponseScenario },
+    { type: "connection-reset", handler: connectionResetScenario },
+    { type: "unavailable", handler: unavailableScenario },
+    { type: "malformed-response", handler: malformedResponseScenario },
+    { type: "stale-response", handler: staleResponseScenario },
+];

package/dist/scenarios/stale-response.d.ts

@@ -0,0 +1,9 @@
+import type { ScenarioHandler } from "../core/types.js";
+export interface StaleResponseOptions {
+    /** The stale/cached payload to serve instead of the real one. */
+    body?: unknown;
+    statusCode?: number;
+    /** Sets the `Age` header (seconds since the cached response was fresh). */
+    ageSeconds?: number;
+}
+export declare const staleResponseScenario: ScenarioHandler;

package/dist/scenarios/stale-response.js

@@ -0,0 +1,10 @@
+export const staleResponseScenario = (ctx, options) => {
+    const { body, statusCode = 200, ageSeconds } = options;
+    if (ageSeconds !== undefined) {
+        ctx.res.header("Age", String(ageSeconds));
+    }
+    ctx.res.header("X-Chaos-Stale", "true");
+    ctx.res.status(statusCode);
+    ctx.res.send(body ?? { stale: true });
+    return "terminated";
+};

package/dist/scenarios/unavailable-503.d.ts

@@ -0,0 +1,5 @@
+import type { ScenarioHandler } from "../core/types.js";
+export interface Unavailable503Options {
+    retryAfterSeconds?: number;
+}
+export declare const unavailable503Scenario: ScenarioHandler;

package/dist/scenarios/unavailable-503.js

@@ -0,0 +1,9 @@
+export const unavailable503Scenario = (ctx, options) => {
+    const { retryAfterSeconds } = options;
+    if (retryAfterSeconds !== undefined) {
+        ctx.res.header("Retry-After", String(retryAfterSeconds));
+    }
+    ctx.res.status(503);
+    ctx.res.send({ error: "chaos-api: service unavailable" });
+    return "terminated";
+};

package/dist/scenarios/unavailable.d.ts

@@ -0,0 +1,7 @@
+import type { ScenarioHandler } from "../core/types.js";
+export interface UnavailableOptions {
+    /** 503 (service unavailable), 507 (insufficient storage), 429 (rate limited), etc. */
+    statusCode?: number;
+    retryAfterSeconds?: number;
+}
+export declare const unavailableScenario: ScenarioHandler;

package/dist/scenarios/unavailable.js

@@ -0,0 +1,9 @@
+export const unavailableScenario = (ctx, options) => {
+    const { statusCode = 503, retryAfterSeconds } = options;
+    if (retryAfterSeconds !== undefined) {
+        ctx.res.header("Retry-After", String(retryAfterSeconds));
+    }
+    ctx.res.status(statusCode);
+    ctx.res.send({ error: "chaos-api: service unavailable" });
+    return "terminated";
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@henriquecosta/chaos-api",
+  "version": "1.0.0",
+  "description": "Middleware pra simular falhas de producao (delay, erros, timeout, indisponibilidade, respostas malformadas/obsoletas) em APIs Express/Fastify/NestJS/Koa durante desenvolvimento.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "chaos-api": "./dist/bin/chaos-api.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-ui.mjs",
+    "dev": "tsx watch src/bin/chaos-api.ts dashboard",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "express": ">=4",
+    "fastify": ">=4",
+    "koa": ">=2"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "fastify": {
+      "optional": true
+    },
+    "koa": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/koa": "^2.15.2",
+    "@types/node": "^20.14.0",
+    "@types/supertest": "^6.0.2",
+    "express": "^4.19.2",
+    "fastify": "^4.28.1",
+    "koa": "^2.16.4",
+    "supertest": "^7.0.0",
+    "tsx": "^4.16.2",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}