@omniaura/scenario-sim 0.1.0

package/dist/vite.d.ts

@@ -0,0 +1,27 @@
+import { Plugin } from 'vite';
+import { a as SimulatorOptions, b as ScenarioDefinition } from './engine-2w32ngB2.js';
+
+/**
+ * @omniaura/scenario-sim/vite — serve a Simulator from the Vite dev server so
+ * the app and its mock share one origin (no CORS, one port, WebSocket
+ * upgrades included).
+ *
+ *   import scenarioSim from "@omniaura/scenario-sim/vite";
+ *   plugins: [scenarioSim({ scenarios: () => import("./scenarios"), match: (p) => p.startsWith("/api/") })]
+ */
+
+interface ScenarioSimVitePluginOptions extends Omit<SimulatorOptions, "scenarios"> {
+    /** Scenario definitions, or a loader (lets you import scenario files lazily). */
+    scenarios: ScenarioDefinition[] | (() => Promise<ScenarioDefinition[] | {
+        default: ScenarioDefinition[];
+    } | {
+        scenarios: ScenarioDefinition[];
+    }>);
+    /** Which paths the simulator owns (default: `/api/` prefix and the control path). */
+    match?: (pathname: string) => boolean;
+    /** Only in `--mode simulator` / when VITE_SIMULATOR=true (default true). */
+    onlyInSimulatorMode?: boolean;
+}
+declare function scenarioSim(options: ScenarioSimVitePluginOptions): Plugin;
+
+export { type ScenarioSimVitePluginOptions, scenarioSim as default };

package/dist/vite.js

