typescript-mock-server 0.0.11 → 1.0.0

package/README.md

@@ -58,6 +58,13 @@ export const data: User[] = [{
     lastName: 'Development',
     creationDate:  newDate()
 }];
+
+export const config: Config = {
+    server: {
+        delay: 2000,
+        statusCode: 418
+    }
+}
 ```
 
 ## Dependencies
@@ -72,19 +79,20 @@ Following dependencies are being used:
 ## Roadmap
 - [x] Support other server port
 - [x] Improve paths/way to start
-- [ ] Support different headers/configurations (delays, status codes, ...)
+- [x] Support different headers/configurations (delays, status codes, ...)
 - [x] Support most used HTTP methods
 - [ ] Add tests
-- [ ] Refactor, split up in separate classes (first check if people actually want to use the tool)
+- [x] Refactor, split up in separate classes (first check if people actually want to use the tool)
 - [ ] Setup CI/CD (+code quality + coverage tooling)
 - [ ] Setup website
 - [ ] Create a JVM compatible version
-- [ ] Create interface to force implementation of required properties and make it more stable
-- [ ] Improve error handling (missing properties etc.)
+- [x] Create interface to force implementation of required properties and make it more stable
+- [x] Improve error handling (missing properties etc.)
 - [ ] Create an optional persistent state
 
 
 ## Release notes (will be moved to GitHub in the future)
+- v1.0.0 - Breaking change: renamed Server config to Request and added interval for delay
 - v0.0.11 - Add items to roadmap, bug fixes
 - v0.0.10 - Support multiple http verbs
 

package/package.json

@@ -1,35 +1,44 @@
 {
   "name": "typescript-mock-server",
-  "version": "0.0.11",
+  "version": "1.0.0",
   "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 --port=5000",
-    "start": "ts-node-dev src/index.ts"
+    "start": "ts-node-dev src/index.ts",
+    "update-deps": "npm update",
+    "get-version": "echo $npm_package_version",
+    "publish-to-npm": "git tag -a ${npm_package_version} -m \"v${npm_package_version}\" && npm publish"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/GuyT07/typescript-mock-server.git"
   },
-  "keywords": ["mock server", "testing", "stub", "typescript"],
+  "keywords": [
+    "mock server",
+    "testing",
+    "stub",
+    "typescript"
+  ],
   "author": "Guy Theuws",
   "license": "ISC",
   "bugs": {
     "url": "https://github.com/GuyT07/typescript-mock-server/issues"
   },
-  "homepage": "https://github.com/GuyT07/typescript-mock-server#readme",
+  "homepage": "https://genydev.nl",
   "funding": {
-    "url" : "https://genydev.nl"
+    "url": "https://genydev.nl"
   },
   "devDependencies": {
     "prettier": "^2.6.2"
   },
   "dependencies": {
-    "express": "^4.17.3",
-    "ts-node-dev": "^1.1.8",
-    "typescript": "^4.0.5",
-    "@types/express": "^4.17.9",
-    "@types/node": "^14.18.12"
+    "@types/express": "^4.17.13",
+    "@types/node": "^18.0.5",
+    "express": "^4.18.1",
+    "ts-node-dev": "2.0.0",
+    "tslog": "^3.3.3",
+    "typescript": "^4.7.4"
   },
   "prettier": {
     "arrowParens": "avoid",

package/src/command-line.ts

@@ -0,0 +1,9 @@
+export interface CommandLine {
+  getCommands(): Map<Command, string>;
+  getCommand(command: Command): string | undefined;
+}
+
+export enum Command {
+  PATH = 'path',
+  PORT = 'port'
+}

package/src/impl/command-line-impl.ts

@@ -0,0 +1,33 @@
+import { Command, CommandLine } from '../command-line';
+import { Logger } from '../logger';
+import { LoggerImpl } from './logger-impl';
+
+export class CommandLineImpl implements CommandLine {
+
+  private arguments: Map<Command, string> = new Map<Command, string>();
+  private log: Logger = new LoggerImpl();
+
+  constructor() {
+    this.parseCommandLineArguments();
+  }
+
+  getCommands(): Map<Command, string> {
+    return this.arguments;
+  }
+
+  getCommand(command: Command): string | undefined {
+    return this.arguments.get(command);
+  }
+
+  private parseCommandLineArguments(): void {
+    process.argv.slice(2).map((element) => {
+      const matches = element.match('--([a-zA-Z0-9]+)=(.*)');
+      if (matches) {
+        const value = matches[2].replace(/^['"]/, '').replace(/['"]$/, '');
+        this.arguments.set(matches[1] as Command, value);
+      }
+    });
+
+    this.log.debug(`Passed arguments ${[...this.arguments.keys()].join(',')}`);
+  }
+}

package/src/impl/logger-impl.ts

@@ -0,0 +1,39 @@
+import { Logger as LoggerInterface } from '../logger';
+import { Logger } from 'tslog';
+
+export class LoggerImpl implements LoggerInterface {
+
+  private readonly log: Logger;
+
+  constructor() {
+    this.log = new Logger({ignoreStackLevels: 4, displayFunctionName: false});
+  }
+
+  private static getArgumentsToPass(args: unknown[]): unknown | unknown[] {
+    return LoggerImpl.getNumberOfArguments(args) === 1 ? args[0] : args;
+  }
+
+  private static getNumberOfArguments(args: unknown[]): number {
+    return args.length;
+  }
+
+  debug(...args: unknown[]): void {
+    this.log.debug(LoggerImpl.getArgumentsToPass(args));
+  }
+
+  error(...args: unknown[]): void {
+    this.log.error(LoggerImpl.getArgumentsToPass(args));
+  }
+
+  trace(...args: unknown[]): void {
+    this.log.trace(LoggerImpl.getArgumentsToPass(args));
+  }
+
+  warn(...args: unknown[]): void {
+    this.log.warn(LoggerImpl.getArgumentsToPass(args));
+  }
+
+  info(...args: unknown[]): void {
+    this.log.info(LoggerImpl.getArgumentsToPass(args));
+  }
+}

package/src/impl/typescript-mock-server-impl.ts

@@ -0,0 +1,105 @@
+import express, { Express } from 'express';
+import { CommandLineImpl } from './command-line-impl';
+import { Command, CommandLine } from '../command-line';
+import { RegisteredEndpoint } from '../models/registered-endpoint';
+import { HttpVerb } from '../types/http-verbs';
+import { Dirent } from 'fs';
+import { opendir } from 'fs/promises';
+import { LoggerImpl } from './logger-impl';
+import { Logger } from '../logger';
+import { TypescriptMockServer } from '../typescript-mock-server';
+import { Interval } from '../models/config';
+
+export class TypescriptMockServerImpl implements TypescriptMockServer{
+
+  private readonly log: Logger = new LoggerImpl();
+  private readonly commandLine: CommandLine = new CommandLineImpl();
+  private readonly app: Express;
+  private readonly basePath;
+  private registeredEndpoints: RegisteredEndpoint[] = [];
+
+  constructor() {
+    this.app = express();
+    this.basePath = this.getPath();
+  }
+
+  private static async loadModule(moduleName: string) {
+    return await import(moduleName);
+  }
+
+  public start() {
+    this.log.info(`basePath: ${this.basePath}`);
+    this.readRoutes(this.basePath).catch(error => this.log.error(error));
+    const port = this.commandLine.getCommand(Command.PORT) || 3000;
+    this.app.listen(port, () => {
+      this.log.info(`App is listening on port ${port}!`);
+    });
+  }
+
+  private async readRoutes(path: string) {
+    const dir = await opendir(path);
+    for await (const dirent of dir) {
+      if (dirent.isDirectory()) {
+        await this.readRoutes(`${path}/${dirent.name}`);
+      } else {
+        this.handleFile(path, dirent);
+      }
+    }
+    this.registeredEndpoints.forEach(endpoint => this.log.info(`${endpoint.httpVerb.toUpperCase()}   http://localhost:${this.commandLine.getCommand(Command.PORT)}${endpoint.endpoint}`));
+  }
+
+  private handleFile(path: string, dirent: Dirent) {
+    const httpVerb = (dirent.name.indexOf('-') > -1 ? dirent.name.split('-')[0] : dirent.name.split('.')[0]) as HttpVerb;
+    this.handleRequest(path, dirent, httpVerb);
+  }
+
+  private addEndpoint(endpoint: string, httpVerb: HttpVerb, model: any) {
+    this.app[httpVerb](endpoint, (req, res) => {
+      if (model?.config?.statusCode) {
+        res.statusCode = model?.config?.statusCode;
+      }
+      if (model?.config?.delay) {
+        setTimeout(() => res.send(model.data), this.getDelayValue(model?.config?.delay));
+      } else {
+        return res.send(model.data);
+      }
+    });
+  }
+
+  private getDelayValue(delay: number | Interval): number {
+    if (typeof delay === 'number') {
+      return delay;
+    } else if (delay.min && delay.max) {
+      return Math.floor(delay.min + Math.random() * delay.max);
+    }
+    return 0;
+  }
+
+  private handleRequest(path: string, dirent: Dirent, httpVerb: HttpVerb) {
+    const endpoint = this.convertFileNameToEndpoint(path, dirent, httpVerb);
+    const modulePath = `${path}/${dirent.name}`;
+    this.registeredEndpoints.push({ httpVerb, endpoint });
+    TypescriptMockServerImpl.loadModule(modulePath)
+      .then(model => this.addEndpoint(endpoint, httpVerb, model))
+      .catch(error => this.log.error(error));
+  }
+
+  private convertFileNameToEndpoint(path: string, dirent: Dirent, httpVerb: HttpVerb): string {
+    const endpoint = `${path.replace(this.basePath, '')}/${dirent.name}`
+      .replace('.ts', '')
+      .replace(httpVerb, '')
+      .replace('-', '');
+    if (endpoint.endsWith('/')) {
+      return endpoint.substring(0, endpoint.length - 1);
+    }
+    return endpoint;
+  }
+
+  private getPath(): string {
+    if (!this.commandLine.getCommands().has(Command.PATH)) {
+      this.log.warn(`Path parameter not set, fallback to default tms-models`);
+      return 'tms-models';
+    }
+    return `${process.cwd()}/${this.commandLine.getCommand(Command.PATH)}`;
+  }
+}

