@sponson/sim 0.0.0-stage → 0.5.0

package/dist/server.js

@@ -0,0 +1,189 @@
+/**
+ * HTTP front of the fake cloud. The core here does what is common to every provider: control endpoints (`/_…`),
+ * bearer-token check, latency, chaos (hang / drop / fail) and the write log. Everything under `/<provider>/` is
+ * answered by that provider's `routes/<provider>.ts`; each of those files lists the assumptions about the real
+ * API it encodes. The one cross-provider assumption:
+ *   S1. 429s carry `Retry-After` in seconds (chaos `retry_after`).
+ */
+import { createHash } from "node:crypto";
+import { createServer } from "node:http";
+import { setTimeout as sleep } from "node:timers/promises";
+import { Reply, route, router } from "./provider.js";
+import { providerEntries } from "./state.js";
+/** `/<provider>` → its routes, one entry per registered provider. */
+const ROUTES = Object.fromEntries(providerEntries().map(([name, p]) => [`/${name}`, (state, req) => p.routes(state, state.provider(name), req)]));
+const WRITE_METHODS = new Set(["POST", "PATCH", "DELETE", "PUT"]);
+/** The sim's HTTP server over `state`, not yet listening. Most callers want `startSim`. */
+export function createSimServer(state) {
+    return createServer((req, res) => {
+        handle(state, req, res).catch((e) => {
+            send(res, 500, { error: e instanceof Error ? e.message : String(e) });
+        });
+    });
+}
+async function handle(state, req, res) {
+    const method = (req.method ?? "GET").toUpperCase();
+    const url = new URL(req.url ?? "/", "http://sim.local");
+    const raw = await readBody(req);
+    // Control endpoints take JSON whatever the client says: `curl -d '{…}'` labels a JSON body as a form.
+    const contentType = req.headers["content-type"] ?? "";
+    const form = !url.pathname.startsWith("/_") && contentType.startsWith("application/x-www-form-urlencoded");
+    // XML bodies reach the provider as text: only it knows the document.
+    const xml = !url.pathname.startsWith("/_") && /^[\w.+-]+\/([\w.-]+\+)?xml\b/.test(contentType);
+    const parsed = xml ? { body: raw } : form ? { body: parseForm(raw) } : parseJson(raw);
+    if (!parsed)
+        return send(res, 400, { error: "invalid json" });
+    const { body } = parsed;
+    if (url.pathname.startsWith("/_")) {
+        const r = control(state, state, { method, url, path: url.pathname, body });
+        return send(res, r.status, r.body);
+    }
+    // Any non-empty credential is accepted unless a provider's seed configures real ones; missing-token bugs must
+    // surface as 401.
+    const verdict = authorized(state, req.headers, { method, url, target: req.url ?? "/", raw });
+    if (verdict instanceof Reply)
+        return send(res, verdict.status, verdict.body, verdict.headers);
+    if (!verdict)
+        return send(res, 401, { error: "unauthorized" });
+    await serveProvider(state, req, res, { method, url, raw, body });
+}
+const WRITES = Object.fromEntries(providerEntries().flatMap(([name, p]) => (p.isWrite ? [[`/${name}`, (state, req) => p.isWrite(req, state.provider(name))]] : [])));
+/** Whether a POST, PUT, PATCH or DELETE goes into the write log. */
+function changesState(state, method, url, body) {
+    const prefix = url.pathname.match(/^\/[^/]+/)?.[0] ?? "";
+    const check = WRITES[prefix];
+    return check ? check(state, { method, path: url.pathname.slice(prefix.length) || "/", body }) : true;
+}
+/** `/<provider>` → how that provider takes its credential, when not as a bearer token. */
+const AUTH = Object.fromEntries(providerEntries().flatMap(([name, p]) => (p.authorized ? [[`/${name}`, (state, h, req) => p.authorized(h, state.provider(name), req, state)]] : [])));
+/** The credential check of the provider the path belongs to; a non-empty bearer token by default. */
+function authorized(state, headers, req) {
+    const prefix = req.url.pathname.match(/^\/[^/]+/)?.[0] ?? "";
+    const check = AUTH[prefix];
+    return check ? check(state, headers, req) : /^Bearer\s+\S+$/.test(headers.authorization ?? "");
+}
+/** An authenticated provider request: latency, chaos, the write log, then the provider's routes. */
+async function serveProvider(state, req, res, { method, url, raw, body }) {
+    if (state.chaos.latency_ms > 0)
+        await sleep(state.chaos.latency_ms);
+    const isWrite = WRITE_METHODS.has(method) && changesState(state, method, url, body);
+    const action = state.chaosFor(method, url.pathname);
+    // Held: performed (and logged) only once released, like a request stuck in the provider's queue.
+    if (action?.kind === "hold")
+        await state.hold();
+    const entry = { at: new Date().toISOString(), method, path: url.pathname, bodyHash: sha256(raw) };
+    if (action?.kind === "hang" || action?.kind === "fail") {
+        // Never performed. A hang is accepted and never answered (sim.close() tears the socket down).
+        if (isWrite)
+            state.writes.push({ ...entry, failed: true });
+        if (action.kind === "fail")
+            send(res, action.status, { error: "chaos" }, action.headers);
+        return;
+    }
+    const logged = { ...entry };
+    if (isWrite)
+        state.writes.push(logged);
+    const r = dispatch(state, method, url, body, headersOf(req));
+    // A refused write (409, 423, 404, …) did not change anything.
+    if (r.status >= 400)
+        logged.failed = true;
+    if (action?.kind === "drop") {
+        // The request was performed; the client never hears about it.
+        req.socket.destroy();
+        return;
+    }
+    send(res, r.status, r.body, r.headers);
+}
+/** `/<provider>/…` → that provider's routes, with the prefix stripped from the path (`/<provider>` alone is `/`). */
+function dispatch(state, method, url, body, headers) {
+    const prefix = url.pathname.match(/^\/[^/]+(?=\/|$)/)?.[0];
+    const routes = prefix === undefined ? undefined : ROUTES[prefix];
+    if (prefix === undefined || !routes)
+        return new Reply(404, { error: "not found" });
+    return routes(state, { method, url, path: url.pathname.slice(prefix.length) || "/", body, headers });
+}
+/** The control endpoints tests and scenarios drive the sim with. */
+const control = router([
+    route("POST", "/_chaos", ({ state, body }) => {
+        try {
+            return new Reply(200, state.applyChaos((body ?? {})));
+        }
+        catch (e) {
+            return new Reply(400, { error: e.message });
+        }
+    }),
+    route("GET", "/_state", ({ state }) => new Reply(200, state.snapshot())),
+    route("GET", "/_writes", ({ state, url }) => {
+        const since = Number(url.searchParams.get("since") ?? 0);
+        return new Reply(200, state.writes.slice(Number.isFinite(since) ? since : 0));
+    }),
+    route("POST", "/_release", ({ state }) => new Reply(200, { released: state.release() })),
+    route("POST", "/_reset", ({ state, body }) => {
+        state.reset(body);
+        return new Reply(200, { ok: true });
+    }),
+], () => new Reply(404, { error: "not found" }));
+/** The request's headers as strings (multi-valued ones joined with `, `). */
+function headersOf(req) {
+    const out = {};
+    for (const [k, v] of Object.entries(req.headers))
+        if (v !== undefined)
+            out[k] = Array.isArray(v) ? v.join(", ") : v;
+    return out;
+}
+/** A request body: empty is `undefined`; null when it is not JSON. */
+/**
+ * A form body (`application/x-www-form-urlencoded`) as the object it encodes, bracket-nested the way Stripe reads
+ * it: `a[b]=1&c[0]=x` is `{ a: { b: "1" }, c: ["x"] }`. Every value is a string.
+ */
+function parseForm(raw) {
+    const out = {};
+    for (const [name, value] of new URLSearchParams(raw)) {
+        const path = name.split(/\[|\]\[|\]/).filter((s) => s !== "");
+        let cur = out;
+        path.forEach((seg, i) => {
+            const last = i === path.length - 1;
+            const slot = cur;
+            if (last)
+                slot[seg] = value;
+            else
+                cur = (slot[seg] ??= /^\d+$/.test(path[i + 1]) ? [] : {});
+        });
+    }
+    return out;
+}
+function parseJson(raw) {
+    if (raw.length === 0)
+        return { body: undefined };
+    try {
+        return { body: JSON.parse(raw) };
+    }
+    catch {
+        return null;
+    }
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        req.on("error", reject);
+    });
+}
+function send(res, status, body, headers = {}) {
+    if (status === 204) {
+        // No Content means no body, not the JSON `null`.
+        res.writeHead(204, headers);
+        res.end();
+        return;
+    }
+    // A provider that answers in another format (S3's XML) sets its own content type and passes the text.
+    const raw = typeof body === "string" && headers["content-type"] !== undefined;
+    const text = raw ? body : JSON.stringify(body ?? null);
+    res.writeHead(status, { "content-type": "application/json", ...headers, "content-length": Buffer.byteLength(text) });
+    res.end(text);
+}
+function sha256(s) {
+    return createHash("sha256").update(s).digest("hex");
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/state.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 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 { type ChaosAction, type ChaosConfig, type ChaosRequest } from "./chaos.js";
+import type { ProviderSim, SimCore } from "./provider.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 declare const PROVIDERS: {
+    vercel: ProviderSim<import("./routes/vercel.js").VercelState, import("./routes/vercel.js").VercelSeed>;
+    neon: ProviderSim<import("./routes/neon.js").NeonState, import("./routes/neon.js").NeonSeed>;
+    clerk: ProviderSim<import("./routes/clerk.js").ClerkState, import("./routes/clerk.js").ClerkSeed>;
+    planetscale: ProviderSim<import("./routes/planetscale.js").PlanetscaleState, import("./routes/planetscale.js").PlanetscaleSeed>;
+    launchdarkly: ProviderSim<import("./routes/launchdarkly.js").LaunchdarklyState, import("./routes/launchdarkly.js").LaunchdarklySeed>;
+    rest: ProviderSim<import("./routes/rest.js").RestState, import("./routes/rest.js").RestSeed>;
+    supabase: ProviderSim<import("./routes/supabase.js").SupabaseState, import("./routes/supabase.js").SupabaseSeed>;
+    netlify: ProviderSim<import("./routes/netlify.js").NetlifyState, import("./routes/netlify.js").NetlifySeed>;
+    cloudflare: ProviderSim<import("./routes/cloudflare.js").CloudflareState, import("./routes/cloudflare.js").CloudflareSeed>;
+    aws: ProviderSim<import("./routes/aws.js").AwsState, import("./routes/aws.js").AwsSeed>;
+    railway: ProviderSim<import("./routes/railway.js").RailwayState, import("./routes/railway.js").RailwaySeed>;
+    fly: ProviderSim<import("./routes/fly.js").FlyState, import("./routes/fly.js").FlySeed>;
+    algolia: ProviderSim<import("./routes/algolia.js").AlgoliaState, import("./routes/algolia.js").AlgoliaSeed>;
+    xata: ProviderSim<import("./routes/xata.js").XataState, import("./routes/xata.js").XataSeed>;
+    digitalocean: ProviderSim<import("./routes/digitalocean.js").DigitaloceanState, import("./routes/digitalocean.js").DigitaloceanSeed>;
+};
+type Providers = typeof PROVIDERS;
+/** A simulated provider's name: its URL prefix, seed key and state key. */
+export type ProviderName = keyof Providers;
+type StateOf<P> = P extends ProviderSim<infer S, infer _D> ? S : never;
+type SeedOf<P> = P extends ProviderSim<infer _S, infer D> ? D : never;
+/** The state object of every provider, by name (`state.vercel`, `state.neon`, ...). */
+export type ProviderStates = {
+    [K in ProviderName]: StateOf<Providers[K]>;
+};
+/**
+ * Initial state for a sim (or a reset): per-provider seeds and optional chaos. Providers it does not name keep
+ * their defaults.
+ */
+export type SimSeed = {
+    /** Chaos applied right after the seed, e.g. `{ page_size: 2 }`. */
+    chaos?: Partial<ChaosConfig>;
+} & {
+    [K in ProviderName]?: SeedOf<Providers[K]>;
+};
+/** The demo projects every provider starts with when a seed does not name it. */
+export declare const DEFAULT_SEED: SimSeed;
+/**
+ * One write the sim received, for assertions such as "the second apply wrote nothing". Bodies are hashed, never
+ * stored.
+ */
+export interface WriteLogEntry {
+    at: string;
+    method: string;
+    path: string;
+    bodyHash: string;
+    /** The write changed nothing: failed by chaos, or refused by the provider (4xx/5xx). */
+    failed?: true;
+}
+/** The registry as the core sees it: names and type-erased providers. */
+export declare function providerEntries(): Array<[ProviderName, ProviderSim<unknown, unknown>]>;
+/**
+ * The whole fake cloud in memory: chaos, the write log, and each provider's state as `state.<provider>`. Tests
+ * seed and inspect it directly. The per-provider fields are declared by this interface and assigned in `reset`.
+ */
+export interface SimState extends ProviderStates {
+}
+export declare class SimState implements SimCore {
+    chaos: ChaosConfig;
+    writes: WriteLogEntry[];
+    private seq;
+    private held;
+    constructor(seed?: Partial<SimSeed>);
+    nextId(prefix: string): string;
+    /** The state object of one provider. */
+    provider(name: ProviderName): unknown;
+    /**
+     * 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?: Partial<SimSeed> | null): void;
+    /** Merge a chaos request; drift is applied to state right away and not kept. */
+    applyChaos(req: ChaosRequest): ChaosConfig;
+    /**
+     * 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: string, value: string): void;
+    /** Requests currently held by chaos `hold_next`. */
+    get heldCount(): number;
+    /** Park the calling request until `release()`. */
+    hold(): Promise<void>;
+    /** Let every held request proceed; returns how many there were. */
+    release(): number;
+    /** Decide what chaos does to this request, consuming one count when it does something. */
+    chaosFor(method: string, path: string): ChaosAction | null;
+    snapshot(): unknown;
+}
+export {};

