@engjts/nexus 0.1.8 → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/package.json +1 -1
  2. package/BENCHMARK_REPORT.md +0 -343
  3. package/documentation/01-getting-started.md +0 -240
  4. package/documentation/02-context.md +0 -335
  5. package/documentation/03-routing.md +0 -397
  6. package/documentation/04-middleware.md +0 -483
  7. package/documentation/05-validation.md +0 -514
  8. package/documentation/06-error-handling.md +0 -465
  9. package/documentation/07-performance.md +0 -364
  10. package/documentation/08-adapters.md +0 -470
  11. package/documentation/09-api-reference.md +0 -548
  12. package/documentation/10-examples.md +0 -582
  13. package/documentation/11-deployment.md +0 -477
  14. package/documentation/12-sentry.md +0 -620
  15. package/documentation/13-sentry-data-storage.md +0 -996
  16. package/documentation/14-sentry-data-reference.md +0 -457
  17. package/documentation/15-sentry-summary.md +0 -409
  18. package/documentation/16-alerts-system.md +0 -745
  19. package/documentation/17-alert-adapters.md +0 -696
  20. package/documentation/18-alerts-implementation-summary.md +0 -385
  21. package/documentation/19-class-based-routing.md +0 -840
  22. package/documentation/20-websocket-realtime.md +0 -813
  23. package/documentation/21-cache-system.md +0 -510
  24. package/documentation/22-job-queue.md +0 -772
  25. package/documentation/23-sentry-plugin.md +0 -551
  26. package/documentation/24-testing-utilities.md +0 -1287
  27. package/documentation/25-api-versioning.md +0 -533
  28. package/documentation/26-context-store.md +0 -607
  29. package/documentation/27-dependency-injection.md +0 -329
  30. package/documentation/28-lifecycle-hooks.md +0 -521
  31. package/documentation/29-package-structure.md +0 -196
  32. package/documentation/30-plugin-system.md +0 -414
  33. package/documentation/31-jwt-authentication.md +0 -597
  34. package/documentation/32-cli.md +0 -268
  35. package/documentation/ALERTS-COMPLETE-SUMMARY.md +0 -429
  36. package/documentation/ALERTS-INDEX.md +0 -330
  37. package/documentation/ALERTS-QUICK-REFERENCE.md +0 -286
  38. package/documentation/README.md +0 -178
  39. package/documentation/index.html +0 -34
  40. package/modern_framework_paper.md +0 -1870
  41. package/public/css/style.css +0 -87
  42. package/public/index.html +0 -34
  43. package/public/js/app.js +0 -27
  44. package/src/advanced/cache/InMemoryCacheStore.ts +0 -68
  45. package/src/advanced/cache/MultiTierCache.ts +0 -194
  46. package/src/advanced/cache/RedisCacheStore.ts +0 -341
  47. package/src/advanced/cache/index.ts +0 -5
  48. package/src/advanced/cache/types.ts +0 -40
  49. package/src/advanced/graphql/SimpleDataLoader.ts +0 -42
  50. package/src/advanced/graphql/index.ts +0 -22
  51. package/src/advanced/graphql/server.ts +0 -252
  52. package/src/advanced/graphql/types.ts +0 -42
  53. package/src/advanced/jobs/InMemoryQueueStore.ts +0 -68
  54. package/src/advanced/jobs/JobQueue.ts +0 -556
  55. package/src/advanced/jobs/RedisQueueStore.ts +0 -367
  56. package/src/advanced/jobs/index.ts +0 -5
  57. package/src/advanced/jobs/types.ts +0 -70
  58. package/src/advanced/observability/APMManager.ts +0 -163
  59. package/src/advanced/observability/AlertManager.ts +0 -109
  60. package/src/advanced/observability/MetricRegistry.ts +0 -151
  61. package/src/advanced/observability/ObservabilityCenter.ts +0 -304
  62. package/src/advanced/observability/StructuredLogger.ts +0 -154
  63. package/src/advanced/observability/TracingManager.ts +0 -117
  64. package/src/advanced/observability/adapters.ts +0 -304
  65. package/src/advanced/observability/createObservabilityMiddleware.ts +0 -63
  66. package/src/advanced/observability/index.ts +0 -11
  67. package/src/advanced/observability/types.ts +0 -174
  68. package/src/advanced/playground/extractPathParams.ts +0 -6
  69. package/src/advanced/playground/generateFieldExample.ts +0 -31
  70. package/src/advanced/playground/generatePlaygroundHTML.ts +0 -1956
  71. package/src/advanced/playground/generateSummary.ts +0 -19
  72. package/src/advanced/playground/getTagFromPath.ts +0 -9
  73. package/src/advanced/playground/index.ts +0 -8
  74. package/src/advanced/playground/playground.ts +0 -250
  75. package/src/advanced/playground/types.ts +0 -49
  76. package/src/advanced/playground/zodToExample.ts +0 -16
  77. package/src/advanced/playground/zodToParams.ts +0 -15
  78. package/src/advanced/postman/buildAuth.ts +0 -31
  79. package/src/advanced/postman/buildBody.ts +0 -15
  80. package/src/advanced/postman/buildQueryParams.ts +0 -27
  81. package/src/advanced/postman/buildRequestItem.ts +0 -36
  82. package/src/advanced/postman/buildResponses.ts +0 -11
  83. package/src/advanced/postman/buildUrl.ts +0 -33
  84. package/src/advanced/postman/capitalize.ts +0 -4
  85. package/src/advanced/postman/generateCollection.ts +0 -59
  86. package/src/advanced/postman/generateEnvironment.ts +0 -34
  87. package/src/advanced/postman/generateExampleFromZod.ts +0 -21
  88. package/src/advanced/postman/generateFieldExample.ts +0 -45
  89. package/src/advanced/postman/generateName.ts +0 -20
  90. package/src/advanced/postman/generateUUID.ts +0 -11
  91. package/src/advanced/postman/getTagFromPath.ts +0 -10
  92. package/src/advanced/postman/index.ts +0 -28
  93. package/src/advanced/postman/postman.ts +0 -156
  94. package/src/advanced/postman/slugify.ts +0 -7
  95. package/src/advanced/postman/types.ts +0 -140
  96. package/src/advanced/realtime/index.ts +0 -18
  97. package/src/advanced/realtime/websocket.ts +0 -231
  98. package/src/advanced/sentry/index.ts +0 -1236
  99. package/src/advanced/sentry/types.ts +0 -355
  100. package/src/advanced/static/generateDirectoryListing.ts +0 -47
  101. package/src/advanced/static/generateETag.ts +0 -7
  102. package/src/advanced/static/getMimeType.ts +0 -9
  103. package/src/advanced/static/index.ts +0 -32
  104. package/src/advanced/static/isSafePath.ts +0 -13
  105. package/src/advanced/static/publicDir.ts +0 -21
  106. package/src/advanced/static/serveStatic.ts +0 -225
  107. package/src/advanced/static/spa.ts +0 -24
  108. package/src/advanced/static/types.ts +0 -159
  109. package/src/advanced/swagger/SwaggerGenerator.ts +0 -66
  110. package/src/advanced/swagger/buildOperation.ts +0 -61
  111. package/src/advanced/swagger/buildParameters.ts +0 -61
  112. package/src/advanced/swagger/buildRequestBody.ts +0 -21
  113. package/src/advanced/swagger/buildResponses.ts +0 -54
  114. package/src/advanced/swagger/capitalize.ts +0 -5
  115. package/src/advanced/swagger/convertPath.ts +0 -9
  116. package/src/advanced/swagger/createSwagger.ts +0 -12
  117. package/src/advanced/swagger/generateOperationId.ts +0 -21
  118. package/src/advanced/swagger/generateSpec.ts +0 -105
  119. package/src/advanced/swagger/generateSummary.ts +0 -24
  120. package/src/advanced/swagger/generateSwaggerUI.ts +0 -70
  121. package/src/advanced/swagger/generateThemeCss.ts +0 -53
  122. package/src/advanced/swagger/index.ts +0 -25
  123. package/src/advanced/swagger/swagger.ts +0 -237
  124. package/src/advanced/swagger/types.ts +0 -206
  125. package/src/advanced/swagger/zodFieldToOpenAPI.ts +0 -94
  126. package/src/advanced/swagger/zodSchemaToOpenAPI.ts +0 -50
  127. package/src/advanced/swagger/zodToOpenAPI.ts +0 -22
  128. package/src/advanced/testing/factory.ts +0 -509
  129. package/src/advanced/testing/harness.ts +0 -612
  130. package/src/advanced/testing/index.ts +0 -430
  131. package/src/advanced/testing/load-test.ts +0 -618
  132. package/src/advanced/testing/mock-server.ts +0 -498
  133. package/src/advanced/testing/mock.ts +0 -670
  134. package/src/cli/bin.ts +0 -9
  135. package/src/cli/cli.ts +0 -158
  136. package/src/cli/commands/add.ts +0 -178
  137. package/src/cli/commands/build.ts +0 -73
  138. package/src/cli/commands/create.ts +0 -166
  139. package/src/cli/commands/dev.ts +0 -85
  140. package/src/cli/commands/generate.ts +0 -99
  141. package/src/cli/commands/help.ts +0 -95
  142. package/src/cli/commands/init.ts +0 -91
  143. package/src/cli/commands/version.ts +0 -38
  144. package/src/cli/index.ts +0 -6
  145. package/src/cli/templates/generators.ts +0 -359
  146. package/src/cli/templates/index.ts +0 -680
  147. package/src/cli/utils/exec.ts +0 -52
  148. package/src/cli/utils/file-system.ts +0 -78
  149. package/src/cli/utils/logger.ts +0 -111
  150. package/src/core/adapter.ts +0 -88
  151. package/src/core/application.ts +0 -1453
  152. package/src/core/context-pool.ts +0 -79
  153. package/src/core/context.ts +0 -856
  154. package/src/core/index.ts +0 -94
  155. package/src/core/middleware.ts +0 -272
  156. package/src/core/performance/buffer-pool.ts +0 -108
  157. package/src/core/performance/middleware-optimizer.ts +0 -162
  158. package/src/core/plugin/PluginManager.ts +0 -435
  159. package/src/core/plugin/builder.ts +0 -358
  160. package/src/core/plugin/index.ts +0 -50
  161. package/src/core/plugin/types.ts +0 -214
  162. package/src/core/router/file-router.ts +0 -623
  163. package/src/core/router/index.ts +0 -260
  164. package/src/core/router/radix-tree.ts +0 -242
  165. package/src/core/serializer.ts +0 -397
  166. package/src/core/store/index.ts +0 -30
  167. package/src/core/store/registry.ts +0 -178
  168. package/src/core/store/request-store.ts +0 -240
  169. package/src/core/store/types.ts +0 -233
  170. package/src/core/types.ts +0 -616
  171. package/src/database/adapter.ts +0 -35
  172. package/src/database/adapters/index.ts +0 -1
  173. package/src/database/adapters/mysql.ts +0 -669
  174. package/src/database/database.ts +0 -70
  175. package/src/database/dialect.ts +0 -388
  176. package/src/database/index.ts +0 -12
  177. package/src/database/migrations.ts +0 -86
  178. package/src/database/optimizer.ts +0 -125
  179. package/src/database/query-builder.ts +0 -404
  180. package/src/database/realtime.ts +0 -53
  181. package/src/database/schema.ts +0 -71
  182. package/src/database/transactions.ts +0 -56
  183. package/src/database/types.ts +0 -87
  184. package/src/deployment/cluster.ts +0 -471
  185. package/src/deployment/config.ts +0 -454
  186. package/src/deployment/docker.ts +0 -599
  187. package/src/deployment/graceful-shutdown.ts +0 -373
  188. package/src/deployment/index.ts +0 -56
  189. package/src/index.ts +0 -281
  190. package/src/security/adapter.ts +0 -318
  191. package/src/security/auth/JWTPlugin.ts +0 -234
  192. package/src/security/auth/JWTProvider.ts +0 -316
  193. package/src/security/auth/adapter.ts +0 -12
  194. package/src/security/auth/jwt.ts +0 -234
  195. package/src/security/auth/middleware.ts +0 -188
  196. package/src/security/csrf.ts +0 -220
  197. package/src/security/headers.ts +0 -108
  198. package/src/security/index.ts +0 -60
  199. package/src/security/rate-limit/adapter.ts +0 -7
  200. package/src/security/rate-limit/memory.ts +0 -108
  201. package/src/security/rate-limit/middleware.ts +0 -181
  202. package/src/security/sanitization.ts +0 -75
  203. package/src/security/types.ts +0 -240
  204. package/src/security/utils.ts +0 -52
  205. package/tsconfig.json +0 -39
