nodejs-quickstart-structure 1.9.4 → 1.10.1

package/templates/clean-architecture/js/src/infrastructure/webserver/server.js.ejs

@@ -3,27 +3,41 @@ const cors = require('cors');
 require('dotenv').config();
 const logger = require('../log/logger');
 const morgan = require('morgan');
-<% if (communication === 'REST APIs') { %>const apiRoutes = require('../../interfaces/routes/api');<% } -%>
-<% if (communication === 'REST APIs') { -%>
+<%_ if (communication === 'REST APIs') { -%>const apiRoutes = require('../../interfaces/routes/api');<%_ } -%>
+<%_ if (communication === 'REST APIs') { -%>
 const swaggerUi = require('swagger-ui-express');
 const swaggerSpecs = require('./swagger');
-<% } -%>
+<%_ } -%>
+<%_ if (communication === 'GraphQL') { -%>
+const { ApolloServer } = require('@apollo/server');
+const { expressMiddleware } = require('@apollo/server/express4');
+const { ApolloServerPluginLandingPageLocalDefault } = require('@apollo/server/plugin/landingPage/default');
+const { typeDefs, resolvers } = require('../../interfaces/graphql');
+const { gqlContext } = require('../../interfaces/graphql/context');
+<%_ } -%>
 
-const startServer = (port) => {
+const startServer = async (port) => {
     const app = express();
 
     app.use(cors());
     app.use(express.json());
     app.use(morgan('combined', { stream: { write: message => logger.info(message.trim()) } }));
-
-    <% if (communication === 'REST APIs') { -%>
+    <%_ if (communication === 'REST APIs') { -%>
     app.use('/api', apiRoutes);
-    <% } -%>
-
-    <% if (communication === 'REST APIs') { -%>
+    <%_ } -%>
+    <%_ if (communication === 'REST APIs') { -%>
     app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpecs));
-    <% } -%>
-
+    <%_ } -%>
+    <%_ if (communication === 'GraphQL') { -%>
+    // GraphQL Setup
+    const server = new ApolloServer({
+        typeDefs,
+        resolvers,
+        plugins: [ApolloServerPluginLandingPageLocalDefault({ embed: true })],
+    });
+    await server.start();
+    app.use('/graphql', expressMiddleware(server, { context: gqlContext }));
+    <%_ } -%>
     app.get('/health', (req, res) => {
         res.json({ status: 'UP' });
     });

package/templates/clean-architecture/js/src/interfaces/controllers/{userController.js → userController.js.ejs}

@@ -1,7 +1,9 @@
 const CreateUser = require('../../usecases/CreateUser');
 const GetAllUsers = require('../../usecases/GetAllUsers');
 const UserRepository = require('../../infrastructure/repositories/UserRepository');
+<% if (communication !== 'GraphQL') { -%>
 const HTTP_STATUS = require('../../utils/httpCodes');
+<% } -%>
 const logger = require('../../infrastructure/log/logger');
 
 class UserController {
@@ -11,6 +13,26 @@ class UserController {
         this.getAllUsersUseCase = new GetAllUsers(this.userRepository);
     }
 
+<% if (communication === 'GraphQL') { -%>
+    async getUsers() {
+        try {
+            return await this.getAllUsersUseCase.execute();
+        } catch (error) {
+            logger.error('Error getting users:', error);
+            throw error;
+        }
+    }
+
+    async createUser(data) {
+        const { name, email } = data;
+        try {
+            return await this.createUserUseCase.execute(name, email);
+        } catch (error) {
+            logger.error('Error creating user:', error);
+            throw error;
+        }
+    }
+<% } else { -%>
     getUsers(req, res) {
         this.getAllUsersUseCase.execute()
             .then(users => res.json(users))
@@ -30,6 +52,7 @@ class UserController {
             res.status(HTTP_STATUS.BAD_REQUEST).json({ error: error.message });
         }
     }
+<% } -%>
 }
 
 module.exports = UserController;

package/templates/clean-architecture/js/src/interfaces/graphql/context.js.ejs

