fexapi 0.1.1 → 0.1.3

package/README.md

@@ -22,25 +22,47 @@ fexapi [options]
 pnpm dlx fexapi init
 ```
 
+`fexapi init` runs an interactive setup wizard and asks:
+
+- What port? (default: 3000)
+- Enable CORS? (Y/n)
+- Generate sample schemas? (Y/n)
+
 Creates:
 
 - `fexapi/schema.fexapi`
 - `fexapi.config.json`
+- `fexapi.config.js`
+- `schemas/user.yaml` and `schemas/post.yaml` (if sample schemas are enabled)
 
 ### 2) Edit schema file
 
-`fexapi/schema.fexapi` uses a simple DSL with only `:` and `,` (no semicolons):
+`fexapi/schema.fexapi` supports readable multi-line route fields (single-line still works):
 
 ```txt
 # Server
 port: 4100
 
 # Routes
-GET /users: id:uuid,name:name,email:email,age:number,phone:phone,pic:url,courseName:string
-GET /courses: id:uuid,courseName:string,mentor:name
+GET /users:
+  id:uuid
+  name:name
+  email:email
+  age:number
+  phone:phone
+  pic:url
+  courseName:string
+
+GET /courses:
+  id:uuid
+  courseName:string
+  mentor:name
+
+# one-line format is also valid:
+# GET /users: id:uuid,name:name,email:email
 ```
 
-### 3) Generate artifacts (like migrations)
+### 3) Generate artifacts (updates migration)
 
 ```bash
 npx fexapi generate
@@ -49,7 +71,7 @@ npx fexapi generate
 Generates:
 
 - `fexapi/generated.api.json`
-- `fexapi/migrations/*.json`
+- `fexapi/migrations/schema.json`
 
 ### 4) Start server
 
@@ -57,12 +79,31 @@ Generates:
 npx fexapi run
 # or
 npx fexapi serve
