@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.
Files changed (348) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +181 -2
  3. package/bin/nodebase.js +4 -0
  4. package/bin/nodestack.js +21 -0
  5. package/dist/NodeBase.d.ts +2 -0
  6. package/dist/NodeBase.d.ts.map +1 -0
  7. package/dist/NodeBase.js +8 -0
  8. package/dist/NodeBase.js.map +1 -0
  9. package/dist/NodeStack.d.ts +106 -0
  10. package/dist/NodeStack.d.ts.map +1 -0
  11. package/dist/NodeStack.js +298 -0
  12. package/dist/NodeStack.js.map +1 -0
  13. package/dist/admin/AdminUIBundler.d.ts +8 -0
  14. package/dist/admin/AdminUIBundler.d.ts.map +1 -0
  15. package/dist/admin/AdminUIBundler.js +103 -0
  16. package/dist/admin/AdminUIBundler.js.map +1 -0
  17. package/dist/admin/AdminUIService.d.ts +30 -0
  18. package/dist/admin/AdminUIService.d.ts.map +1 -0
  19. package/dist/admin/AdminUIService.js +210 -0
  20. package/dist/admin/AdminUIService.js.map +1 -0
  21. package/dist/admin/DocsService.d.ts +29 -0
  22. package/dist/admin/DocsService.d.ts.map +1 -0
  23. package/dist/admin/DocsService.js +564 -0
  24. package/dist/admin/DocsService.js.map +1 -0
  25. package/dist/admin/ui/css/analytics.css +325 -0
  26. package/dist/admin/ui/css/main.css +2015 -0
  27. package/dist/admin/ui/css/rules.css +264 -0
  28. package/dist/admin/ui/css/webhooks.css +336 -0
  29. package/dist/admin/ui/favicon.svg +17 -0
  30. package/dist/admin/ui/icon.svg +17 -0
  31. package/dist/admin/ui/index.html +14584 -0
  32. package/dist/admin/ui/js/analytics.js +624 -0
  33. package/dist/admin/ui/js/api.js +353 -0
  34. package/dist/admin/ui/js/app.js +263 -0
  35. package/dist/admin/ui/js/apps.js +436 -0
  36. package/dist/admin/ui/js/collections.js +436 -0
  37. package/dist/admin/ui/js/command-palette.js +600 -0
  38. package/dist/admin/ui/js/demo.js +559 -0
  39. package/dist/admin/ui/js/modals.js +2379 -0
  40. package/dist/admin/ui/js/plugin-tester.js +559 -0
  41. package/dist/admin/ui/js/plugins.js +768 -0
  42. package/dist/admin/ui/js/records.js +1270 -0
  43. package/dist/admin/ui/js/rules.js +775 -0
  44. package/dist/admin/ui/js/schema.js +290 -0
  45. package/dist/admin/ui/js/state.js +140 -0
  46. package/dist/admin/ui/js/views.js +714 -0
  47. package/dist/admin/ui/js/webhooks.js +1086 -0
  48. package/dist/analytics/AnalyticsService.d.ts +62 -0
  49. package/dist/analytics/AnalyticsService.d.ts.map +1 -0
  50. package/dist/analytics/AnalyticsService.js +196 -0
  51. package/dist/analytics/AnalyticsService.js.map +1 -0
  52. package/dist/apps/AppManager.d.ts +28 -0
  53. package/dist/apps/AppManager.d.ts.map +1 -0
  54. package/dist/apps/AppManager.js +211 -0
  55. package/dist/apps/AppManager.js.map +1 -0
  56. package/dist/apps/AppRegistry.d.ts +27 -0
  57. package/dist/apps/AppRegistry.d.ts.map +1 -0
  58. package/dist/apps/AppRegistry.js +220 -0
  59. package/dist/apps/AppRegistry.js.map +1 -0
  60. package/dist/apps/AppScope.d.ts +55 -0
  61. package/dist/apps/AppScope.d.ts.map +1 -0
  62. package/dist/apps/AppScope.js +295 -0
  63. package/dist/apps/AppScope.js.map +1 -0
  64. package/dist/apps/index.d.ts +5 -0
  65. package/dist/apps/index.d.ts.map +1 -0
  66. package/dist/apps/index.js +21 -0
  67. package/dist/apps/index.js.map +1 -0
  68. package/dist/apps/models/App.d.ts +29 -0
  69. package/dist/apps/models/App.d.ts.map +1 -0
  70. package/dist/apps/models/App.js +3 -0
  71. package/dist/apps/models/App.js.map +1 -0
  72. package/dist/audit/AuditLogService.d.ts +68 -0
  73. package/dist/audit/AuditLogService.d.ts.map +1 -0
  74. package/dist/audit/AuditLogService.js +243 -0
  75. package/dist/audit/AuditLogService.js.map +1 -0
  76. package/dist/auth/AuthService.d.ts +35 -0
  77. package/dist/auth/AuthService.d.ts.map +1 -0
  78. package/dist/auth/AuthService.js +276 -0
  79. package/dist/auth/AuthService.js.map +1 -0
  80. package/dist/cli/cli.d.ts +3 -0
  81. package/dist/cli/cli.d.ts.map +1 -0
  82. package/dist/cli/cli.js +477 -0
  83. package/dist/cli/cli.js.map +1 -0
  84. package/dist/core/config/ConfigService.d.ts +41 -0
  85. package/dist/core/config/ConfigService.d.ts.map +1 -0
  86. package/dist/core/config/ConfigService.js +139 -0
  87. package/dist/core/config/ConfigService.js.map +1 -0
  88. package/dist/core/config/EnvLoader.d.ts +7 -0
  89. package/dist/core/config/EnvLoader.d.ts.map +1 -0
  90. package/dist/core/config/EnvLoader.js +84 -0
  91. package/dist/core/config/EnvLoader.js.map +1 -0
  92. package/dist/core/container/Container.d.ts +34 -0
  93. package/dist/core/container/Container.d.ts.map +1 -0
  94. package/dist/core/container/Container.js +98 -0
  95. package/dist/core/container/Container.js.map +1 -0
  96. package/dist/core/container/Tokens.d.ts +40 -0
  97. package/dist/core/container/Tokens.d.ts.map +1 -0
  98. package/dist/core/container/Tokens.js +40 -0
  99. package/dist/core/container/Tokens.js.map +1 -0
  100. package/dist/core/errors/AppError.d.ts +24 -0
  101. package/dist/core/errors/AppError.d.ts.map +1 -0
  102. package/dist/core/errors/AppError.js +52 -0
  103. package/dist/core/errors/AppError.js.map +1 -0
  104. package/dist/core/events/EventBus.d.ts +45 -0
  105. package/dist/core/events/EventBus.d.ts.map +1 -0
  106. package/dist/core/events/EventBus.js +360 -0
  107. package/dist/core/events/EventBus.js.map +1 -0
  108. package/dist/core/events/types.d.ts +35 -0
  109. package/dist/core/events/types.d.ts.map +1 -0
  110. package/dist/core/events/types.js +3 -0
  111. package/dist/core/events/types.js.map +1 -0
  112. package/dist/core/maintenance/MaintenanceGate.d.ts +65 -0
  113. package/dist/core/maintenance/MaintenanceGate.d.ts.map +1 -0
  114. package/dist/core/maintenance/MaintenanceGate.js +162 -0
  115. package/dist/core/maintenance/MaintenanceGate.js.map +1 -0
  116. package/dist/core/plugins/PluginManager.d.ts +150 -0
  117. package/dist/core/plugins/PluginManager.d.ts.map +1 -0
  118. package/dist/core/plugins/PluginManager.js +1592 -0
  119. package/dist/core/plugins/PluginManager.js.map +1 -0
  120. package/dist/core/plugins/types.d.ts +170 -0
  121. package/dist/core/plugins/types.d.ts.map +1 -0
  122. package/dist/core/plugins/types.js +3 -0
  123. package/dist/core/plugins/types.js.map +1 -0
  124. package/dist/database/DatabaseService.d.ts +27 -0
  125. package/dist/database/DatabaseService.d.ts.map +1 -0
  126. package/dist/database/DatabaseService.js +97 -0
  127. package/dist/database/DatabaseService.js.map +1 -0
  128. package/dist/database/drivers/IDatabaseDriver.d.ts +17 -0
  129. package/dist/database/drivers/IDatabaseDriver.d.ts.map +1 -0
  130. package/dist/database/drivers/IDatabaseDriver.js +3 -0
  131. package/dist/database/drivers/IDatabaseDriver.js.map +1 -0
  132. package/dist/database/drivers/NodeSqliteDriver.d.ts +16 -0
  133. package/dist/database/drivers/NodeSqliteDriver.d.ts.map +1 -0
  134. package/dist/database/drivers/NodeSqliteDriver.js +115 -0
  135. package/dist/database/drivers/NodeSqliteDriver.js.map +1 -0
  136. package/dist/database/migrations/SystemMigrations.d.ts +5 -0
  137. package/dist/database/migrations/SystemMigrations.d.ts.map +1 -0
  138. package/dist/database/migrations/SystemMigrations.js +164 -0
  139. package/dist/database/migrations/SystemMigrations.js.map +1 -0
  140. package/dist/demo/DemoService.d.ts +115 -0
  141. package/dist/demo/DemoService.d.ts.map +1 -0
  142. package/dist/demo/DemoService.js +427 -0
  143. package/dist/demo/DemoService.js.map +1 -0
  144. package/dist/files/FileStorageService.d.ts +35 -0
  145. package/dist/files/FileStorageService.d.ts.map +1 -0
  146. package/dist/files/FileStorageService.js +126 -0
  147. package/dist/files/FileStorageService.js.map +1 -0
  148. package/dist/http/HttpServer.d.ts +61 -0
  149. package/dist/http/HttpServer.d.ts.map +1 -0
  150. package/dist/http/HttpServer.js +478 -0
  151. package/dist/http/HttpServer.js.map +1 -0
  152. package/dist/http/controllers/AnalyticsController.d.ts +9 -0
  153. package/dist/http/controllers/AnalyticsController.d.ts.map +1 -0
  154. package/dist/http/controllers/AnalyticsController.js +18 -0
  155. package/dist/http/controllers/AnalyticsController.js.map +1 -0
  156. package/dist/http/controllers/AppController.d.ts +29 -0
  157. package/dist/http/controllers/AppController.d.ts.map +1 -0
  158. package/dist/http/controllers/AppController.js +36 -0
  159. package/dist/http/controllers/AppController.js.map +1 -0
  160. package/dist/http/controllers/AuditLogController.d.ts +26 -0
  161. package/dist/http/controllers/AuditLogController.d.ts.map +1 -0
  162. package/dist/http/controllers/AuditLogController.js +32 -0
  163. package/dist/http/controllers/AuditLogController.js.map +1 -0
  164. package/dist/http/controllers/AuthController.d.ts +18 -0
  165. package/dist/http/controllers/AuthController.d.ts.map +1 -0
  166. package/dist/http/controllers/AuthController.js +84 -0
  167. package/dist/http/controllers/AuthController.js.map +1 -0
  168. package/dist/http/controllers/BaseController.d.ts +7 -0
  169. package/dist/http/controllers/BaseController.d.ts.map +1 -0
  170. package/dist/http/controllers/BaseController.js +20 -0
  171. package/dist/http/controllers/BaseController.js.map +1 -0
  172. package/dist/http/controllers/CollectionController.d.ts +44 -0
  173. package/dist/http/controllers/CollectionController.d.ts.map +1 -0
  174. package/dist/http/controllers/CollectionController.js +89 -0
  175. package/dist/http/controllers/CollectionController.js.map +1 -0
  176. package/dist/http/controllers/DemoController.d.ts +34 -0
  177. package/dist/http/controllers/DemoController.d.ts.map +1 -0
  178. package/dist/http/controllers/DemoController.js +55 -0
  179. package/dist/http/controllers/DemoController.js.map +1 -0
  180. package/dist/http/controllers/FileController.d.ts +29 -0
  181. package/dist/http/controllers/FileController.d.ts.map +1 -0
  182. package/dist/http/controllers/FileController.js +172 -0
  183. package/dist/http/controllers/FileController.js.map +1 -0
  184. package/dist/http/controllers/HealthController.d.ts +10 -0
  185. package/dist/http/controllers/HealthController.d.ts.map +1 -0
  186. package/dist/http/controllers/HealthController.js +28 -0
  187. package/dist/http/controllers/HealthController.js.map +1 -0
  188. package/dist/http/controllers/LogController.d.ts +15 -0
  189. package/dist/http/controllers/LogController.d.ts.map +1 -0
  190. package/dist/http/controllers/LogController.js +25 -0
  191. package/dist/http/controllers/LogController.js.map +1 -0
  192. package/dist/http/controllers/RealtimeController.d.ts +13 -0
  193. package/dist/http/controllers/RealtimeController.d.ts.map +1 -0
  194. package/dist/http/controllers/RealtimeController.js +54 -0
  195. package/dist/http/controllers/RealtimeController.js.map +1 -0
  196. package/dist/http/controllers/RecordController.d.ts +74 -0
  197. package/dist/http/controllers/RecordController.d.ts.map +1 -0
  198. package/dist/http/controllers/RecordController.js +202 -0
  199. package/dist/http/controllers/RecordController.js.map +1 -0
  200. package/dist/http/controllers/TemplateController.d.ts +29 -0
  201. package/dist/http/controllers/TemplateController.d.ts.map +1 -0
  202. package/dist/http/controllers/TemplateController.js +63 -0
  203. package/dist/http/controllers/TemplateController.js.map +1 -0
  204. package/dist/http/controllers/WebhookController.d.ts +78 -0
  205. package/dist/http/controllers/WebhookController.d.ts.map +1 -0
  206. package/dist/http/controllers/WebhookController.js +113 -0
  207. package/dist/http/controllers/WebhookController.js.map +1 -0
  208. package/dist/http/middleware/AppResolutionMiddleware.d.ts +8 -0
  209. package/dist/http/middleware/AppResolutionMiddleware.d.ts.map +1 -0
  210. package/dist/http/middleware/AppResolutionMiddleware.js +98 -0
  211. package/dist/http/middleware/AppResolutionMiddleware.js.map +1 -0
  212. package/dist/http/middleware/AuthMiddleware.d.ts +17 -0
  213. package/dist/http/middleware/AuthMiddleware.d.ts.map +1 -0
  214. package/dist/http/middleware/AuthMiddleware.js +97 -0
  215. package/dist/http/middleware/AuthMiddleware.js.map +1 -0
  216. package/dist/http/middleware/ChaosMiddleware.d.ts +130 -0
  217. package/dist/http/middleware/ChaosMiddleware.d.ts.map +1 -0
  218. package/dist/http/middleware/ChaosMiddleware.js +434 -0
  219. package/dist/http/middleware/ChaosMiddleware.js.map +1 -0
  220. package/dist/index.d.ts +52 -0
  221. package/dist/index.d.ts.map +1 -0
  222. package/dist/index.js +141 -0
  223. package/dist/index.js.map +1 -0
  224. package/dist/logger/LogService.d.ts +31 -0
  225. package/dist/logger/LogService.d.ts.map +1 -0
  226. package/dist/logger/LogService.js +104 -0
  227. package/dist/logger/LogService.js.map +1 -0
  228. package/dist/plugins/algolia.d.ts +76 -0
  229. package/dist/plugins/algolia.d.ts.map +1 -0
  230. package/dist/plugins/algolia.js +532 -0
  231. package/dist/plugins/algolia.js.map +1 -0
  232. package/dist/plugins/index.d.ts +6 -0
  233. package/dist/plugins/index.d.ts.map +1 -0
  234. package/dist/plugins/index.js +22 -0
  235. package/dist/plugins/index.js.map +1 -0
  236. package/dist/plugins/resend.d.ts +42 -0
  237. package/dist/plugins/resend.d.ts.map +1 -0
  238. package/dist/plugins/resend.js +335 -0
  239. package/dist/plugins/resend.js.map +1 -0
  240. package/dist/plugins/s3.d.ts +35 -0
  241. package/dist/plugins/s3.d.ts.map +1 -0
  242. package/dist/plugins/s3.js +425 -0
  243. package/dist/plugins/s3.js.map +1 -0
  244. package/dist/plugins/stripe.d.ts +45 -0
  245. package/dist/plugins/stripe.d.ts.map +1 -0
  246. package/dist/plugins/stripe.js +470 -0
  247. package/dist/plugins/stripe.js.map +1 -0
  248. package/dist/plugins/webhooks.d.ts +35 -0
  249. package/dist/plugins/webhooks.d.ts.map +1 -0
  250. package/dist/plugins/webhooks.js +415 -0
  251. package/dist/plugins/webhooks.js.map +1 -0
  252. package/dist/realtime/RealtimeService.d.ts +26 -0
  253. package/dist/realtime/RealtimeService.d.ts.map +1 -0
  254. package/dist/realtime/RealtimeService.js +165 -0
  255. package/dist/realtime/RealtimeService.js.map +1 -0
  256. package/dist/records/CsvHelper.d.ts +27 -0
  257. package/dist/records/CsvHelper.d.ts.map +1 -0
  258. package/dist/records/CsvHelper.js +195 -0
  259. package/dist/records/CsvHelper.js.map +1 -0
  260. package/dist/records/FakerEngine.d.ts +73 -0
  261. package/dist/records/FakerEngine.d.ts.map +1 -0
  262. package/dist/records/FakerEngine.js +644 -0
  263. package/dist/records/FakerEngine.js.map +1 -0
  264. package/dist/records/FilterCodec.d.ts +22 -0
  265. package/dist/records/FilterCodec.d.ts.map +1 -0
  266. package/dist/records/FilterCodec.js +57 -0
  267. package/dist/records/FilterCodec.js.map +1 -0
  268. package/dist/records/FtsService.d.ts +63 -0
  269. package/dist/records/FtsService.d.ts.map +1 -0
  270. package/dist/records/FtsService.js +310 -0
  271. package/dist/records/FtsService.js.map +1 -0
  272. package/dist/records/MockDataService.d.ts +31 -0
  273. package/dist/records/MockDataService.d.ts.map +1 -0
  274. package/dist/records/MockDataService.js +222 -0
  275. package/dist/records/MockDataService.js.map +1 -0
  276. package/dist/records/QueryFilterParser.d.ts +35 -0
  277. package/dist/records/QueryFilterParser.d.ts.map +1 -0
  278. package/dist/records/QueryFilterParser.js +262 -0
  279. package/dist/records/QueryFilterParser.js.map +1 -0
  280. package/dist/records/RecordService.d.ts +77 -0
  281. package/dist/records/RecordService.d.ts.map +1 -0
  282. package/dist/records/RecordService.js +686 -0
  283. package/dist/records/RecordService.js.map +1 -0
  284. package/dist/rules/RuleBuilder.d.ts +72 -0
  285. package/dist/rules/RuleBuilder.d.ts.map +1 -0
  286. package/dist/rules/RuleBuilder.js +383 -0
  287. package/dist/rules/RuleBuilder.js.map +1 -0
  288. package/dist/rules/RuleEngine.d.ts +28 -0
  289. package/dist/rules/RuleEngine.d.ts.map +1 -0
  290. package/dist/rules/RuleEngine.js +204 -0
  291. package/dist/rules/RuleEngine.js.map +1 -0
  292. package/dist/schema/OpenApiGenerator.d.ts +32 -0
  293. package/dist/schema/OpenApiGenerator.d.ts.map +1 -0
  294. package/dist/schema/OpenApiGenerator.js +1836 -0
  295. package/dist/schema/OpenApiGenerator.js.map +1 -0
  296. package/dist/schema/SchemaInferenceService.d.ts +82 -0
  297. package/dist/schema/SchemaInferenceService.d.ts.map +1 -0
  298. package/dist/schema/SchemaInferenceService.js +622 -0
  299. package/dist/schema/SchemaInferenceService.js.map +1 -0
  300. package/dist/schema/SchemaService.d.ts +33 -0
  301. package/dist/schema/SchemaService.d.ts.map +1 -0
  302. package/dist/schema/SchemaService.js +338 -0
  303. package/dist/schema/SchemaService.js.map +1 -0
  304. package/dist/schema/TypeGenerator.d.ts +19 -0
  305. package/dist/schema/TypeGenerator.d.ts.map +1 -0
  306. package/dist/schema/TypeGenerator.js +173 -0
  307. package/dist/schema/TypeGenerator.js.map +1 -0
  308. package/dist/schema/models/Collection.d.ts +44 -0
  309. package/dist/schema/models/Collection.d.ts.map +1 -0
  310. package/dist/schema/models/Collection.js +3 -0
  311. package/dist/schema/models/Collection.js.map +1 -0
  312. package/dist/schema/models/Field.d.ts +25 -0
  313. package/dist/schema/models/Field.d.ts.map +1 -0
  314. package/dist/schema/models/Field.js +3 -0
  315. package/dist/schema/models/Field.js.map +1 -0
  316. package/dist/templates/TemplateImageGenerator.d.ts +43 -0
  317. package/dist/templates/TemplateImageGenerator.d.ts.map +1 -0
  318. package/dist/templates/TemplateImageGenerator.js +350 -0
  319. package/dist/templates/TemplateImageGenerator.js.map +1 -0
  320. package/dist/templates/TemplateService.d.ts +31 -0
  321. package/dist/templates/TemplateService.d.ts.map +1 -0
  322. package/dist/templates/TemplateService.js +209 -0
  323. package/dist/templates/TemplateService.js.map +1 -0
  324. package/dist/templates/definitions/blog.d.ts +3 -0
  325. package/dist/templates/definitions/blog.d.ts.map +1 -0
  326. package/dist/templates/definitions/blog.js +386 -0
  327. package/dist/templates/definitions/blog.js.map +1 -0
  328. package/dist/templates/definitions/crm.d.ts +3 -0
  329. package/dist/templates/definitions/crm.d.ts.map +1 -0
  330. package/dist/templates/definitions/crm.js +456 -0
  331. package/dist/templates/definitions/crm.js.map +1 -0
  332. package/dist/templates/definitions/ecommerce.d.ts +3 -0
  333. package/dist/templates/definitions/ecommerce.d.ts.map +1 -0
  334. package/dist/templates/definitions/ecommerce.js +781 -0
  335. package/dist/templates/definitions/ecommerce.js.map +1 -0
  336. package/dist/templates/definitions/index.d.ts +7 -0
  337. package/dist/templates/definitions/index.d.ts.map +1 -0
  338. package/dist/templates/definitions/index.js +15 -0
  339. package/dist/templates/definitions/index.js.map +1 -0
  340. package/dist/templates/types.d.ts +65 -0
  341. package/dist/templates/types.d.ts.map +1 -0
  342. package/dist/templates/types.js +3 -0
  343. package/dist/templates/types.js.map +1 -0
  344. package/dist/webhooks/WebhookService.d.ts +149 -0
  345. package/dist/webhooks/WebhookService.d.ts.map +1 -0
  346. package/dist/webhooks/WebhookService.js +781 -0
  347. package/dist/webhooks/WebhookService.js.map +1 -0
  348. package/package.json +86 -4
