@omniaura/scenario-sim 0.1.0

package/dist/engine-HE7MEQHD.js

@@ -0,0 +1,15 @@
+import {
+  Simulator,
+  UPGRADED_HEADER,
+  isUpgraded,
+  matchPath,
+  upgradedResponse
+} from "./chunk-KU4W4SKO.js";
+export {
+  Simulator,
+  UPGRADED_HEADER,
+  isUpgraded,
+  matchPath,
+  upgradedResponse
+};
+//# sourceMappingURL=engine-HE7MEQHD.js.map

package/dist/engine-HE7MEQHD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/examples.d.ts

@@ -0,0 +1,38 @@
+import { S as ScenarioDefinition } from './scenario--CvzkzX_.js';
+
+/**
+ * Generic example world shipped with the package (also what the test-suite and
+ * consumer smoke test use). No product data — a notes CRUD API, a live notes
+ * feed over SSE, and a streaming-chat WebSocket protocol with per-topic event
+ * ids and resume. Scenario variants layer faults and timing on top.
+ *
+ * WebSocket protocol (`chat-v1` subprotocol), deliberately shaped like real
+ * chat backends so client reconnect logic gets exercised:
+ *   client → { type:"subscribe", topic, sinceEventID? }
+ *          → { type:"send", topic, clientMessageID, content }
+ *   server → { type:"ready" } · { type:"subscribed", topic, replayed, last }
+ *          → { type:"message", topic, eventID, id, role, content }
+ *          → { type:"stream.start", streamID } · { type:"chat.content", streamID, seq, content }
+ *          → { type:"stream.done", streamID } · { type:"resume.miss", topic } · { type:"error", error }
+ */
+
+interface Note extends Record<string, unknown> {
+    id: string;
+    title: string;
+    body: string;
+    done: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+declare const NOTES_TOPIC = "notes";
+declare const chatTopic: (room: string) => string;
+declare const happy: ScenarioDefinition;
+declare const empty: ScenarioDefinition;
+declare const slow: ScenarioDefinition;
+declare const flaky: ScenarioDefinition;
+declare const malformedApi: ScenarioDefinition;
+declare const streamDrop: ScenarioDefinition;
+declare const manualClock: ScenarioDefinition;
+declare const scenarios: ScenarioDefinition[];
+
+export { NOTES_TOPIC, type Note, chatTopic, scenarios as default, empty, flaky, happy, malformedApi, manualClock, scenarios, slow, streamDrop };

package/dist/examples.js

@@ -0,0 +1,233 @@
+import {
+  crud,
+  defineScenario,
+  json,
+  malformed,
+  problem,
+  route,
+  sequence,
+  sse,
+  ws
+} from "./chunk-44ZHRYG6.js";
+
+// src/examples/notes-chat.ts
+var NOTES_TOPIC = "notes";
+var chatTopic = (room) => `chat:${room}`;
+var WORDS = ["alpha", "harbor", "signal", "quiet", "meadow", "copper", "lantern", "orbit", "velvet", "cinder"];
+function baseRoutes() {
+  return [
+    route.get("/api/health", () => json({ ok: true })),
+    ...crud("/api/notes", "notes", {
+      sort: (a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id),
+      validate: (body) => body.title !== void 0 && typeof body.title !== "string" ? "title must be a string" : null,
+      create: (body, ctx) => ({
+        id: ctx.rng.id("note"),
+        title: String(body.title ?? "Untitled"),
+        body: String(body.body ?? ""),
+        done: Boolean(body.done ?? false),
+        createdAt: ctx.clock.iso(),
+        updatedAt: ctx.clock.iso()
+      }),
+      update: (cur, body, ctx) => ({ ...cur, ...body, id: cur.id, updatedAt: ctx.clock.iso() })
+    }),
+    // Bulk action with a side effect: marks everything done and emits one custom event.
+    route.post("/api/notes:complete-all", (ctx) => {
+      let n = 0;
+      for (const note of ctx.state.list("notes", { where: (x) => !x.done })) {
+        ctx.state.update("notes", note.id, { done: true, updatedAt: ctx.clock.iso() });
+        n++;
+      }
+      ctx.state.custom("notes", "completed-all", { count: n });
+      return json({ completed: n });
+    }),
+    route.get("/api/chat/rooms/:room/history", (ctx) => {
+      const topic = chatTopic(ctx.params.room);
+      const { events } = ctx.streams.topics.replay(topic, ctx.query.get("sinceEventID") ?? "0");
+      return json({ items: events.map((e) => ({ ...e.data, eventID: e.eventID, topic })) });
+    })
+  ];
+}
+function streams(opts = {}) {
+  const chunkDelay = opts.chunkDelayMs ?? 40;
+  return [
+    // Live notes feed: every store mutation on "notes" becomes an SSE event, resumable via Last-Event-ID.
+    sse("/api/notes/events", (ctx, stream) => {
+      stream.subscribe(NOTES_TOPIC);
+      stream.send({ type: "hello", run: ctx.run.id }, { event: "hello" });
+    }, { keepaliveMs: 15e3 }),
+    ws("/api/chat/ws", {
+      protocols: ["chat-v1"],
+      onOpen(ctx, socket) {
+        socket.send({ type: "ready", protocolVersion: 1, run: ctx.run.id });
+      },
+      onMessage(ctx, socket, raw) {
+        let frame;
+        try {
+          frame = JSON.parse(String(raw));
+        } catch {
+          return socket.send({ type: "error", error: "invalid json" });
+        }
+        if (frame.type === "subscribe" && frame.topic) {
+          const r = socket.subscribe(frame.topic, { since: frame.sinceEventID ?? null });
+          socket.send({ type: "subscribed", topic: frame.topic, replayed: r.replayed, last: r.last });
+          if (r.missed) socket.send({ type: "resume.miss", topic: frame.topic });
+          return;
+        }
+        if (frame.type === "send" && frame.topic && frame.content !== void 0) {
+          const id = ctx.rng.id("msg");
+          ctx.streams.publish(frame.topic, { type: "message", id, clientMessageID: frame.clientMessageID ?? "", role: "user", content: frame.content, createdAt: ctx.clock.iso() });
+          respond(ctx, socket, frame.topic, frame.content, chunkDelay, opts);
+          return;
+        }
+        socket.send({ type: "error", error: `unknown frame ${frame.type ?? "?"}` });
+      }
+    })
+  ];
+  function respond(ctx, socket, topic, prompt, delay, o) {
+    const streamID = ctx.rng.id("stream");
+    const words = prompt.split(/\s+/).filter(Boolean).slice(0, 12);
+    const reply = ["Echoing", ...words.map((w) => w.toUpperCase()), "\u2014", ctx.rng.pick(WORDS), ctx.rng.pick(WORDS)];
+    ctx.clock.after(o.streamDelayMs ?? 100, () => {
+      ctx.streams.publish(topic, { type: "stream.start", streamID });
+      reply.forEach((word, i) => {
+        ctx.clock.after(delay * (i + 1), () => {
+          if (o.dropMidStream && i === Math.floor(reply.length / 2)) {
+            ctx.streams.disconnect({ topic }, { drop: true });
+            ctx.log("dropped connection mid-stream", { streamID });
+          }
+          ctx.streams.publish(topic, { type: "chat.content", streamID, seq: i + 1, content: word + " " });
+        }, `chunk ${i + 1}`);
+      });
+      ctx.clock.after(delay * (reply.length + 1), () => {
+        const id = ctx.rng.id("msg");
+        ctx.streams.publish(topic, { type: "stream.done", streamID, messageID: id });
+        ctx.streams.publish(topic, { type: "message", id, role: "assistant", content: reply.join(" ").trim(), createdAt: ctx.clock.iso() });
+      }, "stream.done");
+    }, "stream.start");
+  }
+}
+function seedNotes(count) {
+  return ({ state, rng, clock, streams: streams2 }) => {
+    for (let i = 0; i < count; i++) {
+      const created = clock.iso(-(count - i) * 6e4);
+      state.insert("notes", { id: rng.id("note"), title: `${rng.pick(WORDS)} ${rng.pick(WORDS)}`, body: `Note ${i + 1}`, done: rng.chance(0.3), createdAt: created, updatedAt: created });
+    }
+    state.on((e) => {
+      if (e.collection !== "notes") return;
+      if (e.kind === "custom") streams2.publish(NOTES_TOPIC, { type: `notes.${e.name}`, ...e.data });
+      else streams2.publish(NOTES_TOPIC, { type: `notes.${e.kind}`, id: e.id, note: e.record ?? null, previous: e.previous ?? null });
+    });
+  };
+}
+var actions = {
+  /** Emit N synthetic note inserts quickly (list growth / scroll anchoring). */
+  burst: ({ state, rng, clock, args }) => {
+    const n = Number(args.count ?? 5);
+    for (let i = 0; i < n; i++) state.insert("notes", { id: rng.id("note"), title: `burst ${i + 1}`, body: "", done: false, createdAt: clock.iso(), updatedAt: clock.iso() });
+    return { inserted: n };
+  },
+  /** Flip the first note's done flag — a single-record update event. */
+  toggleFirst: ({ state, clock }) => {
+    const first = state.list("notes")[0];
+    if (!first) return { toggled: null };
+    state.update("notes", first.id, { done: !first.done, updatedAt: clock.iso() });
+    return { toggled: first.id };
+  },
+  /** Drop every chat socket without a close frame. */
+  dropChat: ({ streams: streams2 }) => ({ dropped: streams2.disconnect({ path: "/api/chat/ws" }, { drop: true }) })
+};
+var happy = defineScenario({
+  name: "notes-happy",
+  label: "Happy path",
+  description: "8 seeded notes, CRUD, live SSE feed, streaming chat over WebSocket.",
+  setup: seedNotes(8),
+  routes: baseRoutes(),
+  streams: streams(),
+  actions,
+  qa: { routes: ["/"], expectsErrors: false }
+});
+var empty = defineScenario({
+  name: "notes-empty",
+  label: "Empty state",
+  description: "No notes; every list shows its empty state.",
+  setup: seedNotes(0),
+  routes: baseRoutes(),
+  streams: streams(),
+  actions
+});
+var slow = defineScenario({
+  name: "notes-slow",
+  label: "Slow API",
+  description: "1200 ms (+ up to 400 ms seeded jitter) on every response; chat chunks every 250 ms.",
+  faults: { latencyMs: 1200, jitterMs: 400 },
+  setup: seedNotes(8),
+  routes: baseRoutes(),
+  streams: streams({ chunkDelayMs: 250 }),
+  actions,
+  qa: { expectsSlow: true }
+});
+var flaky = defineScenario({
+  name: "notes-flaky",
+  label: "Flaky list",
+  description: "GET /api/notes fails every third call with 503; creates succeed.",
+  setup: seedNotes(8),
+  routes: [
+    route.get("/api/notes", (ctx) => ctx.calls % 3 === 0 ? problem(503, "flaky upstream") : json({ items: ctx.state.list("notes") })),
+    ...baseRoutes().filter((r) => !(r.method === "GET" && r.path === "/api/notes"))
+  ],
+  streams: streams(),
+  actions,
+  qa: { expectsErrors: true }
+});
+var malformedApi = defineScenario({
+  name: "notes-malformed",
+  label: "Malformed responses",
+  description: "GET /api/notes answers, in order: invalid JSON, wrong content-type, schema drift, then a valid list forever.",
+  setup: seedNotes(3),
+  routes: [
+    route.get(
+      "/api/notes",
+      sequence([() => malformed("invalid-json"), () => malformed("wrong-content-type"), () => malformed("schema-drift"), (ctx) => json({ items: ctx.state.list("notes") })])
+    ),
+    ...baseRoutes().filter((r) => !(r.method === "GET" && r.path === "/api/notes"))
+  ],
+  streams: streams(),
+  actions,
+  qa: { expectsErrors: true }
+});
+var streamDrop = defineScenario({
+  name: "chat-stream-drop",
+  label: "Stream drop mid-turn",
+  description: "The chat socket is hard-dropped halfway through every assistant reply; clients must reconnect with sinceEventID and resume.",
+  setup: seedNotes(2),
+  routes: baseRoutes(),
+  streams: streams({ dropMidStream: true }),
+  actions
+});
+var manualClock = defineScenario({
+  name: "notes-manual-clock",
+  label: "Manual clock",
+  description: "Nothing time-based happens until the clock is stepped: deterministic chat streaming and latency for tests (`scenario.step ms=\u2026`).",
+  clock: { mode: "manual" },
+  faults: { latencyMs: 500 },
+  setup: seedNotes(4),
+  routes: baseRoutes(),
+  streams: streams({ streamDelayMs: 100, chunkDelayMs: 100 }),
+  actions
+});
+var scenarios = [happy, empty, slow, flaky, malformedApi, streamDrop, manualClock];
+var notes_chat_default = scenarios;
+export {
+  NOTES_TOPIC,
+  chatTopic,
+  notes_chat_default as default,
+  empty,
+  flaky,
+  happy,
+  malformedApi,
+  manualClock,
+  scenarios,
+  slow,
+  streamDrop
+};
+//# sourceMappingURL=examples.js.map

package/dist/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/examples/notes-chat.ts"],"sourcesContent":["/**\n * Generic example world shipped with the package (also what the test-suite and\n * consumer smoke test use). No product data — a notes CRUD API, a live notes\n * feed over SSE, and a streaming-chat WebSocket protocol with per-topic event\n * ids and resume. Scenario variants layer faults and timing on top.\n *\n * WebSocket protocol (`chat-v1` subprotocol), deliberately shaped like real\n * chat backends so client reconnect logic gets exercised:\n *   client → { type:\"subscribe\", topic, sinceEventID? }\n *          → { type:\"send\", topic, clientMessageID, content }\n *   server → { type:\"ready\" } · { type:\"subscribed\", topic, replayed, last }\n *          → { type:\"message\", topic, eventID, id, role, content }\n *          → { type:\"stream.start\", streamID } · { type:\"chat.content\", streamID, seq, content }\n *          → { type:\"stream.done\", streamID } · { type:\"resume.miss\", topic } · { type:\"error\", error }\n */\n\nimport { defineScenario, type ScenarioDefinition } from \"../core/scenario.js\";\nimport { crud, json, problem, route, sequence, malformed } from \"../core/router.js\";\nimport { sse, ws, type SimSocket } from \"../core/streams.js\";\n\nexport interface Note extends Record<string, unknown> {\n  id: string;\n  title: string;\n  body: string;\n  done: boolean;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport const NOTES_TOPIC = \"notes\";\nexport const chatTopic = (room: string) => `chat:${room}`;\n\nconst WORDS = [\"alpha\", \"harbor\", \"signal\", \"quiet\", \"meadow\", \"copper\", \"lantern\", \"orbit\", \"velvet\", \"cinder\"];\n\nfunction baseRoutes() {\n  return [\n    route.get(\"/api/health\", () => json({ ok: true })),\n    ...crud<Note>(\"/api/notes\", \"notes\", {\n      sort: (a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id),\n      validate: (body) => (body.title !== undefined && typeof body.title !== \"string\" ? \"title must be a string\" : null),\n      create: (body, ctx) => ({\n        id: ctx.rng.id(\"note\"),\n        title: String(body.title ?? \"Untitled\"),\n        body: String(body.body ?? \"\"),\n        done: Boolean(body.done ?? false),\n        createdAt: ctx.clock.iso(),\n        updatedAt: ctx.clock.iso(),\n      }),\n      update: (cur, body, ctx) => ({ ...cur, ...body, id: cur.id, updatedAt: ctx.clock.iso() }),\n    }),\n    // Bulk action with a side effect: marks everything done and emits one custom event.\n    route.post(\"/api/notes:complete-all\", (ctx) => {\n      let n = 0;\n      for (const note of ctx.state.list<Note>(\"notes\", { where: (x) => !x.done })) {\n        ctx.state.update<Note>(\"notes\", note.id, { done: true, updatedAt: ctx.clock.iso() });\n        n++;\n      }\n      ctx.state.custom(\"notes\", \"completed-all\", { count: n });\n      return json({ completed: n });\n    }),\n    route.get(\"/api/chat/rooms/:room/history\", (ctx) => {\n      const topic = chatTopic(ctx.params.room!);\n      const { events } = ctx.streams.topics.replay(topic, ctx.query.get(\"sinceEventID\") ?? \"0\");\n      return json({ items: events.map((e) => ({ ...e.data, eventID: e.eventID, topic })) });\n    }),\n  ];\n}\n\nfunction streams(opts: { streamDelayMs?: number; chunkDelayMs?: number; dropMidStream?: boolean } = {}) {\n  const chunkDelay = opts.chunkDelayMs ?? 40;\n  return [\n    // Live notes feed: every store mutation on \"notes\" becomes an SSE event, resumable via Last-Event-ID.\n    sse(\"/api/notes/events\", (ctx, stream) => {\n      stream.subscribe(NOTES_TOPIC);\n      stream.send({ type: \"hello\", run: ctx.run.id }, { event: \"hello\" });\n    }, { keepaliveMs: 15_000 }),\n    ws(\"/api/chat/ws\", {\n      protocols: [\"chat-v1\"],\n      onOpen(ctx, socket) {\n        socket.send({ type: \"ready\", protocolVersion: 1, run: ctx.run.id });\n      },\n      onMessage(ctx, socket, raw) {\n        let frame: { type?: string; topic?: string; sinceEventID?: string; clientMessageID?: string; content?: string };\n        try {\n          frame = JSON.parse(String(raw)) as typeof frame;\n        } catch {\n          return socket.send({ type: \"error\", error: \"invalid json\" });\n        }\n        if (frame.type === \"subscribe\" && frame.topic) {\n          const r = socket.subscribe(frame.topic, { since: frame.sinceEventID ?? null });\n          socket.send({ type: \"subscribed\", topic: frame.topic, replayed: r.replayed, last: r.last });\n          if (r.missed) socket.send({ type: \"resume.miss\", topic: frame.topic });\n          return;\n        }\n        if (frame.type === \"send\" && frame.topic && frame.content !== undefined) {\n          const id = ctx.rng.id(\"msg\");\n          ctx.streams.publish(frame.topic, { type: \"message\", id, clientMessageID: frame.clientMessageID ?? \"\", role: \"user\", content: frame.content, createdAt: ctx.clock.iso() });\n          respond(ctx, socket, frame.topic, frame.content, chunkDelay, opts);\n          return;\n        }\n        socket.send({ type: \"error\", error: `unknown frame ${frame.type ?? \"?\"}` });\n      },\n    }),\n  ];\n\n  function respond(ctx: Parameters<NonNullable<ReturnType<typeof ws>[\"onMessage\"]>>[0], socket: SimSocket, topic: string, prompt: string, delay: number, o: typeof opts) {\n    const streamID = ctx.rng.id(\"stream\");\n    const words = prompt.split(/\\s+/).filter(Boolean).slice(0, 12);\n    const reply = [\"Echoing\", ...words.map((w) => w.toUpperCase()), \"—\", ctx.rng.pick(WORDS), ctx.rng.pick(WORDS)];\n    ctx.clock.after(o.streamDelayMs ?? 100, () => {\n      ctx.streams.publish(topic, { type: \"stream.start\", streamID });\n      reply.forEach((word, i) => {\n        ctx.clock.after(delay * (i + 1), () => {\n          if (o.dropMidStream && i === Math.floor(reply.length / 2)) {\n            // Cut the connection without a close frame — the client must reconnect and resume.\n            ctx.streams.disconnect({ topic }, { drop: true });\n            ctx.log(\"dropped connection mid-stream\", { streamID });\n          }\n          ctx.streams.publish(topic, { type: \"chat.content\", streamID, seq: i + 1, content: word + \" \" });\n        }, `chunk ${i + 1}`);\n      });\n      ctx.clock.after(delay * (reply.length + 1), () => {\n        const id = ctx.rng.id(\"msg\");\n        ctx.streams.publish(topic, { type: \"stream.done\", streamID, messageID: id });\n        ctx.streams.publish(topic, { type: \"message\", id, role: \"assistant\", content: reply.join(\" \").trim(), createdAt: ctx.clock.iso() });\n      }, \"stream.done\");\n    }, \"stream.start\");\n  }\n}\n\nfunction seedNotes(count: number) {\n  return ({ state, rng, clock, streams }: import(\"../core/scenario.js\").SetupContext) => {\n    for (let i = 0; i < count; i++) {\n      const created = clock.iso(-(count - i) * 60_000);\n      state.insert<Note>(\"notes\", { id: rng.id(\"note\"), title: `${rng.pick(WORDS)} ${rng.pick(WORDS)}`, body: `Note ${i + 1}`, done: rng.chance(0.3), createdAt: created, updatedAt: created });\n    }\n    // Mutations → stream events: the feed publishes what the store does.\n    state.on((e) => {\n      if (e.collection !== \"notes\") return;\n      if (e.kind === \"custom\") streams.publish(NOTES_TOPIC, { type: `notes.${e.name}`, ...(e.data as Record<string, unknown>) });\n      else streams.publish(NOTES_TOPIC, { type: `notes.${e.kind}`, id: e.id, note: e.record ?? null, previous: e.previous ?? null });\n    });\n  };\n}\n\nconst actions: ScenarioDefinition[\"actions\"] = {\n  /** Emit N synthetic note inserts quickly (list growth / scroll anchoring). */\n  burst: ({ state, rng, clock, args }) => {\n    const n = Number(args.count ?? 5);\n    for (let i = 0; i < n; i++) state.insert<Note>(\"notes\", { id: rng.id(\"note\"), title: `burst ${i + 1}`, body: \"\", done: false, createdAt: clock.iso(), updatedAt: clock.iso() });\n    return { inserted: n };\n  },\n  /** Flip the first note's done flag — a single-record update event. */\n  toggleFirst: ({ state, clock }) => {\n    const first = state.list<Note>(\"notes\")[0];\n    if (!first) return { toggled: null };\n    state.update<Note>(\"notes\", first.id, { done: !first.done, updatedAt: clock.iso() });\n    return { toggled: first.id };\n  },\n  /** Drop every chat socket without a close frame. */\n  dropChat: ({ streams }) => ({ dropped: streams.disconnect({ path: \"/api/chat/ws\" }, { drop: true }) }),\n};\n\nexport const happy = defineScenario({\n  name: \"notes-happy\",\n  label: \"Happy path\",\n  description: \"8 seeded notes, CRUD, live SSE feed, streaming chat over WebSocket.\",\n  setup: seedNotes(8),\n  routes: baseRoutes(),\n  streams: streams(),\n  actions,\n  qa: { routes: [\"/\"], expectsErrors: false },\n});\n\nexport const empty = defineScenario({\n  name: \"notes-empty\",\n  label: \"Empty state\",\n  description: \"No notes; every list shows its empty state.\",\n  setup: seedNotes(0),\n  routes: baseRoutes(),\n  streams: streams(),\n  actions,\n});\n\nexport const slow = defineScenario({\n  name: \"notes-slow\",\n  label: \"Slow API\",\n  description: \"1200 ms (+ up to 400 ms seeded jitter) on every response; chat chunks every 250 ms.\",\n  faults: { latencyMs: 1200, jitterMs: 400 },\n  setup: seedNotes(8),\n  routes: baseRoutes(),\n  streams: streams({ chunkDelayMs: 250 }),\n  actions,\n  qa: { expectsSlow: true },\n});\n\nexport const flaky = defineScenario({\n  name: \"notes-flaky\",\n  label: \"Flaky list\",\n  description: \"GET /api/notes fails every third call with 503; creates succeed.\",\n  setup: seedNotes(8),\n  routes: [\n    route.get(\"/api/notes\", (ctx) => (ctx.calls % 3 === 0 ? problem(503, \"flaky upstream\") : json({ items: ctx.state.list<Note>(\"notes\") }))),\n    ...baseRoutes().filter((r) => !(r.method === \"GET\" && r.path === \"/api/notes\")),\n  ],\n  streams: streams(),\n  actions,\n  qa: { expectsErrors: true },\n});\n\nexport const malformedApi = defineScenario({\n  name: \"notes-malformed\",\n  label: \"Malformed responses\",\n  description: \"GET /api/notes answers, in order: invalid JSON, wrong content-type, schema drift, then a valid list forever.\",\n  setup: seedNotes(3),\n  routes: [\n    route.get(\n      \"/api/notes\",\n      sequence([() => malformed(\"invalid-json\"), () => malformed(\"wrong-content-type\"), () => malformed(\"schema-drift\"), (ctx) => json({ items: ctx.state.list<Note>(\"notes\") })]),\n    ),\n    ...baseRoutes().filter((r) => !(r.method === \"GET\" && r.path === \"/api/notes\")),\n  ],\n  streams: streams(),\n  actions,\n  qa: { expectsErrors: true },\n});\n\nexport const streamDrop = defineScenario({\n  name: \"chat-stream-drop\",\n  label: \"Stream drop mid-turn\",\n  description: \"The chat socket is hard-dropped halfway through every assistant reply; clients must reconnect with sinceEventID and resume.\",\n  setup: seedNotes(2),\n  routes: baseRoutes(),\n  streams: streams({ dropMidStream: true }),\n  actions,\n});\n\nexport const manualClock = defineScenario({\n  name: \"notes-manual-clock\",\n  label: \"Manual clock\",\n  description: \"Nothing time-based happens until the clock is stepped: deterministic chat streaming and latency for tests (`scenario.step ms=…`).\",\n  clock: { mode: \"manual\" },\n  faults: { latencyMs: 500 },\n  setup: seedNotes(4),\n  routes: baseRoutes(),\n  streams: streams({ streamDelayMs: 100, chunkDelayMs: 100 }),\n  actions,\n});\n\nexport const scenarios: ScenarioDefinition[] = [happy, empty, slow, flaky, malformedApi, streamDrop, manualClock];\nexport default scenarios;\n"],"mappings":"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","names":["streams"]}