+# request/response logging
+npx fexapi serve --log
+# or dev watch mode (nodemon-like)
+npx fexapi dev --watch
+# watch mode + request logs
+npx fexapi dev --watch --log
 # or (inside local workspace package)
 npm run serve
 ```
 
 Server port is read from `schema.fexapi` unless overridden by CLI `--port`.
 
+`fexapi dev --watch` auto-reloads when these files change:
+
+- `fexapi/schema.fexapi`
+- `fexapi/generated.api.json`
+- `fexapi.config.js`
+- `fexapi.config.json`
+- `schemas/*.yaml`
+
+`fexapi serve --log` prints request logs like:
+
+- `[GET] /users/1 → 200 (45ms)`
+- `[POST] /posts → 201 (12ms)`
+
 ## Configuration File Support
 
 Create a `fexapi.config.js` in your project root:

package/dist/cli/args.d.ts

@@ -9,6 +9,15 @@ export declare const parseGenerateOptions: (generateArgs: string[]) => {
 export declare const parseServeOptions: (serveArgs: string[]) => {
     host: string;
     port?: number;
+    logEnabled: boolean;
+} | {
+    error: string;
+};
+export declare const parseDevOptions: (devArgs: string[]) => {
+    host: string;
+    port?: number;
+    watchEnabled: boolean;
+    logEnabled: boolean;
 } | {
     error: string;
 };

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,iBAAiB,GAC5B,WAAW,MAAM,EAAE,KAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CA+CnD,CAAC"}
+{"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,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"}

package/dist/cli/args.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseServeOptions = exports.parseGenerateOptions = exports.parseInitOptions = void 0;
+exports.parseDevOptions = exports.parseServeOptions = exports.parseGenerateOptions = exports.parseInitOptions = void 0;
 const parseInitOptions = (initArgs) => {
     const validFlags = new Set(["--force"]);
     const invalidFlags = initArgs.filter((value) => value.startsWith("-") && !validFlags.has(value));
@@ -30,7 +30,10 @@ const parseServeOptions = (serveArgs) => {
         }
         return value;
     };
-    const unknownFlags = serveArgs.filter((value) => value.startsWith("-") && value !== "--host" && value !== "--port");
+    const unknownFlags = serveArgs.filter((value) => value.startsWith("-") &&
+        value !== "--host" &&
+        value !== "--port" &&
+        value !== "--log");
     if (unknownFlags.length > 0) {
         return { error: `Unknown option(s): ${unknownFlags.join(", ")}` };
     }
@@ -48,6 +51,48 @@ const parseServeOptions = (serveArgs) => {
         (!Number.isInteger(port) || port < 1 || port > 65535)) {
         return { error: `Invalid port: ${portValue ?? ""}`.trim() };
     }
-    return { host, port };
+    return { host, port, logEnabled: serveArgs.includes("--log") };
 };
 exports.parseServeOptions = parseServeOptions;
+const parseDevOptions = (devArgs) => {
+    const getFlagValue = (flagName) => {
+        const index = devArgs.indexOf(flagName);
+        if (index === -1) {
+            return undefined;
+        }
+        const value = devArgs[index + 1];
+        if (!value || value.startsWith("-")) {
+            return { error: `Missing value for ${flagName}` };
+        }
+        return value;
+    };
+    const unknownFlags = devArgs.filter((value) => value.startsWith("-") &&
+        value !== "--host" &&
+        value !== "--port" &&
+        value !== "--watch" &&
+        value !== "--log");
+    if (unknownFlags.length > 0) {
+        return { error: `Unknown option(s): ${unknownFlags.join(", ")}` };
+    }
+    const hostValue = getFlagValue("--host");
+    if (hostValue && typeof hostValue !== "string") {
+        return hostValue;
+    }
+    const portValue = getFlagValue("--port");
+    if (portValue && typeof portValue !== "string") {
+        return portValue;
+    }
+    const host = hostValue ?? "127.0.0.1";
+    const port = portValue ? Number(portValue) : undefined;
+    if (port !== undefined &&
+        (!Number.isInteger(port) || port < 1 || port > 65535)) {
+        return { error: `Invalid port: ${portValue ?? ""}`.trim() };
+    }
+    return {
+        host,
+        port,
+        watchEnabled: devArgs.includes("--watch"),
+        logEnabled: devArgs.includes("--log"),
+    };
+};
+exports.parseDevOptions = parseDevOptions;

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,YAmCrB,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,YAgDrB,CAAC"}

package/dist/cli/help.js

@@ -7,15 +7,19 @@ const printHelp = () => {
     console.log("Usage:");
     console.log("  fexapi init [--force]");
     console.log("  fexapi generate");
-    console.log("  fexapi serve [--host <host>] [--port <number>]");
-    console.log("  fexapi run [--host <host>] [--port <number>]");
-    console.log("  fexapi [--host <host>] [--port <number>]");
+    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 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("");
@@ -26,7 +30,14 @@ const printHelp = () => {
     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");
@@ -35,6 +46,6 @@ const printHelp = () => {
     console.log("");
     console.log("Generate output:");
     console.log("  fexapi/generated.api.json");
-    console.log("  fexapi/migrations/*.json");
+    console.log("  fexapi/migrations/schema.json");
 };
 exports.printHelp = printHelp;

package/dist/commands/dev.d.ts

@@ -0,0 +1,7 @@
+export declare const runDevCommand: ({ host, port, watchEnabled, logEnabled, }: {
+    host: string;
+    port?: number;
+    watchEnabled: boolean;
+    logEnabled: boolean;
+}) => number;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/dev.js

@@ -0,0 +1,114 @@
+"use strict";
+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 paths_1 = require("../project/paths");
+const serve_1 = require("./serve");
+const WATCH_DEBOUNCE_MS = 150;
+const normalizePath = (pathValue) => {
+    return pathValue.replace(/\\/g, "/").toLowerCase();
+};
+const isWatchedPath = (projectRoot, changedPath) => {
+    const relativePath = normalizePath((0, node_path_1.relative)(projectRoot, changedPath));
+    if (relativePath === "fexapi.config.js" ||
+        relativePath === "fexapi.config.json") {
+        return true;
+    }
+    if (relativePath.startsWith("fexapi/")) {
+        return true;
+    }
+    return (relativePath.startsWith("schemas/") &&
+        (relativePath.endsWith(".yaml") || relativePath.endsWith(".yml")));
+};
+const runDevCommand = ({ host, port, watchEnabled, logEnabled, }) => {
+    if (!watchEnabled) {
+        return (0, serve_1.serveProject)({ host, port, logEnabled });
+    }
+    const projectRoot = (0, paths_1.resolveProjectRoot)();
+    if (!projectRoot) {
+        console.error("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...");
+    let restartTimer;
+    let restartQueued = false;
+    let restartInProgress = false;
+    const restartServer = async (reason) => {
+        if (!currentServer) {
+            return;
+        }
+        if (restartInProgress) {
+            restartQueued = true;
+            return;
+        }
+        restartInProgress = true;
+        console.log(`\n[watch] change detected (${reason})`);
+        await new Promise((resolve) => {
+            currentServer?.close(() => {
+                resolve();
+            });
+        });
+        currentServer = (0, serve_1.createProjectServer)({ host, port, logEnabled });
+        restartInProgress = false;
+        if (restartQueued) {
+            restartQueued = false;
+            await restartServer("queued changes");
+        }
+    };
+    const scheduleRestart = (reason) => {
+        if (restartTimer) {
+            clearTimeout(restartTimer);
+        }
+        restartTimer = setTimeout(() => {
+            void restartServer(reason);
+        }, WATCH_DEBOUNCE_MS);
+    };
+    const activeWatchers = [];
+    const watchTargets = [
+        (0, node_path_1.join)(projectRoot, "fexapi"),
+        (0, node_path_1.join)(projectRoot, "schemas"),
+        projectRoot,
+    ];
+    for (const watchTarget of watchTargets) {
+        if (!(0, node_fs_1.existsSync)(watchTarget)) {
+            continue;
+        }
+        const watcher = (0, node_fs_1.watch)(watchTarget, { recursive: true }, (_event, file) => {
+            if (!file) {
+                scheduleRestart("unknown file");
+                return;
+            }
+            const changedPath = (0, node_path_1.join)(watchTarget, file.toString());
+            if (isWatchedPath(projectRoot, changedPath)) {
+                scheduleRestart((0, node_path_1.relative)(projectRoot, changedPath));
+            }
+        });
+        activeWatchers.push(watcher);
+    }
+    const cleanupAndExit = async () => {
+        if (restartTimer) {
+            clearTimeout(restartTimer);
+            restartTimer = undefined;
+        }
+        for (const watcher of activeWatchers) {
+            watcher.close();
+        }
+        await new Promise((resolve) => {
+            currentServer?.close(() => resolve());
+        });
+        process.exit(0);
+    };
+    process.on("SIGINT", () => {
+        void cleanupAndExit();
+    });
+    process.on("SIGTERM", () => {
+        void cleanupAndExit();
+    });
+    return 0;
+};
+exports.runDevCommand = runDevCommand;

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

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

package/dist/commands/generate.js

@@ -37,8 +37,16 @@ const generateFromSchema = () => {
         routes: parsed.schema.routes,
     };
     (0, node_fs_1.mkdirSync)(migrationsDirectoryPath, { recursive: true });
+    const existingMigrationFiles = (0, node_fs_1.readdirSync)(migrationsDirectoryPath, {
+        withFileTypes: true,
+    })
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+        .map((entry) => (0, node_path_1.join)(migrationsDirectoryPath, entry.name));
+    for (const migrationFilePath of existingMigrationFiles) {
+        (0, node_fs_1.unlinkSync)(migrationFilePath);
+    }
     const migrationId = new Date().toISOString().replace(/[.:]/g, "-");
-    const migrationPath = (0, node_path_1.join)(migrationsDirectoryPath, `${migrationId}_schema.json`);
+    const migrationPath = (0, node_path_1.join)(migrationsDirectoryPath, "schema.json");
     const migration = {
         migrationId,
         sourceSchema: "fexapi/schema.fexapi",
@@ -65,7 +73,7 @@ const generateFromSchema = () => {
     };
     (0, node_fs_1.writeFileSync)(configPath, `${JSON.stringify(updatedConfig, null, 2)}\n`, "utf-8");
     console.log(`Generated API spec at ${generatedPath}`);
-    console.log(`Migration created at ${migrationPath}`);
+    console.log(`Migration updated at ${migrationPath}`);
     console.log(`Routes generated: ${parsed.schema.routes.length}`);
     console.log(`Configured server port: ${parsed.schema.port}`);
     return 0;

package/dist/commands/init.d.ts

@@ -1,4 +1,4 @@
-export declare const initializeProject: ({ force }: {
+export declare const initializeProject: ({ force, }: {
     force: boolean;
-}) => number;
+}) => Promise<number>;
 //# sourceMappingURL=init.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB,GAAI,WAAW;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,KAAG,MAwEjE,CAAC"}
+{"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"}

package/dist/commands/init.js

@@ -3,10 +3,125 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.initializeProject = void 0;
 const node_fs_1 = require("node:fs");
 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 detect_1 = require("../project/detect");
 const paths_1 = require("../project/paths");
-const initializeProject = ({ force }) => {
+const DEFAULT_INIT_PORT = 3000;
+const parseYesNo = (value, defaultValue) => {
+    const normalized = value.trim().toLowerCase();
+    if (!normalized) {
+        return defaultValue;
+    }
+    if (normalized === "y" || normalized === "yes") {
+        return true;
+    }
+    if (normalized === "n" || normalized === "no") {
+        return false;
+    }
+    return undefined;
+};
+const askInitWizardQuestions = async () => {
+    if (!node_process_1.stdin.isTTY || !node_process_1.stdout.isTTY) {
+        return {
+            port: DEFAULT_INIT_PORT,
+            cors: true,
+            generateSampleSchemas: true,
+        };
+    }
+    const questionInterface = (0, promises_1.createInterface)({ input: node_process_1.stdin, output: node_process_1.stdout });
+    try {
+        let port = DEFAULT_INIT_PORT;
+        while (true) {
+            const answer = await questionInterface.question(`What port? (default: ${DEFAULT_INIT_PORT}) `);
+            if (!answer.trim()) {
+                break;
+            }
+            const parsedPort = Number(answer.trim());
+            if (Number.isInteger(parsedPort) &&
+                parsedPort >= 1 &&
+                parsedPort <= 65535) {
+                port = parsedPort;
+                break;
+            }
+            console.log("Please enter a valid port (1-65535).\n");
+        }
+        let cors = true;
+        while (true) {
+            const answer = await questionInterface.question("Enable CORS? (Y/n) ");
+            const parsed = parseYesNo(answer, true);
+            if (parsed !== undefined) {
+                cors = parsed;
+                break;
+            }
+            console.log("Please answer with Y/Yes or N/No.\n");
+        }
+        let generateSampleSchemas = true;
+        while (true) {
+            const answer = await questionInterface.question("Generate sample schemas? (Y/n) ");
+            const parsed = parseYesNo(answer, true);
+            if (parsed !== undefined) {
+                generateSampleSchemas = parsed;
+                break;
+            }
+            console.log("Please answer with Y/Yes or N/No.\n");
+        }
+        console.log("");
+        return {
+            port,
+            cors,
+            generateSampleSchemas,
+        };
+    }
+    finally {
+        questionInterface.close();
+    }
+};
+const getRuntimeConfigTemplate = ({ port, cors, includeSampleRoutes, }) => {
+    const routeSection = includeSampleRoutes
+        ? [
+            "  routes: {",
+            '    "/users": { count: 25, schema: "user" },',
+            '    "/posts": { count: 40, schema: "post" },',
+            "  },",
+        ]
+        : [];
+    return [
+        "module.exports = {",
+        `  port: ${port},`,
+        `  cors: ${cors},`,
+        "  delay: 0,",
+        ...routeSection,
+        "};",
+    ].join("\n");
+};
+const SAMPLE_USER_SCHEMA = [
+    "id:",
+    "  type: uuid",
+    "fullName:",
+    "  type: name",
+    "  faker: person.fullName",
+    "email:",
+    "  type: email",
+    "  faker: internet.email",
+    "avatarUrl:",
+    "  type: url",
+    "  faker: image.avatar",
+].join("\n");
+const SAMPLE_POST_SCHEMA = [
+    "id:",
+    "  type: uuid",
+    "title:",
+    "  type: string",
+    "  faker: lorem.sentence",
+    "body:",
+    "  type: string",
+    "  faker: lorem.paragraph",
+    "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.");
@@ -17,6 +132,11 @@ const initializeProject = ({ force }) => {
     const fexapiDirectoryPath = (0, node_path_1.join)(projectRoot, "fexapi");
     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 userSchemaPath = (0, node_path_1.join)(schemasDirectoryPath, "user.yaml");
+    const postSchemaPath = (0, node_path_1.join)(schemasDirectoryPath, "post.yaml");
+    const wizardAnswers = await askInitWizardQuestions();
     (0, node_fs_1.mkdirSync)(fexapiDirectoryPath, { recursive: true });
     const configExists = (0, node_fs_1.existsSync)(configPath);
     const schemaExists = (0, node_fs_1.existsSync)(schemaPath);
@@ -26,13 +146,45 @@ const initializeProject = ({ force }) => {
         tooling: detectedProject.tooling,
         schemaPath: "fexapi/schema.fexapi",
         generatedPath: constants_1.GENERATED_SPEC_RELATIVE_PATH,
+        defaultPort: wizardAnswers.port,
+        corsEnabled: wizardAnswers.cors,
+        sampleSchemasGenerated: wizardAnswers.generateSampleSchemas,
         createdAt: new Date().toISOString(),
     };
     if (!configExists || force) {
         (0, node_fs_1.writeFileSync)(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
     }
     if (!schemaExists || force) {
-        (0, node_fs_1.writeFileSync)(schemaPath, `${(0, detect_1.getSchemaTemplate)(detectedProject.primaryFramework)}\n`, "utf-8");
+        (0, node_fs_1.writeFileSync)(schemaPath, `${(0, detect_1.getSchemaTemplate)(detectedProject.primaryFramework, wizardAnswers.port)}\n`, "utf-8");
+    }
+    const runtimeConfigExists = (0, node_fs_1.existsSync)(runtimeConfigPath);
+    if (!runtimeConfigExists || force) {
+        (0, node_fs_1.writeFileSync)(runtimeConfigPath, `${getRuntimeConfigTemplate({
+            port: wizardAnswers.port,
+            cors: wizardAnswers.cors,
+            includeSampleRoutes: wizardAnswers.generateSampleSchemas,
+        })}\n`, "utf-8");
+    }
+    let userSchemaStatus = "skipped";
+    let postSchemaStatus = "skipped";
+    if (wizardAnswers.generateSampleSchemas) {
+        (0, node_fs_1.mkdirSync)(schemasDirectoryPath, { recursive: true });
+        const userSchemaExists = (0, node_fs_1.existsSync)(userSchemaPath);
+        if (!userSchemaExists || force) {
+            (0, node_fs_1.writeFileSync)(userSchemaPath, `${SAMPLE_USER_SCHEMA}\n`, "utf-8");
+            userSchemaStatus = userSchemaExists ? "overwritten" : "created";
+        }
+        else {
+            userSchemaStatus = "exists";
+        }
+        const postSchemaExists = (0, node_fs_1.existsSync)(postSchemaPath);
+        if (!postSchemaExists || force) {
+            (0, node_fs_1.writeFileSync)(postSchemaPath, `${SAMPLE_POST_SCHEMA}\n`, "utf-8");
+            postSchemaStatus = postSchemaExists ? "overwritten" : "created";
+        }
+        else {
+            postSchemaStatus = "exists";
+        }
     }
     console.log(`Initialized Fexapi in ${projectRoot}`);
     console.log(`Detected framework: ${detectedProject.primaryFramework}`);
@@ -58,6 +210,38 @@ const initializeProject = ({ force }) => {
     else {
         console.log(`Created ${schemaPath}`);
     }
+    if (runtimeConfigExists && !force) {
+        console.log(`Exists ${runtimeConfigPath}`);
+    }
+    else if (runtimeConfigExists && force) {
+        console.log(`Overwritten ${runtimeConfigPath}`);
+    }
+    else {
+        console.log(`Created ${runtimeConfigPath}`);
+    }
+    if (wizardAnswers.generateSampleSchemas) {
+        if (userSchemaStatus === "exists") {
+            console.log(`Exists ${userSchemaPath}`);
+        }
+        else if (userSchemaStatus === "overwritten") {
+            console.log(`Overwritten ${userSchemaPath}`);
+        }
+        else if (userSchemaStatus === "created") {
+            console.log(`Created ${userSchemaPath}`);
+        }
+        if (postSchemaStatus === "exists") {
+            console.log(`Exists ${postSchemaPath}`);
+        }
+        else if (postSchemaStatus === "overwritten") {
+            console.log(`Overwritten ${postSchemaPath}`);
+        }
+        else if (postSchemaStatus === "created") {
+            console.log(`Created ${postSchemaPath}`);
+        }
+    }
+    else {
+        console.log("Sample schemas were skipped.");
+    }
     if (detectedProject.primaryFramework === "unknown") {
         console.log("No known framework dependency found. Update fexapi.config.json and schema.fexapi if needed.");
     }

package/dist/commands/serve.d.ts

@@ -1,5 +1,12 @@
-export declare const serveProject: ({ host, port, }: {
+import type { Server } from "node:http";
+export declare const createProjectServer: ({ host, port, logEnabled, }: {
     host: string;
     port?: number;
+    logEnabled?: boolean;
+}) => Server | undefined;
+export declare const serveProject: ({ host, port, logEnabled, }: {
+    host: string;
+    port?: number;
+    logEnabled?: boolean;
 }) => number;
 //# sourceMappingURL=serve.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY,GAAI,iBAG1B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KAAG,MAkEH,CAAC"}
+{"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"}

package/dist/commands/serve.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.serveProject = void 0;
+exports.serveProject = exports.createProjectServer = void 0;
 const constants_1 = require("../constants");
 const generated_spec_1 = require("../config/generated-spec");
 const runtime_config_1 = require("../config/runtime-config");
 const schema_definitions_1 = require("../config/schema-definitions");
 const paths_1 = require("../project/paths");
 const server_1 = require("../server");
-const serveProject = ({ host, port, }) => {
+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.");
+        return undefined;
+    }
     const runtimeConfig = projectRoot
         ? (0, runtime_config_1.loadFexapiRuntimeConfig)(projectRoot)
         : undefined;
@@ -33,13 +37,21 @@ const serveProject = ({ host, port, }) => {
         Object.keys(runtimeConfig.routes).length === 0) {
         console.log("No generated schema found. Run `fexapi generate` to serve schema-defined endpoints.");
     }
-    const server = (0, server_1.startServer)({
+    return (0, server_1.startServer)({
         host,
         port: effectivePort,
         apiSpec: generatedSpec,
         runtimeConfig,
         schemaDefinitions,
+        logRequests: logEnabled,
     });
+};
+exports.createProjectServer = createProjectServer;
+const serveProject = ({ host, port, logEnabled, }) => {
+    const server = (0, exports.createProjectServer)({ host, port, logEnabled });
+    if (!server) {
+        return 1;
+    }
     const shutdown = () => {
         server.close((error) => {
             if (error) {

package/dist/index.js

@@ -2,71 +2,97 @@
 "use strict";
 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 generate_1 = require("./commands/generate");
 const init_1 = require("./commands/init");
 const serve_1 = require("./commands/serve");
 const args = process.argv.slice(2);
 const [firstArg, ...restArgs] = args;
-if (firstArg === "init") {
-    if (restArgs.includes("--help") || restArgs.includes("-h")) {
-        console.log("Usage: fexapi init [--force]");
-        console.log("Detects frameworks/tooling and creates fexapi.config.json + fexapi/schema.fexapi.");
-        console.log("Use --force to overwrite existing files.");
-        process.exit(0);
+const main = async () => {
+    if (firstArg === "init") {
+        if (restArgs.includes("--help") || restArgs.includes("-h")) {
+            console.log("Usage: 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]");
+            process.exit(1);
+        }
+        process.exit(await (0, init_1.initializeProject)({ force: initOptions.force }));
     }
-    const initOptions = (0, args_1.parseInitOptions)(restArgs);
-    if ("error" in initOptions) {
-        console.error(initOptions.error);
-        console.log("");
-        console.log("Usage: fexapi init [--force]");
-        process.exit(1);
+    else if (firstArg === "generate") {
+        if (restArgs.includes("--help") || restArgs.includes("-h")) {
+            console.log("Usage: 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");
+            process.exit(1);
+        }
+        process.exit((0, generate_1.generateFromSchema)());
     }
-    process.exit((0, init_1.initializeProject)({ force: initOptions.force }));
-}
-else if (firstArg === "generate") {
-    if (restArgs.includes("--help") || restArgs.includes("-h")) {
-        console.log("Usage: fexapi generate");
-        console.log("Reads fexapi/schema.fexapi and creates generated API artifacts + migrations.");
-        process.exit(0);
+    else if (firstArg === "dev") {
+        if (restArgs.includes("--help") || restArgs.includes("-h")) {
+            console.log("Usage: 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]");
+            process.exit(1);
+        }
+        const exitCode = (0, dev_1.runDevCommand)(devOptions);
+        if (exitCode !== 0) {
+            process.exit(exitCode);
+        }
     }
-    const generateOptions = (0, args_1.parseGenerateOptions)(restArgs);
-    if (generateOptions.error) {
-        console.error(generateOptions.error);
-        console.log("");
-        console.log("Usage: fexapi generate");
-        process.exit(1);
+    else if (!firstArg ||
+        firstArg === "serve" ||
+        firstArg === "run" ||
+        firstArg.startsWith("-")) {
+        const serveArgs = firstArg === "serve" || firstArg === "run" ? restArgs : args;
+        if (serveArgs.includes("--help") || serveArgs.includes("-h")) {
+            (0, help_1.printHelp)();
+            process.exit(0);
+        }
+        const options = (0, args_1.parseServeOptions)(serveArgs);
+        if ("error" in options) {
+            console.error(options.error);
+            console.log("");
+            (0, help_1.printHelp)();
+            process.exit(1);
+        }
+        const exitCode = (0, serve_1.serveProject)(options);
+        if (exitCode !== 0) {
+            process.exit(exitCode);
+        }
     }
-    process.exit((0, generate_1.generateFromSchema)());
-}
-else if (!firstArg ||
-    firstArg === "serve" ||
-    firstArg === "run" ||
-    firstArg.startsWith("-")) {
-    const serveArgs = firstArg === "serve" || firstArg === "run" ? restArgs : args;
-    if (serveArgs.includes("--help") || serveArgs.includes("-h")) {
+    else if (firstArg === "help") {
         (0, help_1.printHelp)();
         process.exit(0);
     }
-    const options = (0, args_1.parseServeOptions)(serveArgs);
-    if ("error" in options) {
-        console.error(options.error);
+    else {
+        console.error(`Unknown command: ${firstArg}`);
         console.log("");
         (0, help_1.printHelp)();
         process.exit(1);
     }
-    const exitCode = (0, serve_1.serveProject)(options);
-    if (exitCode !== 0) {
-        process.exit(exitCode);
-    }
-}
-else if (firstArg === "help") {
-    (0, help_1.printHelp)();
-    process.exit(0);
-}
-else {
-    console.error(`Unknown command: ${firstArg}`);
-    console.log("");
-    (0, help_1.printHelp)();
+};
+void main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Unexpected error: ${message}`);
     process.exit(1);
-}
+});

package/dist/project/detect.d.ts

@@ -1,4 +1,4 @@
 import type { DetectedProject, SupportedFramework } from "../types/project";
 export declare const detectProject: (packageJsonPath: string, projectRoot: string) => DetectedProject;
-export declare const getSchemaTemplate: (framework: SupportedFramework) => string;
+export declare const getSchemaTemplate: (framework: SupportedFramework, port?: number) => string;
 //# sourceMappingURL=detect.d.ts.map

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,GAAI,WAAW,kBAAkB,KAAG,MAkBjE,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,MA+BF,CAAC"}

package/dist/project/detect.js

@@ -93,7 +93,7 @@ const detectProject = (packageJsonPath, projectRoot) => {
     };
 };
 exports.detectProject = detectProject;
-const getSchemaTemplate = (framework) => {
+const getSchemaTemplate = (framework, port = 4000) => {
     const frameworkHint = framework === "nextjs"
         ? "# Framework: Next.js"
         : framework === "reactjs"
@@ -102,12 +102,25 @@ const getSchemaTemplate = (framework) => {
     return [
         frameworkHint,
         "# Server",
-        "port: 4000",
+        `port: ${port}`,
         "",
         "# Routes",
-        "# Format: METHOD /endpoint: field:type,field:type",
-        "GET /users: id:uuid,fullName:name,username:string,email:email,avatarUrl:url",
-        "GET /posts: id:uuid,title:string,body:string,createdAt:date",
+        "# Format (single-line): METHOD /endpoint: field:type,field:type",
+        "# Format (multi-line):",
+        "# METHOD /endpoint:",
+        "#   field:type",
+        "#   field:type",
+        "GET /users:",
+        "  id:uuid",
+        "  fullName:name",
+        "  username:string",
+        "  email:email",
+        "  avatarUrl:url",
+        "GET /posts:",
+        "  id:uuid",
+        "  title:string",
+        "  body:string",
+        "  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;AAkGF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,KACjB;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAoD3C,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;AAqHF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,KACjB;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAmG3C,CAAC"}

package/dist/schema.js

@@ -13,6 +13,28 @@ const VALID_TYPES = [
     "phone",
 ];
 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 isPortLine = (line) => /^port\s*:/i.test(line.trim());
+const parseRouteHeader = (line) => {
+    const separatorIndex = line.indexOf(":");
+    if (separatorIndex === -1) {
+        return undefined;
+    }
+    const rawLeft = line.slice(0, separatorIndex);
+    const rawFields = line.slice(separatorIndex + 1);
+    const [rawMethod, rawPath] = rawLeft.trim().split(/\s+/, 2);
+    const method = rawMethod?.toUpperCase();
+    const path = rawPath?.trim();
+    if (!method || !path || !path.startsWith("/")) {
+        return undefined;
+    }
+    return {
+        method,
+        path,
+        inlineFields: rawFields,
+    };
+};
 const parseField = (rawField) => {
     const [rawName, rawType] = rawField.split(":");
     const name = rawName?.trim();
@@ -33,42 +55,23 @@ const parseField = (rawField) => {
         type: type,
     };
 };
-const parseRoute = (line) => {
-    const separatorIndex = line.indexOf(":");
-    if (separatorIndex === -1) {
-        return {
-            error: "Invalid route definition. Expected format: METHOD /endpoint: field:type,field:type",
-        };
-    }
-    const rawLeft = line.slice(0, separatorIndex);
-    const rawFields = line.slice(separatorIndex + 1);
-    if (!rawLeft || !rawFields) {
-        return {
-            error: "Invalid route definition. Expected format: METHOD /endpoint: field:type,field:type",
-        };
-    }
-    const [rawMethod, rawPath] = rawLeft.trim().split(/\s+/, 2);
-    const method = rawMethod?.toUpperCase();
-    const path = rawPath?.trim();
+const parseRoute = ({ method, path, rawFields, }) => {
     if (!method || !path) {
-        return {
-            error: "Invalid route definition. Missing METHOD or /endpoint before ':'.",
-        };
-    }
-    if (!path.startsWith("/")) {
-        return { error: `Route path must start with '/': ${path}` };
+        return { error: ROUTE_FORMAT_ERROR_MESSAGE };
     }
     const fields = [];
-    for (const part of rawFields.split(",")) {
-        const trimmedPart = part.trim();
-        if (!trimmedPart) {
-            continue;
-        }
-        const parsedField = parseField(trimmedPart);
-        if ("error" in parsedField) {
-            return { error: parsedField.error };
+    for (const rawFieldLine of rawFields) {
+        for (const part of rawFieldLine.split(",")) {
+            const trimmedPart = part.trim();
+            if (!trimmedPart) {
+                continue;
+            }
+            const parsedField = parseField(trimmedPart);
+            if ("error" in parsedField) {
+                return { error: parsedField.error };
+            }
+            fields.push(parsedField);
         }
-        fields.push(parsedField);
     }
     if (fields.length === 0) {
         return { error: `Route ${method} ${path} has no valid fields.` };
@@ -79,13 +82,15 @@ const parseFexapiSchema = (schemaText) => {
     let port = DEFAULT_PORT;
     const routes = [];
     const errors = [];
-    const lines = schemaText
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0 && !line.startsWith("#"));
-    for (const line of lines) {
-        if (line.toLowerCase().startsWith("port:")) {
-            const rawPort = line.slice(line.indexOf(":") + 1).trim();
+    const lines = schemaText.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        const rawLine = lines[index] ?? "";
+        const trimmedLine = rawLine.trim();
+        if (!trimmedLine || trimmedLine.startsWith("#")) {
+            continue;
+        }
+        if (isPortLine(trimmedLine)) {
+            const rawPort = trimmedLine.slice(trimmedLine.indexOf(":") + 1).trim();
             const parsedPort = Number(rawPort);
             if (!Number.isInteger(parsedPort) ||
                 parsedPort < 1 ||
@@ -97,12 +102,45 @@ const parseFexapiSchema = (schemaText) => {
             }
             continue;
         }
-        const parsedRoute = parseRoute(line);
+        const header = parseRouteHeader(trimmedLine);
+        if (!header) {
+            errors.push(ROUTE_FORMAT_ERROR_MESSAGE);
+            continue;
+        }
+        const rawFields = [];
+        if (header.inlineFields.trim()) {
+            rawFields.push(header.inlineFields);
+        }
+        let lookaheadIndex = index + 1;
+        while (lookaheadIndex < lines.length) {
+            const lookaheadRawLine = lines[lookaheadIndex] ?? "";
+            const lookaheadTrimmedLine = lookaheadRawLine.trim();
+            if (!lookaheadTrimmedLine || lookaheadTrimmedLine.startsWith("#")) {
+                lookaheadIndex += 1;
+                continue;
+            }
+            if (isPortLine(lookaheadTrimmedLine) ||
+                parseRouteHeader(lookaheadTrimmedLine)) {
+                break;
+            }
+            if (/^\s+/.test(lookaheadRawLine)) {
+                rawFields.push(lookaheadTrimmedLine.replace(/^-+\s*/, ""));
+                lookaheadIndex += 1;
+                continue;
+            }
+            break;
+        }
+        const parsedRoute = parseRoute({
+            method: header.method,
+            path: header.path,
+            rawFields,
+        });
         if ("error" in parsedRoute) {
             errors.push(parsedRoute.error);
             continue;
         }
         routes.push(parsedRoute);
