@schmock/cli 1.1.1 → 1.4.0

package/dist/cli.d.ts

@@ -6,6 +6,10 @@ export interface CliOptions {
     seed?: string;
     cors?: boolean;
     debug?: boolean;
+    fakerSeed?: number;
+    errors?: boolean;
+    watch?: boolean;
+    admin?: boolean;
 }
 export interface CliServer {
     server: Server;
@@ -17,5 +21,16 @@ export declare function createCliServer(options: CliOptions): Promise<CliServer>
 export declare function parseCliArgs(args: string[]): CliOptions & {
     help: boolean;
 };
+export interface WatchHandle {
+    close(): void;
+}
+/**
+ * Reload a CLI server: close the old one, create a new one on the same port.
+ */
+export declare function reloadServer(current: CliServer, options: CliOptions): Promise<CliServer>;
+/**
+ * Watch a spec file and hot-reload the server on changes.
+ */
+export declare function startWatch(specPath: string, options: CliOptions, getCurrentServer: () => CliServer, onReload: (server: CliServer) => void): WatchHandle;
 export declare function run(args: string[]): Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAOxC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;CACf;AAiCD,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA2G7E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CA2B3E;AAeD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCvD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAOxC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;CACf;AA0ED,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA0H7E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAqC3E;AAqBD,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,CAAC,CAQpB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,EACnB,gBAAgB,EAAE,MAAM,SAAS,EACjC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GACpC,WAAW,CA2Bb;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDvD"}

package/dist/cli.js

@@ -1,5 +1,5 @@
-/// <reference path="../../../types/schmock.d.ts" />
-import { readFileSync } from "node:fs";
+/// <reference path="../../core/schmock.d.ts" />
+import { readFileSync, watch } from "node:fs";
 import { createServer } from "node:http";
 import { parseArgs } from "node:util";
 import { schmock, toHttpMethod } from "@schmock/core";
@@ -28,10 +28,39 @@ function loadSeedFile(seedPath) {
     }
     return result;
 }
