express-generator-typescript 2.7.11 → 2.7.12

package/lib/project-files/src/repos/UserRepo.ts

@@ -1,133 +1,133 @@
-import { IUser } from '@src/models/User';
-import { getRandomInt } from '@src/common/utils/misc';
-
-import orm from './MockOrm';
-
-/******************************************************************************
-                                Functions
-******************************************************************************/
-
-/**
- * Get one user.
- */
-async function getOne(email: string): Promise<IUser | null> {
-  const db = await orm.openDb();
-  for (const user of db.users) {
-    if (user.email === email) {
-      return user;
-    }
-  }
-  return null;
-}
-
-/**
- * See if a user with the given id exists.
- */
-async function persists(id: number): Promise<boolean> {
-  const db = await orm.openDb();
-  for (const user of db.users) {
-    if (user.id === id) {
-      return true;
-    }
-  }
-  return false;
-}
-
-/**
- * Get all users.
- */
-async function getAll(): Promise<IUser[]> {
-  const db = await orm.openDb();
-  return db.users;
-}
-
-/**
- * Add one user.
- */
-async function add(user: IUser): Promise<void> {
-  const db = await orm.openDb();
-  user.id = getRandomInt();
-  db.users.push(user);
-  return orm.saveDb(db);
-}
-
-/**
- * Update a user.
- */
-async function update(user: IUser): Promise<void> {
-  const db = await orm.openDb();
-  for (let i = 0; i < db.users.length; i++) {
-    if (db.users[i].id === user.id) {
-      const dbUser = db.users[i];
-      db.users[i] = {
-        ...dbUser,
-        name: user.name,
-        email: user.email,
-      };
-      return orm.saveDb(db);
-    }
-  }
-}
-
-/**
- * Delete one user.
- */
-async function __delete__(id: number): Promise<void> {
-  const db = await orm.openDb();
-  for (let i = 0; i < db.users.length; i++) {
-    if (db.users[i].id === id) {
-      db.users.splice(i, 1);
-      return orm.saveDb(db);
-    }
-  }
-}
-
-// **** Unit-Tests Only **** //
-
-/**
- * Delete every user record.
- * 
- * @internal
- * Test-only helper. Do not use in production code.
- */
-async function deleteAllUsers(): Promise<void> {
-  const db = await orm.openDb();
-  db.users = [];
-  return orm.saveDb(db);
-}
-
-/**
- * Insert multiple users. Can't do multiple at once cause using a plain file 
- * for now.
- * 
- * @internal
- * Test-only helper. Do not use in production code.
- */
-async function insertMultiple(
-  users: IUser[] | readonly IUser[],
-): Promise<IUser[]> {
-  const db = await orm.openDb(),
-    usersF = [ ...users ];
-  for (const user of usersF) {
-    user.id = getRandomInt();
-    user.created = new Date();
-  }
-  db.users = [ ...db.users, ...users ];
-  await orm.saveDb(db);
-  return usersF;
-}
-
-/******************************************************************************
-                                Export default
-******************************************************************************/
-
-export default {
-  getOne,
-  persists,
-  getAll,
-  add,
-  update,
-  delete: __delete__,
-  deleteAllUsers,
-  insertMultiple,
-} as const;
+import { getRandomInt } from '@src/common/utils/number-utils';
+import { IUser } from '@src/models/User';
+
+import orm from './MockOrm';
+
+/******************************************************************************
+                                Functions
+******************************************************************************/
+
+/**
+ * Get one user.
+ */
+async function getOne(email: string): Promise<IUser | null> {
+  const db = await orm.openDb();
+  for (const user of db.users) {
+    if (user.email === email) {
+      return user;
+    }
+  }
+  return null;
+}
+
+/**
+ * See if a user with the given id exists.
+ */
+async function persists(id: number): Promise<boolean> {
+  const db = await orm.openDb();
+  for (const user of db.users) {
+    if (user.id === id) {
+      return true;
+    }
+  }
+  return false;
+}
+
+/**
+ * Get all users.
+ */
+async function getAll(): Promise<IUser[]> {
+  const db = await orm.openDb();
+  return db.users;
+}
+
+/**
+ * Add one user.
+ */
+async function add(user: IUser): Promise<void> {
+  const db = await orm.openDb();
+  user.id = getRandomInt();
+  db.users.push(user);
+  return orm.saveDb(db);
+}
+
+/**
+ * Update a user.
+ */
+async function update(user: IUser): Promise<void> {
+  const db = await orm.openDb();
+  for (let i = 0; i < db.users.length; i++) {
+    if (db.users[i].id === user.id) {
+      const dbUser = db.users[i];
+      db.users[i] = {
+        ...dbUser,
+        name: user.name,
+        email: user.email,
+      };
+      return orm.saveDb(db);
+    }
+  }
+}
+
+/**
+ * Delete one user.
+ */
+async function __delete__(id: number): Promise<void> {
+  const db = await orm.openDb();
+  for (let i = 0; i < db.users.length; i++) {
+    if (db.users[i].id === id) {
+      db.users.splice(i, 1);
+      return orm.saveDb(db);
+    }
+  }
+}
+
+// **** Unit-Tests Only **** //
+
+/**
+ * Delete every user record.
+ *
+ * @internal
+ * Test-only helper. Do not use in production code.
+ */
+async function deleteAllUsers(): Promise<void> {
+  const db = await orm.openDb();
+  db.users = [];
+  return orm.saveDb(db);
+}
+
+/**
+ * Insert multiple users. Can't do multiple at once cause using a plain file
+ * for now.
+ *
+ * @internal
+ * Test-only helper. Do not use in production code.
+ */
+async function insertMultiple(
+  users: IUser[] | readonly IUser[],
+): Promise<IUser[]> {
+  const db = await orm.openDb(),
+    usersF = [...users];
+  for (const user of usersF) {
+    user.id = getRandomInt();
+    user.created = new Date();
+  }
+  db.users = [...db.users, ...users];
+  await orm.saveDb(db);
+  return usersF;
+}
+
+/******************************************************************************
+                                Export default
+******************************************************************************/
+
+export default {
+  getOne,
+  persists,
+  getAll,
+  add,
+  update,
+  delete: __delete__,
+  deleteAllUsers,
+  insertMultiple,
+} as const;