@@ -0,0 +1,48 @@
+import {
+  attachWebSockets,
+  sendWebResponse,
+  toWebRequest
+} from "./chunk-7HBAY3QY.js";
+import {
+  Simulator
+} from "./chunk-KU4W4SKO.js";
+
+// src/vite.ts
+function scenarioSim(options) {
+  let sim = null;
+  const controlPath = (options.controlPath ?? "/__sim").replace(/\/$/, "");
+  const match = options.match ?? ((p) => p.startsWith("/api/"));
+  const owns = (p) => match(p) || p === controlPath || p.startsWith(`${controlPath}/`);
+  let enabled = true;
+  return {
+    name: "scenario-sim",
+    apply: "serve",
+    configResolved(config) {
+      const only = options.onlyInSimulatorMode ?? true;
+      enabled = !only || config.mode === "simulator" || process.env.VITE_SIMULATOR === "true";
+    },
+    async configureServer(server) {
+      if (!enabled) return;
+      const loaded = typeof options.scenarios === "function" ? await options.scenarios() : options.scenarios;
+      const scenarios = Array.isArray(loaded) ? loaded : "default" in loaded ? loaded.default : loaded.scenarios;
+      sim = new Simulator({ ...options, scenarios, log: options.log ?? ((l) => server.config.logger.info(`  ${l}`)) });
+      const base = () => {
+        const addr = server.httpServer?.address();
+        const port = typeof addr === "object" && addr ? addr.port : server.config.server.port ?? 5173;
+        return `http://localhost:${port}`;
+      };
+      if (server.httpServer) attachWebSockets(sim, server.httpServer, { base, match: owns });
+      server.middlewares.use((req, res, next) => {
+        const pathname = new URL(req.url ?? "/", base()).pathname;
+        if (!sim || !owns(pathname)) return next();
+        void sim.handle(toWebRequest(req, base())).then((response) => sendWebResponse(res, response));
+      });
+      server.httpServer?.once("listening", () => server.config.logger.info(`  \u25A3 scenario-sim: ${base()}${controlPath}/status  (scenarios: ${scenarios.map((s) => s.name).join(", ")})`));
+      server.httpServer?.once("close", () => sim?.dispose());
+    }
+  };
+}
+export {
+  scenarioSim as default
+};
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"sourcesContent":["/**\n * @omniaura/scenario-sim/vite — serve a Simulator from the Vite dev server so\n * the app and its mock share one origin (no CORS, one port, WebSocket\n * upgrades included).\n *\n *   import scenarioSim from \"@omniaura/scenario-sim/vite\";\n *   plugins: [scenarioSim({ scenarios: () => import(\"./scenarios\"), match: (p) => p.startsWith(\"/api/\") })]\n */\n\nimport type { Plugin, ViteDevServer } from \"vite\";\nimport type { Server as HttpServer } from \"node:http\";\nimport { Simulator, type SimulatorOptions } from \"./core/engine.js\";\nimport type { ScenarioDefinition } from \"./core/scenario.js\";\nimport { attachWebSockets, sendWebResponse, toWebRequest } from \"./server.js\";\n\nexport interface ScenarioSimVitePluginOptions extends Omit<SimulatorOptions, \"scenarios\"> {\n  /** Scenario definitions, or a loader (lets you import scenario files lazily). */\n  scenarios: ScenarioDefinition[] | (() => Promise<ScenarioDefinition[] | { default: ScenarioDefinition[] } | { scenarios: ScenarioDefinition[] }>);\n  /** Which paths the simulator owns (default: `/api/` prefix and the control path). */\n  match?: (pathname: string) => boolean;\n  /** Only in `--mode simulator` / when VITE_SIMULATOR=true (default true). */\n  onlyInSimulatorMode?: boolean;\n}\n\nexport default function scenarioSim(options: ScenarioSimVitePluginOptions): Plugin {\n  let sim: Simulator | null = null;\n  const controlPath = (options.controlPath ?? \"/__sim\").replace(/\\/$/, \"\");\n  const match = options.match ?? ((p: string) => p.startsWith(\"/api/\"));\n  const owns = (p: string) => match(p) || p === controlPath || p.startsWith(`${controlPath}/`);\n  let enabled = true;\n\n  return {\n    name: \"scenario-sim\",\n    apply: \"serve\",\n    configResolved(config) {\n      const only = options.onlyInSimulatorMode ?? true;\n      enabled = !only || config.mode === \"simulator\" || process.env.VITE_SIMULATOR === \"true\";\n    },\n    async configureServer(server: ViteDevServer) {\n      if (!enabled) return;\n      const loaded = typeof options.scenarios === \"function\" ? await options.scenarios() : options.scenarios;\n      const scenarios = Array.isArray(loaded) ? loaded : \"default\" in loaded ? loaded.default : loaded.scenarios;\n      sim = new Simulator({ ...options, scenarios, log: options.log ?? ((l) => server.config.logger.info(`  ${l}`)) });\n      const base = () => {\n        const addr = server.httpServer?.address();\n        const port = typeof addr === \"object\" && addr ? addr.port : (server.config.server.port ?? 5173);\n        return `http://localhost:${port}`;\n      };\n      if (server.httpServer) attachWebSockets(sim, server.httpServer as HttpServer, { base, match: owns });\n      server.middlewares.use((req, res, next) => {\n        const pathname = new URL(req.url ?? \"/\", base()).pathname;\n        if (!sim || !owns(pathname)) return next();\n        void sim.handle(toWebRequest(req, base())).then((response) => sendWebResponse(res, response));\n      });\n      server.httpServer?.once(\"listening\", () => server.config.logger.info(`  ▣ scenario-sim: ${base()}${controlPath}/status  (scenarios: ${scenarios.map((s) => s.name).join(\", \")})`));\n      server.httpServer?.once(\"close\", () => sim?.dispose());\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AAwBe,SAAR,YAA6B,SAA+C;AACjF,MAAI,MAAwB;AAC5B,QAAM,eAAe,QAAQ,eAAe,UAAU,QAAQ,OAAO,EAAE;AACvE,QAAM,QAAQ,QAAQ,UAAU,CAAC,MAAc,EAAE,WAAW,OAAO;AACnE,QAAM,OAAO,CAAC,MAAc,MAAM,CAAC,KAAK,MAAM,eAAe,EAAE,WAAW,GAAG,WAAW,GAAG;AAC3F,MAAI,UAAU;AAEd,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,eAAe,QAAQ;AACrB,YAAM,OAAO,QAAQ,uBAAuB;AAC5C,gBAAU,CAAC,QAAQ,OAAO,SAAS,eAAe,QAAQ,IAAI,mBAAmB;AAAA,IACnF;AAAA,IACA,MAAM,gBAAgB,QAAuB;AAC3C,UAAI,CAAC,QAAS;AACd,YAAM,SAAS,OAAO,QAAQ,cAAc,aAAa,MAAM,QAAQ,UAAU,IAAI,QAAQ;AAC7F,YAAM,YAAY,MAAM,QAAQ,MAAM,IAAI,SAAS,aAAa,SAAS,OAAO,UAAU,OAAO;AACjG,YAAM,IAAI,UAAU,EAAE,GAAG,SAAS,WAAW,KAAK,QAAQ,QAAQ,CAAC,MAAM,OAAO,OAAO,OAAO,KAAK,KAAK,CAAC,EAAE,GAAG,CAAC;AAC/G,YAAM,OAAO,MAAM;AACjB,cAAM,OAAO,OAAO,YAAY,QAAQ;AACxC,cAAM,OAAO,OAAO,SAAS,YAAY,OAAO,KAAK,OAAQ,OAAO,OAAO,OAAO,QAAQ;AAC1F,eAAO,oBAAoB,IAAI;AAAA,MACjC;AACA,UAAI,OAAO,WAAY,kBAAiB,KAAK,OAAO,YAA0B,EAAE,MAAM,OAAO,KAAK,CAAC;AACnG,aAAO,YAAY,IAAI,CAAC,KAAK,KAAK,SAAS;AACzC,cAAM,WAAW,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,CAAC,EAAE;AACjD,YAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAG,QAAO,KAAK;AACzC,aAAK,IAAI,OAAO,aAAa,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,gBAAgB,KAAK,QAAQ,CAAC;AAAA,MAC9F,CAAC;AACD,aAAO,YAAY,KAAK,aAAa,MAAM,OAAO,OAAO,OAAO,KAAK,0BAAqB,KAAK,CAAC,GAAG,WAAW,wBAAwB,UAAU,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC;AACjL,aAAO,YAAY,KAAK,SAAS,MAAM,KAAK,QAAQ,CAAC;AAAA,IACvD;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@omniaura/scenario-sim",
+  "version": "0.1.0",
+  "description": "Deterministic scenario simulator for frontend QA: stateful CRUD routes, seeded RNG, virtual clock, response sequences, faults and overrides, SSE and WebSocket routes with scheduled events and resume, per-run isolation, inspectable event log. Runtime-neutral core (Web Request/Response) with Bun/Node server, Vite middleware and in-browser adapters.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "scenario-sim": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./pulse": {
+      "types": "./dist/pulse.d.ts",
+      "import": "./dist/pulse.js"
+    },
+    "./examples": {
+      "types": "./dist/examples.d.ts",
+      "import": "./dist/examples.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "mock",
+    "simulator",
+    "scenario",
+    "msw",
+    "sse",
+    "websocket",
+    "deterministic",
+    "seeded",
+    "qa",
+    "vite-plugin",
+    "solid",
+    "tanstack-query"
+  ],
+  "license": "MIT",
+  "author": "omniaura",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omniaura/solid-pulse.git",
+    "directory": "packages/scenario-sim"
+  },
+  "homepage": "https://github.com/omniaura/solid-pulse/tree/main/packages/scenario-sim#readme",
+  "bugs": {
+    "url": "https://github.com/omniaura/solid-pulse/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.12"
+  }
+}