fexapi 0.1.5 → 0.2.1

package/README.md

@@ -33,7 +33,7 @@ Creates:
 - `fexapi/schema.fexapi`
 - `fexapi.config.json`
 - `fexapi.config.js`
-- `schemas/user.yaml` and `schemas/post.yaml` (if sample schemas are enabled)
+- `fexapi/schemas/user.yaml` and `fexapi/schemas/post.yaml` (if sample schemas are enabled)
 
 ### 2) Edit schema file
 
@@ -141,16 +141,16 @@ Notes:
 
 - `port` sets the default server port (CLI `--port` still has priority).
 - `routes` maps endpoint paths to generated payload settings.
-- `schema` maps to files under `schemas/` (for example `schema: "user"` -> `schemas/user.yaml`); unknown names fall back to a generic record.
+- `schema` maps to files under `fexapi/schemas/` (for example `schema: "user"` -> `fexapi/schemas/user.yaml`); unknown names fall back to a generic record.
 - `cors: true` enables CORS headers and OPTIONS preflight handling.
 - `delay` adds response latency in milliseconds.
 
 ## Custom Schema Definitions
 
-You can define custom schemas in YAML files under `schemas/`.
+You can define custom schemas in YAML files under `fexapi/schemas/`.
 
 ```yaml
-# schemas/user.yaml
+# fexapi/schemas/user.yaml
 name:
   type: string
   faker: person.fullName
@@ -174,7 +174,7 @@ routes: {
 Notes:
 
 - Supported file extensions: `.yaml`, `.yml`
-- Schema name is taken from filename (for example `schemas/user.yaml` -> `schema: "user"`)
+- Schema name is taken from filename (for example `fexapi/schemas/user.yaml` -> `schema: "user"`)
 - `faker` values map to Faker paths like `person.fullName`, `internet.email`
 
 ## Features

package/dist/cli/args.js

@@ -90,7 +90,7 @@ const parseServeOptions = (serveArgs) => {
     if (positionalArgs.length > 0) {
         return { error: `Unexpected argument(s): ${positionalArgs.join(", ")}` };
     }
-    const host = hostValue ?? "127.0.0.1";
+    const host = hostValue ?? "localhost";
     const port = portValue ? Number(portValue) : undefined;
     if (port !== undefined &&
         (!Number.isInteger(port) || port < 1 || port > 65535)) {
@@ -150,7 +150,7 @@ const parseDevOptions = (devArgs) => {
     if (positionalArgs.length > 0) {
         return { error: `Unexpected argument(s): ${positionalArgs.join(", ")}` };
     }
-    const host = hostValue ?? "127.0.0.1";
+    const host = hostValue ?? "localhost";
     const port = portValue ? Number(portValue) : undefined;
     if (port !== undefined &&
         (!Number.isInteger(port) || port < 1 || port > 65535)) {

package/dist/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,YAkDrB,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,YAgErB,CAAC"}

package/dist/cli/help.js

@@ -1,53 +1,54 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.printHelp = void 0;
+const ui_1 = require("./ui");
 const printHelp = () => {
-    console.log("fexapi-cli");
-    console.log("");
-    console.log("Usage:");
-    console.log("  fexapi init [--force]");
-    console.log("  fexapi generate");
-    console.log("  fexapi format");
-    console.log("  fexapi dev [--watch] [--host <host>] [--port <number>] [--log]");
-    console.log("  fexapi serve [--host <host>] [--port <number>] [--log]");
-    console.log("  fexapi run [--host <host>] [--port <number>] [--log]");
-    console.log("  fexapi [--host <host>] [--port <number>] [--log]");
-    console.log("  fexapi --help");
-    console.log("");
-    console.log("Examples:");
-    console.log("  fexapi init");
-    console.log("  fexapi init --force");
-    console.log("  fexapi generate");
-    console.log("  fexapi format");
-    console.log("  fexapi dev --watch");
-    console.log("  fexapi dev --watch --log");
-    console.log("  fexapi serve --log");
-    console.log("  fexapi serve --host 127.0.0.1 --port 5000");
-    console.log("  fexapi --port 4000");
-    console.log("");
-    console.log("Package manager usage:");
-    console.log("  npx fexapi init");
-    console.log("  pnpm dlx fexapi init");
-    console.log("  yarn dlx fexapi init");
-    console.log("");
-    console.log("`fexapi init` creates:");
-    console.log("  fexapi.config.json");
-    console.log("  fexapi.config.js");
-    console.log("  fexapi/schema.fexapi");
-    console.log("  fexapi/schemas/*.yaml (optional, via wizard)");
-    console.log("");
-    console.log("Init wizard asks:");
-    console.log("  What port? (default: 3000)");
-    console.log("  Enable CORS? (Y/n)");
-    console.log("  Generate sample schemas? (Y/n)");
-    console.log("");
-    console.log("Then run:");
-    console.log("  # edit fexapi/schema.fexapi");
-    console.log("  fexapi generate");
-    console.log("  fexapi run");
-    console.log("");
-    console.log("Generate output:");
-    console.log("  fexapi/generated.api.json");
-    console.log("  fexapi/migrations/schema.json");
+    (0, ui_1.printBanner)();
+    (0, ui_1.printSpacer)();
+    console.log(ui_1.ui.bold("Usage"));
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi init [--force]")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi generate")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi format")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi dev [--watch] [--host <host>] [--port <number>] [--log]")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi serve [--host <host>] [--port <number>] [--log]")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi run [--host <host>] [--port <number>] [--log]")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi [--host <host>] [--port <number>] [--log]")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi --help")}`);
+    (0, ui_1.printSpacer)();
+    console.log(ui_1.ui.bold("Examples"));
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi init")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi init --force")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi generate")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi format")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi dev --watch")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi dev --watch --log")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi serve --log")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi serve --host 127.0.0.1 --port 5000")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi --port 4000")}`);
+    (0, ui_1.printSpacer)();
+    console.log(ui_1.ui.bold("Package Manager Usage"));
+    console.log(`  ${(0, ui_1.formatCommand)("npx fexapi init")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("pnpm dlx fexapi init")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("yarn dlx fexapi init")}`);
+    (0, ui_1.printSpacer)();
+    console.log(ui_1.ui.bold("fexapi init creates"));
+    console.log(`  ${ui_1.ui.dim("fexapi.config.json")}`);
+    console.log(`  ${ui_1.ui.dim("fexapi.config.js")}`);
+    console.log(`  ${ui_1.ui.dim("fexapi/schema.fexapi")}`);
+    console.log(`  ${ui_1.ui.dim("fexapi/schemas/*.yaml (optional, via wizard)")}`);
+    (0, ui_1.printSpacer)();
+    console.log(ui_1.ui.bold("Init wizard asks"));
+    console.log(`  ${ui_1.ui.dim("What port? (default: 3000)")}`);
+    console.log(`  ${ui_1.ui.dim("Enable CORS? (Y/n)")}`);
+    console.log(`  ${ui_1.ui.dim("Generate sample schemas? (Y/n)")}`);
+    (0, ui_1.printSpacer)();
+    console.log(ui_1.ui.bold("Then run"));
+    console.log(`  ${ui_1.ui.dim("# edit fexapi/schema.fexapi")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi generate")}`);
+    console.log(`  ${(0, ui_1.formatCommand)("fexapi run")}`);
+    (0, ui_1.printSpacer)();
+    console.log(ui_1.ui.bold("Generate output"));
+    console.log(`  ${ui_1.ui.dim("fexapi/generated.api.json")}`);
+    console.log(`  ${ui_1.ui.dim("fexapi/migrations/schema.json")}`);
 };
 exports.printHelp = printHelp;