package/lib/project-files/src/repos/common/database.test.json

@@ -0,0 +1,22 @@
+{
+  "users": [
+    {
+      "id": 547317739445,
+      "name": "Bill",
+      "email": "sean.maxwell@gmail.com",
+      "created": "2026-01-10T04:06:20.291Z"
+    },
+    {
+      "id": 332906029656,
+      "name": "John Smith",
+      "email": "john.smith@gmail.com",
+      "created": "2026-01-10T04:06:20.291Z"
+    },
+    {
+      "id": 421195709596,
+      "name": "Gordan Freeman",
+      "email": "gordan.freeman@gmail.com",
+      "created": "2026-01-10T04:06:20.291Z"
+    }
+  ]
+}

package/lib/project-files/src/routes/UserRoutes.ts

@@ -1,69 +1,77 @@
-import { isNumber } from 'jet-validators';
-import { transform } from 'jet-validators/utils';
-
-import HttpStatusCodes from '@src/common/constants/HttpStatusCodes';
-import UserService from '@src/services/UserService';
-import User from '@src/models/User';
-
-import { IReq, IRes } from './common/types';
-import { parseReq } from './common/utils';
-
-/******************************************************************************
-                                Constants
-******************************************************************************/
-
-const Validators = {
-  add: parseReq({ user: User.isComplete }),
-  update: parseReq({ user: User.isComplete }),
-  delete: parseReq({ id: transform(Number, isNumber) }),
-} as const;
-
-/******************************************************************************
-                                Functions
-******************************************************************************/
-
-/**
- * Get all users.
- */
-async function getAll(_: IReq, res: IRes) {
-  const users = await UserService.getAll();
-  res.status(HttpStatusCodes.OK).json({ users });
-}
-
-/**
- * Add one user.
- */
-async function add(req: IReq, res: IRes) {
-  const { user } = Validators.add(req.body);
-  await UserService.addOne(user);
-  res.status(HttpStatusCodes.CREATED).end();
-}
-
-/**
- * Update one user.
- */
-async function update(req: IReq, res: IRes) {
-  const { user } = Validators.update(req.body);
-  await UserService.updateOne(user);
-  res.status(HttpStatusCodes.OK).end();
-}
-
-/**
- * Delete one user.
- */
-async function __delete__(req: IReq, res: IRes) {
-  const { id } = Validators.delete(req.params);
-  await UserService.delete(id);
-  res.status(HttpStatusCodes.OK).end();
-}
-
-/******************************************************************************
-                                Export default
-******************************************************************************/
-
-export default {
-  getAll,
-  add,
-  update,
-  delete: __delete__,
-} as const;
+import { isNumber } from 'jet-validators';
+import { transform } from 'jet-validators/utils';
+
+import HttpStatusCodes from '@src/common/constants/HttpStatusCodes';
+import User from '@src/models/User';
+import UserService from '@src/services/UserService';
+
+import { IReq, IRes } from './common/express-types';
+import parseReq from './common/parseReq';
+
+/******************************************************************************
+                                Constants
+******************************************************************************/
+
+const Validators = {
+  add: parseReq({ user: User.isComplete }),
+  update: parseReq({ user: User.isComplete }),
+  delete: parseReq({ id: transform(Number, isNumber) }),
+} as const;
+
+/******************************************************************************
+                                Functions
+******************************************************************************/
+
+/**
+ * Get all users.
+ *
+ * @route GET /api/users/all
+ */
+async function getAll(_: IReq, res: IRes) {
+  const users = await UserService.getAll();
+  res.status(HttpStatusCodes.OK).json({ users });
+}
+
+/**
+ * Add one user.
+ *
+ * @route POST /api/users/add
+ */
+async function add(req: IReq, res: IRes) {
+  const { user } = Validators.add(req.body);
+  await UserService.addOne(user);
+  res.status(HttpStatusCodes.CREATED).end();
+}
+
+/**
+ * Update one user.
+ *
+ * @route PUT /api/users/update
+ */
+async function update(req: IReq, res: IRes) {
+  const { user } = Validators.update(req.body);
+  await UserService.updateOne(user);
+  res.status(HttpStatusCodes.OK).end();
+}
+
+/**
+ * Delete one user.
+ *
+ * @route DELETE /api/users/delete/:id
+ */
+async function __delete__(req: IReq, res: IRes) {
+  const { id } = Validators.delete(req.params);
+  await UserService.delete(id);
+  res.status(HttpStatusCodes.OK).end();
+}
+
+/******************************************************************************
+                                Export default
+******************************************************************************/
+
+export default {
+  getAll,
+  add,
+  update,
+  delete: __delete__,
+} as const;

