xypriss 9.14.13 → 9.14.15

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 (693) hide show
  1. package/dist/cjs/index.js +39023 -2
  2. package/dist/cjs/index.js.map +1 -0
  3. package/dist/esm/index.js +38960 -2
  4. package/dist/esm/index.js.map +1 -0
  5. package/package.json +5 -5
  6. package/dist/cjs/src/ConfigurationManager.js +0 -391
  7. package/dist/cjs/src/ConfigurationManager.js.map +0 -1
  8. package/dist/cjs/src/FiUp.js +0 -88
  9. package/dist/cjs/src/FiUp.js.map +0 -1
  10. package/dist/cjs/src/cache/CacheFactory.js +0 -416
  11. package/dist/cjs/src/cache/CacheFactory.js.map +0 -1
  12. package/dist/cjs/src/configs/WEAK_SECRETS.js +0 -21
  13. package/dist/cjs/src/configs/WEAK_SECRETS.js.map +0 -1
  14. package/dist/cjs/src/const.js +0 -577
  15. package/dist/cjs/src/const.js.map +0 -1
  16. package/dist/cjs/src/index.js +0 -110
  17. package/dist/cjs/src/index.js.map +0 -1
  18. package/dist/cjs/src/middleware/XJsonResponseHandler.js +0 -180
  19. package/dist/cjs/src/middleware/XJsonResponseHandler.js.map +0 -1
  20. package/dist/cjs/src/middleware/XyPrissMiddlewareAPI.js +0 -289
  21. package/dist/cjs/src/middleware/XyPrissMiddlewareAPI.js.map +0 -1
  22. package/dist/cjs/src/middleware/built-in/BuiltInMiddleware.js +0 -167
  23. package/dist/cjs/src/middleware/built-in/BuiltInMiddleware.js.map +0 -1
  24. package/dist/cjs/src/middleware/built-in/ConversionProxyMiddleware.js +0 -52
  25. package/dist/cjs/src/middleware/built-in/ConversionProxyMiddleware.js.map +0 -1
  26. package/dist/cjs/src/middleware/built-in/security/BrowserOnlyProtector.js +0 -552
  27. package/dist/cjs/src/middleware/built-in/security/BrowserOnlyProtector.js.map +0 -1
  28. package/dist/cjs/src/middleware/built-in/security/HoneypotTarpit.js +0 -561
  29. package/dist/cjs/src/middleware/built-in/security/HoneypotTarpit.js.map +0 -1
  30. package/dist/cjs/src/middleware/built-in/security/MaliciousUrlScanner.js +0 -137
  31. package/dist/cjs/src/middleware/built-in/security/MaliciousUrlScanner.js.map +0 -1
  32. package/dist/cjs/src/middleware/built-in/security/MobileOnlyProtector.js +0 -504
  33. package/dist/cjs/src/middleware/built-in/security/MobileOnlyProtector.js.map +0 -1
  34. package/dist/cjs/src/middleware/built-in/security/RequestSignatureProtector.js +0 -487
  35. package/dist/cjs/src/middleware/built-in/security/RequestSignatureProtector.js.map +0 -1
  36. package/dist/cjs/src/middleware/built-in/security/TerminalOnlyProtector.js +0 -478
  37. package/dist/cjs/src/middleware/built-in/security/TerminalOnlyProtector.js.map +0 -1
  38. package/dist/cjs/src/middleware/built-in/security/UriNormalizer.js +0 -413
  39. package/dist/cjs/src/middleware/built-in/security/UriNormalizer.js.map +0 -1
  40. package/dist/cjs/src/middleware/built-in/security/XyPrissHPP.js +0 -52
  41. package/dist/cjs/src/middleware/built-in/security/XyPrissHPP.js.map +0 -1
  42. package/dist/cjs/src/middleware/safe-json-middleware.js +0 -73
  43. package/dist/cjs/src/middleware/safe-json-middleware.js.map +0 -1
  44. package/dist/cjs/src/middleware/security-middleware.js +0 -548
  45. package/dist/cjs/src/middleware/security-middleware.js.map +0 -1
  46. package/dist/cjs/src/plugins/ServerPluginManager.js +0 -153
  47. package/dist/cjs/src/plugins/ServerPluginManager.js.map +0 -1
  48. package/dist/cjs/src/plugins/api/PluginAPI.js +0 -306
  49. package/dist/cjs/src/plugins/api/PluginAPI.js.map +0 -1
  50. package/dist/cjs/src/plugins/builtin/RouteOptimizationPlugin.js +0 -421
  51. package/dist/cjs/src/plugins/builtin/RouteOptimizationPlugin.js.map +0 -1
  52. package/dist/cjs/src/plugins/builtin/server-maintenance/ServerMaintenancePlugin.js +0 -598
  53. package/dist/cjs/src/plugins/builtin/server-maintenance/ServerMaintenancePlugin.js.map +0 -1
  54. package/dist/cjs/src/plugins/builtin/xems/XemsBuiltinPlugin.js +0 -332
  55. package/dist/cjs/src/plugins/builtin/xems/XemsBuiltinPlugin.js.map +0 -1
  56. package/dist/cjs/src/plugins/builtin/xems/XemsPlugin.js +0 -432
  57. package/dist/cjs/src/plugins/builtin/xems/XemsPlugin.js.map +0 -1
  58. package/dist/cjs/src/plugins/const/OFFICIAL_PLUGINS.js +0 -10
  59. package/dist/cjs/src/plugins/const/OFFICIAL_PLUGINS.js.map +0 -1
  60. package/dist/cjs/src/plugins/const/PluginHookIds.js +0 -191
  61. package/dist/cjs/src/plugins/const/PluginHookIds.js.map +0 -1
  62. package/dist/cjs/src/plugins/const/XyprissTempDir.js +0 -136
  63. package/dist/cjs/src/plugins/const/XyprissTempDir.js.map +0 -1
  64. package/dist/cjs/src/plugins/const/getSysApi.js +0 -17
  65. package/dist/cjs/src/plugins/const/getSysApi.js.map +0 -1
  66. package/dist/cjs/src/plugins/core/PermissionManager.js +0 -240
  67. package/dist/cjs/src/plugins/core/PermissionManager.js.map +0 -1
  68. package/dist/cjs/src/plugins/core/XPluginManager.js +0 -218
  69. package/dist/cjs/src/plugins/core/XPluginManager.js.map +0 -1
  70. package/dist/cjs/src/plugins/core/manager/PluginHookRunner.js +0 -108
  71. package/dist/cjs/src/plugins/core/manager/PluginHookRunner.js.map +0 -1
  72. package/dist/cjs/src/plugins/core/manager/PluginInterceptor.js +0 -200
  73. package/dist/cjs/src/plugins/core/manager/PluginInterceptor.js.map +0 -1
  74. package/dist/cjs/src/plugins/core/manager/PluginLoader.js +0 -208
  75. package/dist/cjs/src/plugins/core/manager/PluginLoader.js.map +0 -1
  76. package/dist/cjs/src/plugins/core/manager/PluginManagement.js +0 -135
  77. package/dist/cjs/src/plugins/core/manager/PluginManagement.js.map +0 -1
  78. package/dist/cjs/src/plugins/core/manager/PluginRegistry.js +0 -100
  79. package/dist/cjs/src/plugins/core/manager/PluginRegistry.js.map +0 -1
  80. package/dist/cjs/src/plugins/core/manager/PluginSecurity.js +0 -442
  81. package/dist/cjs/src/plugins/core/manager/PluginSecurity.js.map +0 -1
  82. package/dist/cjs/src/plugins/types/PluginTypes.js +0 -32
  83. package/dist/cjs/src/plugins/types/PluginTypes.js.map +0 -1
  84. package/dist/cjs/src/quick-start.js +0 -31
  85. package/dist/cjs/src/quick-start.js.map +0 -1
  86. package/dist/cjs/src/schemas/plugingSchema.js +0 -45
  87. package/dist/cjs/src/schemas/plugingSchema.js.map +0 -1
  88. package/dist/cjs/src/server/FastServer/ComponentManager.js +0 -94
  89. package/dist/cjs/src/server/FastServer/ComponentManager.js.map +0 -1
  90. package/dist/cjs/src/server/FastServer/LogTracingMethods.js +0 -35
  91. package/dist/cjs/src/server/FastServer/LogTracingMethods.js.map +0 -1
  92. package/dist/cjs/src/server/FastServer/MiddlewareManager.js +0 -73
  93. package/dist/cjs/src/server/FastServer/MiddlewareManager.js.map +0 -1
  94. package/dist/cjs/src/server/FastServer/ShutdownManager.js +0 -82
  95. package/dist/cjs/src/server/FastServer/ShutdownManager.js.map +0 -1
  96. package/dist/cjs/src/server/FastServer/UploadManager.js +0 -71
  97. package/dist/cjs/src/server/FastServer/UploadManager.js.map +0 -1
  98. package/dist/cjs/src/server/FastServer/index.js +0 -226
  99. package/dist/cjs/src/server/FastServer/index.js.map +0 -1
  100. package/dist/cjs/src/server/ServerFactory.js +0 -170
  101. package/dist/cjs/src/server/ServerFactory.js.map +0 -1
  102. package/dist/cjs/src/server/components/fastapi/CacheManager.js +0 -217
  103. package/dist/cjs/src/server/components/fastapi/CacheManager.js.map +0 -1
  104. package/dist/cjs/src/server/components/fastapi/RedirectManager.js +0 -437
  105. package/dist/cjs/src/server/components/fastapi/RedirectManager.js.map +0 -1
  106. package/dist/cjs/src/server/components/fastapi/RequestProcessor.js +0 -182
  107. package/dist/cjs/src/server/components/fastapi/RequestProcessor.js.map +0 -1
  108. package/dist/cjs/src/server/components/fastapi/RouteManager.js +0 -123
  109. package/dist/cjs/src/server/components/fastapi/RouteManager.js.map +0 -1
  110. package/dist/cjs/src/server/components/fastapi/WorkerPoolComponent.js +0 -85
  111. package/dist/cjs/src/server/components/fastapi/WorkerPoolComponent.js.map +0 -1
  112. package/dist/cjs/src/server/components/fastapi/console/ConsoleInterceptor.js +0 -359
  113. package/dist/cjs/src/server/components/fastapi/console/ConsoleInterceptor.js.map +0 -1
  114. package/dist/cjs/src/server/components/fastapi/console/types.js +0 -35
  115. package/dist/cjs/src/server/components/fastapi/console/types.js.map +0 -1
  116. package/dist/cjs/src/server/components/fastapi/templates/redirectTemp.js +0 -101
  117. package/dist/cjs/src/server/components/fastapi/templates/redirectTemp.js.map +0 -1
  118. package/dist/cjs/src/server/components/fastapi/upload/FileUploadManager.js +0 -342
  119. package/dist/cjs/src/server/components/fastapi/upload/FileUploadManager.js.map +0 -1
  120. package/dist/cjs/src/server/components/fastapi/upload/file-upload.js +0 -307
  121. package/dist/cjs/src/server/components/fastapi/upload/file-upload.js.map +0 -1
  122. package/dist/cjs/src/server/components/multi-server/MultiServerApp.js +0 -717
  123. package/dist/cjs/src/server/components/multi-server/MultiServerApp.js.map +0 -1
  124. package/dist/cjs/src/server/components/multi-server/MultiServerManager.js +0 -501
  125. package/dist/cjs/src/server/components/multi-server/MultiServerManager.js.map +0 -1
  126. package/dist/cjs/src/server/components/multi-server/XMSStartupUI.js +0 -320
  127. package/dist/cjs/src/server/components/multi-server/XMSStartupUI.js.map +0 -1
  128. package/dist/cjs/src/server/components/response-control/ResponseControlManager.js +0 -64
  129. package/dist/cjs/src/server/components/response-control/ResponseControlManager.js.map +0 -1
  130. package/dist/cjs/src/server/components/static/IXStaticSchem.js +0 -30
  131. package/dist/cjs/src/server/components/static/IXStaticSchem.js.map +0 -1
  132. package/dist/cjs/src/server/components/static/MetaCache.js +0 -43
  133. package/dist/cjs/src/server/components/static/MetaCache.js.map +0 -1
  134. package/dist/cjs/src/server/components/static/XStatic.js +0 -402
  135. package/dist/cjs/src/server/components/static/XStatic.js.map +0 -1
  136. package/dist/cjs/src/server/const/Defaulthelmetopts.js +0 -126
  137. package/dist/cjs/src/server/const/Defaulthelmetopts.js.map +0 -1
  138. package/dist/cjs/src/server/const/MIME_MAP.js +0 -423
  139. package/dist/cjs/src/server/const/MIME_MAP.js.map +0 -1
  140. package/dist/cjs/src/server/const/XHSC_SIGNATURE.js +0 -78
  141. package/dist/cjs/src/server/const/XHSC_SIGNATURE.js.map +0 -1
  142. package/dist/cjs/src/server/const/XRUNTIME-HEADER.js +0 -6
  143. package/dist/cjs/src/server/const/XRUNTIME-HEADER.js.map +0 -1
  144. package/dist/cjs/src/server/const/default.js +0 -368
  145. package/dist/cjs/src/server/const/default.js.map +0 -1
  146. package/dist/cjs/src/server/const/http.js +0 -19
  147. package/dist/cjs/src/server/const/http.js.map +0 -1
  148. package/dist/cjs/src/server/const/internalFlags.js +0 -15
  149. package/dist/cjs/src/server/const/internalFlags.js.map +0 -1
  150. package/dist/cjs/src/server/const/reStrategy.js +0 -6
  151. package/dist/cjs/src/server/const/reStrategy.js.map +0 -1
  152. package/dist/cjs/src/server/const/xemsKeyPlaceholder.js +0 -6
  153. package/dist/cjs/src/server/const/xemsKeyPlaceholder.js.map +0 -1
  154. package/dist/cjs/src/server/core/HttpServer.js +0 -296
  155. package/dist/cjs/src/server/core/HttpServer.js.map +0 -1
  156. package/dist/cjs/src/server/core/RequestApp.js +0 -95
  157. package/dist/cjs/src/server/core/RequestApp.js.map +0 -1
  158. package/dist/cjs/src/server/core/RequestEnhancer.js +0 -351
  159. package/dist/cjs/src/server/core/RequestEnhancer.js.map +0 -1
  160. package/dist/cjs/src/server/core/ResponseEnhancer.js +0 -594
  161. package/dist/cjs/src/server/core/ResponseEnhancer.js.map +0 -1
  162. package/dist/cjs/src/server/core/SendFileHandler.js +0 -119
  163. package/dist/cjs/src/server/core/SendFileHandler.js.map +0 -1
  164. package/dist/cjs/src/server/core/StartupProcessor.js +0 -113
  165. package/dist/cjs/src/server/core/StartupProcessor.js.map +0 -1
  166. package/dist/cjs/src/server/core/VirtualServer.js +0 -33
  167. package/dist/cjs/src/server/core/VirtualServer.js.map +0 -1
  168. package/dist/cjs/src/server/core/XHSCBridge/EngineManager.js +0 -203
  169. package/dist/cjs/src/server/core/XHSCBridge/EngineManager.js.map +0 -1
  170. package/dist/cjs/src/server/core/XHSCBridge/LogProcessor.js +0 -159
  171. package/dist/cjs/src/server/core/XHSCBridge/LogProcessor.js.map +0 -1
  172. package/dist/cjs/src/server/core/XHSCBridge/SocketManager.js +0 -119
  173. package/dist/cjs/src/server/core/XHSCBridge/SocketManager.js.map +0 -1
  174. package/dist/cjs/src/server/core/XHSCBridge/index.js +0 -115
  175. package/dist/cjs/src/server/core/XHSCBridge/index.js.map +0 -1
  176. package/dist/cjs/src/server/core/XHSCProtocol.js +0 -421
  177. package/dist/cjs/src/server/core/XHSCProtocol.js.map +0 -1
  178. package/dist/cjs/src/server/core/XHSCRequest.js +0 -502
  179. package/dist/cjs/src/server/core/XHSCRequest.js.map +0 -1
  180. package/dist/cjs/src/server/core/XNullSocket.js +0 -118
  181. package/dist/cjs/src/server/core/XNullSocket.js.map +0 -1
  182. package/dist/cjs/src/server/core/XyDiagnosticsManager.js +0 -78
  183. package/dist/cjs/src/server/core/XyDiagnosticsManager.js.map +0 -1
  184. package/dist/cjs/src/server/core/XyLifecycleManager.js +0 -255
  185. package/dist/cjs/src/server/core/XyLifecycleManager.js.map +0 -1
  186. package/dist/cjs/src/server/core/XyModuleManager.js +0 -129
  187. package/dist/cjs/src/server/core/XyModuleManager.js.map +0 -1
  188. package/dist/cjs/src/server/core/XyRoutingManager.js +0 -204
  189. package/dist/cjs/src/server/core/XyRoutingManager.js.map +0 -1
  190. package/dist/cjs/src/server/core/XyServerCreator.js +0 -146
  191. package/dist/cjs/src/server/core/XyServerCreator.js.map +0 -1
  192. package/dist/cjs/src/server/core/XyprissApp.js +0 -579
  193. package/dist/cjs/src/server/core/XyprissApp.js.map +0 -1
  194. package/dist/cjs/src/server/core/http/BodyParser.js +0 -75
  195. package/dist/cjs/src/server/core/http/BodyParser.js.map +0 -1
  196. package/dist/cjs/src/server/core/http/HttpErrorHandler.js +0 -53
  197. package/dist/cjs/src/server/core/http/HttpErrorHandler.js.map +0 -1
  198. package/dist/cjs/src/server/core/http/RequestForwarder.js +0 -45
  199. package/dist/cjs/src/server/core/http/RequestForwarder.js.map +0 -1
  200. package/dist/cjs/src/server/core/http/RouteManager.js +0 -156
  201. package/dist/cjs/src/server/core/http/RouteManager.js.map +0 -1
  202. package/dist/cjs/src/server/core/request/XyRequestManager.js +0 -231
  203. package/dist/cjs/src/server/core/request/XyRequestManager.js.map +0 -1
  204. package/dist/cjs/src/server/handlers/NotFoundHandler.js +0 -85
  205. package/dist/cjs/src/server/handlers/NotFoundHandler.js.map +0 -1
  206. package/dist/cjs/src/server/handlers/templates/notFoundTemplate.js +0 -400
  207. package/dist/cjs/src/server/handlers/templates/notFoundTemplate.js.map +0 -1
  208. package/dist/cjs/src/server/middleware/MiddlewareManager.js +0 -221
  209. package/dist/cjs/src/server/middleware/MiddlewareManager.js.map +0 -1
  210. package/dist/cjs/src/server/routing/Router.js +0 -189
  211. package/dist/cjs/src/server/routing/Router.js.map +0 -1
  212. package/dist/cjs/src/server/routing/modules/XyGuard.js +0 -37
  213. package/dist/cjs/src/server/routing/modules/XyGuard.js.map +0 -1
  214. package/dist/cjs/src/server/routing/modules/constants.js +0 -18
  215. package/dist/cjs/src/server/routing/modules/constants.js.map +0 -1
  216. package/dist/cjs/src/server/routing/modules/groups.js +0 -79
  217. package/dist/cjs/src/server/routing/modules/groups.js.map +0 -1
  218. package/dist/cjs/src/server/routing/modules/helpers.js +0 -168
  219. package/dist/cjs/src/server/routing/modules/helpers.js.map +0 -1
  220. package/dist/cjs/src/server/routing/modules/middleware.js +0 -173
  221. package/dist/cjs/src/server/routing/modules/middleware.js.map +0 -1
  222. package/dist/cjs/src/server/routing/modules/path.js +0 -134
  223. package/dist/cjs/src/server/routing/modules/path.js.map +0 -1
  224. package/dist/cjs/src/server/routing/modules/registry.js +0 -164
  225. package/dist/cjs/src/server/routing/modules/registry.js.map +0 -1
  226. package/dist/cjs/src/server/utils/ConfigLoader.js +0 -205
  227. package/dist/cjs/src/server/utils/ConfigLoader.js.map +0 -1
  228. package/dist/cjs/src/server/utils/MetaConfigRunner.js +0 -89
  229. package/dist/cjs/src/server/utils/MetaConfigRunner.js.map +0 -1
  230. package/dist/cjs/src/server/utils/PortManager.js +0 -200
  231. package/dist/cjs/src/server/utils/PortManager.js.map +0 -1
  232. package/dist/cjs/src/server/utils/WorkerModeHandler.js +0 -82
  233. package/dist/cjs/src/server/utils/WorkerModeHandler.js.map +0 -1
  234. package/dist/cjs/src/server/utils/internalFlagsFunctions.js +0 -156
  235. package/dist/cjs/src/server/utils/internalFlagsFunctions.js.map +0 -1
  236. package/dist/cjs/src/server/utils/reconcilePortConflictResolution.js +0 -79
  237. package/dist/cjs/src/server/utils/reconcilePortConflictResolution.js.map +0 -1
  238. package/dist/cjs/src/shared/logger/DEFAULT_LOGGER_CONFIG.js +0 -68
  239. package/dist/cjs/src/shared/logger/DEFAULT_LOGGER_CONFIG.js.map +0 -1
  240. package/dist/cjs/src/shared/logger/DEFAULT_PALETTE.js +0 -20
  241. package/dist/cjs/src/shared/logger/DEFAULT_PALETTE.js.map +0 -1
  242. package/dist/cjs/src/shared/logger/Logger.js +0 -634
  243. package/dist/cjs/src/shared/logger/Logger.js.map +0 -1
  244. package/dist/cjs/src/shared/logger/quickLogger.js +0 -224
  245. package/dist/cjs/src/shared/logger/quickLogger.js.map +0 -1
  246. package/dist/cjs/src/types/NotFoundConfig.js +0 -87
  247. package/dist/cjs/src/types/NotFoundConfig.js.map +0 -1
  248. package/dist/cjs/src/utils/ConfigSyntaxParser.js +0 -243
  249. package/dist/cjs/src/utils/ConfigSyntaxParser.js.map +0 -1
  250. package/dist/cjs/src/utils/CorePathCheck.js +0 -39
  251. package/dist/cjs/src/utils/CorePathCheck.js.map +0 -1
  252. package/dist/cjs/src/utils/JsonUtils.js +0 -33
  253. package/dist/cjs/src/utils/JsonUtils.js.map +0 -1
  254. package/dist/cjs/src/utils/ProjectDiscovery.js +0 -179
  255. package/dist/cjs/src/utils/ProjectDiscovery.js.map +0 -1
  256. package/dist/cjs/src/utils/SecurityShield.js +0 -96
  257. package/dist/cjs/src/utils/SecurityShield.js.map +0 -1
  258. package/dist/cjs/src/utils/Send.js +0 -653
  259. package/dist/cjs/src/utils/Send.js.map +0 -1
  260. package/dist/cjs/src/utils/getIp.js +0 -164
  261. package/dist/cjs/src/utils/getIp.js.map +0 -1
  262. package/dist/cjs/src/utils/getMime.js +0 -96
  263. package/dist/cjs/src/utils/getMime.js.map +0 -1
  264. package/dist/cjs/src/utils/mergeWithDefaults.js +0 -176
  265. package/dist/cjs/src/utils/mergeWithDefaults.js.map +0 -1
  266. package/dist/cjs/src/utils/mimeUtils.js +0 -18
  267. package/dist/cjs/src/utils/mimeUtils.js.map +0 -1
  268. package/dist/cjs/src/utils/xtrsParser.js +0 -198
  269. package/dist/cjs/src/utils/xtrsParser.js.map +0 -1
  270. package/dist/cjs/src/xhsc/EnvApi.js +0 -716
  271. package/dist/cjs/src/xhsc/EnvApi.js.map +0 -1
  272. package/dist/cjs/src/xhsc/FSApi.js +0 -54
  273. package/dist/cjs/src/xhsc/FSApi.js.map +0 -1
  274. package/dist/cjs/src/xhsc/OSApi.js +0 -225
  275. package/dist/cjs/src/xhsc/OSApi.js.map +0 -1
  276. package/dist/cjs/src/xhsc/PathApi.js +0 -389
  277. package/dist/cjs/src/xhsc/PathApi.js.map +0 -1
  278. package/dist/cjs/src/xhsc/System.js +0 -63
  279. package/dist/cjs/src/xhsc/System.js.map +0 -1
  280. package/dist/cjs/src/xhsc/UtilsApi.js +0 -250
  281. package/dist/cjs/src/xhsc/UtilsApi.js.map +0 -1
  282. package/dist/cjs/src/xhsc/VarsApi.js +0 -180
  283. package/dist/cjs/src/xhsc/VarsApi.js.map +0 -1
  284. package/dist/cjs/src/xhsc/XyPrissRunner.js +0 -180
  285. package/dist/cjs/src/xhsc/XyPrissRunner.js.map +0 -1
  286. package/dist/cjs/src/xhsc/api/env/XessIpcClient.js +0 -600
  287. package/dist/cjs/src/xhsc/api/env/XessIpcClient.js.map +0 -1
  288. package/dist/cjs/src/xhsc/api/env/env.js +0 -166
  289. package/dist/cjs/src/xhsc/api/env/env.js.map +0 -1
  290. package/dist/cjs/src/xhsc/cluster/XHSCWorker.js +0 -359
  291. package/dist/cjs/src/xhsc/cluster/XHSCWorker.js.map +0 -1
  292. package/dist/cjs/src/xhsc/cluster/xbp.js +0 -352
  293. package/dist/cjs/src/xhsc/cluster/xbp.js.map +0 -1
  294. package/dist/cjs/src/xhsc/fs/FSArchive.js +0 -71
  295. package/dist/cjs/src/xhsc/fs/FSArchive.js.map +0 -1
  296. package/dist/cjs/src/xhsc/fs/FSBase.js +0 -20
  297. package/dist/cjs/src/xhsc/fs/FSBase.js.map +0 -1
  298. package/dist/cjs/src/xhsc/fs/FSCore.js +0 -669
  299. package/dist/cjs/src/xhsc/fs/FSCore.js.map +0 -1
  300. package/dist/cjs/src/xhsc/fs/FSExtended.js +0 -308
  301. package/dist/cjs/src/xhsc/fs/FSExtended.js.map +0 -1
  302. package/dist/cjs/src/xhsc/fs/FSHelpers.js +0 -522
  303. package/dist/cjs/src/xhsc/fs/FSHelpers.js.map +0 -1
  304. package/dist/cjs/src/xhsc/fs/FSSearch.js +0 -100
  305. package/dist/cjs/src/xhsc/fs/FSSearch.js.map +0 -1
  306. package/dist/cjs/src/xhsc/fs/FSWatch.js +0 -141
  307. package/dist/cjs/src/xhsc/fs/FSWatch.js.map +0 -1
  308. package/dist/cjs/src/xhsc/fs/FileHandle.js +0 -142
  309. package/dist/cjs/src/xhsc/fs/FileHandle.js.map +0 -1
  310. package/dist/cjs/src/xhsc/fs/TempFileManager.js +0 -165
  311. package/dist/cjs/src/xhsc/fs/TempFileManager.js.map +0 -1
  312. package/dist/cjs/src/xhsc/ipc/XHSCDirectIPC.js +0 -134
  313. package/dist/cjs/src/xhsc/ipc/XHSCDirectIPC.js.map +0 -1
  314. package/dist/cjs/src/xhsc/synapx/SynapxClient.js +0 -544
  315. package/dist/cjs/src/xhsc/synapx/SynapxClient.js.map +0 -1
  316. package/dist/cjs/src/xhsc/synapx/SynapxSchemaPacker.js +0 -44
  317. package/dist/cjs/src/xhsc/synapx/SynapxSchemaPacker.js.map +0 -1
  318. package/dist/cjs/src/xhsc/synapx/SynapxSyncBridge.js +0 -322
  319. package/dist/cjs/src/xhsc/synapx/SynapxSyncBridge.js.map +0 -1
  320. package/dist/cjs/src/xhsc/utils/ArrayUtils.js +0 -67
  321. package/dist/cjs/src/xhsc/utils/ArrayUtils.js.map +0 -1
  322. package/dist/cjs/src/xhsc/utils/AsyncUtils.js +0 -582
  323. package/dist/cjs/src/xhsc/utils/AsyncUtils.js.map +0 -1
  324. package/dist/cjs/src/xhsc/utils/DateUtils.js +0 -1135
  325. package/dist/cjs/src/xhsc/utils/DateUtils.js.map +0 -1
  326. package/dist/cjs/src/xhsc/utils/Discovery.js +0 -121
  327. package/dist/cjs/src/xhsc/utils/Discovery.js.map +0 -1
  328. package/dist/cjs/src/xhsc/utils/FunctionUtils.js +0 -29
  329. package/dist/cjs/src/xhsc/utils/FunctionUtils.js.map +0 -1
  330. package/dist/cjs/src/xhsc/utils/IdUtils.js +0 -22
  331. package/dist/cjs/src/xhsc/utils/IdUtils.js.map +0 -1
  332. package/dist/cjs/src/xhsc/utils/LoggerUtils.js +0 -545
  333. package/dist/cjs/src/xhsc/utils/LoggerUtils.js.map +0 -1
  334. package/dist/cjs/src/xhsc/utils/NumberUtils.js +0 -1182
  335. package/dist/cjs/src/xhsc/utils/NumberUtils.js.map +0 -1
  336. package/dist/cjs/src/xhsc/utils/ObjectUtils.js +0 -728
  337. package/dist/cjs/src/xhsc/utils/ObjectUtils.js.map +0 -1
  338. package/dist/cjs/src/xhsc/utils/ObjectWrapper.js +0 -672
  339. package/dist/cjs/src/xhsc/utils/ObjectWrapper.js.map +0 -1
  340. package/dist/cjs/src/xhsc/utils/Platform.js +0 -51
  341. package/dist/cjs/src/xhsc/utils/Platform.js.map +0 -1
  342. package/dist/cjs/src/xhsc/utils/StringUtils.js +0 -765
  343. package/dist/cjs/src/xhsc/utils/StringUtils.js.map +0 -1
  344. package/dist/cjs/src/xhsc/utils/StringWrapper.js +0 -302
  345. package/dist/cjs/src/xhsc/utils/StringWrapper.js.map +0 -1
  346. package/dist/cjs/src/xhsc/utils/ValidationUtils.js +0 -49
  347. package/dist/cjs/src/xhsc/utils/ValidationUtils.js.map +0 -1
  348. package/dist/cjs/src/xhsc.js +0 -286
  349. package/dist/cjs/src/xhsc.js.map +0 -1
  350. package/dist/esm/src/ConfigurationManager.js +0 -387
  351. package/dist/esm/src/ConfigurationManager.js.map +0 -1
  352. package/dist/esm/src/FiUp.js +0 -82
  353. package/dist/esm/src/FiUp.js.map +0 -1
  354. package/dist/esm/src/cache/CacheFactory.js +0 -412
  355. package/dist/esm/src/cache/CacheFactory.js.map +0 -1
  356. package/dist/esm/src/configs/WEAK_SECRETS.js +0 -19
  357. package/dist/esm/src/configs/WEAK_SECRETS.js.map +0 -1
  358. package/dist/esm/src/const.js +0 -574
  359. package/dist/esm/src/const.js.map +0 -1
  360. package/dist/esm/src/index.js +0 -69
  361. package/dist/esm/src/index.js.map +0 -1
  362. package/dist/esm/src/middleware/XJsonResponseHandler.js +0 -178
  363. package/dist/esm/src/middleware/XJsonResponseHandler.js.map +0 -1
  364. package/dist/esm/src/middleware/XyPrissMiddlewareAPI.js +0 -287
  365. package/dist/esm/src/middleware/XyPrissMiddlewareAPI.js.map +0 -1
  366. package/dist/esm/src/middleware/built-in/BuiltInMiddleware.js +0 -165
  367. package/dist/esm/src/middleware/built-in/BuiltInMiddleware.js.map +0 -1
  368. package/dist/esm/src/middleware/built-in/ConversionProxyMiddleware.js +0 -50
  369. package/dist/esm/src/middleware/built-in/ConversionProxyMiddleware.js.map +0 -1
  370. package/dist/esm/src/middleware/built-in/security/BrowserOnlyProtector.js +0 -550
  371. package/dist/esm/src/middleware/built-in/security/BrowserOnlyProtector.js.map +0 -1
  372. package/dist/esm/src/middleware/built-in/security/HoneypotTarpit.js +0 -559
  373. package/dist/esm/src/middleware/built-in/security/HoneypotTarpit.js.map +0 -1
  374. package/dist/esm/src/middleware/built-in/security/MaliciousUrlScanner.js +0 -135
  375. package/dist/esm/src/middleware/built-in/security/MaliciousUrlScanner.js.map +0 -1
  376. package/dist/esm/src/middleware/built-in/security/MobileOnlyProtector.js +0 -502
  377. package/dist/esm/src/middleware/built-in/security/MobileOnlyProtector.js.map +0 -1
  378. package/dist/esm/src/middleware/built-in/security/RequestSignatureProtector.js +0 -466
  379. package/dist/esm/src/middleware/built-in/security/RequestSignatureProtector.js.map +0 -1
  380. package/dist/esm/src/middleware/built-in/security/TerminalOnlyProtector.js +0 -476
  381. package/dist/esm/src/middleware/built-in/security/TerminalOnlyProtector.js.map +0 -1
  382. package/dist/esm/src/middleware/built-in/security/UriNormalizer.js +0 -391
  383. package/dist/esm/src/middleware/built-in/security/UriNormalizer.js.map +0 -1
  384. package/dist/esm/src/middleware/built-in/security/XyPrissHPP.js +0 -50
  385. package/dist/esm/src/middleware/built-in/security/XyPrissHPP.js.map +0 -1
  386. package/dist/esm/src/middleware/safe-json-middleware.js +0 -71
  387. package/dist/esm/src/middleware/safe-json-middleware.js.map +0 -1
  388. package/dist/esm/src/middleware/security-middleware.js +0 -546
  389. package/dist/esm/src/middleware/security-middleware.js.map +0 -1
  390. package/dist/esm/src/plugins/ServerPluginManager.js +0 -151
  391. package/dist/esm/src/plugins/ServerPluginManager.js.map +0 -1
  392. package/dist/esm/src/plugins/api/PluginAPI.js +0 -304
  393. package/dist/esm/src/plugins/api/PluginAPI.js.map +0 -1
  394. package/dist/esm/src/plugins/builtin/RouteOptimizationPlugin.js +0 -419
  395. package/dist/esm/src/plugins/builtin/RouteOptimizationPlugin.js.map +0 -1
  396. package/dist/esm/src/plugins/builtin/server-maintenance/ServerMaintenancePlugin.js +0 -576
  397. package/dist/esm/src/plugins/builtin/server-maintenance/ServerMaintenancePlugin.js.map +0 -1
  398. package/dist/esm/src/plugins/builtin/xems/XemsBuiltinPlugin.js +0 -330
  399. package/dist/esm/src/plugins/builtin/xems/XemsBuiltinPlugin.js.map +0 -1
  400. package/dist/esm/src/plugins/builtin/xems/XemsPlugin.js +0 -408
  401. package/dist/esm/src/plugins/builtin/xems/XemsPlugin.js.map +0 -1
  402. package/dist/esm/src/plugins/const/OFFICIAL_PLUGINS.js +0 -8
  403. package/dist/esm/src/plugins/const/OFFICIAL_PLUGINS.js.map +0 -1
  404. package/dist/esm/src/plugins/const/PluginHookIds.js +0 -187
  405. package/dist/esm/src/plugins/const/PluginHookIds.js.map +0 -1
  406. package/dist/esm/src/plugins/const/XyprissTempDir.js +0 -129
  407. package/dist/esm/src/plugins/const/XyprissTempDir.js.map +0 -1
  408. package/dist/esm/src/plugins/const/getSysApi.js +0 -15
  409. package/dist/esm/src/plugins/const/getSysApi.js.map +0 -1
  410. package/dist/esm/src/plugins/core/PermissionManager.js +0 -238
  411. package/dist/esm/src/plugins/core/PermissionManager.js.map +0 -1
  412. package/dist/esm/src/plugins/core/XPluginManager.js +0 -216
  413. package/dist/esm/src/plugins/core/XPluginManager.js.map +0 -1
  414. package/dist/esm/src/plugins/core/manager/PluginHookRunner.js +0 -106
  415. package/dist/esm/src/plugins/core/manager/PluginHookRunner.js.map +0 -1
  416. package/dist/esm/src/plugins/core/manager/PluginInterceptor.js +0 -198
  417. package/dist/esm/src/plugins/core/manager/PluginInterceptor.js.map +0 -1
  418. package/dist/esm/src/plugins/core/manager/PluginLoader.js +0 -206
  419. package/dist/esm/src/plugins/core/manager/PluginLoader.js.map +0 -1
  420. package/dist/esm/src/plugins/core/manager/PluginManagement.js +0 -133
  421. package/dist/esm/src/plugins/core/manager/PluginManagement.js.map +0 -1
  422. package/dist/esm/src/plugins/core/manager/PluginRegistry.js +0 -98
  423. package/dist/esm/src/plugins/core/manager/PluginRegistry.js.map +0 -1
  424. package/dist/esm/src/plugins/core/manager/PluginSecurity.js +0 -440
  425. package/dist/esm/src/plugins/core/manager/PluginSecurity.js.map +0 -1
  426. package/dist/esm/src/plugins/types/PluginTypes.js +0 -32
  427. package/dist/esm/src/plugins/types/PluginTypes.js.map +0 -1
  428. package/dist/esm/src/quick-start.js +0 -29
  429. package/dist/esm/src/quick-start.js.map +0 -1
  430. package/dist/esm/src/schemas/plugingSchema.js +0 -43
  431. package/dist/esm/src/schemas/plugingSchema.js.map +0 -1
  432. package/dist/esm/src/server/FastServer/ComponentManager.js +0 -92
  433. package/dist/esm/src/server/FastServer/ComponentManager.js.map +0 -1
  434. package/dist/esm/src/server/FastServer/LogTracingMethods.js +0 -33
  435. package/dist/esm/src/server/FastServer/LogTracingMethods.js.map +0 -1
  436. package/dist/esm/src/server/FastServer/MiddlewareManager.js +0 -71
  437. package/dist/esm/src/server/FastServer/MiddlewareManager.js.map +0 -1
  438. package/dist/esm/src/server/FastServer/ShutdownManager.js +0 -80
  439. package/dist/esm/src/server/FastServer/ShutdownManager.js.map +0 -1
  440. package/dist/esm/src/server/FastServer/UploadManager.js +0 -69
  441. package/dist/esm/src/server/FastServer/UploadManager.js.map +0 -1
  442. package/dist/esm/src/server/FastServer/index.js +0 -224
  443. package/dist/esm/src/server/FastServer/index.js.map +0 -1
  444. package/dist/esm/src/server/ServerFactory.js +0 -167
  445. package/dist/esm/src/server/ServerFactory.js.map +0 -1
  446. package/dist/esm/src/server/components/fastapi/CacheManager.js +0 -215
  447. package/dist/esm/src/server/components/fastapi/CacheManager.js.map +0 -1
  448. package/dist/esm/src/server/components/fastapi/RedirectManager.js +0 -435
  449. package/dist/esm/src/server/components/fastapi/RedirectManager.js.map +0 -1
  450. package/dist/esm/src/server/components/fastapi/RequestProcessor.js +0 -180
  451. package/dist/esm/src/server/components/fastapi/RequestProcessor.js.map +0 -1
  452. package/dist/esm/src/server/components/fastapi/RouteManager.js +0 -121
  453. package/dist/esm/src/server/components/fastapi/RouteManager.js.map +0 -1
  454. package/dist/esm/src/server/components/fastapi/WorkerPoolComponent.js +0 -83
  455. package/dist/esm/src/server/components/fastapi/WorkerPoolComponent.js.map +0 -1
  456. package/dist/esm/src/server/components/fastapi/console/ConsoleInterceptor.js +0 -357
  457. package/dist/esm/src/server/components/fastapi/console/ConsoleInterceptor.js.map +0 -1
  458. package/dist/esm/src/server/components/fastapi/console/types.js +0 -33
  459. package/dist/esm/src/server/components/fastapi/console/types.js.map +0 -1
  460. package/dist/esm/src/server/components/fastapi/templates/redirectTemp.js +0 -99
  461. package/dist/esm/src/server/components/fastapi/templates/redirectTemp.js.map +0 -1
  462. package/dist/esm/src/server/components/fastapi/upload/FileUploadManager.js +0 -340
  463. package/dist/esm/src/server/components/fastapi/upload/FileUploadManager.js.map +0 -1
  464. package/dist/esm/src/server/components/fastapi/upload/file-upload.js +0 -299
  465. package/dist/esm/src/server/components/fastapi/upload/file-upload.js.map +0 -1
  466. package/dist/esm/src/server/components/multi-server/MultiServerApp.js +0 -715
  467. package/dist/esm/src/server/components/multi-server/MultiServerApp.js.map +0 -1
  468. package/dist/esm/src/server/components/multi-server/MultiServerManager.js +0 -499
  469. package/dist/esm/src/server/components/multi-server/MultiServerManager.js.map +0 -1
  470. package/dist/esm/src/server/components/multi-server/XMSStartupUI.js +0 -318
  471. package/dist/esm/src/server/components/multi-server/XMSStartupUI.js.map +0 -1
  472. package/dist/esm/src/server/components/response-control/ResponseControlManager.js +0 -62
  473. package/dist/esm/src/server/components/response-control/ResponseControlManager.js.map +0 -1
  474. package/dist/esm/src/server/components/static/IXStaticSchem.js +0 -28
  475. package/dist/esm/src/server/components/static/IXStaticSchem.js.map +0 -1
  476. package/dist/esm/src/server/components/static/MetaCache.js +0 -41
  477. package/dist/esm/src/server/components/static/MetaCache.js.map +0 -1
  478. package/dist/esm/src/server/components/static/XStatic.js +0 -400
  479. package/dist/esm/src/server/components/static/XStatic.js.map +0 -1
  480. package/dist/esm/src/server/const/Defaulthelmetopts.js +0 -124
  481. package/dist/esm/src/server/const/Defaulthelmetopts.js.map +0 -1
  482. package/dist/esm/src/server/const/MIME_MAP.js +0 -421
  483. package/dist/esm/src/server/const/MIME_MAP.js.map +0 -1
  484. package/dist/esm/src/server/const/XHSC_SIGNATURE.js +0 -74
  485. package/dist/esm/src/server/const/XHSC_SIGNATURE.js.map +0 -1
  486. package/dist/esm/src/server/const/XRUNTIME-HEADER.js +0 -4
  487. package/dist/esm/src/server/const/XRUNTIME-HEADER.js.map +0 -1
  488. package/dist/esm/src/server/const/default.js +0 -364
  489. package/dist/esm/src/server/const/default.js.map +0 -1
  490. package/dist/esm/src/server/const/http.js +0 -17
  491. package/dist/esm/src/server/const/http.js.map +0 -1
  492. package/dist/esm/src/server/const/internalFlags.js +0 -13
  493. package/dist/esm/src/server/const/internalFlags.js.map +0 -1
  494. package/dist/esm/src/server/const/reStrategy.js +0 -4
  495. package/dist/esm/src/server/const/reStrategy.js.map +0 -1
  496. package/dist/esm/src/server/const/xemsKeyPlaceholder.js +0 -4
  497. package/dist/esm/src/server/const/xemsKeyPlaceholder.js.map +0 -1
  498. package/dist/esm/src/server/core/HttpServer.js +0 -294
  499. package/dist/esm/src/server/core/HttpServer.js.map +0 -1
  500. package/dist/esm/src/server/core/RequestApp.js +0 -93
  501. package/dist/esm/src/server/core/RequestApp.js.map +0 -1
  502. package/dist/esm/src/server/core/RequestEnhancer.js +0 -349
  503. package/dist/esm/src/server/core/RequestEnhancer.js.map +0 -1
  504. package/dist/esm/src/server/core/ResponseEnhancer.js +0 -592
  505. package/dist/esm/src/server/core/ResponseEnhancer.js.map +0 -1
  506. package/dist/esm/src/server/core/SendFileHandler.js +0 -117
  507. package/dist/esm/src/server/core/SendFileHandler.js.map +0 -1
  508. package/dist/esm/src/server/core/StartupProcessor.js +0 -111
  509. package/dist/esm/src/server/core/StartupProcessor.js.map +0 -1
  510. package/dist/esm/src/server/core/VirtualServer.js +0 -31
  511. package/dist/esm/src/server/core/VirtualServer.js.map +0 -1
  512. package/dist/esm/src/server/core/XHSCBridge/EngineManager.js +0 -201
  513. package/dist/esm/src/server/core/XHSCBridge/EngineManager.js.map +0 -1
  514. package/dist/esm/src/server/core/XHSCBridge/LogProcessor.js +0 -157
  515. package/dist/esm/src/server/core/XHSCBridge/LogProcessor.js.map +0 -1
  516. package/dist/esm/src/server/core/XHSCBridge/SocketManager.js +0 -96
  517. package/dist/esm/src/server/core/XHSCBridge/SocketManager.js.map +0 -1
  518. package/dist/esm/src/server/core/XHSCBridge/index.js +0 -113
  519. package/dist/esm/src/server/core/XHSCBridge/index.js.map +0 -1
  520. package/dist/esm/src/server/core/XHSCProtocol.js +0 -419
  521. package/dist/esm/src/server/core/XHSCProtocol.js.map +0 -1
  522. package/dist/esm/src/server/core/XHSCRequest.js +0 -500
  523. package/dist/esm/src/server/core/XHSCRequest.js.map +0 -1
  524. package/dist/esm/src/server/core/XNullSocket.js +0 -116
  525. package/dist/esm/src/server/core/XNullSocket.js.map +0 -1
  526. package/dist/esm/src/server/core/XyDiagnosticsManager.js +0 -76
  527. package/dist/esm/src/server/core/XyDiagnosticsManager.js.map +0 -1
  528. package/dist/esm/src/server/core/XyLifecycleManager.js +0 -253
  529. package/dist/esm/src/server/core/XyLifecycleManager.js.map +0 -1
  530. package/dist/esm/src/server/core/XyModuleManager.js +0 -127
  531. package/dist/esm/src/server/core/XyModuleManager.js.map +0 -1
  532. package/dist/esm/src/server/core/XyRoutingManager.js +0 -202
  533. package/dist/esm/src/server/core/XyRoutingManager.js.map +0 -1
  534. package/dist/esm/src/server/core/XyServerCreator.js +0 -144
  535. package/dist/esm/src/server/core/XyServerCreator.js.map +0 -1
  536. package/dist/esm/src/server/core/XyprissApp.js +0 -577
  537. package/dist/esm/src/server/core/XyprissApp.js.map +0 -1
  538. package/dist/esm/src/server/core/http/BodyParser.js +0 -73
  539. package/dist/esm/src/server/core/http/BodyParser.js.map +0 -1
  540. package/dist/esm/src/server/core/http/HttpErrorHandler.js +0 -51
  541. package/dist/esm/src/server/core/http/HttpErrorHandler.js.map +0 -1
  542. package/dist/esm/src/server/core/http/RequestForwarder.js +0 -43
  543. package/dist/esm/src/server/core/http/RequestForwarder.js.map +0 -1
  544. package/dist/esm/src/server/core/http/RouteManager.js +0 -154
  545. package/dist/esm/src/server/core/http/RouteManager.js.map +0 -1
  546. package/dist/esm/src/server/core/request/XyRequestManager.js +0 -229
  547. package/dist/esm/src/server/core/request/XyRequestManager.js.map +0 -1
  548. package/dist/esm/src/server/handlers/NotFoundHandler.js +0 -82
  549. package/dist/esm/src/server/handlers/NotFoundHandler.js.map +0 -1
  550. package/dist/esm/src/server/handlers/templates/notFoundTemplate.js +0 -398
  551. package/dist/esm/src/server/handlers/templates/notFoundTemplate.js.map +0 -1
  552. package/dist/esm/src/server/middleware/MiddlewareManager.js +0 -219
  553. package/dist/esm/src/server/middleware/MiddlewareManager.js.map +0 -1
  554. package/dist/esm/src/server/routing/Router.js +0 -186
  555. package/dist/esm/src/server/routing/Router.js.map +0 -1
  556. package/dist/esm/src/server/routing/modules/XyGuard.js +0 -35
  557. package/dist/esm/src/server/routing/modules/XyGuard.js.map +0 -1
  558. package/dist/esm/src/server/routing/modules/constants.js +0 -15
  559. package/dist/esm/src/server/routing/modules/constants.js.map +0 -1
  560. package/dist/esm/src/server/routing/modules/groups.js +0 -77
  561. package/dist/esm/src/server/routing/modules/groups.js.map +0 -1
  562. package/dist/esm/src/server/routing/modules/helpers.js +0 -163
  563. package/dist/esm/src/server/routing/modules/helpers.js.map +0 -1
  564. package/dist/esm/src/server/routing/modules/middleware.js +0 -168
  565. package/dist/esm/src/server/routing/modules/middleware.js.map +0 -1
  566. package/dist/esm/src/server/routing/modules/path.js +0 -128
  567. package/dist/esm/src/server/routing/modules/path.js.map +0 -1
  568. package/dist/esm/src/server/routing/modules/registry.js +0 -161
  569. package/dist/esm/src/server/routing/modules/registry.js.map +0 -1
  570. package/dist/esm/src/server/utils/ConfigLoader.js +0 -202
  571. package/dist/esm/src/server/utils/ConfigLoader.js.map +0 -1
  572. package/dist/esm/src/server/utils/MetaConfigRunner.js +0 -87
  573. package/dist/esm/src/server/utils/MetaConfigRunner.js.map +0 -1
  574. package/dist/esm/src/server/utils/PortManager.js +0 -197
  575. package/dist/esm/src/server/utils/PortManager.js.map +0 -1
  576. package/dist/esm/src/server/utils/WorkerModeHandler.js +0 -80
  577. package/dist/esm/src/server/utils/WorkerModeHandler.js.map +0 -1
  578. package/dist/esm/src/server/utils/internalFlagsFunctions.js +0 -153
  579. package/dist/esm/src/server/utils/internalFlagsFunctions.js.map +0 -1
  580. package/dist/esm/src/server/utils/reconcilePortConflictResolution.js +0 -77
  581. package/dist/esm/src/server/utils/reconcilePortConflictResolution.js.map +0 -1
  582. package/dist/esm/src/shared/logger/DEFAULT_LOGGER_CONFIG.js +0 -66
  583. package/dist/esm/src/shared/logger/DEFAULT_LOGGER_CONFIG.js.map +0 -1
  584. package/dist/esm/src/shared/logger/DEFAULT_PALETTE.js +0 -18
  585. package/dist/esm/src/shared/logger/DEFAULT_PALETTE.js.map +0 -1
  586. package/dist/esm/src/shared/logger/Logger.js +0 -630
  587. package/dist/esm/src/shared/logger/Logger.js.map +0 -1
  588. package/dist/esm/src/shared/logger/quickLogger.js +0 -222
  589. package/dist/esm/src/shared/logger/quickLogger.js.map +0 -1
  590. package/dist/esm/src/types/NotFoundConfig.js +0 -85
  591. package/dist/esm/src/types/NotFoundConfig.js.map +0 -1
  592. package/dist/esm/src/utils/ConfigSyntaxParser.js +0 -241
  593. package/dist/esm/src/utils/ConfigSyntaxParser.js.map +0 -1
  594. package/dist/esm/src/utils/CorePathCheck.js +0 -36
  595. package/dist/esm/src/utils/CorePathCheck.js.map +0 -1
  596. package/dist/esm/src/utils/JsonUtils.js +0 -31
  597. package/dist/esm/src/utils/JsonUtils.js.map +0 -1
  598. package/dist/esm/src/utils/ProjectDiscovery.js +0 -172
  599. package/dist/esm/src/utils/ProjectDiscovery.js.map +0 -1
  600. package/dist/esm/src/utils/SecurityShield.js +0 -94
  601. package/dist/esm/src/utils/SecurityShield.js.map +0 -1
  602. package/dist/esm/src/utils/Send.js +0 -651
  603. package/dist/esm/src/utils/Send.js.map +0 -1
  604. package/dist/esm/src/utils/getIp.js +0 -162
  605. package/dist/esm/src/utils/getIp.js.map +0 -1
  606. package/dist/esm/src/utils/getMime.js +0 -93
  607. package/dist/esm/src/utils/getMime.js.map +0 -1
  608. package/dist/esm/src/utils/mergeWithDefaults.js +0 -174
  609. package/dist/esm/src/utils/mergeWithDefaults.js.map +0 -1
  610. package/dist/esm/src/utils/mimeUtils.js +0 -16
  611. package/dist/esm/src/utils/mimeUtils.js.map +0 -1
  612. package/dist/esm/src/utils/xtrsParser.js +0 -193
  613. package/dist/esm/src/utils/xtrsParser.js.map +0 -1
  614. package/dist/esm/src/xhsc/EnvApi.js +0 -714
  615. package/dist/esm/src/xhsc/EnvApi.js.map +0 -1
  616. package/dist/esm/src/xhsc/FSApi.js +0 -52
  617. package/dist/esm/src/xhsc/FSApi.js.map +0 -1
  618. package/dist/esm/src/xhsc/OSApi.js +0 -223
  619. package/dist/esm/src/xhsc/OSApi.js.map +0 -1
  620. package/dist/esm/src/xhsc/PathApi.js +0 -386
  621. package/dist/esm/src/xhsc/PathApi.js.map +0 -1
  622. package/dist/esm/src/xhsc/System.js +0 -61
  623. package/dist/esm/src/xhsc/System.js.map +0 -1
  624. package/dist/esm/src/xhsc/UtilsApi.js +0 -248
  625. package/dist/esm/src/xhsc/UtilsApi.js.map +0 -1
  626. package/dist/esm/src/xhsc/VarsApi.js +0 -178
  627. package/dist/esm/src/xhsc/VarsApi.js.map +0 -1
  628. package/dist/esm/src/xhsc/XyPrissRunner.js +0 -177
  629. package/dist/esm/src/xhsc/XyPrissRunner.js.map +0 -1
  630. package/dist/esm/src/xhsc/api/env/XessIpcClient.js +0 -577
  631. package/dist/esm/src/xhsc/api/env/XessIpcClient.js.map +0 -1
  632. package/dist/esm/src/xhsc/api/env/env.js +0 -155
  633. package/dist/esm/src/xhsc/api/env/env.js.map +0 -1
  634. package/dist/esm/src/xhsc/cluster/XHSCWorker.js +0 -338
  635. package/dist/esm/src/xhsc/cluster/XHSCWorker.js.map +0 -1
  636. package/dist/esm/src/xhsc/cluster/xbp.js +0 -349
  637. package/dist/esm/src/xhsc/cluster/xbp.js.map +0 -1
  638. package/dist/esm/src/xhsc/fs/FSArchive.js +0 -69
  639. package/dist/esm/src/xhsc/fs/FSArchive.js.map +0 -1
  640. package/dist/esm/src/xhsc/fs/FSBase.js +0 -18
  641. package/dist/esm/src/xhsc/fs/FSBase.js.map +0 -1
  642. package/dist/esm/src/xhsc/fs/FSCore.js +0 -667
  643. package/dist/esm/src/xhsc/fs/FSCore.js.map +0 -1
  644. package/dist/esm/src/xhsc/fs/FSExtended.js +0 -306
  645. package/dist/esm/src/xhsc/fs/FSExtended.js.map +0 -1
  646. package/dist/esm/src/xhsc/fs/FSHelpers.js +0 -520
  647. package/dist/esm/src/xhsc/fs/FSHelpers.js.map +0 -1
  648. package/dist/esm/src/xhsc/fs/FSSearch.js +0 -98
  649. package/dist/esm/src/xhsc/fs/FSSearch.js.map +0 -1
  650. package/dist/esm/src/xhsc/fs/FSWatch.js +0 -139
  651. package/dist/esm/src/xhsc/fs/FSWatch.js.map +0 -1
  652. package/dist/esm/src/xhsc/fs/FileHandle.js +0 -140
  653. package/dist/esm/src/xhsc/fs/FileHandle.js.map +0 -1
  654. package/dist/esm/src/xhsc/fs/TempFileManager.js +0 -163
  655. package/dist/esm/src/xhsc/fs/TempFileManager.js.map +0 -1
  656. package/dist/esm/src/xhsc/ipc/XHSCDirectIPC.js +0 -113
  657. package/dist/esm/src/xhsc/ipc/XHSCDirectIPC.js.map +0 -1
  658. package/dist/esm/src/xhsc/synapx/SynapxClient.js +0 -513
  659. package/dist/esm/src/xhsc/synapx/SynapxClient.js.map +0 -1
  660. package/dist/esm/src/xhsc/synapx/SynapxSchemaPacker.js +0 -37
  661. package/dist/esm/src/xhsc/synapx/SynapxSchemaPacker.js.map +0 -1
  662. package/dist/esm/src/xhsc/synapx/SynapxSyncBridge.js +0 -312
  663. package/dist/esm/src/xhsc/synapx/SynapxSyncBridge.js.map +0 -1
  664. package/dist/esm/src/xhsc/utils/ArrayUtils.js +0 -65
  665. package/dist/esm/src/xhsc/utils/ArrayUtils.js.map +0 -1
  666. package/dist/esm/src/xhsc/utils/AsyncUtils.js +0 -580
  667. package/dist/esm/src/xhsc/utils/AsyncUtils.js.map +0 -1
  668. package/dist/esm/src/xhsc/utils/DateUtils.js +0 -1133
  669. package/dist/esm/src/xhsc/utils/DateUtils.js.map +0 -1
  670. package/dist/esm/src/xhsc/utils/Discovery.js +0 -118
  671. package/dist/esm/src/xhsc/utils/Discovery.js.map +0 -1
  672. package/dist/esm/src/xhsc/utils/FunctionUtils.js +0 -27
  673. package/dist/esm/src/xhsc/utils/FunctionUtils.js.map +0 -1
  674. package/dist/esm/src/xhsc/utils/IdUtils.js +0 -20
  675. package/dist/esm/src/xhsc/utils/IdUtils.js.map +0 -1
  676. package/dist/esm/src/xhsc/utils/LoggerUtils.js +0 -543
  677. package/dist/esm/src/xhsc/utils/LoggerUtils.js.map +0 -1
  678. package/dist/esm/src/xhsc/utils/NumberUtils.js +0 -1180
  679. package/dist/esm/src/xhsc/utils/NumberUtils.js.map +0 -1
  680. package/dist/esm/src/xhsc/utils/ObjectUtils.js +0 -726
  681. package/dist/esm/src/xhsc/utils/ObjectUtils.js.map +0 -1
  682. package/dist/esm/src/xhsc/utils/ObjectWrapper.js +0 -670
  683. package/dist/esm/src/xhsc/utils/ObjectWrapper.js.map +0 -1
  684. package/dist/esm/src/xhsc/utils/Platform.js +0 -49
  685. package/dist/esm/src/xhsc/utils/Platform.js.map +0 -1
  686. package/dist/esm/src/xhsc/utils/StringUtils.js +0 -763
  687. package/dist/esm/src/xhsc/utils/StringUtils.js.map +0 -1
  688. package/dist/esm/src/xhsc/utils/StringWrapper.js +0 -300
  689. package/dist/esm/src/xhsc/utils/StringWrapper.js.map +0 -1
  690. package/dist/esm/src/xhsc/utils/ValidationUtils.js +0 -47
  691. package/dist/esm/src/xhsc/utils/ValidationUtils.js.map +0 -1
  692. package/dist/esm/src/xhsc.js +0 -282
  693. package/dist/esm/src/xhsc.js.map +0 -1