package/dist/cli/ui.d.ts

@@ -0,0 +1,34 @@
+export declare const ui: {
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    cyan: (text: string) => string;
+    magenta: (text: string) => string;
+    blue: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    red: (text: string) => string;
+    gray: (text: string) => string;
+};
+type SpinnerController = {
+    update: (text: string) => void;
+    succeed: (text: string) => void;
+    fail: (text: string) => void;
+    stop: () => void;
+};
+export declare const startSpinner: (initialText: string) => SpinnerController;
+export declare const nowMs: () => number;
+export declare const formatDuration: (startMs: number) => string;
+export declare const printSummaryCard: (title: string, rows: Array<{
+    label: string;
+    value: string;
+}>) => void;
+export declare const printBanner: () => void;
+export declare const printSpacer: () => void;
+export declare const logInfo: (message: string) => void;
+export declare const logSuccess: (message: string) => void;
+export declare const logWarn: (message: string) => void;
+export declare const logError: (message: string) => void;
+export declare const logStep: (message: string) => void;
+export declare const formatCommand: (command: string) => string;
+export {};
+//# sourceMappingURL=ui.d.ts.map

package/dist/cli/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,EAAE;iBACA,MAAM,KAAG,MAAM;gBAChB,MAAM,KAAG,MAAM;iBACd,MAAM,KAAG,MAAM;oBACZ,MAAM,KAAG,MAAM;iBAClB,MAAM,KAAG,MAAM;kBACd,MAAM,KAAG,MAAM;mBACd,MAAM,KAAG,MAAM;gBAClB,MAAM,KAAG,MAAM;iBACd,MAAM,KAAG,MAAM;CAC7B,CAAC;AAYF,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,KAAG,iBA0ClD,CAAC;AAEF,eAAO,MAAM,KAAK,QAAO,MAAoB,CAAC;AAE9C,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAQhD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,MAAM,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,IAyBF,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,IAO9B,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,IAE9B,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,IAEzC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,IAEzC,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,KAAG,IAE1C,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,IAEzC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,MAE/C,CAAC"}