+function handleAdminRequest(method, path, mock, res, headers) {
+    const route = path.replace("/schmock-admin/", "");
+    if (method === "GET" && route === "routes") {
+        res.writeHead(200, headers);
+        res.end(JSON.stringify(mock.getRoutes()));
+        return;
+    }
+    if (method === "GET" && route === "state") {
+        res.writeHead(200, headers);
+        res.end(JSON.stringify(mock.getState()));
+        return;
+    }
+    if (method === "POST" && route === "reset") {
+        mock.resetHistory();
+        mock.resetState();
+        res.writeHead(204, headers);
+        res.end();
+        return;
+    }
+    if (method === "GET" && route === "history") {
+        res.writeHead(200, headers);
+        res.end(JSON.stringify(mock.history()));
+        return;
+    }
+    res.writeHead(404, headers);
+    res.end(JSON.stringify({ error: "Unknown admin endpoint", code: "NOT_FOUND" }));
+}
 export async function createCliServer(options) {
     const mock = schmock({ debug: options.debug });
     const openapiOptions = {
         spec: options.spec,
+        fakerSeed: options.fakerSeed,
+        validateRequests: options.errors,
     };
     if (options.seed) {
         openapiOptions.seed = loadSeedFile(options.seed);
@@ -41,6 +70,7 @@ export async function createCliServer(options) {
     const hostname = options.hostname ?? "127.0.0.1";
     const port = options.port ?? 3000;
     const cors = options.cors ?? false;
+    const admin = options.admin ?? false;
     const httpServer = createServer((req, res) => {
         // Handle CORS preflight
         if (cors && req.method === "OPTIONS") {
@@ -49,8 +79,17 @@ export async function createCliServer(options) {
             return;
         }
         const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
-        const method = toHttpMethod(req.method ?? "GET");
         const path = url.pathname;
+        // Admin API intercept
+        if (admin && path.startsWith("/schmock-admin/")) {
+            const adminHeaders = {
+                "content-type": "application/json",
+                ...(cors ? CORS_HEADERS : {}),
+            };
+            handleAdminRequest(req.method ?? "GET", path, mock, res, adminHeaders);
+            return;
+        }
+        const method = toHttpMethod(req.method ?? "GET");
         const headers = {};
         for (const [key, value] of Object.entries(req.headers)) {
             if (typeof value === "string") {
@@ -128,6 +167,10 @@ export function parseCliArgs(args) {
             seed: { type: "string" },
             cors: { type: "boolean", default: false },
             debug: { type: "boolean", default: false },
+            errors: { type: "boolean", default: false },
+            watch: { type: "boolean", default: false },
+            admin: { type: "boolean", default: false },
+            "seed-random": { type: "string" },
             help: { type: "boolean", short: "h", default: false },
         },
         strict: true,
@@ -141,6 +184,12 @@ export function parseCliArgs(args) {
         seed: values.seed,
         cors: values.cors,
         debug: values.debug,
+        errors: values.errors,
+        watch: values.watch,
+        admin: values.admin,
+        fakerSeed: values["seed-random"]
+            ? Number(values["seed-random"])
+            : undefined,
         help: values.help ?? false,
     };
 }
@@ -154,8 +203,53 @@ Options:
   --seed <path>       JSON file with seed data
   --cors              Enable CORS for all responses
   --debug             Enable debug logging
+  --errors            Enable request body validation against spec
+  --watch             Watch spec file and hot-reload on changes
+  --admin             Enable /schmock-admin/* introspection endpoints
+  --seed-random <n>   Seed for deterministic random generation
   -h, --help          Show this help message
 `;
+const WATCH_DEBOUNCE_MS = 500;
+/**
+ * Reload a CLI server: close the old one, create a new one on the same port.
+ */
+export async function reloadServer(current, options) {
+    const port = current.port;
+    // Close existing connections and wait for the server to fully close
+    current.server.closeAllConnections();
+    await new Promise((resolve) => {
+        current.server.close(() => resolve());
+    });
+    return createCliServer({ ...options, port });
+}
+/**
+ * Watch a spec file and hot-reload the server on changes.
+ */
+export function startWatch(specPath, options, getCurrentServer, onReload) {
+    let debounceTimer;
+    const watcher = watch(specPath, () => {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(async () => {
+            process.stderr.write("\nSpec changed, reloading...\n");
+            try {
+                const newServer = await reloadServer(getCurrentServer(), options);
+                onReload(newServer);
+                process.stderr.write(`Schmock server reloaded on http://${newServer.hostname}:${newServer.port}\n`);
+            }
+            catch (err) {
+                process.stderr.write(`Reload failed: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }, WATCH_DEBOUNCE_MS);
+    });
+    return {
+        close() {
+            watcher.close();
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+        },
+    };
+}
 export async function run(args) {
     const options = parseCliArgs(args);
     if (options.help) {
@@ -168,14 +262,25 @@ export async function run(args) {
         process.exitCode = 1;
         return;
     }
-    const cliServer = await createCliServer(options);
+    let cliServer = await createCliServer(options);
     process.stderr.write(`Schmock server running on http://${cliServer.hostname}:${cliServer.port}\n`);
     process.stderr.write(`Spec: ${options.spec}\n`);
     if (options.cors) {
         process.stderr.write("CORS: enabled\n");
     }
+    if (options.admin) {
+        process.stderr.write("Admin: enabled (/schmock-admin/*)\n");
+    }
+    let watchHandle;
+    if (options.watch) {
+        watchHandle = startWatch(options.spec, options, () => cliServer, (newServer) => {
+            cliServer = newServer;
+        });
+        process.stderr.write("Watch: enabled\n");
+    }
     const shutdown = () => {
         process.stderr.write("\nShutting down...\n");
+        watchHandle?.close();
         cliServer.close();
     };
     process.on("SIGINT", shutdown);