fexapi 0.1.4 → 0.2.0

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAAE,KACjB;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAWtC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,EAAE,KACrB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAQlB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAAE,KACnB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAQlB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EAAE,KAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAkDxE,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EAAE,KAEf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,KAAK,EAAE,MAAM,CAAA;CAwDlB,CAAC"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAAE,KACjB;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAgBtC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,EAAE,KACrB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAalB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAAE,KACnB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAalB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EAAE,KAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CA6ExE,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EAAE,KAEf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,KAAK,EAAE,MAAM,CAAA;CAoFlB,CAAC"}

package/dist/cli/args.js

@@ -1,12 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseDevOptions = exports.parseServeOptions = exports.parseFormatOptions = exports.parseGenerateOptions = exports.parseInitOptions = void 0;
+const findDuplicateFlags = (args, flags) => {
+    return flags.filter((flag) => args.filter((value) => value === flag).length > 1);
+};
 const parseInitOptions = (initArgs) => {
     const validFlags = new Set(["--force"]);
     const invalidFlags = initArgs.filter((value) => value.startsWith("-") && !validFlags.has(value));
     if (invalidFlags.length > 0) {
         return { error: `Unknown option(s): ${invalidFlags.join(", ")}` };
     }
+    const positionalArgs = initArgs.filter((value) => !value.startsWith("-"));
+    if (positionalArgs.length > 0) {
+        return { error: `Unexpected argument(s): ${positionalArgs.join(", ")}` };
+    }
     return { force: initArgs.includes("--force") };
 };
 exports.parseInitOptions = parseInitOptions;
@@ -15,6 +22,10 @@ const parseGenerateOptions = (generateArgs) => {
     if (invalidFlags.length > 0) {
         return { error: `Unknown option(s): ${invalidFlags.join(", ")}` };
     }
+    const positionalArgs = generateArgs.filter((value) => !value.startsWith("-"));
+    if (positionalArgs.length > 0) {
+        return { error: `Unexpected argument(s): ${positionalArgs.join(", ")}` };
+    }
     return {};
 };
 exports.parseGenerateOptions = parseGenerateOptions;
