express-server done

Author: nishkohli96

apps/express-server/src/app.ts

@@ -7,6 +7,7 @@ import cors from 'cors';
 import { ENV_CONFIG } from '@/constants';
 import { requestLogger } from '@/middleware';
 import { routesList } from '@/routes';
+import { sendErrorResponse } from '@/utils';
 
 const app: Express = express();
 
@@ -23,14 +24,16 @@ app.get('/', (_: Request, response: Response) => {
   });
 });
 
-routesList.forEach(route => {
-  app.use(route.path, route.router);
-});
+routesList.forEach(route => app.use(route.path, route.router));
 
 /* 404 Handler - To be written at last */
 app.get('*', (req: Request, response: Response) => {
-  const notFoundMsg = `Not Found - "${req.originalUrl}"`;
-  response.status(404).send(notFoundMsg);
+  const notFoundError = `No route exists for this endpoint: "${req.originalUrl}"`;
+  return sendErrorResponse(response, {
+    statusCode: 404,
+    message: '404 - Not Found',
+    error: notFoundError
+  });
 });
 
 export default app;

apps/express-server/src/index.ts

@@ -25,21 +25,19 @@ const hostName = os.hostname();
 const { port, env } = ENV_CONFIG;
 
 function bootstrap() {
-  /* DB Connection Logic */
-  // try {
-  //   await mongoose.connect(db_connection_string, { autoIndex: true });
-  //   console_log('Connected to DATABASE', `${db_name}@${db_url}`);
-  // } catch (err) {
-  //   console.log(chalk.red('⚠ Error connecting to the Database ⚠'));
-  //   console.log(err);
-  //   process.exit(1);
-  // }
 
-  const server = createServer(app);
+  /**
+   * You can write any custom logic here, like connecting to the
+   * database. Refer this snippet to connect to MongoDB, Postgres
+   * or MySQL database.
+   *
+   * https://github.com/nishkohli96/client-server-libs/blob/main/apps/express-server/src/index.ts#L171
+   */
 
+  const server = createServer(app);
   server.listen(port, () => {
     winstonLogger.info(
-      `[ ⚡️ ${hostName}@${env} ⚡️ ] - Server running on port ${port}`
+      `[⚡️ ${hostName}@${env} ⚡️] - Server running on port ${port}`
     );
   });
 }

apps/express-server/src/middleware/guard.ts

@@ -1,3 +1,2 @@
-export * from './guard';
 export * from './request-logger';
 export * from './winston-logger';

apps/express-server/src/middleware/index.ts

@@ -16,19 +16,3 @@ export function requestLogger(
   });
   next();
 }
-
-export function printSuccessMsg(msg: string): void {
-  winstonLogger.info(`✅ SUCCESS - ${msg}`);
-}
-
-export function printError(error: unknown): void {
-  winstonLogger.error(
-    `⚠ ERROR - ${error instanceof Error ? error.message : JSON.stringify(error)}`
-  );
-}
-
-export function errorLogger(res: Response, error: unknown) {
-  const err = JSON.stringify(error);
-  printError(error);
-  res.status(500).send(err);
-}

apps/express-server/src/middleware/request-logger.ts

@@ -1,4 +1,4 @@
-import { Router, type Request, type Response } from 'express';
+import { Router, type Response } from 'express';
 import authService from './service';
 import type * as AuthTypes from './types';
 
@@ -12,7 +12,7 @@ authRouter.get('/test', function printHello(_, res: Response) {
 authRouter.post(
   '/login',
   function loginUser(
-    req: Request<object, object, AuthTypes.UserLoginBody>,
+    req: AuthTypes.UserLoginRequest,
     res: Response
   ) {
     const { email, password } = req.body;

apps/express-server/src/routes/auth/controller.ts

@@ -1,20 +1,21 @@
 import type { Response } from 'express';
+import { sendErrorResponse } from '@/utils';
 
 class AuthService {
   loginUser(res: Response, email: string, password: string) {
     try {
-      res
+      return res
         .status(200)
         .send({
           email,
           password
         })
         .end();
     } catch (error) {
-      res.status(500).send(`Internal Server Error: ${JSON.stringify(error)}`);
+      return sendErrorResponse(res, { error });
     }
-    res.end();
   }
 }
 
-export default new AuthService();
+const authService = new AuthService();
+export default authService;

apps/express-server/src/routes/auth/service.ts

@@ -1,4 +1,7 @@
+import { type Request } from 'express';
 export interface UserLoginBody {
   email: string;
   password: string;
 }
+
+export type UserLoginRequest = Request<object, object, UserLoginBody>;

apps/express-server/src/routes/auth/types.ts

@@ -1,20 +1,20 @@
-import { type Router} from 'express';
+import { type Router } from 'express';
 import { authRouter } from './auth/controller';
 
 type RouteInfo = {
   path: string;
 	router: Router;
-}
+};
 
 function generatePrefix(routeName: string) {
-	return `/api${routeName}`;
+  return `/api${routeName}`;
 }
 
 const routesList: RouteInfo[] = [
   {
-		path: generatePrefix('/auth'),
-		router: authRouter
-	}
+    path: generatePrefix('/auth'),
+    router: authRouter
+  }
 ];
 
 export { routesList };

apps/express-server/src/routes/index.ts

@@ -0,0 +1,2 @@
+export * from './printObject';
+export * from './response';

apps/express-server/src/utils/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Winston logger expects string message by default.
+ * If you pass an object directly (like your response),
+ * Winston doesn't automatically serialize it.
+ *
+ * JSON.stringify's 2nd and 3rd args:
+ * - replacer	(Optional): A function or array to control
+ *   which properties are included in the output. Usually
+ *   null if you want to include everything. Specify only
+ *   those keys in an array which you want to log.
+ * - space (Optional): A number or string to control spacing
+ *   or indentation. 2 means 2 spaces of indentation per level
+ *   (for pretty-printing).
+ */
+export function printObject(obj: unknown): string {
+  return JSON.stringify(obj, null, 2);
+}

apps/express-server/src/utils/printObject.ts

@@ -0,0 +1,25 @@
+/**
+ * Move this in types/request folder if you want to
+ * use this code snippet.
+ */
+type PaginationConfig = {
+  records_per_page: number;
+  page: number;
+};
+
+export const DefaultPaginationOptions: PaginationConfig = {
+  records_per_page: 10,
+  page: 1
+};
+
+export function getPaginationParams(
+  page?: string,
+  records_per_page?: string
+): PaginationConfig {
+  return {
+    records_per_page: records_per_page
+      ? Number(records_per_page)
+      : DefaultPaginationOptions.records_per_page,
+    page: page ? Number(page) : DefaultPaginationOptions.page
+  };
+}

apps/express-server/src/utils/request.ts

@@ -0,0 +1,29 @@
+import { winstonLogger } from '@/middleware';
+import type { Response } from 'express';
+
+type ErrorResponseOptions = {
+  error: unknown;
+  message?: string;
+  statusCode?: number;
+};
+
+export function sendErrorResponse(
+  res: Response,
+  {
+    error,
+    message = 'Internal Server Error',
+    statusCode = 500,
+  }: ErrorResponseOptions
+) {
+  const errorMessage = error instanceof Error
+    ? error.message
+    : JSON.stringify(error);
+
+  winstonLogger.error(`⚠ ERROR - ${errorMessage}`);
+  return res.status(statusCode).json({
+    success: false,
+    status: statusCode,
+    message,
+    error: errorMessage,
+  });
+}