@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,316 +0,0 @@
1
- /**
2
- * JWT Provider
3
- *
4
- * Provider untuk JWT authentication yang bisa di-inject via DI system.
5
- * Mudah digunakan di route handler tanpa perlu setup middleware manual.
6
- */
7
-
8
- import { Context } from '../../core';
9
- import type { User, JWTConfig } from '../types';
10
-
11
- export interface JWTProviderConfig {
12
- secret: string;
13
- expiresIn?: string | number; // '1h', '7d', 3600, etc.
14
- issuer?: string;
15
- audience?: string;
16
- }
17
-
18
- export interface TokenPayload {
19
- id: string | number;
20
- email?: string;
21
- username?: string;
22
- roles?: string[];
23
- permissions?: string[];
24
- [key: string]: any;
25
- }
26
-
27
- export interface VerifyResult {
28
- valid: boolean;
29
- user: User | null;
30
- error?: string;
31
- expired?: boolean;
32
- }
33
-
34
- /**
35
- * JWT Provider Class
36
- *
37
- * @example
38
- * ```typescript
39
- * // Setup di app
40
- * const jwt = new JWTProvider({
41
- * secret: process.env.JWT_SECRET!,
42
- * expiresIn: '1h'
43
- * });
44
- *
45
- * const app = createApp().provide({ jwt });
46
- *
47
- * // Gunakan di route
48
- * app.post('/login', async (ctx, { jwt }) => {
49
- * const token = await jwt.sign({ id: user.id, email: user.email });
50
- * return { token };
51
- * });
52
- *
53
- * app.get('/profile', async (ctx, { jwt }) => {
54
- * const result = await jwt.verify(ctx);
55
- * if (!result.valid) return ctx.response.status(401).json({ error: 'Unauthorized' });
56
- * return { user: result.user };
57
- * });
58
- * ```
59
- */
60
- export class JWTProvider {
61
- private config: JWTProviderConfig;
62
-
63
- constructor(config: JWTProviderConfig) {
64
- if (!config.secret) {
65
- throw new Error('JWT secret is required');
66
- }
67
- this.config = {
68
- expiresIn: '1h',
69
- ...config
70
- };
71
- }
72
-
73
- /**
74
- * Generate JWT token dari user/payload
75
- */
76
- async sign(payload: TokenPayload, options?: Partial<JWTProviderConfig>): Promise<string> {
77
- const config = { ...this.config, ...options };
78
-
79
- const header = { alg: 'HS256', typ: 'JWT' };
80
-
81
- // Calculate expiry
82
- let exp: number;
83
- const expiresIn = config.expiresIn || '1h';
84
- if (typeof expiresIn === 'number') {
85
- exp = Math.floor(Date.now() / 1000) + expiresIn;
86
- } else {
87
- exp = Math.floor(Date.now() / 1000) + this.parseExpiry(expiresIn);
88
- }
89
-
90
- const tokenPayload = {
91
- ...payload,
92
- iat: Math.floor(Date.now() / 1000),
93
- exp,
94
- ...(config.issuer && { iss: config.issuer }),
95
- ...(config.audience && { aud: config.audience })
96
- };
97
-
98
- const encodedHeader = this.base64UrlEncode(JSON.stringify(header));
99
- const encodedPayload = this.base64UrlEncode(JSON.stringify(tokenPayload));
100
- const signature = await this.createSignature(`${encodedHeader}.${encodedPayload}`, config.secret);
101
-
102
- return `${encodedHeader}.${encodedPayload}.${signature}`;
103
- }
104
-
105
- /**
106
- * Verify token dari Authorization header atau cookie
107
- */
108
- async verify(ctx: Context, options?: { cookieName?: string }): Promise<VerifyResult> {
109
- const token = this.extractToken(ctx, options?.cookieName);
110
-
111
- if (!token) {
112
- return { valid: false, user: null, error: 'No token provided' };
113
- }
114
-
115
- return this.verifyToken(token);
116
- }
117
-
118
- /**
119
- * Verify token string langsung
120
- */
121
- async verifyToken(token: string): Promise<VerifyResult> {
122
- try {
123
- const parts = token.split('.');
124
- if (parts.length !== 3) {
125
- return { valid: false, user: null, error: 'Invalid token format' };
126
- }
127
-
128
- const [encodedHeader, encodedPayload, signature] = parts;
129
-
130
- // Verify signature
131
- const expectedSignature = await this.createSignature(
132
- `${encodedHeader}.${encodedPayload}`,
133
- this.config.secret
134
- );
135
-
136
- if (signature !== expectedSignature) {
137
- return { valid: false, user: null, error: 'Invalid signature' };
138
- }
139
-
140
- // Decode payload
141
- const payload = JSON.parse(this.base64UrlDecode(encodedPayload));
142
-
143
- // Check expiry
144
- if (payload.exp && payload.exp < Math.floor(Date.now() / 1000)) {
145
- return { valid: false, user: null, error: 'Token expired', expired: true };
146
- }
147
-
148
- // Check issuer
149
- if (this.config.issuer && payload.iss !== this.config.issuer) {
150
- return { valid: false, user: null, error: 'Invalid issuer' };
151
- }
152
-
153
- // Check audience
154
- if (this.config.audience && payload.aud !== this.config.audience) {
155
- return { valid: false, user: null, error: 'Invalid audience' };
156
- }
157
-
158
- const user: User = {
159
- id: payload.id,
160
- email: payload.email,
161
- username: payload.username,
162
- roles: payload.roles || [],
163
- permissions: payload.permissions || []
164
- };
165
-
166
- return { valid: true, user };
167
-
168
- } catch (error) {
169
- return { valid: false, user: null, error: 'Token verification failed' };
170
- }
171
- }
172
-
173
- /**
174
- * Decode token tanpa verify (untuk debugging)
175
- */
176
- decode(token: string): TokenPayload | null {
177
- try {
178
- const parts = token.split('.');
179
- if (parts.length !== 3) return null;
180
-
181
- const payload = JSON.parse(this.base64UrlDecode(parts[1]));
182
- return payload;
183
- } catch {
184
- return null;
185
- }
186
- }
187
-
188
- /**
189
- * Refresh token (generate token baru dengan expiry baru)
190
- */
191
- async refresh(token: string, options?: Partial<JWTProviderConfig>): Promise<string | null> {
192
- const result = await this.verifyToken(token);
193
-
194
- if (!result.valid || !result.user) {
195
- return null;
196
- }
197
-
198
- // Generate new token with same user data
199
- return this.sign({
200
- id: result.user.id,
201
- email: result.user.email,
202
- username: result.user.username,
203
- roles: result.user.roles,
204
- permissions: result.user.permissions
205
- }, options);
206
- }
207
-
208
- /**
209
- * Create middleware untuk protect route
210
- */
211
- middleware(options?: { cookieName?: string }) {
212
- return async (ctx: Context, next: (ctx: Context) => Promise<any>) => {
213
- const result = await this.verify(ctx, options);
214
-
215
- if (!result.valid) {
216
- return ctx.response.status(401).json({
217
- error: 'Unauthorized',
218
- message: result.error
219
- });
220
- }
221
-
222
- // Attach user ke context
223
- (ctx as any).user = result.user;
224
-
225
- return next(ctx);
226
- };
227
- }
228
-
229
- /**
230
- * Check apakah user punya role tertentu
231
- */
232
- hasRole(user: User, role: string | string[]): boolean {
233
- const roles = Array.isArray(role) ? role : [role];
234
- return roles.some(r => user.roles?.includes(r));
235
- }
236
-
237
- /**
238
- * Check apakah user punya permission tertentu
239
- */
240
- hasPermission(user: User, permission: string | string[]): boolean {
241
- const permissions = Array.isArray(permission) ? permission : [permission];
242
- return permissions.some(p => user.permissions?.includes(p));
243
- }
244
-
245
- // === Private Methods ===
246
-
247
- private extractToken(ctx: Context, cookieName?: string): string | null {
248
- // 1. Check Authorization header
249
- const authHeader = ctx.headers?.authorization || ctx.headers?.Authorization;
250
- if (authHeader) {
251
- const header = Array.isArray(authHeader) ? authHeader[0] : authHeader;
252
- if (header.startsWith('Bearer ')) {
253
- return header.slice(7);
254
- }
255
- }
256
-
257
- // 2. Check cookie
258
- if (cookieName) {
259
- const cookieHeader = ctx.headers?.cookie;
260
- if (cookieHeader) {
261
- const cookies = Array.isArray(cookieHeader) ? cookieHeader[0] : cookieHeader;
262
- const match = cookies.match(new RegExp(`${cookieName}=([^;]+)`));
263
- if (match) return match[1];
264
- }
265
- }
266
-
267
- // 3. Check query parameter (for websocket atau special cases)
268
- if (ctx.query?.token) {
269
- return ctx.query.token as string;
270
- }
271
-
272
- return null;
273
- }
274
-
275
- private parseExpiry(expiry: string): number {
276
- const match = expiry.match(/^(\d+)([smhd])$/);
277
- if (!match) return 3600; // default 1h
278
-
279
- const value = parseInt(match[1]);
280
- const unit = match[2];
281
-
282
- switch (unit) {
283
- case 's': return value;
284
- case 'm': return value * 60;
285
- case 'h': return value * 3600;
286
- case 'd': return value * 86400;
287
- default: return 3600;
288
- }
289
- }
290
-
291
- private base64UrlEncode(str: string): string {
292
- const base64 = Buffer.from(str).toString('base64');
293
- return base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
294
- }
295
-
296
- private base64UrlDecode(str: string): string {
297
- let base64 = str.replace(/-/g, '+').replace(/_/g, '/');
298
- while (base64.length % 4) base64 += '=';
299
- return Buffer.from(base64, 'base64').toString('utf-8');
300
- }
301
-
302
- private async createSignature(data: string, secret: string): Promise<string> {
303
- const crypto = await import('crypto');
304
- const hmac = crypto.createHmac('sha256', secret);
305
- hmac.update(data);
306
- const signature = hmac.digest('base64');
307
- return signature.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
308
- }
309
- }
310
-
311
- /**
312
- * Factory function untuk create JWTProvider
313
- */
314
- export function createJWTProvider(config: JWTProviderConfig): JWTProvider {
315
- return new JWTProvider(config);
316
- }
@@ -1,12 +0,0 @@
1
- /**
2
- * Auth Adapter Exports
3
- *
4
- * Re-exports authentication adapters
5
- */
6
-
7
- export * from '../adapter';
8
- export { JWTAuthAdapter } from './jwt';
9
-
10
- // OAuth and Session adapters will be implemented in future
11
- // export { OAuthAdapter } from './oauth';
12
- // export { SessionAdapter } from './session';
@@ -1,234 +0,0 @@
1
- /**
2
- * JWT Authentication Adapter
3
- *
4
- * Implements JWT-based authentication
5
- */
6
-
7
- import type { Context } from '../../core/types';
8
- import type { User, JWTConfig } from '../types';
9
- import type { AuthAdapter } from '../adapter';
10
-
11
- /**
12
- * Simple JWT implementation (in production, use a library like jsonwebtoken)
13
- * This is a basic implementation for demonstration
14
- */
15
- export class JWTAuthAdapter implements AuthAdapter<JWTConfig> {
16
- /**
17
- * Verify JWT token and extract user
18
- */
19
- async verify(ctx: Context, config: JWTConfig): Promise<User | null> {
20
- const token = this.extractToken(ctx, config);
21
-
22
- if (!token) {
23
- return null;
24
- }
25
-
26
- try {
27
- const payload = this.decodeToken(token, config.secret);
28
-
29
- // Check expiration
30
- if (payload.exp && payload.exp < Date.now() / 1000) {
31
- return null;
32
- }
33
-
34
- // Extract user from payload
35
- // Destructure known fields and spread the rest to preserve custom fields like 'type'
36
- const { sub, id, email, username, roles, permissions, user: nestedUser, iat, exp, ...rest } = payload;
37
-
38
- const user: User = {
39
- id: sub || id,
40
- email,
41
- username,
42
- roles,
43
- permissions,
44
- ...nestedUser, // Spread nested user object if exists
45
- ...rest // Spread remaining custom fields (e.g., type)
46
- };
47
-
48
- return user;
49
- } catch (error) {
50
- return null;
51
- }
52
- }
53
-
54
- /**
55
- * Generate JWT token for user
56
- */
57
- async generateToken(user: User, config: JWTConfig): Promise<string> {
58
- const payload: any = {
59
- sub: user.id,
60
- email: user.email,
61
- username: user.username,
62
- roles: user.roles,
63
- permissions: user.permissions,
64
- iat: Math.floor(Date.now() / 1000)
65
- };
66
-
67
- // Add expiration
68
- if (config.expiresIn) {
69
- const expiresIn = typeof config.expiresIn === 'string'
70
- ? this.parseExpiration(config.expiresIn)
71
- : config.expiresIn;
72
- payload.exp = payload.iat + expiresIn;
73
- }
74
-
75
- return this.encodeToken(payload, config.secret);
76
- }
77
-
78
- /**
79
- * Refresh JWT token (placeholder for future implementation)
80
- */
81
- async refreshToken(token: string, config: JWTConfig): Promise<string | null> {
82
- if (!config.refresh?.enabled) {
83
- return null;
84
- }
85
-
86
- try {
87
- const payload = this.decodeToken(token, config.secret);
88
-
89
- // Re-generate with new exp
90
- const newPayload = {
91
- ...payload,
92
- iat: Math.floor(Date.now() / 1000)
93
- };
94
-
95
- if (config.refresh.expiresIn) {
96
- const expiresIn = typeof config.refresh.expiresIn === 'string'
97
- ? this.parseExpiration(config.refresh.expiresIn)
98
- : config.refresh.expiresIn;
99
- newPayload.exp = newPayload.iat + expiresIn;
100
- }
101
-
102
- return this.encodeToken(newPayload, config.secret);
103
- } catch (error) {
104
- return null;
105
- }
106
- }
107
-
108
- /**
109
- * Extract token from request
110
- */
111
- private extractToken(ctx: Context, config: JWTConfig): string | null {
112
- // Use custom extractor if provided
113
- if (config.getToken) {
114
- return config.getToken(ctx);
115
- }
116
-
117
- // Try Authorization header
118
- const authHeader = ctx.headers['authorization'] || ctx.headers['Authorization'];
119
- if (authHeader) {
120
- const headerValue = Array.isArray(authHeader) ? authHeader[0] : authHeader;
121
- if (headerValue?.startsWith('Bearer ')) {
122
- return headerValue.substring(7);
123
- }
124
- }
125
-
126
- // Try cookie
127
- const cookieHeader = ctx.headers['cookie'] || ctx.headers['Cookie'];
128
- if (cookieHeader) {
129
- const cookieValue = Array.isArray(cookieHeader) ? cookieHeader[0] : cookieHeader;
130
- if (cookieValue) {
131
- const match = cookieValue.match(/token=([^;]+)/);
132
- if (match) {
133
- return match[1];
134
- }
135
- }
136
- }
137
-
138
- return null;
139
- }
140
-
141
- /**
142
- * Encode JWT token (simplified HMAC-SHA256)
143
- */
144
- private encodeToken(payload: any, secret: string): string {
145
- const header = { alg: 'HS256', typ: 'JWT' };
146
-
147
- const encodedHeader = this.base64UrlEncode(JSON.stringify(header));
148
- const encodedPayload = this.base64UrlEncode(JSON.stringify(payload));
149
-
150
- const signature = this.sign(`${encodedHeader}.${encodedPayload}`, secret);
151
-
152
- return `${encodedHeader}.${encodedPayload}.${signature}`;
153
- }
154
-
155
- /**
156
- * Decode and verify JWT token
157
- */
158
- private decodeToken(token: string, secret: string): any {
159
- const parts = token.split('.');
160
-
161
- if (parts.length !== 3) {
162
- throw new Error('Invalid token format');
163
- }
164
-
165
- const [encodedHeader, encodedPayload, signature] = parts;
166
-
167
- // Verify signature
168
- const expectedSignature = this.sign(`${encodedHeader}.${encodedPayload}`, secret);
169
- if (signature !== expectedSignature) {
170
- throw new Error('Invalid signature');
171
- }
172
-
173
- // Decode payload
174
- const payload = JSON.parse(this.base64UrlDecode(encodedPayload));
175
-
176
- return payload;
177
- }
178
-
179
- /**
180
- * Base64 URL encode
181
- */
182
- private base64UrlEncode(str: string): string {
183
- const base64 = Buffer.from(str).toString('base64');
184
- return base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '');
185
- }
186
-
187
- /**
188
- * Base64 URL decode
189
- */
190
- private base64UrlDecode(str: string): string {
191
- let base64 = str.replace(/-/g, '+').replace(/_/g, '/');
192
-
193
- // Add padding
194
- while (base64.length % 4) {
195
- base64 += '=';
196
- }
197
-
198
- return Buffer.from(base64, 'base64').toString('utf-8');
199
- }
200
-
201
- /**
202
- * Sign data with HMAC-SHA256
203
- */
204
- private sign(data: string, secret: string): string {
205
- const crypto = require('crypto');
206
- const hmac = crypto.createHmac('sha256', secret);
207
- hmac.update(data);
208
- const signature = hmac.digest('base64');
209
- return signature.replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '');
210
- }
211
-
212
- /**
213
- * Parse expiration string to seconds
214
- */
215
- private parseExpiration(exp: string): number {
216
- const match = exp.match(/^(\d+)([smhd])$/);
217
-
218
- if (!match) {
219
- throw new Error('Invalid expiration format');
220
- }
221
-
222
- const value = parseInt(match[1]);
223
- const unit = match[2];
224
-
225
- const multipliers: Record<string, number> = {
226
- s: 1,
227
- m: 60,
228
- h: 3600,
229
- d: 86400
230
- };
231
-
232
- return value * multipliers[unit];
233
- }
234
- }