express-generator-typescript 2.7.6 → 2.7.8

package/lib/project-files/src/common/util/route-errors.ts

@@ -1,38 +0,0 @@
-import { IParseObjectError } from 'jet-validators/utils';
-
-import HTTP_STATUS_CODES, {
-  HttpStatusCodes,
-} from '@src/common/constants/HTTP_STATUS_CODES';
-
-/******************************************************************************
-                                 Classes
-******************************************************************************/
-
-/**
- * Error with status code and message.
- */
-export class RouteError extends Error {
-  public status: HttpStatusCodes;
-
-  public constructor(status: HttpStatusCodes, message: string) {
-    super(message);
-    this.status = status;
-  }
-}
-
-/**
- * Handle "parseObj" errors.
- */
-export class ValidationError extends RouteError {
-
-  public static MESSAGE = 'The parseObj() function discovered one or ' + 
-    'more errors.';
-
-  public constructor(errors: IParseObjectError[]) {
-    const msg = JSON.stringify({
-      message: ValidationError.MESSAGE,
-      errors,
-    });
-    super(HTTP_STATUS_CODES.BadRequest, msg);
-  }
-}

package/lib/project-files/src/common/util/validators.ts

@@ -1,21 +0,0 @@
-import { isNumber, isDate } from 'jet-validators';
-import { transform } from 'jet-validators/utils';
-
-/******************************************************************************
-                                Functions
-******************************************************************************/
-
-/**
- * Database relational key.
- */
-export function isRelationalKey(arg: unknown): arg is number {
-  return isNumber(arg) && arg >= -1;
-}
-
-/**
- * Convert to date object then check is a validate date.
- */
-export const transIsDate = transform(
-  arg => new Date(arg as string),
-  arg => isDate(arg),
-);

package/lib/project-files/src/index.ts

@@ -1,27 +0,0 @@
-import logger from 'jet-logger';
-
-import ENV from '@src/common/constants/ENV';
-import server from './server';
-
-
-/******************************************************************************
-                                Constants
-******************************************************************************/
-
-const SERVER_START_MSG = (
-  'Express server started on port: ' + ENV.Port.toString()
-);
-
-
-/******************************************************************************
-                                  Run
-******************************************************************************/
-
-// Start the server
-server.listen(ENV.Port, err => {
-  if (!!err) {
-    logger.err(err.message);
-  } else {
-    logger.info(SERVER_START_MSG);
-  }
-});

package/lib/project-files/src/models/User.ts

@@ -1,69 +0,0 @@
-import { isString } from 'jet-validators';
-import { parseObject, TParseOnError } from 'jet-validators/utils';
-
-import { isRelationalKey, transIsDate } from '@src/common/util/validators';
-import { IModel } from './common/types';
-
-/******************************************************************************
-                                 Constants
-******************************************************************************/
-
-const DEFAULT_USER_VALS: IUser = {
-  id: -1,
-  name: '',
-  created: new Date(),
-  email: '',
-} as const;
-
-/******************************************************************************
-                                  Types
-******************************************************************************/
-
-export interface IUser extends IModel {
-  name: string;
-  email: string;
-}
-
-/******************************************************************************
-                                  Setup
-******************************************************************************/
-
-// Initialize the "parseUser" function
-const parseUser = parseObject<IUser>({
-  id: isRelationalKey,
-  name: isString,
-  email: isString,
-  created: transIsDate,
-});
-
-/******************************************************************************
-                                 Functions
-******************************************************************************/
-
-/**
- * New user object.
- */
-function __new__(user?: Partial<IUser>): IUser {
-  const defaults = { ...DEFAULT_USER_VALS };
-  defaults.created = new Date();
-  const retVal = { ...defaults, ...user };
-  return parseUser(retVal, errors => {
-    throw new Error('Setup new user failed ' + JSON.stringify(errors, null, 2));
-  });
-}
-
-/**
- * Check is a user object. For the route validation.
- */
-function test(arg: unknown, errCb?: TParseOnError): arg is IUser {
-  return !!parseUser(arg, errCb);
-}
-
-/******************************************************************************
-                                Export default
-******************************************************************************/
-
-export default {
-  new: __new__,
-  test,
-} as const;

package/lib/project-files/src/models/common/types/index.ts

@@ -1,5 +0,0 @@
-
-export interface IModel {
-  id: number;
-  created: Date;
-}

package/lib/project-files/src/public/scripts/http.js

@@ -1,26 +0,0 @@
-var Http = (() => {
-
-  // Setup request for json
-  var getOptions = (verb, data) => {
-    var options = {
-      dataType: 'json',
-      method: verb,
-      headers: {
-        'Accept': 'application/json',
-        'Content-Type': 'application/json',
-      },
-    };
-    if (!!data) {
-      options.body = JSON.stringify(data);
-    }
-    return options;
-  };
-
-  // Set Http methods
-  return {
-    get: (path) => fetch(path, getOptions('GET')),
-    post: (path, data) => fetch(path, getOptions('POST', data)),
-    put: (path, data) => fetch(path, getOptions('PUT', data)),
-    delete: (path) => fetch(path, getOptions('DELETE')),
-  };
-})();