package/dist/state.js

@@ -0,0 +1,121 @@
+/**
+ * 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 { restSim } from "./routes/rest.js";
+import { vercelSim } from "./routes/vercel.js";
+import { netlifySim } from "./routes/netlify.js";
+import { planetscaleSim } from "./routes/planetscale.js";
+import { launchdarklySim } from "./routes/launchdarkly.js";
+import { supabaseSim } from "./routes/supabase.js";
+import { awsSim } from "./routes/aws.js";
+import { railwaySim } from "./routes/railway.js";
+import { flySim } from "./routes/fly.js";
+import { cloudflareSim } from "./routes/cloudflare.js";
+import { algoliaSim } from "./routes/algolia.js";
+import { xataSim } from "./routes/xata.js";
+import { digitaloceanSim } from "./routes/digitalocean.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, planetscale: planetscaleSim, launchdarkly: launchdarklySim, rest: restSim, supabase: supabaseSim, netlify: netlifySim, cloudflare: cloudflareSim, aws: awsSim, railway: railwaySim, fly: flySim, algolia: algoliaSim, xata: xataSim, digitalocean: digitaloceanSim };
+/** 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":"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"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@sponson/sim",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.5.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"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "homepage": "https://sponson.mintlify.site",
+  "bugs": {
+    "url": "https://github.com/MishaBear94/Sponson/issues"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
 }