fexapi 0.1.4 → 0.1.5

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.js

@@ -34,7 +34,7 @@ const printHelp = () => {
     console.log("  fexapi.config.json");
     console.log("  fexapi.config.js");
     console.log("  fexapi/schema.fexapi");
-    console.log("  schemas/*.yaml (optional, via wizard)");
+    console.log("  fexapi/schemas/*.yaml (optional, via wizard)");
     console.log("");
     console.log("Init wizard asks:");
     console.log("  What port? (default: 3000)");

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":"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"}

package/dist/commands/dev.js

@@ -18,7 +18,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, }) => {
@@ -71,7 +71,6 @@ const runDevCommand = ({ host, port, watchEnabled, logEnabled, }) => {
     const activeWatchers = [];
     const watchTargets = [
         (0, node_path_1.join)(projectRoot, "fexapi"),
-        (0, node_path_1.join)(projectRoot, "schemas"),
         projectRoot,
     ];
     for (const watchTarget of watchTargets) {

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":"AA0LA,eAAO,MAAM,iBAAiB,GAAU,YAErC;IACD,KAAK,EAAE,OAAO,CAAC;CAChB,KAAG,OAAO,CAAC,MAAM,CAmJjB,CAAC"}

package/dist/commands/init.js

@@ -82,8 +82,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 +102,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,7 +127,15 @@ 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");
@@ -133,7 +151,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();

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/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;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"}

package/dist/server.js

@@ -187,11 +187,39 @@ 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 = getCountFromUrl(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;
             }
         }

package/package.json

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