@engjts/nexus 0.1.7 → 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.
- package/dist/advanced/playground/generatePlaygroundHTML.d.ts.map +1 -1
- package/dist/advanced/playground/generatePlaygroundHTML.js +107 -0
- package/dist/advanced/playground/generatePlaygroundHTML.js.map +1 -1
- package/dist/advanced/playground/playground.d.ts +19 -0
- package/dist/advanced/playground/playground.d.ts.map +1 -1
- package/dist/advanced/playground/playground.js +70 -0
- package/dist/advanced/playground/playground.js.map +1 -1
- package/dist/advanced/playground/types.d.ts +20 -0
- package/dist/advanced/playground/types.d.ts.map +1 -1
- package/dist/core/application.d.ts +14 -0
- package/dist/core/application.d.ts.map +1 -1
- package/dist/core/application.js +173 -71
- package/dist/core/application.js.map +1 -1
- package/dist/core/context-pool.d.ts +2 -13
- package/dist/core/context-pool.d.ts.map +1 -1
- package/dist/core/context-pool.js +7 -45
- package/dist/core/context-pool.js.map +1 -1
- package/dist/core/context.d.ts +108 -5
- package/dist/core/context.d.ts.map +1 -1
- package/dist/core/context.js +449 -53
- package/dist/core/context.js.map +1 -1
- package/dist/core/index.d.ts +1 -0
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +9 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/middleware.d.ts +6 -0
- package/dist/core/middleware.d.ts.map +1 -1
- package/dist/core/middleware.js +83 -84
- package/dist/core/middleware.js.map +1 -1
- package/dist/core/performance/fast-json.d.ts +149 -0
- package/dist/core/performance/fast-json.d.ts.map +1 -0
- package/dist/core/performance/fast-json.js +473 -0
- package/dist/core/performance/fast-json.js.map +1 -0
- package/dist/core/router/file-router.d.ts +20 -7
- package/dist/core/router/file-router.d.ts.map +1 -1
- package/dist/core/router/file-router.js +41 -13
- package/dist/core/router/file-router.js.map +1 -1
- package/dist/core/router/index.d.ts +6 -0
- package/dist/core/router/index.d.ts.map +1 -1
- package/dist/core/router/index.js +33 -6
- package/dist/core/router/index.js.map +1 -1
- package/dist/core/router/radix-tree.d.ts +4 -1
- package/dist/core/router/radix-tree.d.ts.map +1 -1
- package/dist/core/router/radix-tree.js +7 -3
- package/dist/core/router/radix-tree.js.map +1 -1
- package/dist/core/serializer.d.ts +251 -0
- package/dist/core/serializer.d.ts.map +1 -0
- package/dist/core/serializer.js +290 -0
- package/dist/core/serializer.js.map +1 -0
- package/dist/core/types.d.ts +39 -1
- package/dist/core/types.d.ts.map +1 -1
- package/dist/core/types.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +12 -2
- package/dist/index.js.map +1 -1
- package/package.json +3 -1
- package/documentation/01-getting-started.md +0 -240
- package/documentation/02-context.md +0 -335
- package/documentation/03-routing.md +0 -397
- package/documentation/04-middleware.md +0 -483
- package/documentation/05-validation.md +0 -514
- package/documentation/06-error-handling.md +0 -465
- package/documentation/07-performance.md +0 -364
- package/documentation/08-adapters.md +0 -470
- package/documentation/09-api-reference.md +0 -548
- package/documentation/10-examples.md +0 -582
- package/documentation/11-deployment.md +0 -477
- package/documentation/12-sentry.md +0 -620
- package/documentation/13-sentry-data-storage.md +0 -996
- package/documentation/14-sentry-data-reference.md +0 -457
- package/documentation/15-sentry-summary.md +0 -409
- package/documentation/16-alerts-system.md +0 -745
- package/documentation/17-alert-adapters.md +0 -696
- package/documentation/18-alerts-implementation-summary.md +0 -385
- package/documentation/19-class-based-routing.md +0 -840
- package/documentation/20-websocket-realtime.md +0 -813
- package/documentation/21-cache-system.md +0 -510
- package/documentation/22-job-queue.md +0 -772
- package/documentation/23-sentry-plugin.md +0 -551
- package/documentation/24-testing-utilities.md +0 -1287
- package/documentation/25-api-versioning.md +0 -533
- package/documentation/26-context-store.md +0 -607
- package/documentation/27-dependency-injection.md +0 -329
- package/documentation/28-lifecycle-hooks.md +0 -521
- package/documentation/29-package-structure.md +0 -196
- package/documentation/30-plugin-system.md +0 -414
- package/documentation/31-jwt-authentication.md +0 -597
- package/documentation/32-cli.md +0 -268
- package/documentation/ALERTS-COMPLETE-SUMMARY.md +0 -429
- package/documentation/ALERTS-INDEX.md +0 -330
- package/documentation/ALERTS-QUICK-REFERENCE.md +0 -286
- package/documentation/README.md +0 -178
- package/documentation/index.html +0 -34
- package/modern_framework_paper.md +0 -1870
- package/public/css/style.css +0 -87
- package/public/index.html +0 -34
- package/public/js/app.js +0 -27
- package/src/advanced/cache/InMemoryCacheStore.ts +0 -68
- package/src/advanced/cache/MultiTierCache.ts +0 -194
- package/src/advanced/cache/RedisCacheStore.ts +0 -341
- package/src/advanced/cache/index.ts +0 -5
- package/src/advanced/cache/types.ts +0 -40
- package/src/advanced/graphql/SimpleDataLoader.ts +0 -42
- package/src/advanced/graphql/index.ts +0 -22
- package/src/advanced/graphql/server.ts +0 -252
- package/src/advanced/graphql/types.ts +0 -42
- package/src/advanced/jobs/InMemoryQueueStore.ts +0 -68
- package/src/advanced/jobs/JobQueue.ts +0 -556
- package/src/advanced/jobs/RedisQueueStore.ts +0 -367
- package/src/advanced/jobs/index.ts +0 -5
- package/src/advanced/jobs/types.ts +0 -70
- package/src/advanced/observability/APMManager.ts +0 -163
- package/src/advanced/observability/AlertManager.ts +0 -109
- package/src/advanced/observability/MetricRegistry.ts +0 -151
- package/src/advanced/observability/ObservabilityCenter.ts +0 -304
- package/src/advanced/observability/StructuredLogger.ts +0 -154
- package/src/advanced/observability/TracingManager.ts +0 -117
- package/src/advanced/observability/adapters.ts +0 -304
- package/src/advanced/observability/createObservabilityMiddleware.ts +0 -63
- package/src/advanced/observability/index.ts +0 -11
- package/src/advanced/observability/types.ts +0 -174
- package/src/advanced/playground/extractPathParams.ts +0 -6
- package/src/advanced/playground/generateFieldExample.ts +0 -31
- package/src/advanced/playground/generatePlaygroundHTML.ts +0 -1849
- package/src/advanced/playground/generateSummary.ts +0 -19
- package/src/advanced/playground/getTagFromPath.ts +0 -9
- package/src/advanced/playground/index.ts +0 -8
- package/src/advanced/playground/playground.ts +0 -170
- package/src/advanced/playground/types.ts +0 -20
- package/src/advanced/playground/zodToExample.ts +0 -16
- package/src/advanced/playground/zodToParams.ts +0 -15
- package/src/advanced/postman/buildAuth.ts +0 -31
- package/src/advanced/postman/buildBody.ts +0 -15
- package/src/advanced/postman/buildQueryParams.ts +0 -27
- package/src/advanced/postman/buildRequestItem.ts +0 -36
- package/src/advanced/postman/buildResponses.ts +0 -11
- package/src/advanced/postman/buildUrl.ts +0 -33
- package/src/advanced/postman/capitalize.ts +0 -4
- package/src/advanced/postman/generateCollection.ts +0 -59
- package/src/advanced/postman/generateEnvironment.ts +0 -34
- package/src/advanced/postman/generateExampleFromZod.ts +0 -21
- package/src/advanced/postman/generateFieldExample.ts +0 -45
- package/src/advanced/postman/generateName.ts +0 -20
- package/src/advanced/postman/generateUUID.ts +0 -11
- package/src/advanced/postman/getTagFromPath.ts +0 -10
- package/src/advanced/postman/index.ts +0 -28
- package/src/advanced/postman/postman.ts +0 -156
- package/src/advanced/postman/slugify.ts +0 -7
- package/src/advanced/postman/types.ts +0 -140
- package/src/advanced/realtime/index.ts +0 -18
- package/src/advanced/realtime/websocket.ts +0 -231
- package/src/advanced/sentry/index.ts +0 -1236
- package/src/advanced/sentry/types.ts +0 -355
- package/src/advanced/static/generateDirectoryListing.ts +0 -47
- package/src/advanced/static/generateETag.ts +0 -7
- package/src/advanced/static/getMimeType.ts +0 -9
- package/src/advanced/static/index.ts +0 -32
- package/src/advanced/static/isSafePath.ts +0 -13
- package/src/advanced/static/publicDir.ts +0 -21
- package/src/advanced/static/serveStatic.ts +0 -225
- package/src/advanced/static/spa.ts +0 -24
- package/src/advanced/static/types.ts +0 -159
- package/src/advanced/swagger/SwaggerGenerator.ts +0 -66
- package/src/advanced/swagger/buildOperation.ts +0 -61
- package/src/advanced/swagger/buildParameters.ts +0 -61
- package/src/advanced/swagger/buildRequestBody.ts +0 -21
- package/src/advanced/swagger/buildResponses.ts +0 -54
- package/src/advanced/swagger/capitalize.ts +0 -5
- package/src/advanced/swagger/convertPath.ts +0 -9
- package/src/advanced/swagger/createSwagger.ts +0 -12
- package/src/advanced/swagger/generateOperationId.ts +0 -21
- package/src/advanced/swagger/generateSpec.ts +0 -105
- package/src/advanced/swagger/generateSummary.ts +0 -24
- package/src/advanced/swagger/generateSwaggerUI.ts +0 -70
- package/src/advanced/swagger/generateThemeCss.ts +0 -53
- package/src/advanced/swagger/index.ts +0 -25
- package/src/advanced/swagger/swagger.ts +0 -237
- package/src/advanced/swagger/types.ts +0 -206
- package/src/advanced/swagger/zodFieldToOpenAPI.ts +0 -94
- package/src/advanced/swagger/zodSchemaToOpenAPI.ts +0 -50
- package/src/advanced/swagger/zodToOpenAPI.ts +0 -22
- package/src/advanced/testing/factory.ts +0 -509
- package/src/advanced/testing/harness.ts +0 -612
- package/src/advanced/testing/index.ts +0 -430
- package/src/advanced/testing/load-test.ts +0 -618
- package/src/advanced/testing/mock-server.ts +0 -498
- package/src/advanced/testing/mock.ts +0 -670
- package/src/cli/bin.ts +0 -9
- package/src/cli/cli.ts +0 -158
- package/src/cli/commands/add.ts +0 -178
- package/src/cli/commands/build.ts +0 -73
- package/src/cli/commands/create.ts +0 -166
- package/src/cli/commands/dev.ts +0 -85
- package/src/cli/commands/generate.ts +0 -99
- package/src/cli/commands/help.ts +0 -95
- package/src/cli/commands/init.ts +0 -91
- package/src/cli/commands/version.ts +0 -38
- package/src/cli/index.ts +0 -6
- package/src/cli/templates/generators.ts +0 -359
- package/src/cli/templates/index.ts +0 -680
- package/src/cli/utils/exec.ts +0 -52
- package/src/cli/utils/file-system.ts +0 -78
- package/src/cli/utils/logger.ts +0 -111
- package/src/core/adapter.ts +0 -88
- package/src/core/application.ts +0 -1335
- package/src/core/context-pool.ts +0 -127
- package/src/core/context.ts +0 -412
- package/src/core/index.ts +0 -80
- package/src/core/middleware.ts +0 -262
- package/src/core/performance/buffer-pool.ts +0 -108
- package/src/core/performance/middleware-optimizer.ts +0 -162
- package/src/core/plugin/PluginManager.ts +0 -435
- package/src/core/plugin/builder.ts +0 -358
- package/src/core/plugin/index.ts +0 -50
- package/src/core/plugin/types.ts +0 -214
- package/src/core/router/file-router.ts +0 -594
- package/src/core/router/index.ts +0 -227
- package/src/core/router/radix-tree.ts +0 -226
- package/src/core/store/index.ts +0 -30
- package/src/core/store/registry.ts +0 -178
- package/src/core/store/request-store.ts +0 -240
- package/src/core/store/types.ts +0 -233
- package/src/core/types.ts +0 -574
- package/src/database/adapter.ts +0 -35
- package/src/database/adapters/index.ts +0 -1
- package/src/database/adapters/mysql.ts +0 -669
- package/src/database/database.ts +0 -70
- package/src/database/dialect.ts +0 -388
- package/src/database/index.ts +0 -12
- package/src/database/migrations.ts +0 -86
- package/src/database/optimizer.ts +0 -125
- package/src/database/query-builder.ts +0 -404
- package/src/database/realtime.ts +0 -53
- package/src/database/schema.ts +0 -71
- package/src/database/transactions.ts +0 -56
- package/src/database/types.ts +0 -87
- package/src/deployment/cluster.ts +0 -471
- package/src/deployment/config.ts +0 -454
- package/src/deployment/docker.ts +0 -599
- package/src/deployment/graceful-shutdown.ts +0 -373
- package/src/deployment/index.ts +0 -56
- package/src/index.ts +0 -264
- package/src/security/adapter.ts +0 -318
- package/src/security/auth/JWTPlugin.ts +0 -234
- package/src/security/auth/JWTProvider.ts +0 -316
- package/src/security/auth/adapter.ts +0 -12
- package/src/security/auth/jwt.ts +0 -234
- package/src/security/auth/middleware.ts +0 -188
- package/src/security/csrf.ts +0 -220
- package/src/security/headers.ts +0 -108
- package/src/security/index.ts +0 -60
- package/src/security/rate-limit/adapter.ts +0 -7
- package/src/security/rate-limit/memory.ts +0 -108
- package/src/security/rate-limit/middleware.ts +0 -181
- package/src/security/sanitization.ts +0 -75
- package/src/security/types.ts +0 -240
- package/src/security/utils.ts +0 -52
- package/tsconfig.json +0 -39
|
@@ -1,78 +0,0 @@
|
|
|
1
|
-
import * as fs from 'fs';
|
|
2
|
-
import * as path from 'path';
|
|
3
|
-
|
|
4
|
-
export class FileSystem {
|
|
5
|
-
static async exists(filePath: string): Promise<boolean> {
|
|
6
|
-
try {
|
|
7
|
-
await fs.promises.access(filePath);
|
|
8
|
-
return true;
|
|
9
|
-
} catch {
|
|
10
|
-
return false;
|
|
11
|
-
}
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
static async createDirectory(dirPath: string): Promise<void> {
|
|
15
|
-
await fs.promises.mkdir(dirPath, { recursive: true });
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
static async writeFile(filePath: string, content: string): Promise<void> {
|
|
19
|
-
const dir = path.dirname(filePath);
|
|
20
|
-
await this.createDirectory(dir);
|
|
21
|
-
await fs.promises.writeFile(filePath, content, 'utf-8');
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
static async readFile(filePath: string): Promise<string> {
|
|
25
|
-
return fs.promises.readFile(filePath, 'utf-8');
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
static async copyDirectory(src: string, dest: string): Promise<void> {
|
|
29
|
-
await this.createDirectory(dest);
|
|
30
|
-
const entries = await fs.promises.readdir(src, { withFileTypes: true });
|
|
31
|
-
|
|
32
|
-
for (const entry of entries) {
|
|
33
|
-
const srcPath = path.join(src, entry.name);
|
|
34
|
-
const destPath = path.join(dest, entry.name);
|
|
35
|
-
|
|
36
|
-
if (entry.isDirectory()) {
|
|
37
|
-
await this.copyDirectory(srcPath, destPath);
|
|
38
|
-
} else {
|
|
39
|
-
await fs.promises.copyFile(srcPath, destPath);
|
|
40
|
-
}
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
static async removeDirectory(dirPath: string): Promise<void> {
|
|
45
|
-
if (await this.exists(dirPath)) {
|
|
46
|
-
await fs.promises.rm(dirPath, { recursive: true, force: true });
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
static async listDirectory(dirPath: string): Promise<string[]> {
|
|
51
|
-
return fs.promises.readdir(dirPath);
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
static async isDirectory(filePath: string): Promise<boolean> {
|
|
55
|
-
try {
|
|
56
|
-
const stat = await fs.promises.stat(filePath);
|
|
57
|
-
return stat.isDirectory();
|
|
58
|
-
} catch {
|
|
59
|
-
return false;
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
static resolvePath(...paths: string[]): string {
|
|
64
|
-
return path.resolve(...paths);
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
static joinPath(...paths: string[]): string {
|
|
68
|
-
return path.join(...paths);
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
static getBasename(filePath: string): string {
|
|
72
|
-
return path.basename(filePath);
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
static getDirname(filePath: string): string {
|
|
76
|
-
return path.dirname(filePath);
|
|
77
|
-
}
|
|
78
|
-
}
|
package/src/cli/utils/logger.ts
DELETED
|
@@ -1,111 +0,0 @@
|
|
|
1
|
-
export class Logger {
|
|
2
|
-
colors = {
|
|
3
|
-
reset: '\x1b[0m',
|
|
4
|
-
bright: '\x1b[1m',
|
|
5
|
-
dim: '\x1b[2m',
|
|
6
|
-
red: '\x1b[31m',
|
|
7
|
-
green: '\x1b[32m',
|
|
8
|
-
yellow: '\x1b[33m',
|
|
9
|
-
blue: '\x1b[34m',
|
|
10
|
-
magenta: '\x1b[35m',
|
|
11
|
-
cyan: '\x1b[36m',
|
|
12
|
-
white: '\x1b[37m',
|
|
13
|
-
bgRed: '\x1b[41m',
|
|
14
|
-
bgGreen: '\x1b[42m',
|
|
15
|
-
bgYellow: '\x1b[43m',
|
|
16
|
-
bgBlue: '\x1b[44m',
|
|
17
|
-
};
|
|
18
|
-
|
|
19
|
-
info(message: string): void {
|
|
20
|
-
console.log(`${this.colors.blue}ℹ${this.colors.reset} ${message}`);
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
success(message: string): void {
|
|
24
|
-
console.log(`${this.colors.green}✓${this.colors.reset} ${message}`);
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
warning(message: string): void {
|
|
28
|
-
console.log(`${this.colors.yellow}⚠${this.colors.reset} ${message}`);
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
error(message: string): void {
|
|
32
|
-
console.log(`${this.colors.red}✗${this.colors.reset} ${message}`);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
step(step: number, total: number, message: string): void {
|
|
36
|
-
console.log(
|
|
37
|
-
`${this.colors.cyan}[${step}/${total}]${this.colors.reset} ${message}`
|
|
38
|
-
);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
blank(): void {
|
|
42
|
-
console.log('');
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
header(text: string): void {
|
|
46
|
-
console.log(`\n${this.colors.bright}${this.colors.cyan}${text}${this.colors.reset}\n`);
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
list(items: string[]): void {
|
|
50
|
-
for (const item of items) {
|
|
51
|
-
console.log(` ${this.colors.dim}•${this.colors.reset} ${item}`);
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
box(lines: string[]): void {
|
|
56
|
-
const maxLength = Math.max(...lines.map(l => l.length));
|
|
57
|
-
const border = '─'.repeat(maxLength + 2);
|
|
58
|
-
|
|
59
|
-
console.log(`┌${border}┐`);
|
|
60
|
-
for (const line of lines) {
|
|
61
|
-
const padding = ' '.repeat(maxLength - line.length);
|
|
62
|
-
console.log(`│ ${line}${padding} │`);
|
|
63
|
-
}
|
|
64
|
-
console.log(`└${border}┘`);
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
spinner(message: string): Spinner {
|
|
68
|
-
return new Spinner(message, this);
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
export class Spinner {
|
|
73
|
-
private frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
|
|
74
|
-
private frameIndex = 0;
|
|
75
|
-
private interval: ReturnType<typeof setInterval> | null = null;
|
|
76
|
-
private message: string;
|
|
77
|
-
private logger: Logger;
|
|
78
|
-
|
|
79
|
-
constructor(message: string, logger: Logger) {
|
|
80
|
-
this.message = message;
|
|
81
|
-
this.logger = logger;
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
start(): void {
|
|
85
|
-
process.stdout.write(`${this.logger.colors.cyan}${this.frames[0]}${this.logger.colors.reset} ${this.message}`);
|
|
86
|
-
this.interval = setInterval(() => {
|
|
87
|
-
this.frameIndex = (this.frameIndex + 1) % this.frames.length;
|
|
88
|
-
process.stdout.clearLine(0);
|
|
89
|
-
process.stdout.cursorTo(0);
|
|
90
|
-
process.stdout.write(`${this.logger.colors.cyan}${this.frames[this.frameIndex]}${this.logger.colors.reset} ${this.message}`);
|
|
91
|
-
}, 80);
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
stop(success = true): void {
|
|
95
|
-
if (this.interval) {
|
|
96
|
-
clearInterval(this.interval);
|
|
97
|
-
this.interval = null;
|
|
98
|
-
}
|
|
99
|
-
process.stdout.clearLine(0);
|
|
100
|
-
process.stdout.cursorTo(0);
|
|
101
|
-
if (success) {
|
|
102
|
-
console.log(`${this.logger.colors.green}✓${this.logger.colors.reset} ${this.message}`);
|
|
103
|
-
} else {
|
|
104
|
-
console.log(`${this.logger.colors.red}✗${this.logger.colors.reset} ${this.message}`);
|
|
105
|
-
}
|
|
106
|
-
}
|
|
107
|
-
|
|
108
|
-
update(message: string): void {
|
|
109
|
-
this.message = message;
|
|
110
|
-
}
|
|
111
|
-
}
|
package/src/core/adapter.ts
DELETED
|
@@ -1,88 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Adapter interfaces for extensibility
|
|
3
|
-
* These interfaces define contracts that external implementations must follow
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
/**
|
|
7
|
-
* Logger adapter interface
|
|
8
|
-
* Allows plugging in different logging implementations (winston, pino, etc.)
|
|
9
|
-
*
|
|
10
|
-
* @example
|
|
11
|
-
* ```typescript
|
|
12
|
-
* class PinoAdapter implements LoggerAdapter {
|
|
13
|
-
* private pino = require('pino')();
|
|
14
|
-
* info(message: string, meta?: any) { this.pino.info(meta, message); }
|
|
15
|
-
* // ...
|
|
16
|
-
* }
|
|
17
|
-
* app.adapter('logger', new PinoAdapter());
|
|
18
|
-
* ```
|
|
19
|
-
*/
|
|
20
|
-
export interface LoggerAdapter {
|
|
21
|
-
info(message: string, meta?: any): void;
|
|
22
|
-
warn(message: string, meta?: any): void;
|
|
23
|
-
error(message: string, error?: Error, meta?: any): void;
|
|
24
|
-
debug(message: string, meta?: any): void;
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
/**
|
|
28
|
-
* Cache adapter interface
|
|
29
|
-
* Allows plugging in different cache implementations (Redis, Memcached, etc.)
|
|
30
|
-
*
|
|
31
|
-
* @example
|
|
32
|
-
* ```typescript
|
|
33
|
-
* class RedisAdapter implements CacheAdapter {
|
|
34
|
-
* constructor(private redis: Redis) {}
|
|
35
|
-
* async get<T>(key: string) { return JSON.parse(await this.redis.get(key)); }
|
|
36
|
-
* // ...
|
|
37
|
-
* }
|
|
38
|
-
* app.adapter('cache', new RedisAdapter(redis));
|
|
39
|
-
* ```
|
|
40
|
-
*/
|
|
41
|
-
export interface CacheAdapter {
|
|
42
|
-
get<T>(key: string): Promise<T | null>;
|
|
43
|
-
set<T>(key: string, value: T, ttl?: number): Promise<void>;
|
|
44
|
-
delete(key: string): Promise<void>;
|
|
45
|
-
clear(): Promise<void>;
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
/**
|
|
49
|
-
* Session adapter interface
|
|
50
|
-
* Allows plugging in different session storage (Redis, Database, etc.)
|
|
51
|
-
*
|
|
52
|
-
* @example
|
|
53
|
-
* ```typescript
|
|
54
|
-
* class DatabaseSessionAdapter implements SessionAdapter {
|
|
55
|
-
* async get(sessionId: string) { return await db.sessions.findById(sessionId); }
|
|
56
|
-
* // ...
|
|
57
|
-
* }
|
|
58
|
-
* app.adapter('session', new DatabaseSessionAdapter());
|
|
59
|
-
* ```
|
|
60
|
-
*/
|
|
61
|
-
export interface SessionAdapter {
|
|
62
|
-
get(sessionId: string): Promise<any>;
|
|
63
|
-
set(sessionId: string, data: any, ttl?: number): Promise<void>;
|
|
64
|
-
destroy(sessionId: string): Promise<void>;
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
/**
|
|
68
|
-
* Adapter registry for managing all adapters
|
|
69
|
-
*/
|
|
70
|
-
export class AdapterRegistry {
|
|
71
|
-
private adapters: Map<string, any> = new Map();
|
|
72
|
-
|
|
73
|
-
register<T>(name: string, adapter: T): void {
|
|
74
|
-
this.adapters.set(name, adapter);
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
get<T>(name: string): T | undefined {
|
|
78
|
-
return this.adapters.get(name) as T;
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
has(name: string): boolean {
|
|
82
|
-
return this.adapters.has(name);
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
remove(name: string): boolean {
|
|
86
|
-
return this.adapters.delete(name);
|
|
87
|
-
}
|
|
88
|
-
}
|