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,1135 +0,0 @@
1
- 'use strict';
2
-
3
- class DateUtils {
4
- // ─────────────────────────────────────────────
5
- // Internal helpers
6
- // ─────────────────────────────────────────────
7
- /**
8
- * Converts any supported input value to a `Date` object.
9
- *
10
- * Supported inputs:
11
- * - `Date` — returned as-is (not cloned).
12
- * - `number` — auto-detected as Unix seconds (`< 1e11`) or milliseconds.
13
- * - `string` — natural expression (`"7d"`, `"3M"`, `"tomorrow"`) or standard date string (ISO 8601).
14
- *
15
- * @param date - The value to convert.
16
- * @returns The corresponding `Date` object.
17
- * @throws {RangeError} If the resulting `Date` is invalid.
18
- *
19
- * @internal
20
- */
21
- toDate(date) {
22
- let d;
23
- if (date instanceof Date) {
24
- d = date;
25
- }
26
- else if (typeof date === "number") {
27
- // Heuristic: Unix timestamps (seconds) are currently ~1.7e9.
28
- // JavaScript timestamps (ms) are ~1.7e12.
29
- // Values below 1e11 are assumed to be in seconds.
30
- const ms = date < 100000000000 ? date * 1000 : date;
31
- d = new Date(ms);
32
- }
33
- else if (typeof date === "string") {
34
- const trimmed = date.trim();
35
- // Try standard ISO / Date parsing first if it looks like a formatted timestamp
36
- if (/^\d{4}[-/]\d{2}[-/]\d{2}/.test(trimmed) || trimmed.includes("T")) {
37
- d = new Date(trimmed);
38
- }
39
- else {
40
- // Otherwise attempt natural duration parsing (e.g. "7d", "3M", "tomorrow")
41
- try {
42
- d = this.from(trimmed);
43
- }
44
- catch {
45
- d = new Date(trimmed);
46
- }
47
- }
48
- }
49
- else {
50
- d = new Date(date);
51
- }
52
- if (!d || isNaN(d.getTime())) {
53
- throw new RangeError(`DateUtils: invalid date value — "${date}"`);
54
- }
55
- return d;
56
- }
57
- /**
58
- * Converts any supported input value to a millisecond timestamp.
59
- *
60
- * @param date - The value to convert.
61
- * @returns Milliseconds since the Unix epoch.
62
- *
63
- * @internal
64
- */
65
- toMs(date) {
66
- return this.toDate(date).getTime();
67
- }
68
- // ─────────────────────────────────────────────
69
- // Current time
70
- // ─────────────────────────────────────────────
71
- /**
72
- * Returns the current Unix timestamp in **seconds**.
73
- *
74
- * @returns The current time as a Unix timestamp (integer seconds).
75
- *
76
- * @example
77
- * ```ts
78
- * du.now(); // e.g. 1776287197
79
- * ```
80
- */
81
- now() {
82
- return Math.floor(Date.now() / 1000);
83
- }
84
- /**
85
- * Returns the current time as a JavaScript timestamp in **milliseconds**.
86
- *
87
- * Equivalent to `Date.now()`.
88
- *
89
- * @returns The current time in milliseconds since the Unix epoch.
90
- *
91
- * @example
92
- * ```ts
93
- * du.nowMs(); // e.g. 1776287197000
94
- * ```
95
- */
96
- nowMs() {
97
- return Date.now();
98
- }
99
- /**
100
- * Returns the current time as a `Date` object.
101
- *
102
- * @returns A new `Date` representing the current instant.
103
- *
104
- * @example
105
- * ```ts
106
- * du.today(); // Date { ... }
107
- * ```
108
- */
109
- today() {
110
- return new Date();
111
- }
112
- // ─────────────────────────────────────────────
113
- // Formatting
114
- // ─────────────────────────────────────────────
115
- /**
116
- * Serializes a date value into a localized string using `Intl.DateTimeFormat`.
117
- *
118
- * Automatically handles Unix timestamps (seconds) and JavaScript timestamps
119
- * (milliseconds) via the `< 1e11` heuristic.
120
- *
121
- * @param date - The input to format: `Date`, number (timestamp), or ISO string.
122
- * @param locale - BCP 47 locale tag (default: `"en-US"`).
123
- * @param options - `Intl.DateTimeFormatOptions` to customize the output.
124
- * @returns A localized date string.
125
- *
126
- * @example
127
- * ```ts
128
- * du.format(1776287197);
129
- * // → "Apr 15, 2026"
130
- *
131
- * du.format(new Date(), "fr-FR", { dateStyle: "full" });
132
- * // → "mercredi 15 avril 2026"
133
- *
134
- * du.format("2026-04-15T12:00:00Z", "en-GB", { timeStyle: "short" });
135
- * // → "12:00"
136
- * ```
137
- */
138
- format(date, locale = "en-US", options = { dateStyle: "long" }) {
139
- return new Intl.DateTimeFormat(locale, options).format(this.toDate(date));
140
- }
141
- /**
142
- * Formats a date as an ISO 8601 string (`YYYY-MM-DDTHH:mm:ss.sssZ`).
143
- *
144
- * This is the format recommended for data interchange and storage.
145
- *
146
- * @param date - The date to format (default: current time).
147
- * @returns An ISO 8601 UTC string.
148
- *
149
- * @example
150
- * ```ts
151
- * du.toISO();
152
- * // → "2026-04-15T10:30:00.000Z"
153
- *
154
- * du.toISO(1776287197);
155
- * // → "2026-04-15T..."
156
- * ```
157
- */
158
- toISO(date = new Date()) {
159
- return this.toDate(date).toISOString();
160
- }
161
- /**
162
- * Formats a date as a plain date string: `YYYY-MM-DD`.
163
- *
164
- * The date is rendered in **local time** unless a UTC flag is set.
165
- *
166
- * @param date - The date to format (default: current time).
167
- * @param utc - If `true`, use UTC date components instead of local time (default: `false`).
168
- * @returns A date-only string in `YYYY-MM-DD` format.
169
- *
170
- * @example
171
- * ```ts
172
- * du.toDateString();
173
- * // → "2026-04-15"
174
- *
175
- * du.toDateString(new Date("2026-12-31T23:59:00Z"), true);
176
- * // → "2026-12-31"
177
- * ```
178
- */
179
- toDateString(date = new Date(), utc = false) {
180
- const d = this.toDate(date);
181
- const y = utc ? d.getUTCFullYear() : d.getFullYear();
182
- const m = String(utc ? d.getUTCMonth() + 1 : d.getMonth() + 1).padStart(2, "0");
183
- const day = String(utc ? d.getUTCDate() : d.getDate()).padStart(2, "0");
184
- return `${y}-${m}-${day}`;
185
- }
186
- /**
187
- * Formats a date as a time string: `HH:mm:ss`.
188
- *
189
- * The time is rendered in **local time** unless the UTC flag is set.
190
- *
191
- * @param date - The date to format (default: current time).
192
- * @param utc - If `true`, use UTC time components (default: `false`).
193
- * @returns A time-only string in `HH:mm:ss` format.
194
- *
195
- * @example
196
- * ```ts
197
- * du.toTimeString(new Date("2026-04-15T08:05:03Z"), true);
198
- * // → "08:05:03"
199
- * ```
200
- */
201
- toTimeString(date = new Date(), utc = false) {
202
- const d = this.toDate(date);
203
- const h = String(utc ? d.getUTCHours() : d.getHours()).padStart(2, "0");
204
- const min = String(utc ? d.getUTCMinutes() : d.getMinutes()).padStart(2, "0");
205
- const sec = String(utc ? d.getUTCSeconds() : d.getSeconds()).padStart(2, "0");
206
- return `${h}:${min}:${sec}`;
207
- }
208
- /**
209
- * Converts a duration into a human-readable string (e.g., `"1d 2h 30m 5s"`).
210
- *
211
- * Components are omitted when their value is zero, except for seconds which
212
- * always appear when the total duration is less than one minute.
213
- *
214
- * @param value - The duration to format.
215
- * @param unit - The unit of `value`: `"ms"` (milliseconds, default) or `"s"` (seconds).
216
- * @returns A compact, space-separated duration string.
217
- *
218
- * @example
219
- * ```ts
220
- * du.formatDuration(3_661_000); // → "1h 1m 1s"
221
- * du.formatDuration(90, "s"); // → "1m 30s"
222
- * du.formatDuration(0); // → "0s"
223
- * du.formatDuration(86_400_000); // → "1d"
224
- * ```
225
- */
226
- formatDuration(value, unit = "ms") {
227
- const ms = unit === "s" ? value * 1000 : value;
228
- const seconds = Math.floor((ms / 1000) % 60);
229
- const minutes = Math.floor((ms / (1000 * 60)) % 60);
230
- const hours = Math.floor((ms / (1000 * 60 * 60)) % 24);
231
- const days = Math.floor(ms / (1000 * 60 * 60 * 24));
232
- const parts = [];
233
- if (days > 0)
234
- parts.push(`${days}d`);
235
- if (hours > 0)
236
- parts.push(`${hours}h`);
237
- if (minutes > 0)
238
- parts.push(`${minutes}m`);
239
- if (seconds > 0 || parts.length === 0)
240
- parts.push(`${seconds}s`);
241
- return parts.join(" ");
242
- }
243
- /**
244
- * Returns a relative time string (e.g., `"5 minutes ago"`, `"in 2 hours"`).
245
- *
246
- * Uses `Intl.RelativeTimeFormat` for locale-aware output. Automatically
247
- * selects the most appropriate unit (second → minute → hour → day → month → year).
248
- *
249
- * @param date - The reference date, in the past or future.
250
- * @param locale - BCP 47 locale tag (default: `"en-US"`).
251
- * @returns A localized relative time string.
252
- *
253
- * @example
254
- * ```ts
255
- * du.timeAgo(Date.now() - 90_000); // → "2 minutes ago"
256
- * du.timeAgo(Date.now() + 3_600_000); // → "in 1 hour"
257
- * du.timeAgo(Date.now() - 90_000, "fr"); // → "il y a 2 minutes"
258
- * ```
259
- */
260
- timeAgo(date, locale = "en-US") {
261
- const ms = this.toMs(date);
262
- const deltaSeconds = Math.floor((Date.now() - ms) / 1000);
263
- const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
264
- if (Math.abs(deltaSeconds) < 60)
265
- return rtf.format(-deltaSeconds, "second");
266
- const minutes = Math.floor(deltaSeconds / 60);
267
- if (Math.abs(minutes) < 60)
268
- return rtf.format(-minutes, "minute");
269
- const hours = Math.floor(minutes / 60);
270
- if (Math.abs(hours) < 24)
271
- return rtf.format(-hours, "hour");
272
- const days = Math.floor(hours / 24);
273
- if (Math.abs(days) < 30)
274
- return rtf.format(-days, "day");
275
- const months = Math.floor(days / 30);
276
- if (Math.abs(months) < 12)
277
- return rtf.format(-months, "month");
278
- const years = Math.floor(months / 12);
279
- return rtf.format(-years, "year");
280
- }
281
- // ─────────────────────────────────────────────
282
- // Arithmetic
283
- // ─────────────────────────────────────────────
284
- /**
285
- * Adds a given amount of time to a date and returns a new `Date`.
286
- *
287
- * Supported units: `"ms"`, `"s"` (seconds), `"m"` (minutes), `"h"` (hours),
288
- * `"d"` (days), `"w"` (weeks), `"mo"` (months), `"y"` (years).
289
- *
290
- * Month and year arithmetic is handled using `setMonth` / `setFullYear`,
291
- * which correctly accounts for varying month lengths (e.g., adding 1 month
292
- * to January 31 yields February 28/29).
293
- *
294
- * @param date - The starting date.
295
- * @param value - The amount to add (can be negative to subtract).
296
- * @param unit - The time unit.
297
- * @returns A new `Date` offset by the specified amount.
298
- *
299
- * @example
300
- * ```ts
301
- * du.add(new Date("2026-01-31"), 1, "mo");
302
- * // → Date("2026-02-28") — accounts for shorter February
303
- *
304
- * du.add(new Date("2026-04-15"), -7, "d");
305
- * // → Date("2026-04-08")
306
- *
307
- * du.add(Date.now(), 2, "h");
308
- * // → Date 2 hours from now
309
- * ```
310
- */
311
- add(date, value, unit) {
312
- const d = new Date(this.toMs(date));
313
- switch (unit) {
314
- case "ms":
315
- d.setMilliseconds(d.getMilliseconds() + value);
316
- break;
317
- case "s":
318
- d.setSeconds(d.getSeconds() + value);
319
- break;
320
- case "m":
321
- d.setMinutes(d.getMinutes() + value);
322
- break;
323
- case "h":
324
- d.setHours(d.getHours() + value);
325
- break;
326
- case "d":
327
- d.setDate(d.getDate() + value);
328
- break;
329
- case "w":
330
- d.setDate(d.getDate() + value * 7);
331
- break;
332
- case "mo": {
333
- const day = d.getDate();
334
- d.setMonth(d.getMonth() + value);
335
- if (d.getDate() !== day) {
336
- d.setDate(0);
337
- }
338
- break;
339
- }
340
- case "y": {
341
- d.getDate();
342
- const month = d.getMonth();
343
- d.setFullYear(d.getFullYear() + value);
344
- if (d.getMonth() !== month) {
345
- d.setDate(0);
346
- }
347
- break;
348
- }
349
- }
350
- return d;
351
- }
352
- /**
353
- * Subtracts a given amount of time from a date and returns a new `Date`.
354
- *
355
- * This is a convenience wrapper around {@link add} with a negated `value`.
356
- *
357
- * @param date - The starting date.
358
- * @param value - The amount to subtract (must be positive).
359
- * @param unit - The time unit (same options as {@link add}).
360
- * @returns A new `Date` shifted back by the specified amount.
361
- *
362
- * @example
363
- * ```ts
364
- * du.subtract(new Date("2026-03-01"), 1, "mo");
365
- * // → Date("2026-02-01")
366
- * ```
367
- */
368
- subtract(date, value, unit) {
369
- return this.add(date, -value, unit);
370
- }
371
- // ─────────────────────────────────────────────
372
- // Difference & comparison
373
- // ─────────────────────────────────────────────
374
- /**
375
- * Returns the difference between two dates in the specified unit.
376
- *
377
- * The result is the **signed** difference `(dateA - dateB)` truncated
378
- * toward zero. A positive value means `dateA` is later than `dateB`.
379
- *
380
- * Supported units: `"ms"`, `"s"`, `"m"`, `"h"`, `"d"`, `"w"`.
381
- * Month and year differences are intentionally excluded because their
382
- * variable length makes a lossless inverse impossible; use {@link add}
383
- * and calendar-aware logic for those cases.
384
- *
385
- * @param dateA - The first date.
386
- * @param dateB - The second date.
387
- * @param unit - The unit for the result (default: `"ms"`).
388
- * @returns The signed integer difference in the requested unit.
389
- *
390
- * @example
391
- * ```ts
392
- * du.diff("2026-04-20", "2026-04-15", "d"); // → 5
393
- * du.diff("2026-04-10", "2026-04-15", "d"); // → -5
394
- * du.diff(Date.now(), Date.now() - 3600_000, "h"); // → 1
395
- * ```
396
- */
397
- diff(dateA, dateB, unit = "ms") {
398
- const delta = this.toMs(dateA) - this.toMs(dateB);
399
- const divisors = {
400
- ms: 1,
401
- s: 1000,
402
- m: 60000,
403
- h: 3600000,
404
- d: 86400000,
405
- w: 604800000,
406
- };
407
- return Math.trunc(delta / divisors[unit]);
408
- }
409
- /**
410
- * Returns `true` if `dateA` is strictly before `dateB`.
411
- *
412
- * @param dateA - The first date.
413
- * @param dateB - The second date.
414
- * @returns `true` if `dateA < dateB`.
415
- *
416
- * @example
417
- * ```ts
418
- * du.isBefore("2026-01-01", "2026-06-01"); // → true
419
- * ```
420
- */
421
- isBefore(dateA, dateB) {
422
- return this.toMs(dateA) < this.toMs(dateB);
423
- }
424
- /**
425
- * Returns `true` if `dateA` is strictly after `dateB`.
426
- *
427
- * @param dateA - The first date.
428
- * @param dateB - The second date.
429
- * @returns `true` if `dateA > dateB`.
430
- *
431
- * @example
432
- * ```ts
433
- * du.isAfter("2026-12-31", "2026-06-01"); // → true
434
- * ```
435
- */
436
- isAfter(dateA, dateB) {
437
- return this.toMs(dateA) > this.toMs(dateB);
438
- }
439
- /**
440
- * Returns `true` if two dates represent the same instant in time.
441
- *
442
- * Comparison is performed at millisecond precision.
443
- *
444
- * @param dateA - The first date.
445
- * @param dateB - The second date.
446
- * @returns `true` if both dates resolve to the same millisecond.
447
- *
448
- * @example
449
- * ```ts
450
- * du.isSame(new Date("2026-04-15"), 1776268800000); // → true (if same instant)
451
- * ```
452
- */
453
- isSame(dateA, dateB) {
454
- return this.toMs(dateA) === this.toMs(dateB);
455
- }
456
- /**
457
- * Returns `true` if `date` falls within the range `[start, end]` (inclusive).
458
- *
459
- * @param date - The date to test.
460
- * @param start - The start of the range.
461
- * @param end - The end of the range.
462
- * @returns `true` if `start ≤ date ≤ end`.
463
- *
464
- * @example
465
- * ```ts
466
- * du.isBetween("2026-04-15", "2026-01-01", "2026-12-31"); // → true
467
- * du.isBetween("2025-12-31", "2026-01-01", "2026-12-31"); // → false
468
- * ```
469
- */
470
- isBetween(date, start, end) {
471
- const ms = this.toMs(date);
472
- return ms >= this.toMs(start) && ms <= this.toMs(end);
473
- }
474
- // ─────────────────────────────────────────────
475
- // Boundary helpers
476
- // ─────────────────────────────────────────────
477
- /**
478
- * Returns a new `Date` set to the **start** of the specified unit
479
- * (i.e., all smaller components zeroed out).
480
- *
481
- * Supported units: `"day"`, `"week"` (Monday = start), `"month"`, `"year"`.
482
- *
483
- * @param unit - The boundary unit.
484
- * @param date - The reference date (default: current time).
485
- * @returns A new `Date` at the beginning of the unit.
486
- *
487
- * @example
488
- * ```ts
489
- * du.startOf("day");
490
- * // → 2026-04-15T00:00:00.000 (local)
491
- *
492
- * du.startOf("month", new Date("2026-04-15"));
493
- * // → 2026-04-01T00:00:00.000
494
- *
495
- * du.startOf("year", "2026-06-15");
496
- * // → 2026-01-01T00:00:00.000
497
- * ```
498
- */
499
- startOf(unit, date = new Date()) {
500
- const d = new Date(this.toMs(date));
501
- switch (unit) {
502
- case "day":
503
- d.setHours(0, 0, 0, 0);
504
- break;
505
- case "week": {
506
- const day = d.getDay(); // 0 = Sunday
507
- const diff = day === 0 ? -6 : 1 - day; // shift to Monday
508
- d.setDate(d.getDate() + diff);
509
- d.setHours(0, 0, 0, 0);
510
- break;
511
- }
512
- case "month":
513
- d.setDate(1);
514
- d.setHours(0, 0, 0, 0);
515
- break;
516
- case "year":
517
- d.setMonth(0, 1);
518
- d.setHours(0, 0, 0, 0);
519
- break;
520
- }
521
- return d;
522
- }
523
- /**
524
- * Returns a new `Date` set to the **end** of the specified unit
525
- * (i.e., the last millisecond of that unit).
526
- *
527
- * Supported units: `"day"`, `"week"` (Sunday = end), `"month"`, `"year"`.
528
- *
529
- * @param unit - The boundary unit.
530
- * @param date - The reference date (default: current time).
531
- * @returns A new `Date` at the very last millisecond of the unit.
532
- *
533
- * @example
534
- * ```ts
535
- * du.endOf("month", new Date("2026-02-01"));
536
- * // → 2026-02-28T23:59:59.999
537
- *
538
- * du.endOf("year", "2026-01-01");
539
- * // → 2026-12-31T23:59:59.999
540
- * ```
541
- */
542
- endOf(unit, date = new Date()) {
543
- const d = new Date(this.toMs(date));
544
- switch (unit) {
545
- case "day":
546
- d.setHours(23, 59, 59, 999);
547
- break;
548
- case "week": {
549
- const day = d.getDay();
550
- const diff = day === 0 ? 0 : 7 - day; // shift to next Sunday
551
- d.setDate(d.getDate() + diff);
552
- d.setHours(23, 59, 59, 999);
553
- break;
554
- }
555
- case "month":
556
- d.setMonth(d.getMonth() + 1, 0); // day 0 of next month = last day of current
557
- d.setHours(23, 59, 59, 999);
558
- break;
559
- case "year":
560
- d.setMonth(11, 31);
561
- d.setHours(23, 59, 59, 999);
562
- break;
563
- }
564
- return d;
565
- }
566
- // ─────────────────────────────────────────────
567
- // Calendar queries
568
- // ─────────────────────────────────────────────
569
- /**
570
- * Returns `true` if the given year is a leap year.
571
- *
572
- * A year is a leap year if it is divisible by 4, except for century years,
573
- * which must also be divisible by 400.
574
- *
575
- * @param year - The four-digit year to test (default: current year).
576
- * @returns `true` if the year is a leap year.
577
- *
578
- * @example
579
- * ```ts
580
- * du.isLeapYear(2024); // → true
581
- * du.isLeapYear(2100); // → false
582
- * du.isLeapYear(2000); // → true
583
- * ```
584
- */
585
- isLeapYear(year = new Date().getFullYear()) {
586
- return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
587
- }
588
- /**
589
- * Returns the number of days in a given month of a given year.
590
- *
591
- * Correctly accounts for leap years when querying February.
592
- *
593
- * @param month - The 1-based month index (1 = January, 12 = December).
594
- * @param year - The four-digit year (default: current year).
595
- * @returns The number of days in the specified month (28–31).
596
- *
597
- * @example
598
- * ```ts
599
- * du.daysInMonth(2, 2024); // → 29 (leap year)
600
- * du.daysInMonth(2, 2023); // → 28
601
- * du.daysInMonth(1, 2026); // → 31
602
- * ```
603
- */
604
- daysInMonth(month, year = new Date().getFullYear()) {
605
- // Day 0 of the next month equals the last day of the given month.
606
- return new Date(year, month, 0).getDate();
607
- }
608
- /**
609
- * Returns the ISO 8601 week number (1–53) for a given date.
610
- *
611
- * ISO 8601 defines Week 1 as the week containing the year's first Thursday.
612
- * Weeks run Monday–Sunday. A date in early January may belong to the
613
- * final week of the previous year (e.g., January 1, 2016 → Week 53 of 2015).
614
- *
615
- * @param date - The reference date (default: current time).
616
- * @returns The ISO week number.
617
- *
618
- * @example
619
- * ```ts
620
- * du.weekNumber(new Date("2026-01-01")); // → 1
621
- * du.weekNumber(new Date("2016-01-03")); // → 53 (belongs to 2015)
622
- * ```
623
- */
624
- weekNumber(date = new Date()) {
625
- const d = new Date(this.toMs(date));
626
- // Set to nearest Thursday: current date + 4 - current day number (Mon=1 .. Sun=7)
627
- d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
628
- const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
629
- return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
630
- }
631
- /**
632
- * Returns the day of the year (1–366) for a given date.
633
- *
634
- * @param date - The reference date (default: current time).
635
- * @returns An integer from 1 to 366.
636
- *
637
- * @example
638
- * ```ts
639
- * du.dayOfYear(new Date("2026-02-01")); // → 32
640
- * du.dayOfYear(new Date("2026-12-31")); // → 365
641
- * ```
642
- */
643
- dayOfYear(date = new Date()) {
644
- const d = this.toDate(date);
645
- const start = new Date(d.getFullYear(), 0, 0);
646
- const diff = d.getTime() - start.getTime();
647
- return Math.floor(diff / 86400000);
648
- }
649
- /**
650
- * Returns the ISO 8601 quarter (1–4) in which the given date falls.
651
- *
652
- * @param date - The reference date (default: current time).
653
- * @returns A quarter number: `1`, `2`, `3`, or `4`.
654
- *
655
- * @example
656
- * ```ts
657
- * du.quarter(new Date("2026-04-15")); // → 2 (Apr–Jun)
658
- * du.quarter(new Date("2026-11-01")); // → 4 (Oct–Dec)
659
- * ```
660
- */
661
- quarter(date = new Date()) {
662
- return (Math.floor(this.toDate(date).getMonth() / 3) + 1);
663
- }
664
- /**
665
- * Returns `true` if the given date falls on a weekend (Saturday or Sunday).
666
- *
667
- * The check uses **local time**.
668
- *
669
- * @param date - The date to check (default: current time).
670
- * @returns `true` if the date is a Saturday or Sunday.
671
- *
672
- * @example
673
- * ```ts
674
- * du.isWeekend(new Date("2026-04-18")); // → true (Saturday)
675
- * du.isWeekend(new Date("2026-04-15")); // → false (Wednesday)
676
- * ```
677
- */
678
- isWeekend(date = new Date()) {
679
- const day = this.toDate(date).getDay();
680
- return day === 0 || day === 6;
681
- }
682
- /**
683
- * Returns `true` if the given date falls on a weekday (Monday–Friday).
684
- *
685
- * @param date - The date to check (default: current time).
686
- * @returns `true` if the date is Monday through Friday.
687
- *
688
- * @example
689
- * ```ts
690
- * du.isWeekday(new Date("2026-04-15")); // → true
691
- * du.isWeekday(new Date("2026-04-19")); // → false (Sunday)
692
- * ```
693
- */
694
- isWeekday(date = new Date()) {
695
- return !this.isWeekend(date);
696
- }
697
- /**
698
- * Returns `true` if two dates fall on the same calendar day (in local time).
699
- *
700
- * Only the year, month, and date components are compared; time is ignored.
701
- *
702
- * @param dateA - The first date.
703
- * @param dateB - The second date.
704
- * @returns `true` if both dates share the same year, month, and day.
705
- *
706
- * @example
707
- * ```ts
708
- * du.isSameDay("2026-04-15T08:00:00", "2026-04-15T22:00:00"); // → true
709
- * du.isSameDay("2026-04-15", "2026-04-16"); // → false
710
- * ```
711
- */
712
- isSameDay(dateA, dateB) {
713
- const a = this.toDate(dateA);
714
- const b = this.toDate(dateB);
715
- return (a.getFullYear() === b.getFullYear() &&
716
- a.getMonth() === b.getMonth() &&
717
- a.getDate() === b.getDate());
718
- }
719
- /**
720
- * Returns `true` if the given date is today (in local time).
721
- *
722
- * @param date - The date to test.
723
- * @returns `true` if `date` falls on the current calendar day.
724
- *
725
- * @example
726
- * ```ts
727
- * du.isToday(new Date()); // → true
728
- * du.isToday("2020-01-01"); // → false
729
- * ```
730
- */
731
- isToday(date) {
732
- return this.isSameDay(date, new Date());
733
- }
734
- /**
735
- * Returns `true` if the given date is in the past (before the current instant).
736
- *
737
- * @param date - The date to check.
738
- * @returns `true` if `date` is strictly before `Date.now()`.
739
- *
740
- * @example
741
- * ```ts
742
- * du.isPast("2020-01-01"); // → true
743
- * du.isPast(Date.now() + 1000); // → false
744
- * ```
745
- */
746
- isPast(date) {
747
- return this.toMs(date) < Date.now();
748
- }
749
- /**
750
- * Returns `true` if the given date is in the future (after the current instant).
751
- *
752
- * @param date - The date to check.
753
- * @returns `true` if `date` is strictly after `Date.now()`.
754
- *
755
- * @example
756
- * ```ts
757
- * du.isFuture(Date.now() + 5000); // → true
758
- * du.isFuture("2020-01-01"); // → false
759
- * ```
760
- */
761
- isFuture(date) {
762
- return this.toMs(date) > Date.now();
763
- }
764
- // ─────────────────────────────────────────────
765
- // Clamp & range utilities
766
- // ─────────────────────────────────────────────
767
- /**
768
- * Clamps a date to a `[min, max]` range.
769
- *
770
- * If `date` is before `min`, `min` is returned.
771
- * If `date` is after `max`, `max` is returned.
772
- * Otherwise, `date` is returned unchanged (as a new `Date`).
773
- *
774
- * @param date - The date to clamp.
775
- * @param min - The lower bound.
776
- * @param max - The upper bound.
777
- * @returns A new `Date` clamped within `[min, max]`.
778
- *
779
- * @example
780
- * ```ts
781
- * du.clamp("2025-01-01", "2026-01-01", "2026-12-31");
782
- * // → Date("2026-01-01") — clamped to min
783
- *
784
- * du.clamp("2026-06-15", "2026-01-01", "2026-12-31");
785
- * // → Date("2026-06-15") — within range, unchanged
786
- * ```
787
- */
788
- clamp(date, min, max) {
789
- const ms = Math.min(Math.max(this.toMs(date), this.toMs(min)), this.toMs(max));
790
- return new Date(ms);
791
- }
792
- /**
793
- * Generates an array of `Date` objects representing each day in the range
794
- * `[start, end]`, inclusive.
795
- *
796
- * The range is capped at **3 650 days** (~10 years) to prevent accidental
797
- * allocation of enormous arrays.
798
- *
799
- * @param start - The first day of the range.
800
- * @param end - The last day of the range.
801
- * @returns An ordered array of `Date` objects, one per day.
802
- * @throws {RangeError} If the range exceeds 3 650 days.
803
- *
804
- * @example
805
- * ```ts
806
- * du.dateRange("2026-04-13", "2026-04-15");
807
- * // → [Date("2026-04-13"), Date("2026-04-14"), Date("2026-04-15")]
808
- * ```
809
- */
810
- dateRange(start, end) {
811
- const startMs = this.toMs(this.startOf("day", start));
812
- const endMs = this.toMs(this.startOf("day", end));
813
- const days = Math.round((endMs - startMs) / 86400000);
814
- if (days < 0)
815
- return [];
816
- if (days > 3650) {
817
- throw new RangeError(`DateUtils.dateRange: range of ${days} days exceeds the 3,650-day limit.`);
818
- }
819
- return Array.from({ length: days + 1 }, (_, i) => new Date(startMs + i * 86400000));
820
- }
821
- // ─────────────────────────────────────────────
822
- // Validation & parsing
823
- // ─────────────────────────────────────────────
824
- /**
825
- * Returns `true` if the given value can be successfully interpreted
826
- * as a valid, finite date.
827
- *
828
- * Accepts `Date`, `number`, and `string` inputs. A `Date` whose
829
- * `getTime()` returns `NaN` is considered invalid.
830
- *
831
- * @param value - The value to validate.
832
- * @returns `true` if the value represents a valid date.
833
- *
834
- * @example
835
- * ```ts
836
- * du.isValid(new Date()); // → true
837
- * du.isValid("2026-04-15"); // → true
838
- * du.isValid("not-a-date"); // → false
839
- * du.isValid(new Date("invalid")); // → false
840
- * du.isValid(NaN); // → false
841
- * ```
842
- */
843
- isValid(value) {
844
- try {
845
- if (typeof value !== "string" &&
846
- typeof value !== "number" &&
847
- !(value instanceof Date)) {
848
- return false;
849
- }
850
- const d = this.toDate(value);
851
- return !isNaN(d.getTime());
852
- }
853
- catch {
854
- return false;
855
- }
856
- }
857
- /**
858
- * Parses a date string using an ordered list of format patterns and returns
859
- * the first successfully parsed `Date`, or `null` if none match.
860
- *
861
- * Supported format tokens:
862
- * - `YYYY` — 4-digit year
863
- * - `MM` — 2-digit month (01–12)
864
- * - `DD` — 2-digit day (01–31)
865
- * - `HH` — 2-digit hours (00–23)
866
- * - `mm` — 2-digit minutes (00–59)
867
- * - `ss` — 2-digit seconds (00–59)
868
- *
869
- * @param value - The date string to parse.
870
- * @param formats - An ordered list of format strings to attempt.
871
- * @returns The first successfully parsed `Date`, or `null`.
872
- *
873
- * @example
874
- * ```ts
875
- * du.parse("15/04/2026", ["DD/MM/YYYY"]);
876
- * // → Date("2026-04-15")
877
- *
878
- * du.parse("2026-04-15 08:30:00", ["YYYY-MM-DD HH:mm:ss"]);
879
- * // → Date("2026-04-15T08:30:00")
880
- *
881
- * du.parse("bad-input", ["YYYY-MM-DD"]);
882
- * // → null
883
- * ```
884
- */
885
- parse(value, formats) {
886
- for (const fmt of formats) {
887
- let regexStr = fmt
888
- .replace("YYYY", "(?<YYYY>\\d{4})")
889
- .replace("MM", "(?<MM>\\d{2})")
890
- .replace("DD", "(?<DD>\\d{2})")
891
- .replace("HH", "(?<HH>\\d{2})")
892
- .replace("mm", "(?<mm>\\d{2})")
893
- .replace("ss", "(?<ss>\\d{2})");
894
- const match = new RegExp(`^${regexStr}$`).exec(value);
895
- if (!match?.groups)
896
- continue;
897
- const g = match.groups;
898
- const year = parseInt(g.YYYY ?? "1970", 10);
899
- const month = parseInt(g.MM ?? "1", 10) - 1;
900
- const day = parseInt(g.DD ?? "1", 10);
901
- const hour = parseInt(g.HH ?? "0", 10);
902
- const minute = parseInt(g.mm ?? "0", 10);
903
- const second = parseInt(g.ss ?? "0", 10);
904
- const d = new Date(year, month, day, hour, minute, second);
905
- if (!isNaN(d.getTime()))
906
- return d;
907
- }
908
- return null;
909
- }
910
- /**
911
- * Parses a human-readable duration shorthand (e.g. `"7d"`, `"3M"`, `"2h 30m"`, `"1y"`, `"-5d"`)
912
- * and converts it to a future or past JavaScript `Date` object relative to `baseDate` (default: `now`).
913
- *
914
- * Also parses standard natural language relative strings such as `"today"`, `"yesterday"`,
915
- * `"tomorrow"`, `"now"`, or compound tokens (e.g. `"7d 12h"`).
916
- *
917
- * Supported shorthand units:
918
- * - `ms` / `millis` / `milliseconds`
919
- * - `s` / `sec` / `seconds`
920
- * - `m` / `min` / `minutes`
921
- * - `h` / `hr` / `hours`
922
- * - `d` / `day` / `days`
923
- * - `w` / `wk` / `weeks`
924
- * - `M` / `mo` / `month` / `months` (Note: uppercase `M` or `mo` is month; lowercase `m` is minute)
925
- * - `y` / `yr` / `year` / `years`
926
- *
927
- * @param expression - The natural date or duration expression (e.g. `"7d"`, `"3M"`, `"+2w"`, `"-1d"`, `"tomorrow"`).
928
- * @param baseDate - The reference starting point (default: current instant `new Date()`).
929
- * @returns A JavaScript `Date` object matching the target time.
930
- * @throws {RangeError} If the expression cannot be parsed or contains invalid units.
931
- *
932
- * @example
933
- * ```ts
934
- * du.from("7d"); // Date 7 days in the future
935
- * du.from("3M"); // Date 3 months in the future
936
- * du.from("-2h"); // Date 2 hours in the past
937
- * du.from("1w 2d"); // Date 9 days in the future
938
- * du.from("tomorrow"); // Tomorrow at current time
939
- * du.from("7d", "2026-01-01"); // Date("2026-01-08")
940
- * ```
941
- */
942
- from(expression, baseDate = new Date()) {
943
- if (!expression || typeof expression !== "string") {
944
- throw new RangeError(`DateUtils.from: invalid expression provided — "${expression}"`);
945
- }
946
- const trimmed = expression.trim();
947
- if (trimmed.length === 0) {
948
- throw new RangeError("DateUtils.from: expression cannot be empty");
949
- }
950
- const lower = trimmed.toLowerCase();
951
- // 1. Natural keywords
952
- if (lower === "now")
953
- return new Date(baseDate instanceof Date ? baseDate.getTime() : (typeof baseDate === "number" || typeof baseDate === "string" ? new Date(baseDate).getTime() : Date.now()));
954
- if (lower === "today")
955
- return new Date(baseDate instanceof Date ? baseDate.getTime() : (typeof baseDate === "number" || typeof baseDate === "string" ? new Date(baseDate).getTime() : Date.now()));
956
- if (lower === "yesterday")
957
- return this.add(baseDate, -1, "d");
958
- if (lower === "tomorrow")
959
- return this.add(baseDate, 1, "d");
960
- // 2. Tokenize compound shorthand like "1y 2M 3w 4d 5h 6m 7s" or "+7d" or "-3M"
961
- const tokenRegex = /([+-]?\s*\d+(?:\.\d+)?)\s*([a-zA-Z]+)/g;
962
- let match;
963
- let matchedAny = false;
964
- let d = new Date(baseDate instanceof Date ? baseDate.getTime() : (typeof baseDate === "number" || typeof baseDate === "string" ? new Date(baseDate).getTime() : Date.now()));
965
- if (isNaN(d.getTime()))
966
- d = new Date();
967
- let matchedLength = 0;
968
- const normalized = trimmed.replace(/\s+/g, " ");
969
- while ((match = tokenRegex.exec(normalized)) !== null) {
970
- matchedAny = true;
971
- matchedLength += match[0].length;
972
- const rawVal = match[1].replace(/\s+/g, "");
973
- const num = parseFloat(rawVal);
974
- const rawUnit = match[2];
975
- if (isNaN(num)) {
976
- throw new RangeError(`DateUtils.from: invalid numeric value in expression "${expression}"`);
977
- }
978
- // Determine unit
979
- if (rawUnit === "M" || rawUnit.toLowerCase() === "mo" || rawUnit.toLowerCase() === "month" || rawUnit.toLowerCase() === "months") {
980
- d = this.add(d, num, "mo");
981
- }
982
- else {
983
- const u = rawUnit.toLowerCase();
984
- if (u === "y" || u === "yr" || u === "year" || u === "years") {
985
- d = this.add(d, num, "y");
986
- }
987
- else if (u === "w" || u === "wk" || u === "week" || u === "weeks") {
988
- d = this.add(d, num, "w");
989
- }
990
- else if (u === "d" || u === "day" || u === "days") {
991
- d = this.add(d, num, "d");
992
- }
993
- else if (u === "h" || u === "hr" || u === "hour" || u === "hours") {
994
- d = this.add(d, num, "h");
995
- }
996
- else if (u === "m" || u === "min" || u === "minute" || u === "minutes") {
997
- d = this.add(d, num, "m");
998
- }
999
- else if (u === "s" || u === "sec" || u === "second" || u === "seconds") {
1000
- d = this.add(d, num, "s");
1001
- }
1002
- else if (u === "ms" || u === "milli" || u === "millis" || u === "millisecond" || u === "milliseconds") {
1003
- d = this.add(d, num, "ms");
1004
- }
1005
- else {
1006
- throw new RangeError(`DateUtils.from: unrecognized unit "${rawUnit}" in expression "${expression}"`);
1007
- }
1008
- }
1009
- }
1010
- // Validate that the entire string was consumed (excluding spaces)
1011
- const unspaced = normalized.replace(/\s+/g, "");
1012
- const matchedUnspaced = normalized.match(tokenRegex)?.join("").replace(/\s+/g, "") || "";
1013
- if (!matchedAny || unspaced !== matchedUnspaced) {
1014
- throw new RangeError(`DateUtils.from: unable to parse date expression "${expression}"`);
1015
- }
1016
- return d;
1017
- }
1018
- /**
1019
- * Parses a duration shorthand string (e.g. `"7d"`, `"3M"`, `"2h"`, `"500ms"`)
1020
- * into a total number of milliseconds.
1021
- *
1022
- * Note: 1 month (`"1M"`) is approximated as 30 days (2,592,000,000 ms), and
1023
- * 1 year (`"1y"`) is approximated as 365 days (31,536,000,000 ms). For calendar-exact
1024
- * arithmetic taking into account specific months and leap years, use {@link from} or {@link add}.
1025
- *
1026
- * @param duration - The duration shorthand string.
1027
- * @returns Total milliseconds as a number.
1028
- * @throws {RangeError} If the duration string is invalid or contains unknown units.
1029
- *
1030
- * @example
1031
- * ```ts
1032
- * du.parseDuration("7d"); // → 604800000 (7 * 24 * 3600 * 1000)
1033
- * du.parseDuration("2h 30m"); // → 9000000
1034
- * du.parseDuration("10s"); // → 10000
1035
- * ```
1036
- */
1037
- parseDuration(duration) {
1038
- if (!duration || typeof duration !== "string") {
1039
- throw new RangeError(`DateUtils.parseDuration: invalid duration provided — "${duration}"`);
1040
- }
1041
- const tokenRegex = /([+-]?\s*\d+(?:\.\d+)?)\s*([a-zA-Z]+)/g;
1042
- let match;
1043
- let totalMs = 0;
1044
- let matchedAny = false;
1045
- const normalized = duration.trim().replace(/\s+/g, " ");
1046
- while ((match = tokenRegex.exec(normalized)) !== null) {
1047
- matchedAny = true;
1048
- const rawVal = match[1].replace(/\s+/g, "");
1049
- const num = parseFloat(rawVal);
1050
- const rawUnit = match[2];
1051
- if (isNaN(num)) {
1052
- throw new RangeError(`DateUtils.parseDuration: invalid numeric value in duration "${duration}"`);
1053
- }
1054
- if (rawUnit === "M" || rawUnit.toLowerCase() === "mo" || rawUnit.toLowerCase() === "month" || rawUnit.toLowerCase() === "months") {
1055
- totalMs += num * 30 * 24 * 3600 * 1000;
1056
- }
1057
- else {
1058
- const u = rawUnit.toLowerCase();
1059
- if (u === "y" || u === "yr" || u === "year" || u === "years") {
1060
- totalMs += num * 365 * 24 * 3600 * 1000;
1061
- }
1062
- else if (u === "w" || u === "wk" || u === "week" || u === "weeks") {
1063
- totalMs += num * 7 * 24 * 3600 * 1000;
1064
- }
1065
- else if (u === "d" || u === "day" || u === "days") {
1066
- totalMs += num * 24 * 3600 * 1000;
1067
- }
1068
- else if (u === "h" || u === "hr" || u === "hour" || u === "hours") {
1069
- totalMs += num * 3600 * 1000;
1070
- }
1071
- else if (u === "m" || u === "min" || u === "minute" || u === "minutes") {
1072
- totalMs += num * 60 * 1000;
1073
- }
1074
- else if (u === "s" || u === "sec" || u === "second" || u === "seconds") {
1075
- totalMs += num * 1000;
1076
- }
1077
- else if (u === "ms" || u === "milli" || u === "millis" || u === "millisecond" || u === "milliseconds") {
1078
- totalMs += num;
1079
- }
1080
- else {
1081
- throw new RangeError(`DateUtils.parseDuration: unrecognized unit "${rawUnit}" in duration "${duration}"`);
1082
- }
1083
- }
1084
- }
1085
- const unspaced = normalized.replace(/\s+/g, "");
1086
- const matchedUnspaced = normalized.match(tokenRegex)?.join("").replace(/\s+/g, "") || "";
1087
- if (!matchedAny || unspaced !== matchedUnspaced) {
1088
- throw new RangeError(`DateUtils.parseDuration: unable to parse duration expression "${duration}"`);
1089
- }
1090
- return totalMs;
1091
- }
1092
- // ─────────────────────────────────────────────
1093
- // Timezone utilities
1094
- // ─────────────────────────────────────────────
1095
- /**
1096
- * Returns the UTC offset of the local environment in minutes.
1097
- *
1098
- * Positive values indicate zones **behind** UTC (e.g., UTC-5 → `300`),
1099
- * mirroring the behaviour of `Date.prototype.getTimezoneOffset()`.
1100
- *
1101
- * @returns The UTC offset in minutes.
1102
- *
1103
- * @example
1104
- * ```ts
1105
- * du.timezoneOffset(); // → -120 for UTC+2, 300 for UTC-5
1106
- * ```
1107
- */
1108
- timezoneOffset() {
1109
- return new Date().getTimezoneOffset();
1110
- }
1111
- /**
1112
- * Formats a date in a specific IANA timezone using `Intl.DateTimeFormat`.
1113
- *
1114
- * Requires the runtime to support the `timeZone` option (all modern
1115
- * environments do).
1116
- *
1117
- * @param date - The date to format.
1118
- * @param timeZone - A valid IANA timezone identifier (e.g., `"America/New_York"`).
1119
- * @param locale - BCP 47 locale tag (default: `"en-US"`).
1120
- * @param options - Additional `Intl.DateTimeFormatOptions`.
1121
- * @returns A localized date string in the given timezone.
1122
- *
1123
- * @example
1124
- * ```ts
1125
- * du.formatInTimezone(Date.now(), "Asia/Tokyo", "ja-JP", { dateStyle: "full", timeStyle: "short" });
1126
- * // → "2026年4月15日水曜日 19:00"
1127
- * ```
1128
- */
1129
- formatInTimezone(date, timeZone, locale = "en-US", options) {
1130
- return new Intl.DateTimeFormat(locale, { ...options, timeZone }).format(this.toDate(date));
1131
- }
1132
- }
1133
-
1134
- exports.DateUtils = DateUtils;
1135
- //# sourceMappingURL=DateUtils.js.map