package/dist/cli/ui.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCommand = exports.logStep = exports.logError = exports.logWarn = exports.logSuccess = exports.logInfo = exports.printSpacer = exports.printBanner = exports.printSummaryCard = exports.formatDuration = exports.nowMs = exports.startSpinner = exports.ui = void 0;
+const shouldUseColor = () => {
+    return Boolean(process.stdout.isTTY);
+};
+const colorEnabled = shouldUseColor();
+const interactive = Boolean(process.stdout.isTTY);
+const paint = (code, text) => {
+    if (!colorEnabled) {
+        return text;
+    }
+    return `\u001b[${code}m${text}\u001b[0m`;
+};
+exports.ui = {
+    bold: (text) => paint("1", text),
+    dim: (text) => paint("2", text),
+    cyan: (text) => paint("36", text),
+    magenta: (text) => paint("35", text),
+    blue: (text) => paint("94", text),
+    green: (text) => paint("32", text),
+    yellow: (text) => paint("33", text),
+    red: (text) => paint("31", text),
+    gray: (text) => paint("90", text),
+};
+const SPINNER_FRAMES = ["-", "\\", "|", "/"];
+const clearCurrentLine = () => {
+    if (!interactive) {
+        return;
+    }
+    process.stdout.write("\r\u001b[2K");
+};
+const startSpinner = (initialText) => {
+    if (!interactive) {
+        (0, exports.logStep)(initialText);
+        return {
+            update: (text) => (0, exports.logStep)(text),
+            succeed: (text) => (0, exports.logSuccess)(text),
+            fail: (text) => (0, exports.logError)(text),
+            stop: () => undefined,
+        };
+    }
+    let text = initialText;
+    let frameIndex = 0;
+    const render = () => {
+        const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length] ?? "-";
+        frameIndex += 1;
+        process.stdout.write(`\r${exports.ui.cyan(frame)} ${exports.ui.bold(text)}`);
+    };
+    render();
+    const timer = setInterval(render, 80);
+    return {
+        update: (nextText) => {
+            text = nextText;
+        },
+        succeed: (finalText) => {
+            clearInterval(timer);
+            clearCurrentLine();
+            console.log(`${exports.ui.green("ok")} ${finalText}`);
+        },
+        fail: (finalText) => {
+            clearInterval(timer);
+            clearCurrentLine();
+            console.log(`${exports.ui.red("err")} ${finalText}`);
+        },
+        stop: () => {
+            clearInterval(timer);
+            clearCurrentLine();
+        },
+    };
+};
+exports.startSpinner = startSpinner;
+const nowMs = () => Date.now();
+exports.nowMs = nowMs;
+const formatDuration = (startMs) => {
+    const elapsedMs = Date.now() - startMs;
+    if (elapsedMs < 1000) {
+        return `${elapsedMs}ms`;
+    }
+    return `${(elapsedMs / 1000).toFixed(2)}s`;
+};
+exports.formatDuration = formatDuration;
+const printSummaryCard = (title, rows) => {
+    const contentRows = [{ label: "", value: title }, ...rows];
+    const maxLabel = Math.max(...contentRows.map((row) => row.label.length));
+    const maxValue = Math.max(...contentRows.map((row) => row.value.length));
+    const cardWidth = Math.max(40, maxLabel + maxValue + 7);
+    const border = `+${"-".repeat(cardWidth - 2)}+`;
+    console.log(exports.ui.gray(border));
+    const titleText = exports.ui.bold(exports.ui.cyan(title));
+    const titleLine = `| ${titleText}${" ".repeat(Math.max(0, cardWidth - 4 - title.length))} |`;
+    console.log(titleLine);
+    console.log(exports.ui.gray(`|${"-".repeat(cardWidth - 2)}|`));
+    for (const row of rows) {
+        const label = row.label.padEnd(maxLabel, " ");
+        const value = row.value;
+        const spaces = " ".repeat(Math.max(1, cardWidth - 4 - label.length - 3 - value.length));
+        console.log(`| ${exports.ui.dim(label)} : ${exports.ui.bold(value)}${spaces}|`);
+    }
+    console.log(exports.ui.gray(border));
+};
+exports.printSummaryCard = printSummaryCard;
+const printBanner = () => {
+    console.log(exports.ui.bold(exports.ui.cyan("fexapi")) +
+        exports.ui.gray("  ") +
+        exports.ui.magenta("mock") +
+        exports.ui.gray(" api toolkit"));
+};
+exports.printBanner = printBanner;
+const printSpacer = () => {
+    console.log("");
+};
+exports.printSpacer = printSpacer;
+const logInfo = (message) => {
+    console.log(`${exports.ui.blue("info")} ${message}`);
+};
+exports.logInfo = logInfo;
+const logSuccess = (message) => {
+    console.log(`${exports.ui.green("ok  ")} ${message}`);
+};
+exports.logSuccess = logSuccess;
+const logWarn = (message) => {
+    console.log(`${exports.ui.yellow("warn")} ${message}`);
+};
+exports.logWarn = logWarn;
+const logError = (message) => {
+    console.error(`${exports.ui.red("err ")} ${message}`);
+};
+exports.logError = logError;
+const logStep = (message) => {
+    console.log(`${exports.ui.cyan("->")} ${message}`);
+};
+exports.logStep = logStep;
+const formatCommand = (command) => {
+    return exports.ui.bold(command);
+};
+exports.formatCommand = formatCommand;

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,aAAa,GAAI,2CAK3B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,KAAG,MAsHH,CAAC"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,aAAa,GAAI,2CAK3B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,KAAG,MAmHH,CAAC"}

package/dist/commands/dev.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDevCommand = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const ui_1 = require("../cli/ui");
 const paths_1 = require("../project/paths");
 const serve_1 = require("./serve");
 const WATCH_DEBOUNCE_MS = 150;
@@ -27,14 +28,14 @@ const runDevCommand = ({ host, port, watchEnabled, logEnabled, }) => {
     }
     const projectRoot = (0, paths_1.resolveProjectRoot)();
     if (!projectRoot) {
-        console.error("Could not find package.json in this directory or parent directories.");
+        (0, ui_1.logError)("Could not find package.json in this directory or parent directories.");
         return 1;
     }
     let currentServer = (0, serve_1.createProjectServer)({ host, port, logEnabled });
     if (!currentServer) {
         return 1;
     }
-    console.log("Watch mode enabled. Restarting on config/schema changes...");
+    (0, ui_1.logInfo)("Watch mode enabled. Restarting on config/schema changes...");
     let restartTimer;
     let restartQueued = false;
     let restartInProgress = false;
@@ -47,7 +48,7 @@ const runDevCommand = ({ host, port, watchEnabled, logEnabled, }) => {
             return;
         }
         restartInProgress = true;
