callman-core 1.38.0 → 1.40.0

package/dist-cjs/mock-engine/node/index.js

@@ -0,0 +1,16 @@
+"use strict";
+// `callman-core/mock-engine/node` — Node-only mock engine pieces: the Ajv
+// body validator, the vm regex runner, the file-backed data store and the
+// node:http adapter.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodeMockHandler = exports.FileDataStore = exports.createVmRegexRunner = exports.normalizeStrictSchema = exports.createAjvBodyValidator = void 0;
+var ajv_body_validator_js_1 = require("./ajv-body-validator.js");
+Object.defineProperty(exports, "createAjvBodyValidator", { enumerable: true, get: function () { return ajv_body_validator_js_1.createAjvBodyValidator; } });
+Object.defineProperty(exports, "normalizeStrictSchema", { enumerable: true, get: function () { return ajv_body_validator_js_1.normalizeStrictSchema; } });
+var vm_regex_runner_js_1 = require("./vm-regex-runner.js");
+Object.defineProperty(exports, "createVmRegexRunner", { enumerable: true, get: function () { return vm_regex_runner_js_1.createVmRegexRunner; } });
+var file_store_js_1 = require("./file-store.js");
+Object.defineProperty(exports, "FileDataStore", { enumerable: true, get: function () { return file_store_js_1.FileDataStore; } });
+var node_http_adapter_js_1 = require("./node-http-adapter.js");
+Object.defineProperty(exports, "createNodeMockHandler", { enumerable: true, get: function () { return node_http_adapter_js_1.createNodeMockHandler; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/mock-engine/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mock-engine/node/index.ts"],"names":[],"mappings":";AAAA,0EAA0E;AAC1E,0EAA0E;AAC1E,qBAAqB;;;AAErB,iEAA+G;AAAtG,+HAAA,sBAAsB,OAAA;AAAE,8HAAA,qBAAqB,OAAA;AACtD,2DAA0G;AAAjG,yHAAA,mBAAmB,OAAA;AAC5B,iDAA2E;AAAlE,8GAAA,aAAa,OAAA;AACtB,+DAAmH;AAA1G,6HAAA,qBAAqB,OAAA"}

package/dist-cjs/mock-engine/node/node-http-adapter.js

@@ -0,0 +1,219 @@
+"use strict";
+// node:http adapter: parses an IncomingMessage into a MockRequest, runs the
+// engine, then carries out the delay and transport (respond, hang, drop).
+// The desktop's local mock servers use it; the definition is resolved per
+// request, so saving a mock hot-swaps it without restarting the server.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodeMockHandler = void 0;
+const node_crypto_1 = require("node:crypto");
+const engine_js_1 = require("../engine.js");
+const truncate = (text, max) => {
+    if (text === null)
+        return null;
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+};
+const flatHeaders = (raw) => {
+    const out = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (value === undefined)
+            continue;
+        out[key.toLowerCase()] = Array.isArray(value) ? value.join(", ") : value;
+    }
+    return out;
+};
+const queryObject = (params) => {
+    const out = {};
+    for (const [key, value] of params) {
+        if (key === "__proto__" || key === "constructor" || key === "prototype")
+            continue;
+        const existing = out[key];
+        if (existing === undefined)
+            out[key] = value;
+        else if (Array.isArray(existing))
+            existing.push(value);
+        else
+            out[key] = [existing, value];
+    }
+    return out;
+};
+const parseBody = (text, contentType) => {
+    if (text.length === 0)
+        return { ok: true, body: undefined };
+    if (/\bjson\b/i.test(contentType)) {
+        try {
+            return { ok: true, body: JSON.parse(text) };
+        }
+        catch {
+            return { ok: false };
+        }
+    }
+    if (/application\/x-www-form-urlencoded/i.test(contentType))
+        return { ok: true, body: queryObject(new URLSearchParams(text)) };
+    return { ok: true, body: text };
+};
+const readBody = (req, limit) => new Promise((resolve) => {
+    const chunks = [];
+    let size = 0;
+    let settled = false;
+    req.on("data", (chunk) => {
+        if (settled)
+            return;
+        size += chunk.length;
+        if (size > limit) {
+            settled = true;
+            resolve({ ok: false, reason: "too-large" });
+            return;
+        }
+        chunks.push(chunk);
+    });
+    req.on("end", () => {
+        if (settled)
+            return;
+        settled = true;
+        resolve({ ok: true, text: new TextDecoder().decode(concat(chunks, size)) });
+    });
+    req.on("error", () => {
+        if (settled)
+            return;
+        settled = true;
+        resolve({ ok: false, reason: "aborted" });
+    });
+});
+const concat = (chunks, size) => {
+    const out = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return out;
+};
+const wait = (ms, res) => new Promise((resolve) => {
+    if (ms <= 0)
+        return resolve(true);
+    const timer = setTimeout(() => {
+        res.off("close", onClose);
+        resolve(true);
+    }, ms);
+    const onClose = () => {
+        clearTimeout(timer);
+        resolve(false);
+    };
+    res.once("close", onClose);
+});
+/** A request handler for `http.createServer(handler)`. */
+const createNodeMockHandler = (options) => {
+    const maxRequestBytes = options.maxRequestBytes ?? 5 * 1024 * 1024;
+    const logBodyBytes = options.logBodyBytes ?? 16 * 1024;
+    const cors = options.cors !== false;
+    return async (req, res) => {
+        const startedAt = Date.now();
+        const method = (req.method ?? "GET").toUpperCase();
+        const url = new URL(req.url ?? "/", "http://127.0.0.1");
+        const requestHeaders = flatHeaders(req.headers);
+        let requestText = null;
+        const log = (statusCode, result, outcome, responseHeaders = {}, responseBody = null) => {
+            options.onLog?.({
+                id: (0, node_crypto_1.randomUUID)(),
+                at: new Date(startedAt).toISOString(),
+                method,
+                path: url.pathname,
+                query: url.search.replace(/^\?/, ""),
+                statusCode,
+                durationMs: Date.now() - startedAt,
+                trace: result?.trace ?? null,
+                requestHeaders,
+                requestBody: truncate(requestText, logBodyBytes),
+                responseHeaders,
+                responseBody: truncate(responseBody, logBodyBytes),
+                outcome,
+            });
+        };
+        const sendJson = (status, body) => {
+            const text = JSON.stringify(body);
+            if (!res.headersSent) {
+                res.statusCode = status;
+                res.setHeader("Content-Type", "application/json; charset=utf-8");
+            }
+            res.end(text);
+            log(status, null, "error", { "content-type": "application/json; charset=utf-8" }, text);
+        };
+        if (cors) {
+            res.setHeader("Access-Control-Allow-Origin", "*");
+            res.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,PATCH,DELETE,OPTIONS,HEAD");
+            res.setHeader("Access-Control-Allow-Headers", "*");
+        }
+        if (method === "OPTIONS") {
+            res.statusCode = 204;
+            res.end();
+            log(204, null, "respond");
+            return;
+        }
+        const resolved = options.resolve();
+        if (!resolved) {
+            sendJson(503, { error: "This mock is not available" });
+            return;
+        }
+        const body = await readBody(req, maxRequestBytes);
+        if (!body.ok) {
+            if (body.reason === "too-large") {
+                res.setHeader("Connection", "close");
+                sendJson(413, { error: "Request body too large", limitBytes: maxRequestBytes });
+                req.resume();
+            }
+            else {
+                res.destroy();
+            }
+            return;
+        }
+        requestText = body.text.length > 0 ? body.text : null;
+        const parsed = parseBody(body.text, requestHeaders["content-type"] ?? "");
+        if (!parsed.ok) {
+            sendJson(400, { error: "Invalid JSON body" });
+            return;
+        }
+        const mockRequest = {
+            method,
+            path: url.pathname || "/",
+            mountPath: "",
+            query: queryObject(url.searchParams),
+            rawQuery: [...url.searchParams.entries()],
+            headers: requestHeaders,
+            body: parsed.body,
+            receivedAt: startedAt,
+        };
+        let result;
+        try {
+            result = await (0, engine_js_1.executeMockRequest)(resolved.compiled, mockRequest, resolved.ctx);
+        }
+        catch (error) {
+            resolved.ctx.logger?.error("Local mock request failed", { message: error instanceof Error ? error.message : String(error) });
+            sendJson(500, { error: "Mock engine error" });
+            return;
+        }
+        const { response, transport } = result;
+        const delay = transport.kind === "hang" ? transport.ms : result.delayMs;
+        if (!(await wait(delay, res))) {
+            log(499, result, "client-closed");
+            return;
+        }
+        if (transport.kind === "drop") {
+            if (transport.mode === "partial" && response.body.length > 1) {
+                res.writeHead(response.statusCode, response.headers);
+                res.write(response.body.slice(0, Math.max(1, Math.floor(response.body.length / 2))));
+            }
+            req.socket.destroy();
+            log(0, result, "drop", response.headers, null);
+            return;
+        }
+        res.statusCode = response.statusCode;
+        for (const [key, value] of Object.entries(response.headers)) {
+            if (key.trim())
+                res.setHeader(key, value);
+        }
+        res.end(response.body);
+        log(response.statusCode, result, transport.kind, response.headers, response.body);
+    };
+};
+exports.createNodeMockHandler = createNodeMockHandler;
+//# sourceMappingURL=node-http-adapter.js.map

package/dist-cjs/mock-engine/node/node-http-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http-adapter.js","sourceRoot":"","sources":["../../../src/mock-engine/node/node-http-adapter.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;;;AAExE,6CAAyC;AAGzC,4CAAqE;AAkCrE,MAAM,QAAQ,GAAG,CAAC,IAAmB,EAAE,GAAW,EAAiB,EAAE;IACnE,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,GAA+B,EAA0B,EAAE;IAC9E,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAuB,EAA2B,EAAE;IACvE,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW;YAAE,SAAS;QAClF,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,QAAQ,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;aACxC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YAClD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,WAAmB,EAA+C,EAAE;IACnG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC5D,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,qCAAqC,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IAC/H,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,GAAoB,EAAE,KAAa,EAAwF,EAAE,CAC7I,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE;QACnC,IAAI,OAAO;YAAE,OAAO;QACpB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;QACrB,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;QACjB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACnB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,MAAM,GAAG,CAAC,MAAoB,EAAE,IAAY,EAAc,EAAE;IAChE,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,GAAmB,EAAoB,EAAE,CACjE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEL,0DAA0D;AACnD,MAAM,qBAAqB,GAAG,CAAC,OAA+B,EAAE,EAAE;IACvE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACnE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,GAAG,IAAI,CAAC;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC;IAEpC,OAAO,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAiB,EAAE;QACxE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxD,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,WAAW,GAAkB,IAAI,CAAC;QAEtC,MAAM,GAAG,GAAG,CAAC,UAAkB,EAAE,MAAkC,EAAE,OAAe,EAAE,kBAA0C,EAAE,EAAE,eAA8B,IAAI,EAAQ,EAAE;YAC9K,OAAO,CAAC,KAAK,EAAE,CAAC;gBACd,EAAE,EAAE,IAAA,wBAAU,GAAE;gBAChB,EAAE,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;gBACrC,MAAM;gBACN,IAAI,EAAE,GAAG,CAAC,QAAQ;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;gBACpC,UAAU;gBACV,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,IAAI;gBAC5B,cAAc;gBACd,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;gBAChD,eAAe;gBACf,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;gBAClD,OAAO;aACR,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,IAAa,EAAQ,EAAE;YACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;gBACxB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;YACnE,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACd,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1F,CAAC,CAAC;QAEF,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YAClD,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,wCAAwC,CAAC,CAAC;YACxF,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAChC,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACrC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC,CAAC;gBAChF,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;YACD,OAAO;QACT,CAAC;QACD,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACtD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAgB;YAC/B,MAAM;YACN,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,GAAG;YACzB,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;YACpC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO,EAAE,cAAc;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,SAAS;SACtB,CAAC;QAEF,IAAI,MAA2B,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAA,8BAAkB,EAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7H,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACxE,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7D,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvF,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,IAAI,GAAG,CAAC,IAAI,EAAE;gBAAE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpF,CAAC,CAAC;AACJ,CAAC,CAAC;AAxHW,QAAA,qBAAqB,yBAwHhC"}

package/dist-cjs/mock-engine/node/vm-regex-runner.js

@@ -0,0 +1,97 @@
+"use strict";
+// Interruptible regex for `matches` conditions and field patterns. The
+// mock's author writes the pattern and an anonymous caller supplies the
+// subject, so every test runs inside a `vm` script with a hard timeout. A
+// pattern that timed out is "poisoned" for a while and reports no match
+// without running, so a caller cannot buy CPU per request. Invalid,
+// timed-out and poisoned patterns all report no match.
+//
+// The save-time half (`describeUnsafePattern`) lives in the universal
+// engine; this is the run-time half. The vm round trip costs ~0.1 ms.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVmRegexRunner = void 0;
+const node_vm_1 = __importDefault(require("node:vm"));
+const conditions_js_1 = require("../conditions.js");
+const createVmRegexRunner = (options = {}) => {
+    const timeoutMs = options.timeoutMs ?? 50;
+    const compiledCacheLimit = options.compiledCacheLimit ?? 500;
+    const poisonTtlMs = options.poisonTtlMs ?? 10 * 60 * 1000;
+    const poisonLimit = options.poisonLimit ?? 1000;
+    const compiled = new Map();
+    const poisonedUntil = new Map();
+    const sandbox = node_vm_1.default.createContext(Object.create(null));
+    const testScript = new node_vm_1.default.Script("pattern.test(subject)");
+    const getCompiled = (source) => {
+        if (compiled.has(source)) {
+            const hit = compiled.get(source) ?? null;
+            compiled.delete(source);
+            compiled.set(source, hit);
+            return hit;
+        }
+        let pattern;
+        try {
+            pattern = new RegExp(source);
+        }
+        catch {
+            pattern = null;
+        }
+        compiled.set(source, pattern);
+        if (compiled.size > compiledCacheLimit) {
+            const oldest = compiled.keys().next().value;
+            if (oldest !== undefined)
+                compiled.delete(oldest);
+        }
+        return pattern;
+    };
+    const isPoisoned = (source) => {
+        const until = poisonedUntil.get(source);
+        if (until === undefined)
+            return false;
+        if (until > Date.now())
+            return true;
+        poisonedUntil.delete(source);
+        return false;
+    };
+    const poison = (source) => {
+        if (poisonedUntil.size >= poisonLimit) {
+            const oldest = poisonedUntil.keys().next().value;
+            if (oldest !== undefined)
+                poisonedUntil.delete(oldest);
+        }
+        poisonedUntil.set(source, Date.now() + poisonTtlMs);
+    };
+    return {
+        test(source, subject) {
+            if (source.length > conditions_js_1.MAX_PATTERN_LENGTH * 4 || isPoisoned(source))
+                return false;
+            const pattern = getCompiled(source);
+            if (!pattern)
+                return false;
+            sandbox.pattern = pattern;
+            sandbox.subject = subject.length > conditions_js_1.MAX_REGEX_SUBJECT_CHARS ? subject.slice(0, conditions_js_1.MAX_REGEX_SUBJECT_CHARS) : subject;
+            try {
+                return testScript.runInContext(sandbox, { timeout: timeoutMs }) === true;
+            }
+            catch (error) {
+                if (error?.code === "ERR_SCRIPT_EXECUTION_TIMEOUT") {
+                    poison(source);
+                    options.logger?.warn("Mock regex timed out — disabled for 10 minutes", { pattern: source.slice(0, 120), timeoutMs });
+                }
+                return false;
+            }
+            finally {
+                sandbox.pattern = undefined;
+                sandbox.subject = undefined;
+            }
+        },
+        reset() {
+            compiled.clear();
+            poisonedUntil.clear();
+        },
+    };
+};
+exports.createVmRegexRunner = createVmRegexRunner;
+//# sourceMappingURL=vm-regex-runner.js.map

package/dist-cjs/mock-engine/node/vm-regex-runner.js.map

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

package/dist-cjs/mock-engine/render.js

@@ -0,0 +1,64 @@
+"use strict";
+// Serialise a response into the wire shape: status, headers, body string.
+//
+// Content-Type defaults: JSON for objects/arrays/numbers/booleans, text for
+// strings, nothing for an empty body. `bodyTruncated` only flags bodies above
+// the configured size for the request log; the bytes on the wire are exactly
+// what was configured.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderOutcome = exports.renderResponseConfig = exports.jsonResponse = exports.buildRendered = exports.JSON_CONTENT_TYPE = void 0;
+const templates_js_1 = require("./templates.js");
+const util_js_1 = require("./util.js");
+exports.JSON_CONTENT_TYPE = "application/json; charset=utf-8";
+const TEXT_CONTENT_TYPE = "text/plain; charset=utf-8";
+const buildRendered = (statusCode, headers, body, maxBodyBytes) => {
+    const effectiveHeaders = { ...(headers ?? {}) };
+    const contentType = (0, util_js_1.lookupHeader)(effectiveHeaders, "content-type");
+    let payload;
+    if (body === undefined || body === null || statusCode === 204 || statusCode === 304) {
+        payload = "";
+    }
+    else if (typeof body === "string") {
+        payload = body;
+        if (!contentType)
+            effectiveHeaders["content-type"] = TEXT_CONTENT_TYPE;
+    }
+    else {
+        payload = JSON.stringify(body);
+        if (!contentType)
+            effectiveHeaders["content-type"] = exports.JSON_CONTENT_TYPE;
+    }
+    return {
+        statusCode,
+        headers: effectiveHeaders,
+        body: payload,
+        rawBody: body,
+        bodyTruncated: (0, util_js_1.byteLength)(payload) > maxBodyBytes,
+    };
+};
+exports.buildRendered = buildRendered;
+const jsonResponse = (statusCode, body, maxBodyBytes, headers) => (0, exports.buildRendered)(statusCode, { "content-type": exports.JSON_CONTENT_TYPE, ...(headers ?? {}) }, body, maxBodyBytes);
+exports.jsonResponse = jsonResponse;
+/** Render a static or template response config. */
+const renderResponseConfig = (config, scope, rt, maxBodyBytes) => {
+    if (config.type === "static")
+        return (0, exports.buildRendered)(config.statusCode, config.headers, config.body, maxBodyBytes);
+    const body = (0, templates_js_1.resolveMockTemplate)(config.body, scope, rt);
+    const headers = (0, templates_js_1.resolveTemplateHeaders)(config.headers, scope, rt);
+    return (0, exports.buildRendered)(config.statusCode, headers, body, maxBodyBytes);
+};
+exports.renderResponseConfig = renderResponseConfig;
+/**
+ * Render an outcome: the author's override (if any) on top of the engine's
+ * default status/body. Override bodies and header values are templates.
+ */
+const renderOutcome = (override, defaults, scope, rt, maxBodyBytes) => {
+    const statusCode = override?.statusCode ?? defaults.statusCode;
+    const body = override && Object.prototype.hasOwnProperty.call(override, "body")
+        ? (0, templates_js_1.resolveMockTemplate)(override.body, scope, rt)
+        : defaults.body;
+    const headers = { ...(defaults.headers ?? {}), ...(0, templates_js_1.resolveTemplateHeaders)(override?.headers, scope, rt) };
+    return (0, exports.buildRendered)(statusCode, headers, body, maxBodyBytes);
+};
+exports.renderOutcome = renderOutcome;
+//# sourceMappingURL=render.js.map

package/dist-cjs/mock-engine/render.js.map

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

package/dist-cjs/mock-engine/routing.js

@@ -0,0 +1,130 @@
+"use strict";
+// Route table: explicit routes + virtual endpoints derived from resources
+// (auto CRUD, nested `/parents/:id/children`) and user sign-in. One matcher,
+// highest specificity first; on a tie explicit routes win, then declaration
+// order. Literal segment = 100, `:param` = 10, `*`/`**` = 1 (same scoring
+// the v1 matcher used).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainRouteTable = exports.compileRouteTable = exports.pathSpecificity = exports.compilePath = void 0;
+exports.matchRouteTable = matchRouteTable;
+const definition_js_1 = require("./definition.js");
+const escapeRegex = (literal) => literal.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const compilePath = (path) => {
+    const paramNames = [];
+    const parts = [];
+    for (const segment of path.split("/").filter((s) => s.length > 0)) {
+        if (segment === "*" || segment === "**")
+            parts.push("(?:.+)");
+        else if (segment.startsWith(":")) {
+            paramNames.push(segment.slice(1));
+            parts.push("([^/]+)");
+        }
+        else
+            parts.push(escapeRegex(segment));
+    }
+    return { regex: new RegExp(`^/${parts.join("/")}/?$`), paramNames };
+};
+exports.compilePath = compilePath;
+const pathSpecificity = (path) => {
+    let score = 0;
+    for (const segment of path.split("/").filter((s) => s.length > 0)) {
+        if (segment === "*" || segment === "**")
+            score += 1;
+        else if (segment.startsWith(":"))
+            score += 10;
+        else
+            score += 100;
+    }
+    return score;
+};
+exports.pathSpecificity = pathSpecificity;
+const entry = (method, path, explicit, order, target) => {
+    const { regex, paramNames } = (0, exports.compilePath)(path);
+    return { method, path, regex, paramNames, specificity: (0, exports.pathSpecificity)(path), explicit, order, target };
+};
+const compileRouteTable = (definition) => {
+    const entries = [];
+    let order = 0;
+    for (const route of definition.routes) {
+        if (route.enabled === false)
+            continue;
+        entries.push(entry(route.method, route.path, true, order++, { kind: "route", route }));
+    }
+    const byName = new Map(definition.resources.map((resource) => [resource.name, resource]));
+    for (const resource of definition.resources) {
+        for (const row of (0, definition_js_1.resourceEndpointRoutes)(resource)) {
+            entries.push(entry(row.method, row.path, false, order++, { kind: "resource", resource, endpoint: row.endpoint }));
+        }
+        for (const field of resource.fields) {
+            if (!field.ref || field.ref.nested === false)
+                continue;
+            const parent = byName.get(field.ref.resource);
+            if (!parent || parent === resource)
+                continue;
+            const path = `${parent.basePath.replace(/\/+$/, "")}/:${field.name}/${resource.name}`;
+            if (resource.endpoints.list.enabled)
+                entries.push(entry("GET", path, false, order++, { kind: "nested", parent, child: resource, field: field.name, endpoint: "list" }));
+            if (resource.endpoints.create.enabled)
+                entries.push(entry("POST", path, false, order++, { kind: "nested", parent, child: resource, field: field.name, endpoint: "create" }));
+        }
+    }
+    const auth = definition.userAuth;
+    if (auth?.enabled) {
+        if (auth.endpoints.login.enabled)
+            entries.push(entry("POST", auth.endpoints.login.path, false, order++, { kind: "auth", op: "login" }));
+        if (auth.endpoints.register.enabled)
+            entries.push(entry("POST", auth.endpoints.register.path, false, order++, { kind: "auth", op: "register" }));
+        if (auth.endpoints.me.enabled)
+            entries.push(entry("GET", auth.endpoints.me.path, false, order++, { kind: "auth", op: "me" }));
+    }
+    return entries.sort((a, b) => {
+        if (b.specificity !== a.specificity)
+            return b.specificity - a.specificity;
+        if (a.explicit !== b.explicit)
+            return a.explicit ? -1 : 1;
+        return a.order - b.order;
+    });
+};
+exports.compileRouteTable = compileRouteTable;
+const methodMatches = (routeMethod, requestMethod) => {
+    if (routeMethod === "ANY")
+        return true;
+    const method = requestMethod.toUpperCase();
+    return routeMethod === method || (method === "HEAD" && routeMethod === "GET");
+};
+/** Yield candidate matches in precedence order (callers skip ones whose `match` condition fails). */
+function* matchRouteTable(table, method, path) {
+    const normalised = path.startsWith("/") ? path : `/${path}`;
+    for (const candidate of table) {
+        if (!methodMatches(candidate.method, method))
+            continue;
+        const match = candidate.regex.exec(normalised);
+        if (!match)
+            continue;
+        const params = {};
+        candidate.paramNames.forEach((name, i) => {
+            try {
+                params[name] = decodeURIComponent(match[i + 1] ?? "");
+            }
+            catch {
+                params[name] = match[i + 1] ?? "";
+            }
+        });
+        yield { entry: candidate, params };
+    }
+}
+/** Human-readable route table for editors ("overridden by" hints). */
+const explainRouteTable = (definition) => (0, exports.compileRouteTable)(definition).map((row) => ({
+    method: row.method,
+    path: row.path,
+    kind: row.target.kind,
+    label: row.target.kind === "route"
+        ? row.target.route.name ?? `${row.target.route.method} ${row.target.route.path}`
+        : row.target.kind === "resource"
+            ? `${row.target.resource.name} · ${row.target.endpoint}`
+            : row.target.kind === "nested"
+                ? `${row.target.child.name} of ${row.target.parent.name} · ${row.target.endpoint}`
+                : `sign-in · ${row.target.op}`,
+}));
+exports.explainRouteTable = explainRouteTable;
+//# sourceMappingURL=routing.js.map

package/dist-cjs/mock-engine/routing.js.map

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