@nodestackapp/server 0.0.0-stage → 2.0.0
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/LICENSE +36 -0
- package/README.md +182 -3
- package/bin/nodebase.js +4 -0
- package/bin/nodestack.js +21 -0
- package/dist/NodeBase.d.ts +2 -0
- package/dist/NodeBase.d.ts.map +1 -0
- package/dist/NodeBase.js +8 -0
- package/dist/NodeBase.js.map +1 -0
- package/dist/NodeStack.d.ts +111 -0
- package/dist/NodeStack.d.ts.map +1 -0
- package/dist/NodeStack.js +316 -0
- package/dist/NodeStack.js.map +1 -0
- package/dist/admin/AdminUIBundler.d.ts +8 -0
- package/dist/admin/AdminUIBundler.d.ts.map +1 -0
- package/dist/admin/AdminUIBundler.js +104 -0
- package/dist/admin/AdminUIBundler.js.map +1 -0
- package/dist/admin/AdminUIService.d.ts +30 -0
- package/dist/admin/AdminUIService.d.ts.map +1 -0
- package/dist/admin/AdminUIService.js +210 -0
- package/dist/admin/AdminUIService.js.map +1 -0
- package/dist/admin/DocsService.d.ts +29 -0
- package/dist/admin/DocsService.d.ts.map +1 -0
- package/dist/admin/DocsService.js +564 -0
- package/dist/admin/DocsService.js.map +1 -0
- package/dist/admin/ui/css/analytics.css +382 -0
- package/dist/admin/ui/css/main.css +2189 -0
- package/dist/admin/ui/css/rules.css +292 -0
- package/dist/admin/ui/css/webhooks.css +360 -0
- package/dist/admin/ui/favicon.svg +17 -0
- package/dist/admin/ui/icon.svg +17 -0
- package/dist/admin/ui/index.html +15168 -0
- package/dist/admin/ui/js/analytics.js +673 -0
- package/dist/admin/ui/js/api.js +369 -0
- package/dist/admin/ui/js/app.js +254 -0
- package/dist/admin/ui/js/apps.js +454 -0
- package/dist/admin/ui/js/collections.js +435 -0
- package/dist/admin/ui/js/command-palette.js +631 -0
- package/dist/admin/ui/js/demo.js +661 -0
- package/dist/admin/ui/js/modals.js +2379 -0
- package/dist/admin/ui/js/plugin-tester.js +559 -0
- package/dist/admin/ui/js/plugins.js +778 -0
- package/dist/admin/ui/js/records.js +1270 -0
- package/dist/admin/ui/js/rules.js +775 -0
- package/dist/admin/ui/js/schema.js +290 -0
- package/dist/admin/ui/js/state.js +140 -0
- package/dist/admin/ui/js/theme.js +120 -0
- package/dist/admin/ui/js/views.js +632 -0
- package/dist/admin/ui/js/webhooks.js +1104 -0
- package/dist/analytics/AnalyticsService.d.ts +62 -0
- package/dist/analytics/AnalyticsService.d.ts.map +1 -0
- package/dist/analytics/AnalyticsService.js +196 -0
- package/dist/analytics/AnalyticsService.js.map +1 -0
- package/dist/apps/AppManager.d.ts +28 -0
- package/dist/apps/AppManager.d.ts.map +1 -0
- package/dist/apps/AppManager.js +211 -0
- package/dist/apps/AppManager.js.map +1 -0
- package/dist/apps/AppRegistry.d.ts +27 -0
- package/dist/apps/AppRegistry.d.ts.map +1 -0
- package/dist/apps/AppRegistry.js +220 -0
- package/dist/apps/AppRegistry.js.map +1 -0
- package/dist/apps/AppScope.d.ts +57 -0
- package/dist/apps/AppScope.d.ts.map +1 -0
- package/dist/apps/AppScope.js +299 -0
- package/dist/apps/AppScope.js.map +1 -0
- package/dist/apps/index.d.ts +5 -0
- package/dist/apps/index.d.ts.map +1 -0
- package/dist/apps/index.js +21 -0
- package/dist/apps/index.js.map +1 -0
- package/dist/apps/models/App.d.ts +29 -0
- package/dist/apps/models/App.d.ts.map +1 -0
- package/dist/apps/models/App.js +3 -0
- package/dist/apps/models/App.js.map +1 -0
- package/dist/audit/AuditLogService.d.ts +68 -0
- package/dist/audit/AuditLogService.d.ts.map +1 -0
- package/dist/audit/AuditLogService.js +243 -0
- package/dist/audit/AuditLogService.js.map +1 -0
- package/dist/auth/AuthService.d.ts +35 -0
- package/dist/auth/AuthService.d.ts.map +1 -0
- package/dist/auth/AuthService.js +303 -0
- package/dist/auth/AuthService.js.map +1 -0
- package/dist/cli/cli.d.ts +3 -0
- package/dist/cli/cli.d.ts.map +1 -0
- package/dist/cli/cli.js +541 -0
- package/dist/cli/cli.js.map +1 -0
- package/dist/core/config/ConfigService.d.ts +42 -0
- package/dist/core/config/ConfigService.d.ts.map +1 -0
- package/dist/core/config/ConfigService.js +142 -0
- package/dist/core/config/ConfigService.js.map +1 -0
- package/dist/core/config/EnvLoader.d.ts +7 -0
- package/dist/core/config/EnvLoader.d.ts.map +1 -0
- package/dist/core/config/EnvLoader.js +84 -0
- package/dist/core/config/EnvLoader.js.map +1 -0
- package/dist/core/container/Container.d.ts +34 -0
- package/dist/core/container/Container.d.ts.map +1 -0
- package/dist/core/container/Container.js +98 -0
- package/dist/core/container/Container.js.map +1 -0
- package/dist/core/container/Tokens.d.ts +42 -0
- package/dist/core/container/Tokens.d.ts.map +1 -0
- package/dist/core/container/Tokens.js +42 -0
- package/dist/core/container/Tokens.js.map +1 -0
- package/dist/core/errors/AppError.d.ts +24 -0
- package/dist/core/errors/AppError.d.ts.map +1 -0
- package/dist/core/errors/AppError.js +52 -0
- package/dist/core/errors/AppError.js.map +1 -0
- package/dist/core/events/EventBus.d.ts +45 -0
- package/dist/core/events/EventBus.d.ts.map +1 -0
- package/dist/core/events/EventBus.js +360 -0
- package/dist/core/events/EventBus.js.map +1 -0
- package/dist/core/events/types.d.ts +35 -0
- package/dist/core/events/types.d.ts.map +1 -0
- package/dist/core/events/types.js +3 -0
- package/dist/core/events/types.js.map +1 -0
- package/dist/core/maintenance/MaintenanceGate.d.ts +65 -0
- package/dist/core/maintenance/MaintenanceGate.d.ts.map +1 -0
- package/dist/core/maintenance/MaintenanceGate.js +162 -0
- package/dist/core/maintenance/MaintenanceGate.js.map +1 -0
- package/dist/core/plugins/PluginManager.d.ts +150 -0
- package/dist/core/plugins/PluginManager.d.ts.map +1 -0
- package/dist/core/plugins/PluginManager.js +1592 -0
- package/dist/core/plugins/PluginManager.js.map +1 -0
- package/dist/core/plugins/types.d.ts +170 -0
- package/dist/core/plugins/types.d.ts.map +1 -0
- package/dist/core/plugins/types.js +3 -0
- package/dist/core/plugins/types.js.map +1 -0
- package/dist/database/DatabaseService.d.ts +27 -0
- package/dist/database/DatabaseService.d.ts.map +1 -0
- package/dist/database/DatabaseService.js +97 -0
- package/dist/database/DatabaseService.js.map +1 -0
- package/dist/database/drivers/IDatabaseDriver.d.ts +17 -0
- package/dist/database/drivers/IDatabaseDriver.d.ts.map +1 -0
- package/dist/database/drivers/IDatabaseDriver.js +3 -0
- package/dist/database/drivers/IDatabaseDriver.js.map +1 -0
- package/dist/database/drivers/NodeSqliteDriver.d.ts +16 -0
- package/dist/database/drivers/NodeSqliteDriver.d.ts.map +1 -0
- package/dist/database/drivers/NodeSqliteDriver.js +115 -0
- package/dist/database/drivers/NodeSqliteDriver.js.map +1 -0
- package/dist/database/migrations/SystemMigrations.d.ts +5 -0
- package/dist/database/migrations/SystemMigrations.d.ts.map +1 -0
- package/dist/database/migrations/SystemMigrations.js +164 -0
- package/dist/database/migrations/SystemMigrations.js.map +1 -0
- package/dist/demo/DemoService.d.ts +27 -0
- package/dist/demo/DemoService.d.ts.map +1 -0
- package/dist/demo/DemoService.js +22 -0
- package/dist/demo/DemoService.js.map +1 -0
- package/dist/files/FileStorageService.d.ts +35 -0
- package/dist/files/FileStorageService.d.ts.map +1 -0
- package/dist/files/FileStorageService.js +126 -0
- package/dist/files/FileStorageService.js.map +1 -0
- package/dist/http/HttpServer.d.ts +63 -0
- package/dist/http/HttpServer.d.ts.map +1 -0
- package/dist/http/HttpServer.js +513 -0
- package/dist/http/HttpServer.js.map +1 -0
- package/dist/http/controllers/AnalyticsController.d.ts +9 -0
- package/dist/http/controllers/AnalyticsController.d.ts.map +1 -0
- package/dist/http/controllers/AnalyticsController.js +18 -0
- package/dist/http/controllers/AnalyticsController.js.map +1 -0
- package/dist/http/controllers/AppController.d.ts +29 -0
- package/dist/http/controllers/AppController.d.ts.map +1 -0
- package/dist/http/controllers/AppController.js +36 -0
- package/dist/http/controllers/AppController.js.map +1 -0
- package/dist/http/controllers/AuditLogController.d.ts +26 -0
- package/dist/http/controllers/AuditLogController.d.ts.map +1 -0
- package/dist/http/controllers/AuditLogController.js +32 -0
- package/dist/http/controllers/AuditLogController.js.map +1 -0
- package/dist/http/controllers/AuthController.d.ts +18 -0
- package/dist/http/controllers/AuthController.d.ts.map +1 -0
- package/dist/http/controllers/AuthController.js +84 -0
- package/dist/http/controllers/AuthController.js.map +1 -0
- package/dist/http/controllers/BaseController.d.ts +7 -0
- package/dist/http/controllers/BaseController.d.ts.map +1 -0
- package/dist/http/controllers/BaseController.js +20 -0
- package/dist/http/controllers/BaseController.js.map +1 -0
- package/dist/http/controllers/CollectionController.d.ts +44 -0
- package/dist/http/controllers/CollectionController.d.ts.map +1 -0
- package/dist/http/controllers/CollectionController.js +89 -0
- package/dist/http/controllers/CollectionController.js.map +1 -0
- package/dist/http/controllers/DemoController.d.ts +34 -0
- package/dist/http/controllers/DemoController.d.ts.map +1 -0
- package/dist/http/controllers/DemoController.js +56 -0
- package/dist/http/controllers/DemoController.js.map +1 -0
- package/dist/http/controllers/FileController.d.ts +29 -0
- package/dist/http/controllers/FileController.d.ts.map +1 -0
- package/dist/http/controllers/FileController.js +172 -0
- package/dist/http/controllers/FileController.js.map +1 -0
- package/dist/http/controllers/HealthController.d.ts +10 -0
- package/dist/http/controllers/HealthController.d.ts.map +1 -0
- package/dist/http/controllers/HealthController.js +28 -0
- package/dist/http/controllers/HealthController.js.map +1 -0
- package/dist/http/controllers/LogController.d.ts +15 -0
- package/dist/http/controllers/LogController.d.ts.map +1 -0
- package/dist/http/controllers/LogController.js +25 -0
- package/dist/http/controllers/LogController.js.map +1 -0
- package/dist/http/controllers/RealtimeController.d.ts +13 -0
- package/dist/http/controllers/RealtimeController.d.ts.map +1 -0
- package/dist/http/controllers/RealtimeController.js +54 -0
- package/dist/http/controllers/RealtimeController.js.map +1 -0
- package/dist/http/controllers/RecordController.d.ts +74 -0
- package/dist/http/controllers/RecordController.d.ts.map +1 -0
- package/dist/http/controllers/RecordController.js +202 -0
- package/dist/http/controllers/RecordController.js.map +1 -0
- package/dist/http/controllers/SnapshotController.d.ts +58 -0
- package/dist/http/controllers/SnapshotController.d.ts.map +1 -0
- package/dist/http/controllers/SnapshotController.js +79 -0
- package/dist/http/controllers/SnapshotController.js.map +1 -0
- package/dist/http/controllers/TemplateController.d.ts +29 -0
- package/dist/http/controllers/TemplateController.d.ts.map +1 -0
- package/dist/http/controllers/TemplateController.js +63 -0
- package/dist/http/controllers/TemplateController.js.map +1 -0
- package/dist/http/controllers/WebhookController.d.ts +78 -0
- package/dist/http/controllers/WebhookController.d.ts.map +1 -0
- package/dist/http/controllers/WebhookController.js +113 -0
- package/dist/http/controllers/WebhookController.js.map +1 -0
- package/dist/http/middleware/AppResolutionMiddleware.d.ts +8 -0
- package/dist/http/middleware/AppResolutionMiddleware.d.ts.map +1 -0
- package/dist/http/middleware/AppResolutionMiddleware.js +98 -0
- package/dist/http/middleware/AppResolutionMiddleware.js.map +1 -0
- package/dist/http/middleware/AuthMiddleware.d.ts +17 -0
- package/dist/http/middleware/AuthMiddleware.d.ts.map +1 -0
- package/dist/http/middleware/AuthMiddleware.js +97 -0
- package/dist/http/middleware/AuthMiddleware.js.map +1 -0
- package/dist/http/middleware/ChaosMiddleware.d.ts +130 -0
- package/dist/http/middleware/ChaosMiddleware.d.ts.map +1 -0
- package/dist/http/middleware/ChaosMiddleware.js +434 -0
- package/dist/http/middleware/ChaosMiddleware.js.map +1 -0
- package/dist/index.d.ts +55 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +147 -0
- package/dist/index.js.map +1 -0
- package/dist/logger/LogService.d.ts +31 -0
- package/dist/logger/LogService.d.ts.map +1 -0
- package/dist/logger/LogService.js +104 -0
- package/dist/logger/LogService.js.map +1 -0
- package/dist/plugins/algolia.d.ts +76 -0
- package/dist/plugins/algolia.d.ts.map +1 -0
- package/dist/plugins/algolia.js +532 -0
- package/dist/plugins/algolia.js.map +1 -0
- package/dist/plugins/index.d.ts +6 -0
- package/dist/plugins/index.d.ts.map +1 -0
- package/dist/plugins/index.js +22 -0
- package/dist/plugins/index.js.map +1 -0
- package/dist/plugins/resend.d.ts +42 -0
- package/dist/plugins/resend.d.ts.map +1 -0
- package/dist/plugins/resend.js +335 -0
- package/dist/plugins/resend.js.map +1 -0
- package/dist/plugins/s3.d.ts +35 -0
- package/dist/plugins/s3.d.ts.map +1 -0
- package/dist/plugins/s3.js +425 -0
- package/dist/plugins/s3.js.map +1 -0
- package/dist/plugins/stripe.d.ts +45 -0
- package/dist/plugins/stripe.d.ts.map +1 -0
- package/dist/plugins/stripe.js +470 -0
- package/dist/plugins/stripe.js.map +1 -0
- package/dist/plugins/webhooks.d.ts +35 -0
- package/dist/plugins/webhooks.d.ts.map +1 -0
- package/dist/plugins/webhooks.js +415 -0
- package/dist/plugins/webhooks.js.map +1 -0
- package/dist/realtime/RealtimeService.d.ts +26 -0
- package/dist/realtime/RealtimeService.d.ts.map +1 -0
- package/dist/realtime/RealtimeService.js +165 -0
- package/dist/realtime/RealtimeService.js.map +1 -0
- package/dist/records/CsvHelper.d.ts +27 -0
- package/dist/records/CsvHelper.d.ts.map +1 -0
- package/dist/records/CsvHelper.js +195 -0
- package/dist/records/CsvHelper.js.map +1 -0
- package/dist/records/FakerEngine.d.ts +73 -0
- package/dist/records/FakerEngine.d.ts.map +1 -0
- package/dist/records/FakerEngine.js +644 -0
- package/dist/records/FakerEngine.js.map +1 -0
- package/dist/records/FilterCodec.d.ts +22 -0
- package/dist/records/FilterCodec.d.ts.map +1 -0
- package/dist/records/FilterCodec.js +57 -0
- package/dist/records/FilterCodec.js.map +1 -0
- package/dist/records/FtsService.d.ts +63 -0
- package/dist/records/FtsService.d.ts.map +1 -0
- package/dist/records/FtsService.js +310 -0
- package/dist/records/FtsService.js.map +1 -0
- package/dist/records/MockDataService.d.ts +31 -0
- package/dist/records/MockDataService.d.ts.map +1 -0
- package/dist/records/MockDataService.js +222 -0
- package/dist/records/MockDataService.js.map +1 -0
- package/dist/records/QueryFilterParser.d.ts +35 -0
- package/dist/records/QueryFilterParser.d.ts.map +1 -0
- package/dist/records/QueryFilterParser.js +263 -0
- package/dist/records/QueryFilterParser.js.map +1 -0
- package/dist/records/RecordService.d.ts +77 -0
- package/dist/records/RecordService.d.ts.map +1 -0
- package/dist/records/RecordService.js +704 -0
- package/dist/records/RecordService.js.map +1 -0
- package/dist/rules/RuleBuilder.d.ts +72 -0
- package/dist/rules/RuleBuilder.d.ts.map +1 -0
- package/dist/rules/RuleBuilder.js +383 -0
- package/dist/rules/RuleBuilder.js.map +1 -0
- package/dist/rules/RuleEngine.d.ts +42 -0
- package/dist/rules/RuleEngine.d.ts.map +1 -0
- package/dist/rules/RuleEngine.js +347 -0
- package/dist/rules/RuleEngine.js.map +1 -0
- package/dist/schema/OpenApiGenerator.d.ts +32 -0
- package/dist/schema/OpenApiGenerator.d.ts.map +1 -0
- package/dist/schema/OpenApiGenerator.js +1836 -0
- package/dist/schema/OpenApiGenerator.js.map +1 -0
- package/dist/schema/SchemaInferenceService.d.ts +82 -0
- package/dist/schema/SchemaInferenceService.d.ts.map +1 -0
- package/dist/schema/SchemaInferenceService.js +622 -0
- package/dist/schema/SchemaInferenceService.js.map +1 -0
- package/dist/schema/SchemaService.d.ts +33 -0
- package/dist/schema/SchemaService.d.ts.map +1 -0
- package/dist/schema/SchemaService.js +338 -0
- package/dist/schema/SchemaService.js.map +1 -0
- package/dist/schema/TypeGenerator.d.ts +19 -0
- package/dist/schema/TypeGenerator.d.ts.map +1 -0
- package/dist/schema/TypeGenerator.js +173 -0
- package/dist/schema/TypeGenerator.js.map +1 -0
- package/dist/schema/models/Collection.d.ts +44 -0
- package/dist/schema/models/Collection.d.ts.map +1 -0
- package/dist/schema/models/Collection.js +3 -0
- package/dist/schema/models/Collection.js.map +1 -0
- package/dist/schema/models/Field.d.ts +25 -0
- package/dist/schema/models/Field.d.ts.map +1 -0
- package/dist/schema/models/Field.js +3 -0
- package/dist/schema/models/Field.js.map +1 -0
- package/dist/snapshots/SnapshotService.d.ts +75 -0
- package/dist/snapshots/SnapshotService.d.ts.map +1 -0
- package/dist/snapshots/SnapshotService.js +775 -0
- package/dist/snapshots/SnapshotService.js.map +1 -0
- package/dist/snapshots/types.d.ts +63 -0
- package/dist/snapshots/types.d.ts.map +1 -0
- package/dist/snapshots/types.js +5 -0
- package/dist/snapshots/types.js.map +1 -0
- package/dist/templates/TemplateImageGenerator.d.ts +43 -0
- package/dist/templates/TemplateImageGenerator.d.ts.map +1 -0
- package/dist/templates/TemplateImageGenerator.js +350 -0
- package/dist/templates/TemplateImageGenerator.js.map +1 -0
- package/dist/templates/TemplateService.d.ts +31 -0
- package/dist/templates/TemplateService.d.ts.map +1 -0
- package/dist/templates/TemplateService.js +209 -0
- package/dist/templates/TemplateService.js.map +1 -0
- package/dist/templates/definitions/blog.d.ts +3 -0
- package/dist/templates/definitions/blog.d.ts.map +1 -0
- package/dist/templates/definitions/blog.js +386 -0
- package/dist/templates/definitions/blog.js.map +1 -0
- package/dist/templates/definitions/crm.d.ts +3 -0
- package/dist/templates/definitions/crm.d.ts.map +1 -0
- package/dist/templates/definitions/crm.js +456 -0
- package/dist/templates/definitions/crm.js.map +1 -0
- package/dist/templates/definitions/ecommerce.d.ts +3 -0
- package/dist/templates/definitions/ecommerce.d.ts.map +1 -0
- package/dist/templates/definitions/ecommerce.js +781 -0
- package/dist/templates/definitions/ecommerce.js.map +1 -0
- package/dist/templates/definitions/index.d.ts +7 -0
- package/dist/templates/definitions/index.d.ts.map +1 -0
- package/dist/templates/definitions/index.js +15 -0
- package/dist/templates/definitions/index.js.map +1 -0
- package/dist/templates/types.d.ts +65 -0
- package/dist/templates/types.d.ts.map +1 -0
- package/dist/templates/types.js +3 -0
- package/dist/templates/types.js.map +1 -0
- package/dist/webhooks/WebhookService.d.ts +149 -0
- package/dist/webhooks/WebhookService.d.ts.map +1 -0
- package/dist/webhooks/WebhookService.js +781 -0
- package/dist/webhooks/WebhookService.js.map +1 -0
- package/package.json +88 -6
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.AuthMiddleware = void 0;
|
|
4
|
+
class AuthMiddleware {
|
|
5
|
+
authService;
|
|
6
|
+
constructor(authService) {
|
|
7
|
+
this.authService = authService;
|
|
8
|
+
}
|
|
9
|
+
getAuthService(req) {
|
|
10
|
+
return req?.appScope?.auth || this.authService;
|
|
11
|
+
}
|
|
12
|
+
async handle(req, _reply) {
|
|
13
|
+
req.auth = null;
|
|
14
|
+
let token;
|
|
15
|
+
// Check Authorization header
|
|
16
|
+
const authHeader = req.headers.authorization;
|
|
17
|
+
if (authHeader && authHeader.startsWith('Bearer ')) {
|
|
18
|
+
token = authHeader.substring(7).trim();
|
|
19
|
+
}
|
|
20
|
+
else if (req.query && typeof req.query.token === 'string') {
|
|
21
|
+
// Allow token via query param (useful for SSE and file downloads)
|
|
22
|
+
token = req.query.token;
|
|
23
|
+
}
|
|
24
|
+
else if (req.url && req.url.includes('?')) {
|
|
25
|
+
try {
|
|
26
|
+
const queryIndex = req.url.indexOf('?');
|
|
27
|
+
const qs = new URLSearchParams(req.url.slice(queryIndex + 1));
|
|
28
|
+
const qToken = qs.get('token');
|
|
29
|
+
if (qToken) {
|
|
30
|
+
token = qToken;
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
catch { }
|
|
34
|
+
}
|
|
35
|
+
if (token) {
|
|
36
|
+
const authService = this.getAuthService(req);
|
|
37
|
+
try {
|
|
38
|
+
req.auth = authService.verifyToken(token);
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
// If scoped verification failed (e.g. app-scoped collection token or scoped admin mismatch),
|
|
42
|
+
// fallback to default authService if the token is a valid global admin token.
|
|
43
|
+
if (authService !== this.authService) {
|
|
44
|
+
try {
|
|
45
|
+
const adminClaims = this.authService.verifyToken(token);
|
|
46
|
+
if (adminClaims && adminClaims.isAdmin) {
|
|
47
|
+
req.auth = adminClaims;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
// Leave req.auth as null so route can determine if auth is required
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
requireAdmin() {
|
|
58
|
+
return async (req, reply) => {
|
|
59
|
+
await this.handle(req, reply);
|
|
60
|
+
if (!req.auth || !req.auth.isAdmin) {
|
|
61
|
+
reply.status(403).send({
|
|
62
|
+
statusCode: 403,
|
|
63
|
+
message: 'Only admins are authorized to access this resource',
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
requireAdminOrInitialSetup() {
|
|
69
|
+
return async (req, reply) => {
|
|
70
|
+
await this.handle(req, reply);
|
|
71
|
+
const authService = this.getAuthService(req);
|
|
72
|
+
const hasAdmins = authService.hasAdmins() || this.authService.hasAdmins();
|
|
73
|
+
if (!hasAdmins) {
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
if (!req.auth || !req.auth.isAdmin) {
|
|
77
|
+
reply.status(403).send({
|
|
78
|
+
statusCode: 403,
|
|
79
|
+
message: 'Only admins are authorized to access this resource',
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
requireAuth() {
|
|
85
|
+
return async (req, reply) => {
|
|
86
|
+
await this.handle(req, reply);
|
|
87
|
+
if (!req.auth) {
|
|
88
|
+
reply.status(401).send({
|
|
89
|
+
statusCode: 401,
|
|
90
|
+
message: 'Authentication required to access this resource',
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
exports.AuthMiddleware = AuthMiddleware;
|
|
97
|
+
//# sourceMappingURL=AuthMiddleware.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AuthMiddleware.js","sourceRoot":"","sources":["../../../src/http/middleware/AuthMiddleware.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { FastifyRequest, FastifyReply } from 'fastify';
|
|
2
|
+
import { ConfigService } from '../../core/config/ConfigService';
|
|
3
|
+
export interface ChaosSimulationConfig {
|
|
4
|
+
enabled?: boolean;
|
|
5
|
+
chaosEnabled?: boolean;
|
|
6
|
+
maxMockDelayMs?: number;
|
|
7
|
+
mockDelay?: number | string;
|
|
8
|
+
mockError?: number | string;
|
|
9
|
+
mockFailRate?: number;
|
|
10
|
+
mockJitter?: number;
|
|
11
|
+
mockErrorMessage?: string;
|
|
12
|
+
rng?: () => number;
|
|
13
|
+
}
|
|
14
|
+
export interface RequestSimulationParams {
|
|
15
|
+
delay?: number;
|
|
16
|
+
errorStatus?: number | 'drop';
|
|
17
|
+
failRate?: number;
|
|
18
|
+
jitter?: number;
|
|
19
|
+
errorMessage?: string;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* ChaosMiddleware simulates real-world mobile network latency, intermittent network drops,
|
|
23
|
+
* and HTTP server errors. This allows frontend developers to test loading spinners,
|
|
24
|
+
* skeleton placeholders, error boundary toasts, and retry logic locally against SQLite.
|
|
25
|
+
*
|
|
26
|
+
* Security: Gated behind development/feature flag (chaosEnabled) or admin authorization.
|
|
27
|
+
* Critical system endpoints (/api/health, /api/admins/auth-with-password) are immune to chaos.
|
|
28
|
+
*/
|
|
29
|
+
export declare class ChaosMiddleware {
|
|
30
|
+
private config;
|
|
31
|
+
private configService?;
|
|
32
|
+
private rng;
|
|
33
|
+
/**
|
|
34
|
+
* Protected system endpoints that must NEVER be disrupted by request-driven chaos parameters.
|
|
35
|
+
* Health probes, liveness checks, and admin auth endpoints must remain available and responsive.
|
|
36
|
+
*/
|
|
37
|
+
private static readonly PROTECTED_PATHS;
|
|
38
|
+
constructor(configServiceOrConfig?: ConfigService | ChaosSimulationConfig);
|
|
39
|
+
/**
|
|
40
|
+
* Inject a custom / deterministic RNG for testing or simulation.
|
|
41
|
+
*/
|
|
42
|
+
setRng(rng: () => number): void;
|
|
43
|
+
/**
|
|
44
|
+
* Restore the default Math.random generator.
|
|
45
|
+
*/
|
|
46
|
+
resetRng(): void;
|
|
47
|
+
/**
|
|
48
|
+
* Checks whether the requested URL pathname is a protected system endpoint.
|
|
49
|
+
*/
|
|
50
|
+
isProtectedPath(url: string): boolean;
|
|
51
|
+
/**
|
|
52
|
+
* Determines whether request-driven chaos parameters (query params or headers)
|
|
53
|
+
* are permitted for the current request.
|
|
54
|
+
*
|
|
55
|
+
* Gated behind:
|
|
56
|
+
* 1. Authenticated admin caller (req.auth?.isAdmin === true), OR
|
|
57
|
+
* 2. Explicit development / feature flag (dev mode or chaosEnabled: true).
|
|
58
|
+
*
|
|
59
|
+
* In production (NODE_ENV === 'production' or dev: false), unauthenticated callers
|
|
60
|
+
* cannot trigger latency or errors.
|
|
61
|
+
*/
|
|
62
|
+
isRequestChaosAllowed(req: FastifyRequest): boolean;
|
|
63
|
+
/**
|
|
64
|
+
* Dynamically update global chaos simulation options at runtime.
|
|
65
|
+
*/
|
|
66
|
+
setOptions(options: Partial<ChaosSimulationConfig>): void;
|
|
67
|
+
/**
|
|
68
|
+
* Get current simulation options.
|
|
69
|
+
*/
|
|
70
|
+
getOptions(): ChaosSimulationConfig;
|
|
71
|
+
/**
|
|
72
|
+
* Reset simulation options to clean defaults.
|
|
73
|
+
*/
|
|
74
|
+
reset(): void;
|
|
75
|
+
/**
|
|
76
|
+
* Helper to set delay in milliseconds.
|
|
77
|
+
*/
|
|
78
|
+
setDelay(delayMs?: number | string): void;
|
|
79
|
+
/**
|
|
80
|
+
* Helper to set fail rate between 0.0 and 1.0 (or percentage).
|
|
81
|
+
*/
|
|
82
|
+
setFailRate(rate?: number): void;
|
|
83
|
+
/**
|
|
84
|
+
* Helper to set mock error status code.
|
|
85
|
+
*/
|
|
86
|
+
setError(status?: number | string): void;
|
|
87
|
+
/**
|
|
88
|
+
* Fastify onRequest hook handler.
|
|
89
|
+
* Returns true if the request was handled / short-circuited (e.g. simulated error or socket drop),
|
|
90
|
+
* or false if processing should continue normally.
|
|
91
|
+
*/
|
|
92
|
+
handle(req: FastifyRequest, reply: FastifyReply): Promise<boolean>;
|
|
93
|
+
/**
|
|
94
|
+
* Resolves simulation parameters by checking:
|
|
95
|
+
* 1. Query parameters (?mock_delay=1500, ?mock_error=500, ?mock_fail_rate=0.2)
|
|
96
|
+
* 2. Request headers (x-mock-delay: 1500, x-mock-error: 500, x-mock-fail-rate: 0.2)
|
|
97
|
+
* 3. ConfigService / Server global options
|
|
98
|
+
*/
|
|
99
|
+
resolveParams(req: FastifyRequest): RequestSimulationParams | null;
|
|
100
|
+
/**
|
|
101
|
+
* Evaluates whether a request should fail based on errorStatus and failRate.
|
|
102
|
+
*/
|
|
103
|
+
shouldFail(params: RequestSimulationParams): boolean;
|
|
104
|
+
/**
|
|
105
|
+
* Parse delay into milliseconds. Supports:
|
|
106
|
+
* - 1500 or "1500" -> 1500
|
|
107
|
+
* - "1.5s" -> 1500
|
|
108
|
+
* - "500ms" -> 500
|
|
109
|
+
* - "500-1500" or "500..1500" (random range)
|
|
110
|
+
*/
|
|
111
|
+
parseDelay(rawVal: any, jitter?: number): number | undefined;
|
|
112
|
+
private parseSingleDuration;
|
|
113
|
+
parseJitter(rawVal: any): number;
|
|
114
|
+
/**
|
|
115
|
+
* Parse fail rate between 0.0 and 1.0. Supports:
|
|
116
|
+
* - 0.2 -> 0.2
|
|
117
|
+
* - "0.2" -> 0.2
|
|
118
|
+
* - "20%" -> 0.2
|
|
119
|
+
* - 20 (interpreted as 20% if > 1)
|
|
120
|
+
*/
|
|
121
|
+
parseFailRate(rawVal: any): number | undefined;
|
|
122
|
+
/**
|
|
123
|
+
* Parse mock error status code or special mode. Supports:
|
|
124
|
+
* - 500, 503, 404, etc.
|
|
125
|
+
* - 'drop' / 'hangup' for socket destruction
|
|
126
|
+
*/
|
|
127
|
+
parseErrorStatus(rawVal: any): number | 'drop' | undefined;
|
|
128
|
+
private sleep;
|
|
129
|
+
}
|
|
130
|
+
//# sourceMappingURL=ChaosMiddleware.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ChaosMiddleware.d.ts","sourceRoot":"","sources":["../../../src/http/middleware/ChaosMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,GAAG,CAAe;IAE1B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CASrC;IAEF,YAAY,qBAAqB,CAAC,EAAE,aAAa,GAAG,qBAAqB,EAkCxE;IAED;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,IAAI,CAErC;IAED;;OAEG;IACI,QAAQ,IAAI,IAAI,CAEtB;IAED;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK3C;IAED;;;;;;;;;;OAUG;IACI,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAgBzD;IAED;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAK/D;IAED;;OAEG;IACI,UAAU,IAAI,qBAAqB,CAEzC;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAMnB;IAED;;OAEG;IACI,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE/C;IAED;;OAEG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED;;OAEG;IACI,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9C;IAED;;;;OAIG;IACU,MAAM,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAuE9E;IAED;;;;;OAKG;IACI,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,uBAAuB,GAAG,IAAI,CA6ExE;IAED;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAa1D;IAED;;;;;;OAMG;IACI,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,SAAI,GAAG,MAAM,GAAG,SAAS,CA8C7D;IAED,OAAO,CAAC,mBAAmB;IAWpB,WAAW,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAItC;IAED;;;;;;OAMG;IACI,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CA2BpD;IAED;;;;OAIG;IACI,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBhE;IAED,OAAO,CAAC,KAAK;CAGd"}
|
|
@@ -0,0 +1,434 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ChaosMiddleware = void 0;
|
|
4
|
+
const ConfigService_1 = require("../../core/config/ConfigService");
|
|
5
|
+
/**
|
|
6
|
+
* ChaosMiddleware simulates real-world mobile network latency, intermittent network drops,
|
|
7
|
+
* and HTTP server errors. This allows frontend developers to test loading spinners,
|
|
8
|
+
* skeleton placeholders, error boundary toasts, and retry logic locally against SQLite.
|
|
9
|
+
*
|
|
10
|
+
* Security: Gated behind development/feature flag (chaosEnabled) or admin authorization.
|
|
11
|
+
* Critical system endpoints (/api/health, /api/admins/auth-with-password) are immune to chaos.
|
|
12
|
+
*/
|
|
13
|
+
class ChaosMiddleware {
|
|
14
|
+
config;
|
|
15
|
+
configService;
|
|
16
|
+
rng;
|
|
17
|
+
/**
|
|
18
|
+
* Protected system endpoints that must NEVER be disrupted by request-driven chaos parameters.
|
|
19
|
+
* Health probes, liveness checks, and admin auth endpoints must remain available and responsive.
|
|
20
|
+
*/
|
|
21
|
+
static PROTECTED_PATHS = [
|
|
22
|
+
'/api/health',
|
|
23
|
+
'/api/settings',
|
|
24
|
+
'/api/admins/auth-with-password',
|
|
25
|
+
'/api/admins/create-initial',
|
|
26
|
+
'/api/admins/has-admins',
|
|
27
|
+
'/api/admins/me',
|
|
28
|
+
'/api/demo/reset',
|
|
29
|
+
'/api/realtime',
|
|
30
|
+
];
|
|
31
|
+
constructor(configServiceOrConfig) {
|
|
32
|
+
if (configServiceOrConfig instanceof ConfigService_1.ConfigService) {
|
|
33
|
+
this.configService = configServiceOrConfig;
|
|
34
|
+
this.config = {
|
|
35
|
+
enabled: true,
|
|
36
|
+
chaosEnabled: configServiceOrConfig.chaosEnabled,
|
|
37
|
+
maxMockDelayMs: configServiceOrConfig.maxMockDelayMs,
|
|
38
|
+
mockDelay: configServiceOrConfig.mockDelay,
|
|
39
|
+
mockError: configServiceOrConfig.mockError,
|
|
40
|
+
mockFailRate: configServiceOrConfig.mockFailRate,
|
|
41
|
+
mockJitter: configServiceOrConfig.mockJitter,
|
|
42
|
+
mockErrorMessage: configServiceOrConfig.mockErrorMessage,
|
|
43
|
+
};
|
|
44
|
+
this.rng = () => Math.random();
|
|
45
|
+
}
|
|
46
|
+
else if (configServiceOrConfig && typeof configServiceOrConfig === 'object') {
|
|
47
|
+
this.config = {
|
|
48
|
+
enabled: configServiceOrConfig.enabled ?? true,
|
|
49
|
+
chaosEnabled: configServiceOrConfig.chaosEnabled ?? true,
|
|
50
|
+
maxMockDelayMs: configServiceOrConfig.maxMockDelayMs ?? 15000,
|
|
51
|
+
mockDelay: configServiceOrConfig.mockDelay,
|
|
52
|
+
mockError: configServiceOrConfig.mockError,
|
|
53
|
+
mockFailRate: configServiceOrConfig.mockFailRate,
|
|
54
|
+
mockJitter: configServiceOrConfig.mockJitter,
|
|
55
|
+
mockErrorMessage: configServiceOrConfig.mockErrorMessage,
|
|
56
|
+
};
|
|
57
|
+
this.rng = configServiceOrConfig.rng || (() => Math.random());
|
|
58
|
+
}
|
|
59
|
+
else {
|
|
60
|
+
this.config = {
|
|
61
|
+
enabled: true,
|
|
62
|
+
chaosEnabled: true,
|
|
63
|
+
maxMockDelayMs: 15000,
|
|
64
|
+
};
|
|
65
|
+
this.rng = () => Math.random();
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Inject a custom / deterministic RNG for testing or simulation.
|
|
70
|
+
*/
|
|
71
|
+
setRng(rng) {
|
|
72
|
+
this.rng = rng;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Restore the default Math.random generator.
|
|
76
|
+
*/
|
|
77
|
+
resetRng() {
|
|
78
|
+
this.rng = () => Math.random();
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Checks whether the requested URL pathname is a protected system endpoint.
|
|
82
|
+
*/
|
|
83
|
+
isProtectedPath(url) {
|
|
84
|
+
const pathname = url.split('?')[0].toLowerCase();
|
|
85
|
+
return ChaosMiddleware.PROTECTED_PATHS.some((path) => pathname === path || pathname === `${path}/`);
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Determines whether request-driven chaos parameters (query params or headers)
|
|
89
|
+
* are permitted for the current request.
|
|
90
|
+
*
|
|
91
|
+
* Gated behind:
|
|
92
|
+
* 1. Authenticated admin caller (req.auth?.isAdmin === true), OR
|
|
93
|
+
* 2. Explicit development / feature flag (dev mode or chaosEnabled: true).
|
|
94
|
+
*
|
|
95
|
+
* In production (NODE_ENV === 'production' or dev: false), unauthenticated callers
|
|
96
|
+
* cannot trigger latency or errors.
|
|
97
|
+
*/
|
|
98
|
+
isRequestChaosAllowed(req) {
|
|
99
|
+
// 1. Authenticated admins are always authorized
|
|
100
|
+
if (req.auth && req.auth.isAdmin) {
|
|
101
|
+
return true;
|
|
102
|
+
}
|
|
103
|
+
// 2. Explicit feature flag in config
|
|
104
|
+
if (this.config.chaosEnabled !== undefined) {
|
|
105
|
+
return this.config.chaosEnabled;
|
|
106
|
+
}
|
|
107
|
+
if (this.configService) {
|
|
108
|
+
return this.configService.chaosEnabled;
|
|
109
|
+
}
|
|
110
|
+
return process.env.NODE_ENV !== 'production';
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Dynamically update global chaos simulation options at runtime.
|
|
114
|
+
*/
|
|
115
|
+
setOptions(options) {
|
|
116
|
+
this.config = {
|
|
117
|
+
...this.config,
|
|
118
|
+
...options,
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Get current simulation options.
|
|
123
|
+
*/
|
|
124
|
+
getOptions() {
|
|
125
|
+
return { ...this.config };
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* Reset simulation options to clean defaults.
|
|
129
|
+
*/
|
|
130
|
+
reset() {
|
|
131
|
+
this.config = {
|
|
132
|
+
enabled: true,
|
|
133
|
+
chaosEnabled: this.configService ? this.configService.chaosEnabled : true,
|
|
134
|
+
maxMockDelayMs: this.configService ? this.configService.maxMockDelayMs : 15000,
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* Helper to set delay in milliseconds.
|
|
139
|
+
*/
|
|
140
|
+
setDelay(delayMs) {
|
|
141
|
+
this.config.mockDelay = delayMs;
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* Helper to set fail rate between 0.0 and 1.0 (or percentage).
|
|
145
|
+
*/
|
|
146
|
+
setFailRate(rate) {
|
|
147
|
+
this.config.mockFailRate = rate;
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Helper to set mock error status code.
|
|
151
|
+
*/
|
|
152
|
+
setError(status) {
|
|
153
|
+
this.config.mockError = status;
|
|
154
|
+
}
|
|
155
|
+
/**
|
|
156
|
+
* Fastify onRequest hook handler.
|
|
157
|
+
* Returns true if the request was handled / short-circuited (e.g. simulated error or socket drop),
|
|
158
|
+
* or false if processing should continue normally.
|
|
159
|
+
*/
|
|
160
|
+
async handle(req, reply) {
|
|
161
|
+
// Never simulate chaos on CORS preflight OPTIONS requests
|
|
162
|
+
if (req.method === 'OPTIONS') {
|
|
163
|
+
return false;
|
|
164
|
+
}
|
|
165
|
+
if (this.config.enabled === false) {
|
|
166
|
+
return false;
|
|
167
|
+
}
|
|
168
|
+
const params = this.resolveParams(req);
|
|
169
|
+
if (!params) {
|
|
170
|
+
return false;
|
|
171
|
+
}
|
|
172
|
+
// 1. Latency Simulation
|
|
173
|
+
if (params.delay && params.delay > 0) {
|
|
174
|
+
reply.header('x-simulated-delay', String(params.delay));
|
|
175
|
+
await this.sleep(params.delay);
|
|
176
|
+
}
|
|
177
|
+
// 2. Chaos / Error Simulation
|
|
178
|
+
const shouldFail = this.shouldFail(params);
|
|
179
|
+
if (shouldFail) {
|
|
180
|
+
// Simulate raw TCP socket drop / connection hangup if requested
|
|
181
|
+
if (params.errorStatus === 'drop') {
|
|
182
|
+
// Explicitly hijack Fastify reply so Fastify halts request lifecycle
|
|
183
|
+
// and does NOT execute subsequent hooks, body parsers, or route handlers!
|
|
184
|
+
if (typeof reply.hijack === 'function') {
|
|
185
|
+
reply.hijack();
|
|
186
|
+
}
|
|
187
|
+
if (req.raw && typeof req.raw.destroy === 'function') {
|
|
188
|
+
req.raw.destroy();
|
|
189
|
+
}
|
|
190
|
+
if (reply.raw && typeof reply.raw.destroy === 'function' && !reply.raw.destroyed) {
|
|
191
|
+
reply.raw.destroy();
|
|
192
|
+
}
|
|
193
|
+
return true;
|
|
194
|
+
}
|
|
195
|
+
const statusCode = typeof params.errorStatus === 'number' ? params.errorStatus : 500;
|
|
196
|
+
const message = params.errorMessage ||
|
|
197
|
+
(params.errorStatus && params.errorStatus !== 500
|
|
198
|
+
? `Simulated chaos error (mock_error=${statusCode})`
|
|
199
|
+
: params.failRate !== undefined
|
|
200
|
+
? `Simulated network drop (mock_fail_rate=${params.failRate})`
|
|
201
|
+
: `Simulated chaos error (mock_error=${statusCode})`);
|
|
202
|
+
reply.header('x-simulated-chaos', 'true');
|
|
203
|
+
reply.header('x-simulated-error', String(statusCode));
|
|
204
|
+
if (params.failRate !== undefined) {
|
|
205
|
+
reply.header('x-simulated-fail-rate', String(params.failRate));
|
|
206
|
+
}
|
|
207
|
+
// Fastify reply short-circuits route execution
|
|
208
|
+
await reply.status(statusCode).send({
|
|
209
|
+
statusCode,
|
|
210
|
+
message,
|
|
211
|
+
chaos: true,
|
|
212
|
+
data: {
|
|
213
|
+
simulated: true,
|
|
214
|
+
mockError: statusCode,
|
|
215
|
+
mockFailRate: params.failRate,
|
|
216
|
+
mockDelay: params.delay,
|
|
217
|
+
},
|
|
218
|
+
});
|
|
219
|
+
return true;
|
|
220
|
+
}
|
|
221
|
+
return false;
|
|
222
|
+
}
|
|
223
|
+
/**
|
|
224
|
+
* Resolves simulation parameters by checking:
|
|
225
|
+
* 1. Query parameters (?mock_delay=1500, ?mock_error=500, ?mock_fail_rate=0.2)
|
|
226
|
+
* 2. Request headers (x-mock-delay: 1500, x-mock-error: 500, x-mock-fail-rate: 0.2)
|
|
227
|
+
* 3. ConfigService / Server global options
|
|
228
|
+
*/
|
|
229
|
+
resolveParams(req) {
|
|
230
|
+
const isProtected = this.isProtectedPath(req.url);
|
|
231
|
+
const allowRequestParams = !isProtected && this.isRequestChaosAllowed(req);
|
|
232
|
+
const query = req.query || {};
|
|
233
|
+
const headers = req.headers || {};
|
|
234
|
+
// Helper to find first defined value among multiple keys
|
|
235
|
+
const getQueryVal = (...keys) => {
|
|
236
|
+
if (!allowRequestParams)
|
|
237
|
+
return undefined;
|
|
238
|
+
for (const k of keys) {
|
|
239
|
+
if (query[k] !== undefined && query[k] !== null && query[k] !== '') {
|
|
240
|
+
return query[k];
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
return undefined;
|
|
244
|
+
};
|
|
245
|
+
const getHeaderVal = (...keys) => {
|
|
246
|
+
if (!allowRequestParams)
|
|
247
|
+
return undefined;
|
|
248
|
+
for (const k of keys) {
|
|
249
|
+
const val = headers[k.toLowerCase()];
|
|
250
|
+
if (val !== undefined && val !== null && val !== '') {
|
|
251
|
+
return val;
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
return undefined;
|
|
255
|
+
};
|
|
256
|
+
// Raw values: query overrides header overrides config (unless protected path)
|
|
257
|
+
const rawDelay = getQueryVal('mock_delay', 'mockDelay', 'mock-delay', 'delay') ??
|
|
258
|
+
getHeaderVal('x-mock-delay', 'mock-delay', 'x-delay') ??
|
|
259
|
+
(!isProtected ? this.config.mockDelay : undefined);
|
|
260
|
+
const rawJitter = getQueryVal('mock_jitter', 'mockJitter', 'mock-jitter') ??
|
|
261
|
+
getHeaderVal('x-mock-jitter', 'mock-jitter') ??
|
|
262
|
+
(!isProtected ? this.config.mockJitter : undefined);
|
|
263
|
+
const rawError = getQueryVal('mock_error', 'mockError', 'mock-error') ??
|
|
264
|
+
getHeaderVal('x-mock-error', 'mock-error') ??
|
|
265
|
+
(!isProtected ? this.config.mockError : undefined);
|
|
266
|
+
const rawFailRate = getQueryVal('mock_fail_rate', 'mockFailRate', 'mock-fail-rate', 'mock_failure_rate', 'mockFailureRate') ??
|
|
267
|
+
getHeaderVal('x-mock-fail-rate', 'mock-fail-rate', 'x-mock-failure-rate', 'mock-failure-rate') ??
|
|
268
|
+
(!isProtected ? this.config.mockFailRate : undefined);
|
|
269
|
+
const rawErrorMessage = getQueryVal('mock_error_message', 'mockErrorMessage', 'mock-error-message') ??
|
|
270
|
+
getHeaderVal('x-mock-error-message', 'mock-error-message') ??
|
|
271
|
+
(!isProtected ? this.config.mockErrorMessage : undefined);
|
|
272
|
+
// If nothing is configured or requested on this request, skip
|
|
273
|
+
if (rawDelay === undefined &&
|
|
274
|
+
rawError === undefined &&
|
|
275
|
+
rawFailRate === undefined &&
|
|
276
|
+
rawJitter === undefined) {
|
|
277
|
+
return null;
|
|
278
|
+
}
|
|
279
|
+
const jitter = this.parseJitter(rawJitter);
|
|
280
|
+
const delay = this.parseDelay(rawDelay, jitter);
|
|
281
|
+
const errorStatus = this.parseErrorStatus(rawError);
|
|
282
|
+
const failRate = this.parseFailRate(rawFailRate);
|
|
283
|
+
return {
|
|
284
|
+
delay,
|
|
285
|
+
errorStatus,
|
|
286
|
+
failRate,
|
|
287
|
+
jitter,
|
|
288
|
+
errorMessage: rawErrorMessage ? String(rawErrorMessage) : undefined,
|
|
289
|
+
};
|
|
290
|
+
}
|
|
291
|
+
/**
|
|
292
|
+
* Evaluates whether a request should fail based on errorStatus and failRate.
|
|
293
|
+
*/
|
|
294
|
+
shouldFail(params) {
|
|
295
|
+
if (params.failRate !== undefined) {
|
|
296
|
+
if (params.failRate <= 0)
|
|
297
|
+
return false;
|
|
298
|
+
if (params.failRate >= 1)
|
|
299
|
+
return true;
|
|
300
|
+
return this.rng() < params.failRate;
|
|
301
|
+
}
|
|
302
|
+
// If mock_error was explicitly provided without a fail_rate, fail 100% of the time
|
|
303
|
+
if (params.errorStatus !== undefined) {
|
|
304
|
+
return true;
|
|
305
|
+
}
|
|
306
|
+
return false;
|
|
307
|
+
}
|
|
308
|
+
/**
|
|
309
|
+
* Parse delay into milliseconds. Supports:
|
|
310
|
+
* - 1500 or "1500" -> 1500
|
|
311
|
+
* - "1.5s" -> 1500
|
|
312
|
+
* - "500ms" -> 500
|
|
313
|
+
* - "500-1500" or "500..1500" (random range)
|
|
314
|
+
*/
|
|
315
|
+
parseDelay(rawVal, jitter = 0) {
|
|
316
|
+
if (rawVal === undefined || rawVal === null || rawVal === '') {
|
|
317
|
+
return undefined;
|
|
318
|
+
}
|
|
319
|
+
let delayMs = 0;
|
|
320
|
+
if (typeof rawVal === 'number') {
|
|
321
|
+
delayMs = rawVal;
|
|
322
|
+
}
|
|
323
|
+
else if (typeof rawVal === 'string') {
|
|
324
|
+
const trimmed = rawVal.trim();
|
|
325
|
+
// Range check: "500-1500" or "500..1500"
|
|
326
|
+
if (trimmed.includes('..') || (trimmed.includes('-') && !trimmed.startsWith('-'))) {
|
|
327
|
+
const parts = trimmed.split(/\.\.|-/).map((p) => p.trim());
|
|
328
|
+
if (parts.length === 2) {
|
|
329
|
+
const min = this.parseSingleDuration(parts[0]);
|
|
330
|
+
const max = this.parseSingleDuration(parts[1]);
|
|
331
|
+
if (!isNaN(min) && !isNaN(max)) {
|
|
332
|
+
const low = Math.min(min, max);
|
|
333
|
+
const high = Math.max(min, max);
|
|
334
|
+
delayMs = Math.round(low + this.rng() * (high - low));
|
|
335
|
+
}
|
|
336
|
+
else {
|
|
337
|
+
delayMs = this.parseSingleDuration(trimmed);
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
else {
|
|
341
|
+
delayMs = this.parseSingleDuration(trimmed);
|
|
342
|
+
}
|
|
343
|
+
}
|
|
344
|
+
else {
|
|
345
|
+
delayMs = this.parseSingleDuration(trimmed);
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
if (isNaN(delayMs) || delayMs < 0) {
|
|
349
|
+
return undefined;
|
|
350
|
+
}
|
|
351
|
+
// Apply jitter if provided: ±jitter
|
|
352
|
+
if (jitter > 0) {
|
|
353
|
+
const variance = (this.rng() * 2 - 1) * jitter;
|
|
354
|
+
delayMs = Math.round(delayMs + variance);
|
|
355
|
+
}
|
|
356
|
+
const maxLimit = this.config.maxMockDelayMs ?? (this.configService?.maxMockDelayMs || 15000);
|
|
357
|
+
// Clamp between 0 and maxLimit (default 15,000ms / 15 seconds)
|
|
358
|
+
return Math.min(maxLimit, Math.max(0, delayMs));
|
|
359
|
+
}
|
|
360
|
+
parseSingleDuration(str) {
|
|
361
|
+
const trimmed = str.trim().toLowerCase();
|
|
362
|
+
if (trimmed.endsWith('ms')) {
|
|
363
|
+
return parseFloat(trimmed.slice(0, -2));
|
|
364
|
+
}
|
|
365
|
+
if (trimmed.endsWith('s')) {
|
|
366
|
+
return parseFloat(trimmed.slice(0, -1)) * 1000;
|
|
367
|
+
}
|
|
368
|
+
return parseFloat(trimmed);
|
|
369
|
+
}
|
|
370
|
+
parseJitter(rawVal) {
|
|
371
|
+
if (rawVal === undefined || rawVal === null || rawVal === '')
|
|
372
|
+
return 0;
|
|
373
|
+
const parsed = typeof rawVal === 'number' ? rawVal : parseFloat(String(rawVal));
|
|
374
|
+
return isNaN(parsed) || parsed < 0 ? 0 : parsed;
|
|
375
|
+
}
|
|
376
|
+
/**
|
|
377
|
+
* Parse fail rate between 0.0 and 1.0. Supports:
|
|
378
|
+
* - 0.2 -> 0.2
|
|
379
|
+
* - "0.2" -> 0.2
|
|
380
|
+
* - "20%" -> 0.2
|
|
381
|
+
* - 20 (interpreted as 20% if > 1)
|
|
382
|
+
*/
|
|
383
|
+
parseFailRate(rawVal) {
|
|
384
|
+
if (rawVal === undefined || rawVal === null || rawVal === '') {
|
|
385
|
+
return undefined;
|
|
386
|
+
}
|
|
387
|
+
let rate = 0;
|
|
388
|
+
if (typeof rawVal === 'string') {
|
|
389
|
+
const trimmed = rawVal.trim();
|
|
390
|
+
if (trimmed.endsWith('%')) {
|
|
391
|
+
rate = parseFloat(trimmed.slice(0, -1)) / 100;
|
|
392
|
+
}
|
|
393
|
+
else {
|
|
394
|
+
rate = parseFloat(trimmed);
|
|
395
|
+
}
|
|
396
|
+
}
|
|
397
|
+
else if (typeof rawVal === 'number') {
|
|
398
|
+
rate = rawVal;
|
|
399
|
+
}
|
|
400
|
+
if (isNaN(rate)) {
|
|
401
|
+
return undefined;
|
|
402
|
+
}
|
|
403
|
+
// If user passed a percentage integer like 20 or 50
|
|
404
|
+
if (rate > 1 && rate <= 100) {
|
|
405
|
+
rate = rate / 100;
|
|
406
|
+
}
|
|
407
|
+
return Math.min(1, Math.max(0, rate));
|
|
408
|
+
}
|
|
409
|
+
/**
|
|
410
|
+
* Parse mock error status code or special mode. Supports:
|
|
411
|
+
* - 500, 503, 404, etc.
|
|
412
|
+
* - 'drop' / 'hangup' for socket destruction
|
|
413
|
+
*/
|
|
414
|
+
parseErrorStatus(rawVal) {
|
|
415
|
+
if (rawVal === undefined || rawVal === null || rawVal === '') {
|
|
416
|
+
return undefined;
|
|
417
|
+
}
|
|
418
|
+
const strVal = String(rawVal).trim().toLowerCase();
|
|
419
|
+
if (strVal === 'drop' || strVal === 'hangup' || strVal === 'socket_hangup' || strVal === 'reset') {
|
|
420
|
+
return 'drop';
|
|
421
|
+
}
|
|
422
|
+
const code = parseInt(strVal, 10);
|
|
423
|
+
if (!isNaN(code) && code >= 400 && code <= 599) {
|
|
424
|
+
return code;
|
|
425
|
+
}
|
|
426
|
+
// If raw value was provided but invalid status number (e.g. true or general error), default to 500
|
|
427
|
+
return 500;
|
|
428
|
+
}
|
|
429
|
+
sleep(ms) {
|
|
430
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
exports.ChaosMiddleware = ChaosMiddleware;
|
|
434
|
+
//# sourceMappingURL=ChaosMiddleware.js.map
|