counterfact 2.6.0 → 2.8.1

package/dist/util/forward-slash-path.js

@@ -0,0 +1,63 @@
+import nodePath from "node:path";
+/**
+ * Converts a file-system path to use forward slashes as separators.
+ *
+ * On Windows, `node:path` methods such as `path.join` and `path.resolve`
+ * return paths with backslash separators.  Many parts of Counterfact
+ * (chokidar watchers, ES module import specifiers, URL routing) require
+ * forward slashes.  This function centralises that normalisation and returns
+ * a {@link ForwardSlashPath} branded type so that call sites that demand a
+ * forward-slash path are statically enforced.
+ *
+ * @param path - Any file-system path string.
+ * @returns The same path with every `\` replaced by `/`.
+ */
+export function toForwardSlashPath(path) {
+    return path.replaceAll("\\", "/");
+}
+/**
+ * Joins path segments and returns a {@link ForwardSlashPath} with forward
+ * slashes regardless of the host operating system.
+ *
+ * Equivalent to `toForwardSlashPath(nodePath.join(...paths))`.
+ *
+ * @param paths - Path segments to join.
+ * @returns The joined path normalised to forward slashes.
+ */
+export function pathJoin(...paths) {
+    return toForwardSlashPath(nodePath.join(...paths));
+}
+/**
+ * Returns the relative path from `from` to `to` using forward slashes.
+ *
+ * Equivalent to `toForwardSlashPath(nodePath.relative(from, to))`.
+ *
+ * @param from - The starting path.
+ * @param to - The destination path.
+ * @returns The relative path normalised to forward slashes.
+ */
+export function pathRelative(from, to) {
+    return toForwardSlashPath(nodePath.relative(from, to));
+}
+/**
+ * Returns the directory portion of a path using forward slashes.
+ *
+ * Equivalent to `toForwardSlashPath(nodePath.dirname(path))`.
+ *
+ * @param path - The file path.
+ * @returns The directory portion normalised to forward slashes.
+ */
+export function pathDirname(path) {
+    return toForwardSlashPath(nodePath.dirname(path));
+}
+/**
+ * Resolves a sequence of paths into an absolute path using forward slashes.
+ *
+ * Equivalent to `toForwardSlashPath(nodePath.resolve(...paths))`.
+ *
+ * @param paths - Path segments to resolve.
+ * @returns The resolved absolute path normalised to forward slashes.
+ */
+export function pathResolve(...paths) {
+    return toForwardSlashPath(nodePath.resolve(...paths));
+}

package/dist/util/load-config-file.js

@@ -0,0 +1,44 @@
+import { readFile } from "node:fs/promises";
+import { load as loadYaml } from "js-yaml";
+function kebabToCamel(str) {
+    return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function normalizeKeys(obj) {
+    return Object.fromEntries(Object.entries(obj).map(([key, value]) => [kebabToCamel(key), value]));
+}
+/**
+ * Loads and parses a counterfact YAML config file.
+ *
+ * @param configPath - Absolute or relative path to the config file.
+ * @param required - When true, throws if the file does not exist.
+ *                   When false (default), returns an empty object for missing files.
+ * @returns A plain object of config keys (camelCase) to values.
+ */
+export async function loadConfigFile(configPath, required = false) {
+    let content;
+    try {
+        content = await readFile(configPath, "utf8");
+    }
+    catch (error) {
+        if (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            if (required) {
+                throw new Error(`Config file not found: ${configPath}`, {
+                    cause: error,
+                });
+            }
+            return {};
+        }
+        throw error;
+    }
+    const parsed = loadYaml(content);
+    if (parsed === null || parsed === undefined) {
+        return {};
+    }
+    if (typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`Config file must be a YAML object (mapping): ${configPath}`);
+    }
+    return normalizeKeys(parsed);
+}

package/dist/util/read-file.js

@@ -1,5 +1,16 @@
 import fs from "node:fs/promises";
 import nodeFetch from "node-fetch";
