@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.
- package/package.json +1 -1
- package/BENCHMARK_REPORT.md +0 -343
- 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 -1956
- 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 -250
- package/src/advanced/playground/types.ts +0 -49
- 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 -1453
- package/src/core/context-pool.ts +0 -79
- package/src/core/context.ts +0 -856
- package/src/core/index.ts +0 -94
- package/src/core/middleware.ts +0 -272
- 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 -623
- package/src/core/router/index.ts +0 -260
- package/src/core/router/radix-tree.ts +0 -242
- package/src/core/serializer.ts +0 -397
- 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 -616
- 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 -281
- 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,174 +0,0 @@
|
|
|
1
|
-
export interface MetricDefinition {
|
|
2
|
-
name: string;
|
|
3
|
-
type: 'counter' | 'histogram' | 'gauge';
|
|
4
|
-
help: string;
|
|
5
|
-
buckets?: number[];
|
|
6
|
-
labels?: string[];
|
|
7
|
-
}
|
|
8
|
-
|
|
9
|
-
export interface TracingOptions {
|
|
10
|
-
enabled: boolean;
|
|
11
|
-
exporter?: 'otlp' | 'jaeger' | 'zipkin' | 'console';
|
|
12
|
-
endpoint?: string;
|
|
13
|
-
serviceName?: string;
|
|
14
|
-
sampleRate?: number;
|
|
15
|
-
alwaysTrace?: string[];
|
|
16
|
-
propagation?: 'w3c' | 'b3' | 'jaeger';
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
export interface LoggingOptions {
|
|
20
|
-
level?: 'debug' | 'info' | 'warn' | 'error';
|
|
21
|
-
format?: 'json' | 'pretty';
|
|
22
|
-
requests?: {
|
|
23
|
-
enabled?: boolean;
|
|
24
|
-
includeBody?: boolean;
|
|
25
|
-
excludePaths?: string[];
|
|
26
|
-
};
|
|
27
|
-
mask?: {
|
|
28
|
-
fields?: string[];
|
|
29
|
-
patterns?: RegExp[];
|
|
30
|
-
replacement?: string;
|
|
31
|
-
};
|
|
32
|
-
correlationId?: {
|
|
33
|
-
enabled?: boolean;
|
|
34
|
-
header?: string;
|
|
35
|
-
generator?: () => string;
|
|
36
|
-
};
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
export interface APMOptions {
|
|
40
|
-
/**
|
|
41
|
-
* Enable APM features
|
|
42
|
-
* Note: For full APM, use Sentry integration which includes
|
|
43
|
-
* enhanced APM with memory leak detection and slow query tracking
|
|
44
|
-
* @default true when observability is enabled
|
|
45
|
-
*/
|
|
46
|
-
enabled?: boolean;
|
|
47
|
-
|
|
48
|
-
/**
|
|
49
|
-
* Slow query threshold in milliseconds
|
|
50
|
-
* @default 1000
|
|
51
|
-
*/
|
|
52
|
-
slowQueryThreshold?: number;
|
|
53
|
-
|
|
54
|
-
/**
|
|
55
|
-
* Memory leak detection options
|
|
56
|
-
*/
|
|
57
|
-
memoryLeakDetection?: {
|
|
58
|
-
enabled?: boolean;
|
|
59
|
-
/**
|
|
60
|
-
* Memory growth threshold percentage (e.g., "50%" or 0.5)
|
|
61
|
-
* @default "50%"
|
|
62
|
-
*/
|
|
63
|
-
threshold?: string | number;
|
|
64
|
-
/**
|
|
65
|
-
* Check interval in milliseconds
|
|
66
|
-
* @default 60000
|
|
67
|
-
*/
|
|
68
|
-
interval?: number;
|
|
69
|
-
};
|
|
70
|
-
|
|
71
|
-
/**
|
|
72
|
-
* Deadlock detection (experimental)
|
|
73
|
-
* @default false
|
|
74
|
-
*/
|
|
75
|
-
deadlockDetection?: boolean;
|
|
76
|
-
|
|
77
|
-
/**
|
|
78
|
-
* Profiling options
|
|
79
|
-
*/
|
|
80
|
-
profiling?: {
|
|
81
|
-
enabled?: boolean;
|
|
82
|
-
sampleRate?: number;
|
|
83
|
-
includeStackTrace?: boolean;
|
|
84
|
-
};
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
export interface AlertDefinition {
|
|
88
|
-
name: string;
|
|
89
|
-
condition: string;
|
|
90
|
-
window: string;
|
|
91
|
-
channels: string[];
|
|
92
|
-
threshold?: number;
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
export interface AlertingOptions {
|
|
96
|
-
enabled?: boolean;
|
|
97
|
-
alerts?: AlertDefinition[];
|
|
98
|
-
channels?: {
|
|
99
|
-
slack?: { webhookUrl: string };
|
|
100
|
-
email?: { recipients: string[] };
|
|
101
|
-
pagerduty?: { routingKey: string };
|
|
102
|
-
webhook?: { url: string };
|
|
103
|
-
telegram?: { botToken: string; chatId: string };
|
|
104
|
-
discord?: { webhookUrl: string };
|
|
105
|
-
console?: {};
|
|
106
|
-
};
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
export interface HealthCheckDefinition {
|
|
110
|
-
name: string;
|
|
111
|
-
check: () => Promise<{ status: 'up' | 'down'; details?: Record<string, any> }>;
|
|
112
|
-
timeout?: number;
|
|
113
|
-
critical?: boolean;
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
export interface ObservabilityOptions {
|
|
117
|
-
metrics?: {
|
|
118
|
-
enabled?: boolean;
|
|
119
|
-
custom?: MetricDefinition[];
|
|
120
|
-
format?: 'prometheus' | 'json';
|
|
121
|
-
endpoint?: string;
|
|
122
|
-
defaultLabels?: Record<string, string>;
|
|
123
|
-
};
|
|
124
|
-
tracing?: TracingOptions;
|
|
125
|
-
logging?: LoggingOptions;
|
|
126
|
-
apm?: APMOptions;
|
|
127
|
-
alerting?: AlertingOptions;
|
|
128
|
-
health?: {
|
|
129
|
-
endpoint?: string;
|
|
130
|
-
checks?: HealthCheckDefinition[];
|
|
131
|
-
};
|
|
132
|
-
}
|
|
133
|
-
|
|
134
|
-
export type HistogramRecord = {
|
|
135
|
-
count: number;
|
|
136
|
-
sum: number;
|
|
137
|
-
buckets: number[];
|
|
138
|
-
bucketBoundaries: number[];
|
|
139
|
-
};
|
|
140
|
-
|
|
141
|
-
export type LabeledMetric<T> = Map<string, T>;
|
|
142
|
-
|
|
143
|
-
export interface GaugeRecord {
|
|
144
|
-
value: number;
|
|
145
|
-
timestamp: number;
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
/**
|
|
149
|
-
* Span for distributed tracing
|
|
150
|
-
*/
|
|
151
|
-
export interface Span {
|
|
152
|
-
traceId: string;
|
|
153
|
-
spanId: string;
|
|
154
|
-
parentSpanId?: string;
|
|
155
|
-
name: string;
|
|
156
|
-
startTime: number;
|
|
157
|
-
endTime?: number;
|
|
158
|
-
duration?: number;
|
|
159
|
-
status: 'ok' | 'error' | 'unset';
|
|
160
|
-
attributes: Record<string, any>;
|
|
161
|
-
events: Array<{ name: string; timestamp: number; attributes?: Record<string, any> }>;
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
/**
|
|
165
|
-
* Structured log entry
|
|
166
|
-
*/
|
|
167
|
-
export interface LogEntry {
|
|
168
|
-
level: 'debug' | 'info' | 'warn' | 'error';
|
|
169
|
-
message: string;
|
|
170
|
-
timestamp: number;
|
|
171
|
-
correlationId?: string;
|
|
172
|
-
context?: Record<string, any>;
|
|
173
|
-
error?: { message: string; stack?: string };
|
|
174
|
-
}
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
import { zodToExample } from './zodToExample';
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
export function generateFieldExample(field: any, fieldName: string): any {
|
|
6
|
-
if (!field?._def) return '';
|
|
7
|
-
const def = field._def;
|
|
8
|
-
const typeName = def.typeName;
|
|
9
|
-
switch (typeName) {
|
|
10
|
-
case 'ZodString': {
|
|
11
|
-
for (const check of def.checks || []) {
|
|
12
|
-
if (check.kind === 'email') return 'user@example.com';
|
|
13
|
-
if (check.kind === 'url') return 'https://example.com';
|
|
14
|
-
if (check.kind === 'uuid') return '550e8400-e29b-41d4-a716-446655440000';
|
|
15
|
-
}
|
|
16
|
-
if (fieldName.toLowerCase().includes('email')) return 'user@example.com';
|
|
17
|
-
if (fieldName.toLowerCase().includes('password')) return 'password123';
|
|
18
|
-
if (fieldName.toLowerCase().includes('name')) return 'John Doe';
|
|
19
|
-
if (fieldName.toLowerCase().includes('username')) return 'johndoe';
|
|
20
|
-
return 'string';
|
|
21
|
-
}
|
|
22
|
-
case 'ZodNumber': return 0;
|
|
23
|
-
case 'ZodBoolean': return true;
|
|
24
|
-
case 'ZodArray': return [];
|
|
25
|
-
case 'ZodObject': return zodToExample(field);
|
|
26
|
-
case 'ZodEnum': return def.values?.[0] || 'enum';
|
|
27
|
-
case 'ZodOptional':
|
|
28
|
-
case 'ZodNullable': return generateFieldExample(def.innerType, fieldName);
|
|
29
|
-
default: return '';
|
|
30
|
-
}
|
|
31
|
-
}
|