@@ -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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ChaosMiddleware.js","sourceRoot":"","sources":["../../../src/http/middleware/ChaosMiddleware.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ export { NodeStack, NodeStackOptions, NodeBase, NodeBaseOptions } from './NodeStack';
2
+ export { Container } from './core/container/Container';
3
+ export { TOKENS, ServiceIdentifier } from './core/container/Tokens';
4
+ export { ConfigService, NodeStackConfigOptions, NodeBaseConfigOptions } from './core/config/ConfigService';
5
+ export { loadEnvFile } from './core/config/EnvLoader';
6
+ export { EventBus } from './core/events/EventBus';
7
+ export * from './core/events/types';
8
+ export * from './core/errors/AppError';
9
+ export { DatabaseService } from './database/DatabaseService';
10
+ export { IDatabaseDriver, IPreparedStatement, RunResult } from './database/drivers/IDatabaseDriver';
11
+ export { NodeSqliteDriver } from './database/drivers/NodeSqliteDriver';
12
+ export { SchemaService } from './schema/SchemaService';
13
+ export { SchemaInferenceService, inferFieldType, isDateString, sanitizeFieldName, parsePayload, InferredSchemaResult, ImportJsonOptions, ImportJsonResult, } from './schema/SchemaInferenceService';
14
+ export { TypeGenerator } from './schema/TypeGenerator';
15
+ export { OpenApiGenerator, OpenApiGeneratorOptions } from './schema/OpenApiGenerator';
16
+ export * from './schema/models/Collection';
17
+ export * from './schema/models/Field';
18
+ export { RecordService, ListResult, QueryOptions, ExportResult, ImportOptions, ImportResult } from './records/RecordService';
19
+ export { MockDataService, MockGenerateOptions, MockGenerateResult } from './records/MockDataService';
20
+ export { FakerEngine, FakerContext, GeneratedFilePayload } from './records/FakerEngine';
21
+ export { QueryFilterParser, ParsedFilter, ParsedSort } from './records/QueryFilterParser';
22
+ export { CsvHelper } from './records/CsvHelper';
23
+ export { FtsService, FtsQueryOptions, sanitizeFtsQuery, isFtsField, getFtsFields, getFtsTableName, } from './records/FtsService';
24
+ export { RuleEngine, RuleEvaluationContext } from './rules/RuleEngine';
25
+ export { RuleBuilder, RuleClause, ParsedRule, RuleOperator, RuleMode, RuleOperation, RuleJoinOp, SUPPORTED_OPERATORS, COMMON_AUTH_FIELDS, } from './rules/RuleBuilder';
26
+ export { AuthService, AuthClaims, AuthResult } from './auth/AuthService';
27
+ export { FileStorageService, SavedFileMeta } from './files/FileStorageService';
28
+ export { RealtimeService, RealtimeAction, RealtimeClient } from './realtime/RealtimeService';
29
+ export { LogService, LogEntry } from './logger/LogService';
30
+ export { AuditLogService, AuditLogEntry, AuditDiffMap, AuditFieldDiff, AuditQueryOptions, AuditListResult, } from './audit/AuditLogService';
31
+ export { WebhookService, WebhookConfig, WebhookDeliveryLog, WebhookQueryOptions, DeliveryQueryOptions, DeliveryListResult, WebhookStatsResult, } from './webhooks/WebhookService';
32
+ export { AnalyticsService, AnalyticsMetrics, DatabaseMetrics, RealtimeMetrics, Traffic24hMetrics, HourlyDataPoint, CollectionRecordCount, formatBytes, } from './analytics/AnalyticsService';
33
+ export { HttpServer } from './http/HttpServer';
34
+ export { AuthMiddleware } from './http/middleware/AuthMiddleware';
35
+ export { ChaosMiddleware, ChaosSimulationConfig, RequestSimulationParams, } from './http/middleware/ChaosMiddleware';
36
+ export { AdminUIService } from './admin/AdminUIService';
37
+ export { AdminUIBundler } from './admin/AdminUIBundler';
38
+ export { DocsService } from './admin/DocsService';
39
+ export { TemplateService } from './templates/TemplateService';
40
+ export { TemplateImageGenerator } from './templates/TemplateImageGenerator';
41
+ export { STARTER_TEMPLATES, ecommerceTemplate, blogTemplate, crmTemplate } from './templates/definitions';
42
+ export * from './templates/types';
43
+ export { DemoService, DemoSnapshotOptions, DemoCollectionSummary, DemoSnapshotMetadata, DemoSnapshotStatus, DemoResetResult, } from './demo/DemoService';
44
+ export { DemoController } from './http/controllers/DemoController';
45
+ export { PluginManager } from './core/plugins/PluginManager';
46
+ export * from './core/plugins/types';
47
+ export * from './plugins';
48
+ export { AppManager, DatabaseDriverFactory } from './apps/AppManager';
49
+ export { AppRegistry } from './apps/AppRegistry';
50
+ export { AppScope } from './apps/AppScope';
51
+ export * from './apps/models/App';
52
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}