@@ -1,714 +0,0 @@
1
- import { XY_ENV_INTERNAL_GET_FOR_ROOT, EnvAccessError, XY_ENV_CONFIGURE_SHIELD, getInternalProjectEnvs, EnvStoreError, EnvKeyError, FORBIDDEN_VALUE_PATTERN } from './api/env/env.js';
2
- import { getCallerProjectRoot } from '../utils/ProjectDiscovery.js';
3
- import { logger } from '../shared/logger/Logger.js';
4
- import { XessIpcClient } from './api/env/XessIpcClient.js';
5
- import { isCoreFrameworkPath } from '../utils/CorePathCheck.js';
6
-
7
- class EnvApi {
8
- /**
9
- * @param runner - The XyPrissRunner used to invoke native Go binaries.
10
- * @param mode - The execution mode. Defaults to `"development"`.
11
- * @param isDynamic - Whether this EnvApi should use dynamic project discovery (Sandboxing).
12
- */
13
- constructor(runner, mode = "development", isDynamic = false) {
14
- /**
15
- * Keys that may pass through the Shield to the real `process.env` without
16
- * restriction. Stored as a `Set` for O(1) lookup inside the Proxy trap.
17
- *
18
- * This list covers OS and Node.js internals required for system stability.
19
- * Application secrets must never be added here.
20
- */
21
- this.defaultWhitelist = new Set([
22
- "PORT",
23
- "TERM",
24
- "PATH",
25
- "PWD",
26
- "HOME",
27
- "USER",
28
- "LANG",
29
- "COLORTERM",
30
- "FORCE_COLOR",
31
- "TERM_PROGRAM",
32
- "EDITOR",
33
- "SHELL",
34
- "SHLVL",
35
- "NO_DEPRECATION",
36
- "DEBUG_FD",
37
- "DEBUG",
38
- "NODE_DEBUG",
39
- "NODE_OPTIONS",
40
- "NODE_ENV",
41
- "ENC_SECRET_KEY",
42
- "ENC_SECRET_SEED",
43
- "ENC_SECRET_SALT",
44
- "TRACE_DEPRECATION",
45
- "APPEND_DEPRECATION",
46
- "READABLE_STREAM",
47
- "BUN_CONFIG_VERBOSE_FETCH",
48
- "XYPRISS_ENV_SHIELD",
49
- "XYPRISS_SESSION_HASH",
50
- "XYPRISS_USER_TMP",
51
- "XYPRISS_XESS_AUTH_TOKEN",
52
- "LIBXESS_ACTIVE",
53
- "XESS_SESSION_TMP",
54
- "XESS_TEMP_DIR",
55
- "LIBPORT_SOCKET_PATH",
56
- "PORT_SOCKET_PATH",
57
- "XPM_SOCKET_PATH",
58
- "BUN_DISABLE_DYNAMIC_CHUNK_SIZE",
59
- // Node / Bun core HTTPS variables (Issue #43: prevent false-positive security blocking during outgoing TLS/HTTPS requests)
60
- "NODE_TLS_REJECT_UNAUTHORIZED",
61
- "NODE_EXTRA_CA_CERTS",
62
- // Standard OS environment paths (Windows / Cross-platform stability)
63
- "APPDATA",
64
- "LOCALAPPDATA",
65
- "USERPROFILE",
66
- "ProgramFiles",
67
- "ProgramFiles(x86)",
68
- "SYSTEMROOT",
69
- "TEMP",
70
- "TMP",
71
- ]);
72
- this.whitelistedFields = new Set(this.defaultWhitelist);
73
- this.runner = runner;
74
- this.mode = mode;
75
- this.isDynamic = isDynamic;
76
- this.applyShield();
77
- }
78
- // -------------------------------------------------------------------------
79
- // Write
80
- // -------------------------------------------------------------------------
81
- /**
82
- * Writes a variable to the secure internal store.
83
- *
84
- * The key must be non-empty and must not consist solely of whitespace.
85
- * The value must not contain CR (`\r`), LF (`\n`), or NUL (`\0`) — these
86
- * characters can corrupt downstream parsers and log sinks.
87
- *
88
- * @param key - Variable name.
89
- * @param value - Value to store.
90
- * @throws {EnvKeyError} When the key or value fails validation.
91
- * @throws {EnvStoreError} When the store has not been initialised.
92
- *
93
- * @example
94
- * __sys__.__env__.set("MAINTENANCE_MODE", "true");
95
- *
96
- * const resolvedBase = resolveBaseUrl(config);
97
- * __sys__.__env__.set("APP_BASE_URL", resolvedBase);
98
- */
99
- set(key, value) {
100
- this.validateKey(key);
101
- this.validateValue(key, value);
102
- const store = this.getStoreForCaller();
103
- store[key] = value;
104
- // Keep process.env in sync for whitelisted keys and framework keys to maintain system stability.
105
- // Issue #43: Ensures internal components and child processes have immediate access to
106
- // framework configuration without triggering proxy descriptor violations under strict runtimes (Bun).
107
- if (this.whitelistedFields.has(key) ||
108
- key.startsWith("XY_") ||
109
- key.startsWith("XYPRISS_") ||
110
- key.startsWith("XEMS_") ||
111
- key.startsWith("ENC_") ||
112
- key.startsWith("DOTENV_") ||
113
- key.startsWith("__")) {
114
- try {
115
- process.env[key] = value;
116
- }
117
- catch {
118
- // Shield is locked
119
- }
120
- }
121
- }
122
- /**
123
- * Removes a variable from the secure internal store and from `process.env`.
124
- * Deleting a key that does not exist is a no-op; no error is thrown.
125
- *
126
- * @param key - Variable name to remove.
127
- * @throws {EnvStoreError} When the store has not been initialised.
128
- *
129
- * @example
130
- * // Revoke a short-lived deployment credential immediately after use
131
- * __sys__.__env__.delete("CI_DEPLOY_TOKEN");
132
- */
133
- delete(key) {
134
- const store = this.getStoreForCaller();
135
- delete store[key];
136
- if (this.whitelistedFields.has(key) ||
137
- key.startsWith("XY_") ||
138
- key.startsWith("XYPRISS_") ||
139
- key.startsWith("XEMS_") ||
140
- key.startsWith("ENC_") ||
141
- key.startsWith("DOTENV_") ||
142
- key.startsWith("__")) {
143
- try {
144
- delete process.env[key];
145
- }
146
- catch {
147
- // Shield may block deletion
148
- }
149
- }
150
- }
151
- get(key, defaultValue) {
152
- if (key === "__root__") {
153
- return (this.isDynamic ? getCallerProjectRoot() : null) || this.runner.getRoot();
154
- }
155
- const store = this.getStoreForCaller();
156
- const value = store[key];
157
- return value !== undefined ? value : defaultValue;
158
- }
159
- /**
160
- * Reads a variable from the secure internal store for a specific root.
161
- *
162
- * **Security Note:**
163
- * Formerly exposed as `getForRoot(key, root)`. It was removed from the public API
164
- * because it functioned as a zero-trust bypass: plugins could manually pass the host project
165
- * root and read host secrets. It is now private to the engine and keyed by an internal Symbol.
166
- *
167
- * @internal
168
- * @param key - Variable name to look up.
169
- * @param root - Absolute project root path.
170
- * @returns The resolved variable value or undefined.
171
- */
172
- [XY_ENV_INTERNAL_GET_FOR_ROOT](key, root) {
173
- if (key === "__root__") {
174
- return root;
175
- }
176
- const store = this.getStoreForCaller(root);
177
- return store[key];
178
- }
179
- /**
180
- * Reads a required variable from the secure internal store and throws if
181
- * it cannot be resolved.
182
- *
183
- * Use this method for every variable that is mandatory for application
184
- * correctness. It surfaces configuration errors at startup rather than
185
- * silently producing `undefined` at the point of use.
186
- *
187
- * @param key - Variable name to look up.
188
- * @param options - Optional validation settings.
189
- * @returns The stored value, guaranteed non-undefined.
190
- * @throws {EnvAccessError} When the variable is missing or empty.
191
- * @throws {EnvStoreError} When the store has not been initialised.
192
- *
193
- * @example
194
- * // Fail fast at boot if a critical variable is absent
195
- * const databaseUrl = __sys__.__env__.getStrict("DATABASE_URL");
196
- * const jwtSecret = __sys__.__env__.getStrict("JWT_SECRET", { rejectEmpty: true });
197
- * const smtpHost = __sys__.__env__.getStrict("SMTP_HOST");
198
- *
199
- * // Collect all required variables once at module initialisation
200
- * const config = {
201
- * db: __sys__.__env__.getStrict("DATABASE_URL"),
202
- * jwt: __sys__.__env__.getStrict("JWT_SECRET", { rejectEmpty: true }),
203
- * smtp: __sys__.__env__.getStrict("SMTP_HOST"),
204
- * };
205
- */
206
- getStrict(key, options) {
207
- if (key === "__root__") {
208
- const rootVal = (this.isDynamic ? getCallerProjectRoot() : null) || this.runner.getRoot();
209
- if (!rootVal) {
210
- throw new EnvAccessError(key, "missing");
211
- }
212
- return rootVal;
213
- }
214
- const store = this.getStoreForCaller();
215
- const value = store[key];
216
- if (value === undefined) {
217
- throw new EnvAccessError(key, "missing");
218
- }
219
- if (options?.rejectEmpty && value === "") {
220
- throw new EnvAccessError(key, "empty");
221
- }
222
- return value;
223
- }
224
- /**
225
- * Returns `true` when the given key is present in the secure internal
226
- * store, regardless of its value (including empty strings).
227
- *
228
- * @param key - Variable name to test.
229
- * @throws {EnvStoreError} When the store has not been initialised.
230
- *
231
- * @example
232
- * if (__sys__.__env__.has("SENTRY_DSN")) {
233
- * Sentry.init({ dsn: __sys__.__env__.get("SENTRY_DSN") });
234
- * }
235
- *
236
- * const betaEnabled = __sys__.__env__.has("ENABLE_BETA_UI");
237
- */
238
- has(key) {
239
- const store = this.getStoreForCaller();
240
- return store[key] !== undefined;
241
- }
242
- /**
243
- * Returns a frozen, point-in-time snapshot of stored variables.
244
- *
245
- * The object is frozen at the moment of the call; subsequent `set` or
246
- * `delete` calls do not affect it.
247
- *
248
- * Providing `options.keys` is strongly recommended in production code.
249
- * Returning the full store risks inadvertently capturing secrets in log
250
- * statements or JSON serialisations.
251
- *
252
- * @param options - Optional filter configuration.
253
- * @returns A frozen {@link EnvSnapshot}.
254
- * @throws {EnvStoreError} When the store has not been initialised.
255
- *
256
- * @example
257
- * // Filtered snapshot — preferred in all production code paths
258
- * const dbConfig = __sys__.__env__.all({
259
- * keys: ["DATABASE_URL", "DATABASE_POOL_SIZE", "DATABASE_TIMEOUT_MS"],
260
- * });
261
- *
262
- * // Full snapshot — use only for diagnostics / startup validation
263
- * const full = __sys__.__env__.all();
264
- * logger.debug("Env snapshot", { count: Object.keys(full).length });
265
- */
266
- all(options) {
267
- const store = this.getStoreForCaller();
268
- if (options?.keys && options.keys.length > 0) {
269
- const subset = {};
270
- for (const key of options.keys) {
271
- subset[key] = store[key];
272
- }
273
- return Object.freeze(subset);
274
- }
275
- return Object.freeze({ ...store });
276
- }
277
- // -------------------------------------------------------------------------
278
- // Mode helpers
279
- // -------------------------------------------------------------------------
280
- /**
281
- * Returns `true` when the execution mode is `"production"`.
282
- *
283
- * @example
284
- * const logger = createLogger({
285
- * level: __sys__.__env__.isProduction() ? "error" : "debug",
286
- * });
287
- */
288
- isProduction() {
289
- return this.mode === "production";
290
- }
291
- /**
292
- * Returns `true` when the execution mode is `"development"`.
293
- *
294
- * @example
295
- * if (__sys__.__env__.isDevelopment()) {
296
- * app.use(requestLogger({ colorize: true }));
297
- * }
298
- */
299
- isDevelopment() {
300
- return this.mode === "development";
301
- }
302
- /**
303
- * Returns `true` when the execution mode is `"staging"`.
304
- *
305
- * @example
306
- * if (__sys__.__env__.isStaging()) {
307
- * payment.useSandbox();
308
- * }
309
- */
310
- isStaging() {
311
- return this.mode === "staging";
312
- }
313
- /**
314
- * Returns `true` when the execution mode is `"test"`.
315
- *
316
- * @example
317
- * const dbUrl = __sys__.__env__.isTest()
318
- * ? __sys__.__env__.getStrict("TEST_DATABASE_URL")
319
- * : __sys__.__env__.getStrict("DATABASE_URL");
320
- */
321
- isTest() {
322
- return this.mode === "test";
323
- }
324
- /**
325
- * Returns `true` when the execution mode exactly matches `envName`
326
- * (case-sensitive).
327
- *
328
- * @param envName - Mode name to compare against.
329
- *
330
- * @example
331
- * if (__sys__.__env__.is("canary")) {
332
- * featureFlags.enableAll();
333
- * }
334
- */
335
- is(envName) {
336
- return this.mode === envName;
337
- }
338
- /**
339
- * Configures the XESS (XyPriss Environment Security Shield) dynamically.
340
- *
341
- * **Security Enforcement:**
342
- * Only the host application and internal engine are authorized to invoke this method.
343
- * Invocations from third-party plugins in `node_modules` or foreign project roots
344
- * are strictly blocked to prevent malicious tampering with the `process.env` whitelist.
345
- *
346
- * @deprecated Consider declaring `$env: { whitelist: [...] }` in `xypriss.config.jsonc` instead.
347
- */
348
- configureShield(config) {
349
- const callerRoot = getCallerProjectRoot();
350
- const hostRoot = this.runner.getRoot();
351
- if (callerRoot && callerRoot !== hostRoot && !isCoreFrameworkPath(callerRoot)) {
352
- logger.warn("security", `Blocked unauthorized attempt by third-party plugin at '${callerRoot}' to configure Environment Security Shield.`);
353
- return;
354
- }
355
- this[XY_ENV_CONFIGURE_SHIELD](config);
356
- }
357
- /**
358
- * Configures the XESS (XyPriss Environment Security Shield) dynamically.
359
- *
360
- * **Security Note:**
361
- * Formerly exposed as `public configureShield(...)`. It was removed from the public API
362
- * because any untrusted caller could modify the whitelist of allowed `process.env` properties,
363
- * effectively destroying the Environment Security Shield. It is now private to the engine
364
- * and only accessible via this internal Symbol during early bootstrap.
365
- *
366
- * @internal
367
- * @param config - XESS configuration options.
368
- */
369
- [XY_ENV_CONFIGURE_SHIELD](config) {
370
- if (!config)
371
- return;
372
- if (config.whitelist !== undefined) {
373
- if (config.replaceDefaultWhitelist) {
374
- this.whitelistedFields = new Set(config.whitelist);
375
- }
376
- else {
377
- this.whitelistedFields = new Set([
378
- ...this.defaultWhitelist,
379
- ...config.whitelist,
380
- ]);
381
- }
382
- }
383
- }
384
- // -------------------------------------------------------------------------
385
- // Native / system
386
- // -------------------------------------------------------------------------
387
- /**
388
- * Retrieves the OS-level username of the current process owner by invoking
389
- * the XHSC native Go binary.
390
- *
391
- * This method is synchronous and blocks until the native call completes.
392
- * Do not call it in request hot paths. Returns `""` on failure so callers
393
- * can safely use the result without null checks.
394
- *
395
- * @returns The current OS username, or `""` on failure.
396
- *
397
- * @example
398
- * const actor = __sys__.__env__.user() || "<unknown>";
399
- * auditLog.write({ actor, action: "deploy" });
400
- */
401
- user() {
402
- try {
403
- const result = this.runner.runSync("sys", "user");
404
- return result?.username ?? "";
405
- }
406
- catch {
407
- return "";
408
- }
409
- }
410
- // -------------------------------------------------------------------------
411
- // Private — store access
412
- // -------------------------------------------------------------------------
413
- /**
414
- * Returns the internal store, throwing {@link EnvStoreError} if it has not
415
- * yet been initialised.
416
- *
417
- * SECURITY: This is the single point of store access. Every read and write
418
- * method must go through here — never access `globalThis[XY_ENV_STORE_KEY]`
419
- * directly outside this method.
420
- *
421
- * Eliminating the `?? process.env` fallback is intentional. A silent
422
- * fallback to `process.env` during the bootstrap race window would bypass
423
- * the Shield and leak values without any warning. A thrown error is
424
- * immediately visible during development and integration testing.
425
- *
426
- * @internal
427
- * @throws {EnvStoreError}
428
- */
429
- requireStoreMap() {
430
- const storeMap = getInternalProjectEnvs();
431
- if (!storeMap) {
432
- throw new EnvStoreError();
433
- }
434
- return storeMap;
435
- }
436
- getStoreForCaller(callerRoot) {
437
- const storeMap = this.requireStoreMap();
438
- // 🛡️ Security & Scope Policy (Sandboxing):
439
- // 1. If an explicit root is provided, use it.
440
- // 2. Fallback to dynamic project discovery based on the caller's stack (Restricted Context) if enabled.
441
- // 3. Fallback to this EnvApi instance's pinned runner root (System Baseline/Forced root).
442
- const root = callerRoot ||
443
- (this.isDynamic ? getCallerProjectRoot() : null) ||
444
- this.runner.getRoot() ||
445
- getCallerProjectRoot();
446
- if (!root)
447
- return {};
448
- let store = storeMap.get(root);
449
- if (!store) {
450
- // Dynamic loading for projects/plugins not encountered during bootstrap.
451
- // Under Zero-Trust, all environment secrets must transit through libXESS IPC.
452
- const envData = {};
453
- const ipcSecrets = XessIpcClient.fetchSecretsSync(root);
454
- for (const key in ipcSecrets) {
455
- envData[key] = ipcSecrets[key];
456
- }
457
- // Cache the loaded env for this project
458
- storeMap.set(root, envData);
459
- store = envData;
460
- }
461
- return store;
462
- }
463
- // -------------------------------------------------------------------------
464
- // Private — validation
465
- // -------------------------------------------------------------------------
466
- /**
467
- * Asserts that `key` is a valid environment variable name.
468
- *
469
- * @internal
470
- * @throws {EnvKeyError}
471
- */
472
- validateKey(key) {
473
- if (key.length === 0) {
474
- throw new EnvKeyError(key, "key must not be empty");
475
- }
476
- if (key.trim().length === 0) {
477
- throw new EnvKeyError(key, "key must not consist solely of whitespace");
478
- }
479
- }
480
- /**
481
- * Asserts that `value` does not contain characters that can corrupt
482
- * downstream parsers, log sinks, or HTTP serialisers.
483
- *
484
- * Rejected characters:
485
- * - CR (`\r`) and LF (`\n`) — break line-oriented `.env` parsers and
486
- * enable log injection attacks.
487
- * - NUL (`\0`) — truncates strings in C-based runtimes and can bypass
488
- * suffix-based extension checks in some file path handling code.
489
- *
490
- * @internal
491
- * @throws {EnvKeyError}
492
- */
493
- validateValue(key, value) {
494
- if (FORBIDDEN_VALUE_PATTERN.test(value)) {
495
- throw new EnvKeyError(key, "value must not contain carriage return (\\r), line feed (\\n), " +
496
- "or NUL (\\0) characters — these can corrupt parsers and enable log injection");
497
- }
498
- }
499
- // -------------------------------------------------------------------------
500
- // Private — Shield
501
- // -------------------------------------------------------------------------
502
- /**
503
- * **Environment Security Shield**
504
- *
505
- * Replaces the `process.env` object with a hardened Proxy that enforces
506
- * the following policies on every property access:
507
- *
508
- * **Read trap**
509
- * - Whitelisted keys (see {@link EnvApi.whitelistedFields}) and keys
510
- * matching the prefixes `XY_`, `XYPRISS_`, `ENC_`, `DOTENV_`, or `__`
511
- * pass through to the real value.
512
- * - All other reads return `undefined`. A one-time per-key warning is
513
- * written to `process.stderr` (suppressed when
514
- * `XYPRISS_ENV_SHIELD=silent`).
515
- *
516
- * **`ownKeys` and `has` traps**
517
- * - Restrict the apparent key set to the whitelist. This prevents
518
- * third-party code from enumerating the real store through
519
- * `Object.keys(process.env)`, `JSON.stringify(process.env)`, or spread
520
- * operators — all of which bypass the `get` trap.
521
- *
522
- * The descriptor is applied with `writable: false` to prevent replacement
523
- * by application code, and `configurable: true` to allow test teardown.
524
- *
525
- * @internal
526
- */
527
- /**
528
- * **Environment Security Shield**
529
- *
530
- * Replaces the `process.env` object with a hardened Proxy that enforces
531
- * the following policies on every property access:
532
- *
533
- * **Read trap**
534
- * - Whitelisted keys (see {@link EnvApi.whitelistedFields}) and keys
535
- * matching the prefixes `XY_`, `XYPRISS_`, `ENC_`, `DOTENV_`, or `__`
536
- * pass through to the real value.
537
- * - All other reads return `undefined`. A one-time per-key warning is
538
- * written to `process.stderr` (suppressed when
539
- * `XYPRISS_ENV_SHIELD=silent`).
540
- *
541
- * **`ownKeys` and `has` traps**
542
- * - Restrict the apparent key set to the whitelist. This prevents
543
- * third-party code from enumerating the real store through
544
- * `Object.keys(process.env)`, `JSON.stringify(process.env)`, or spread
545
- * operators — all of which bypass the `get` trap.
546
- *
547
- * The descriptor is applied with `writable: false` to prevent replacement
548
- * by application code, and `configurable: true` to allow test teardown.
549
- *
550
- * @internal
551
- */
552
- applyShield() {
553
- // Issue #43: Guard against multi-server sequential startup re-wrapping process.env in nested proxies.
554
- const SHIELD_MARKER = Symbol.for("xypriss.env.shielded");
555
- if (process.env[SHIELD_MARKER]) {
556
- return;
557
- }
558
- // Per-key deduplication: every distinct blocked key gets exactly one
559
- // warning, preserving actionable signal without log flooding.
560
- const warnedKeys = new Set();
561
- const self = this;
562
- const envShield = new Proxy(process.env, {
563
- get(target, prop, receiver) {
564
- if (prop === SHIELD_MARKER) {
565
- return true;
566
- }
567
- if (typeof prop !== "string") {
568
- return Reflect.get(target, prop, receiver);
569
- }
570
- // Pass through whitelisted keys and framework-reserved prefixes.
571
- if (self.whitelistedFields.has(prop) ||
572
- prop.startsWith("XY_") ||
573
- prop.startsWith("XYPRISS_") ||
574
- prop.startsWith("LIBXESS_") ||
575
- prop.startsWith("ENC_") ||
576
- prop.startsWith("DOTENV_") ||
577
- prop.startsWith("__")) {
578
- return Reflect.get(target, prop, receiver);
579
- }
580
- // Emit one warning per unique blocked key.
581
- if (!warnedKeys.has(prop)) {
582
- const storeMap = getInternalProjectEnvs();
583
- let isSilent = target["XYPRISS_ENV_SHIELD"] === "silent";
584
- if (storeMap) {
585
- for (const env of storeMap.values()) {
586
- if (env["XYPRISS_ENV_SHIELD"] === "silent") {
587
- isSilent = true;
588
- break;
589
- }
590
- }
591
- }
592
- if (!isSilent) {
593
- process.stderr.write(`\x1b[33m[SECURITY]\x1b[0m ` +
594
- `Direct access to process.env["${prop}"] is blocked. ` +
595
- `Use \x1b[36m__sys__.__env__.get("${prop}")\x1b[0m ` +
596
- `or \x1b[36m__sys__.__env__.getStrict("${prop}")\x1b[0m instead.\n`);
597
- }
598
- warnedKeys.add(prop);
599
- }
600
- return undefined;
601
- },
602
- /**
603
- * Issue #43: Strict `set` trap on `process.env`.
604
- *
605
- * Under the Bun runtime, missing a `set` trap causes assignment on `process.env` to invoke
606
- * `Reflect.defineProperty` with strict descriptor expectations, failing with:
607
- * `'process.env' only accepts a configurable, writable, and enumerable data descriptor`.
608
- *
609
- * This trap permits safe mutation of whitelisted and framework-reserved keys (e.g. `XYPRISS_*`),
610
- * while gracefully intercepting and auditing non-compliant mutations without crashing the host process.
611
- */
612
- set(target, prop, value, receiver) {
613
- if (typeof prop !== "string") {
614
- return Reflect.set(target, prop, value, receiver);
615
- }
616
- const key = prop;
617
- // Allow whitelisted keys and framework-reserved prefixes
618
- if (self.whitelistedFields.has(key) ||
619
- key.startsWith("XY_") ||
620
- key.startsWith("XYPRISS_") ||
621
- key.startsWith("LIBXESS_") ||
622
- key.startsWith("XEMS_") ||
623
- key.startsWith("ENC_") ||
624
- key.startsWith("DOTENV_") ||
625
- key.startsWith("__")) {
626
- try {
627
- target[key] = String(value);
628
- }
629
- catch {
630
- // In case target descriptor cannot be mutated directly
631
- }
632
- return true;
633
- }
634
- // Prevent fatal crashes in strict runtimes (like Bun) while auditing unauthorized modifications
635
- if (!warnedKeys.has(key)) {
636
- process.stderr.write(`\x1b[33m[SECURITY]\x1b[0m ` +
637
- `Direct modification to process.env["${key}"] is blocked. ` +
638
- `Use \x1b[36m__sys__.__env__.set("${key}", value)\x1b[0m instead.\n`);
639
- warnedKeys.add(key);
640
- }
641
- return true;
642
- },
643
- /**
644
- * Issue #43: Explicit `defineProperty` trap to prevent uncaught descriptor exceptions under Bun.
645
- */
646
- defineProperty(target, prop, descriptor) {
647
- try {
648
- return Reflect.defineProperty(target, prop, descriptor);
649
- }
650
- catch {
651
- return false;
652
- }
653
- },
654
- /**
655
- * Issue #43: Explicit `deleteProperty` trap to allow removing allowed framework keys safely.
656
- */
657
- deleteProperty(target, prop) {
658
- if (typeof prop === "string") {
659
- if (self.whitelistedFields.has(prop) ||
660
- prop.startsWith("XY_") ||
661
- prop.startsWith("XYPRISS_") ||
662
- prop.startsWith("LIBXESS_") ||
663
- prop.startsWith("XEMS_") ||
664
- prop.startsWith("ENC_") ||
665
- prop.startsWith("DOTENV_") ||
666
- prop.startsWith("__")) {
667
- try {
668
- delete target[prop];
669
- }
670
- catch {
671
- // ignore
672
- }
673
- return true;
674
- }
675
- }
676
- return true;
677
- },
678
- // Harden enumeration: restrict what callers see when they iterate
679
- // or spread process.env. Without this trap, spread operators and
680
- // Object.keys() bypass the get trap entirely.
681
- ownKeys(_target) {
682
- return [...self.whitelistedFields];
683
- },
684
- // Align `in` operator behaviour with the restricted key set.
685
- has(_target, prop) {
686
- if (typeof prop !== "string")
687
- return false;
688
- return self.whitelistedFields.has(prop);
689
- },
690
- });
691
- try {
692
- Object.defineProperty(process, "env", {
693
- value: envShield,
694
- writable: false,
695
- configurable: true,
696
- enumerable: true,
697
- });
698
- }
699
- catch {
700
- // Silently degrade — the Shield could not be applied (e.g., inside
701
- // certain container or VM environments with locked descriptors).
702
- // The Symbol-keyed internal store remains the authoritative and
703
- // isolated source for all EnvApi reads.
704
- }
705
- }
706
- isCallerProjectCode() {
707
- const callerRoot = getCallerProjectRoot();
708
- const sysRoot = globalThis.__sys__?.__root__;
709
- return !!callerRoot && callerRoot === sysRoot;
710
- }
711
- }
712
-
713
- export { EnvApi };
714
- //# sourceMappingURL=EnvApi.js.map