package/lib/project-files/src/public/scripts/users.js

@@ -1,141 +0,0 @@
-// @ts-nocheck
-
-/******************************************************************************
-                                Constants
-******************************************************************************/
-
-const DateFormatter = new Intl.DateTimeFormat('en-US', {
-  year: 'numeric',
-  month: '2-digit',
-  day: '2-digit',
-});
-
-const formatDate = (date) => DateFormatter.format(new Date(date));
-
-
-/******************************************************************************
-                                  Run
-******************************************************************************/
-
-// Start
-displayUsers();
-
-
-/******************************************************************************
-                              Functions
-******************************************************************************/
-
-/**
- * Call api
- */
-function displayUsers() {
-  Http
-    .get('/api/users/all')
-    .then(resp => resp.json())
-    .then(resp => {
-      var allUsersTemplate = document.getElementById('all-users-template'),
-        allUsersTemplateHtml = allUsersTemplate.innerHTML,
-        template = Handlebars.compile(allUsersTemplateHtml);
-      var allUsersAnchor = document.getElementById('all-users-anchor');
-      allUsersAnchor.innerHTML = template({
-        users: resp.users.map(user => ({
-          ...user,
-          createdFormatted: formatDate(user.created),
-        })),
-      });
-    });
-}
-
-// Setup event listener for button click
-document.addEventListener('click', event => {
-  event.preventDefault();
-  var ele = event.target;
-  if (ele.matches('#add-user-btn')) {
-    addUser();
-  } else if (ele.matches('.edit-user-btn')) {
-    showEditView(ele.parentNode.parentNode);
-  } else if (ele.matches('.cancel-edit-btn')) {
-    cancelEdit(ele.parentNode.parentNode);
-  } else if (ele.matches('.submit-edit-btn')) {
-    submitEdit(ele);
-  } else if (ele.matches('.delete-user-btn')) {
-    deleteUser(ele);
-  }
-}, false);
-
-/**
- * Add a new user.
- */
-function addUser() {
-  var nameInput = document.getElementById('name-input');
-  var emailInput = document.getElementById('email-input');
-  var data = {
-    user: {
-      id: -1,
-      name: nameInput.value,
-      email: emailInput.value,
-      created: new Date(),
-    },
-  };
-  // Call api
-  Http
-    .post('/api/users/add', data)
-    .then(() => {
-      nameInput.value = '';
-      emailInput.value = '';
-      displayUsers();
-    });
-}
-
-/**
- * Show edit view.
- */
-function showEditView(userEle) {
-  var normalView = userEle.getElementsByClassName('normal-view')[0];
-  var editView = userEle.getElementsByClassName('edit-view')[0];
-  normalView.style.display = 'none';
-  editView.style.display = 'block';
-}
-
-/**
- * Cancel edit.
- */
-function cancelEdit(userEle) {
-  var normalView = userEle.getElementsByClassName('normal-view')[0];
-  var editView = userEle.getElementsByClassName('edit-view')[0];
-  normalView.style.display = 'block';
-  editView.style.display = 'none';
-}
-
-/**
- * Submit edit.
- */
-function submitEdit(ele) {
-  var userEle = ele.parentNode.parentNode;
-  var nameInput = userEle.getElementsByClassName('name-edit-input')[0];
-  var emailInput = userEle.getElementsByClassName('email-edit-input')[0];
-  var id = ele.getAttribute('data-user-id');
-  var created = ele.getAttribute('data-user-created');
-    console.log(ele, created)
-  var data = {
-    user: {
-      id: Number(id),
-      name: nameInput.value,
-      email: emailInput.value,
-      created: new Date(created),
-    },
-  };
-	Http
-    .put('/api/users/update', data)
-    .then(() => displayUsers());
-}
-
-/**
- * Delete a user
- */
-function deleteUser(ele) {
-  var id = ele.getAttribute('data-user-id');
-	Http
-    .delete('/api/users/delete/' + id)
-    .then(() => displayUsers());
-}

package/lib/project-files/src/public/stylesheets/users.css

@@ -1,48 +0,0 @@
-body {
-  padding: 100px;
-  font: 14px "Lucida Grande", Helvetica, Arial, sans-serif;
-}
-
-body .users-column {
-  display: inline-block;
-  margin-right: 2em;
-  vertical-align: top;
-}
-
-body .users-column .column-header {
-  padding-bottom: 5px;
-  font-weight: 700;
-  font-size: 1.2em;
-}
-
-
-/** Add User Column **/
-
-body .add-user-col input {
-  margin-bottom: 10px;
-}
-
-body .add-user-col #add-user-btn {
-  margin-top: 2px;
-  margin-bottom: 10px;
-}
-
-
-/** Users Display Column **/
-
-.email-edit {
-  padding-bottom: 8px;
-}
-
-body .users-column .user-display-ele {
-  padding-bottom: 10px;
-}
-
-body .users-column .user-display-ele button {
-  margin-top: 2px;
-  margin-bottom: 10px;
-}
-
-body .users-column .user-display-ele .edit-view {
-  display: none;
-}

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