-        console.log(`\n[watch] change detected (${reason})`);
+        (0, ui_1.logInfo)(`[watch] change detected (${reason})`);
         await new Promise((resolve) => {
             currentServer?.close(() => {
                 resolve();
@@ -69,10 +70,7 @@ const runDevCommand = ({ host, port, watchEnabled, logEnabled, }) => {
         }, WATCH_DEBOUNCE_MS);
     };
     const activeWatchers = [];
-    const watchTargets = [
-        (0, node_path_1.join)(projectRoot, "fexapi"),
-        projectRoot,
-    ];
+    const watchTargets = [(0, node_path_1.join)(projectRoot, "fexapi"), projectRoot];
     for (const watchTarget of watchTargets) {
         if (!(0, node_fs_1.existsSync)(watchTarget)) {
             continue;

package/dist/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,kBAAkB,QAAO,MAyGrC,CAAC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,kBAAkB,QAAO,MA8KrC,CAAC"}

package/dist/commands/generate.js

@@ -4,12 +4,20 @@ exports.generateFromSchema = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const constants_1 = require("../constants");
+const ui_1 = require("../cli/ui");
 const paths_1 = require("../project/paths");
 const schema_1 = require("../schema");
+const createRouteSignature = (value) => {
+    return JSON.stringify({
+        port: value.port,
+        routes: value.routes,
+    });
+};
 const generateFromSchema = () => {
+    const startedAtMs = (0, ui_1.nowMs)();
     const projectRoot = (0, paths_1.resolveProjectRoot)();
     if (!projectRoot) {
-        console.error("Could not find package.json in this directory or parent directories.");
+        (0, ui_1.logError)("Could not find package.json in this directory or parent directories.");
         return 1;
     }
     const schemaPath = (0, node_path_1.join)(projectRoot, "fexapi", "schema.fexapi");
@@ -17,19 +25,41 @@ const generateFromSchema = () => {
     const migrationsDirectoryPath = (0, node_path_1.join)(projectRoot, "fexapi", "migrations");
     const configPath = (0, node_path_1.join)(projectRoot, "fexapi.config.json");
     if (!(0, node_fs_1.existsSync)(schemaPath)) {
-        console.error(`Schema file not found: ${schemaPath}`);
-        console.error("Run `fexapi init` first.");
+        (0, ui_1.logError)(`Schema file not found: ${schemaPath}`);
+        (0, ui_1.logError)("Run `fexapi init` first.");
         return 1;
     }
+    const generationSpinner = (0, ui_1.startSpinner)("Reading schema");
     const schemaText = (0, node_fs_1.readFileSync)(schemaPath, "utf-8");
+    generationSpinner.update("Parsing schema routes");
     const parsed = (0, schema_1.parseFexapiSchema)(schemaText);
     if (parsed.errors.length > 0 || !parsed.schema) {
-        console.error("Failed to generate API from schema.fexapi");
+        generationSpinner.fail("Schema parsing failed");
+        (0, ui_1.logError)("Failed to generate API from schema.fexapi");
         for (const error of parsed.errors) {
-            console.error(`- ${error}`);
+            (0, ui_1.logError)(`- ${error}`);
         }
         return 1;
     }
+    generationSpinner.update("Resolving cache state");
+    const previousGenerated = (0, node_fs_1.existsSync)(generatedPath)
+        ? (() => {
+            try {
+                return JSON.parse((0, node_fs_1.readFileSync)(generatedPath, "utf-8"));
+            }
+            catch {
+                return undefined;
+            }
+        })()
+        : undefined;
+    const nextSignature = createRouteSignature({
+        port: parsed.schema.port,
+        routes: parsed.schema.routes,
+    });
+    const previousSignature = previousGenerated
+        ? createRouteSignature(previousGenerated)
+        : undefined;
+    const schemaChanged = nextSignature !== previousSignature;
     const generated = {
         schemaVersion: 1,
         generatedAt: new Date().toISOString(),
@@ -37,25 +67,26 @@ const generateFromSchema = () => {
         routes: parsed.schema.routes,
     };
     (0, node_fs_1.mkdirSync)(migrationsDirectoryPath, { recursive: true });
-    const existingMigrationFiles = (0, node_fs_1.readdirSync)(migrationsDirectoryPath, {
-        withFileTypes: true,
-    })
-        .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
-        .map((entry) => (0, node_path_1.join)(migrationsDirectoryPath, entry.name));
-    for (const migrationFilePath of existingMigrationFiles) {
-        (0, node_fs_1.unlinkSync)(migrationFilePath);
-    }
-    const migrationId = new Date().toISOString().replace(/[.:]/g, "-");
     const migrationPath = (0, node_path_1.join)(migrationsDirectoryPath, "schema.json");
     const migration = {
-        migrationId,
+        migrationId: new Date().toISOString().replace(/[.:]/g, "-"),
         sourceSchema: "fexapi/schema.fexapi",
         createdAt: generated.generatedAt,
         port: parsed.schema.port,
         routes: parsed.schema.routes,
     };
-    (0, node_fs_1.writeFileSync)(generatedPath, `${JSON.stringify(generated, null, 2)}\n`, "utf-8");
-    (0, node_fs_1.writeFileSync)(migrationPath, `${JSON.stringify(migration, null, 2)}\n`, "utf-8");
+    let generatedStatus = "cached";
+    let migrationStatus = "cached";
+    if (schemaChanged || !(0, node_fs_1.existsSync)(generatedPath)) {
+        generationSpinner.update("Writing generated API spec");
+        (0, node_fs_1.writeFileSync)(generatedPath, `${JSON.stringify(generated, null, 2)}\n`, "utf-8");
+        generatedStatus = "changed";
+    }
+    if (schemaChanged || !(0, node_fs_1.existsSync)(migrationPath)) {
+        generationSpinner.update("Updating migration snapshot");
+        (0, node_fs_1.writeFileSync)(migrationPath, `${JSON.stringify(migration, null, 2)}\n`, "utf-8");
+        migrationStatus = "changed";
+    }
     let existingConfig = {};
     if ((0, node_fs_1.existsSync)(configPath)) {
         try {
@@ -69,13 +100,50 @@ const generateFromSchema = () => {
         ...existingConfig,
         schemaPath: "fexapi/schema.fexapi",
         generatedPath: constants_1.GENERATED_SPEC_RELATIVE_PATH,
-        lastGeneratedAt: new Date().toISOString(),
+        ...(schemaChanged ? { lastGeneratedAt: new Date().toISOString() } : {}),
     };
-    (0, node_fs_1.writeFileSync)(configPath, `${JSON.stringify(updatedConfig, null, 2)}\n`, "utf-8");
-    console.log(`Generated API spec at ${generatedPath}`);
-    console.log(`Migration updated at ${migrationPath}`);
-    console.log(`Routes generated: ${parsed.schema.routes.length}`);
-    console.log(`Configured server port: ${parsed.schema.port}`);
+    generationSpinner.update("Syncing project config");
+    const nextConfigText = `${JSON.stringify(updatedConfig, null, 2)}\n`;
+    const previousConfigText = (0, node_fs_1.existsSync)(configPath)
+        ? (0, node_fs_1.readFileSync)(configPath, "utf-8")
+        : undefined;
+    let configStatus = "cached";
+    if (previousConfigText !== nextConfigText) {
+        (0, node_fs_1.writeFileSync)(configPath, nextConfigText, "utf-8");
+        configStatus = "changed";
+    }
+    generationSpinner.succeed(`Generate complete (${schemaChanged ? "changed" : "cached"})`);
+    (0, ui_1.printSpacer)();
+    (0, ui_1.printSummaryCard)("Generate Summary", [
+        {
+            label: "routes",
+            value: ui_1.ui.cyan(String(parsed.schema.routes.length)),
+        },
+        {
+            label: "port",
+            value: ui_1.ui.cyan(String(parsed.schema.port)),
+        },
+        {
+            label: "schema source",
+            value: "fexapi/schema.fexapi",
+        },
+        {
+            label: "generated.api.json",
+            value: generatedStatus === "changed" ? ui_1.ui.green("changed") : ui_1.ui.gray("cached"),
+        },
+        {
+            label: "migration",
+            value: migrationStatus === "changed" ? ui_1.ui.green("changed") : ui_1.ui.gray("cached"),
+        },
+        {
+            label: "config",
+            value: configStatus === "changed" ? ui_1.ui.green("changed") : ui_1.ui.gray("cached"),
+        },
+        {
+            label: "time",
+            value: ui_1.ui.bold((0, ui_1.formatDuration)(startedAtMs)),
+        },
+    ]);
     return 0;
 };
 exports.generateFromSchema = generateFromSchema;

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA0LA,eAAO,MAAM,iBAAiB,GAAU,YAErC;IACD,KAAK,EAAE,OAAO,CAAC;CAChB,KAAG,OAAO,CAAC,MAAM,CAmJjB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAuMA,eAAO,MAAM,iBAAiB,GAAU,YAErC;IACD,KAAK,EAAE,OAAO,CAAC;CAChB,KAAG,OAAO,CAAC,MAAM,CA0MjB,CAAC"}

package/dist/commands/init.js

@@ -6,9 +6,10 @@ const node_path_1 = require("node:path");
 const promises_1 = require("node:readline/promises");
 const node_process_1 = require("node:process");
 const constants_1 = require("../constants");
+const ui_1 = require("../cli/ui");
 const detect_1 = require("../project/detect");
 const paths_1 = require("../project/paths");
-const DEFAULT_INIT_PORT = 3000;
+const DEFAULT_INIT_PORT = 4000;
 const parseYesNo = (value, defaultValue) => {
     const normalized = value.trim().toLowerCase();
     if (!normalized) {
@@ -140,9 +141,10 @@ const SAMPLE_POST_SCHEMA = [
     "  type: date",
 ].join("\n");
 const initializeProject = async ({ force, }) => {
+    const initStartedAtMs = (0, ui_1.nowMs)();
     const packageJsonPath = (0, paths_1.findClosestPackageJson)(process.cwd());
     if (!packageJsonPath) {
-        console.error("Could not find package.json in this directory or parent directories.");
+        (0, ui_1.logError)("Could not find package.json in this directory or parent directories.");
         return 1;
     }
     const projectRoot = (0, node_path_1.dirname)(packageJsonPath);
@@ -155,6 +157,7 @@ const initializeProject = async ({ force, }) => {
     const userSchemaPath = (0, node_path_1.join)(schemasDirectoryPath, "user.yaml");
     const postSchemaPath = (0, node_path_1.join)(schemasDirectoryPath, "post.yaml");
     const wizardAnswers = await askInitWizardQuestions();
+    const initSpinner = (0, ui_1.startSpinner)("Scaffolding fexapi project files");
     (0, node_fs_1.mkdirSync)(fexapiDirectoryPath, { recursive: true });
     const configExists = (0, node_fs_1.existsSync)(configPath);
     const schemaExists = (0, node_fs_1.existsSync)(schemaPath);
@@ -170,13 +173,16 @@ const initializeProject = async ({ force, }) => {
         createdAt: new Date().toISOString(),
     };
     if (!configExists || force) {
+        initSpinner.update("Writing fexapi.config.json");
         (0, node_fs_1.writeFileSync)(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
     }
     if (!schemaExists || force) {
+        initSpinner.update("Writing fexapi/schema.fexapi");
         (0, node_fs_1.writeFileSync)(schemaPath, `${(0, detect_1.getSchemaTemplate)(detectedProject.primaryFramework, wizardAnswers.port)}\n`, "utf-8");
     }
     const runtimeConfigExists = (0, node_fs_1.existsSync)(runtimeConfigPath);
     if (!runtimeConfigExists || force) {
+        initSpinner.update("Writing fexapi.config.js");
         (0, node_fs_1.writeFileSync)(runtimeConfigPath, `${getRuntimeConfigTemplate({
             port: wizardAnswers.port,
             cors: wizardAnswers.cors,
@@ -189,6 +195,7 @@ const initializeProject = async ({ force, }) => {
         (0, node_fs_1.mkdirSync)(schemasDirectoryPath, { recursive: true });
         const userSchemaExists = (0, node_fs_1.existsSync)(userSchemaPath);
         if (!userSchemaExists || force) {
+            initSpinner.update("Writing sample user schema");
             (0, node_fs_1.writeFileSync)(userSchemaPath, `${SAMPLE_USER_SCHEMA}\n`, "utf-8");
             userSchemaStatus = userSchemaExists ? "overwritten" : "created";
         }
@@ -197,6 +204,7 @@ const initializeProject = async ({ force, }) => {
         }
         const postSchemaExists = (0, node_fs_1.existsSync)(postSchemaPath);
         if (!postSchemaExists || force) {
+            initSpinner.update("Writing sample post schema");
             (0, node_fs_1.writeFileSync)(postSchemaPath, `${SAMPLE_POST_SCHEMA}\n`, "utf-8");
             postSchemaStatus = postSchemaExists ? "overwritten" : "created";
         }
@@ -204,65 +212,105 @@ const initializeProject = async ({ force, }) => {
             postSchemaStatus = "exists";
         }
     }
-    console.log(`Initialized Fexapi in ${projectRoot}`);
-    console.log(`Detected framework: ${detectedProject.primaryFramework}`);
-    console.log(`Detected frameworks: ${detectedProject.frameworks.join(", ")}`);
+    initSpinner.succeed("Project scaffolding complete");
+    (0, ui_1.logSuccess)(`Initialized fexapi in ${projectRoot}`);
+    (0, ui_1.logInfo)(`Detected framework: ${detectedProject.primaryFramework}`);
+    (0, ui_1.logInfo)(`Detected frameworks: ${detectedProject.frameworks.join(", ")}`);
     if (detectedProject.tooling.length > 0) {
-        console.log(`Detected tooling: ${detectedProject.tooling.join(", ")}`);
+        (0, ui_1.logInfo)(`Detected tooling: ${detectedProject.tooling.join(", ")}`);
     }
+    (0, ui_1.printSpacer)();
     if (configExists && !force) {
-        console.log(`Exists ${configPath}`);
+        (0, ui_1.logWarn)(`Exists ${configPath}`);
     }
     else if (configExists && force) {
-        console.log(`Overwritten ${configPath}`);
+        (0, ui_1.logSuccess)(`Overwritten ${configPath}`);
     }
     else {
-        console.log(`Created ${configPath}`);
+        (0, ui_1.logSuccess)(`Created ${configPath}`);
     }
     if (schemaExists && !force) {
-        console.log(`Exists ${schemaPath}`);
+        (0, ui_1.logWarn)(`Exists ${schemaPath}`);
     }
     else if (schemaExists && force) {
-        console.log(`Overwritten ${schemaPath}`);
+        (0, ui_1.logSuccess)(`Overwritten ${schemaPath}`);
     }
     else {
-        console.log(`Created ${schemaPath}`);
+        (0, ui_1.logSuccess)(`Created ${schemaPath}`);
     }
     if (runtimeConfigExists && !force) {
-        console.log(`Exists ${runtimeConfigPath}`);
+        (0, ui_1.logWarn)(`Exists ${runtimeConfigPath}`);
     }
     else if (runtimeConfigExists && force) {
-        console.log(`Overwritten ${runtimeConfigPath}`);
+        (0, ui_1.logSuccess)(`Overwritten ${runtimeConfigPath}`);
     }
     else {
-        console.log(`Created ${runtimeConfigPath}`);
+        (0, ui_1.logSuccess)(`Created ${runtimeConfigPath}`);
     }
     if (wizardAnswers.generateSampleSchemas) {
         if (userSchemaStatus === "exists") {
-            console.log(`Exists ${userSchemaPath}`);
+            (0, ui_1.logWarn)(`Exists ${userSchemaPath}`);
         }
         else if (userSchemaStatus === "overwritten") {
-            console.log(`Overwritten ${userSchemaPath}`);
+            (0, ui_1.logSuccess)(`Overwritten ${userSchemaPath}`);
         }
         else if (userSchemaStatus === "created") {
-            console.log(`Created ${userSchemaPath}`);
+            (0, ui_1.logSuccess)(`Created ${userSchemaPath}`);
         }
         if (postSchemaStatus === "exists") {
-            console.log(`Exists ${postSchemaPath}`);
+            (0, ui_1.logWarn)(`Exists ${postSchemaPath}`);
         }
         else if (postSchemaStatus === "overwritten") {
-            console.log(`Overwritten ${postSchemaPath}`);
+            (0, ui_1.logSuccess)(`Overwritten ${postSchemaPath}`);
         }
         else if (postSchemaStatus === "created") {
-            console.log(`Created ${postSchemaPath}`);
+            (0, ui_1.logSuccess)(`Created ${postSchemaPath}`);
         }
     }
     else {
-        console.log("Sample schemas were skipped.");
+        (0, ui_1.logWarn)("Sample schemas were skipped.");
     }
     if (detectedProject.primaryFramework === "unknown") {
-        console.log("No known framework dependency found. Update fexapi.config.json and schema.fexapi if needed.");
+        (0, ui_1.logWarn)("No known framework dependency found. Update fexapi.config.json and schema.fexapi if needed.");
     }
+    (0, ui_1.printSpacer)();
+    const createdFiles = [
+        !configExists || force,
+        !schemaExists || force,
+        !runtimeConfigExists || force,
+        userSchemaStatus === "created" || userSchemaStatus === "overwritten",
+        postSchemaStatus === "created" || postSchemaStatus === "overwritten",
+    ].filter(Boolean).length;
+    (0, ui_1.printSummaryCard)("Init Summary", [
+        {
+            label: "framework",
+            value: detectedProject.primaryFramework,
+        },
+        {
+            label: "port",
+            value: ui_1.ui.cyan(String(wizardAnswers.port)),
+        },
+        {
+            label: "cors",
+            value: wizardAnswers.cors ? ui_1.ui.green("enabled") : ui_1.ui.gray("disabled"),
+        },
+        {
+            label: "sample schemas",
+            value: wizardAnswers.generateSampleSchemas
+                ? ui_1.ui.green("enabled")
+                : ui_1.ui.gray("disabled"),
+        },
+        {
+            label: "files changed",
+            value: ui_1.ui.bold(String(createdFiles)),
+        },
+        {
+            label: "time",
+            value: ui_1.ui.bold((0, ui_1.formatDuration)(initStartedAtMs)),
+        },
+    ]);
+    (0, ui_1.printSpacer)();
+    (0, ui_1.logInfo)(`Next: ${(0, ui_1.formatCommand)("fexapi generate")} then ${(0, ui_1.formatCommand)("fexapi serve")}`);
     return 0;
 };
 exports.initializeProject = initializeProject;

package/dist/commands/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQxC,eAAO,MAAM,mBAAmB,GAAI,6BAIjC;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KAAG,MAAM,GAAG,SA2DZ,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,6BAI1B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KAAG,MAsBH,CAAC"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASxC,eAAO,MAAM,mBAAmB,GAAI,6BAIjC;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KAAG,MAAM,GAAG,SA2DZ,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,6BAI1B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KAAG,MAsBH,CAAC"}

package/dist/commands/serve.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serveProject = exports.createProjectServer = void 0;
+const ui_1 = require("../cli/ui");
 const constants_1 = require("../constants");
 const generated_spec_1 = require("../config/generated-spec");
 const runtime_config_1 = require("../config/runtime-config");
@@ -10,7 +11,7 @@ const server_1 = require("../server");
 const createProjectServer = ({ host, port, logEnabled = false, }) => {
     const projectRoot = (0, paths_1.resolveProjectRoot)();
     if (!projectRoot) {
-        console.error("Could not find package.json in this directory or parent directories.");
+        (0, ui_1.logError)("Could not find package.json in this directory or parent directories.");
         return undefined;
     }
     const runtimeConfig = projectRoot
@@ -24,18 +25,18 @@ const createProjectServer = ({ host, port, logEnabled = false, }) => {
         : undefined;
     const effectivePort = port ?? runtimeConfig?.port ?? generatedSpec?.port ?? 4000;
     if (runtimeConfig?.routes && Object.keys(runtimeConfig.routes).length > 0) {
-        console.log(`Using routes from fexapi.config.js (${Object.keys(runtimeConfig.routes).length})`);
+        (0, ui_1.logInfo)(`Using routes from fexapi.config.js (${Object.keys(runtimeConfig.routes).length})`);
     }
     if (Object.keys(schemaDefinitions).length > 0) {
-        console.log(`Loaded custom schemas from /schemas (${Object.keys(schemaDefinitions).length})`);
+        (0, ui_1.logInfo)(`Loaded custom schemas from fexapi/schemas (${Object.keys(schemaDefinitions).length})`);
     }
     if (generatedSpec &&
         !(runtimeConfig?.routes && Object.keys(runtimeConfig.routes).length > 0)) {
-        console.log(`Using generated schema routes (${generatedSpec.routes.length}) from ${constants_1.GENERATED_SPEC_RELATIVE_PATH}`);
+        (0, ui_1.logInfo)(`Using generated schema routes (${generatedSpec.routes.length}) from ${constants_1.GENERATED_SPEC_RELATIVE_PATH}`);
     }
     else if (!runtimeConfig?.routes ||
         Object.keys(runtimeConfig.routes).length === 0) {
-        console.log("No generated schema found. Run `fexapi generate` to serve schema-defined endpoints.");
+        (0, ui_1.logWarn)("No generated schema found. Run `fexapi generate` to serve schema-defined endpoints.");
     }
     return (0, server_1.startServer)({
         host,
@@ -55,7 +56,7 @@ const serveProject = ({ host, port, logEnabled, }) => {
     const shutdown = () => {
         server.close((error) => {
             if (error) {
-                console.error("Error while shutting down server", error);
+                (0, ui_1.logError)(`Error while shutting down server: ${String(error)}`);
                 process.exit(1);
             }
             process.exit(0);

package/dist/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const args_1 = require("./cli/args");
 const dev_1 = require("./commands/dev");
 const help_1 = require("./cli/help");
+const ui_1 = require("./cli/ui");
 const format_1 = require("./commands/format");
 const generate_1 = require("./commands/generate");
 const init_1 = require("./commands/init");
@@ -13,61 +14,69 @@ const [firstArg, ...restArgs] = args;
 const main = async () => {
     if (firstArg === "init") {
         if (restArgs.includes("--help") || restArgs.includes("-h")) {
-            console.log("Usage: fexapi init [--force]");
+            (0, ui_1.printBanner)();
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi init [--force]")}`);
             console.log("Runs an interactive setup wizard and creates fexapi config/schema files.");
             console.log("Use --force to overwrite existing files.");
             process.exit(0);
         }
         const initOptions = (0, args_1.parseInitOptions)(restArgs);
         if ("error" in initOptions) {
-            console.error(initOptions.error);
-            console.log("");
-            console.log("Usage: fexapi init [--force]");
+            (0, ui_1.logError)(initOptions.error);
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi init [--force]")}`);
             process.exit(1);
         }
         process.exit(await (0, init_1.initializeProject)({ force: initOptions.force }));
     }
     else if (firstArg === "generate") {
         if (restArgs.includes("--help") || restArgs.includes("-h")) {
-            console.log("Usage: fexapi generate");
+            (0, ui_1.printBanner)();
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi generate")}`);
             console.log("Reads fexapi/schema.fexapi and updates generated API artifacts + migration.");
             process.exit(0);
         }
         const generateOptions = (0, args_1.parseGenerateOptions)(restArgs);
         if (generateOptions.error) {
-            console.error(generateOptions.error);
-            console.log("");
-            console.log("Usage: fexapi generate");
+            (0, ui_1.logError)(generateOptions.error);
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi generate")}`);
             process.exit(1);
         }
         process.exit((0, generate_1.generateFromSchema)());
     }
     else if (firstArg === "format") {
         if (restArgs.includes("--help") || restArgs.includes("-h")) {
-            console.log("Usage: fexapi format");
+            (0, ui_1.printBanner)();
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi format")}`);
             console.log("Reformats fexapi/schema.fexapi to use readable multi-line field formatting.");
             process.exit(0);
         }
         const formatOptions = (0, args_1.parseFormatOptions)(restArgs);
         if (formatOptions.error) {
-            console.error(formatOptions.error);
-            console.log("");
-            console.log("Usage: fexapi format");
+            (0, ui_1.logError)(formatOptions.error);
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi format")}`);
             process.exit(1);
         }
         process.exit((0, format_1.formatSchema)());
     }
     else if (firstArg === "dev") {
         if (restArgs.includes("--help") || restArgs.includes("-h")) {
-            console.log("Usage: fexapi dev [--watch] [--host <host>] [--port <number>] [--log]");
+            (0, ui_1.printBanner)();
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi dev [--watch] [--host <host>] [--port <number>] [--log]")}`);
             console.log("Starts development server and optionally auto-reloads when config/schema files change.");
             process.exit(0);
         }
         const devOptions = (0, args_1.parseDevOptions)(restArgs);
         if ("error" in devOptions) {
-            console.error(devOptions.error);
-            console.log("");
-            console.log("Usage: fexapi dev [--watch] [--host <host>] [--port <number>] [--log]");
+            (0, ui_1.logError)(devOptions.error);
+            (0, ui_1.printSpacer)();
+            (0, ui_1.logInfo)(`Usage: ${(0, ui_1.formatCommand)("fexapi dev [--watch] [--host <host>] [--port <number>] [--log]")}`);
             process.exit(1);
         }
         const exitCode = (0, dev_1.runDevCommand)(devOptions);
@@ -86,8 +95,8 @@ const main = async () => {
         }
         const options = (0, args_1.parseServeOptions)(serveArgs);
         if ("error" in options) {
-            console.error(options.error);
-            console.log("");
+            (0, ui_1.logError)(options.error);
+            (0, ui_1.printSpacer)();
             (0, help_1.printHelp)();
             process.exit(1);
         }
@@ -101,14 +110,14 @@ const main = async () => {
         process.exit(0);
     }
     else {
-        console.error(`Unknown command: ${firstArg}`);
-        console.log("");
+        (0, ui_1.logError)(`Unknown command: ${firstArg}`);
+        (0, ui_1.printSpacer)();
         (0, help_1.printHelp)();
         process.exit(1);
     }
 };
 void main().catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`Unexpected error: ${message}`);
+    (0, ui_1.logError)(`Unexpected error: ${message}`);
     process.exit(1);
 });

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EAExB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAyLF,eAAO,MAAM,WAAW,GAAI,0EAOzB,aAAkB,wFAuIpB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EAExB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAgMF,eAAO,MAAM,WAAW,GAAI,0EAOzB,aAAkB,wFAwJpB,CAAC"}

package/dist/server.js

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.startServer = void 0;
 const faker_1 = require("@faker-js/faker");
 const node_http_1 = require("node:http");
-const DEFAULT_HOST = "127.0.0.1";
+const ui_1 = require("./cli/ui");
+const DEFAULT_HOST = "localhost";
 const DEFAULT_PORT = 4000;
 const sendJson = (response, statusCode, payload, options) => {
     const send = () => {
@@ -132,16 +133,20 @@ const createRecordFromSchemaName = (schemaName, schemaDefinitions) => {
         createdAt: faker_1.faker.date.recent({ days: 7 }).toISOString(),
     };
 };
-const getCountFromUrl = (urlText, fallback = 5) => {
+const getCountOverrideFromUrl = (urlText) => {
     if (!urlText) {
-        return fallback;
+        return undefined;
     }
     const url = new URL(urlText, "http://localhost");
-    const rawCount = Number(url.searchParams.get("count") ?? fallback);
-    if (!Number.isFinite(rawCount)) {
-        return fallback;
+    const rawCount = url.searchParams.get("count");
+    if (rawCount === null) {
+        return undefined;
     }
-    return Math.min(Math.max(Math.floor(rawCount), 1), 50);
+    const parsedCount = Number(rawCount);
+    if (!Number.isFinite(parsedCount)) {
+        return undefined;
+    }
+    return Math.min(Math.max(Math.floor(parsedCount), 1), 50);
 };
 const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtimeConfig, schemaDefinitions = {}, logRequests = false, } = {}) => {
     const corsEnabled = runtimeConfig?.cors ?? false;
@@ -162,7 +167,19 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
                 const method = request.method ?? "UNKNOWN";
                 const durationMs = Date.now() - requestStartedAt;
                 const statusCode = response.statusCode;
-                console.log(`[${method}] ${pathname} → ${statusCode} (${durationMs}ms)`);
+                const statusLabel = statusCode >= 500
+                    ? ui_1.ui.red(String(statusCode))
+                    : statusCode >= 400
+                        ? ui_1.ui.yellow(String(statusCode))
+                        : ui_1.ui.green(String(statusCode));
+                const methodLabel = method === "GET"
+                    ? ui_1.ui.cyan(method)
+                    : method === "POST"
+                        ? ui_1.ui.green(method)
+                        : method === "DELETE"
+                            ? ui_1.ui.red(method)
+                            : ui_1.ui.blue(method);
+                console.log(`${ui_1.ui.gray("req")} ${methodLabel} ${pathname} ${statusLabel} ${ui_1.ui.dim(`(${durationMs}ms)`)}`);
             });
         }
         if (corsEnabled && request.method === "OPTIONS") {
@@ -177,9 +194,10 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
         if (request.method === "GET") {
             const configuredRoute = configuredRoutes[pathname];
             if (configuredRoute) {
+                const count = getCountOverrideFromUrl(request.url) ?? configuredRoute.count;
                 const payloadKey = toCollectionKey(pathname);
                 sendJson(response, 200, {
-                    [payloadKey]: Array.from({ length: configuredRoute.count }, () => createRecordFromSchemaName(configuredRoute.schema, schemaDefinitions)),
+                    [payloadKey]: Array.from({ length: count }, () => createRecordFromSchemaName(configuredRoute.schema, schemaDefinitions)),
                 }, { cors: corsEnabled, delay: responseDelay });
                 return;
             }
@@ -189,7 +207,7 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
             if (matchedRoute) {
                 const method = request.method ?? "GET";
                 if (method === "GET") {
-                    const count = getCountFromUrl(request.url, 5);
+                    const count = getCountOverrideFromUrl(request.url) ?? 5;
                     const payloadKey = toCollectionKey(matchedRoute.path);
                     sendJson(response, 200, {
                         [payloadKey]: Array.from({ length: count }, () => createRecordFromRoute(matchedRoute)),
@@ -210,8 +228,7 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
                             requestBody = JSON.parse(raw);
                         }
                     }
-                    catch {
-                    }
+                    catch { }
                     const generatedRecord = createRecordFromRoute(matchedRoute);
                     const merged = { ...generatedRecord, ...requestBody };
                     const statusCode = method === "POST" ? 201 : 200;
@@ -229,7 +246,7 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
         }, { cors: corsEnabled, delay: responseDelay });
     });
     server.listen(port, host, () => {
-        console.log(`Mock API running at http://${host}:${port}`);
+        console.log(`${ui_1.ui.green("ready")} Mock API running at ${ui_1.ui.bold(`http://${host}:${port}`)}`);
     });
     return server;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fexapi",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "Mock API generation CLI tool for local development and testing",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",