@nodestackapp/server 0.0.0-stage → 1.3.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 +21 -0
- package/README.md +181 -2
- 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 +106 -0
- package/dist/NodeStack.d.ts.map +1 -0
- package/dist/NodeStack.js +298 -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 +103 -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 +325 -0
- package/dist/admin/ui/css/main.css +2015 -0
- package/dist/admin/ui/css/rules.css +264 -0
- package/dist/admin/ui/css/webhooks.css +336 -0
- package/dist/admin/ui/favicon.svg +17 -0
- package/dist/admin/ui/icon.svg +17 -0
- package/dist/admin/ui/index.html +14584 -0
- package/dist/admin/ui/js/analytics.js +624 -0
- package/dist/admin/ui/js/api.js +353 -0
- package/dist/admin/ui/js/app.js +263 -0
- package/dist/admin/ui/js/apps.js +436 -0
- package/dist/admin/ui/js/collections.js +436 -0
- package/dist/admin/ui/js/command-palette.js +600 -0
- package/dist/admin/ui/js/demo.js +559 -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 +768 -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/views.js +714 -0
- package/dist/admin/ui/js/webhooks.js +1086 -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 +55 -0
- package/dist/apps/AppScope.d.ts.map +1 -0
- package/dist/apps/AppScope.js +295 -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 +276 -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 +477 -0
- package/dist/cli/cli.js.map +1 -0
- package/dist/core/config/ConfigService.d.ts +41 -0
- package/dist/core/config/ConfigService.d.ts.map +1 -0
- package/dist/core/config/ConfigService.js +139 -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 +40 -0
- package/dist/core/container/Tokens.d.ts.map +1 -0
- package/dist/core/container/Tokens.js +40 -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 +115 -0
- package/dist/demo/DemoService.d.ts.map +1 -0
- package/dist/demo/DemoService.js +427 -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 +61 -0
- package/dist/http/HttpServer.d.ts.map +1 -0
- package/dist/http/HttpServer.js +478 -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 +55 -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/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 +52 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +141 -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 +262 -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 +686 -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 +28 -0
- package/dist/rules/RuleEngine.d.ts.map +1 -0
- package/dist/rules/RuleEngine.js +204 -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/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 +86 -4
|
@@ -0,0 +1,360 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.EventBus = void 0;
|
|
4
|
+
const AppError_1 = require("../errors/AppError");
|
|
5
|
+
class EventBus {
|
|
6
|
+
beforeCreateHooks = [];
|
|
7
|
+
afterCreateHooks = [];
|
|
8
|
+
beforeUpdateHooks = [];
|
|
9
|
+
afterUpdateHooks = [];
|
|
10
|
+
beforeDeleteHooks = [];
|
|
11
|
+
afterDeleteHooks = [];
|
|
12
|
+
beforeServeHooks = [];
|
|
13
|
+
afterServeHooks = [];
|
|
14
|
+
authHooks = [];
|
|
15
|
+
// Register Hooks
|
|
16
|
+
onRecordBeforeCreate(collectionOrHandler, handler) {
|
|
17
|
+
let item;
|
|
18
|
+
if (typeof collectionOrHandler === 'string' && handler) {
|
|
19
|
+
item = { collection: collectionOrHandler, handler };
|
|
20
|
+
}
|
|
21
|
+
else if (typeof collectionOrHandler === 'function') {
|
|
22
|
+
item = { handler: collectionOrHandler };
|
|
23
|
+
}
|
|
24
|
+
else {
|
|
25
|
+
return () => { };
|
|
26
|
+
}
|
|
27
|
+
this.beforeCreateHooks.push(item);
|
|
28
|
+
return () => {
|
|
29
|
+
const idx = this.beforeCreateHooks.indexOf(item);
|
|
30
|
+
if (idx !== -1) {
|
|
31
|
+
this.beforeCreateHooks.splice(idx, 1);
|
|
32
|
+
}
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
offRecordBeforeCreate(handler) {
|
|
36
|
+
this.beforeCreateHooks = this.beforeCreateHooks.filter((h) => h.handler !== handler);
|
|
37
|
+
}
|
|
38
|
+
onRecordAfterCreate(collectionOrHandler, handler) {
|
|
39
|
+
let item;
|
|
40
|
+
if (typeof collectionOrHandler === 'string' && handler) {
|
|
41
|
+
item = { collection: collectionOrHandler, handler };
|
|
42
|
+
}
|
|
43
|
+
else if (typeof collectionOrHandler === 'function') {
|
|
44
|
+
item = { handler: collectionOrHandler };
|
|
45
|
+
}
|
|
46
|
+
else {
|
|
47
|
+
return () => { };
|
|
48
|
+
}
|
|
49
|
+
this.afterCreateHooks.push(item);
|
|
50
|
+
return () => {
|
|
51
|
+
const idx = this.afterCreateHooks.indexOf(item);
|
|
52
|
+
if (idx !== -1) {
|
|
53
|
+
this.afterCreateHooks.splice(idx, 1);
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
offRecordAfterCreate(handler) {
|
|
58
|
+
this.afterCreateHooks = this.afterCreateHooks.filter((h) => h.handler !== handler);
|
|
59
|
+
}
|
|
60
|
+
onRecordBeforeUpdate(collectionOrHandler, handler) {
|
|
61
|
+
let item;
|
|
62
|
+
if (typeof collectionOrHandler === 'string' && handler) {
|
|
63
|
+
item = { collection: collectionOrHandler, handler };
|
|
64
|
+
}
|
|
65
|
+
else if (typeof collectionOrHandler === 'function') {
|
|
66
|
+
item = { handler: collectionOrHandler };
|
|
67
|
+
}
|
|
68
|
+
else {
|
|
69
|
+
return () => { };
|
|
70
|
+
}
|
|
71
|
+
this.beforeUpdateHooks.push(item);
|
|
72
|
+
return () => {
|
|
73
|
+
const idx = this.beforeUpdateHooks.indexOf(item);
|
|
74
|
+
if (idx !== -1) {
|
|
75
|
+
this.beforeUpdateHooks.splice(idx, 1);
|
|
76
|
+
}
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
offRecordBeforeUpdate(handler) {
|
|
80
|
+
this.beforeUpdateHooks = this.beforeUpdateHooks.filter((h) => h.handler !== handler);
|
|
81
|
+
}
|
|
82
|
+
onRecordAfterUpdate(collectionOrHandler, handler) {
|
|
83
|
+
let item;
|
|
84
|
+
if (typeof collectionOrHandler === 'string' && handler) {
|
|
85
|
+
item = { collection: collectionOrHandler, handler };
|
|
86
|
+
}
|
|
87
|
+
else if (typeof collectionOrHandler === 'function') {
|
|
88
|
+
item = { handler: collectionOrHandler };
|
|
89
|
+
}
|
|
90
|
+
else {
|
|
91
|
+
return () => { };
|
|
92
|
+
}
|
|
93
|
+
this.afterUpdateHooks.push(item);
|
|
94
|
+
return () => {
|
|
95
|
+
const idx = this.afterUpdateHooks.indexOf(item);
|
|
96
|
+
if (idx !== -1) {
|
|
97
|
+
this.afterUpdateHooks.splice(idx, 1);
|
|
98
|
+
}
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
offRecordAfterUpdate(handler) {
|
|
102
|
+
this.afterUpdateHooks = this.afterUpdateHooks.filter((h) => h.handler !== handler);
|
|
103
|
+
}
|
|
104
|
+
onRecordBeforeDelete(collectionOrHandler, handler) {
|
|
105
|
+
let item;
|
|
106
|
+
if (typeof collectionOrHandler === 'string' && handler) {
|
|
107
|
+
item = { collection: collectionOrHandler, handler };
|
|
108
|
+
}
|
|
109
|
+
else if (typeof collectionOrHandler === 'function') {
|
|
110
|
+
item = { handler: collectionOrHandler };
|
|
111
|
+
}
|
|
112
|
+
else {
|
|
113
|
+
return () => { };
|
|
114
|
+
}
|
|
115
|
+
this.beforeDeleteHooks.push(item);
|
|
116
|
+
return () => {
|
|
117
|
+
const idx = this.beforeDeleteHooks.indexOf(item);
|
|
118
|
+
if (idx !== -1) {
|
|
119
|
+
this.beforeDeleteHooks.splice(idx, 1);
|
|
120
|
+
}
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
offRecordBeforeDelete(handler) {
|
|
124
|
+
this.beforeDeleteHooks = this.beforeDeleteHooks.filter((h) => h.handler !== handler);
|
|
125
|
+
}
|
|
126
|
+
onRecordAfterDelete(collectionOrHandler, handler) {
|
|
127
|
+
let item;
|
|
128
|
+
if (typeof collectionOrHandler === 'string' && handler) {
|
|
129
|
+
item = { collection: collectionOrHandler, handler };
|
|
130
|
+
}
|
|
131
|
+
else if (typeof collectionOrHandler === 'function') {
|
|
132
|
+
item = { handler: collectionOrHandler };
|
|
133
|
+
}
|
|
134
|
+
else {
|
|
135
|
+
return () => { };
|
|
136
|
+
}
|
|
137
|
+
this.afterDeleteHooks.push(item);
|
|
138
|
+
return () => {
|
|
139
|
+
const idx = this.afterDeleteHooks.indexOf(item);
|
|
140
|
+
if (idx !== -1) {
|
|
141
|
+
this.afterDeleteHooks.splice(idx, 1);
|
|
142
|
+
}
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
offRecordAfterDelete(handler) {
|
|
146
|
+
this.afterDeleteHooks = this.afterDeleteHooks.filter((h) => h.handler !== handler);
|
|
147
|
+
}
|
|
148
|
+
onBeforeServe(handler) {
|
|
149
|
+
this.beforeServeHooks.push(handler);
|
|
150
|
+
return () => {
|
|
151
|
+
const idx = this.beforeServeHooks.indexOf(handler);
|
|
152
|
+
if (idx !== -1) {
|
|
153
|
+
this.beforeServeHooks.splice(idx, 1);
|
|
154
|
+
}
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
offBeforeServe(handler) {
|
|
158
|
+
this.beforeServeHooks = this.beforeServeHooks.filter((h) => h !== handler);
|
|
159
|
+
}
|
|
160
|
+
onAfterServe(handler) {
|
|
161
|
+
this.afterServeHooks.push(handler);
|
|
162
|
+
return () => {
|
|
163
|
+
const idx = this.afterServeHooks.indexOf(handler);
|
|
164
|
+
if (idx !== -1) {
|
|
165
|
+
this.afterServeHooks.splice(idx, 1);
|
|
166
|
+
}
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
offAfterServe(handler) {
|
|
170
|
+
this.afterServeHooks = this.afterServeHooks.filter((h) => h !== handler);
|
|
171
|
+
}
|
|
172
|
+
onRecordAuthRequest(collectionOrHandler, handler) {
|
|
173
|
+
let item;
|
|
174
|
+
if (typeof collectionOrHandler === 'string' && handler) {
|
|
175
|
+
item = { collection: collectionOrHandler, handler };
|
|
176
|
+
}
|
|
177
|
+
else if (typeof collectionOrHandler === 'function') {
|
|
178
|
+
item = { handler: collectionOrHandler };
|
|
179
|
+
}
|
|
180
|
+
else {
|
|
181
|
+
return () => { };
|
|
182
|
+
}
|
|
183
|
+
this.authHooks.push(item);
|
|
184
|
+
return () => {
|
|
185
|
+
const idx = this.authHooks.indexOf(item);
|
|
186
|
+
if (idx !== -1) {
|
|
187
|
+
this.authHooks.splice(idx, 1);
|
|
188
|
+
}
|
|
189
|
+
};
|
|
190
|
+
}
|
|
191
|
+
offRecordAuthRequest(handler) {
|
|
192
|
+
this.authHooks = this.authHooks.filter((h) => h.handler !== handler);
|
|
193
|
+
}
|
|
194
|
+
// Dispatchers
|
|
195
|
+
async triggerRecordBeforeCreate(collection, record, auth, httpContext) {
|
|
196
|
+
const ctx = {
|
|
197
|
+
collection,
|
|
198
|
+
record: { ...record },
|
|
199
|
+
auth,
|
|
200
|
+
httpContext,
|
|
201
|
+
isCanceled: false,
|
|
202
|
+
cancel(reason) {
|
|
203
|
+
this.isCanceled = true;
|
|
204
|
+
this.cancelReason = reason;
|
|
205
|
+
},
|
|
206
|
+
};
|
|
207
|
+
for (const hook of this.beforeCreateHooks) {
|
|
208
|
+
if (!hook.collection || hook.collection === collection) {
|
|
209
|
+
await hook.handler(ctx);
|
|
210
|
+
if (ctx.isCanceled) {
|
|
211
|
+
throw new AppError_1.AppError(ctx.cancelReason || 'Operation canceled by hook', 400);
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
return ctx.record;
|
|
216
|
+
}
|
|
217
|
+
async triggerRecordAfterCreate(collection, record, auth, httpContext) {
|
|
218
|
+
const ctx = {
|
|
219
|
+
collection,
|
|
220
|
+
record,
|
|
221
|
+
auth,
|
|
222
|
+
httpContext,
|
|
223
|
+
};
|
|
224
|
+
for (const hook of this.afterCreateHooks) {
|
|
225
|
+
if (!hook.collection || hook.collection === collection) {
|
|
226
|
+
await hook.handler(ctx);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
async triggerRecordBeforeUpdate(collection, record, auth, httpContext) {
|
|
231
|
+
const ctx = {
|
|
232
|
+
collection,
|
|
233
|
+
record: { ...record },
|
|
234
|
+
auth,
|
|
235
|
+
httpContext,
|
|
236
|
+
isCanceled: false,
|
|
237
|
+
cancel(reason) {
|
|
238
|
+
this.isCanceled = true;
|
|
239
|
+
this.cancelReason = reason;
|
|
240
|
+
},
|
|
241
|
+
};
|
|
242
|
+
for (const hook of this.beforeUpdateHooks) {
|
|
243
|
+
if (!hook.collection || hook.collection === collection) {
|
|
244
|
+
await hook.handler(ctx);
|
|
245
|
+
if (ctx.isCanceled) {
|
|
246
|
+
throw new AppError_1.AppError(ctx.cancelReason || 'Operation canceled by hook', 400);
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
return ctx.record;
|
|
251
|
+
}
|
|
252
|
+
async triggerRecordAfterUpdate(collection, record, auth, httpContext, originalRecord) {
|
|
253
|
+
const ctx = {
|
|
254
|
+
collection,
|
|
255
|
+
record,
|
|
256
|
+
originalRecord,
|
|
257
|
+
auth,
|
|
258
|
+
httpContext,
|
|
259
|
+
};
|
|
260
|
+
for (const hook of this.afterUpdateHooks) {
|
|
261
|
+
if (!hook.collection || hook.collection === collection) {
|
|
262
|
+
await hook.handler(ctx);
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
async triggerRecordBeforeDelete(collection, record, auth, httpContext) {
|
|
267
|
+
const ctx = {
|
|
268
|
+
collection,
|
|
269
|
+
record,
|
|
270
|
+
auth,
|
|
271
|
+
httpContext,
|
|
272
|
+
isCanceled: false,
|
|
273
|
+
cancel(reason) {
|
|
274
|
+
this.isCanceled = true;
|
|
275
|
+
this.cancelReason = reason;
|
|
276
|
+
},
|
|
277
|
+
};
|
|
278
|
+
for (const hook of this.beforeDeleteHooks) {
|
|
279
|
+
if (!hook.collection || hook.collection === collection) {
|
|
280
|
+
await hook.handler(ctx);
|
|
281
|
+
if (ctx.isCanceled) {
|
|
282
|
+
throw new AppError_1.AppError(ctx.cancelReason || 'Operation canceled by hook', 400);
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
async triggerRecordAfterDelete(collection, record, auth, httpContext) {
|
|
288
|
+
const ctx = {
|
|
289
|
+
collection,
|
|
290
|
+
record,
|
|
291
|
+
auth,
|
|
292
|
+
httpContext,
|
|
293
|
+
};
|
|
294
|
+
for (const hook of this.afterDeleteHooks) {
|
|
295
|
+
if (!hook.collection || hook.collection === collection) {
|
|
296
|
+
await hook.handler(ctx);
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
}
|
|
300
|
+
async triggerBeforeServe(ctx) {
|
|
301
|
+
for (const hook of this.beforeServeHooks) {
|
|
302
|
+
await hook(ctx);
|
|
303
|
+
}
|
|
304
|
+
}
|
|
305
|
+
async triggerAfterServe(ctx) {
|
|
306
|
+
for (const hook of this.afterServeHooks) {
|
|
307
|
+
await hook(ctx);
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
async triggerAuthRequest(ctx) {
|
|
311
|
+
for (const hook of this.authHooks) {
|
|
312
|
+
if (!hook.collection || hook.collection === ctx.collection) {
|
|
313
|
+
await hook.handler(ctx);
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
// --- Generic Custom Events ---
|
|
318
|
+
customEventHandlers = new Map();
|
|
319
|
+
on(event, handler) {
|
|
320
|
+
if (!this.customEventHandlers.has(event)) {
|
|
321
|
+
this.customEventHandlers.set(event, []);
|
|
322
|
+
}
|
|
323
|
+
this.customEventHandlers.get(event).push(handler);
|
|
324
|
+
return () => this.off(event, handler);
|
|
325
|
+
}
|
|
326
|
+
off(event, handler) {
|
|
327
|
+
const handlers = this.customEventHandlers.get(event);
|
|
328
|
+
if (handlers) {
|
|
329
|
+
const idx = handlers.indexOf(handler);
|
|
330
|
+
if (idx !== -1) {
|
|
331
|
+
handlers.splice(idx, 1);
|
|
332
|
+
}
|
|
333
|
+
if (handlers.length === 0) {
|
|
334
|
+
this.customEventHandlers.delete(event);
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
}
|
|
338
|
+
async emit(event, data) {
|
|
339
|
+
const handlers = this.customEventHandlers.get(event);
|
|
340
|
+
if (handlers) {
|
|
341
|
+
for (const handler of handlers) {
|
|
342
|
+
await handler(data);
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
clear() {
|
|
347
|
+
this.beforeCreateHooks = [];
|
|
348
|
+
this.afterCreateHooks = [];
|
|
349
|
+
this.beforeUpdateHooks = [];
|
|
350
|
+
this.afterUpdateHooks = [];
|
|
351
|
+
this.beforeDeleteHooks = [];
|
|
352
|
+
this.afterDeleteHooks = [];
|
|
353
|
+
this.beforeServeHooks = [];
|
|
354
|
+
this.afterServeHooks = [];
|
|
355
|
+
this.authHooks = [];
|
|
356
|
+
this.customEventHandlers.clear();
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
exports.EventBus = EventBus;
|
|
360
|
+
//# sourceMappingURL=EventBus.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../../src/core/events/EventBus.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
export interface HookContext {
|
|
2
|
+
[key: string]: any;
|
|
3
|
+
}
|
|
4
|
+
export interface RecordEventContext {
|
|
5
|
+
collection: string;
|
|
6
|
+
record: Record<string, any>;
|
|
7
|
+
auth?: {
|
|
8
|
+
id: string;
|
|
9
|
+
email?: string;
|
|
10
|
+
collection: string;
|
|
11
|
+
isAdmin: boolean;
|
|
12
|
+
} | null;
|
|
13
|
+
httpContext?: any;
|
|
14
|
+
}
|
|
15
|
+
export interface RecordBeforeEventContext extends RecordEventContext {
|
|
16
|
+
cancel: (reason?: string) => void;
|
|
17
|
+
isCanceled: boolean;
|
|
18
|
+
cancelReason?: string;
|
|
19
|
+
}
|
|
20
|
+
export interface RecordAfterEventContext extends RecordEventContext {
|
|
21
|
+
originalRecord?: Record<string, any>;
|
|
22
|
+
}
|
|
23
|
+
export interface AuthEventContext {
|
|
24
|
+
collection: string;
|
|
25
|
+
identity: string;
|
|
26
|
+
record?: Record<string, any>;
|
|
27
|
+
token?: string;
|
|
28
|
+
}
|
|
29
|
+
export interface ServeEventContext {
|
|
30
|
+
server: any;
|
|
31
|
+
port: number;
|
|
32
|
+
host: string;
|
|
33
|
+
}
|
|
34
|
+
export type HookHandler<T> = (context: T) => Promise<void> | void;
|
|
35
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/events/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/events/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
export interface MaintenanceGateOptions {
|
|
2
|
+
/** Maximum time (ms) to wait for in-flight requests to drain before starting exclusive work. Default: 5000ms */
|
|
3
|
+
drainTimeoutMs?: number;
|
|
4
|
+
/** Maximum time (ms) a request can wait in queue before timing out with 503. Default: 10000ms */
|
|
5
|
+
requestQueueTimeoutMs?: number;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Coordinates exclusive system operations (such as "Reset to Demo State")
|
|
9
|
+
* with incoming and in-flight HTTP requests and database operations.
|
|
10
|
+
*
|
|
11
|
+
* Responsibilities:
|
|
12
|
+
* 1. Gates incoming requests during reset, holding them in an asynchronous queue.
|
|
13
|
+
* 2. Drains all active in-flight requests before database closing or filesystem swaps occur.
|
|
14
|
+
* 3. Prevents race conditions and in-flight handlers observing partially swapped files or closed drivers.
|
|
15
|
+
* 4. Safely flushes queued requests once the clean state has been fully restored and reconnected.
|
|
16
|
+
*/
|
|
17
|
+
export declare class MaintenanceGate {
|
|
18
|
+
private options;
|
|
19
|
+
private isGated;
|
|
20
|
+
private isExecutingExclusive;
|
|
21
|
+
private activeRequests;
|
|
22
|
+
private waitingQueue;
|
|
23
|
+
private drainResolvers;
|
|
24
|
+
constructor(options?: MaintenanceGateOptions);
|
|
25
|
+
/**
|
|
26
|
+
* Returns whether maintenance mode / gate is currently active.
|
|
27
|
+
*/
|
|
28
|
+
isMaintenanceActive(): boolean;
|
|
29
|
+
/**
|
|
30
|
+
* Returns whether an exclusive operation is currently executing.
|
|
31
|
+
*/
|
|
32
|
+
isExclusiveActive(): boolean;
|
|
33
|
+
/**
|
|
34
|
+
* Returns the count of active non-exempt in-flight requests.
|
|
35
|
+
*/
|
|
36
|
+
getActiveRequestsCount(): number;
|
|
37
|
+
/**
|
|
38
|
+
* Returns the count of requests currently waiting in queue.
|
|
39
|
+
*/
|
|
40
|
+
getWaitingQueueLength(): number;
|
|
41
|
+
/**
|
|
42
|
+
* Tracks incoming request start.
|
|
43
|
+
* If maintenance mode is active, the request is held in queue until maintenance completes.
|
|
44
|
+
* If isExempt is true (e.g., the reset endpoint or SSE stream), it proceeds immediately.
|
|
45
|
+
*/
|
|
46
|
+
trackRequestStart(requestId: string, isExempt?: boolean): Promise<void>;
|
|
47
|
+
/**
|
|
48
|
+
* Tracks request completion. Removes requestId from active requests
|
|
49
|
+
* and notifies drain listeners when all in-flight requests have finished.
|
|
50
|
+
*/
|
|
51
|
+
trackRequestEnd(requestId: string): void;
|
|
52
|
+
/**
|
|
53
|
+
* Coordinates exclusive execution (e.g., demo reset):
|
|
54
|
+
* 1. Gates the server (holds new incoming requests in queue).
|
|
55
|
+
* 2. Waits for all current in-flight requests to drain to 0.
|
|
56
|
+
* 3. Executes the exclusive action (file swap, database reconnect).
|
|
57
|
+
* 4. Unlocks the gate and releases all queued requests in FIFO order.
|
|
58
|
+
*/
|
|
59
|
+
executeExclusive<T>(action: () => Promise<T> | T): Promise<T>;
|
|
60
|
+
private drainInFlightRequests;
|
|
61
|
+
private notifyDrain;
|
|
62
|
+
private flushWaitingQueue;
|
|
63
|
+
reset(): void;
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=MaintenanceGate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MaintenanceGate.d.ts","sourceRoot":"","sources":["../../../src/core/maintenance/MaintenanceGate.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,gHAAgH;IAChH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iGAAiG;IACjG,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAYd,OAAO,CAAC,OAAO;IAX3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,YAAY,CAKZ;IACR,OAAO,CAAC,cAAc,CAAyB;IAE/C,YAAoB,OAAO,GAAE,sBAA2B,EAAI;IAE5D;;OAEG;IACI,mBAAmB,IAAI,OAAO,CAEpC;IAED;;OAEG;IACI,iBAAiB,IAAI,OAAO,CAElC;IAED;;OAEG;IACI,sBAAsB,IAAI,MAAM,CAEtC;IAED;;OAEG;IACI,qBAAqB,IAAI,MAAM,CAErC;IAED;;;;OAIG;IACU,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BjF;IAED;;;OAGG;IACI,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM9C;IAED;;;;;;OAMG;IACU,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoBzE;YAEa,qBAAqB;IA2BnC,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,iBAAiB;IASlB,KAAK,IAAI,IAAI,CAMnB;CACF"}
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.MaintenanceGate = void 0;
|
|
4
|
+
const AppError_1 = require("../errors/AppError");
|
|
5
|
+
/**
|
|
6
|
+
* Coordinates exclusive system operations (such as "Reset to Demo State")
|
|
7
|
+
* with incoming and in-flight HTTP requests and database operations.
|
|
8
|
+
*
|
|
9
|
+
* Responsibilities:
|
|
10
|
+
* 1. Gates incoming requests during reset, holding them in an asynchronous queue.
|
|
11
|
+
* 2. Drains all active in-flight requests before database closing or filesystem swaps occur.
|
|
12
|
+
* 3. Prevents race conditions and in-flight handlers observing partially swapped files or closed drivers.
|
|
13
|
+
* 4. Safely flushes queued requests once the clean state has been fully restored and reconnected.
|
|
14
|
+
*/
|
|
15
|
+
class MaintenanceGate {
|
|
16
|
+
options;
|
|
17
|
+
isGated = false;
|
|
18
|
+
isExecutingExclusive = false;
|
|
19
|
+
activeRequests = new Set();
|
|
20
|
+
waitingQueue = [];
|
|
21
|
+
drainResolvers = [];
|
|
22
|
+
constructor(options = {}) {
|
|
23
|
+
this.options = options;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Returns whether maintenance mode / gate is currently active.
|
|
27
|
+
*/
|
|
28
|
+
isMaintenanceActive() {
|
|
29
|
+
return this.isGated;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Returns whether an exclusive operation is currently executing.
|
|
33
|
+
*/
|
|
34
|
+
isExclusiveActive() {
|
|
35
|
+
return this.isExecutingExclusive;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Returns the count of active non-exempt in-flight requests.
|
|
39
|
+
*/
|
|
40
|
+
getActiveRequestsCount() {
|
|
41
|
+
return this.activeRequests.size;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Returns the count of requests currently waiting in queue.
|
|
45
|
+
*/
|
|
46
|
+
getWaitingQueueLength() {
|
|
47
|
+
return this.waitingQueue.length;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Tracks incoming request start.
|
|
51
|
+
* If maintenance mode is active, the request is held in queue until maintenance completes.
|
|
52
|
+
* If isExempt is true (e.g., the reset endpoint or SSE stream), it proceeds immediately.
|
|
53
|
+
*/
|
|
54
|
+
async trackRequestStart(requestId, isExempt = false) {
|
|
55
|
+
if (isExempt) {
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
if (this.isGated) {
|
|
59
|
+
// Hold incoming request in queue until exclusive maintenance completes
|
|
60
|
+
await new Promise((resolve, reject) => {
|
|
61
|
+
const timeoutMs = this.options.requestQueueTimeoutMs ?? 10000;
|
|
62
|
+
const timer = setTimeout(() => {
|
|
63
|
+
const idx = this.waitingQueue.findIndex((item) => item.requestId === requestId);
|
|
64
|
+
if (idx !== -1) {
|
|
65
|
+
this.waitingQueue.splice(idx, 1);
|
|
66
|
+
}
|
|
67
|
+
reject(new AppError_1.ServiceUnavailableError('Server is temporarily undergoing demo reset maintenance. Request timed out in queue.'));
|
|
68
|
+
}, timeoutMs);
|
|
69
|
+
this.waitingQueue.push({
|
|
70
|
+
requestId,
|
|
71
|
+
resolve,
|
|
72
|
+
reject,
|
|
73
|
+
timer,
|
|
74
|
+
});
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
this.activeRequests.add(requestId);
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Tracks request completion. Removes requestId from active requests
|
|
81
|
+
* and notifies drain listeners when all in-flight requests have finished.
|
|
82
|
+
*/
|
|
83
|
+
trackRequestEnd(requestId) {
|
|
84
|
+
if (this.activeRequests.delete(requestId)) {
|
|
85
|
+
if (this.isGated && this.activeRequests.size === 0) {
|
|
86
|
+
this.notifyDrain();
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Coordinates exclusive execution (e.g., demo reset):
|
|
92
|
+
* 1. Gates the server (holds new incoming requests in queue).
|
|
93
|
+
* 2. Waits for all current in-flight requests to drain to 0.
|
|
94
|
+
* 3. Executes the exclusive action (file swap, database reconnect).
|
|
95
|
+
* 4. Unlocks the gate and releases all queued requests in FIFO order.
|
|
96
|
+
*/
|
|
97
|
+
async executeExclusive(action) {
|
|
98
|
+
if (this.isExecutingExclusive) {
|
|
99
|
+
throw new AppError_1.ConflictError('A demo reset or maintenance operation is already in progress.');
|
|
100
|
+
}
|
|
101
|
+
this.isExecutingExclusive = true;
|
|
102
|
+
this.isGated = true;
|
|
103
|
+
try {
|
|
104
|
+
// 1. Wait for existing in-flight requests to complete
|
|
105
|
+
await this.drainInFlightRequests();
|
|
106
|
+
// 2. Perform exclusive action safely (zero active requests)
|
|
107
|
+
return await action();
|
|
108
|
+
}
|
|
109
|
+
finally {
|
|
110
|
+
// 3. Guaranteed unlock and queue flush
|
|
111
|
+
this.isGated = false;
|
|
112
|
+
this.isExecutingExclusive = false;
|
|
113
|
+
this.flushWaitingQueue();
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
async drainInFlightRequests() {
|
|
117
|
+
if (this.activeRequests.size === 0) {
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
120
|
+
const drainTimeoutMs = this.options.drainTimeoutMs ?? 5000;
|
|
121
|
+
await new Promise((resolve) => {
|
|
122
|
+
let timer = null;
|
|
123
|
+
const onDrain = () => {
|
|
124
|
+
if (timer)
|
|
125
|
+
clearTimeout(timer);
|
|
126
|
+
resolve();
|
|
127
|
+
};
|
|
128
|
+
timer = setTimeout(() => {
|
|
129
|
+
const idx = this.drainResolvers.indexOf(onDrain);
|
|
130
|
+
if (idx !== -1) {
|
|
131
|
+
this.drainResolvers.splice(idx, 1);
|
|
132
|
+
}
|
|
133
|
+
resolve(); // Continue even if drain timed out to avoid permanent lock
|
|
134
|
+
}, drainTimeoutMs);
|
|
135
|
+
this.drainResolvers.push(onDrain);
|
|
136
|
+
});
|
|
137
|
+
}
|
|
138
|
+
notifyDrain() {
|
|
139
|
+
const resolvers = [...this.drainResolvers];
|
|
140
|
+
this.drainResolvers = [];
|
|
141
|
+
for (const resolve of resolvers) {
|
|
142
|
+
resolve();
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
flushWaitingQueue() {
|
|
146
|
+
const queue = [...this.waitingQueue];
|
|
147
|
+
this.waitingQueue = [];
|
|
148
|
+
for (const item of queue) {
|
|
149
|
+
clearTimeout(item.timer);
|
|
150
|
+
item.resolve();
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
reset() {
|
|
154
|
+
this.isGated = false;
|
|
155
|
+
this.isExecutingExclusive = false;
|
|
156
|
+
this.activeRequests.clear();
|
|
157
|
+
this.flushWaitingQueue();
|
|
158
|
+
this.notifyDrain();
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
exports.MaintenanceGate = MaintenanceGate;
|
|
162
|
+
//# sourceMappingURL=MaintenanceGate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MaintenanceGate.js","sourceRoot":"","sources":["../../../src/core/maintenance/MaintenanceGate.ts"],"names":[],"mappings":"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"}
|