+        index = lookaheadIndex - 1;
     }
     if (routes.length === 0) {
         errors.push("No routes defined in schema.fexapi.");

package/dist/server.d.ts

@@ -7,10 +7,11 @@ export type ServerOptions = {
     apiSpec?: GeneratedApiSpec;
     runtimeConfig?: FexapiRuntimeConfig;
     schemaDefinitions?: FexapiSchemaDefinitions;
+    logRequests?: boolean;
 };
 export type GeneratedApiSpec = {
     port: number;
     routes: FexapiRoute[];
 };
-export declare const startServer: ({ host, port, apiSpec, runtimeConfig, schemaDefinitions, }?: ServerOptions) => import("http").Server<typeof import("http").IncomingMessage, typeof ServerResponse>;
+export declare const startServer: ({ host, port, apiSpec, runtimeConfig, schemaDefinitions, logRequests, }?: ServerOptions) => import("http").Server<typeof import("http").IncomingMessage, typeof ServerResponse>;
 //# sourceMappingURL=server.d.ts.map

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;CAC7C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAyLF,eAAO,MAAM,WAAW,GAAI,6DAMzB,aAAkB,wFAqGpB,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;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"}

package/dist/server.js

@@ -143,7 +143,7 @@ const getCountFromUrl = (urlText, fallback = 5) => {
     }
     return Math.min(Math.max(Math.floor(rawCount), 1), 50);
 };