@@ -1,63 +0,0 @@
-import jsonfile from 'jsonfile';
-
-import ENV from '@src/common/constants/ENV';
-import { NODE_ENVS } from '@src/common/constants';
-import { IUser } from '@src/models/User';
-
-
-/******************************************************************************
-                                Constants
-******************************************************************************/
-
-const DB_FILE_NAME = (
-  ENV.NodeEnv === NODE_ENVS.Test 
-    ? 'database.test.json' 
-    : 'database.json'
-);
-
-
-/******************************************************************************
-                                Types
-******************************************************************************/
-
-interface IDatabase {
-  users: IUser[];
-}
-
-
-/******************************************************************************
-                                Functions
-******************************************************************************/
-
-/**
- * Fetch the json from the file.
- */
-function openDb(): Promise<IDatabase> {
-  return jsonfile.readFile(__dirname + '/' + DB_FILE_NAME) as 
-    Promise<IDatabase>;
-}
-
-/**
- * Update the file.
- */
-function saveDb(db: IDatabase): Promise<void> {
-  return jsonfile.writeFile((__dirname + '/' + DB_FILE_NAME), db);
-}
-
-/**
- * Empty the database
- */
-function cleanDb(): Promise<void> {
-  return jsonfile.writeFile((__dirname + '/' + DB_FILE_NAME), {});
-}
-
-
-/******************************************************************************
-                                Export default
-******************************************************************************/
-
-export default {
-  openDb,
-  saveDb,
-  cleanDb,
-} as const;

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

@@ -1,134 +0,0 @@
-import { IUser } from '@src/models/User';
-import { getRandomInt } from '@src/common/util/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 insertMult(
-  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,
-  insertMult,
-} as const;

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

@@ -1 +0,0 @@
-{"users":[{"id":366115170645,"name":"Sean Maxwell","email":"smaxwell@example.com","created":"2024-03-22T05:14:36.252Z"},{"id":310946254456,"name":"John Smith","email":"john.smith@example.com","created":"2024-03-22T05:20:55.079Z"},{"id":143027113460,"name":"Gordan Freeman","email":"nova@prospect.com","created":"2024-03-22T05:42:18.895Z"}]}

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

@@ -1 +0,0 @@
-{"users":[{"id":967269206317,"name":"Bill","created":"2025-12-17T09:55:17.960Z","email":"sean.maxwell@gmail.com"},{"id":3025435078,"name":"John Smith","created":"2025-12-17T09:55:17.960Z","email":"john.smith@gmail.com"},{"id":786429791732,"name":"Gordan Freeman","created":"2025-12-17T09:55:17.960Z","email":"gordan.freeman@gmail.com"}]}

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

@@ -1,69 +0,0 @@
-import { isNumber } from 'jet-validators';
-import { transform } from 'jet-validators/utils';
-
-import HTTP_STATUS_CODES from '@src/common/constants/HTTP_STATUS_CODES';
-import UserService from '@src/services/UserService';
-import User from '@src/models/User';
-
-import { IReq, IRes } from './common/types';
-import { parseReq } from './common/util';
-
-/******************************************************************************
-                                Constants
-******************************************************************************/
-
-const Validators = {
-  add: parseReq({ user: User.test }),
-  update: parseReq({ user: User.test }),
-  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(HTTP_STATUS_CODES.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(HTTP_STATUS_CODES.Created).end();
-}
-
-/**
- * Update one user.
- */
-async function update(req: IReq, res: IRes) {
-  const { user } = Validators.update(req.body);
-  await UserService.updateOne(user);
-  res.status(HTTP_STATUS_CODES.Ok).end();
-}
-
-/**
- * Delete one user.
- */
-async function delete_(req: IReq, res: IRes) {
-  const { id } = Validators.delete(req.params);
-  await UserService.delete(id);
-  res.status(HTTP_STATUS_CODES.Ok).end();
-}
-
-/******************************************************************************
-                                Export default
-******************************************************************************/
-
-export default {
-  getAll,
-  add,
-  update,
-  delete: delete_,
-} as const;

package/lib/project-files/src/routes/common/types/index.ts

@@ -1,10 +0,0 @@
-import { Response, Request } from 'express';
-
-/******************************************************************************
-                                Types
-******************************************************************************/
-
-type TRecord = Record<string, unknown>;
-export type IReq = Request<TRecord, void, TRecord, TRecord>;
-export type IRes = Response<unknown, TRecord>;
-

package/lib/project-files/src/routes/common/util/index.ts

@@ -1,16 +0,0 @@
-import { parseObject, TSchema } from 'jet-validators/utils';
-import { ValidationError } from '@src/common/util/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 TSchema>(schema: U) {
-  return parseObject(schema, errors => {
-    throw new ValidationError(errors);
-  });
-}