@sponson/sim 0.0.0-stage → 0.4.0

package/dist/state.js

@@ -0,0 +1,109 @@
+/**
+ * In-memory state for the fake cloud: the core (chaos, write log, ids) plus one state object per registered
+ * provider, reachable as `state.<provider>` (e.g. `state.vercel.projects`).
+ */
+import { CHAOS_KEYS, chaosFor, defaultChaos } from "./chaos.js";
+import { clerkSim } from "./routes/clerk.js";
+import { neonSim } from "./routes/neon.js";
+import { vercelSim } from "./routes/vercel.js";
+/**
+ * Every simulated provider, by URL prefix (`/<name>/…`), drift prefix (`<name>.…`), seed key and state key.
+ * Order matters only for determinism: resets seed providers (and so allocate ids) in this order.
+ */
+export const PROVIDERS = { vercel: vercelSim, neon: neonSim, clerk: clerkSim };
+/** The demo projects every provider starts with when a seed does not name it. */
+export const DEFAULT_SEED = Object.fromEntries(Object.entries(PROVIDERS).map(([name, p]) => [name, p.defaultSeed]));
+/** The registry as the core sees it: names and type-erased providers. */
+export function providerEntries() {
+    return Object.entries(PROVIDERS);
+}
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+export class SimState {
+    chaos = defaultChaos();
+    writes = [];
+    seq = 0;
+    held = [];
+    constructor(seed) {
+        this.reset(seed);
+    }
+    nextId(prefix) {
+        this.seq += 1;
+        return `${prefix}${this.seq}`;
+    }
+    /** The state object of one provider. */
+    provider(name) {
+        return this[name];
+    }
+    /**
+     * Clear everything (state, chaos, writes) and apply a seed. A partial seed replaces only the providers it names;
+     * the others keep their defaults, so `{ clerk: {...} }` still has the demo Vercel and Neon projects.
+     */
+    reset(seed) {
+        const s = seed ?? {};
+        this.release();
+        this.chaos = defaultChaos();
+        this.writes = [];
+        this.seq = 0;
+        const states = this;
+        for (const [name, p] of providerEntries())
+            states[name] = p.reset(this, name in s ? s[name] : p.defaultSeed);
+        if (s.chaos)
+            this.applyChaos(s.chaos);
+    }
+    /** Merge a chaos request; drift is applied to state right away and not kept. */
+    applyChaos(req) {
+        const { drift, ...rest } = req;
+        // The request arrives as JSON over HTTP: its keys are checked here, not by the type.
+        const entries = Object.entries(rest);
+        for (const [k, v] of entries) {
+            // A misspelt key would silently leave the test running without its chaos.
+            if (!CHAOS_KEYS.has(k))
+                throw new Error(`unknown chaos key: ${k} (known: ${[...CHAOS_KEYS].join(", ")}, drift)`);
+            if (v !== undefined)
+                Object.assign(this.chaos, { [k]: v });
+        }
+        if (drift)
+            for (const [key, value] of Object.entries(drift))
+                this.applyDrift(key, value);
+        return this.chaos;
+    }
+    /**
+     * Drift: change provider state behind the client's back, like a human in a console. The key is
+     * `<provider>.<rest>`, or `<provider>:<project>.<rest>` to limit it to one project; each provider documents
+     * the `<rest>` forms it accepts in its `drift`. Values are a new value, "delete", or "recreate" (delete and
+     * re-create with the same name and a new id).
+     */
+    applyDrift(key, value) {
+        const m = key.match(/^([a-z][a-z0-9_-]*)(?::([^.]+))?\.(.+)$/);
+        const entry = m ? providerEntries().find(([name]) => name === m[1]) : undefined;
+        if (!m || !entry)
+            throw new Error(`unknown drift key: ${key}`);
+        const [name, p] = entry;
+        if (!p.drift(this, this.provider(name), { key, rest: m[3], value, ...(m[2] !== undefined ? { only: m[2] } : {}) }))
+            throw new Error(`unknown drift key: ${key}`);
+    }
+    /** Requests currently held by chaos `hold_next`. */
+    get heldCount() {
+        return this.held.length;
+    }
+    /** Park the calling request until `release()`. */
+    hold() {
+        return new Promise((resolve) => this.held.push(resolve));
+    }
+    /** Let every held request proceed; returns how many there were. */
+    release() {
+        const held = this.held;
+        this.held = [];
+        for (const go of held)
+            go();
+        return held.length;
+    }
+    /** Decide what chaos does to this request, consuming one count when it does something. */
+    chaosFor(method, path) {
+        return chaosFor(this.chaos, method, path);
+    }
+    snapshot() {
+        return { ...Object.fromEntries(providerEntries().map(([name]) => [name, this.provider(name)])), chaos: this.chaos };
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAyD,MAAM,YAAY,CAAC;AAEvH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAoB/E,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAY,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAY,CAAC;AAexI,yEAAyE;AACzE,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAyD,CAAC;AAC3F,CAAC;AASD,4EAA4E;AAC5E,MAAM,OAAO,QAAQ;IACnB,KAAK,GAAgB,YAAY,EAAE,CAAC;IACpC,MAAM,GAAoB,EAAE,CAAC;IACrB,GAAG,GAAG,CAAC,CAAC;IACR,IAAI,GAAsB,EAAE,CAAC;IAErC,YAAY,IAAuB;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,wCAAwC;IACxC,QAAQ,CAAC,IAAkB;QACzB,OAAQ,IAAiD,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAA8B;QAClC,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,YAAY,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,MAAM,MAAM,GAAG,IAAgD,CAAC;QAChE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,eAAe,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC7G,IAAI,CAAC,CAAC,KAAK;YAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,gFAAgF;IAChF,UAAU,CAAC,GAAiB;QAC1B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;QAC/B,qFAAqF;QACrF,MAAM,OAAO,GAA6B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/D,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;YAC7B,0EAA0E;YAC1E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjH,IAAI,CAAC,KAAK,SAAS;gBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,KAAK;YAAE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,GAAW,EAAE,KAAa;QACnC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IACpK,CAAC;IAED,oDAAoD;IACpD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,kDAAkD;IAClD,IAAI;QACF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,mEAAmE;IACnE,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,IAAI;YAAE,EAAE,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,0FAA0F;IAC1F,QAAQ,CAAC,MAAc,EAAE,IAAY;QACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACtH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@sponson/sim",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.0",
+  "description": "Local fake cloud for Sponson: Vercel, Neon and Clerk API subsets with chaos injection.",
+  "keywords": [
+    "sponson",
+    "fake-cloud",
+    "api-simulator",
+    "chaos-testing",
+    "vercel",
+    "neon",
+    "clerk",
+    "testing"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MishaBear94/Sponson.git",
+    "directory": "packages/sim"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "sponson-sim": "./dist/bin.js"
+  },
+  "dependencies": {},
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://sponson.mintlify.site",
+  "bugs": {
+    "url": "https://github.com/MishaBear94/Sponson/issues"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
 }