@@ -0,0 +1,13 @@
+const UserRepository = require('../../infrastructure/repositories/UserRepository');
+
+const gqlContext = async ({ req }) => {
+  const token = req.headers.authorization || '';
+  const userRepository = new UserRepository();
+  
+  return { 
+    token, 
+    userRepository 
+  };
+};
+
+module.exports = { gqlContext };

package/templates/clean-architecture/js/src/interfaces/graphql/index.js.ejs

@@ -0,0 +1,5 @@
+const { typeDefs } = require('./typeDefs');
+const { resolvers } = require('./resolvers');
+const { gqlContext } = require('./context');
+
+module.exports = { typeDefs, resolvers, gqlContext };

package/templates/clean-architecture/js/src/interfaces/graphql/resolvers/index.js.ejs

@@ -0,0 +1,6 @@
+const { mergeResolvers } = require('@graphql-tools/merge');
+const { userResolvers } = require('./user.resolvers');
+
+const resolvers = mergeResolvers([userResolvers]);
+
+module.exports = { resolvers };

package/templates/clean-architecture/js/src/interfaces/graphql/resolvers/user.resolvers.js.ejs

@@ -0,0 +1,27 @@
+const { GraphQLError } = require('graphql');
+const UserController = require('../../controllers/userController');
+
+const userController = new UserController();
+
+const userResolvers = {
+  Query: {
+    getAllUsers: async () => {
+      try {
+        return await userController.getUsers();
+      } catch (error) {
+        throw new GraphQLError(error.message || 'Internal server error', { extensions: { code: 'INTERNAL_SERVER_ERROR' } });
+      }
+    }
+  },
+  Mutation: {
+    createUser: async (_, { name, email }) => {
+      try {
+        return await userController.createUser({ name, email });
+      } catch (error) {
+        throw new GraphQLError(error.message || 'Internal server error', { extensions: { code: 'INTERNAL_SERVER_ERROR' } });
+      }
+    }
+  }
+};
+
+module.exports = { userResolvers };

package/templates/clean-architecture/js/src/interfaces/graphql/typeDefs/index.js.ejs

@@ -0,0 +1,6 @@
+const { mergeTypeDefs } = require('@graphql-tools/merge');
+const { userTypes } = require('./user.types');
+
+const typeDefs = mergeTypeDefs([userTypes]);
+
+module.exports = { typeDefs };

package/templates/clean-architecture/js/src/interfaces/graphql/typeDefs/user.types.js.ejs

@@ -0,0 +1,17 @@
+const userTypes = `#graphql
+  type User {
+    id: ID!
+    name: String!
+    email: String!
+  }
+
+  type Query {
+    getAllUsers: [User]
+  }
+
+  type Mutation {
+    createUser(name: String!, email: String!): User
+  }
+`;
+
+module.exports = { userTypes };

package/templates/clean-architecture/ts/src/index.ts.ejs

@@ -6,11 +6,18 @@ import rateLimit from 'express-rate-limit';
 import dotenv from 'dotenv';
 import logger from '@/infrastructure/log/logger';
 import morgan from 'morgan';
-<% if (communication === 'REST APIs') { %>import userRoutes from '@/interfaces/routes/userRoutes';<% } -%>
+<%_ if (communication === 'REST APIs') { -%>import userRoutes from '@/interfaces/routes/userRoutes';<%_ } -%>
 <% if (communication === 'REST APIs') { -%>
 import swaggerUi from 'swagger-ui-express';
 import swaggerSpecs from '@/config/swagger';<% } -%>
-<% if (communication === 'Kafka') { %>import { KafkaService } from '@/infrastructure/messaging/kafkaClient';<% } -%>
+<%_ if (communication === 'Kafka') { -%>import { KafkaService } from '@/infrastructure/messaging/kafkaClient';<%_ } -%>
+<%_ if (communication === 'GraphQL') { -%>
+import { ApolloServer } from '@apollo/server';
+import { expressMiddleware } from '@apollo/server/express4';
+import { ApolloServerPluginLandingPageLocalDefault } from '@apollo/server/plugin/landingPage/default';
+import { typeDefs, resolvers } from '@/interfaces/graphql';
+import { gqlContext, MyContext } from '@/interfaces/graphql/context';
+<% } -%>
 
 dotenv.config();
 
