create-mock-api-from-types 1.0.0

package/README.md

@@ -0,0 +1,220 @@
+# Mock API
+
+Generate a mock REST API server from TypeScript interfaces and object type aliases. Perfect for frontend development, testing, and prototyping—define your data shapes in TypeScript and get a fully functional API with realistic fake data powered by [Faker](https://fakerjs.dev/).
+
+## Features
+
+- **TypeScript-first**: Define schemas as interfaces or object type aliases
+- **Smart mock data**: Property names are matched to appropriate Faker generators (e.g. `email` → realistic emails, `price` → commerce prices)
+- **Full REST API**: GET, POST, PUT, PATCH, DELETE with pagination support
+- **Nested types**: References to other interfaces/types are resolved recursively
+- **Multiple schemas**: Point to one or more schema files to build a complete API
+
+## Installation
+
+```bash
+pnpm add mock-api
+# or
+npm install mock-api
+```
+
+## Quick Start
+
+1. Create a schema file (e.g. `schema.ts`):
+
+```typescript
+interface User {
+    id: string;
+    name: string;
+    email: string;
+    phone: string;
+    isActive: boolean;
+}
+
+type Product = {
+    id: string;
+    name: string;
+    price: number;
+    inStock: boolean;
+};
+```
+
+2. Start the mock API:
+
+```bash
+npx mock-api schema.ts
+```
+
+3. Visit `http://localhost:3000` to see all available routes and collections.
+
+## CLI Usage
+
+```bash
+mock-api <schemas...> [options]
+```
+
+### Arguments
+
+| Argument   | Description                          |
+| ---------- | ------------------------------------ |
+| `<schemas...>` | One or more TypeScript schema file paths (required) |
+
+### Options
+
+| Option | Short | Default | Description                          |
+| ------ | ----- | ------- | ------------------------------------ |
+| `--port` | `-p` | `3000` | Port to run the server on            |
+| `--count` | `-c` | `10` | Number of mock items to generate per collection |
+
+### Examples
+
+```bash
+# Basic usage
+mock-api src/schema.ts
+
+# Custom port and item count
+mock-api schemas/*.ts -p 8080 -c 25
+
+# Multiple schema files
+mock-api src/models/user.ts src/models/product.ts
+```
+
+## Schema Definition
+
+### Interfaces
+
+```typescript
+interface User {
+    id: string;
+    name: string;
+    email: string;
+}
+```
+
+### Object Type Aliases
+
+```typescript
+type Product = {
+    id: string;
+    name: string;
+    price: number;
+};
+```
+
+Both interfaces and object type aliases (`type X = { ... }`) are supported. Only object-shaped types are used—primitives and union aliases (e.g. `type ID = string`) are ignored.
+
+### Supported Types
+
+- **Primitives**: `string`, `number`, `boolean`
+- **Arrays**: `T[]` or `Array<T>`
+- **Unions**: `'a' | 'b'` (picks a random option)
+- **Nested types**: References to other interfaces or type aliases in the same project
+- **Optional**: `| undefined` and `| null` are stripped when generating mocks
+
+## API Endpoints
+
+Each schema becomes a collection with the following REST endpoints:
+
+| Method | Path | Description |
+| ------ | ---- | ----------- |
+| GET | `/` | List all collections and their endpoints |
+| GET | `/:collection` | List items (supports `?page` and `?limit` for pagination) |
+| GET | `/:collection/:id` | Get a single item by ID |
+| POST | `/:collection` | Create a new item |
+| PUT | `/:collection/:id` | Replace an item |
+| PATCH | `/:collection/:id` | Partially update an item |
+| DELETE | `/:collection/:id` | Delete an item |
+
+### Route Naming
+
+Interface/type names are converted to kebab-case and pluralized:
+
+- `User` → `/users`
+- `Product` → `/products`
+- `OrderItem` → `/order-items`
+
+### Response Format
+
+**List (GET `/:collection`):**
+
+```json
+{
+  "data": [...],
+  "total": 10,
+  "page": 1,
+  "limit": 10
+}
+```
+
+**Single item (GET `/:collection/:id`):**
+
+```json
+{
+  "id": "uuid-here",
+  "name": "John Doe",
+  "email": "john@example.com"
+}
+```
+
+## Smart Property Generation
+
+Property names are matched to Faker generators for realistic data:
+
+| Pattern | Example |
+| ------- | ------- |
+| `id`, `*Id` | UUID |
+| `email` | `user@example.com` |
+| `name`, `firstName`, `lastName` | Person names |
+| `phone`, `mobile` | Phone numbers |
+| `password`, `secret` | Passwords |
+| `address`, `city`, `state`, `zip`, `country` | Location data |
+| `price`, `cost`, `amount` | Commerce prices |
+| `createdAt`, `updatedAt`, `date` | ISO date strings |
+| `description`, `content`, `body` | Lorem paragraphs |
+| `url`, `image`, `avatar` | URLs |
+| `isActive`, `isEnabled`, `verified` | Booleans |
+| ...and more | See `propGenerator.ts` for full list |
+
+Unmatched properties fall back to type-based generation (`string` → word, `number` → integer, etc.).
+
+## Programmatic Usage
+
+Use the library in your own Node.js application:
+
+```typescript
+import { createServer, startServer } from "mock-api";
+import type { MockApiOptions } from "mock-api";
+
+const options: MockApiOptions = {
+    schemaPaths: ["src/schema.ts"],
+    port: 3000,
+    count: 10,
+};
+
+// Start a server (blocks)
+startServer(options);
+
+// Or create an Express app for custom use (e.g. testing)
+const app = createServer(options);
+// app is a standard Express application
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm run build
+
+# Run with tsx (no build step)
+pnpm run dev src/schema.ts
+
+# Type check
+pnpm run typecheck
+```
+
+## License
+
+ISC

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { processArgs } from "./utils/processArgs.js";
+import { startServer } from "./server.js";
+const options = processArgs(process.argv);
+startServer(options);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1C,WAAW,CAAC,OAAO,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createServer, startServer } from "./server.js";
+export type { MockApiOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createServer, startServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/router/routeBuilder.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { DataStore } from "../store/dataStore.js";
+export declare function buildRouter(collection: string, store: DataStore): Router;
+//# sourceMappingURL=routeBuilder.d.ts.map

package/dist/router/routeBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeBuilder.d.ts","sourceRoot":"","sources":["../../src/router/routeBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAmBvD,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CA4ExE"}

package/dist/router/routeBuilder.js

@@ -0,0 +1,78 @@
+import { Router } from "express";
+// parseQueryInt(value) parses the given value as an integer
+// returns: value as an int if valid, undefined otherwise
+function parseQueryInt(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const num = parseInt(value, 10);
+    return isNaN(num) ? undefined : num;
+}
+// buildRouter(collection, store) builds a router for the given collection and store
+// returns: the router
+// example: "users" -> "/users"
+//          "posts" -> "/posts"
+//          "comments" -> "/comments"
+//          "products" -> "/products"
+//          "orders" -> "/orders"
+export function buildRouter(collection, store) {
+    const router = Router();
+    // GET /: paginated list of items
+    router.get("/", (req, res) => {
+        const page = parseQueryInt(req.query["page"]);
+        const limit = parseQueryInt(req.query["limit"]);
+        const data = store.getAll(collection, page, limit);
+        const total = store.count(collection);
+        res.json({ data, total, page: page ?? 1, limit: limit ?? total });
+    });
+    // GET /:id: get an item by id
+    router.get("/:id", (req, res) => {
+        const id = req.params["id"];
+        const item = store.getById(collection, id);
+        if (item === undefined) {
+            res.status(404).json({ error: "Not found" });
+            return;
+        }
+        res.json(item);
+    });
+    // POST /: create a new item
+    router.post("/", (req, res) => {
+        const body = req.body;
+        const item = store.create(collection, body);
+        res.status(201).json(item);
+    });
+    // PUT /:id: update an item by id
+    router.put("/:id", (req, res) => {
+        const id = req.params["id"];
+        const body = req.body;
+        const item = store.update(collection, id, body);
+        if (item === undefined) {
+            res.status(404).json({ error: "Not found" });
+            return;
+        }
+        res.json(item);
+    });
+    // PATCH /:id: update an item by id
+    router.patch("/:id", (req, res) => {
+        const id = req.params["id"];
+        const body = req.body;
+        const item = store.patch(collection, id, body);
+        if (item === undefined) {
+            res.status(404).json({ error: "Not found" });
+            return;
+        }
+        res.json(item);
+    });
+    // DELETE /:id: delete an item by id
+    router.delete("/:id", (req, res) => {
+        const id = req.params["id"];
+        const deleted = store.delete(collection, id);
+        if (!deleted) {
+            res.status(404).json({ error: "Not found" });
+            return;
+        }
+        res.status(204).send();
+    });
+    return router;
+}
+//# sourceMappingURL=routeBuilder.js.map

package/dist/router/routeBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeBuilder.js","sourceRoot":"","sources":["../../src/router/routeBuilder.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":""}

package/dist/schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":""}

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+import { type Express } from "express";
+import type { MockApiOptions } from "./types.js";
+export declare function createServer(options: MockApiOptions): Express;
+export declare function startServer(options: MockApiOptions): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CA2E7D;AAKD,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAezD"}

package/dist/server.js

@@ -0,0 +1,87 @@
+import { resolve } from "node:path";
+import express, {} from "express";
+import { Node, Project } from "ts-morph";
+import { DataStore } from "./store/dataStore.js";
+import { buildRouter } from "./router/routeBuilder.js";
+import { generateMockCollection, } from "./utils/mockGenerator.js";
+import { toRoutePath, toCollectionKey } from "./utils/nameUtils.js";
+// createServer(options) creates a new server with the given options
+//   options: the options for the server
+//   returns: the Express application (server)
+export function createServer(options) {
+    const app = express();
+    const project = new Project({ skipAddingFilesFromTsConfig: true });
+    const store = new DataStore();
+    app.use(express.json());
+    // Add the source files to the project
+    for (const schemaPath of options.schemaPaths) {
+        project.addSourceFilesAtPaths(resolve(schemaPath));
+    }
+    const schemas = [];
+    for (const sf of project.getSourceFiles()) {
+        // Add all interfaces to the schemas
+        for (const iface of sf.getInterfaces()) {
+            schemas.push({ name: iface.getName(), schema: iface });
+        }
+        // Add all type aliases to the schemas
+        for (const typeAlias of sf.getTypeAliases()) {
+            const typeNode = typeAlias.getTypeNode();
+            if (typeNode !== undefined && Node.isTypeLiteral(typeNode)) {
+                schemas.push({ name: typeAlias.getName(), schema: typeNode });
+            }
+        }
+    }
+    if (schemas.length === 0) {
+        console.warn("Warning: No interfaces or object type aliases found in the provided schema files");
+    }
+    const routes = [];
+    for (const { name, schema } of schemas) {
+        const routePath = toRoutePath(name);
+        const collectionKey = toCollectionKey(name);
+        const mockData = generateMockCollection(schema, project, options.count);
+        store.seed(collectionKey, mockData);
+        const router = buildRouter(collectionKey, store);
+        app.use(routePath, router);
+        routes.push({
+            path: routePath,
+            interface: name,
+            count: options.count,
+        });
+    }
+    // Root route lists all available collections
+    app.get("/", (_req, res) => {
+        res.json({
+            message: "Mock API is running",
+            routes: routes.map((r) => ({
+                collection: r.path,
+                interface: r.interface,
+                seeded: r.count,
+                endpoints: [
+                    `GET ${r.path}`,
+                    `GET ${r.path}/:id`,
+                    `POST ${r.path}`,
+                    `PUT ${r.path}/:id`,
+                    `PATCH ${r.path}/:id`,
+                    `DELETE ${r.path}/:id`,
+                ],
+            })),
+        });
+    });
+    return app;
+}
+// startServer(options) starts the server with the given options
+//   options: the options for the server
+//   returns: void
+export function startServer(options) {
+    const app = createServer(options);
+    console.log("\nRegistering routes:");
+    for (const schemaPath of options.schemaPaths) {
+        console.log(`  Schema: ${schemaPath}`);
+    }
+    app.listen(options.port, () => {
+        console.log(`\nMock API running at http://localhost:${options.port}`);
+        console.log(`Visit http://localhost:${options.port}/ to see all routes`);
+        console.log("Press Ctrl+C to stop\n");
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/store/dataStore.d.ts

@@ -0,0 +1,16 @@
+type MockRecord = Record<string, unknown> & {
+    id: string;
+};
+export declare class DataStore {
+    private readonly collections;
+    seed(collection: string, items: Record<string, unknown>[]): void;
+    count(collection: string): number;
+    getAll(collection: string, page?: number, limit?: number): MockRecord[];
+    getById(collection: string, id: string): MockRecord | undefined;
+    create(collection: string, data: Record<string, unknown>): MockRecord;
+    update(collection: string, id: string, data: Record<string, unknown>): MockRecord | undefined;
+    patch(collection: string, id: string, data: Record<string, unknown>): MockRecord | undefined;
+    delete(collection: string, id: string): boolean;
+}
+export {};
+//# sourceMappingURL=dataStore.d.ts.map

package/dist/store/dataStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataStore.d.ts","sourceRoot":"","sources":["../../src/store/dataStore.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IAIpE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAShE,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAMjC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAWvE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAM/D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IASrE,MAAM,CACF,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,UAAU,GAAG,SAAS;IAiBzB,KAAK,CACD,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,UAAU,GAAG,SAAS;IAiBzB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;CAalD"}

package/dist/store/dataStore.js

@@ -0,0 +1,77 @@
+import { randomUUID } from "node:crypto";
+export class DataStore {
+    collections = new Map();
+    // seed(collection, items) seeds the collection with the given items
+    //   adds the items to the collection
+    seed(collection, items) {
+        const records = items.map((item) => ({ id: randomUUID(), ...item }));
+        this.collections.set(collection, records);
+    }
+    // count(collection) counts the number of items in the collection
+    // returns: the number of items in the collection
+    count(collection) {
+        return this.collections.get(collection)?.length ?? 0;
+    }
+    // getAll(collection, page, limit) gets all items from the collection
+    // returns: a slice of the collection based on the page and limit
+    getAll(collection, page, limit) {
+        const items = this.collections.get(collection) ?? [];
+        if (page !== undefined && limit !== undefined) {
+            const start = (page - 1) * limit;
+            return items.slice(start, start + limit);
+        }
+        return items;
+    }
+    // getById(collection, id) gets an item from the collection by id
+    // returns: the item if it exists, undefined otherwise
+    getById(collection, id) {
+        return this.collections.get(collection)?.find((item) => item.id === id);
+    }
+    // create(collection, data) creates a new item in the collection
+    // returns: the created item
+    create(collection, data) {
+        const record = { id: randomUUID(), ...data };
+        const existing = this.collections.get(collection) ?? [];
+        this.collections.set(collection, [...existing, record]);
+        return record;
+    }
+    // update(collection, id, data) updates an item in the collection
+    // returns: the updated item if it exists, undefined otherwise
+    update(collection, id, data) {
+        const items = this.collections.get(collection);
+        if (items === undefined)
+            return undefined;
+        const exists = items.some((item) => item.id === id);
+        if (!exists)
+            return undefined;
+        const updated = { id, ...data };
+        this.collections.set(collection, items.map((item) => (item.id === id ? updated : item)));
+        return updated;
+    }
+    // patch(collection, id, data) partially updates an item in the collection
+    // returns: the updated item if it exists, undefined otherwise
+    patch(collection, id, data) {
+        const items = this.collections.get(collection);
+        if (items === undefined)
+            return undefined;
+        const existing = items.find((item) => item.id === id);
+        if (existing === undefined)
+            return undefined;
+        const updated = { ...existing, ...data, id };
+        this.collections.set(collection, items.map((item) => (item.id === id ? updated : item)));
+        return updated;
+    }
+    // delete(collection, id) deletes an item from the collection
+    // returns: true if the item was deleted, false otherwise
+    delete(collection, id) {
+        const items = this.collections.get(collection);
+        if (items === undefined)
+            return false;
+        const exists = items.some((item) => item.id === id);
+        if (!exists)
+            return false;
+        this.collections.set(collection, items.filter((item) => item.id !== id));
+        return true;
+    }
+}
+//# sourceMappingURL=dataStore.js.map

package/dist/store/dataStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataStore.js","sourceRoot":"","sources":["../../src/store/dataStore.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export type MockApiOptions = {
+    schemaPaths: string[];
+    port: number;
+    count: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/mockGenerator.d.ts

@@ -0,0 +1,5 @@
+import { type InterfaceDeclaration, type Project, type TypeLiteralNode } from "ts-morph";
+export type ObjectSchema = InterfaceDeclaration | TypeLiteralNode;
+export declare function generateMockObject(schema: ObjectSchema, project: Project, depth?: number): Record<string, unknown>;
+export declare function generateMockCollection(schema: ObjectSchema, project: Project, count: number): Record<string, unknown>[];
+//# sourceMappingURL=mockGenerator.d.ts.map

package/dist/utils/mockGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/mockGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,oBAAoB,EACzB,KAAK,OAAO,EACZ,KAAK,eAAe,EACvB,MAAM,UAAU,CAAC;AAKlB,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,eAAe,CAAC;AA4FlE,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,MAAU,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAID,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAI3B"}

package/dist/utils/mockGenerator.js

@@ -0,0 +1,84 @@
+import { Node, } from "ts-morph";
+import { generateProp } from "./propGenerator.js";
+const MAX_DEPTH = 5;
+// findSchema(typeName, project) finds the interface or type alias with the given name in the project
+// returns: the schema if it exists (interface or type literal from object type alias), undefined otherwise
+function findSchema(typeName, project) {
+    const iface = project
+        .getSourceFiles()
+        .flatMap((sf) => sf.getInterfaces())
+        .find((i) => i.getName() === typeName);
+    if (iface !== undefined) {
+        return iface;
+    }
+    const typeAlias = project
+        .getSourceFiles()
+        .flatMap((sf) => sf.getTypeAliases())
+        .find((t) => t.getName() === typeName);
+    if (typeAlias === undefined) {
+        return undefined;
+    }
+    const typeNode = typeAlias.getTypeNode();
+    if (typeNode === undefined || !Node.isTypeLiteral(typeNode)) {
+        return undefined;
+    }
+    return typeNode;
+}
+// resolveTypeText(propName, typeText, project, depth) resolves the type text for the given property name,
+// type text, project, and depth.
+//   returns: the resolved type text
+function resolveTypeText(propName, typeText, project, depth) {
+    if (depth > MAX_DEPTH) {
+        return null;
+    }
+    // Strip optional modifiers (| undefined, | null)
+    const cleaned = typeText
+        .replace(/\s*\|\s*undefined/g, "")
+        .replace(/\s*\|\s*null/g, "")
+        .trim();
+    // Array type: T[]
+    if (cleaned.endsWith("[]")) {
+        const inner = cleaned.slice(0, -2);
+        return Array.from({ length: 3 }, () => resolveTypeText(propName, inner, project, depth + 1));
+    }
+    // Generic array: Array<T>
+    const arrayMatch = cleaned.match(/^Array<(.+)>$/);
+    const arrayInner = arrayMatch?.[1];
+    if (arrayInner !== undefined) {
+        return Array.from({ length: 3 }, () => resolveTypeText(propName, arrayInner, project, depth + 1));
+    }
+    // String literal: 'value' or "value"
+    if (/^'[^']*'$/.test(cleaned) || /^"[^"]*"$/.test(cleaned)) {
+        return cleaned.slice(1, -1);
+    }
+    // Union type: pick a random option
+    if (cleaned.includes(" | ")) {
+        const options = cleaned.split(" | ").map((t) => t.trim());
+        const picked = options[Math.floor(Math.random() * options.length)] ?? "string";
+        return resolveTypeText(propName, picked, project, depth + 1);
+    }
+    // Nested interface or type alias
+    const nested = findSchema(cleaned, project);
+    if (nested !== undefined) {
+        return generateMockObject(nested, project, depth + 1);
+    }
+    return generateProp(propName, cleaned);
+}
+// generateMockObject(schema, project, depth) generates a mock object with the given schema, project, and depth
+//   returns: a mock object
+export function generateMockObject(schema, project, depth = 0) {
+    const obj = {};
+    for (const prop of schema.getProperties()) {
+        const propName = prop.getName();
+        // Prefer the type node text (as written) for clean type names
+        const typeText = prop.getTypeNode()?.getText() ?? prop.getType().getText();
+        obj[propName] = resolveTypeText(propName, typeText, project, depth);
+    }
+    return obj;
+}
+// generateMockCollection(schema, project, count) generates a mock collection with the given schema, project, and count
+//   returns: an array of mock objects
+export function generateMockCollection(schema, project, count) {
+    return Array.from({ length: count }, () => generateMockObject(schema, project));
+}
+//# sourceMappingURL=mockGenerator.js.map

package/dist/utils/mockGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockGenerator.js","sourceRoot":"","sources":["../../src/utils/mockGenerator.ts"],"names":[],"mappings":"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"}

package/dist/utils/nameUtils.d.ts

@@ -0,0 +1,5 @@
+export declare function pluralize(word: string): string;
+export declare function toKebabCase(str: string): string;
+export declare function toRoutePath(interfaceName: string): string;
+export declare function toCollectionKey(interfaceName: string): string;
+//# sourceMappingURL=nameUtils.d.ts.map

package/dist/utils/nameUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameUtils.d.ts","sourceRoot":"","sources":["../../src/utils/nameUtils.ts"],"names":[],"mappings":"AAeA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB9C;AAKD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAKD,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQzD;AAKD,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/utils/nameUtils.js

@@ -0,0 +1,58 @@
+const IRREGULAR_PLURALS = {
+    person: "people",
+    man: "men",
+    woman: "women",
+    child: "children",
+    mouse: "mice",
+    tooth: "teeth",
+    foot: "feet",
+    goose: "geese",
+};
+// pluralize(word) pluralizes the given word
+// returns: the pluralized word
+// example: "Person" -> "People"
+//          "User" -> "Users"
+export function pluralize(word) {
+    const lower = word.toLowerCase();
+    const irregular = IRREGULAR_PLURALS[lower];
+    if (irregular !== undefined) {
+        return irregular;
+    }
+    // If the word ends in s, x, z, ch, or sh, add es
+    if (/(?:s|x|z|ch|sh)$/i.test(word)) {
+        return word + "es";
+    }
+    // If the word ends in y and is not preceded by a vowel, add ies
+    if (/[^aeiou]y$/i.test(word)) {
+        return word.slice(0, -1) + "ies";
+    }
+    return word + "s";
+}
+// toKebabCase(str) converts the given string to kebab case
+// returns: the kebab case string
+// example: "User" -> "user"
+export function toKebabCase(str) {
+    return str
+        .replace(/([A-Z])/g, (_, char) => `-${char}`)
+        .toLowerCase()
+        .replace(/^-/, "");
+}
+// toRoutePath(interfaceName) converts the given interface name to a route path
+// returns: route path
+// example: "User" -> "/users"
+export function toRoutePath(interfaceName) {
+    const kebab = toKebabCase(interfaceName);
+    const parts = kebab.split("-");
+    const lastPart = parts[parts.length - 1];
+    if (lastPart !== undefined) {
+        parts[parts.length - 1] = pluralize(lastPart);
+    }
+    return "/" + parts.join("-");
+}
+// toCollectionKey(interfaceName) converts the given interface name to a collection key
+// returns: collection key
+// example: "User" -> "users"
+export function toCollectionKey(interfaceName) {
+    return toRoutePath(interfaceName).slice(1);
+}
+//# sourceMappingURL=nameUtils.js.map

package/dist/utils/nameUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameUtils.js","sourceRoot":"","sources":["../../src/utils/nameUtils.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAqC;IACxD,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACjB,CAAC;AAEF,4CAA4C;AAC5C,+BAA+B;AAC/B,gCAAgC;AAChC,6BAA6B;AAC7B,MAAM,UAAU,SAAS,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEjC,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,iDAAiD;IACjD,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,GAAG,IAAI,CAAC;IACvB,CAAC;IACD,gEAAgE;IAChE,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,GAAG,GAAG,CAAC;AACtB,CAAC;AAED,2DAA2D;AAC3D,iCAAiC;AACjC,4BAA4B;AAC5B,MAAM,UAAU,WAAW,CAAC,GAAW;IACnC,OAAO,GAAG;SACL,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;SACpD,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,8BAA8B;AAC9B,MAAM,UAAU,WAAW,CAAC,aAAqB;IAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,uFAAuF;AACvF,0BAA0B;AAC1B,6BAA6B;AAC7B,MAAM,UAAU,eAAe,CAAC,aAAqB;IACjD,OAAO,WAAW,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/utils/processArgs.d.ts

@@ -0,0 +1,3 @@
+import type { MockApiOptions } from "../types.js";
+export declare function processArgs(argv: string[]): MockApiOptions;
+//# sourceMappingURL=processArgs.d.ts.map

package/dist/utils/processArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processArgs.d.ts","sourceRoot":"","sources":["../../src/utils/processArgs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAuC1D"}

package/dist/utils/processArgs.js

@@ -0,0 +1,31 @@
+import { Command } from "commander";
+// processArgs(argv) processes the given arguments and returns the options
+// retunrs: object with schema paths, port, and count
+export function processArgs(argv) {
+    const program = new Command();
+    program
+        .name("mock-api")
+        .description("Generate a mock REST API from TypeScript interfaces and object type aliases")
+        .argument("<schemas...>", "TypeScript schema file path(s)")
+        .option("-p, --port <number>", "Port to run the server on", "3000")
+        .option("-c, --count <number>", "Number of mock items to generate per collection", "10")
+        .parse(argv);
+    const schemaPaths = program.args;
+    const opts = program.opts();
+    const port = parseInt(opts.port, 10);
+    const count = parseInt(opts.count, 10);
+    if (schemaPaths.length === 0) {
+        console.error("Error: At least one schema file is required");
+        process.exit(1);
+    }
+    if (isNaN(port) || port < 1 || port > 65535) {
+        console.error("Error: Port must be a number between 1 and 65535");
+        process.exit(1);
+    }
+    if (isNaN(count) || count < 1) {
+        console.error("Error: Count must be a positive integer");
+        process.exit(1);
+    }
+    return { schemaPaths, port, count };
+}
+//# sourceMappingURL=processArgs.js.map

package/dist/utils/processArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processArgs.js","sourceRoot":"","sources":["../../src/utils/processArgs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,0EAA0E;AAC1E,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,IAAc;IACtC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACF,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CACR,6EAA6E,CAChF;SACA,QAAQ,CAAC,cAAc,EAAE,gCAAgC,CAAC;SAC1D,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;SAClE,MAAM,CACH,sBAAsB,EACtB,iDAAiD,EACjD,IAAI,CACP;SACA,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAmC,CAAC;IAE7D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEvC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/utils/propGenerator.d.ts

@@ -0,0 +1,2 @@
+export declare function generateProp(propName: string, propType: string): unknown;
+//# sourceMappingURL=propGenerator.d.ts.map

package/dist/utils/propGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/propGenerator.ts"],"names":[],"mappings":"AAiEA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAaxE"}

package/dist/utils/propGenerator.js

@@ -0,0 +1,73 @@
+import { faker } from "@faker-js/faker";
+// Ordered by specificity — first match wins
+const NAME_PATTERNS = [
+    [/^id$|Id$/, () => faker.string.uuid()],
+    [/email/i, () => faker.internet.email()],
+    [/username/i, () => faker.internet.username()],
+    [/password|secret/i, () => faker.internet.password()],
+    [/phone|mobile/i, () => faker.phone.number()],
+    [/firstName|first_name/i, () => faker.person.firstName()],
+    [/lastName|last_name/i, () => faker.person.lastName()],
+    [/fullName|full_name/i, () => faker.person.fullName()],
+    [/name/i, () => faker.person.fullName()],
+    [/address|street/i, () => faker.location.streetAddress()],
+    [/city/i, () => faker.location.city()],
+    [/state|province/i, () => faker.location.state()],
+    [/zip|postal/i, () => faker.location.zipCode()],
+    [/country/i, () => faker.location.country()],
+    [/latitude|lat$/i, () => faker.location.latitude()],
+    [/longitude|lng$|lon$/i, () => faker.location.longitude()],
+    [/createdAt|updatedAt|deletedAt/i, () => faker.date.recent().toISOString()],
+    [/date|time/i, () => faker.date.recent().toISOString()],
+    [/description|bio|summary|about/i, () => faker.lorem.paragraph()],
+    [/title|headline/i, () => faker.lorem.words(4)],
+    [/slug/i, () => faker.helpers.slugify(faker.lorem.words(3))],
+    [/image|avatar|photo|picture/i, () => faker.image.url()],
+    [/url|website|link|href/i, () => faker.internet.url()],
+    [/price|cost|amount|fee/i, () => faker.commerce.price()],
+    [/color|colour/i, () => faker.color.human()],
+    [/company|organization|org/i, () => faker.company.name()],
+    [/job|position|role|occupation/i, () => faker.person.jobTitle()],
+    [/age/i, () => faker.number.int({ min: 18, max: 80 })],
+    [
+        /rating|score/i,
+        () => faker.number.float({ min: 0, max: 5, fractionDigits: 1 }),
+    ],
+    [/count|total|quantity|qty/i, () => faker.number.int({ min: 0, max: 100 })],
+    [/content|body|text/i, () => faker.lorem.paragraphs(2)],
+    [/token|key|hash/i, () => faker.string.alphanumeric(32)],
+    [/tag|label|category/i, () => faker.commerce.department()],
+    [
+        /isActive|isEnabled|isVerified|active|enabled|verified/i,
+        () => faker.datatype.boolean(),
+    ],
+];
+// Record of type generic type fallbacks in case no pattern matches
+const TYPE_FALLBACKS = {
+    string: () => faker.lorem.word(),
+    number: () => faker.number.int({ max: 1000 }),
+    boolean: () => faker.datatype.boolean(),
+    Date: () => faker.date.recent().toISOString(),
+    any: () => faker.lorem.word(),
+    unknown: () => faker.lorem.word(),
+};
+// generateProp(propName, propType) generates a mock property with the given name and type
+// returns: mock property
+// example: "name" -> "John Doe"
+//          "email" -> "john.doe@example.com"
+//          "password" -> "password123"
+//          "phone" -> "1234567890"
+//          "createdAt" -> "2021-01-01T00:00:00.000Z"
+export function generateProp(propName, propType) {
+    for (const [pattern, generator] of NAME_PATTERNS) {
+        if (pattern.test(propName)) {
+            return generator();
+        }
+    }
+    const fallback = TYPE_FALLBACKS[propType];
+    if (fallback !== undefined) {
+        return fallback();
+    }
+    return faker.lorem.word();
+}
+//# sourceMappingURL=propGenerator.js.map

package/dist/utils/propGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propGenerator.js","sourceRoot":"","sources":["../../src/utils/propGenerator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "create-mock-api-from-types",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Generate a mock REST API server from TypeScript interfaces",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mock-api": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mock",
+    "api",
+    "faker",
+    "typescript",
+    "rest",
+    "testing"
+  ],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.5.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@faker-js/faker": "^10.3.0",
+    "commander": "^14.0.3",
+    "express": "^5.2.1",
+    "ts-morph": "^27.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "chmod +x dist/cli.js",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}