+/**
+ * Reads the content of a file or URL and returns it as a UTF-8 string.
+ *
+ * Accepts three kinds of inputs:
+ * - **HTTP(S) URLs** — fetches with `node-fetch`.
+ * - **`file://` URLs** — reads via the Node.js `fs` module.
+ * - **File system paths** — reads via the Node.js `fs` module.
+ *
+ * @param urlOrPath - A URL string or file-system path.
+ * @returns The file contents as a string.
+ */
 export async function readFile(urlOrPath) {
     if (urlOrPath.startsWith("http")) {
         const response = await nodeFetch(urlOrPath);

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

@@ -2,6 +2,17 @@ import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
+/**
+ * Probes the current Node.js runtime to determine whether it can execute
+ * TypeScript source files directly (via `--experimental-strip-types` or
+ * equivalent).
+ *
+ * The check works by writing a tiny TypeScript module to a temporary directory
+ * and attempting to import it.  If the import succeeds and returns the
+ * expected value, the runtime supports native TypeScript execution.
+ *
+ * @returns `true` when the runtime can execute `.ts` files natively.
+ */
 export async function runtimeCanExecuteErasableTs() {
     const dir = mkdtempSync(join(tmpdir(), "ts-probe-"));
     // helper.ts is imported via .js extension — the TypeScript convention used

package/dist/util/windows-escape.js

@@ -1,5 +1,16 @@
 const UNICODE_RATIO_SYMBOL = "∶"; // U+2236
 const REGULAR_COLON = ":";
+/**
+ * Escapes a Windows absolute path for use in an ES module import specifier.
+ *
+ * On Windows, drive letters produce colons (e.g. `C:\path`) which are invalid
+ * in URL-like import paths.  The drive separator colon and any additional
+ * colons in the path are replaced with the Unicode ratio symbol `∶` (U+2236),
+ * which is visually identical but safe in import specifiers.
+ *
+ * @param path - The file-system path to escape.
+ * @returns An escaped path safe for use in an import specifier.
+ */
 export function escapePathForWindows(path) {
     if (path.at(1) === ":") {
         return (path.slice(0, 2) +
@@ -7,6 +18,13 @@ export function escapePathForWindows(path) {
     }
     return path.replaceAll(REGULAR_COLON, UNICODE_RATIO_SYMBOL);
 }
+/**
+ * Reverses the transformation applied by {@link escapePathForWindows},
+ * converting `∶` back to `:`.
+ *
+ * @param path - A previously escaped path.
+ * @returns The original unescaped path.
+ */
 export function unescapePathForWindows(path) {
     return path.replaceAll(UNICODE_RATIO_SYMBOL, REGULAR_COLON);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "counterfact",
-  "version": "2.6.0",
+  "version": "2.8.1",
   "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",
@@ -21,9 +21,9 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pmcelhaney/counterfact.git"
+    "url": "git+https://github.com/counterfact/api-simulator.git"
   },
-  "bugs": "https://github.com/pmcelhaney/counterfact/issues",
+  "bugs": "https://github.com/counterfact/api-simulator/issues",
   "homepage": "https://counterfact.dev",
   "funding": {
     "type": "github",
@@ -56,7 +56,7 @@
     "node": ">=22"
   },
   "bin": {
-    "counterfact": "./bin/counterfact.js"
+    "counterfact": "bin/counterfact.js"
   },
   "files": [
     "bin",
@@ -67,7 +67,7 @@
     "test": "yarn node --experimental-vm-modules ./node_modules/jest-cli/bin/jest --testPathIgnorePatterns=black-box",
     "test:black-box": "rimraf dist && yarn build && python3 -m pytest test-black-box/ -v",
     "test:tsd": "tsd --typings ./dist/server/counterfact-types/index.ts --files ./test/**/*.test-d.ts",
-    "build": "rm -rf dist && tsc && copyfiles -f \"src/client/**\" dist/client && copyfiles -f \"src/counterfact-types/*.ts\" dist/server/counterfact-types && copyfiles -f \"src/server/*.cjs\" dist/server",
+    "build": "rm -rf dist && tsc && copyfiles -f \"src/counterfact-types/*.ts\" dist/server/counterfact-types && copyfiles -f \"src/server/*.cjs\" dist/server",
     "prepack": "yarn build",
     "release": "npx changeset publish",
     "prepare": "husky install",
@@ -76,7 +76,7 @@
     "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 ./openapi-example.yaml out",
+    "go:example": "yarn build && node ./bin/counterfact.js ./test/fixtures/openapi-example.yaml out",
     "counterfact": "./bin/counterfact.js",
     "postinstall": "patch-package"
   },
@@ -84,7 +84,7 @@
     "@changesets/cli": "2.30.0",
     "@eslint/js": "10.0.1",
     "@jest/globals": "^30.3.0",
-    "@swc/core": "1.15.21",
+    "@swc/core": "1.15.24",
     "@swc/jest": "0.2.39",
     "@testing-library/dom": "10.4.1",
     "@types/debug": "^4.1.12",
@@ -98,7 +98,7 @@
     "@typescript-eslint/eslint-plugin": "^8.58.0",
     "@typescript-eslint/parser": "^8.58.0",
     "copyfiles": "2.4.1",
-    "eslint": "10.1.0",
+    "eslint": "10.2.0",
     "eslint-formatter-github-annotations": "0.1.0",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-etc": "2.0.3",
@@ -126,12 +126,11 @@
     "@apidevtools/json-schema-ref-parser": "13.0.5",
     "@hapi/accept": "6.0.3",
     "@types/json-schema": "7.0.15",
-    "ajv": "6.14.0",
+    "ajv": "8.18.0",
     "chokidar": "5.0.0",
     "commander": "14.0.3",
     "debug": "4.4.3",
     "fs-extra": "11.3.4",
-    "handlebars": "4.7.9",
     "http-terminator": "3.2.0",
     "js-yaml": "4.1.1",
     "json-schema-faker": "0.6.0",

package/dist/client/README.md

@@ -1,14 +0,0 @@
-# `src/client/` — Built-in UI Templates
-
-This directory contains [Handlebars](https://handlebarsjs.com/) (`.hbs`) templates that are rendered by `page-middleware.ts` to produce the browser-facing pages bundled with Counterfact.
-
-## Files
-
-| File | Description |
-|---|---|
-| `index.html.hbs` | Template for the Counterfact dashboard (`/counterfact/`); lists registered routes and shows server status |
-| `rapi-doc.html.hbs` | Template for the interactive API documentation page (`/counterfact/swagger/`); embeds the [RapiDoc](https://rapidocweb.com/) viewer and adds VSCode "open file" links |
-
-## How It Works
-
-When a request arrives for `/counterfact/` or `/counterfact/swagger/`, `page-middleware.ts` compiles the appropriate template with runtime data (routes, port, base path, etc.) and sends the resulting HTML to the browser. No build step is required; templates are rendered on the fly.

package/dist/client/index.html.hbs

@@ -1,244 +0,0 @@
-<!--
-This code is hideous. I'm trying to get a feel for the layout and it's easier 
-for me to push pixels in devtools than use a real tool like Figma. I'll clean
-it up later. In the mean time, I welcome pull requests. :)
---->
-
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <title>Counterfact</title>
-    <meta charset="utf-8">
-    <meta name="description" content="Counterfact Dashboard" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-
-    <style type="text/css">
-        body { 
-            font-family: Helvetica, Arial, sans-serif;
-            max-width: 800px;
-            margin: 0 auto;
-            background-color: white;
-            color: black;
-        } 
-        
-        a {
-          color: #fff;
-        }
-
-        h1 {
-          text-align: center;
-        }
-
-        table {
-          width: 100%;
-          border-collapse: collapse;
-        }
-
-        .tilt {
-          width: 1.5em;
-          position: relative;
-          padding-top: 75px;
-        }
-
-        .tilt > * {
-          display: block;
-          position: absolute;
-          transform: rotate(-90deg);
-          transform-origin: left;
-          text-align: center;
-          bottom: 0;
-          left: 20px;
-        
-        }
-
-        thead {
-          position: sticky;
-          top: 0;
-        }
-
-        th.path > * {
-          visibility: hidden;
-        }
-
-        td.path {
-          font-family: monospace;
-          font-size: 1.4em;
-        }
-
-        .path {
-          text-align: left;
-          padding-left: 20px;
-        }
-        
-        .method-identifier {
-          text-align: center;
-          font-size: 1.5em;
-          font-weight: bold;
-          color: #333;
-          padding: 0 0.5em;
-        }
-
-        tbody tr:hover {
-          background-color: #ccc;
-        }
-      
-        .path a {
-          color: black;
-          text-decoration: none;
-        }
-
-
-        .buttons {
-          position: relative;
-          display: flex;
-          justify-content: center;
-          top: -40px;
-          left: 72px;
-
-        }
-        .buttons > a {
-          display: inline-block;
-          margin: 0 0.5em;
-          padding: 0.5em 1em;
-          background-color: #0071b5;
-          border-radius: 5px;
-          color: white;
-          text-decoration: none;
-          
-        }
-
-        #paths-container {
-          margin-top: -35px;
-        }
-      
-    </style>
-  <body>
-
-   
-
-    <h1>
-      
-<svg
-   width="616.38678"
-   height="104.03941"
-   viewBox="0 0 163.08567 27.527093"
-   version="1.1"
-   id="svg1"
-   inkscape:version="1.3.2 (091e20e, 2023-11-25)"
-   sodipodi:docname="counterfact.svg"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <sodipodi:namedview
-     id="namedview1"
-     pagecolor="#ffffff"
-     bordercolor="#000000"
-     borderopacity="0.25"
-     inkscape:showpageshadow="2"
-     inkscape:pageopacity="0.0"
-     inkscape:pagecheckerboard="0"
-     inkscape:deskcolor="#d1d1d1"
-     inkscape:document-units="mm"
-     inkscape:zoom="1.4873456"
-     inkscape:cx="308.93964"
-     inkscape:cy="100.17847"
-     inkscape:window-width="1728"
-     inkscape:window-height="1051"
-     inkscape:window-x="0"
-     inkscape:window-y="38"
-     inkscape:window-maximized="1"
-     inkscape:current-layer="svg1" />
-  <defs
-     id="defs1" />
-  <g
-     id="g6"
-     transform="matrix(1.0103886,0,0,1.0103886,-29.555241,-50.917297)">
-    <g
-       id="g1"
-       transform="matrix(0.27630185,0,0,0.27630185,16.871974,36.385623)">
-      <polygon
-         points="155.19615,103 130.19615,146.30127 105.19615,103 "
-         fill="#f58e00"
-         id="polygon1" />
-      <polygon
-         points="125,149.30127 75,149.30127 100,106 "
-         fill="#0071b5"
-         id="polygon2" />
-      <polygon
-         points="69.803848,146.30127 44.803848,103 94.803848,103 "
-         fill="#0071b5"
-         id="polygon3" />
-      <polygon
-         points="44.803848,97 69.803848,53.69873 94.803848,97 "
-         fill="#0071b5"
-         id="polygon4" />
-      <polygon
-         points="75,50.69873 125,50.69873 100,94 "
-         fill="#0071b5"
-         id="polygon5" />
-      <polygon
-         points="130.19615,53.69873 155.19615,97 105.19615,97 "
-         fill="#0071b5"
-         id="polygon6" />
-    </g>
-  </g>
-  <g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1"
-     transform="translate(8.8561952,-0.31740497)">
-    <path
-       style="font-weight:bold;font-size:16.9333px;font-family:Futura;-inkscape-font-specification:'Futura, Bold';fill:#0071b5;fill-opacity:1;stroke-width:0.322562"
-       d="M 39.469822,10.780228 Q 38.066034,9.0667813 36.00164,9.0667813 q -0.908333,0 -1.692803,0.330303 -0.763826,0.330302 -1.321212,0.9083327 -0.557387,0.557386 -0.887689,1.341856 -0.309659,0.78447 -0.309659,1.692803 0,0.928977 0.309659,1.713448 0.330302,0.78447 0.887689,1.3625 0.578031,0.57803 1.341857,0.908334 0.763825,0.330303 1.651515,0.330303 1.94053,0 3.488825,-1.651516 v 4.789394 l -0.412879,0.144508 q -0.928976,0.330303 -1.734091,0.474811 -0.805114,0.165151 -1.589583,0.165151 -1.610227,0 -3.096591,-0.598674 -1.46572,-0.619319 -2.601137,-1.713447 -1.114773,-1.114773 -1.796023,-2.621781 -0.68125,-1.527651 -0.68125,-3.323675 0,-1.796023 0.660606,-3.282386 0.681251,-1.5070074 1.796023,-2.5804934 1.135417,-1.094128 2.621781,-1.692803 1.486364,-0.619317 3.117235,-0.619317 0.928978,0 1.816667,0.206439 0.908333,0.185795 1.899242,0.598673 z m 5.739013,5.016479 q 0,0.536741 0.185795,0.990908 0.20644,0.433522 0.5161,0.763826 0.330302,0.330302 0.763825,0.516099 0.454168,0.185794 0.949622,0.185794 0.495453,0 0.928977,-0.185794 0.454166,-0.185797 0.763825,-0.516099 0.330303,-0.330304 0.516099,-0.763826 0.20644,-0.454167 0.20644,-0.970265 0,-0.495454 -0.20644,-0.928978 -0.185796,-0.454167 -0.516099,-0.784469 -0.309659,-0.330304 -0.763825,-0.5161 -0.433524,-0.185794 -0.928977,-0.185794 -0.495454,0 -0.949622,0.185794 -0.433523,0.185796 -0.763825,0.5161 -0.30966,0.330302 -0.5161,0.763825 -0.185795,0.433522 -0.185795,0.928979 z m -3.942993,-0.04129 q 0,-1.176705 0.474811,-2.188258 0.474811,-1.032196 1.321211,-1.775379 0.846403,-0.763826 2.002464,-1.197348 1.176704,-0.433522 2.559849,-0.433522 1.3625,0 2.51856,0.433522 1.176704,0.412878 2.023106,1.176704 0.867045,0.743182 1.341856,1.796023 0.474811,1.032198 0.474811,2.291477 0,1.259281 -0.495454,2.312123 -0.474811,1.032196 -1.321213,1.796022 -0.846402,0.743182 -2.04375,1.156061 -1.176705,0.412879 -2.559848,0.412879 -1.362501,0 -2.518563,-0.412879 -1.15606,-0.412879 -2.002462,-1.176704 -0.825756,-0.763826 -1.300567,-1.816668 -0.474811,-1.073484 -0.474811,-2.374053 z m 18.600208,-5.20227 v 5.9661 q 0,1.961175 1.899242,1.961175 1.899242,0 1.899242,-1.961175 v -5.9661 h 3.736555 v 6.688638 q 0,2.14697 -1.424433,3.220454 -1.403788,1.073485 -4.211364,1.073485 -2.807577,0 -4.232008,-1.073485 -1.403788,-1.073488 -1.403788,-3.220458 v -6.688638 z m 10.074252,0 h 3.736558 v 1.341857 q 0.763823,-0.928978 1.548299,-1.238636 0.784462,-0.330304 1.837303,-0.330304 1.114777,0 1.89924,0.371591 0.805115,0.350947 1.362508,1.011553 0.454175,0.536743 0.619315,1.197349 0.165157,0.660606 0.165157,1.507007 v 6.729926 h -3.736558 v -5.34678 q 0,-0.784472 -0.123862,-1.259282 -0.103262,-0.495455 -0.392233,-0.78447 -0.247728,-0.247727 -0.557388,-0.350946 -0.30966,-0.103224 -0.660611,-0.103224 -0.949619,0 -1.465715,0.578031 -0.495455,0.557385 -0.495455,1.610227 v 5.656437 h -3.736558 z m 17.877642,3.117236 v 7.473107 h -3.736542 v -7.473107 h -1.238638 v -3.117236 h 1.238638 V 7.3739806 h 3.736542 v 3.1791664 h 2.126327 v 3.117236 z m 11.478028,0.639962 q -0.185801,-0.78447 -0.763829,-1.259281 -0.578036,-0.474811 -1.403791,-0.474811 -0.867046,0 -1.42443,0.454167 -0.536741,0.454167 -0.681237,1.279925 z m -4.376513,2.167613 q 0,2.415342 2.270832,2.415342 1.217991,0 1.837315,-0.99091 h 3.612684 q -1.09413,3.633334 -5.470643,3.633334 -1.341865,0 -2.456623,-0.392234 -1.114777,-0.41288 -1.919893,-1.15606 -0.784472,-0.743183 -1.218004,-1.77538 -0.433505,-1.032197 -0.433505,-2.312122 0,-1.321211 0.41287,-2.374053 0.41288,-1.073485 1.176708,-1.816667 0.76382,-0.743182 1.837301,-1.135417 1.094143,-0.412878 2.456641,-0.412878 1.341844,0 2.415334,0.412878 1.073484,0.392235 1.816664,1.15606 0.74319,0.763828 1.13541,1.878601 0.39225,1.094128 0.39225,2.477272 v 0.392234 z m 9.991641,-5.924811 h 3.73656 v 1.734092 q 0.59868,-0.949622 1.46571,-1.445077 0.86705,-0.516098 2.02311,-0.516098 0.1445,0 0.30966,0 0.1858,0 0.41289,0.04129 v 3.571402 q -0.74318,-0.371592 -1.61023,-0.371592 -1.30057,0 -1.96117,0.78447 -0.63997,0.763826 -0.63997,2.25019 v 4.541667 h -3.73656 z m 14.18238,3.117236 v 7.473107 h -3.73656 v -7.473107 h -1.34185 v -3.117236 h 1.34185 V 8.9635643 q 0,-1.3212127 0.24772,-2.1056817 0.20646,-0.660606 0.66062,-1.217993 0.45416,-0.578029 1.05284,-0.990909 0.61932,-0.412878 1.32122,-0.639963 0.70189,-0.227083 1.38313,-0.227083 0.47481,0 0.86705,0.103224 0.41287,0.103224 0.82576,0.289017 v 3.261742 q -0.37159,-0.185797 -0.70189,-0.268371 -0.30966,-0.103224 -0.66062,-0.103224 -0.22707,0 -0.4748,0.08258 -0.22708,0.06193 -0.43352,0.289014 -0.20645,0.227083 -0.28902,0.660608 -0.0619,0.412878 -0.0619,1.1354157 v 1.3212117 h 2.62178 v 3.117236 z m 7.72084,2.14697 q 0,0.516098 0.18579,0.970265 0.1858,0.433522 0.49545,0.763826 0.33031,0.330302 0.76384,0.516099 0.45416,0.185794 0.97025,0.185794 0.49546,0 0.92898,-0.185794 0.45417,-0.185797 0.76384,-0.516099 0.3303,-0.330304 0.51609,-0.763826 0.20643,-0.433523 0.20643,-0.928978 0,-0.495454 -0.20643,-0.928977 -0.18579,-0.454167 -0.51609,-0.784469 -0.30967,-0.330304 -0.76384,-0.516099 -0.43352,-0.185796 -0.92898,-0.185796 -0.51609,0 -0.97025,0.185796 -0.43353,0.185795 -0.76384,0.516099 -0.30965,0.330302 -0.49545,0.763825 -0.18579,0.41288 -0.18579,0.908334 z m 4.70682,-5.264206 h 3.7572 V 21.14349 h -3.7572 v -1.176702 q -1.19735,1.507008 -3.2411,1.507008 -1.15606,0 -2.12634,-0.412879 -0.97025,-0.433522 -1.6928,-1.197347 -0.72253,-0.763827 -1.13541,-1.796023 -0.39223,-1.032198 -0.39223,-2.250191 0,-1.135417 0.39223,-2.146969 0.39223,-1.032198 1.09414,-1.796023 0.70188,-0.763828 1.67215,-1.19735 0.97026,-0.454166 2.14696,-0.454166 1.98182,0 3.2824,1.383145 z m 14.28561,3.426895 q -0.97028,-0.660607 -1.96119,-0.660607 -0.53672,0 -1.01154,0.185796 -0.45417,0.185795 -0.80512,0.536742 -0.35094,0.330304 -0.55738,0.805115 -0.1858,0.454166 -0.1858,1.032197 0,0.557386 0.1858,1.032197 0.20644,0.454166 0.53674,0.805113 0.35095,0.330303 0.82576,0.516099 0.47482,0.185795 1.01154,0.185795 1.05286,0 1.96119,-0.722538 v 3.179167 q -1.38315,0.598674 -2.62179,0.598674 -1.15606,0 -2.20889,-0.392235 -1.0322,-0.392234 -1.83732,-1.114772 -0.78446,-0.743182 -1.25928,-1.754735 -0.4748,-1.032197 -0.4748,-2.291479 0,-1.259279 0.45416,-2.291476 0.45416,-1.052842 1.23863,-1.796024 0.78448,-0.763825 1.85796,-1.176703 1.09413,-0.433523 2.33277,-0.433523 1.36249,0 2.51856,0.57803 z m 6.2964,-0.309659 v 7.473107 h -3.73655 v -7.473107 h -1.23864 v -3.117236 h 1.23864 V 7.3739806 h 3.73655 v 3.1791664 h 2.12633 v 3.117236 z"
-       id="text1"
-       fill="#0071b5"
-       aria-label="Counterfact" />
-  </g>
-</svg>
-    </h1>
-      
-      
-      
-
-    <div class="buttons">
-      <a href="./swagger" class="button" target="_blank">Swagger UI</a>
-      <a href="{{openApiHref}}" class="button" target="_blank">OpenAPI</a>
-      <a href="https://counterfact.dev/docs/usage.html" target="_blank">Usage Guide</a>
-      <a href="https://github.com/pmcelhaney/counterfact" target="_blank">GitHub</a>
-    </div>
-
-
-
-    <div id="paths-container">
-    <table>
-      <thead>
-      <tr>
-        <th class="tilt"><span>GET</span></th>
-        <th class="tilt"><span>POST</span></th>
-        <th class="tilt"><span>PUT</span></th>
-        <th class="tilt"><span>DELETE</span></th>
-        <th class="tilt"><span>PATCH</span></th>
-        <th class="path"><span>Path</span></th>
-      </tr>
-      </thead>  
-      <tbody>
-      {{#each routes as |route|}}
-      <tr>  
-        <td class="method-identifier" title="{{route.methods.GET}}">{{#if route.methods.GET }}⚪️{{/if}}</td>
-        <td class="method-identifier" title="{{route.methods.POST}}">{{#if route.methods.POST }}⚪️{{/if}}</td>
-        <td class="method-identifier" title="{{route.methods.PUT}}">{{#if route.methods.PUT }}⚪️{{/if}}</td>
-        <td class="method-identifier" title="{{route.methods.DELETE}}">{{#if route.methods.DELETE }}⚪️{{/if}}</td>
-        <td class="method-identifier" title="{{route.methods.PATH}}">{{#if route.methods.PATCH }}⚪️{{/if}}</td>
-        <td class="path"><a href="vscode://file/{{../basePath}}/routes{{route.path}}.ts">{{route.path}}</a></td>
-      </tr>
-      {{/each}}
-      </tbody>
-    </table>
-    </div>
-
-
-
-  
-  </body>
-</html>

package/dist/client/rapi-doc.html.hbs

@@ -1,36 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <title>Counterfact</title>
-    <meta charset="utf-8">
-    <meta name="description" content="Rapidoc" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <script type="module" src="https://unpkg.com/rapidoc/dist/rapidoc-min.js"></script>
-  </head>
-  <body>
-
-
-
-     <rapi-doc spec-url="/counterfact/openapi" show-method-in-nav-bar="as-colored-block" nav-active-item-marker="left-bar" use-path-in-nav-bar="true"> 
-
-      <div slot="overview" style="background-color: #eee">
-        <p>Put an explanation of Counterfact here.</p>
-         <a
-            href="https://github.com/pmcelhaney/counterfact/blob/main/docs/usage.md#generated-code-"
-            >How does this work?</a
-          > 
-      </div>
-      {{#each routes as |route|}}
-        <a slot="get-{{escape_route route}}" href="vscode://file/{{../basePath}}/routes/{{.}}.ts">Edit in VSCode</a>
-        <a slot="put-{{escape_route route}}" href="vscode://file/{{../basePath}}/routes/{{.}}.ts">Edit in VSCode</a>
-        <a slot="post-{{escape_route route}}" href="vscode://file/{{../basePath}}/routes/{{.}}.ts">Edit in VSCode</a>
-        <a slot="delete-{{escape_route route}}" href="vscode://file/{{../basePath}}/routes/{{.}}.ts">Edit in VSCode</a>
-        <a slot="patch-{{escape_route route}}" href="vscode://file/{{../basePath}}/routes/{{.}}.ts">Edit in VSCode</a>
-
-      {{/each}}
-      </rapi-doc>
-
-
-
-  </body>
-</html>

package/dist/server/page-middleware.js

@@ -1,23 +0,0 @@
-import nodePath from "node:path";
-import { fileURLToPath } from "node:url";
-import createDebug from "debug";
-import Handlebars from "handlebars";
-import { readFile } from "../util/read-file.js";
-const __dirname = nodePath.dirname(fileURLToPath(import.meta.url));
-const debug = createDebug("counterfact:server:page-middleware");
-Handlebars.registerHelper("escape_route", (route) => route.replaceAll(/[^\w/]/gu, "-"));
-export function pageMiddleware(pathname, templateName, locals) {
-    return async (ctx, next) => {
-        const pathToHandlebarsTemplate = nodePath
-            .join(__dirname, `../client/${templateName}.html.hbs`)
-            .replaceAll("\\", "/");
-        const render = Handlebars.compile(await readFile(pathToHandlebarsTemplate));
-        if (ctx.URL.pathname === pathname) {
-            debug("rendering page: %s", pathname);
-            debug("locals: %o", locals);
-            ctx.body = render(locals);
-            return;
-        }
-        await next();
-    };
-}

package/dist/typescript-generator/generate.js

@@ -1,63 +0,0 @@
-import { existsSync } from "node:fs";
-import fs from "node:fs/promises";
-import nodePath from "node:path";
-import createDebug from "debug";
-import { ensureDirectoryExists } from "../util/ensure-directory-exists.js";
-import { OperationCoder } from "./operation-coder.js";
-import { pruneRoutes } from "./prune.js";
-import { Repository } from "./repository.js";
-import { Specification } from "./specification.js";
-const debug = createDebug("counterfact:typescript-generator:generate");
-async function buildCacheDirectory(destination) {
-    const gitignorePath = nodePath.join(destination, ".gitignore");
-    const cacheReadmePath = nodePath.join(destination, ".cache", "README.md");
-    debug("ensuring the directory containing .gitgnore exists");
-    await ensureDirectoryExists(gitignorePath);
-    debug("creating the .gitignore file if it doesn't already exist");
-    if (!existsSync(gitignorePath)) {
-        await fs.writeFile(gitignorePath, ".cache\n", "utf8");
-    }
-    debug("creating the .cache/README.md file");
-    ensureDirectoryExists(cacheReadmePath);
-    await fs.writeFile(cacheReadmePath, "This directory contains compiled JS files from the paths directory. Do not edit these files directly.\n", "utf8");
-}
-async function getPathsFromSpecification(specification) {
-    try {
-        return specification.getRequirement("#/paths") ?? new Set();
-    }
-    catch (error) {
-        process.stderr.write(`Could not find #/paths in the specification.\n${error}\n`);
-        return undefined;
-    }
-}
-export async function generate(source, destination, generateOptions, repository = new Repository()) {
-    debug("generating code from %s to %s", source, destination);
-    debug("initializing the .cache directory");
-    await buildCacheDirectory(destination);
-    debug("done initializing the .cache directory");
-    debug("creating specification from %s", source);
-    const specification = await Specification.fromFile(source);
-    debug("created specification: $o", specification);
-    debug("reading the #/paths from the specification");
-    const paths = await getPathsFromSpecification(specification);
-    debug("got %i paths", paths?.map?.length ?? 0);
-    if (generateOptions.prune && generateOptions.routes) {
-        debug("pruning defunct route files");
-        await pruneRoutes(destination, paths.map((_v, key) => key));
-        debug("done pruning");
-    }
-    const securityRequirement = specification.getRequirement("#/components/securitySchemes");
-    const securitySchemes = Object.values(securityRequirement?.data ?? {});
-    paths.forEach((pathDefinition, key) => {
-        debug("processing path %s", key);
-        const path = key === "/" ? "/index" : key;
-        pathDefinition.forEach((operation, requestMethod) => {
-            repository
-                .get(`routes${path}.ts`)
-                .export(new OperationCoder(operation, requestMethod, securitySchemes));
-        });
-    });
-    debug("telling the repository to write the files to %s", destination);
-    await repository.writeFiles(destination, generateOptions);
-    debug("finished writing the files");
-}