fexapi 0.1.5 → 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/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,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,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":"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":"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":"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;
@@ -142,7 +143,7 @@ const SAMPLE_POST_SCHEMA = [
 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);
@@ -204,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/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,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;
     }
-    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.0",
   "description": "Mock API generation CLI tool for local development and testing",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",