package/src/index.ts

@@ -1,88 +1,8 @@
 #!./node_modules/.bin/ts-node-dev
 
-import express, { Express } from 'express';
-import * as fs from 'fs';
+import { TypescriptMockServer } from './typescript-mock-server';
+import { TypescriptMockServerImpl } from './impl/typescript-mock-server-impl';
 
-type HttpVerb = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
+const server: TypescriptMockServer = new TypescriptMockServerImpl();
 
-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(`Passed arguments %o`, argv);
-
-// Create a new express app instance
-const app: Express = express();
-
-const { path, port } = argv;
-
-const basePath = `${process.cwd()}/${path}`;
-
-interface RegisteredEndpoint {
-  httpVerb: string;
-  endpoint: string;
-}
-
-const registeredEndpoints: RegisteredEndpoint[] = [];
-
-console.log('basePath:' + basePath);
-
-async function readRoutes(path: string) {
-  const dir = await fs.promises.opendir(path);
-  for await (const dirent of dir) {
-    if (dirent.isDirectory()) {
-      await readRoutes(`${path}/${dirent.name}`);
-    } else {
-      handleFile(path, dirent);
-    }
-  }
-  registeredEndpoints.forEach(endpoint => console.log(`${endpoint.httpVerb.toUpperCase()}   http://localhost:${port}${endpoint.endpoint}`))
-}
-
-readRoutes(basePath).catch(console.error);
-
-app.listen(port || 3000, function() {
-  console.log(`App is listening on port ${port || 3000}!`);
-});
-
-async function loadModule(moduleName: string) {
-  return await import(moduleName);
-}
-
-function handleFile(path: string, dirent: fs.Dirent) {
-  const httpVerb = (dirent.name.indexOf('-') > -1 ? dirent.name.split('-')[0] : dirent.name.split('.')[0]) as HttpVerb;
-  handleRequest(path, dirent, httpVerb);
-}
-
-function addEndpoint(endpoint: string, httpVerb: HttpVerb, model: any) {
-  app[httpVerb](endpoint, (req, res) => res.send(model.data));
-}
-
-function handleRequest(path: string, dirent: fs.Dirent, httpVerb: HttpVerb) {
-  const endpoint = convertFileNameToEndpoint(path, dirent, httpVerb);
-  const modulePath = `${path}/${dirent.name}`;
-  registeredEndpoints.push({httpVerb, endpoint});
-  loadModule(modulePath)
-    .then(model => addEndpoint(endpoint, httpVerb, model))
-    .catch(err => console.error(err));
-}
-
-function convertFileNameToEndpoint(path: string, dirent: fs.Dirent, httpVerb: HttpVerb): string {
-  const endpoint = `${path.replace(basePath, '')}/${dirent.name}`
-    .replace('.ts', '')
-    .replace(httpVerb, '')
-    .replace('-', '');
-  if (endpoint.endsWith('/')) {
-    return endpoint.substring(0, endpoint.length - 1);
-  }
-  return endpoint;
-}
+server.start();