@@ -23,10 +34,22 @@ const parseFormatOptions = (formatArgs) => {
     if (invalidFlags.length > 0) {
         return { error: `Unknown option(s): ${invalidFlags.join(", ")}` };
     }
+    const positionalArgs = formatArgs.filter((value) => !value.startsWith("-"));
+    if (positionalArgs.length > 0) {
+        return { error: `Unexpected argument(s): ${positionalArgs.join(", ")}` };
+    }
     return {};
 };
 exports.parseFormatOptions = parseFormatOptions;
 const parseServeOptions = (serveArgs) => {
+    const duplicateFlags = findDuplicateFlags(serveArgs, [
+        "--host",
+        "--port",
+        "--log",
+    ]);
+    if (duplicateFlags.length > 0) {
+        return { error: `Duplicate option(s): ${duplicateFlags.join(", ")}` };
+    }
     const getFlagValue = (flagName) => {
         const index = serveArgs.indexOf(flagName);
         if (index === -1) {
@@ -53,6 +76,20 @@ const parseServeOptions = (serveArgs) => {
     if (portValue && typeof portValue !== "string") {
         return portValue;
     }
+    const consumedIndexes = new Set();
+    serveArgs.forEach((value, index) => {
+        if (value === "--log") {
+            consumedIndexes.add(index);
+        }
+        if ((value === "--host" || value === "--port") && serveArgs[index + 1]) {
+            consumedIndexes.add(index);
+            consumedIndexes.add(index + 1);
+        }
+    });
+    const positionalArgs = serveArgs.filter((_value, index) => !consumedIndexes.has(index));
+    if (positionalArgs.length > 0) {
+        return { error: `Unexpected argument(s): ${positionalArgs.join(", ")}` };
+    }
     const host = hostValue ?? "127.0.0.1";
     const port = portValue ? Number(portValue) : undefined;
     if (port !== undefined &&
@@ -63,6 +100,15 @@ const parseServeOptions = (serveArgs) => {
 };
 exports.parseServeOptions = parseServeOptions;
 const parseDevOptions = (devArgs) => {
+    const duplicateFlags = findDuplicateFlags(devArgs, [
+        "--host",
+        "--port",
+        "--watch",
+        "--log",
+    ]);
+    if (duplicateFlags.length > 0) {
+        return { error: `Duplicate option(s): ${duplicateFlags.join(", ")}` };
+    }
     const getFlagValue = (flagName) => {
         const index = devArgs.indexOf(flagName);
         if (index === -1) {
@@ -90,6 +136,20 @@ const parseDevOptions = (devArgs) => {
     if (portValue && typeof portValue !== "string") {
         return portValue;
     }
+    const consumedIndexes = new Set();
+    devArgs.forEach((value, index) => {
+        if (value === "--watch" || value === "--log") {
+            consumedIndexes.add(index);
+        }
+        if ((value === "--host" || value === "--port") && devArgs[index + 1]) {
+            consumedIndexes.add(index);
+            consumedIndexes.add(index + 1);
+        }
+    });
+    const positionalArgs = devArgs.filter((_value, index) => !consumedIndexes.has(index));
+    if (positionalArgs.length > 0) {
+        return { error: `Unexpected argument(s): ${positionalArgs.join(", ")}` };
+    }
     const host = hostValue ?? "127.0.0.1";
     const port = portValue ? Number(portValue) : undefined;
     if (port !== undefined &&

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("  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,19 @@
+export declare const ui: {
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    cyan: (text: string) => string;
+    blue: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    red: (text: string) => string;
+    gray: (text: string) => string;
+};
+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;
+//# 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":"AAcA,eAAO,MAAM,EAAE;iBACA,MAAM,KAAG,MAAM;gBAChB,MAAM,KAAG,MAAM;iBACd,MAAM,KAAG,MAAM;iBACf,MAAM,KAAG,MAAM;kBACd,MAAM,KAAG,MAAM;mBACd,MAAM,KAAG,MAAM;gBAClB,MAAM,KAAG,MAAM;iBACd,MAAM,KAAG,MAAM;CAC7B,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,IAE9B,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,55 @@
+"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.ui = void 0;
+const shouldUseColor = () => {
+    return Boolean(process.stdout.isTTY);
+};
+const colorEnabled = shouldUseColor();
+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),
+    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 printBanner = () => {
+    console.log(exports.ui.bold(exports.ui.cyan("fexapi")) + exports.ui.gray("  mock 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,MAuHH,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;
@@ -18,7 +19,7 @@ const isWatchedPath = (projectRoot, changedPath) => {
     if (relativePath.startsWith("fexapi/")) {
         return true;
     }
-    return (relativePath.startsWith("schemas/") &&
+    return (relativePath.startsWith("fexapi/schemas/") &&
         (relativePath.endsWith(".yaml") || relativePath.endsWith(".yml")));
 };
 const runDevCommand = ({ host, port, watchEnabled, logEnabled, }) => {
@@ -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,11 +70,7 @@ const runDevCommand = ({ host, port, watchEnabled, logEnabled, }) => {
         }, WATCH_DEBOUNCE_MS);
     };
     const activeWatchers = [];
-    const watchTargets = [
-        (0, node_path_1.join)(projectRoot, "fexapi"),
-        (0, node_path_1.join)(projectRoot, "schemas"),
-        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":"AAcA,eAAO,MAAM,kBAAkB,QAAO,MA0GrC,CAAC"}

package/dist/commands/generate.js

@@ -4,12 +4,13 @@ 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 generateFromSchema = () => {
     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,16 +18,16 @@ 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.logInfo)("Run `fexapi init` first.");
         return 1;
     }
     const schemaText = (0, node_fs_1.readFileSync)(schemaPath, "utf-8");
     const parsed = (0, schema_1.parseFexapiSchema)(schemaText);
     if (parsed.errors.length > 0 || !parsed.schema) {
-        console.error("Failed to generate API from schema.fexapi");
+        (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;
     }
@@ -72,10 +73,11 @@ const generateFromSchema = () => {
         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}`);
+    (0, ui_1.logSuccess)(`Generated API spec at ${generatedPath}`);
+    (0, ui_1.logSuccess)(`Migration updated at ${migrationPath}`);
+    (0, ui_1.printSpacer)();
+    (0, ui_1.logInfo)(`Routes generated: ${parsed.schema.routes.length}`);
+    (0, ui_1.logInfo)(`Configured server port: ${parsed.schema.port}`);
     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":"AAwKA,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":"AAkMA,eAAO,MAAM,iBAAiB,GAAU,YAErC;IACD,KAAK,EAAE,OAAO,CAAC;CAChB,KAAG,OAAO,CAAC,MAAM,CA0JjB,CAAC"}

package/dist/commands/init.js

@@ -6,6 +6,7 @@ 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;
@@ -82,8 +83,8 @@ const getRuntimeConfigTemplate = ({ port, cors, includeSampleRoutes, }) => {
     const routeSection = includeSampleRoutes
         ? [
             "  routes: {",
-            '    "/users": { count: 25, schema: "user" },',
-            '    "/posts": { count: 40, schema: "post" },',
+            '    "/users": { count: 10, schema: "user" },',
+            '    "/posts": { count: 20, schema: "post" },',
             "  },",
         ]
         : [];
@@ -102,12 +103,22 @@ const SAMPLE_USER_SCHEMA = [
     "fullName:",
     "  type: name",
     "  faker: person.fullName",
+    "username:",
+    "  type: string",
+    "  faker: internet.username",
     "email:",
     "  type: email",
     "  faker: internet.email",
     "avatarUrl:",
     "  type: url",
     "  faker: image.avatar",
+    "bio:",
+    "  type: string",
+    "  faker: lorem.sentence",
+    "isActive:",
+    "  type: boolean",
+    "joinedAt:",
+    "  type: date",
 ].join("\n");
 const SAMPLE_POST_SCHEMA = [
     "id:",
@@ -117,14 +128,22 @@ const SAMPLE_POST_SCHEMA = [
     "  faker: lorem.sentence",
     "body:",
     "  type: string",
-    "  faker: lorem.paragraph",
+    "  faker: lorem.paragraphs",
+    "authorId:",
+    "  type: uuid",
+    "published:",
+    "  type: boolean",
+    "likes:",
+    "  type: number",
+    "  min: 0",
+    "  max: 500",
     "createdAt:",
     "  type: date",
 ].join("\n");
 const initializeProject = async ({ force, }) => {
     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);
@@ -133,7 +152,7 @@ const initializeProject = async ({ force, }) => {
     const schemaPath = (0, node_path_1.join)(fexapiDirectoryPath, "schema.fexapi");
     const configPath = (0, node_path_1.join)(projectRoot, "fexapi.config.json");
     const runtimeConfigPath = (0, node_path_1.join)(projectRoot, "fexapi.config.js");
-    const schemasDirectoryPath = (0, node_path_1.join)(projectRoot, "schemas");
+    const schemasDirectoryPath = (0, node_path_1.join)(projectRoot, "fexapi", "schemas");
     const userSchemaPath = (0, node_path_1.join)(schemasDirectoryPath, "user.yaml");
     const postSchemaPath = (0, node_path_1.join)(schemasDirectoryPath, "post.yaml");
     const wizardAnswers = await askInitWizardQuestions();
@@ -186,65 +205,68 @@ 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(", ")}`);
+    (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)();
+    (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/config/schema-definitions.js

@@ -20,23 +20,23 @@ const isRecord = (value) => {
 };
 const parseSchemaDefinition = (schemaName, rawValue) => {
     if (!isRecord(rawValue)) {
-        console.error(`Invalid schemas/${schemaName}.yaml: expected root object of field definitions.`);
+        console.error(`Invalid fexapi/schemas/${schemaName}.yaml: expected root object of field definitions.`);
         return undefined;
     }
     const result = {};
     for (const [fieldName, rawFieldConfig] of Object.entries(rawValue)) {
         if (!isRecord(rawFieldConfig)) {
-            console.error(`Invalid schemas/${schemaName}.yaml field \`${fieldName}\`: expected object with type/faker/min/max.`);
+            console.error(`Invalid fexapi/schemas/${schemaName}.yaml field \`${fieldName}\`: expected object with type/faker/min/max.`);
             continue;
         }
         const rawType = rawFieldConfig.type;
         if (typeof rawType !== "string") {
-            console.error(`Invalid schemas/${schemaName}.yaml field \`${fieldName}\`: missing string \`type\`.`);
+            console.error(`Invalid fexapi/schemas/${schemaName}.yaml field \`${fieldName}\`: missing string \`type\`.`);
             continue;
         }
         const normalizedType = rawType.trim().toLowerCase();
         if (!VALID_TYPES.has(normalizedType)) {
-            console.error(`Invalid schemas/${schemaName}.yaml field \`${fieldName}\`: unknown type \`${rawType}\`.`);
+            console.error(`Invalid fexapi/schemas/${schemaName}.yaml field \`${fieldName}\`: unknown type \`${rawType}\`.`);
             continue;
         }
         const minValue = rawFieldConfig.min;
@@ -57,7 +57,7 @@ const parseSchemaDefinition = (schemaName, rawValue) => {
     return Object.keys(result).length > 0 ? result : undefined;
 };
 const loadSchemaDefinitions = (projectRoot) => {
-    const schemasDirectoryPath = (0, node_path_1.join)(projectRoot, "schemas");
+    const schemasDirectoryPath = (0, node_path_1.join)(projectRoot, "fexapi", "schemas");
     if (!(0, node_fs_1.existsSync)(schemasDirectoryPath)) {
         return {};
     }

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/project/detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/project/detect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAyD5E,eAAO,MAAM,aAAa,GACxB,iBAAiB,MAAM,EACvB,aAAa,MAAM,KAClB,eAwDF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,WAAW,kBAAkB,EAC7B,aAAW,KACV,MA+BF,CAAC"}
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/project/detect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAyD5E,eAAO,MAAM,aAAa,GACxB,iBAAiB,MAAM,EACvB,aAAa,MAAM,KAClB,eAwDF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,WAAW,kBAAkB,EAC7B,aAAW,KACV,MAmGF,CAAC"}

package/dist/project/detect.js

@@ -94,33 +94,101 @@ const detectProject = (packageJsonPath, projectRoot) => {
 };
 exports.detectProject = detectProject;
 const getSchemaTemplate = (framework, port = 4000) => {
-    const frameworkHint = framework === "nextjs"
-        ? "# Framework: Next.js"
+    const frameworkLabel = framework === "nextjs"
+        ? "Next.js"
         : framework === "reactjs"
-            ? "# Framework: React"
-            : "# Framework: unknown";
+            ? "React"
+            : framework === "vue"
+                ? "Vue"
+                : framework === "nuxt"
+                    ? "Nuxt"
+                    : framework === "svelte"
+                        ? "Svelte"
+                        : framework === "sveltekit"
+                            ? "SvelteKit"
+                            : framework === "angular"
+                                ? "Angular"
+                                : framework === "solid"
+                                    ? "Solid"
+                                    : framework === "remix"
+                                        ? "Remix"
+                                        : framework === "astro"
+                                            ? "Astro"
+                                            : "unknown";
     return [
-        frameworkHint,
+        `# Framework: ${frameworkLabel}`,
+        "",
+        "# ──────────────────────────────────────────────",
         "# Server",
+        "# ──────────────────────────────────────────────",
         `port: ${port}`,
         "",
+        "# ──────────────────────────────────────────────",
+        "# Available types",
+        "#   string   → random words",
+        "#   number   → random integer",
+        "#   boolean  → true / false",
+        "#   uuid     → unique id",
+        "#   email    → fake email",
+        "#   name     → full name",
+        "#   url      → fake URL",
+        "#   phone    → phone number",
+        "#   date     → ISO date string",
+        "# ──────────────────────────────────────────────",
+        "",
+        "# ──────────────────────────────────────────────",
         "# Routes",
-        "# Format (single-line): METHOD /endpoint: field:type,field:type",
-        "# Format (multi-line):",
-        "# METHOD /endpoint:",
-        "#   field:type",
-        "#   field:type",
+        "#",
+        "# Single-line:  GET /items: id:uuid, name:string",
+        "# Multi-line:",
+        "#   GET /items:",
+        "#     id:uuid",
+        "#     name:string",
+        "# ──────────────────────────────────────────────",
+        "",
+        "# ── Users ────────────────────────────────────",
+        "",
         "GET /users:",
         "  id:uuid",
         "  fullName:name",
         "  username:string",
         "  email:email",
+        "  phone:phone",
         "  avatarUrl:url",
+        "  joinedAt:date",
+        "",
+        "POST /users:",
+        "  id:uuid",
+        "  fullName:name",
+        "  username:string",
+        "  email:email",
+        "",
+        "# ── Posts ────────────────────────────────────",
+        "",
         "GET /posts:",
         "  id:uuid",
         "  title:string",
         "  body:string",
+        "  authorId:uuid",
+        "  published:boolean",
         "  createdAt:date",
+        "",
+        "POST /posts:",
+        "  id:uuid",
+        "  title:string",
+        "  body:string",
+        "  authorId:uuid",
+        "",
+        "PUT /posts:",
+        "  id:uuid",
+        "  title:string",
+        "  body:string",
+        "",
+        "DELETE /posts: id:uuid",
+        "",
+        "# ── Comments (single-line example) ───────────",
+        "",
+        "GET /comments: id:uuid, body:string, postId:uuid, authorId:uuid, createdAt:date",
     ].join("\n");
 };
 exports.getSchemaTemplate = getSchemaTemplate;

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAqHF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,KACjB;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAmG3C,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAqKF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,KACjB;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAmH3C,CAAC"}

package/dist/schema.js

@@ -12,10 +12,27 @@ const VALID_TYPES = [
     "name",
     "phone",
 ];
+const VALID_METHODS = new Set([
+    "GET",
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE",
+    "HEAD",
+    "OPTIONS",
+]);
 const DEFAULT_PORT = 4000;
 const ROUTE_FORMAT_ERROR_MESSAGE = "Invalid route definition. Expected format: " +
     "METHOD /endpoint: field:type,field:type (or multiline fields under METHOD /endpoint:)";
+const FIELD_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 const isPortLine = (line) => /^port\s*:/i.test(line.trim());
+const stripInlineComment = (line) => {
+    const commentIndex = line.indexOf("#");
+    if (commentIndex === -1) {
+        return line.trim();
+    }
+    return line.slice(0, commentIndex).trim();
+};
 const parseRouteHeader = (line) => {
     const separatorIndex = line.indexOf(":");
     if (separatorIndex === -1) {
@@ -36,12 +53,23 @@ const parseRouteHeader = (line) => {
     };
 };
 const parseField = (rawField) => {
-    const [rawName, rawType] = rawField.split(":");
+    const parts = rawField.split(":");
+    if (parts.length !== 2) {
+        return {
+            error: `Invalid field "${rawField}". Expected format name:type.`,
+        };
+    }
+    const [rawName, rawType] = parts;
     const name = rawName?.trim();
     const type = rawType?.trim().toLowerCase();
     if (!name) {
         return { error: `Invalid field "${rawField}". Missing field name.` };
     }
+    if (!FIELD_NAME_PATTERN.test(name)) {
+        return {
+            error: `Invalid field name "${name}". Use letters, numbers, and underscore only (must not start with a number).`,
+        };
+    }
     if (!type) {
         return { error: `Invalid field "${rawField}". Missing field type.` };
     }
@@ -59,10 +87,16 @@ const parseRoute = ({ method, path, rawFields, }) => {
     if (!method || !path) {
         return { error: ROUTE_FORMAT_ERROR_MESSAGE };
     }
+    if (!VALID_METHODS.has(method)) {
+        return {
+            error: `Unsupported HTTP method "${method}" for route ${method} ${path}. Valid methods: ${Array.from(VALID_METHODS).join(", ")}`,
+        };
+    }
     const fields = [];
+    const seenFieldNames = new Set();
     for (const rawFieldLine of rawFields) {
         for (const part of rawFieldLine.split(",")) {
-            const trimmedPart = part.trim();
+            const trimmedPart = stripInlineComment(part);
             if (!trimmedPart) {
                 continue;
             }
@@ -70,6 +104,12 @@ const parseRoute = ({ method, path, rawFields, }) => {
             if ("error" in parsedField) {
                 return { error: parsedField.error };
             }
+            if (seenFieldNames.has(parsedField.name)) {
+                return {
+                    error: `Duplicate field "${parsedField.name}" in route ${method} ${path}.`,
+                };
+            }
+            seenFieldNames.add(parsedField.name);
             fields.push(parsedField);
         }
     }
@@ -83,9 +123,10 @@ const parseFexapiSchema = (schemaText) => {
     const routes = [];
     const errors = [];
     const lines = schemaText.split(/\r?\n/);
+    const seenRoutes = new Set();
     for (let index = 0; index < lines.length; index += 1) {
         const rawLine = lines[index] ?? "";
-        const trimmedLine = rawLine.trim();
+        const trimmedLine = stripInlineComment(rawLine);
         if (!trimmedLine || trimmedLine.startsWith("#")) {
             continue;
         }
@@ -104,12 +145,18 @@ const parseFexapiSchema = (schemaText) => {
         }
         const header = parseRouteHeader(trimmedLine);
         if (!header) {
-            errors.push(ROUTE_FORMAT_ERROR_MESSAGE);
+            errors.push(`${ROUTE_FORMAT_ERROR_MESSAGE} (line ${index + 1})`);
+            continue;
+        }
+        const routeKey = `${header.method} ${header.path}`;
+        if (seenRoutes.has(routeKey)) {
+            errors.push(`Duplicate route definition: ${routeKey} (line ${index + 1})`);
             continue;
         }
         const rawFields = [];
-        if (header.inlineFields.trim()) {
-            rawFields.push(header.inlineFields);
+        const inlineFields = stripInlineComment(header.inlineFields);
+        if (inlineFields) {
+            rawFields.push(inlineFields);
         }
         let lookaheadIndex = index + 1;
         while (lookaheadIndex < lines.length) {
@@ -124,7 +171,10 @@ const parseFexapiSchema = (schemaText) => {
                 break;
             }
             if (/^\s+/.test(lookaheadRawLine)) {
-                rawFields.push(lookaheadTrimmedLine.replace(/^-+\s*/, ""));
+                const normalizedFieldLine = stripInlineComment(lookaheadTrimmedLine.replace(/^-+\s*/, ""));
+                if (normalizedFieldLine) {
+                    rawFields.push(normalizedFieldLine);
+                }
                 lookaheadIndex += 1;
                 continue;
             }
@@ -136,9 +186,10 @@ const parseFexapiSchema = (schemaText) => {
             rawFields,
         });
         if ("error" in parsedRoute) {
-            errors.push(parsedRoute.error);
+            errors.push(`${parsedRoute.error} (line ${index + 1})`);
             continue;
         }
+        seenRoutes.add(routeKey);
         routes.push(parsedRoute);
         index = lookaheadIndex - 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,wFAmGpB,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,6 +3,7 @@ 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 ui_1 = require("./cli/ui");
 const DEFAULT_HOST = "127.0.0.1";
 const DEFAULT_PORT = 4000;
 const sendJson = (response, statusCode, payload, options) => {
@@ -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;
+    }
+    const parsedCount = Number(rawCount);
+    if (!Number.isFinite(parsedCount)) {
+        return undefined;
     }
-    return Math.min(Math.max(Math.floor(rawCount), 1), 50);
+    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;
             }
@@ -187,11 +205,38 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
         if (apiSpec) {
             const matchedRoute = apiSpec.routes.find((route) => route.method === request.method && route.path === pathname);
             if (matchedRoute) {
-                const count = getCountFromUrl(request.url, 5);
-                const payloadKey = toCollectionKey(matchedRoute.path);
-                sendJson(response, 200, {
-                    [payloadKey]: Array.from({ length: count }, () => createRecordFromRoute(matchedRoute)),
-                }, { cors: corsEnabled, delay: responseDelay });
+                const method = request.method ?? "GET";
+                if (method === "GET") {
+                    const count = getCountOverrideFromUrl(request.url) ?? 5;
+                    const payloadKey = toCollectionKey(matchedRoute.path);
+                    sendJson(response, 200, {
+                        [payloadKey]: Array.from({ length: count }, () => createRecordFromRoute(matchedRoute)),
+                    }, { cors: corsEnabled, delay: responseDelay });
+                    return;
+                }
+                if (method === "DELETE") {
+                    sendJson(response, 200, { message: `Deleted resource at ${matchedRoute.path}` }, { cors: corsEnabled, delay: responseDelay });
+                    return;
+                }
+                const bodyChunks = [];
+                request.on("data", (chunk) => bodyChunks.push(chunk));
+                request.on("end", () => {
+                    let requestBody = {};
+                    try {
+                        const raw = Buffer.concat(bodyChunks).toString("utf-8");
+                        if (raw.trim()) {
+                            requestBody = JSON.parse(raw);
+                        }
+                    }
+                    catch { }
+                    const generatedRecord = createRecordFromRoute(matchedRoute);
+                    const merged = { ...generatedRecord, ...requestBody };
+                    const statusCode = method === "POST" ? 201 : 200;
+                    sendJson(response, statusCode, merged, {
+                        cors: corsEnabled,
+                        delay: responseDelay,
+                    });
+                });
                 return;
             }
         }
@@ -201,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.4",
+  "version": "0.2.0",
   "description": "Mock API generation CLI tool for local development and testing",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",