@@ -18,7 +25,21 @@ const app = express();
 const port = process.env.PORT || 3000;
 
 // Security Middleware
+<%_ if (communication === 'GraphQL') { -%>
+app.use(helmet({
+  crossOriginEmbedderPolicy: false,
+  contentSecurityPolicy: {
+    directives: {
+      imgSrc: [`'self'`, 'data:', 'apollo-server-landing-page.cdn.apollographql.com'],
+      scriptSrc: [`'self'`, `https: 'unsafe-inline'`],
+      manifestSrc: [`'self'`, 'apollo-server-landing-page.cdn.apollographql.com'],
+      frameSrc: [`'self'`, 'sandbox.embed.apollographql.com'],
+    },
+  },
+}));
+<%_ } else { -%>
 app.use(helmet());
+<%_ } -%>
 app.use(hpp());
 app.use(cors({ origin: '*', methods: ['GET', 'POST', 'PUT', 'DELETE'] }));
 const limiter = rateLimit({ windowMs: 10 * 60 * 1000, max: 100 });
@@ -27,32 +48,42 @@ app.use(limiter);
 app.use(express.json());
 app.use(morgan('combined', { stream: { write: (message) => logger.info(message.trim()) } }));
 
-<% if (communication === 'REST APIs') { -%>
+<%_ if (communication === 'REST APIs') { -%>
 app.use('/api/users', userRoutes);
-<% } -%>
-
-<% if (communication === 'REST APIs') { -%>
+<%_ } -%>
+<%_ if (communication === 'REST APIs') { -%>
 app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpecs));
-<% } -%>
-
+<%_ } -%>
 app.get('/health', (req: Request, res: Response) => {
   res.json({ status: 'UP' });
 });
 
 // Start Server Logic
 const startServer = async () => {
-    logger.info(`Server running on port ${port}`);
+<%_ if (communication === 'GraphQL') { -%>
+    // GraphQL Setup
+    const server = new ApolloServer<MyContext>({
+      typeDefs,
+      resolvers,
+      plugins: [ApolloServerPluginLandingPageLocalDefault({ embed: true })],
+    });
+    await server.start();
+    app.use('/graphql', expressMiddleware(server, { context: gqlContext }));
+<%_ } -%>
+    app.listen(port, () => {
+        logger.info(`Server running on port ${port}`);
 <%_ if (communication === 'Kafka') { -%>
-    try {
-    const kafkaService = new KafkaService();
-    await kafkaService.connect();
-    logger.info('Kafka connected');
-    // Demo
-    await kafkaService.sendMessage('test-topic', 'Hello Kafka from Clean Arch TS!');
-    } catch (err) {
-    logger.error('Failed to connect to Kafka:', err);
-    }
+        try {
+          const kafkaService = new KafkaService();
+          kafkaService.connect().then(() => {
+            logger.info('Kafka connected');
+            kafkaService.sendMessage('test-topic', 'Hello Kafka from Clean Arch TS!');
+          });
+        } catch (err) {
+          logger.error('Failed to connect to Kafka:', err);
+        }
 <%_ } -%>
+    });
 };
 
 <%_ if (database !== 'None') { -%>
@@ -69,7 +100,7 @@ const syncDatabase = async () => {
             await sequelize.sync();
             <%_ } -%>
             logger.info('Database synced');
-            app.listen(port, startServer);
+            await startServer();
             break;
         } catch (error) {
             logger.error('Error syncing database:', error);
@@ -82,5 +113,5 @@ const syncDatabase = async () => {
 
 syncDatabase();
 <%_ } else { -%>
-app.listen(port, startServer);
+startServer();
 <%_ } -%>

package/templates/clean-architecture/ts/src/interfaces/controllers/{userController.ts → userController.ts.ejs}

@@ -1,8 +1,10 @@
+<% if (communication !== 'GraphQL') { -%>
 import { Request, Response } from 'express';
+import { HTTP_STATUS } from '@/utils/httpCodes';
+<% } -%>
 import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 import CreateUser from '@/usecases/createUser';
 import GetAllUsers from '@/usecases/getAllUsers';
-import { HTTP_STATUS } from '@/utils/httpCodes';
 import logger from '@/infrastructure/log/logger';
 
 export class UserController {
@@ -15,6 +17,30 @@ export class UserController {
         this.getAllUsersUseCase = new GetAllUsers(userRepository);
     }
 
+<% if (communication === 'GraphQL') { -%>
+    async createUser(data: { name: string, email: string }) {
+        try {
+            const { name, email } = data;
+            const user = await this.createUserUseCase.execute(name, email);
+            return user;
+        } catch (error: unknown) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            logger.error('UserController Error:', message);
+            throw error;
+        }
+    }
+
+    async getUsers() {
+        try {
+            const users = await this.getAllUsersUseCase.execute();
+            return users;
+        } catch (error: unknown) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            logger.error('UserController Error:', message);
+            throw error;
+        }
+    }
+<% } else { -%>
     async createUser(req: Request, res: Response) {
         try {
             const { name, email } = req.body;
@@ -43,4 +69,5 @@ export class UserController {
             }
         }
     }
+<% } -%>
 }

