fexapi 0.1.0 → 0.1.2

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;AAiGF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,KACjB;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAoD3C,CAAC"}

package/dist/schema.js

@@ -13,6 +13,8 @@ const VALID_TYPES = [
     "phone",
 ];
 const DEFAULT_PORT = 4000;
+const ROUTE_FORMAT_ERROR_MESSAGE = "Invalid route definition. Expected format: " +
+    "METHOD /endpoint: field:type,field:type";
 const parseField = (rawField) => {
     const [rawName, rawType] = rawField.split(":");
     const name = rawName?.trim();
@@ -36,16 +38,12 @@ const parseField = (rawField) => {
 const parseRoute = (line) => {
     const separatorIndex = line.indexOf(":");
     if (separatorIndex === -1) {
-        return {
-            error: "Invalid route definition. Expected format: METHOD /endpoint: field:type,field:type",
-        };
+        return { error: ROUTE_FORMAT_ERROR_MESSAGE };
     }
     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",
-        };
+        return { error: ROUTE_FORMAT_ERROR_MESSAGE };
     }
     const [rawMethod, rawPath] = rawLeft.trim().split(/\s+/, 2);
     const method = rawMethod?.toUpperCase();

package/dist/server.d.ts

@@ -1,13 +1,17 @@
 import type { ServerResponse } from "node:http";
 import type { FexapiRoute } from "./schema";
+import type { FexapiRuntimeConfig, FexapiSchemaDefinitions } from "./types/config";
 export type ServerOptions = {
     host?: string;
     port?: number;
     apiSpec?: GeneratedApiSpec;
+    runtimeConfig?: FexapiRuntimeConfig;
+    schemaDefinitions?: FexapiSchemaDefinitions;
+    logRequests?: boolean;
 };
 export type GeneratedApiSpec = {
     port: number;
     routes: FexapiRoute[];
 };
-export declare const startServer: ({ host, port, apiSpec, }?: 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;AAEzD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AA2FF,eAAO,MAAM,WAAW,GAAI,2BAIzB,aAAkB,wFA8DpB,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

@@ -5,9 +5,25 @@ const faker_1 = require("@faker-js/faker");
 const node_http_1 = require("node:http");
 const DEFAULT_HOST = "127.0.0.1";
 const DEFAULT_PORT = 4000;
-const sendJson = (response, statusCode, payload) => {
-    response.writeHead(statusCode, { "Content-Type": "application/json" });
-    response.end(JSON.stringify(payload));
+const sendJson = (response, statusCode, payload, options) => {
+    const send = () => {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (options.cors) {
+            headers["Access-Control-Allow-Origin"] = "*";
+            headers["Access-Control-Allow-Methods"] =
+                "GET,POST,PUT,PATCH,DELETE,OPTIONS";
+            headers["Access-Control-Allow-Headers"] = "Content-Type,Authorization";
+        }
+        response.writeHead(statusCode, headers);
+        response.end(JSON.stringify(payload));
+    };
+    if (options.delay > 0) {
+        setTimeout(send, options.delay);
+        return;
+    }
+    send();
 };
 const createValueFromField = (field) => {
     switch (field.type) {
@@ -39,6 +55,62 @@ const createRecordFromRoute = (route) => {
         return record;
     }, {});
 };
+const resolveFakerMethod = (path) => {
+    const pathParts = path.split(".").filter(Boolean);
+    let current = faker_1.faker;
+    for (const pathPart of pathParts) {
+        if (typeof current !== "object" || current === null) {
+            return undefined;
+        }
+        current = current[pathPart];
+    }
+    if (typeof current !== "function") {
+        return undefined;
+    }
+    return current;
+};
+const createValueFromSchemaFieldDefinition = (fieldDefinition) => {
+    if (fieldDefinition.faker) {
+        const fakerMethod = resolveFakerMethod(fieldDefinition.faker);
+        if (fakerMethod) {
+            return fakerMethod();
+        }
+    }
+    switch (fieldDefinition.type) {
+        case "number": {
+            const min = typeof fieldDefinition.min === "number" ? fieldDefinition.min : 1;
+            const max = typeof fieldDefinition.max === "number" ? fieldDefinition.max : 10000;
+            return faker_1.faker.number.int({
+                min: Math.min(min, max),
+                max: Math.max(min, max),
+            });
+        }
+        case "boolean":
+            return faker_1.faker.datatype.boolean();
+        case "date":
+            return faker_1.faker.date.recent({ days: 30 }).toISOString();
+        case "uuid":
+            return faker_1.faker.string.uuid();
+        case "email":
+            return faker_1.faker.internet.email();
+        case "url":
+            return faker_1.faker.internet.url();
+        case "name":
+            return faker_1.faker.person.fullName();
+        case "phone":
+            return faker_1.faker.phone.number();
+        case "string":
+        default:
+            return faker_1.faker.lorem.words({ min: 1, max: 4 });
+    }
+};
+const createRecordFromSchemaDefinition = (schemaDefinition) => {
+    const result = {};
+    for (const [fieldName, fieldDefinition] of Object.entries(schemaDefinition)) {
+        result[fieldName] = createValueFromSchemaFieldDefinition(fieldDefinition);
+    }
+    return result;
+};
 const toCollectionKey = (routePath) => {
     const segments = routePath.split("/").filter(Boolean);
     const lastSegment = segments[segments.length - 1];
@@ -47,21 +119,17 @@ const toCollectionKey = (routePath) => {
     }
     return lastSegment.replace(/[^a-zA-Z0-9_]/g, "_");
 };
-const createMockUser = () => {
-    return {
-        id: faker_1.faker.string.uuid(),
-        fullName: faker_1.faker.person.fullName(),
-        username: faker_1.faker.internet.username(),
-        email: faker_1.faker.internet.email(),
-        avatarUrl: faker_1.faker.image.avatar(),
-    };
-};
-const createMockPost = () => {
+const createRecordFromSchemaName = (schemaName, schemaDefinitions) => {
+    const normalizedSchemaName = schemaName.trim().toLowerCase();
+    const customSchemaDefinition = schemaDefinitions[normalizedSchemaName];
+    if (customSchemaDefinition) {
+        return createRecordFromSchemaDefinition(customSchemaDefinition);
+    }
     return {
         id: faker_1.faker.string.uuid(),
-        title: faker_1.faker.lorem.sentence(),
-        body: faker_1.faker.lorem.paragraphs({ min: 1, max: 3 }),
-        createdAt: faker_1.faker.date.recent({ days: 14 }).toISOString(),
+        type: normalizedSchemaName || "record",
+        value: faker_1.faker.lorem.words({ min: 1, max: 4 }),
+        createdAt: faker_1.faker.date.recent({ days: 7 }).toISOString(),
     };
 };
 const getCountFromUrl = (urlText, fallback = 5) => {
@@ -75,16 +143,47 @@ const getCountFromUrl = (urlText, fallback = 5) => {
     }
     return Math.min(Math.max(Math.floor(rawCount), 1), 50);
 };
-const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, } = {}) => {
+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 ?? {};
+    const availableConfiguredRoutes = Object.keys(configuredRoutes).map((path) => `GET ${path}`);
+    const availableSchemaRoutes = apiSpec
+        ? apiSpec.routes.map((route) => `${route.method} ${route.path}`)
+        : [];
+    const availableRoutes = [
+        ...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 (request.method === "GET" && pathname === "/health") {
-            sendJson(response, 200, {
-                ok: true,
-                timestamp: new Date().toISOString(),
+        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": "*",
+                "Access-Control-Allow-Methods": "GET,POST,PUT,PATCH,DELETE,OPTIONS",
+                "Access-Control-Allow-Headers": "Content-Type,Authorization",
+            });
+            response.end();
             return;
         }
+        if (request.method === "GET") {
+            const configuredRoute = configuredRoutes[pathname];
+            if (configuredRoute) {
+                const payloadKey = toCollectionKey(pathname);
+                sendJson(response, 200, {
+                    [payloadKey]: Array.from({ length: configuredRoute.count }, () => createRecordFromSchemaName(configuredRoute.schema, schemaDefinitions)),
+                }, { cors: corsEnabled, delay: responseDelay });
+                return;
+            }
+        }
         if (apiSpec) {
             const matchedRoute = apiSpec.routes.find((route) => route.method === request.method && route.path === pathname);
             if (matchedRoute) {
@@ -92,33 +191,14 @@ const startServer = ({ host = DEFAULT_HOST, port = DEFAULT_PORT, apiSpec, } = {}
                 const payloadKey = toCollectionKey(matchedRoute.path);
                 sendJson(response, 200, {
                     [payloadKey]: Array.from({ length: count }, () => createRecordFromRoute(matchedRoute)),
-                });
+                }, { cors: corsEnabled, delay: responseDelay });
                 return;
             }
         }
-        if (request.method === "GET" && pathname === "/users") {
-            const count = getCountFromUrl(request.url, 8);
-            sendJson(response, 200, {
-                users: Array.from({ length: count }, createMockUser),
-            });
-            return;
-        }
-        if (request.method === "GET" && pathname === "/posts") {
-            const count = getCountFromUrl(request.url, 5);
-            sendJson(response, 200, {
-                posts: Array.from({ length: count }, createMockPost),
-            });
-            return;
-        }
         sendJson(response, 404, {
             message: "Route not found",
-            availableRoutes: apiSpec
-                ? [
-                    "GET /health",
-                    ...apiSpec.routes.map((route) => `${route.method} ${route.path}`),
-                ]
-                : ["GET /health", "GET /users?count=10", "GET /posts?count=5"],
-        });
+            availableRoutes,
+        }, { cors: corsEnabled, delay: responseDelay });
     });
     server.listen(port, host, () => {
         console.log(`Mock API running at http://${host}:${port}`);

package/dist/types/config.d.ts

@@ -0,0 +1,20 @@
+export type FexapiRouteConfig = {
+    count: number;
+    schema: string;
+};
+export type FexapiFieldValueType = "number" | "string" | "boolean" | "date" | "uuid" | "email" | "url" | "name" | "phone";
+export type FexapiSchemaFieldDefinition = {
+    type: FexapiFieldValueType;
+    faker?: string;
+    min?: number;
+    max?: number;
+};
+export type FexapiSchemaDefinition = Record<string, FexapiSchemaFieldDefinition>;
+export type FexapiSchemaDefinitions = Record<string, FexapiSchemaDefinition>;
+export type FexapiRuntimeConfig = {
+    port?: number;
+    routes?: Record<string, FexapiRouteConfig>;
+    cors?: boolean;
+    delay?: number;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACzC,MAAM,EACN,2BAA2B,CAC5B,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/project.d.ts

@@ -0,0 +1,7 @@
+export type SupportedFramework = "nextjs" | "reactjs" | "vue" | "nuxt" | "svelte" | "sveltekit" | "angular" | "solid" | "remix" | "astro" | "unknown";
+export type DetectedProject = {
+    primaryFramework: SupportedFramework;
+    frameworks: SupportedFramework[];
+    tooling: string[];
+};
+//# sourceMappingURL=project.d.ts.map

package/dist/types/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,SAAS,GACT,KAAK,GACL,MAAM,GACN,QAAQ,GACR,WAAW,GACX,SAAS,GACT,OAAO,GACP,OAAO,GACP,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG;IAC5B,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/dist/types/project.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,51 +1,56 @@
-{
-  "name": "fexapi",
-  "version": "0.1.0",
-  "description": "Mock API generation CLI tool for local development and testing",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "fexapi": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "check-types": "tsc --noEmit",
-    "start": "node dist/index.js",
-    "dev": "tsc -w -p tsconfig.json",
-    "prepublishOnly": "pnpm build"
-  },
-  "keywords": [
-    "mock",
-    "api",
-    "cli",
-    "testing",
-    "development",
-    "faker",
-    "mock-server"
-  ],
-  "author": "Shreeteja Mutukundu smutukundu2006@gmail.com",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/shreeteja172/fexapi.git",
-    "directory": "apps/cli"
-  },
-  "bugs": {
-    "url": "https://github.com/shreeteja172/fexapi/issues"
-  },
-  "homepage": "https://github.com/shreeteja172/fexapi#readme",
-  "devDependencies": {
-    "@types/node": "^22.15.3",
-    "typescript": "5.9.2"
-  },
-  "dependencies": {
-    "@faker-js/faker": "^10.3.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "fexapi",
+  "version": "0.1.2",
+  "description": "Mock API generation CLI tool for local development and testing",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "fexapi": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "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",
+    "dev": "tsc -w -p tsconfig.json",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "mock",
+    "api",
+    "cli",
+    "testing",
+    "development",
+    "faker",
+    "mock-server"
+  ],
+  "author": "Shreeteja Mutukundu smutukundu2006@gmail.com",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shreeteja172/fexapi.git",
+    "directory": "apps/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/shreeteja172/fexapi/issues"
+  },
+  "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": {
+    "@faker-js/faker": "^10.3.0",
+    "yaml": "^2.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}