counterfact 2.8.1 → 2.10.0

package/dist/util/runtime-can-execute-erasable-ts.js

@@ -2,6 +2,7 @@ import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
+/* eslint-disable security/detect-non-literal-fs-filename -- runtime probe only writes fixed filenames in a fresh temporary directory. */
 /**
  * Probes the current Node.js runtime to determine whether it can execute
  * TypeScript source files directly (via `--experimental-strip-types` or

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "counterfact",
-  "version": "2.8.1",
+  "version": "2.10.0",
   "description": "Generate a TypeScript-based mock server from an OpenAPI spec in seconds — with stateful routes, hot reload, and REPL support.",
   "type": "module",
   "main": "./dist/app.js",
@@ -76,7 +76,8 @@
     "lint:quickfix": "eslint --fix . eslint --fix demo-ts --rule=\"import/namespace: 0,etc/no-deprecated:0,import/no-cycle:0,no-explicit-type-exports/no-explicit-type-exports:0,import/no-deprecated:0,import/no-self-import:0,import/default:0,import/no-named-as-default:0\" --ignore-pattern dist --ignore-pattern out",
     "go:petstore": "yarn build && yarn counterfact https://petstore3.swagger.io/api/v3/openapi.json out",
     "go:petstore2": "yarn build && yarn counterfact  https://petstore.swagger.io/v2/swagger.json out",
-    "go:example": "yarn build && node ./bin/counterfact.js ./test/fixtures/openapi-example.yaml out",
+    "go:example": "yarn build && node ./bin/counterfact.js ./test/fixtures/openapi/example.yaml out",
+    "go:multiple-apis": "yarn build && node ./bin/counterfact.js --config ./test/fixtures/config/multiple-apis.yaml",
     "counterfact": "./bin/counterfact.js",
     "postinstall": "patch-package"
   },

package/dist/server/create-koa-app.js

@@ -1,65 +0,0 @@
-import createDebug from "debug";
-import Koa from "koa";
-import bodyParser from "koa-bodyparser";
-import { koaSwagger } from "koa2-swagger-ui";
-import { adminApiMiddleware } from "./admin-api-middleware.js";
-import { routesMiddleware } from "./koa-middleware.js";
-import { openapiMiddleware } from "./openapi-middleware.js";
-const debug = createDebug("counterfact:server:create-koa-app");
-/**
- * Builds and configures the Koa application with all built-in middleware.
- *
- * The middleware stack (in order) is:
- * 1. OpenAPI document serving at `/counterfact/openapi`
- * 2. Swagger UI at `/counterfact/swagger`
- * 3. Admin API (when `config.startAdminApi` is `true`) at `/_counterfact/api/`
- * 4. Redirect `/counterfact` → `/counterfact/swagger`
- * 5. Body parser
- * 6. JSON serialisation of object bodies
- * 7. Route-dispatching middleware
- *
- * @param config - Server configuration.
- * @param dispatcher - The Dispatcher used to build the route-dispatching middleware.
- * @param registry - The route Registry used to build the admin API middleware.
- * @param contextRegistry - The ContextRegistry used to build the admin API middleware.
- * @returns A configured Koa application (not yet listening).
- */
-export function createKoaApp({ config, contextRegistry, dispatcher, registry, }) {
-    const app = new Koa();
-    app.use(openapiMiddleware([
-        {
-            path: config.openApiPath,
-            baseUrl: `//localhost:${config.port}${config.routePrefix}`,
-        },
-    ]));
-    app.use(koaSwagger({
-        routePrefix: "/counterfact/swagger",
-        swaggerOptions: {
-            url: "/counterfact/openapi",
-        },
-    }));
-    if (config.startAdminApi) {
-        app.use(adminApiMiddleware(registry, contextRegistry, config));
-    }
-    debug("basePath: %s", config.basePath);
-    app.use(async (ctx, next) => {
-        if (ctx.URL.pathname === "/counterfact") {
-            ctx.redirect("/counterfact/swagger");
-            return;
-        }
-        await next();
-    });
-    app.use(bodyParser());
-    app.use(async (ctx, next) => {
-        await next();
-        if (ctx.body !== null &&
-            ctx.body !== undefined &&
-            typeof ctx.body === "object" &&
-            !Buffer.isBuffer(ctx.body)) {
-            ctx.body = JSON.stringify(ctx.body, null, 2);
-            ctx.type = "application/json";
-        }
-    });
-    app.use(routesMiddleware(dispatcher, config));
-    return app;
-}

package/dist/server/openapi-middleware.js

@@ -1,48 +0,0 @@
-import { bundle } from "@apidevtools/json-schema-ref-parser";
-import { dump } from "js-yaml";
-/**
- * Returns a Koa middleware that serves bundled OpenAPI documents as YAML.
- *
- * When `documents` has exactly one entry the document is served at
- * `/counterfact/openapi` (backward-compatible behaviour).
- *
- * When `documents` has more than one entry each document is served at
- * `/counterfact/openapi/{id}` where `id` comes from the corresponding entry.
- *
- * Every served document is augmented with a `servers` entry (OpenAPI 3.x) and
- * a `host` field (OpenAPI 2.x / Swagger) so that the Swagger UI can send
- * requests to the running Counterfact instance.
- *
- * @param documents - Array of document descriptors. Each entry must provide
- *   `path` (file path or URL to the source OpenAPI document) and `baseUrl`
- *   (the base URL to inject, e.g. `"//localhost:3100/api"`). An optional `id`
- *   string is used to build the per-document URL when more than one document
- *   is present.
- * @returns A Koa middleware function.
- */
-export function openapiMiddleware(documents) {
-    return async (ctx, next) => {
-        let matched;
-        if (documents.length === 1) {
-            if (ctx.URL.pathname === "/counterfact/openapi") {
-                matched = documents[0];
-            }
-        }
-        else {
-            matched = documents.find((doc) => ctx.URL.pathname === `/counterfact/openapi/${doc.id}`);
-        }
-        if (matched) {
-            const openApiDocument = (await bundle(matched.path));
-            openApiDocument.servers ??= [];
-            openApiDocument.servers.unshift({
-                description: "Counterfact",
-                url: matched.baseUrl,
-            });
-            // OpenApi 2 support:
-            openApiDocument.host = matched.baseUrl;
-            ctx.body = dump(openApiDocument);
-            return;
-        }
-        await next();
-    };
-}