package/templates/clean-architecture/ts/src/interfaces/graphql/context.ts.ejs

@@ -0,0 +1,17 @@
+import { Request } from 'express';
+import { UserRepository } from '@/infrastructure/repositories/UserRepository';
+
+export interface MyContext {
+  token?: string;
+  userRepository: UserRepository;
+}
+
+export const gqlContext = async ({ req }: { req: Request }): Promise<MyContext> => {
+  const token = req.headers.authorization || '';
+  const userRepository = new UserRepository();
+  
+  return { 
+    token, 
+    userRepository 
+  };
+};

package/templates/clean-architecture/ts/src/interfaces/graphql/index.ts.ejs

@@ -0,0 +1,3 @@
+export { typeDefs } from '@/interfaces/graphql/typeDefs';
+export { resolvers } from '@/interfaces/graphql/resolvers';
+export { gqlContext, MyContext } from '@/interfaces/graphql/context';

package/templates/clean-architecture/ts/src/interfaces/graphql/resolvers/index.ts.ejs

@@ -0,0 +1,4 @@
+import { mergeResolvers } from '@graphql-tools/merge';
+import { userResolvers } from '@/interfaces/graphql/resolvers/user.resolvers';
+
+export const resolvers = mergeResolvers([userResolvers]);

package/templates/clean-architecture/ts/src/interfaces/graphql/resolvers/user.resolvers.ts.ejs

@@ -0,0 +1,27 @@
+import { GraphQLError } from 'graphql';
+import { UserController } from '@/interfaces/controllers/userController';
+
+const userController = new UserController();
+
+export const userResolvers = {
+  Query: {
+    getAllUsers: async () => {
+      try {
+        return await userController.getUsers();
+      } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : 'Internal server error';
+        throw new GraphQLError(message, { extensions: { code: 'INTERNAL_SERVER_ERROR' } });
+      }
+    }
+  },
+  Mutation: {
+    createUser: async (_: unknown, { name, email }: { name: string, email: string }) => {
+      try {
+        return await userController.createUser({ name, email });
+      } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : 'Internal server error';
+        throw new GraphQLError(message, { extensions: { code: 'INTERNAL_SERVER_ERROR' } });
+      }
+    }
+  }
+};

package/templates/clean-architecture/ts/src/interfaces/graphql/typeDefs/index.ts.ejs

@@ -0,0 +1,4 @@
+import { mergeTypeDefs } from '@graphql-tools/merge';
+import { userTypes } from './user.types';
+
+export const typeDefs = mergeTypeDefs([userTypes]);

package/templates/clean-architecture/ts/src/interfaces/graphql/typeDefs/user.types.ts.ejs

