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,1182 +0,0 @@
1
- 'use strict';
2
-
3
- var xyprissSecurity = require('xypriss-security');
4
-
5
- /***************************************************************************
6
- * XyPrissJS - Fast And Secure
7
- *
8
- * @author Nehonix
9
- * @license Nehonix OSL (NOSL)
10
- *
11
- * Copyright (c) 2025 Nehonix. All rights reserved.
12
- *
13
- * This License governs the use, modification, and distribution of software
14
- * provided by NEHONIX under its open source projects.
15
- * NEHONIX is committed to fostering collaborative innovation while strictly
16
- * protecting its intellectual property rights.
17
- * Violation of any term of this License will result in immediate termination of all granted rights
18
- * and may subject the violator to legal action.
19
- *
20
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
21
- * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
22
- * AND NON-INFRINGEMENT.
23
- * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
24
- * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
25
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
26
- *
27
- ***************************************************************************** */
28
- /**
29
- * @file NumberUtils.ts
30
- * @description XyPriss Number & Math Utilities — A comprehensive suite of
31
- * everyday numeric calculations, file & storage conversions, percentage analytics,
32
- * pagination algorithms, precision roundings, and localized formatters.
33
- *
34
- * @remarks
35
- * All methods are pure and deterministic unless utilizing cryptographic randomness
36
- * provided by `xypriss-security`.
37
- *
38
- * @example
39
- * ```ts
40
- * const num = new NumberUtils();
41
- *
42
- * // File & Storage Calculations
43
- * num.formatBytes(15_728_640); // "15 MB"
44
- * num.parseBytes("25.5 MB"); // 26738688
45
- * num.toMB(104857600); // 100
46
- *
47
- * // Daily Percentages & Ratios
48
- * num.percentage(45, 200); // 22.5 (%)
49
- * num.percentageOf(20, 150); // 30
50
- * num.percentageChange(100, 125); // 25 (+25%)
51
- *
52
- * // Pagination Helper
53
- * num.paginate(154, 20, 2); // { currentPage: 2, totalPages: 8, offset: 20, limit: 20, ... }
54
- * ```
55
- */
56
- /**
57
- * **NumberUtils — XyPriss Number & Math Utilities**
58
- *
59
- * Provides ready-to-use helpers for daily mathematical operations, data storage units,
60
- * rates, roundings, statistical metrics, bounds, and formatted output.
61
- */
62
- class NumberUtils {
63
- // ─────────────────────────────────────────────
64
- // Internal Helpers
65
- // ─────────────────────────────────────────────
66
- /**
67
- * Flattens a variadic list of numbers or number arrays into a flat numeric array.
68
- *
69
- * @param args - Numbers or arrays of numbers.
70
- * @returns A flat array of valid numbers.
71
- * @internal
72
- */
73
- flattenNumbers(args) {
74
- const result = [];
75
- for (const item of args) {
76
- if (Array.isArray(item)) {
77
- for (const num of item) {
78
- if (typeof num === "number" && !isNaN(num)) {
79
- result.push(num);
80
- }
81
- }
82
- }
83
- else if (typeof item === "number" && !isNaN(item)) {
84
- result.push(item);
85
- }
86
- }
87
- return result;
88
- }
89
- // ─────────────────────────────────────────────
90
- // File Sizes & Storage Data Calculations
91
- // ─────────────────────────────────────────────
92
- /**
93
- * **Format Bytes**
94
- *
95
- * Converts a raw number of bytes into a human-readable size string (e.g., `KB`, `MB`, `GB` or `KiB`, `MiB`, `GiB`).
96
- * Supports negative values and configurable decimal precision.
97
- *
98
- * @param bytes - The number of bytes to format.
99
- * @param optionsOrDecimals - Number of decimal places (default: `2`) or a {@link FormatBytesOptions} configuration object.
100
- * @returns A human-readable file size string.
101
- *
102
- * @example
103
- * ```ts
104
- * num.formatBytes(0); // "0 Bytes"
105
- * num.formatBytes(1024); // "1 KB"
106
- * num.formatBytes(15728640, 1); // "15 MB"
107
- * num.formatBytes(1073741824, { binary: true }); // "1 GiB"
108
- * ```
109
- */
110
- formatBytes(bytes, optionsOrDecimals = 2) {
111
- const options = typeof optionsOrDecimals === "number"
112
- ? { decimals: optionsOrDecimals }
113
- : optionsOrDecimals || {};
114
- const decimals = options.decimals !== undefined && options.decimals >= 0
115
- ? options.decimals
116
- : 2;
117
- const binary = options.binary ?? false;
118
- const spacer = options.spacer ?? " ";
119
- if (bytes === 0) {
120
- return `0${spacer}Bytes`;
121
- }
122
- const isNegative = bytes < 0;
123
- const absBytes = Math.abs(bytes);
124
- const k = 1024;
125
- const standardSizes = [
126
- "Bytes",
127
- "KB",
128
- "MB",
129
- "GB",
130
- "TB",
131
- "PB",
132
- "EB",
133
- "ZB",
134
- "YB",
135
- ];
136
- const binarySizes = [
137
- "Bytes",
138
- "KiB",
139
- "MiB",
140
- "GiB",
141
- "TiB",
142
- "PiB",
143
- "EiB",
144
- "ZiB",
145
- "YiB",
146
- ];
147
- const sizes = binary ? binarySizes : standardSizes;
148
- const i = Math.min(Math.floor(Math.log(absBytes) / Math.log(k)), sizes.length - 1);
149
- if (i === 0) {
150
- return `${isNegative ? "-" : ""}${absBytes}${spacer}${sizes[0]}`;
151
- }
152
- const val = absBytes / Math.pow(k, i);
153
- const formatted = this.round(val, decimals);
154
- return `${isNegative ? "-" : ""}${formatted}${spacer}${sizes[i]}`;
155
- }
156
- /**
157
- * **Parse Bytes**
158
- *
159
- * Parses a human-readable storage string (e.g., `"10MB"`, `"1.5 GB"`, `"500KB"`, `"64KiB"`, `"1024 B"`)
160
- * into the equivalent raw number of bytes. Very helpful for upload limits, payload sizes, and cache config.
161
- *
162
- * @param input - The size string to parse or raw byte number.
163
- * @returns The parsed number of bytes, or `NaN` if parsing fails.
164
- *
165
- * @example
166
- * ```ts
167
- * num.parseBytes("500 KB"); // 512000
168
- * num.parseBytes("10MB"); // 10485760
169
- * num.parseBytes("1.5 GB"); // 1610612736
170
- * num.parseBytes("256 B"); // 256
171
- * ```
172
- */
173
- parseBytes(input) {
174
- if (typeof input === "number") {
175
- return isNaN(input) ? 0 : input;
176
- }
177
- if (!input || typeof input !== "string") {
178
- return 0;
179
- }
180
- const trimmed = input.trim();
181
- const match = trimmed.match(/^([+-]?(?:\d+(?:\.\d+)?|\.\d+))\s*([a-zA-Z]*)$/);
182
- if (!match) {
183
- return NaN;
184
- }
185
- const value = parseFloat(match[1]);
186
- const unit = match[2].toUpperCase();
187
- if (!unit || unit === "B" || unit === "BYTES" || unit === "BYTE") {
188
- return Math.round(value);
189
- }
190
- const multipliers = {
191
- K: 1024,
192
- KB: 1024,
193
- KIB: 1024,
194
- M: 1024 ** 2,
195
- MB: 1024 ** 2,
196
- MIB: 1024 ** 2,
197
- G: 1024 ** 3,
198
- GB: 1024 ** 3,
199
- GIB: 1024 ** 3,
200
- T: 1024 ** 4,
201
- TB: 1024 ** 4,
202
- TIB: 1024 ** 4,
203
- P: 1024 ** 5,
204
- PB: 1024 ** 5,
205
- PIB: 1024 ** 5,
206
- };
207
- const mult = multipliers[unit];
208
- return mult !== undefined ? Math.round(value * mult) : NaN;
209
- }
210
- /**
211
- * **Convert Bytes to Kilobytes (KB)**
212
- *
213
- * @param bytes - Number of raw bytes.
214
- * @param decimals - Decimal places (default: `2`).
215
- * @returns The value in Kilobytes.
216
- *
217
- * @example
218
- * ```ts
219
- * num.toKB(2048); // 2
220
- * ```
221
- */
222
- toKB(bytes, decimals = 2) {
223
- return this.round(bytes / 1024, decimals);
224
- }
225
- /**
226
- * **Convert Bytes to Megabytes (MB)**
227
- *
228
- * @param bytes - Number of raw bytes.
229
- * @param decimals - Decimal places (default: `2`).
230
- * @returns The value in Megabytes.
231
- *
232
- * @example
233
- * ```ts
234
- * num.toMB(10485760); // 10
235
- * ```
236
- */
237
- toMB(bytes, decimals = 2) {
238
- return this.round(bytes / 1024 ** 2, decimals);
239
- }
240
- /**
241
- * **Convert Bytes to Gigabytes (GB)**
242
- *
243
- * @param bytes - Number of raw bytes.
244
- * @param decimals - Decimal places (default: `2`).
245
- * @returns The value in Gigabytes.
246
- *
247
- * @example
248
- * ```ts
249
- * num.toGB(1073741824); // 1
250
- * ```
251
- */
252
- toGB(bytes, decimals = 2) {
253
- return this.round(bytes / 1024 ** 3, decimals);
254
- }
255
- /**
256
- * **Convert Bytes to Terabytes (TB)**
257
- *
258
- * @param bytes - Number of raw bytes.
259
- * @param decimals - Decimal places (default: `2`).
260
- * @returns The value in Terabytes.
261
- *
262
- * @example
263
- * ```ts
264
- * num.toTB(1099511627776); // 1
265
- * ```
266
- */
267
- toTB(bytes, decimals = 2) {
268
- return this.round(bytes / 1024 ** 4, decimals);
269
- }
270
- /**
271
- * **Convert Bytes to Target Unit**
272
- *
273
- * Converts a byte count to any specified target unit (`KB`, `MB`, `GB`, `TB`, etc.).
274
- *
275
- * @param bytes - The number of bytes.
276
- * @param targetUnit - Destination unit (e.g., `"MB"`, `"GB"`).
277
- * @param decimals - Decimal places (default: `2`).
278
- * @returns The converted numeric value.
279
- *
280
- * @example
281
- * ```ts
282
- * num.convertBytes(52428800, "MB"); // 50
283
- * ```
284
- */
285
- convertBytes(bytes, targetUnit, decimals = 2) {
286
- const unitMap = {
287
- B: 1,
288
- KB: 1024,
289
- KIB: 1024,
290
- MB: 1024 ** 2,
291
- MIB: 1024 ** 2,
292
- GB: 1024 ** 3,
293
- GIB: 1024 ** 3,
294
- TB: 1024 ** 4,
295
- TIB: 1024 ** 4,
296
- PB: 1024 ** 5,
297
- PIB: 1024 ** 5,
298
- EB: 1024 ** 6,
299
- EIB: 1024 ** 6,
300
- ZB: 1024 ** 7,
301
- ZIB: 1024 ** 7,
302
- YB: 1024 ** 8,
303
- YIB: 1024 ** 8,
304
- };
305
- const divisor = unitMap[targetUnit.toUpperCase()] ?? 1;
306
- return this.round(bytes / divisor, decimals);
307
- }
308
- /**
309
- * **Transfer Rate / Speed**
310
- *
311
- * Calculates the transfer throughput given transferred bytes and elapsed duration in milliseconds.
312
- *
313
- * @param bytes - Transferred bytes.
314
- * @param durationMs - Duration in milliseconds.
315
- * @param decimals - Decimal places (default: `2`).
316
- * @returns A formatted speed string (e.g., `"12.5 MB/s"`).
317
- *
318
- * @example
319
- * ```ts
320
- * num.transferRate(10485760, 2000); // "5 MB/s"
321
- * ```
322
- */
323
- transferRate(bytes, durationMs, decimals = 2) {
324
- if (durationMs <= 0 || bytes <= 0) {
325
- return "0 Bytes/s";
326
- }
327
- const bytesPerSec = (bytes / durationMs) * 1000;
328
- return `${this.formatBytes(bytesPerSec, decimals)}/s`;
329
- }
330
- /**
331
- * **Transfer Estimated Time of Arrival (ETA)**
332
- *
333
- * Calculates the remaining time in seconds to complete a file or data transfer.
334
- *
335
- * @param remainingBytes - Bytes left to transfer.
336
- * @param bytesPerSec - Transfer throughput in bytes per second.
337
- * @returns Remaining time in seconds (rounded up), or `0` if invalid.
338
- *
339
- * @example
340
- * ```ts
341
- * num.transferETA(52428800, 10485760); // 5 (seconds)
342
- * ```
343
- */
344
- transferETA(remainingBytes, bytesPerSec) {
345
- if (bytesPerSec <= 0 || remainingBytes <= 0) {
346
- return 0;
347
- }
348
- return Math.ceil(remainingBytes / bytesPerSec);
349
- }
350
- // ─────────────────────────────────────────────
351
- // Percentages, Ratios & Progress
352
- // ─────────────────────────────────────────────
353
- /**
354
- * **Calculate Percentage (Partial of Total)**
355
- *
356
- * Returns what percentage `partial` represents relative to `total`: `(partial / total) * 100`.
357
- * Safely returns `0` if `total === 0` to prevent division by zero.
358
- *
359
- * @param partial - The partial amount.
360
- * @param total - The reference total.
361
- * @param decimals - Decimal places (default: `2`).
362
- * @returns The percentage value (e.g. `25` for 25%).
363
- *
364
- * @example
365
- * ```ts
366
- * num.percentage(25, 200); // 12.5
367
- * num.percentage(50, 100); // 50
368
- * num.percentage(0, 0); // 0
369
- * ```
370
- */
371
- percentage(partial, total, decimals = 2) {
372
- if (total === 0) {
373
- return 0;
374
- }
375
- return this.round((partial / total) * 100, decimals);
376
- }
377
- /**
378
- * **Calculate Value From Percentage (X% of Total)**
379
- *
380
- * Returns the actual value corresponding to `percent` of `total`: `(percent / 100) * total`.
381
- *
382
- * @param percent - The percentage rate (e.g., `20` for 20%).
383
- * @param total - The reference total.
384
- * @param decimals - Decimal places (default: `2`).
385
- * @returns The calculated portion.
386
- *
387
- * @example
388
- * ```ts
389
- * num.percentageOf(20, 150); // 30 (20% of 150 is 30)
390
- * num.percentageOf(5.5, 200); // 11
391
- * ```
392
- */
393
- percentageOf(percent, total, decimals = 2) {
394
- return this.round((percent / 100) * total, decimals);
395
- }
396
- /**
397
- * **Percentage Change / Growth Rate**
398
- *
399
- * Computes the relative percentage variation from `oldValue` to `newValue`.
400
- * Positive indicates an increase, negative indicates a decrease.
401
- *
402
- * @param oldValue - The baseline value.
403
- * @param newValue - The current value.
404
- * @param decimals - Decimal precision (default: `2`).
405
- * @returns Percentage variation.
406
- *
407
- * @example
408
- * ```ts
409
- * num.percentageChange(100, 150); // 50 (+50%)
410
- * num.percentageChange(200, 150); // -25 (-25%)
411
- * ```
412
- */
413
- percentageChange(oldValue, newValue, decimals = 2) {
414
- if (oldValue === 0) {
415
- return newValue === 0 ? 0 : 100;
416
- }
417
- const change = ((newValue - oldValue) / Math.abs(oldValue)) * 100;
418
- return this.round(change, decimals);
419
- }
420
- /**
421
- * **Progress Ratio**
422
- *
423
- * Calculates a normalized progress value clamped strictly between `0.0` and `1.0`.
424
- * Ideal for progress bars and completion meters.
425
- *
426
- * @param current - The current progress value.
427
- * @param total - The target total value.
428
- * @returns A float between `0.0` and `1.0`.
429
- *
430
- * @example
431
- * ```ts
432
- * num.progress(50, 100); // 0.5
433
- * num.progress(120, 100); // 1.0 (clamped)
434
- * num.progress(-10, 100); // 0.0 (clamped)
435
- * ```
436
- */
437
- progress(current, total) {
438
- if (total <= 0) {
439
- return 0;
440
- }
441
- return this.clamp(current / total, 0, 1);
442
- }
443
- // ─────────────────────────────────────────────
444
- // Rounding & Decimal Precision
445
- // ─────────────────────────────────────────────
446
- /**
447
- * **Accurate Decimal Rounding**
448
- *
449
- * Accurately rounds a number to a specified number of decimal places.
450
- * Uses exponential notation internally to avoid common JavaScript floating-point rounding bugs (e.g. `1.005 * 100`).
451
- *
452
- * @param value - The number to round.
453
- * @param decimals - Decimal places (default: `0`).
454
- * @returns The rounded number.
455
- *
456
- * @example
457
- * ```ts
458
- * num.round(1.005, 2); // 1.01 (avoids standard JS Math.round bug)
459
- * num.round(12.3456, 2); // 12.35
460
- * num.round(12.3456, 0); // 12
461
- * ```
462
- */
463
- round(value, decimals = 0) {
464
- if (isNaN(value)) {
465
- return NaN;
466
- }
467
- if (decimals <= 0) {
468
- return Math.round(value);
469
- }
470
- return Number(Math.round(Number(value + "e" + decimals)) + "e-" + decimals);
471
- }
472
- /**
473
- * **Accurate Decimal Ceil**
474
- *
475
- * Rounds up to the nearest specified decimal precision.
476
- *
477
- * @param value - The number to round up.
478
- * @param decimals - Decimal places (default: `0`).
479
- * @returns Ceiled value.
480
- *
481
- * @example
482
- * ```ts
483
- * num.ceil(1.234, 2); // 1.24
484
- * num.ceil(1.2, 0); // 2
485
- * ```
486
- */
487
- ceil(value, decimals = 0) {
488
- if (isNaN(value)) {
489
- return NaN;
490
- }
491
- if (decimals <= 0) {
492
- return Math.ceil(value);
493
- }
494
- return Number(Math.ceil(Number(value + "e" + decimals)) + "e-" + decimals);
495
- }
496
- /**
497
- * **Accurate Decimal Floor**
498
- *
499
- * Rounds down to the nearest specified decimal precision.
500
- *
501
- * @param value - The number to round down.
502
- * @param decimals - Decimal places (default: `0`).
503
- * @returns Floored value.
504
- *
505
- * @example
506
- * ```ts
507
- * num.floor(1.239, 2); // 1.23
508
- * num.floor(1.9, 0); // 1
509
- * ```
510
- */
511
- floor(value, decimals = 0) {
512
- if (isNaN(value)) {
513
- return NaN;
514
- }
515
- if (decimals <= 0) {
516
- return Math.floor(value);
517
- }
518
- return Number(Math.floor(Number(value + "e" + decimals)) + "e-" + decimals);
519
- }
520
- /**
521
- * **Round to Step / Multiple**
522
- *
523
- * Rounds a value to the nearest multiple of a given step (e.g., nearest `5`, `0.25`, or `100`).
524
- *
525
- * @param value - The value to round.
526
- * @param step - The increment step size.
527
- * @returns Value rounded to the nearest step.
528
- *
529
- * @example
530
- * ```ts
531
- * num.roundToStep(23, 5); // 25
532
- * num.roundToStep(1.234, 0.05); // 1.25
533
- * num.roundToStep(1430, 500); // 1500
534
- * ```
535
- */
536
- roundToStep(value, step) {
537
- if (step <= 0) {
538
- return value;
539
- }
540
- const inv = 1 / step;
541
- return Math.round(value * inv) / inv;
542
- }
543
- /**
544
- * **Round to Significant Digits**
545
- *
546
- * Formats a number to a specified number of significant digits.
547
- *
548
- * @param value - The number to format.
549
- * @param digits - Number of significant digits.
550
- * @returns The number rounded to significant precision.
551
- *
552
- * @example
553
- * ```ts
554
- * num.toPrecision(12345, 3); // 12300
555
- * num.toPrecision(0.001234, 2); // 0.0012
556
- * ```
557
- */
558
- toPrecision(value, digits) {
559
- if (isNaN(value) || digits <= 0) {
560
- return value;
561
- }
562
- return parseFloat(value.toPrecision(digits));
563
- }
564
- // ─────────────────────────────────────────────
565
- // Bounds, Clamping & Mapping
566
- // ─────────────────────────────────────────────
567
- /**
568
- * **Clamp a Value**
569
- *
570
- * Restricts a numeric value within a defined range `[min, max]`.
571
- * If `min > max`, the bounds are automatically swapped for safety.
572
- *
573
- * @param value - The value to clamp.
574
- * @param min - The lower bound.
575
- * @param max - The upper bound.
576
- * @returns The clamped value.
577
- *
578
- * @example
579
- * ```ts
580
- * num.clamp(15, 0, 10); // 10
581
- * num.clamp(-5, 0, 10); // 0
582
- * num.clamp(5, 0, 10); // 5
583
- * ```
584
- */
585
- clamp(value, min, max) {
586
- const lower = Math.min(min, max);
587
- const upper = Math.max(min, max);
588
- return Math.min(Math.max(value, lower), upper);
589
- }
590
- /**
591
- * **Check if Value is in Range**
592
- *
593
- * Determines whether a value falls within `[min, max]`.
594
- *
595
- * @param value - The value to test.
596
- * @param min - Range start.
597
- * @param max - Range end.
598
- * @param inclusive - Whether the bounds are inclusive (default: `true`).
599
- * @returns `true` if value is within bounds.
600
- *
601
- * @example
602
- * ```ts
603
- * num.inRange(5, 1, 10); // true
604
- * num.inRange(10, 1, 10, true); // true
605
- * num.inRange(10, 1, 10, false);// false
606
- * ```
607
- */
608
- inRange(value, min, max, inclusive = true) {
609
- const lower = Math.min(min, max);
610
- const upper = Math.max(min, max);
611
- return inclusive
612
- ? value >= lower && value <= upper
613
- : value > lower && value < upper;
614
- }
615
- /**
616
- * **Normalize a Value (0 to 1)**
617
- *
618
- * Maps a value from its original range `[min, max]` into a normalized unit float `[0.0, 1.0]`.
619
- *
620
- * @param value - The input value.
621
- * @param min - The minimum of the original range.
622
- * @param max - The maximum of the original range.
623
- * @returns Normalized float.
624
- *
625
- * @example
626
- * ```ts
627
- * num.normalize(50, 0, 100); // 0.5
628
- * num.normalize(15, 10, 20); // 0.5
629
- * ```
630
- */
631
- normalize(value, min, max) {
632
- if (min === max) {
633
- return 0;
634
- }
635
- return (value - min) / (max - min);
636
- }
637
- /**
638
- * **Linear Interpolation (LERP)**
639
- *
640
- * Returns the linear interpolation between `start` and `end` for a factor `t`:
641
- * Formula: `start * (1 - t) + end * t`.
642
- *
643
- * @param start - The start value.
644
- * @param end - The end value.
645
- * @param t - The interpolation factor (typically `0.0` to `1.0`).
646
- * @returns The interpolated value.
647
- *
648
- * @example
649
- * ```ts
650
- * num.lerp(0, 100, 0.5); // 50
651
- * num.lerp(20, 80, 0.25); // 35
652
- * ```
653
- */
654
- lerp(start, end, t) {
655
- return start * (1 - t) + end * t;
656
- }
657
- /**
658
- * **Map Range (Re-scale)**
659
- *
660
- * Maps an input number from an incoming range `[inMin, inMax]` to an outgoing range `[outMin, outMax]`.
661
- *
662
- * @param value - The number to map.
663
- * @param inMin - Lower bound of input range.
664
- * @param inMax - Upper bound of input range.
665
- * @param outMin - Lower bound of output range.
666
- * @param outMax - Upper bound of output range.
667
- * @returns The re-scaled value.
668
- *
669
- * @example
670
- * ```ts
671
- * // Map a 0-10 rating to a 0-100 percentage
672
- * num.mapRange(7.5, 0, 10, 0, 100); // 75
673
- *
674
- * // Map temperature sensor (0-1023) to degrees C (0-100)
675
- * num.mapRange(511.5, 0, 1023, 0, 100); // 50
676
- * ```
677
- */
678
- mapRange(value, inMin, inMax, outMin, outMax) {
679
- if (inMin === inMax) {
680
- return outMin;
681
- }
682
- return (((value - inMin) * (outMax - outMin)) / (inMax - inMin) + outMin);
683
- }
684
- // ─────────────────────────────────────────────
685
- // Aggregates & Statistics
686
- // ─────────────────────────────────────────────
687
- /**
688
- * **Sum of Numbers**
689
- *
690
- * Computes the sum of all provided numbers or numeric arrays.
691
- *
692
- * @param numbers - Variadic numbers or number arrays.
693
- * @returns Total sum.
694
- *
695
- * @example
696
- * ```ts
697
- * num.sum(1, 2, 3, 4); // 10
698
- * num.sum([10, 20, 30]); // 60
699
- * ```
700
- */
701
- sum(...numbers) {
702
- const flat = this.flattenNumbers(numbers);
703
- return flat.reduce((acc, curr) => acc + curr, 0);
704
- }
705
- /**
706
- * **Average / Arithmetic Mean**
707
- *
708
- * Computes the arithmetic mean of all provided numbers or numeric arrays.
709
- *
710
- * @param numbers - Variadic numbers or number arrays.
711
- * @returns The average, or `0` if empty.
712
- *
713
- * @example
714
- * ```ts
715
- * num.average(10, 20, 30); // 20
716
- * num.average([5, 15]); // 10
717
- * ```
718
- */
719
- average(...numbers) {
720
- const flat = this.flattenNumbers(numbers);
721
- if (flat.length === 0) {
722
- return 0;
723
- }
724
- return this.sum(flat) / flat.length;
725
- }
726
- /**
727
- * **Median**
728
- *
729
- * Returns the statistical median (middle value) of a set of numbers.
730
- *
731
- * @param numbers - Variadic numbers or number arrays.
732
- * @returns The median value, or `0` if empty.
733
- *
734
- * @example
735
- * ```ts
736
- * num.median(1, 3, 5); // 3
737
- * num.median([1, 2, 3, 4]); // 2.5
738
- * ```
739
- */
740
- median(...numbers) {
741
- const flat = this.flattenNumbers(numbers);
742
- if (flat.length === 0) {
743
- return 0;
744
- }
745
- const sorted = [...flat].sort((a, b) => a - b);
746
- const mid = Math.floor(sorted.length / 2);
747
- return sorted.length % 2 !== 0
748
- ? sorted[mid]
749
- : (sorted[mid - 1] + sorted[mid]) / 2;
750
- }
751
- /**
752
- * **Minimum Value**
753
- *
754
- * Returns the minimum value from numbers or number arrays.
755
- *
756
- * @param numbers - Variadic numbers or number arrays.
757
- * @returns The smallest number, or `Infinity` if no numbers provided.
758
- *
759
- * @example
760
- * ```ts
761
- * num.min(10, 5, 20); // 5
762
- * num.min([12, 4, 89]); // 4
763
- * ```
764
- */
765
- min(...numbers) {
766
- const flat = this.flattenNumbers(numbers);
767
- if (flat.length === 0) {
768
- return Infinity;
769
- }
770
- return Math.min(...flat);
771
- }
772
- /**
773
- * **Maximum Value**
774
- *
775
- * Returns the maximum value from numbers or number arrays.
776
- *
777
- * @param numbers - Variadic numbers or number arrays.
778
- * @returns The largest number, or `-Infinity` if no numbers provided.
779
- *
780
- * @example
781
- * ```ts
782
- * num.max(10, 5, 20); // 20
783
- * num.max([12, 4, 89]); // 89
784
- * ```
785
- */
786
- max(...numbers) {
787
- const flat = this.flattenNumbers(numbers);
788
- if (flat.length === 0) {
789
- return -Infinity;
790
- }
791
- return Math.max(...flat);
792
- }
793
- // ─────────────────────────────────────────────
794
- // Pagination & Integer Division
795
- // ─────────────────────────────────────────────
796
- /**
797
- * **Calculate Pagination**
798
- *
799
- * Computes all essential pagination parameters (`totalPages`, `offset`, `limit`, `startIndex`, `endIndex`, `hasNext`, `hasPrev`)
800
- * for database queries and user interfaces.
801
- *
802
- * @param totalItems - Total number of items across the entire dataset.
803
- * @param pageSize - Items per page (minimum 1).
804
- * @param currentPage - Requested 1-based page number (default: `1`).
805
- * @returns A structured {@link PaginationResult} object.
806
- *
807
- * @example
808
- * ```ts
809
- * const pageInfo = num.paginate(154, 20, 2);
810
- * // {
811
- * // currentPage: 2,
812
- * // totalPages: 8,
813
- * // pageSize: 20,
814
- * // totalItems: 154,
815
- * // offset: 20,
816
- * // limit: 20,
817
- * // startIndex: 20,
818
- * // endIndex: 39,
819
- * // hasNext: true,
820
- * // hasPrev: true
821
- * // }
822
- * ```
823
- */
824
- paginate(totalItems, pageSize, currentPage = 1) {
825
- const safeTotal = Math.max(0, totalItems);
826
- const safePageSize = Math.max(1, pageSize);
827
- const totalPages = Math.max(1, Math.ceil(safeTotal / safePageSize));
828
- const safeCurrentPage = this.clamp(currentPage, 1, totalPages);
829
- const offset = (safeCurrentPage - 1) * safePageSize;
830
- const limit = safePageSize;
831
- const startIndex = safeTotal === 0 ? 0 : offset;
832
- const endIndex = safeTotal === 0
833
- ? 0
834
- : Math.min(offset + safePageSize - 1, safeTotal - 1);
835
- return {
836
- currentPage: safeCurrentPage,
837
- totalPages,
838
- pageSize: safePageSize,
839
- totalItems: safeTotal,
840
- offset,
841
- limit,
842
- startIndex,
843
- endIndex,
844
- hasNext: safeCurrentPage < totalPages,
845
- hasPrev: safeCurrentPage > 1,
846
- };
847
- }
848
- /**
849
- * **Euclidean Division (DivMod)**
850
- *
851
- * Simultaneously calculates the integer quotient and remainder of two numbers: `[quotient, remainder]`.
852
- * Extremely convenient for converting time units (seconds to minutes/seconds), grid positioning, and pagination.
853
- *
854
- * @param numerator - The dividend.
855
- * @param denominator - The divisor.
856
- * @returns A tuple `[quotient, remainder]`.
857
- *
858
- * @example
859
- * ```ts
860
- * const [minutes, seconds] = num.divmod(135, 60); // [2, 15] (2 min 15 sec)
861
- * const [hours, remainingMin] = num.divmod(150, 60); // [2, 30] (2 h 30 min)
862
- * ```
863
- */
864
- divmod(numerator, denominator) {
865
- if (denominator === 0) {
866
- return [NaN, NaN];
867
- }
868
- const quotient = Math.trunc(numerator / denominator);
869
- const remainder = numerator % denominator;
870
- return [quotient, remainder];
871
- }
872
- // ─────────────────────────────────────────────
873
- // Secure Randomness
874
- // ─────────────────────────────────────────────
875
- /**
876
- * **Get a Random Integer**
877
- *
878
- * Generates a cryptographically secure random integer.
879
- * Powered by `xypriss-security` Random core.
880
- *
881
- * - If one argument is provided: `[0, max)`
882
- * - If two arguments are provided: `[min, max)`
883
- *
884
- * @param minOrMax - Minimum value (inclusive) or maximum if second argument is omitted.
885
- * @param max - Maximum value (exclusive).
886
- * @returns A secure random integer.
887
- *
888
- * @example
889
- * ```ts
890
- * num.randomInt(10); // Secure integer in [0, 10)
891
- * num.randomInt(10, 50); // Secure integer in [10, 50)
892
- * ```
893
- */
894
- randomInt(...I) {
895
- return xyprissSecurity.Random.Int(...I);
896
- }
897
- /**
898
- * **Get a Random Float**
899
- *
900
- * Generates a cryptographically secure random floating-point number between `min` and `max`.
901
- *
902
- * @param min - Lower bound (default: `0`).
903
- * @param max - Upper bound (default: `1`).
904
- * @param decimals - Decimal places (default: `4`).
905
- * @returns A secure random float.
906
- *
907
- * @example
908
- * ```ts
909
- * num.randomFloat(); // e.g. 0.4821
910
- * num.randomFloat(1.5, 9.5, 2); // e.g. 6.34
911
- * ```
912
- */
913
- randomFloat(min = 0, max = 1, decimals = 4) {
914
- let low = min;
915
- let high = max;
916
- if (low > high) {
917
- [low, high] = [high, low];
918
- }
919
- const bytes = xyprissSecurity.Random.Bytes(4);
920
- const view = new DataView(bytes.buffer, bytes.byteOffset, 4);
921
- const uint32 = view.getUint32(0, true);
922
- const norm = uint32 / 0xffffffff;
923
- const val = low + norm * (high - low);
924
- return this.round(val, decimals);
925
- }
926
- /**
927
- * **Random Item Selection**
928
- *
929
- * Randomly picks an element from an array using cryptographically secure random numbers.
930
- *
931
- * @param items - The candidate array.
932
- * @returns A selected item from the array.
933
- *
934
- * @example
935
- * ```ts
936
- * num.randomChoice(["apple", "banana", "cherry"]); // e.g. "banana"
937
- * ```
938
- */
939
- randomChoice(items) {
940
- return xyprissSecurity.Random.pick(items);
941
- }
942
- // ─────────────────────────────────────────────
943
- // Formatting & Localization
944
- // ─────────────────────────────────────────────
945
- /**
946
- * **Format Number**
947
- *
948
- * Locale-aware number formatting powered by `Intl.NumberFormat`.
949
- *
950
- * @param value - The number to format.
951
- * @param locale - Optional BCP 47 locale (default: `en-US`).
952
- * @param options - `Intl.NumberFormatOptions`.
953
- * @returns A localized string.
954
- *
955
- * @example
956
- * ```ts
957
- * num.formatNumber(1250000); // "1,250,000"
958
- * num.formatNumber(1250000, "fr-FR"); // "1 250 000"
959
- * ```
960
- */
961
- formatNumber(value, locale = "en-US", options) {
962
- return new Intl.NumberFormat(locale, options).format(value);
963
- }
964
- /**
965
- * **Compact Number Formatting**
966
- *
967
- * Formats large numbers compactly for dashboards, views, and metrics (e.g., `1.5K`, `2.3M`, `4.8B`).
968
- *
969
- * @param value - The number to format.
970
- * @param locale - Locale tag (default: `en-US`).
971
- * @param decimals - Decimal digits (default: `1`).
972
- * @returns A compact string.
973
- *
974
- * @example
975
- * ```ts
976
- * num.formatCompact(1500); // "1.5K"
977
- * num.formatCompact(2500000); // "2.5M"
978
- * num.formatCompact(1200000000); // "1.2B"
979
- * ```
980
- */
981
- formatCompact(value, locale = "en-US", decimals = 1) {
982
- return new Intl.NumberFormat(locale, {
983
- notation: "compact",
984
- compactDisplay: "short",
985
- maximumFractionDigits: decimals,
986
- }).format(value);
987
- }
988
- /**
989
- * **Format Currency**
990
- *
991
- * Formats a numeric value into a localized currency string.
992
- *
993
- * @param value - The amount to format.
994
- * @param currency - ISO 4217 currency code (default: `"USD"`).
995
- * @param locale - Locale tag (default: `"en-US"`).
996
- * @param options - Additional `Intl.NumberFormatOptions`.
997
- * @returns Formatted currency string.
998
- *
999
- * @example
1000
- * ```ts
1001
- * num.formatCurrency(49.99, "USD"); // "$49.99"
1002
- * num.formatCurrency(49.99, "EUR", "fr-FR"); // "49,99 €"
1003
- * ```
1004
- */
1005
- formatCurrency(value, currency = "USD", locale = "en-US", options) {
1006
- return new Intl.NumberFormat(locale, {
1007
- style: "currency",
1008
- currency,
1009
- ...options,
1010
- }).format(value);
1011
- }
1012
- /**
1013
- * **Format Percentage String**
1014
- *
1015
- * Formats a numeric value into a localized percentage string with the `%` symbol.
1016
- *
1017
- * @param value - The percentage value (e.g. `15.5` or `0.155` if `isRatio: true`).
1018
- * @param decimals - Decimal places (default: `1`).
1019
- * @param locale - Locale tag (default: `"en-US"`).
1020
- * @param isRatio - If `true`, multiplies value by 100 first (default: `false`).
1021
- * @returns Formatted percentage string.
1022
- *
1023
- * @example
1024
- * ```ts
1025
- * num.formatPercent(15.5); // "15.5%"
1026
- * num.formatPercent(0.155, 1, "en-US", true); // "15.5%"
1027
- * ```
1028
- */
1029
- formatPercent(value, decimals = 1, locale = "en-US", isRatio = false) {
1030
- const percentValue = isRatio ? value * 100 : value;
1031
- const formatted = this.formatNumber(this.round(percentValue, decimals), locale, {
1032
- minimumFractionDigits: decimals,
1033
- maximumFractionDigits: decimals,
1034
- });
1035
- return `${formatted}%`;
1036
- }
1037
- /**
1038
- * **Ordinal Number Suffix**
1039
- *
1040
- * Appends the appropriate ordinal suffix to a number (e.g. `1st`, `2nd`, `3rd`, `4th` in English, or `1er`, `2e` in French).
1041
- *
1042
- * @param num - The integer number.
1043
- * @param locale - Target locale (default: `"en-US"`).
1044
- * @returns The number with its ordinal suffix.
1045
- *
1046
- * @example
1047
- * ```ts
1048
- * num.ordinal(1); // "1st"
1049
- * num.ordinal(2); // "2nd"
1050
- * num.ordinal(23); // "23rd"
1051
- * num.ordinal(1, "fr-FR"); // "1er"
1052
- * num.ordinal(2, "fr-FR"); // "2e"
1053
- * ```
1054
- */
1055
- ordinal(num, locale = "en-US") {
1056
- const intVal = Math.trunc(num);
1057
- if (locale.startsWith("fr")) {
1058
- return intVal === 1 ? "1er" : `${intVal}e`;
1059
- }
1060
- const abs = Math.abs(intVal);
1061
- const mod100 = abs % 100;
1062
- if (mod100 >= 11 && mod100 <= 13) {
1063
- return `${intVal}th`;
1064
- }
1065
- switch (abs % 10) {
1066
- case 1:
1067
- return `${intVal}st`;
1068
- case 2:
1069
- return `${intVal}nd`;
1070
- case 3:
1071
- return `${intVal}rd`;
1072
- default:
1073
- return `${intVal}th`;
1074
- }
1075
- }
1076
- // ─────────────────────────────────────────────
1077
- // Predicates & Checks
1078
- // ─────────────────────────────────────────────
1079
- /**
1080
- * **Check Even**
1081
- *
1082
- * Returns `true` if the number is an even integer.
1083
- *
1084
- * @param value - The number to test.
1085
- * @returns `true` if even.
1086
- *
1087
- * @example
1088
- * ```ts
1089
- * num.isEven(4); // true
1090
- * num.isEven(3); // false
1091
- * ```
1092
- */
1093
- isEven(value) {
1094
- return value % 2 === 0;
1095
- }
1096
- /**
1097
- * **Check Odd**
1098
- *
1099
- * Returns `true` if the number is an odd integer.
1100
- *
1101
- * @param value - The number to test.
1102
- * @returns `true` if odd.
1103
- *
1104
- * @example
1105
- * ```ts
1106
- * num.isOdd(3); // true
1107
- * num.isOdd(4); // false
1108
- * ```
1109
- */
1110
- isOdd(value) {
1111
- return Math.abs(value % 2) === 1;
1112
- }
1113
- /**
1114
- * **Check Integer**
1115
- *
1116
- * Returns `true` if the value is a safe, finite integer.
1117
- *
1118
- * @param value - The number to test.
1119
- * @returns `true` if an integer.
1120
- *
1121
- * @example
1122
- * ```ts
1123
- * num.isInteger(42); // true
1124
- * num.isInteger(42.5); // false
1125
- * ```
1126
- */
1127
- isInteger(value) {
1128
- return Number.isInteger(value);
1129
- }
1130
- /**
1131
- * **Check Numeric**
1132
- *
1133
- * Checks if a value is a valid numeric value or a numeric string representing a finite number.
1134
- *
1135
- * @param value - Any value to test.
1136
- * @returns Type guard confirming if the value is numeric.
1137
- *
1138
- * @example
1139
- * ```ts
1140
- * num.isNumeric(42); // true
1141
- * num.isNumeric("42.5"); // true
1142
- * num.isNumeric("abc"); // false
1143
- * num.isNumeric(null); // false
1144
- * ```
1145
- */
1146
- isNumeric(value) {
1147
- if (typeof value === "number") {
1148
- return !isNaN(value) && isFinite(value);
1149
- }
1150
- if (typeof value !== "string") {
1151
- return false;
1152
- }
1153
- return (value.trim() !== "" &&
1154
- !isNaN(Number(value)) &&
1155
- isFinite(Number(value)));
1156
- }
1157
- /**
1158
- * **Sign of a Number**
1159
- *
1160
- * Returns `-1` for negative numbers, `1` for positive numbers, and `0` for zero.
1161
- *
1162
- * @param value - The number.
1163
- * @returns `-1 | 0 | 1`.
1164
- *
1165
- * @example
1166
- * ```ts
1167
- * num.sign(-42); // -1
1168
- * num.sign(42); // 1
1169
- * num.sign(0); // 0
1170
- * ```
1171
- */
1172
- sign(value) {
1173
- if (value > 0)
1174
- return 1;
1175
- if (value < 0)
1176
- return -1;
1177
- return 0;
1178
- }
1179
- }
1180
-
1181
- exports.NumberUtils = NumberUtils;
1182
- //# sourceMappingURL=NumberUtils.js.map