package/lib/project-files/src/routes/{index.ts → apiRouter.ts}

@@ -1,28 +1,28 @@
-import { Router } from 'express';
-
-import Paths from '@src/common/constants/Paths';
-import UserRoutes from './UserRoutes';
-
-/******************************************************************************
-                                Setup
-******************************************************************************/
-
-const apiRouter = Router();
-
-
-// **** Add UserRouter **** //
-
-const userRouter = Router();
-
-userRouter.get(Paths.Users.Get, UserRoutes.getAll);
-userRouter.post(Paths.Users.Add, UserRoutes.add);
-userRouter.put(Paths.Users.Update, UserRoutes.update);
-userRouter.delete(Paths.Users.Delete, UserRoutes.delete);
-
-apiRouter.use(Paths.Users._, userRouter);
-
-/******************************************************************************
-                                Export default
-******************************************************************************/
-
-export default apiRouter;
+import { Router } from 'express';
+
+import Paths from '@src/common/constants/Paths';
+
+import UserRoutes from './UserRoutes';
+
+/******************************************************************************
+                                Setup
+******************************************************************************/
+
+const apiRouter = Router();
+
+// ----------------------- Add UserRouter ---------------------------------- //
+
+const userRouter = Router();
+
+userRouter.get(Paths.Users.Get, UserRoutes.getAll);
+userRouter.post(Paths.Users.Add, UserRoutes.add);
+userRouter.put(Paths.Users.Update, UserRoutes.update);
+userRouter.delete(Paths.Users.Delete, UserRoutes.delete);
+
+apiRouter.use(Paths.Users._, userRouter);
+
+/******************************************************************************
+                                Export default
+******************************************************************************/
+
+export default apiRouter;

package/lib/project-files/src/routes/common/{types.ts → express-types.ts}

@@ -1,10 +1,9 @@
-import { Response, Request } from 'express';
-import { PlainObject } from 'jet-validators';
-
-/******************************************************************************
-                                Types
-******************************************************************************/
-
-export type IReq = Request<PlainObject, void, PlainObject, PlainObject>;
-export type IRes = Response<unknown, PlainObject>;
-
+import { Request, Response } from 'express';
+import { PlainObject } from 'jet-validators';
+
+/******************************************************************************
+                                Types
+******************************************************************************/
+
+export type IReq = Request<PlainObject, void, PlainObject, PlainObject>;
+export type IRes = Response<unknown, PlainObject>;

package/lib/project-files/src/routes/common/{utils.ts → parseReq.ts}

@@ -1,16 +1,19 @@
-import { parseObject, Schema } from 'jet-validators/utils';
-import { ValidationError } from '@src/common/utils/route-errors';
-
-/******************************************************************************
-                              Functions
-******************************************************************************/
-
-/**
- * Throw a "ParseObjError" when "parseObject" fails. Also extract a nested 
- * "ParseObjError" and add it to the nestedErrors array.
- */
-export function parseReq<U extends Schema>(schema: U) {
-  return parseObject(schema, errors => {
-    throw new ValidationError(errors);
-  });
-}
+import { parseObject, Schema } from 'jet-validators/utils';
+
+import { ValidationError } from '@src/common/utils/route-errors';
+
+/******************************************************************************
+                              Functions
+******************************************************************************/
+
+/**
+ * Throw a "ParseObjError" when "parseObject" fails. Also extract a nested
+ * "ParseObjError" and add it to the nestedErrors array.
+ */
+function parseReq<U extends Schema>(schema: U) {
+  return parseObject(schema, (errors) => {
+    throw new ValidationError(errors);
+  });
+}
+
+export default parseReq;