package/src/logger.ts

@@ -0,0 +1,7 @@
+export interface Logger {
+  debug(...args: unknown[]): void;
+  trace(...args: unknown[]): void;
+  warn(...args: unknown[]): void;
+  error(...args: unknown[]): void;
+  info(...args: unknown[]): void
+}

package/src/models/config.ts

@@ -0,0 +1,13 @@
+export interface DefaultConfig {
+  request: RequestConfig;
+}
+
+export interface RequestConfig {
+  delay?: number | Interval; // Delay response (in ms), or an interval
+  statusCode?: number; // Status code of response
+}
+
+export interface Interval {
+  min: number; // Minimum boundary, including the value
+  max: number; // Maximum boundary, including the value
+}

package/src/models/registered-endpoint.ts

@@ -0,0 +1,4 @@
+export interface RegisteredEndpoint {
+  httpVerb: string;
+  endpoint: string;
+}

package/src/types/http-verbs.ts

@@ -0,0 +1 @@
+export type HttpVerb = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';

package/src/typescript-mock-server.ts

@@ -0,0 +1,3 @@
+export interface TypescriptMockServer {
+  start(): void;
+}

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

@@ -1,11 +1,20 @@
+import { RequestConfig } from '../../src/models/config';
+
 interface User {
-    id: number;
-    firstName: string;
-    lastName: string;
+  id: number;
+  firstName: string;
+  lastName: string;
 }
 
 export const data: User = {
-    id: 1,
-    firstName: 'Guy',
-    lastName: 'Theuws'
+  id: 1,
+  firstName: 'Guy',
+  lastName: 'Theuws',
+};
+
+export const config: RequestConfig = {
+  delay: {
+    min: 1000,
+    max: 5000,
+  },
 };

package/tms-models/users/get.ts

@@ -1,3 +1,5 @@
+import { RequestConfig } from '../../src/models/config';
+
 export interface User {
     id: number;
     firstName: string;
@@ -18,3 +20,8 @@ export const data: User[] = [{
     lastName: 'Development',
     creationDate:  newDate()
 }];
+
+export const config: RequestConfig = {
+    delay: 2000,
+    statusCode: 418
+}