-const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtimeConfig, schemaDefinitions = {}, } = {}) => {
+const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtimeConfig, schemaDefinitions = {}, logRequests = false, } = {}) => {
     const corsEnabled = runtimeConfig?.cors ?? false;
     const responseDelay = runtimeConfig?.delay ?? 0;
     const configuredRoutes = runtimeConfig?.routes ?? {};
@@ -152,11 +152,19 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
         ? apiSpec.routes.map((route) => `${route.method} ${route.path}`)
         : [];
     const availableRoutes = [
-        "GET /health",
         ...new Set([...availableConfiguredRoutes, ...availableSchemaRoutes]),
     ];
     const server = (0, node_http_1.createServer)((request, response) => {
+        const requestStartedAt = Date.now();
         const pathname = new URL(request.url ?? "/", "http://localhost").pathname;
+        if (logRequests) {
+            response.on("finish", () => {
+                const method = request.method ?? "UNKNOWN";
+                const durationMs = Date.now() - requestStartedAt;
+                const statusCode = response.statusCode;
+                console.log(`[${method}] ${pathname} → ${statusCode} (${durationMs}ms)`);
+            });
+        }
         if (corsEnabled && request.method === "OPTIONS") {
             response.writeHead(204, {
                 "Access-Control-Allow-Origin": "*",
@@ -166,13 +174,6 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, runtim
             response.end();
             return;
         }
-        if (request.method === "GET" && pathname === "/health") {
-            sendJson(response, 200, {
-                ok: true,
-                timestamp: new Date().toISOString(),
-            }, { cors: corsEnabled, delay: responseDelay });
-            return;
-        }
         if (request.method === "GET") {
             const configuredRoute = configuredRoutes[pathname];
             if (configuredRoute) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fexapi",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Mock API generation CLI tool for local development and testing",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,6 +13,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "lint": "pnpm exec eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
     "start": "node dist/index.js",
     "serve": "node dist/index.js serve",
@@ -40,7 +41,9 @@
   },
   "homepage": "https://github.com/shreeteja172/fexapi#readme",
   "devDependencies": {
+    "@repo/eslint-config": "workspace:*",
     "@types/node": "^22.15.3",
+    "eslint": "^9.39.1",
     "typescript": "5.9.2"
   },
   "dependencies": {