typescript-mock-server 0.0.5 → 0.0.8

package/README.md

@@ -1,10 +1,76 @@
 # Typescript mock server
-Simple mock server that can be used in front end development. Instead of creating json files you can just publish TypeScript objects as json. 
+Simple mock/stub server that can be used in front end development. Instead of creating json files you can just publish TypeScript objects as json. 
 This makes it easier to maintain your mocks because you can load your own models. When you change your implementation you also 
-have to update your mock, otherwise you will receive compile errors. 
+have to update your mock, otherwise you will receive compile errors.
 
-# Dependencies
+# Quickstart
+The easiest way to check out this stub/mock server is by installing it as a (dev)dependency and then 
+add a script to you scripts section: `cd node_modules/typescript-mock-server && npm run start -- --path=../../path-to-your-model-directory`. 
+Please note we are changing the directory and therefore, to set the path parameter, you need to go 2 levels up to be in your root. 
+I am looking for a cleaner way of doing this. Your models should export a data const and your file should be named as `^(get|post){1}(-\d)?.ts$`. 
+Changes are being picked up automatically, so no need for a restart.
 
+Check out the [working example project](https://github.com/GuyT07/typescript-mock-server-examle) and source [the examples](https://github.com/GuyT07/typescript-mock-server/tree/main/tms-models/users).
 
+# Options
+`--port=x`: Port number the server runs on
+`--path=x`: Path to your models
+
+## Adding GET mocks/stubs
+Examples talk, so lets start with an example.
+
+Your requirement is to have the following endpoints `/users`, `/users/1` and `/users/profile/1`
+
+Create a root folder that contains your models, like `models`. Then add a folder `users` and within the newly created folder 
+create a new folder `profile`. Add following files `get.ts` and `get-1.ts` in the `users` directory, `get-1.ts` in the `profile` dir. You should 
+have the following structure:
+
+```
+--models
+    -- users
+       - get.ts
+       - get-1.ts
+    -- profile
+       - get-1.ts
+```
+
+Within the model file you can import/create your model:
+
+```
+export interface User {
+    id: number;
+    firstName: string;
+    lastName: string;
+    creationDate: Date;
+}
+
+const newDate = () => new Date();
+
+export const data: User[] = [{
+    id: 1,
+    firstName: 'Guy',
+    lastName: 'Theuws',
+    creationDate:  newDate()
+}, {
+    id: 2,
+    firstName: 'Generation Y',
+    lastName: 'Development',
+    creationDate:  newDate()
+}];
+```
+
+## Dependencies
+Following dependencies are being used:
+
+- express
+- ts-node-dev
+- typescript
+- @types/express
+- @types/node
+
+## Roadmap
+- [x] Support other server port
+- [ ] Improve paths/way to start
+- [ ] Support different headers
+- [ ] Support all HTTP methods
 
-# 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "typescript-mock-server",
-  "version": "0.0.5",
+  "version": "0.0.8",
   "description": "Simple mock server that can be used in front end development. Instead of creating json files you can just publish TypeScript objects as json",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
-    "example": "ts-node-dev src/index.ts --path=tms-models",
+    "example": "ts-node-dev src/index.ts --path=tms-models --port=5000",
     "start": "ts-node-dev src/index.ts"
   },
   "repository": {

package/src/index.js

@@ -0,0 +1,133 @@
+#!./../node_modules/.bin/ts-node-dev
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const fs = __importStar(require("fs"));
+const baseDirPath = process.cwd();
+console.log(baseDirPath);
+const argv = (() => {
+    const args = {};
+    process.argv.slice(2).map((element) => {
+        const matches = element.match('--([a-zA-Z0-9]+)=(.*)');
+        if (matches) {
+            // @ts-ignore
+            args[matches[1]] = matches[2]
+                .replace(/^['"]/, '').replace(/['"]$/, '');
+        }
+    });
+    return args;
+})();
+console.log(argv);
+// Create a new express app instance
+const app = (0, express_1.default)();
+// @ts-ignore
+const args = argv['path'];
+// @ts-ignore
+const basePath = `${baseDirPath}/${args}`;
+console.log('basePath:' + basePath);
+function print(path) {
+    var e_1, _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log(path);
+        const dir = yield fs.promises.opendir(path);
+        try {
+            for (var dir_1 = __asyncValues(dir), dir_1_1; dir_1_1 = yield dir_1.next(), !dir_1_1.done;) {
+                const dirent = dir_1_1.value;
+                if (dirent.isDirectory()) {
+                    yield print(`${path}/${dirent.name}`);
+                }
+                else {
+                    handleFile(path, dirent);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (dir_1_1 && !dir_1_1.done && (_a = dir_1.return)) yield _a.call(dir_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    });
+}
+print(basePath).catch(console.error);
+function loadModule(moduleName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return yield Promise.resolve().then(() => __importStar(require(moduleName)));
+    });
+}
+app.listen(3000, function () {
+    console.log('App is listening on port 3000!');
+});
+function handleFile(path, dirent) {
+    console.log('File name: ' + dirent.name);
+    if (dirent.name.startsWith('get')) {
+        handleGetRequest(path, dirent);
+    }
+}
+function addEndpoint(endpoint, model) {
+    app.get(endpoint, function (req, res) {
+        res.send(model.data);
+    });
+}
+function handleGetRequest(path, dirent) {
+    console.log('Adding GET request');
+    const endpoint = convertFileNameToEndpoint(path, dirent);
+    console.log('Endpoint: ' + endpoint);
+    const modulePath = `${path}/${dirent.name}`;
+    console.log('Resolve module: ' + modulePath);
+    loadModule(modulePath)
+        .then(model => addEndpoint(endpoint, model))
+        .catch(err => console.error(err));
+}
+function convertFileNameToEndpoint(path, dirent) {
+    let endpoint = `${path.replace(basePath, '')}/${dirent.name}`;
+    endpoint = endpoint.replace('.ts', '');
+    endpoint = endpoint.replace('get', '');
+    if (endpoint !== '') {
+        endpoint = endpoint.replace('-', '');
+    }
+    return endpoint;
+}

package/src/index.ts

@@ -1,90 +1,88 @@
-#!./../node_modules/.bin/ts-node-dev
+#!./node_modules/.bin/ts-node-dev
 
-import express from 'express';
-import { Express } from 'express';
+import express, { Express } from 'express';
 import * as fs from 'fs';
 
-    const baseDirPath = process.cwd()
-    console.log(baseDirPath);
-
-    const argv = (() => {
-        const args = {};
-        process.argv.slice(2).map((element) => {
-            const matches = element.match('--([a-zA-Z0-9]+)=(.*)');
-            if (matches) {
-                // @ts-ignore
-                args[matches[1]] = matches[2]
-                  .replace(/^['"]/, '').replace(/['"]$/, '');
-            }
-        });
-        return args;
-    })();
+const baseDirPath = process.cwd();
+console.log(baseDirPath);
+
+const argv: { [key: string]: string } = (() => {
+  const args = {};
+  process.argv.slice(2).map((element) => {
+    const matches = element.match('--([a-zA-Z0-9]+)=(.*)');
+    if (matches) {
+      // @ts-ignore
+      args[matches[1]] = matches[2]
+        .replace(/^['"]/, '').replace(/['"]$/, '');
+    }
+  });
+  return args;
+})();
 
-    console.log(argv);
+console.log(argv);
 
 // Create a new express app instance
-    const app: Express = express();
+const app: Express = express();
 
-// @ts-ignore
-    const args = argv['path'];
+const {path, port} = argv;
 
 // @ts-ignore
-    const basePath = `${baseDirPath}/${args}`;
-
-    console.log('basePath:' + basePath);
-
-    async function print(path: string) {
-        console.log(path);
-        const dir = await fs.promises.opendir(path);
-        for await (const dirent of dir) {
-            if (dirent.isDirectory()) {
-                await print(`${path}/${dirent.name}`);
-            } else {
-                handleFile(path, dirent);
-            }
-        }
+const basePath = `${baseDirPath}/${path}`;
+
+console.log('basePath:' + basePath);
+
+async function print(path: string) {
+  console.log(path);
+  const dir = await fs.promises.opendir(path);
+  for await (const dirent of dir) {
+    if (dirent.isDirectory()) {
+      await print(`${path}/${dirent.name}`);
+    } else {
+      handleFile(path, dirent);
     }
+  }
+}
 
-    print(basePath).catch(console.error);
+print(basePath).catch(console.error);
 
-    async function loadModule(moduleName: string) {
-        return await import(moduleName);
-    }
+async function loadModule(moduleName: string) {
+  return await import(moduleName);
+}
 
-    app.listen(3000, function() {
-        console.log('App is listening on port 3000!');
-    });
+app.listen(port || 3000, function() {
+  console.log(`App is listening on port ${port || 3000}!`);
+});
 
-    function handleFile(path: string, dirent: fs.Dirent) {
-        console.log('File name: ' + dirent.name);
-        if (dirent.name.startsWith('get')) {
-            handleGetRequest(path, dirent);
-        }
-    }
+function handleFile(path: string, dirent: fs.Dirent) {
+  console.log('File name: ' + dirent.name);
+  if (dirent.name.startsWith('get')) {
+    handleGetRequest(path, dirent);
+  }
+}
 
-    function addEndpoint(endpoint: string, model: any) {
-        app.get(endpoint, function(req, res) {
-            res.send(model.data)
-        });
-    }
+function addEndpoint(endpoint: string, model: any) {
+  app.get(endpoint, function(req, res) {
+    res.send(model.data);
+  });
+}
 
-    function handleGetRequest(path: string, dirent: fs.Dirent) {
-        console.log('Adding GET request');
-        const endpoint = convertFileNameToEndpoint(path, dirent);
-        console.log('Endpoint: ' + endpoint);
-        const modulePath = `${path}/${dirent.name}`;
-        console.log('Resolve module: ' + modulePath);
-        loadModule(modulePath)
-          .then(model => addEndpoint(endpoint, model))
-          .catch(err => console.error(err));
-    }
+function handleGetRequest(path: string, dirent: fs.Dirent) {
+  console.log('Adding GET request');
+  const endpoint = convertFileNameToEndpoint(path, dirent);
+  console.log('Endpoint: ' + endpoint);
+  const modulePath = `${path}/${dirent.name}`;
+  console.log('Resolve module: ' + modulePath);
+  loadModule(modulePath)
+    .then(model => addEndpoint(endpoint, model))
+    .catch(err => console.error(err));
+}
 
-    function convertFileNameToEndpoint(path: string, dirent: fs.Dirent): string {
-        let endpoint = `${path.replace(basePath, '')}/${dirent.name}`;
-        endpoint = endpoint.replace('.ts', '');
-        endpoint = endpoint.replace('get', '');
-        if (endpoint !== '') {
-            endpoint = endpoint.replace('-', '');
-        }
-        return endpoint;
+function convertFileNameToEndpoint(path: string, dirent: fs.Dirent): string {
+  let endpoint = `${path.replace(basePath, '')}/${dirent.name}`;
+  endpoint = endpoint.replace('.ts', '');
+  endpoint = endpoint.replace('get', '');
+  if (endpoint !== '') {
+    endpoint = endpoint.replace('-', '');
+  }
+  return endpoint;
 }

package/tms-models/users/get-1.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.data = void 0;
+exports.data = {
+    id: 1,
+    firstName: 'Guy',
+    lastName: 'Theuws'
+};

package/tms-models/users/get.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.data = exports.newDate = void 0;
+const newDate = () => new Date();
+exports.newDate = newDate;
+exports.data = [{
+        id: 1,
+        firstName: 'Guy',
+        lastName: 'Theuws',
+        creationDate: (0, exports.newDate)()
+    }, {
+        id: 2,
+        firstName: 'Generation Y',
+        lastName: 'Development',
+        creationDate: (0, exports.newDate)()
+    }];

package/tms-models/users/get.ts

@@ -2,16 +2,19 @@ export interface User {
     id: number;
     firstName: string;
     lastName: string;
+    creationDate:  Date;
 }
 
-const myNewMethod = () => new Date();
+export const newDate = () => new Date();
 
 export const data: User[] = [{
     id: 1,
     firstName: 'Guy',
-    lastName: 'Theuws'
+    lastName: 'Theuws',
+    creationDate:  newDate()
 }, {
     id: 2,
     firstName: 'Generation Y',
-    lastName: 'Development'
+    lastName: 'Development',
+    creationDate:  newDate()
 }];

package/tms-models/users/profile/get-1.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.data = void 0;
+const get_1 = require("../get");
+exports.data = {
+    id: 1, title: 'Hello profile', user: {
+        id: 1,
+        firstName: 'Guy',
+        lastName: 'Theuws',
+        creationDate: (0, get_1.newDate)()
+    }
+};

package/tms-models/users/profile/get-1.ts

@@ -1,4 +1,4 @@
-import { User } from '../get';
+import { newDate, User } from '../get';
 
 interface Profile {
     id: number;
@@ -10,6 +10,7 @@ export const data: Profile = {
     id: 1, title: 'Hello profile', user: {
         id: 1,
         firstName: 'Guy',
-        lastName: 'Theuws'
+        lastName: 'Theuws',
+        creationDate: newDate()
     }
 };

package/nodemon.json

@@ -1,9 +0,0 @@
-{
-  "watch": [
-    "src",
-    "tms-models"
-  ],
-  "ext": ".ts,.js",
-  "ignore": [],
-  "exec": "ts-node ./src/index.ts"
-}