package/dist/index.d.ts

@@ -0,0 +1,322 @@
+import { S as ScenarioDefinition, R as Run, W as WsRoute, a as StreamContext, C as ClockMode, b as ConnectionSummary, F as FaultSnapshot, M as Method, c as Record_, d as StoreEvent, e as RunLogEntry, T as TopicEvent, O as Override, f as OverrideInput, g as FailMode } from './scenario--CvzkzX_.js';
+export { A as ActionContext, h as ClockTimer, i as FaultLayer, H as Handler, j as MalformedKind, k as Rng, l as Route, m as RouteContext, n as Serializer, o as SetupContext, p as SimSocket, q as SimSseStream, r as SocketTransport, s as SseRoute, t as Store, u as StoreEventKind, v as StoreListener, w as StreamHub, x as StreamRoute, y as TopicLog, V as VIRTUAL_EPOCH, z as VirtualClock, B as compileRoute, D as crud, E as defineScenario, G as delayed, I as empty, J as json, K as malformed, L as problem, N as route, P as sequence, Q as sse, U as statusText, X as text, Y as ws } from './scenario--CvzkzX_.js';
+
+interface SimulatorOptions {
+    scenarios: ScenarioDefinition[];
+    defaultScenario?: string;
+    /** Control-plane prefix (default `/__sim`). */
+    controlPath?: string;
+    /** Default run id (default `default`). */
+    defaultRun?: string;
+    /** Add permissive CORS headers (default true — the mock is a dev tool). */
+    cors?: boolean;
+    log?: (line: string) => void;
+}
+/**
+ * Marker for "the adapter completed the WebSocket upgrade". Node's undici
+ * refuses `new Response(null, { status: 101 })`, so adapters return a 200 with
+ * this header instead of a 101.
+ */
+declare const UPGRADED_HEADER = "x-sim-upgraded";
+declare const upgradedResponse: () => Response;
+declare const isUpgraded: (response: Response) => boolean;
+/** How an adapter completes a WebSocket upgrade for a matched route. */
+type UpgradeHook = (route: WsRoute, ctx: StreamContext, run: Run, protocol: string | null) => Response | Promise<Response>;
+interface HandleOptions {
+    upgrade?: UpgradeHook;
+}
+declare class Simulator {
+    readonly scenarios: Map<string, ScenarioDefinition>;
+    readonly runs: Map<string, Run>;
+    readonly controlPath: string;
+    readonly defaultRun: string;
+    readonly defaultScenario: string;
+    private readonly cors;
+    private readonly log;
+    constructor(options: SimulatorOptions);
+    private cookie;
+    runIdFor(request: Request, url: URL): string;
+    scenarioNameFor(request: Request, url: URL): string;
+    /** Get or lazily create the run for a request. */
+    runFor(request: Request, url: URL): Promise<Run>;
+    createRun(id: string, scenarioName: string, seed?: string): Run;
+    getRun(id?: string): Run | null;
+    handle(request: Request, options?: HandleOptions): Promise<Response>;
+    private routeContext;
+    streamContext(run: Run, request: Request, url: URL, params: Record<string, string>): StreamContext;
+    private withCors;
+    private control;
+    /** In-process control API — the same operations the HTTP control plane offers. */
+    readonly api: {
+        scenarios: () => {
+            name: string;
+            label: string | null;
+            description: string | null;
+            seed: string;
+            tags: string[];
+            clock: {
+                mode?: ClockMode;
+                speed?: number;
+            };
+            actions: string[];
+            qa: Record<string, unknown> | null;
+        }[];
+        status: (runId?: string) => Promise<{
+            run: string;
+            scenario: null;
+            exists: boolean;
+            defaultScenario: string;
+        } | {
+            run: string;
+            scenario: string;
+            label: string | null;
+            seed: string;
+            createdWall: number;
+            requests: number;
+            clock: {
+                mode: ClockMode;
+                speed: number;
+                now: number;
+                wall: string;
+                pending: {
+                    id: number;
+                    at: number;
+                    label: string;
+                }[];
+            };
+            state: {
+                collections: Record<string, number>;
+                lastSeq: number;
+            };
+            streams: ConnectionSummary[];
+            topics: {
+                topic: string;
+                last: string;
+            }[];
+            faults: FaultSnapshot;
+            routes: {
+                method: Method;
+                path: string;
+                calls: number;
+                name: string | null;
+            }[];
+            streamRoutes: ({
+                kind: string;
+                path: string;
+                protocols: string[];
+            } | {
+                kind: string;
+                path: string;
+                method: "GET" | "POST";
+            })[];
+            actions: string[];
+            exists: boolean;
+            defaultScenario?: undefined;
+        }>;
+        select: (runId: string, scenario: string, seed?: string) => Promise<{
+            run: string;
+            scenario: string;
+            label: string | null;
+            seed: string;
+            createdWall: number;
+            requests: number;
+            clock: {
+                mode: ClockMode;
+                speed: number;
+                now: number;
+                wall: string;
+                pending: {
+                    id: number;
+                    at: number;
+                    label: string;
+                }[];
+            };
+            state: {
+                collections: Record<string, number>;
+                lastSeq: number;
+            };
+            streams: ConnectionSummary[];
+            topics: {
+                topic: string;
+                last: string;
+            }[];
+            faults: FaultSnapshot;
+            routes: {
+                method: Method;
+                path: string;
+                calls: number;
+                name: string | null;
+            }[];
+            streamRoutes: ({
+                kind: string;
+                path: string;
+                protocols: string[];
+            } | {
+                kind: string;
+                path: string;
+                method: "GET" | "POST";
+            })[];
+            actions: string[];
+        }>;
+        reset: (runId: string, seed?: string) => Promise<{
+            run: string;
+            scenario: string;
+            label: string | null;
+            seed: string;
+            createdWall: number;
+            requests: number;
+            clock: {
+                mode: ClockMode;
+                speed: number;
+                now: number;
+                wall: string;
+                pending: {
+                    id: number;
+                    at: number;
+                    label: string;
+                }[];
+            };
+            state: {
+                collections: Record<string, number>;
+                lastSeq: number;
+            };
+            streams: ConnectionSummary[];
+            topics: {
+                topic: string;
+                last: string;
+            }[];
+            faults: FaultSnapshot;
+            routes: {
+                method: Method;
+                path: string;
+                calls: number;
+                name: string | null;
+            }[];
+            streamRoutes: ({
+                kind: string;
+                path: string;
+                protocols: string[];
+            } | {
+                kind: string;
+                path: string;
+                method: "GET" | "POST";
+            })[];
+            actions: string[];
+        }>;
+        step: (runId: string, ms: number) => {
+            pending: {
+                id: number;
+                at: number;
+                label: string;
+            }[];
+            now: number;
+            fired: {
+                id: number;
+                at: number;
+                label: string;
+            }[];
+        };
+        clock: (runId: string, patch: {
+            mode?: "manual" | "realtime";
+            speed?: number;
+        }) => {
+            mode: ClockMode;
+            speed: number;
+            now: number;
+            pending: {
+                id: number;
+                at: number;
+                label: string;
+            }[];
+        };
+        state: (runId: string, collection?: string) => {
+            run: string;
+            collection: string;
+            items: Record_[];
+            counts?: undefined;
+            collections?: undefined;
+        } | {
+            run: string;
+            counts: Record<string, number>;
+            collections: Record<string, Record_[]>;
+            collection?: undefined;
+            items?: undefined;
+        };
+        events: (runId: string, opts: {
+            since?: number;
+            limit?: number;
+            collection?: string;
+        }) => {
+            run: string;
+            last: number;
+            count: number;
+            events: StoreEvent[];
+        };
+        log: (runId: string, opts: {
+            since?: number;
+            limit?: number;
+        }) => {
+            run: string;
+            entries: RunLogEntry[];
+        };
+        streams: (runId: string) => {
+            run: string;
+            connections: ConnectionSummary[];
+            topics: {
+                topic: string;
+                last: string;
+            }[];
+            latencyMs: number;
+        };
+        disconnect: (runId: string, target: {
+            id?: string;
+            topic?: string;
+            path?: string;
+            all?: boolean;
+        }, opts?: {
+            code?: number;
+            reason?: string;
+            drop?: boolean;
+        }) => {
+            closed: string[];
+        };
+        pause: (runId: string, id: string, paused: boolean) => boolean;
+        publish: (runId: string, topic: string, data: Record<string, unknown>) => TopicEvent;
+        overrides: (runId: string) => {
+            run: string;
+            overrides: Override[];
+        };
+        setOverride: (runId: string, input: OverrideInput) => Override;
+        clearOverrides: (runId: string, target?: string, method?: string) => {
+            cleared: boolean;
+        };
+        faults: (runId: string, patch: {
+            latencyMs?: number;
+            jitterMs?: number;
+            failMode?: "off" | "data" | "all";
+            shellPaths?: string[];
+            streamLatencyMs?: number;
+        }) => {
+            streamLatencyMs: number;
+            latencyMs: number;
+            jitterMs: number;
+            failMode: FailMode;
+            shellPaths: string[];
+            overrides: Override[];
+        };
+        action: (runId: string, name: string, args?: Record<string, unknown>) => Promise<unknown>;
+        runs: () => {
+            id: string;
+            scenario: string;
+            seed: string;
+            requests: number;
+            createdWall: number;
+        }[];
+        deleteRun: (runId: string) => boolean;
+    };
+    private require;
+    dispose(): void;
+}
+declare function matchPath(pattern: string, pathname: string): Record<string, string> | null;
+
+export { ClockMode, ConnectionSummary, FailMode, FaultSnapshot, type HandleOptions, Method, Override, OverrideInput, Run, RunLogEntry, ScenarioDefinition, Simulator, type SimulatorOptions, StoreEvent, StreamContext, TopicEvent, UPGRADED_HEADER, type UpgradeHook, WsRoute, isUpgraded, matchPath, upgradedResponse };