@@ -1,99 +0,0 @@
1
- import { Command, CommandOption } from '../cli';
2
- import { Logger } from '../utils/logger';
3
- import { FileSystem } from '../utils/file-system';
4
- import { GeneratorTemplates } from '../templates/generators';
5
-
6
- type GeneratorType = 'route' | 'route-class' | 'middleware' | 'controller' | 'service' | 'model' | 'validator';
7
-
8
- export class GenerateCommand implements Command {
9
- name = 'generate';
10
- description = 'Generate components (route, middleware, controller, etc.)';
11
- usage = 'nexus generate <type> <name> [options]';
12
- options: CommandOption[] = [
13
- {
14
- name: 'path',
15
- alias: 'p',
16
- description: 'Custom path for the generated file',
17
- },
18
- {
19
- name: 'methods',
20
- alias: 'm',
21
- description: 'HTTP methods for route (comma-separated)',
22
- defaultValue: 'get',
23
- },
24
- ];
25
-
26
- private logger = new Logger();
27
- private validTypes: GeneratorType[] = ['route', 'route-class', 'middleware', 'controller', 'service', 'model', 'validator'];
28
-
29
- async execute(
30
- args: string[],
31
- options: Record<string, string | boolean>
32
- ): Promise<void> {
33
- if (args.length < 2) {
34
- this.showUsage();
35
- return;
36
- }
37
-
38
- const [type, name] = args;
39
-
40
- if (!this.validTypes.includes(type as GeneratorType)) {
41
- this.logger.error(`Invalid type: ${type}`);
42
- this.logger.info(`Valid types: ${this.validTypes.join(', ')}`);
43
- return;
44
- }
45
-
46
- const customPath = options.path as string | undefined;
47
- const methods = ((options.methods || 'get') as string).split(',').map(m => m.trim().toLowerCase());
48
-
49
- await this.generate(type as GeneratorType, name, { customPath, methods });
50
- }
51
-
52
- private async generate(
53
- type: GeneratorType,
54
- name: string,
55
- options: { customPath?: string; methods: string[] }
56
- ): Promise<void> {
57
- const generator = new GeneratorTemplates();
58
- const { filePath, content } = generator.generate(type, name, options);
59
-
60
- const targetPath = options.customPath
61
- ? FileSystem.joinPath(process.cwd(), options.customPath, `${name}.ts`)
62
- : FileSystem.joinPath(process.cwd(), filePath);
63
-
64
- // Check if file already exists
65
- if (await FileSystem.exists(targetPath)) {
66
- this.logger.error(`File already exists: ${targetPath}`);
67
- return;
68
- }
69
-
70
- await FileSystem.writeFile(targetPath, content);
71
- this.logger.success(`Created ${type}: ${targetPath}`);
72
- }
73
-
74
- private showUsage(): void {
75
- console.log(`
76
- ${this.logger.colors.bright}Usage:${this.logger.colors.reset} nexus generate <type> <name> [options]
77
-
78
- ${this.logger.colors.bright}Types:${this.logger.colors.reset}
79
- route Generate a function-based route handler
80
- route-class Generate a class-based route (with meta, schema, onBefore)
81
- middleware Generate a middleware
82
- controller Generate a controller class
83
- service Generate a service class
84
- model Generate a model/entity
85
- validator Generate a validation schema
86
-
87
- ${this.logger.colors.bright}Examples:${this.logger.colors.reset}
88
- nexus generate route users
89
- nexus generate route-class users
90
- nexus generate controller UserController
91
- nexus generate middleware auth
92
- nexus generate route products --methods get,post,put,delete
93
-
94
- ${this.logger.colors.bright}Options:${this.logger.colors.reset}
95
- --path, -p Custom output path
96
- --methods, -m HTTP methods for routes (comma-separated)
97
- `);
98
- }
99
- }
@@ -1,95 +0,0 @@
1
- import { Command } from '../cli';
2
- import { Logger } from '../utils/logger';
3
-
4
- export class HelpCommand implements Command {
5
- name = 'help';
6
- description = 'Show help information';
7
- usage = 'nexus help [command]';
8
-
9
- private logger = new Logger();
10
- private getCommands: () => Map<string, Command>;
11
-
12
- constructor(getCommands: () => Map<string, Command>) {
13
- this.getCommands = getCommands;
14
- }
15
-
16
- async execute(
17
- args: string[],
18
- options: Record<string, string | boolean>
19
- ): Promise<void> {
20
- const commands = this.getCommands();
21
-
22
- if (args.length > 0) {
23
- const commandName = args[0];
24
- const command = commands.get(commandName);
25
-
26
- if (!command) {
27
- this.logger.error(`Unknown command: ${commandName}`);
28
- return;
29
- }
30
-
31
- this.showCommandHelp(command);
32
- return;
33
- }
34
-
35
- this.showGeneralHelp(commands);
36
- }
37
-
38
- private showGeneralHelp(commands: Map<string, Command>): void {
39
- console.log(`
40
- ${this.logger.colors.bright}Nexus CLI${this.logger.colors.reset} - Async-First Web Framework
41
-
42
- ${this.logger.colors.bright}Usage:${this.logger.colors.reset}
43
- nexus <command> [options]
44
-
45
- ${this.logger.colors.bright}Commands:${this.logger.colors.reset}
46
- `);
47
-
48
- for (const [name, command] of commands) {
49
- console.log(` ${this.logger.colors.cyan}${name.padEnd(12)}${this.logger.colors.reset} ${command.description}`);
50
- }
51
-
52
- console.log(`
53
- ${this.logger.colors.bright}Global Options:${this.logger.colors.reset}
54
- --help, -h Show help
55
- --version, -v Show version
56
-
57
- ${this.logger.colors.bright}Examples:${this.logger.colors.reset}
58
- ${this.logger.colors.dim}# Create a new project${this.logger.colors.reset}
59
- nexus create my-app
60
-
61
- ${this.logger.colors.dim}# Create with specific template${this.logger.colors.reset}
62
- nexus create my-api --template api
63
-
64
- ${this.logger.colors.dim}# Generate a route${this.logger.colors.reset}
65
- nexus generate route users
66
-
67
- ${this.logger.colors.dim}# Start development server${this.logger.colors.reset}
68
- nexus dev
69
-
70
- Run ${this.logger.colors.cyan}nexus help <command>${this.logger.colors.reset} for more information on a specific command.
71
- `);
72
- }
73
-
74
- private showCommandHelp(command: Command): void {
75
- console.log(`
76
- ${this.logger.colors.bright}${command.name}${this.logger.colors.reset} - ${command.description}
77
-
78
- ${this.logger.colors.bright}Usage:${this.logger.colors.reset}
79
- ${command.usage}
80
- `);
81
-
82
- if (command.options && command.options.length > 0) {
83
- console.log(`${this.logger.colors.bright}Options:${this.logger.colors.reset}`);
84
- for (const option of command.options) {
85
- const aliasStr = option.alias ? `, -${option.alias}` : '';
86
- const defaultStr = option.defaultValue !== undefined
87
- ? ` (default: ${option.defaultValue})`
88
- : '';
89
- console.log(` --${option.name}${aliasStr}`);
90
- console.log(` ${option.description}${defaultStr}`);
91
- }
92
- console.log('');
93
- }
94
- }
95
- }
@@ -1,91 +0,0 @@
1
- import { Command, CommandOption } from '../cli';
2
- import { Logger } from '../utils/logger';
3
- import { FileSystem } from '../utils/file-system';
4
- import { spawnCommand, checkCommandExists } from '../utils/exec';
5
- import { ProjectTemplates } from '../templates';
6
-
7
- export class InitCommand implements Command {
8
- name = 'init';
9
- description = 'Initialize Nexus in the current directory';
10
- usage = 'nexus init [options]';
11
- options: CommandOption[] = [
12
- {
13
- name: 'template',
14
- alias: 't',
15
- description: 'Project template (basic, api, fullstack)',
16
- defaultValue: 'basic',
17
- },
18
- {
19
- name: 'force',
20
- alias: 'f',
21
- description: 'Force initialization even if directory is not empty',
22
- defaultValue: false,
23
- },
24
- ];
25
-
26
- private logger = new Logger();
27
-
28
- async execute(
29
- args: string[],
30
- options: Record<string, string | boolean>
31
- ): Promise<void> {
32
- const template = (options.template || options.t || 'basic') as string;
33
- const force = options.force === true || options.f === true;
34
- const projectPath = process.cwd();
35
- const projectName = FileSystem.getBasename(projectPath);
36
-
37
- // Check if directory is not empty
38
- const files = await FileSystem.listDirectory(projectPath);
39
- const hasFiles = files.filter(f => !f.startsWith('.')).length > 0;
40
-
41
- if (hasFiles && !force) {
42
- this.logger.error('Directory is not empty');
43
- this.logger.info('Use --force to initialize anyway');
44
- return;
45
- }
46
-
47
- this.logger.header(`Initializing Nexus project in ${projectPath}`);
48
-
49
- // Create project structure
50
- this.logger.step(1, 2, 'Creating project files...');
51
- await this.createProjectFiles(projectPath, projectName, template);
52
- this.logger.success('Project files created');
53
-
54
- // Initialize git if not exists
55
- this.logger.step(2, 2, 'Checking git repository...');
56
- const gitExists = await FileSystem.exists(FileSystem.joinPath(projectPath, '.git'));
57
- if (!gitExists && await checkCommandExists('git')) {
58
- await spawnCommand('git', ['init'], { cwd: projectPath, stdio: 'pipe' });
59
- this.logger.success('Git repository initialized');
60
- } else if (gitExists) {
61
- this.logger.info('Git repository already exists');
62
- }
63
-
64
- this.logger.blank();
65
- this.logger.success('Nexus project initialized successfully!');
66
- this.logger.blank();
67
- this.logger.info('Run "npm install" to install dependencies');
68
- this.logger.info('Run "npm run dev" to start the development server');
69
- }
70
-
71
- private async createProjectFiles(
72
- projectPath: string,
73
- projectName: string,
74
- template: string
75
- ): Promise<void> {
76
- const templates = new ProjectTemplates(projectName);
77
- const files = templates.getTemplate(template);
78
-
79
- for (const [filePath, content] of Object.entries(files)) {
80
- const fullPath = FileSystem.joinPath(projectPath, filePath);
81
-
82
- // Skip if file already exists
83
- if (await FileSystem.exists(fullPath)) {
84
- this.logger.warning(`Skipping ${filePath} (already exists)`);
85
- continue;
86
- }
87
-
88
- await FileSystem.writeFile(fullPath, content);
89
- }
90
- }
91
- }
@@ -1,38 +0,0 @@
1
- import { Command } from '../cli';
2
- import { Logger } from '../utils/logger';
3
- import { FileSystem } from '../utils/file-system';
4
-
5
- export class VersionCommand implements Command {
6
- name = 'version';
7
- description = 'Show Nexus CLI version';
8
- usage = 'nexus version';
9
-
10
- private logger = new Logger();
11
-
12
- async execute(
13
- args: string[],
14
- options: Record<string, string | boolean>
15
- ): Promise<void> {
16
- // Try to read version from package.json
17
- let version = '0.1.0';
18
-
19
- try {
20
- // Check for local package.json first
21
- const localPackage = FileSystem.joinPath(process.cwd(), 'node_modules', '@engjts/nexus', 'package.json');
22
- if (await FileSystem.exists(localPackage)) {
23
- const content = await FileSystem.readFile(localPackage);
24
- const pkg = JSON.parse(content);
25
- version = pkg.version;
26
- }
27
- } catch {
28
- // Use default version
29
- }
30
-
31
- console.log(`
32
- ${this.logger.colors.cyan}Nexus CLI${this.logger.colors.reset} v${version}
33
-
34
- ${this.logger.colors.dim}Node:${this.logger.colors.reset} ${process.version}
35
- ${this.logger.colors.dim}OS:${this.logger.colors.reset} ${process.platform} ${process.arch}
36
- `);
37
- }
38
- }
package/src/cli/index.ts DELETED
@@ -1,6 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- import { CLI } from './cli';
4
-
5
- const cli = new CLI();
6
- cli.run(process.argv.slice(2));
@@ -1,359 +0,0 @@
1
- type GeneratorType = 'route' | 'route-class' | 'middleware' | 'controller' | 'service' | 'model' | 'validator';
2
-
3
- interface GeneratorResult {
4
- filePath: string;
5
- content: string;
6
- }
7
-
8
- interface GeneratorOptions {
9
- customPath?: string;
10
- methods: string[];
11
- }
12
-
13
- export class GeneratorTemplates {
14
- generate(type: GeneratorType, name: string, options: GeneratorOptions): GeneratorResult {
15
- switch (type) {
16
- case 'route':
17
- return this.generateRoute(name, options.methods);
18
- case 'route-class':
19
- return this.generateRouteClass(name, options.methods);
20
- case 'middleware':
21
- return this.generateMiddleware(name);
22
- case 'controller':
23
- return this.generateController(name);
24
- case 'service':
25
- return this.generateService(name);
26
- case 'model':
27
- return this.generateModel(name);
28
- case 'validator':
29
- return this.generateValidator(name);
30
- default:
31
- throw new Error(`Unknown generator type: ${type}`);
32
- }
33
- }
34
-
35
- private toPascalCase(str: string): string {
36
- return str
37
- .replace(/[-_](.)/g, (_, c) => c.toUpperCase())
38
- .replace(/^(.)/, (_, c) => c.toUpperCase());
39
- }
40
-
41
- private toCamelCase(str: string): string {
42
- return str
43
- .replace(/[-_](.)/g, (_, c) => c.toUpperCase())
44
- .replace(/^(.)/, (_, c) => c.toLowerCase());
45
- }
46
-
47
- private generateRoute(name: string, methods: string[]): GeneratorResult {
48
- const routeName = this.toCamelCase(name);
49
- const routeHandlers = methods
50
- .map((method) => {
51
- return `
52
- // ${method.toUpperCase()} /${name}
53
- ${routeName}Routes.${method}('/', async (ctx) => {
54
- return {
55
- message: '${method.toUpperCase()} /${name}',
56
- };
57
- });`;
58
- })
59
- .join('\n');
60
-
61
- const content = `import { Router } from '@engjts/nexus';
62
-
63
- export const ${routeName}Routes = new Router();
64
- ${routeHandlers}
65
- `;
66
-
67
- return {
68
- filePath: `src/routes/${name}.ts`,
69
- content,
70
- };
71
- }
72
-
73
- private generateRouteClass(name: string, methods: string[]): GeneratorResult {
74
- const className = this.toPascalCase(name);
75
- const baseName = name.toLowerCase();
76
- const method = methods[0] || 'get';
77
-
78
- const content = `import { Route, Context, z } from '@engjts/nexus';
79
-
80
- export class ${className}Route extends Route {
81
- pathName = '/${baseName}';
82
-
83
- meta() {
84
- return {
85
- summary: '${className} route',
86
- description: '${className} route description',
87
- tags: ['${className}'],
88
- };
89
- }
90
-
91
- schema() {
92
- return {
93
- // params: z.object({}),
94
- // query: z.object({}),
95
- // body: z.object({}),
96
- };
97
- }
98
-
99
- async onBefore(ctx: Context) {
100
- // Hook sebelum handler
101
- // Return value untuk skip handler dan langsung return response
102
- }
103
-
104
- async handler(ctx: Context) {
105
- return {
106
- message: '${method.toUpperCase()} /${baseName}',
107
- };
108
- }
109
- }
110
- `;
111
-
112
- return {
113
- filePath: `src/routes/${name}.ts`,
114
- content,
115
- };
116
- }
117
-
118
- private generateMiddleware(name: string): GeneratorResult {
119
- const middlewareName = this.toCamelCase(name);
120
-
121
- const content = `import { Middleware, Context } from '@engjts/nexus';
122
-
123
- export const ${middlewareName}Middleware: Middleware = async (ctx: Context, next) => {
124
- // Before handler
125
- console.log(\`[${name}] Before: \${ctx.method} \${ctx.path}\`);
126
-
127
- // Call next middleware/handler
128
- const response = await next();
129
-
130
- // After handler
131
- console.log(\`[${name}] After: \${ctx.method} \${ctx.path}\`);
132
-
133
- return response;
134
- };
135
- `;
136
-
137
- return {
138
- filePath: `src/middleware/${name}.ts`,
139
- content,
140
- };
141
- }
142
-
143
- private generateController(name: string): GeneratorResult {
144
- const className = this.toPascalCase(name);
145
- const baseName = name.replace(/controller$/i, '').toLowerCase();
146
-
147
- const content = `import { Controller, Get, Post, Put, Delete, Context } from '@engjts/nexus';
148
-
149
- @Controller('/${baseName}')
150
- export class ${className} {
151
- @Get('/')
152
- async getAll() {
153
- return {
154
- message: 'Get all ${baseName}',
155
- data: [],
156
- };
157
- }
158
-
159
- @Get('/:id')
160
- async getById(ctx: Context) {
161
- const { id } = ctx.params;
162
- return {
163
- message: \`Get ${baseName} by id: \${id}\`,
164
- data: null,
165
- };
166
- }
167
-
168
- @Post('/')
169
- async create(ctx: Context) {
170
- const body = await ctx.body();
171
- return {
172
- status: 201,
173
- data: {
174
- message: 'Create ${baseName}',
175
- data: body,
176
- },
177
- };
178
- }
179
-
180
- @Put('/:id')
181
- async update(ctx: Context) {
182
- const { id } = ctx.params;
183
- const body = await ctx.body();
184
- return {
185
- message: \`Update ${baseName}: \${id}\`,
186
- data: body,
187
- };
188
- }
189
-
190
- @Delete('/:id')
191
- async delete(ctx: Context) {
192
- const { id } = ctx.params;
193
- return {
194
- message: \`Delete ${baseName}: \${id}\`,
195
- };
196
- }
197
- }
198
- `;
199
-
200
- return {
201
- filePath: `src/controllers/${name}.ts`,
202
- content,
203
- };
204
- }
205
-
206
- private generateService(name: string): GeneratorResult {
207
- const className = this.toPascalCase(name);
208
- const baseName = name.replace(/service$/i, '').toLowerCase();
209
-
210
- const content = `export interface ${this.toPascalCase(baseName)} {
211
- id: string;
212
- createdAt: Date;
213
- updatedAt: Date;
214
- }
215
-
216
- export interface Create${this.toPascalCase(baseName)}Dto {
217
- // Add your create DTO properties here
218
- }
219
-
220
- export interface Update${this.toPascalCase(baseName)}Dto {
221
- // Add your update DTO properties here
222
- }
223
-
224
- export class ${className} {
225
- private items: Map<string, ${this.toPascalCase(baseName)}> = new Map();
226
- private idCounter = 1;
227
-
228
- async findAll(): Promise<${this.toPascalCase(baseName)}[]> {
229
- return Array.from(this.items.values());
230
- }
231
-
232
- async findById(id: string): Promise<${this.toPascalCase(baseName)} | null> {
233
- return this.items.get(id) || null;
234
- }
235
-
236
- async create(data: Create${this.toPascalCase(baseName)}Dto): Promise<${this.toPascalCase(baseName)}> {
237
- const id = String(this.idCounter++);
238
- const item: ${this.toPascalCase(baseName)} = {
239
- id,
240
- ...data,
241
- createdAt: new Date(),
242
- updatedAt: new Date(),
243
- } as ${this.toPascalCase(baseName)};
244
-
245
- this.items.set(id, item);
246
- return item;
247
- }
248
-
249
- async update(id: string, data: Update${this.toPascalCase(baseName)}Dto): Promise<${this.toPascalCase(baseName)} | null> {
250
- const item = this.items.get(id);
251
-
252
- if (!item) {
253
- return null;
254
- }
255
-
256
- const updated: ${this.toPascalCase(baseName)} = {
257
- ...item,
258
- ...data,
259
- updatedAt: new Date(),
260
- };
261
-
262
- this.items.set(id, updated);
263
- return updated;
264
- }
265
-
266
- async delete(id: string): Promise<boolean> {
267
- return this.items.delete(id);
268
- }
269
- }
270
- `;
271
-
272
- return {
273
- filePath: `src/services/${name}.ts`,
274
- content,
275
- };
276
- }
277
-
278
- private generateModel(name: string): GeneratorResult {
279
- const className = this.toPascalCase(name);
280
-
281
- const content = `export interface ${className} {
282
- id: string;
283
- createdAt: Date;
284
- updatedAt: Date;
285
- // Add your model properties here
286
- }
287
-
288
- export interface Create${className}Input {
289
- // Add required fields for creation
290
- }
291
-
292
- export interface Update${className}Input {
293
- // Add optional fields for updates
294
- }
295
-
296
- // Database table name
297
- export const ${className}Table = '${name.toLowerCase()}s';
298
-
299
- // Field definitions (useful for query builders)
300
- export const ${className}Fields = {
301
- id: 'id',
302
- createdAt: 'created_at',
303
- updatedAt: 'updated_at',
304
- } as const;
305
- `;
306
-
307
- return {
308
- filePath: `src/models/${name}.ts`,
309
- content,
310
- };
311
- }
312
-
313
- private generateValidator(name: string): GeneratorResult {
314
- const baseName = name.replace(/validator$/i, '');
315
- const pascalName = this.toPascalCase(baseName);
316
-
317
- const content = `import { z } from 'zod';
318
-
319
- // Create schema
320
- export const create${pascalName}Schema = z.object({
321
- // Add your validation rules here
322
- // Example:
323
- // name: z.string().min(2).max(100),
324
- // email: z.string().email(),
325
- });
326
-
327
- // Update schema
328
- export const update${pascalName}Schema = z.object({
329
- // Add optional fields for updates
330
- // Example:
331
- // name: z.string().min(2).max(100).optional(),
332
- });
333
-
334
- // Query params schema
335
- export const ${this.toCamelCase(baseName)}QuerySchema = z.object({
336
- page: z.coerce.number().min(1).default(1),
337
- limit: z.coerce.number().min(1).max(100).default(10),
338
- search: z.string().optional(),
339
- sortBy: z.string().optional(),
340
- sortOrder: z.enum(['asc', 'desc']).default('asc'),
341
- });
342
-
343
- // ID param schema
344
- export const ${this.toCamelCase(baseName)}IdSchema = z.object({
345
- id: z.string().uuid(),
346
- });
347
-
348
- // Type exports
349
- export type Create${pascalName}Input = z.infer<typeof create${pascalName}Schema>;
350
- export type Update${pascalName}Input = z.infer<typeof update${pascalName}Schema>;
351
- export type ${pascalName}Query = z.infer<typeof ${this.toCamelCase(baseName)}QuerySchema>;
352
- `;
353
-
354
- return {
355
- filePath: `src/validators/${name}.ts`,
356
- content,
357
- };
358
- }
359
- }