@@ -0,0 +1,15 @@
+export const userTypes = `#graphql
+  type User {
+    id: ID!
+    name: String!
+    email: String!
+  }
+
+  type Query {
+    getAllUsers: [User]
+  }
+
+  type Mutation {
+    createUser(name: String!, email: String!): User
+  }
+`;

package/templates/common/README.md.ejs

@@ -84,6 +84,33 @@ npm run format
 The project follows **<%= architecture %>** principles.
 <% if (communication === 'Kafka') { -%>
 Microservices communication handled via **Kafka**.
+<% } else if (communication === 'GraphQL') { -%>
+API is exposed via **GraphQL**.
+The Apollo Sandbox UI for API exploration and documentation is available natively, fully embedded for offline development:
+- **URL**: `http://localhost:3000/graphql` (Dynamic based on PORT)
+If you are opening `http://localhost:3000/graphql` in your browser, you can directly run the following in the Apollo Sandbox UI:
+
+**Query to get all users:**
+```graphql
+query GetAllUsers {
+  getAllUsers {
+    id
+    name
+    email
+  }
+}
+```
+
+**Mutation to create a user:**
+```graphql
+mutation CreateUser {
+  createUser(name: "John Doe", email: "john@example.com") {
+    id
+    name
+    email
+  }
+}
+```
 <% } else { -%>
 API is exposed via **REST**.
 A Swagger UI for API documentation is available at:

package/templates/common/database/js/mongoose.js.ejs

@@ -6,7 +6,6 @@ logger = require('../utils/logger');
 <% } else { %>
 logger = require('../log/logger');
 <% } %>
-
 const connectDB = async () => {
     const dbHost = process.env.DB_HOST || 'localhost';
     const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:27017/<%= dbName %>`;

package/templates/common/database/ts/mongoose.ts.ejs

@@ -4,7 +4,6 @@ import logger from '@/utils/logger';
 <% } else { %>
 import logger from '@/infrastructure/log/logger';
 <% } %>
-
 const connectDB = async (): Promise<void> => {
     const dbHost = process.env.DB_HOST || 'localhost';
     const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:27017/<%= dbName %>`;

package/templates/common/package.json.ejs

@@ -48,7 +48,10 @@
     "winston-daily-rotate-file": "^5.0.0",
     "morgan": "^1.10.0"<% if (communication === 'REST APIs') { %>,
     "swagger-ui-express": "^5.0.0",
-    "yamljs": "^0.3.0"<% } %>
+    "yamljs": "^0.3.0"<% } %><% if (communication === 'GraphQL') { %>,
+    "@apollo/server": "^4.10.0",
+    "graphql": "^16.8.1",
+    "@graphql-tools/merge": "^9.0.3"<% } %>
   },
   "devDependencies": {
     "nodemon": "^3.0.2"<% if (language === 'TypeScript') { %>,

package/templates/mvc/js/src/controllers/userController.js.ejs

@@ -1,5 +1,7 @@
 const User = require('../models/User');
+<% if (communication !== 'GraphQL') { -%>
 const HTTP_STATUS = require('../utils/httpCodes');
+<% } -%>
 const logger = require('../utils/logger');
 <%_ if (caching === 'Redis') { -%>
 const cacheService = require('../config/redisClient');
@@ -7,6 +9,58 @@ const cacheService = require('../config/redisClient');
 const cacheService = require('../config/memoryCache');
 <%_ } -%>
 
+<% if (communication === 'GraphQL') { -%>
+const getUsers = async () => {
+  try {
+<%_ if (caching === 'Redis' || caching === 'Memory Cache') { -%>
+    const users = await cacheService.getOrSet('users:all', async () => {
+<%_ if (database === 'MongoDB') { -%>
+        return await User.find();
+<%_ } else if (database === 'None') { -%>
+        return User.mockData;
+<%_ } else { -%>
+        return await User.findAll();
+<%_ } -%>
+    }, 60);
+<%_ } else { -%>
+<%_ if (database === 'MongoDB') { -%>
+    const users = await User.find();
+<%_ } else if (database === 'None') { -%>
+    const users = User.mockData;
+<%_ } else { -%>
+    const users = await User.findAll();
+<%_ } -%>
+<%_ } -%>
+    return users;
+  } catch (error) {
+    logger.error('Error fetching users:', error);
+    throw error;
+  }
+};
+
+const createUser = async (data) => {
+  try {
+    const { name, email } = data;
+<%_ if (database === 'None') { -%>
+    const newUser = { id: String(User.mockData.length + 1), name, email };
+    User.mockData.push(newUser);
+<%_ if (caching === 'Redis' || caching === 'Memory Cache') { -%>
+    await cacheService.del('users:all');
+<%_ } -%>
+    return newUser;
+<%_ } else { -%>
+    const user = await User.create({ name, email });
+<%_ if (caching === 'Redis' || caching === 'Memory Cache') { -%>
+    await cacheService.del('users:all');
+<%_ } -%>
+    return user;
+<%_ } -%>
+  } catch (error) {
+    logger.error('Error creating user:', error);
+    throw error;
+  }
+};
+<% } else { -%>
 const getUsers = async (req, res) => {
   try {
 <%_ if (caching === 'Redis' || caching === 'Memory Cache') { -%>
@@ -56,6 +110,7 @@ const createUser = async (req, res) => {
     res.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).json({ error: error.message });
   }
 };
+<% } -%>
 
 module.exports = { getUsers, createUser };
 

package/templates/mvc/js/src/graphql/context.js.ejs

@@ -0,0 +1,7 @@
+const gqlContext = async ({ req }) => {
+  // Setup authorization or context here
+  const token = req.headers.authorization || '';
+  return { token };
+};
+
+module.exports = { gqlContext };

package/templates/mvc/js/src/graphql/index.js.ejs

@@ -0,0 +1,5 @@
+const { typeDefs } = require('./typeDefs');
+const { resolvers } = require('./resolvers');
+const { gqlContext } = require('./context');
+
+module.exports = { typeDefs, resolvers, gqlContext };

package/templates/mvc/js/src/graphql/resolvers/index.js.ejs

@@ -0,0 +1,6 @@
+const { mergeResolvers } = require('@graphql-tools/merge');
+const { userResolvers } = require('./user.resolvers');
+
+const resolvers = mergeResolvers([userResolvers]);
+
+module.exports = { resolvers };

package/templates/mvc/js/src/graphql/resolvers/user.resolvers.js.ejs

@@ -0,0 +1,25 @@
+const { GraphQLError } = require('graphql');
+const userController = require('../../controllers/userController');
+
+const userResolvers = {
+  Query: {
+    getAllUsers: async () => {
+      try {
+        return await userController.getUsers();
+      } catch (error) {
+        throw new GraphQLError(error.message || 'Internal server error', { extensions: { code: 'INTERNAL_SERVER_ERROR' } });
+      }
+    }
+  },
+  Mutation: {
+    createUser: async (_, { name, email }) => {
+      try {
+        return await userController.createUser({ name, email });
+      } catch (error) {
+        throw new GraphQLError(error.message || 'Internal server error', { extensions: { code: 'INTERNAL_SERVER_ERROR' } });
+      }
+    }
+  }
+};
+
+module.exports = { userResolvers };

package/templates/mvc/js/src/graphql/typeDefs/index.js.ejs

@@ -0,0 +1,6 @@
+const { mergeTypeDefs } = require('@graphql-tools/merge');
+const { userTypes } = require('./user.types');
+
+const typeDefs = mergeTypeDefs([userTypes]);
+
+module.exports = { typeDefs };

package/templates/mvc/js/src/graphql/typeDefs/user.types.js.ejs

@@ -0,0 +1,17 @@
+const userTypes = `#graphql
+  type User {
+    id: ID!
+    name: String!
+    email: String!
+  }
+
+  type Query {
+    getAllUsers: [User]
+  }
+
+  type Mutation {
+    createUser(name: String!, email: String!): User
+  }
+`;
+
+module.exports = { userTypes };