@zudojs/errors 0.1.1 → 1.0.1

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 (506) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +29 -8
  3. package/dist/base/core/baseError.core.d.ts +25 -2
  4. package/dist/base/core/baseError.core.js +95 -23
  5. package/dist/base/core/errorMetadata.core.d.ts +62 -5
  6. package/dist/base/core/errorMetadata.core.js +292 -23
  7. package/dist/base/types/errorCategory.helpers.js +3 -2
  8. package/dist/base/types/errorCode.type.d.ts +70 -1
  9. package/dist/base/types/errorCode.type.js +78 -2
  10. package/dist/base/types/errorSeverity.type.js +3 -2
  11. package/dist/base/utils/baseError.utils.d.ts +18 -2
  12. package/dist/base/utils/baseError.utils.js +68 -17
  13. package/dist/domain/access/rateLimit.error.d.ts +6 -1
  14. package/dist/domain/access/rateLimit.error.js +7 -9
  15. package/dist/domain/api/apiError.base.js +2 -2
  16. package/dist/domain/api/apiError.lifecycle.d.ts +10 -1
  17. package/dist/domain/api/apiError.lifecycle.js +22 -7
  18. package/dist/domain/api/apiError.routing.js +4 -4
  19. package/dist/domain/app/domain.error.d.ts +2 -0
  20. package/dist/domain/app/domain.error.js +3 -1
  21. package/dist/domain/app/lifecycleError.types.js +2 -8
  22. package/dist/domain/app/moduleError.types.d.ts +3 -0
  23. package/dist/domain/app/moduleError.types.js +6 -2
  24. package/dist/domain/body/bodyParser.error.d.ts +9 -2
  25. package/dist/domain/body/bodyParser.error.js +20 -12
  26. package/dist/domain/body/httpBodyError.base.js +1 -2
  27. package/dist/domain/body/httpBodyError.types.js +1 -3
  28. package/dist/domain/body/httpFormData.error.js +2 -4
  29. package/dist/domain/body/multipart.error.js +2 -4
  30. package/dist/domain/documentation/documentationError.base.js +4 -2
  31. package/dist/domain/documentation/documentationError.types.js +1 -11
  32. package/dist/domain/documentation/index.d.ts +1 -1
  33. package/dist/domain/documentation/index.js +1 -1
  34. package/dist/domain/event/event.error.d.ts +1 -1
  35. package/dist/domain/event/event.error.js +1 -1
  36. package/dist/domain/event/eventError.base.d.ts +4 -1
  37. package/dist/domain/event/eventError.base.js +7 -9
  38. package/dist/domain/event/eventError.handler.d.ts +12 -3
  39. package/dist/domain/event/eventError.handler.js +21 -11
  40. package/dist/domain/event/eventError.lifecycle.d.ts +20 -3
  41. package/dist/domain/event/eventError.lifecycle.js +48 -18
  42. package/dist/domain/event/eventError.serialization.d.ts +10 -2
  43. package/dist/domain/event/eventError.serialization.js +16 -4
  44. package/dist/domain/message/message.error.d.ts +1 -0
  45. package/dist/domain/message/message.error.js +1 -0
  46. package/dist/domain/message/messageError.base.d.ts +4 -1
  47. package/dist/domain/message/messageError.base.js +7 -9
  48. package/dist/domain/message/messageError.handler.d.ts +12 -3
  49. package/dist/domain/message/messageError.handler.js +22 -12
  50. package/dist/domain/message/messageError.lifecycle.d.ts +5 -1
  51. package/dist/domain/message/messageError.lifecycle.js +15 -8
  52. package/dist/domain/message/messageError.serialization.d.ts +26 -0
  53. package/dist/domain/message/messageError.serialization.js +35 -0
  54. package/dist/domain/plugin/pluginError.lifecycle.js +23 -21
  55. package/dist/domain/plugin/pluginError.runtime.d.ts +5 -1
  56. package/dist/domain/plugin/pluginError.runtime.js +12 -7
  57. package/dist/domain/queue/queueError.base.d.ts +19 -0
  58. package/dist/domain/queue/queueError.base.js +24 -4
  59. package/dist/domain/queue/queueError.job.js +2 -0
  60. package/dist/domain/queue/queueError.worker.d.ts +9 -3
  61. package/dist/domain/queue/queueError.worker.js +14 -6
  62. package/dist/domain/rpc/rpcError.base.js +0 -2
  63. package/dist/domain/rpc/rpcError.protocol.js +0 -7
  64. package/dist/domain/rpc/rpcError.transport.d.ts +10 -1
  65. package/dist/domain/rpc/rpcError.transport.js +19 -9
  66. package/dist/domain/scheduler/schedulerError.base.d.ts +17 -3
  67. package/dist/domain/scheduler/schedulerError.base.js +26 -15
  68. package/dist/domain/scheduler/schedulerError.execution.d.ts +7 -6
  69. package/dist/domain/scheduler/schedulerError.execution.js +22 -18
  70. package/dist/domain/scheduler/schedulerError.schedule.d.ts +15 -5
  71. package/dist/domain/scheduler/schedulerError.schedule.js +32 -14
  72. package/dist/domain/schema/index.d.ts +2 -1
  73. package/dist/domain/schema/index.js +1 -1
  74. package/dist/domain/schema/schemaError.base.d.ts +31 -5
  75. package/dist/domain/schema/schemaError.base.js +34 -6
  76. package/dist/domain/schema/schemaError.types.js +12 -5
  77. package/dist/domain/serialization/serializationError.base.d.ts +8 -2
  78. package/dist/domain/serialization/serializationError.base.js +38 -8
  79. package/dist/domain/serialization/serializationError.types.d.ts +22 -3
  80. package/dist/domain/serialization/serializationError.types.js +30 -5
  81. package/dist/domain/shared/domainError.helpers.d.ts +60 -0
  82. package/dist/domain/shared/domainError.helpers.js +191 -0
  83. package/dist/domain/state/conflict.error.d.ts +1 -1
  84. package/dist/domain/state/conflict.error.js +2 -2
  85. package/dist/domain/state/validationError.base.d.ts +8 -1
  86. package/dist/domain/state/validationError.base.js +11 -2
  87. package/dist/infrastructure/adapter/adapterError.base.js +6 -6
  88. package/dist/infrastructure/adapter/adapterError.lifecycle.js +0 -3
  89. package/dist/infrastructure/adapter/adapterError.operation.js +0 -5
  90. package/dist/infrastructure/cache/cacheError.base.js +1 -1
  91. package/dist/infrastructure/container/containerError.registration.js +6 -4
  92. package/dist/infrastructure/network/httpAdapter.error.js +4 -2
  93. package/dist/infrastructure/network/httpClientError.advanced.js +10 -18
  94. package/dist/infrastructure/network/httpClientError.base.d.ts +11 -0
  95. package/dist/infrastructure/network/httpClientError.base.js +47 -7
  96. package/dist/infrastructure/network/httpClientError.common.d.ts +14 -0
  97. package/dist/infrastructure/network/httpClientError.common.js +21 -31
  98. package/dist/infrastructure/network/httpClientError.specialized.js +5 -8
  99. package/dist/infrastructure/network/httpClientError.types.d.ts +23 -2
  100. package/dist/infrastructure/network/httpClientError.types.js +55 -42
  101. package/dist/infrastructure/network/httpResponse.error.js +0 -3
  102. package/dist/infrastructure/network/httpRouterError.base.js +0 -1
  103. package/dist/infrastructure/network/httpRouterError.types.d.ts +5 -3
  104. package/dist/infrastructure/network/httpRouterError.types.js +6 -7
  105. package/dist/infrastructure/network/httpServerError.error.js +6 -10
  106. package/dist/infrastructure/network/httpServerLifecycleError.base.js +0 -1
  107. package/dist/infrastructure/network/httpServerLifecycleError.types.js +0 -3
  108. package/dist/infrastructure/network/httpStream.error.js +0 -1
  109. package/dist/infrastructure/network/network.error.d.ts +1 -1
  110. package/dist/infrastructure/network/network.error.js +1 -1
  111. package/dist/infrastructure/network/networkError.factory.d.ts +9 -2
  112. package/dist/infrastructure/network/networkError.factory.js +9 -2
  113. package/dist/infrastructure/network/routePattern.error.d.ts +7 -6
  114. package/dist/infrastructure/network/routePattern.error.js +16 -8
  115. package/dist/infrastructure/network/timeoutError.base.d.ts +7 -0
  116. package/dist/infrastructure/network/timeoutError.base.js +12 -1
  117. package/dist/infrastructure/network/timeoutError.factory.d.ts +14 -0
  118. package/dist/infrastructure/network/timeoutError.factory.js +25 -17
  119. package/dist/infrastructure/service/externalService.error.d.ts +1 -1
  120. package/dist/infrastructure/service/externalService.error.js +1 -1
  121. package/dist/infrastructure/service/externalServiceError.base.d.ts +8 -0
  122. package/dist/infrastructure/service/externalServiceError.base.js +8 -11
  123. package/dist/infrastructure/service/externalServiceError.factory.d.ts +3 -1
  124. package/dist/infrastructure/service/externalServiceError.factory.js +3 -1
  125. package/dist/infrastructure/storage/databaseError.factory.js +1 -1
  126. package/dist/infrastructure/storage/storageError.factory.js +2 -2
  127. package/dist/system/cryptoError.factory.js +5 -2
  128. package/dist/system/runtimeError.base.js +1 -1
  129. package/dist/utils/errorHandler.core.d.ts +42 -8
  130. package/dist/utils/errorHandler.core.js +116 -63
  131. package/dist/utils/errorHandler.factory.d.ts +1 -1
  132. package/dist/utils/errorHandler.factory.js +2 -2
  133. package/dist/utils/errorHandler.types.d.ts +37 -1
  134. package/dist/utils/errorMapper.core.d.ts +1 -1
  135. package/dist/utils/errorMapper.core.js +1 -1
  136. package/dist/utils/errorMapper.mappers.d.ts +27 -6
  137. package/dist/utils/errorMapper.mappers.js +57 -49
  138. package/dist/utils/errorSerializer.core.d.ts +22 -3
  139. package/dist/utils/errorSerializer.core.js +144 -39
  140. package/dist/utils/errorSerializer.factory.d.ts +1 -1
  141. package/dist/utils/errorSerializer.factory.js +2 -26
  142. package/dist/utils/errorSerializer.types.d.ts +14 -4
  143. package/dist/utils/errorUtils.extraction.js +3 -2
  144. package/dist/utils/errorUtils.transform.d.ts +1 -1
  145. package/dist/utils/errorUtils.transform.js +2 -26
  146. package/dist/utils/errorUtils.typeCheck.js +7 -7
  147. package/package.json +25 -10
  148. package/dist/.tsbuildinfo +0 -1
  149. package/dist/base/core/baseError.core.d.ts.map +0 -1
  150. package/dist/base/core/baseError.core.js.map +0 -1
  151. package/dist/base/core/errorMetadata.core.d.ts.map +0 -1
  152. package/dist/base/core/errorMetadata.core.js.map +0 -1
  153. package/dist/base/core/errorMetadata.type.d.ts.map +0 -1
  154. package/dist/base/core/errorMetadata.type.js.map +0 -1
  155. package/dist/base/core/index.d.ts.map +0 -1
  156. package/dist/base/core/index.js.map +0 -1
  157. package/dist/base/index.d.ts.map +0 -1
  158. package/dist/base/index.js.map +0 -1
  159. package/dist/base/types/baseError.type.d.ts.map +0 -1
  160. package/dist/base/types/baseError.type.js.map +0 -1
  161. package/dist/base/types/errorCategory.enum.d.ts.map +0 -1
  162. package/dist/base/types/errorCategory.enum.js.map +0 -1
  163. package/dist/base/types/errorCategory.helpers.d.ts.map +0 -1
  164. package/dist/base/types/errorCategory.helpers.js.map +0 -1
  165. package/dist/base/types/errorCategory.type.d.ts.map +0 -1
  166. package/dist/base/types/errorCategory.type.js.map +0 -1
  167. package/dist/base/types/errorCode.type.d.ts.map +0 -1
  168. package/dist/base/types/errorCode.type.js.map +0 -1
  169. package/dist/base/types/errorSeverity.type.d.ts.map +0 -1
  170. package/dist/base/types/errorSeverity.type.js.map +0 -1
  171. package/dist/base/types/index.d.ts.map +0 -1
  172. package/dist/base/types/index.js.map +0 -1
  173. package/dist/base/utils/baseError.utils.d.ts.map +0 -1
  174. package/dist/base/utils/baseError.utils.js.map +0 -1
  175. package/dist/base/utils/index.d.ts.map +0 -1
  176. package/dist/base/utils/index.js.map +0 -1
  177. package/dist/domain/access/authentication.error.d.ts.map +0 -1
  178. package/dist/domain/access/authentication.error.js.map +0 -1
  179. package/dist/domain/access/authorization.error.d.ts.map +0 -1
  180. package/dist/domain/access/authorization.error.js.map +0 -1
  181. package/dist/domain/access/index.d.ts.map +0 -1
  182. package/dist/domain/access/index.js.map +0 -1
  183. package/dist/domain/access/rateLimit.error.d.ts.map +0 -1
  184. package/dist/domain/access/rateLimit.error.js.map +0 -1
  185. package/dist/domain/api/api.error.d.ts.map +0 -1
  186. package/dist/domain/api/api.error.js.map +0 -1
  187. package/dist/domain/api/apiError.base.d.ts.map +0 -1
  188. package/dist/domain/api/apiError.base.js.map +0 -1
  189. package/dist/domain/api/apiError.lifecycle.d.ts.map +0 -1
  190. package/dist/domain/api/apiError.lifecycle.js.map +0 -1
  191. package/dist/domain/api/apiError.routing.d.ts.map +0 -1
  192. package/dist/domain/api/apiError.routing.js.map +0 -1
  193. package/dist/domain/api/index.d.ts.map +0 -1
  194. package/dist/domain/api/index.js.map +0 -1
  195. package/dist/domain/app/application.error.d.ts.map +0 -1
  196. package/dist/domain/app/application.error.js.map +0 -1
  197. package/dist/domain/app/configuration.error.d.ts.map +0 -1
  198. package/dist/domain/app/configuration.error.js.map +0 -1
  199. package/dist/domain/app/domain.error.d.ts.map +0 -1
  200. package/dist/domain/app/domain.error.js.map +0 -1
  201. package/dist/domain/app/index.d.ts.map +0 -1
  202. package/dist/domain/app/index.js.map +0 -1
  203. package/dist/domain/app/lifecycle.error.d.ts.map +0 -1
  204. package/dist/domain/app/lifecycle.error.js.map +0 -1
  205. package/dist/domain/app/lifecycleError.base.d.ts.map +0 -1
  206. package/dist/domain/app/lifecycleError.base.js.map +0 -1
  207. package/dist/domain/app/lifecycleError.types.d.ts.map +0 -1
  208. package/dist/domain/app/lifecycleError.types.js.map +0 -1
  209. package/dist/domain/app/module.error.d.ts.map +0 -1
  210. package/dist/domain/app/module.error.js.map +0 -1
  211. package/dist/domain/app/moduleError.base.d.ts.map +0 -1
  212. package/dist/domain/app/moduleError.base.js.map +0 -1
  213. package/dist/domain/app/moduleError.types.d.ts.map +0 -1
  214. package/dist/domain/app/moduleError.types.js.map +0 -1
  215. package/dist/domain/body/bodyParser.error.d.ts.map +0 -1
  216. package/dist/domain/body/bodyParser.error.js.map +0 -1
  217. package/dist/domain/body/httpBody.error.d.ts.map +0 -1
  218. package/dist/domain/body/httpBody.error.js.map +0 -1
  219. package/dist/domain/body/httpBodyError.base.d.ts.map +0 -1
  220. package/dist/domain/body/httpBodyError.base.js.map +0 -1
  221. package/dist/domain/body/httpBodyError.types.d.ts.map +0 -1
  222. package/dist/domain/body/httpBodyError.types.js.map +0 -1
  223. package/dist/domain/body/httpFormData.error.d.ts.map +0 -1
  224. package/dist/domain/body/httpFormData.error.js.map +0 -1
  225. package/dist/domain/body/index.d.ts.map +0 -1
  226. package/dist/domain/body/index.js.map +0 -1
  227. package/dist/domain/body/multipart.error.d.ts.map +0 -1
  228. package/dist/domain/body/multipart.error.js.map +0 -1
  229. package/dist/domain/documentation/documentation.error.d.ts.map +0 -1
  230. package/dist/domain/documentation/documentation.error.js.map +0 -1
  231. package/dist/domain/documentation/documentationError.base.d.ts.map +0 -1
  232. package/dist/domain/documentation/documentationError.base.js.map +0 -1
  233. package/dist/domain/documentation/documentationError.types.d.ts.map +0 -1
  234. package/dist/domain/documentation/documentationError.types.js.map +0 -1
  235. package/dist/domain/documentation/index.d.ts.map +0 -1
  236. package/dist/domain/documentation/index.js.map +0 -1
  237. package/dist/domain/event/event.error.d.ts.map +0 -1
  238. package/dist/domain/event/event.error.js.map +0 -1
  239. package/dist/domain/event/eventError.base.d.ts.map +0 -1
  240. package/dist/domain/event/eventError.base.js.map +0 -1
  241. package/dist/domain/event/eventError.handler.d.ts.map +0 -1
  242. package/dist/domain/event/eventError.handler.js.map +0 -1
  243. package/dist/domain/event/eventError.lifecycle.d.ts.map +0 -1
  244. package/dist/domain/event/eventError.lifecycle.js.map +0 -1
  245. package/dist/domain/event/eventError.serialization.d.ts.map +0 -1
  246. package/dist/domain/event/eventError.serialization.js.map +0 -1
  247. package/dist/domain/event/index.d.ts.map +0 -1
  248. package/dist/domain/event/index.js.map +0 -1
  249. package/dist/domain/index.d.ts.map +0 -1
  250. package/dist/domain/index.js.map +0 -1
  251. package/dist/domain/message/index.d.ts.map +0 -1
  252. package/dist/domain/message/index.js.map +0 -1
  253. package/dist/domain/message/message.error.d.ts.map +0 -1
  254. package/dist/domain/message/message.error.js.map +0 -1
  255. package/dist/domain/message/messageError.base.d.ts.map +0 -1
  256. package/dist/domain/message/messageError.base.js.map +0 -1
  257. package/dist/domain/message/messageError.handler.d.ts.map +0 -1
  258. package/dist/domain/message/messageError.handler.js.map +0 -1
  259. package/dist/domain/message/messageError.lifecycle.d.ts.map +0 -1
  260. package/dist/domain/message/messageError.lifecycle.js.map +0 -1
  261. package/dist/domain/message/messageError.validation.d.ts.map +0 -1
  262. package/dist/domain/message/messageError.validation.js.map +0 -1
  263. package/dist/domain/plugin/index.d.ts.map +0 -1
  264. package/dist/domain/plugin/index.js.map +0 -1
  265. package/dist/domain/plugin/plugin.error.d.ts.map +0 -1
  266. package/dist/domain/plugin/plugin.error.js.map +0 -1
  267. package/dist/domain/plugin/pluginError.base.d.ts.map +0 -1
  268. package/dist/domain/plugin/pluginError.base.js.map +0 -1
  269. package/dist/domain/plugin/pluginError.lifecycle.d.ts.map +0 -1
  270. package/dist/domain/plugin/pluginError.lifecycle.js.map +0 -1
  271. package/dist/domain/plugin/pluginError.runtime.d.ts.map +0 -1
  272. package/dist/domain/plugin/pluginError.runtime.js.map +0 -1
  273. package/dist/domain/queue/index.d.ts.map +0 -1
  274. package/dist/domain/queue/index.js.map +0 -1
  275. package/dist/domain/queue/queue.error.d.ts.map +0 -1
  276. package/dist/domain/queue/queue.error.js.map +0 -1
  277. package/dist/domain/queue/queueError.base.d.ts.map +0 -1
  278. package/dist/domain/queue/queueError.base.js.map +0 -1
  279. package/dist/domain/queue/queueError.job.d.ts.map +0 -1
  280. package/dist/domain/queue/queueError.job.js.map +0 -1
  281. package/dist/domain/queue/queueError.queue.d.ts.map +0 -1
  282. package/dist/domain/queue/queueError.queue.js.map +0 -1
  283. package/dist/domain/queue/queueError.worker.d.ts.map +0 -1
  284. package/dist/domain/queue/queueError.worker.js.map +0 -1
  285. package/dist/domain/rpc/index.d.ts.map +0 -1
  286. package/dist/domain/rpc/index.js.map +0 -1
  287. package/dist/domain/rpc/rpc.error.d.ts.map +0 -1
  288. package/dist/domain/rpc/rpc.error.js.map +0 -1
  289. package/dist/domain/rpc/rpcError.base.d.ts.map +0 -1
  290. package/dist/domain/rpc/rpcError.base.js.map +0 -1
  291. package/dist/domain/rpc/rpcError.protocol.d.ts.map +0 -1
  292. package/dist/domain/rpc/rpcError.protocol.js.map +0 -1
  293. package/dist/domain/rpc/rpcError.transport.d.ts.map +0 -1
  294. package/dist/domain/rpc/rpcError.transport.js.map +0 -1
  295. package/dist/domain/scheduler/index.d.ts.map +0 -1
  296. package/dist/domain/scheduler/index.js.map +0 -1
  297. package/dist/domain/scheduler/scheduler.error.d.ts.map +0 -1
  298. package/dist/domain/scheduler/scheduler.error.js.map +0 -1
  299. package/dist/domain/scheduler/schedulerError.base.d.ts.map +0 -1
  300. package/dist/domain/scheduler/schedulerError.base.js.map +0 -1
  301. package/dist/domain/scheduler/schedulerError.execution.d.ts.map +0 -1
  302. package/dist/domain/scheduler/schedulerError.execution.js.map +0 -1
  303. package/dist/domain/scheduler/schedulerError.schedule.d.ts.map +0 -1
  304. package/dist/domain/scheduler/schedulerError.schedule.js.map +0 -1
  305. package/dist/domain/schema/index.d.ts.map +0 -1
  306. package/dist/domain/schema/index.js.map +0 -1
  307. package/dist/domain/schema/schema.error.d.ts.map +0 -1
  308. package/dist/domain/schema/schema.error.js.map +0 -1
  309. package/dist/domain/schema/schemaError.base.d.ts.map +0 -1
  310. package/dist/domain/schema/schemaError.base.js.map +0 -1
  311. package/dist/domain/schema/schemaError.types.d.ts.map +0 -1
  312. package/dist/domain/schema/schemaError.types.js.map +0 -1
  313. package/dist/domain/serialization/index.d.ts.map +0 -1
  314. package/dist/domain/serialization/index.js.map +0 -1
  315. package/dist/domain/serialization/serialization.error.d.ts.map +0 -1
  316. package/dist/domain/serialization/serialization.error.js.map +0 -1
  317. package/dist/domain/serialization/serializationError.base.d.ts.map +0 -1
  318. package/dist/domain/serialization/serializationError.base.js.map +0 -1
  319. package/dist/domain/serialization/serializationError.types.d.ts.map +0 -1
  320. package/dist/domain/serialization/serializationError.types.js.map +0 -1
  321. package/dist/domain/state/conflict.error.d.ts.map +0 -1
  322. package/dist/domain/state/conflict.error.js.map +0 -1
  323. package/dist/domain/state/index.d.ts.map +0 -1
  324. package/dist/domain/state/index.js.map +0 -1
  325. package/dist/domain/state/notFound.error.d.ts.map +0 -1
  326. package/dist/domain/state/notFound.error.js.map +0 -1
  327. package/dist/domain/state/validation.error.d.ts.map +0 -1
  328. package/dist/domain/state/validation.error.js.map +0 -1
  329. package/dist/domain/state/validationError.base.d.ts.map +0 -1
  330. package/dist/domain/state/validationError.base.js.map +0 -1
  331. package/dist/domain/state/validationError.helpers.d.ts.map +0 -1
  332. package/dist/domain/state/validationError.helpers.js.map +0 -1
  333. package/dist/index.d.ts.map +0 -1
  334. package/dist/index.js.map +0 -1
  335. package/dist/infrastructure/adapter/adapter.error.d.ts.map +0 -1
  336. package/dist/infrastructure/adapter/adapter.error.js.map +0 -1
  337. package/dist/infrastructure/adapter/adapterError.base.d.ts.map +0 -1
  338. package/dist/infrastructure/adapter/adapterError.base.js.map +0 -1
  339. package/dist/infrastructure/adapter/adapterError.lifecycle.d.ts.map +0 -1
  340. package/dist/infrastructure/adapter/adapterError.lifecycle.js.map +0 -1
  341. package/dist/infrastructure/adapter/adapterError.operation.d.ts.map +0 -1
  342. package/dist/infrastructure/adapter/adapterError.operation.js.map +0 -1
  343. package/dist/infrastructure/adapter/index.d.ts.map +0 -1
  344. package/dist/infrastructure/adapter/index.js.map +0 -1
  345. package/dist/infrastructure/cache/cache.error.d.ts.map +0 -1
  346. package/dist/infrastructure/cache/cache.error.js.map +0 -1
  347. package/dist/infrastructure/cache/cacheError.base.d.ts.map +0 -1
  348. package/dist/infrastructure/cache/cacheError.base.js.map +0 -1
  349. package/dist/infrastructure/cache/cacheError.factory.d.ts.map +0 -1
  350. package/dist/infrastructure/cache/cacheError.factory.js.map +0 -1
  351. package/dist/infrastructure/cache/index.d.ts.map +0 -1
  352. package/dist/infrastructure/cache/index.js.map +0 -1
  353. package/dist/infrastructure/container/container.error.d.ts.map +0 -1
  354. package/dist/infrastructure/container/container.error.js.map +0 -1
  355. package/dist/infrastructure/container/containerError.base.d.ts.map +0 -1
  356. package/dist/infrastructure/container/containerError.base.js.map +0 -1
  357. package/dist/infrastructure/container/containerError.registration.d.ts.map +0 -1
  358. package/dist/infrastructure/container/containerError.registration.js.map +0 -1
  359. package/dist/infrastructure/container/index.d.ts.map +0 -1
  360. package/dist/infrastructure/container/index.js.map +0 -1
  361. package/dist/infrastructure/index.d.ts.map +0 -1
  362. package/dist/infrastructure/index.js.map +0 -1
  363. package/dist/infrastructure/middleware/index.d.ts.map +0 -1
  364. package/dist/infrastructure/middleware/index.js.map +0 -1
  365. package/dist/infrastructure/middleware/middleware.error.d.ts.map +0 -1
  366. package/dist/infrastructure/middleware/middleware.error.js.map +0 -1
  367. package/dist/infrastructure/network/http.error.d.ts.map +0 -1
  368. package/dist/infrastructure/network/http.error.js.map +0 -1
  369. package/dist/infrastructure/network/httpAdapter.error.d.ts.map +0 -1
  370. package/dist/infrastructure/network/httpAdapter.error.js.map +0 -1
  371. package/dist/infrastructure/network/httpClient.errors.d.ts.map +0 -1
  372. package/dist/infrastructure/network/httpClient.errors.js.map +0 -1
  373. package/dist/infrastructure/network/httpClientError.advanced.d.ts.map +0 -1
  374. package/dist/infrastructure/network/httpClientError.advanced.js.map +0 -1
  375. package/dist/infrastructure/network/httpClientError.base.d.ts.map +0 -1
  376. package/dist/infrastructure/network/httpClientError.base.js.map +0 -1
  377. package/dist/infrastructure/network/httpClientError.common.d.ts.map +0 -1
  378. package/dist/infrastructure/network/httpClientError.common.js.map +0 -1
  379. package/dist/infrastructure/network/httpClientError.error.d.ts.map +0 -1
  380. package/dist/infrastructure/network/httpClientError.error.js.map +0 -1
  381. package/dist/infrastructure/network/httpClientError.options.d.ts.map +0 -1
  382. package/dist/infrastructure/network/httpClientError.options.js.map +0 -1
  383. package/dist/infrastructure/network/httpClientError.specialized.d.ts.map +0 -1
  384. package/dist/infrastructure/network/httpClientError.specialized.js.map +0 -1
  385. package/dist/infrastructure/network/httpClientError.types.d.ts.map +0 -1
  386. package/dist/infrastructure/network/httpClientError.types.js.map +0 -1
  387. package/dist/infrastructure/network/httpError.base.d.ts.map +0 -1
  388. package/dist/infrastructure/network/httpError.base.js.map +0 -1
  389. package/dist/infrastructure/network/httpError.helpers.d.ts.map +0 -1
  390. package/dist/infrastructure/network/httpError.helpers.js.map +0 -1
  391. package/dist/infrastructure/network/httpResponse.error.d.ts.map +0 -1
  392. package/dist/infrastructure/network/httpResponse.error.js.map +0 -1
  393. package/dist/infrastructure/network/httpRouter.error.d.ts.map +0 -1
  394. package/dist/infrastructure/network/httpRouter.error.js.map +0 -1
  395. package/dist/infrastructure/network/httpRouterError.base.d.ts.map +0 -1
  396. package/dist/infrastructure/network/httpRouterError.base.js.map +0 -1
  397. package/dist/infrastructure/network/httpRouterError.types.d.ts.map +0 -1
  398. package/dist/infrastructure/network/httpRouterError.types.js.map +0 -1
  399. package/dist/infrastructure/network/httpServerError.error.d.ts.map +0 -1
  400. package/dist/infrastructure/network/httpServerError.error.js.map +0 -1
  401. package/dist/infrastructure/network/httpServerLifecycle.error.d.ts.map +0 -1
  402. package/dist/infrastructure/network/httpServerLifecycle.error.js.map +0 -1
  403. package/dist/infrastructure/network/httpServerLifecycleError.base.d.ts.map +0 -1
  404. package/dist/infrastructure/network/httpServerLifecycleError.base.js.map +0 -1
  405. package/dist/infrastructure/network/httpServerLifecycleError.types.d.ts.map +0 -1
  406. package/dist/infrastructure/network/httpServerLifecycleError.types.js.map +0 -1
  407. package/dist/infrastructure/network/httpStream.error.d.ts.map +0 -1
  408. package/dist/infrastructure/network/httpStream.error.js.map +0 -1
  409. package/dist/infrastructure/network/index.d.ts.map +0 -1
  410. package/dist/infrastructure/network/index.js.map +0 -1
  411. package/dist/infrastructure/network/network.error.d.ts.map +0 -1
  412. package/dist/infrastructure/network/network.error.js.map +0 -1
  413. package/dist/infrastructure/network/networkError.base.d.ts.map +0 -1
  414. package/dist/infrastructure/network/networkError.base.js.map +0 -1
  415. package/dist/infrastructure/network/networkError.factory.d.ts.map +0 -1
  416. package/dist/infrastructure/network/networkError.factory.js.map +0 -1
  417. package/dist/infrastructure/network/routePattern.error.d.ts.map +0 -1
  418. package/dist/infrastructure/network/routePattern.error.js.map +0 -1
  419. package/dist/infrastructure/network/timeout.error.d.ts.map +0 -1
  420. package/dist/infrastructure/network/timeout.error.js.map +0 -1
  421. package/dist/infrastructure/network/timeoutError.base.d.ts.map +0 -1
  422. package/dist/infrastructure/network/timeoutError.base.js.map +0 -1
  423. package/dist/infrastructure/network/timeoutError.factory.d.ts.map +0 -1
  424. package/dist/infrastructure/network/timeoutError.factory.js.map +0 -1
  425. package/dist/infrastructure/service/externalService.error.d.ts.map +0 -1
  426. package/dist/infrastructure/service/externalService.error.js.map +0 -1
  427. package/dist/infrastructure/service/externalServiceError.base.d.ts.map +0 -1
  428. package/dist/infrastructure/service/externalServiceError.base.js.map +0 -1
  429. package/dist/infrastructure/service/externalServiceError.factory.d.ts.map +0 -1
  430. package/dist/infrastructure/service/externalServiceError.factory.js.map +0 -1
  431. package/dist/infrastructure/service/index.d.ts.map +0 -1
  432. package/dist/infrastructure/service/index.js.map +0 -1
  433. package/dist/infrastructure/service/service.error.d.ts.map +0 -1
  434. package/dist/infrastructure/service/service.error.js.map +0 -1
  435. package/dist/infrastructure/service/serviceError.base.d.ts.map +0 -1
  436. package/dist/infrastructure/service/serviceError.base.js.map +0 -1
  437. package/dist/infrastructure/service/serviceError.factory.d.ts.map +0 -1
  438. package/dist/infrastructure/service/serviceError.factory.js.map +0 -1
  439. package/dist/infrastructure/storage/database.error.d.ts.map +0 -1
  440. package/dist/infrastructure/storage/database.error.js.map +0 -1
  441. package/dist/infrastructure/storage/databaseError.base.d.ts.map +0 -1
  442. package/dist/infrastructure/storage/databaseError.base.js.map +0 -1
  443. package/dist/infrastructure/storage/databaseError.factory.d.ts.map +0 -1
  444. package/dist/infrastructure/storage/databaseError.factory.js.map +0 -1
  445. package/dist/infrastructure/storage/index.d.ts.map +0 -1
  446. package/dist/infrastructure/storage/index.js.map +0 -1
  447. package/dist/infrastructure/storage/storage.error.d.ts.map +0 -1
  448. package/dist/infrastructure/storage/storage.error.js.map +0 -1
  449. package/dist/infrastructure/storage/storageError.base.d.ts.map +0 -1
  450. package/dist/infrastructure/storage/storageError.base.js.map +0 -1
  451. package/dist/infrastructure/storage/storageError.factory.d.ts.map +0 -1
  452. package/dist/infrastructure/storage/storageError.factory.js.map +0 -1
  453. package/dist/system/crypto.error.d.ts.map +0 -1
  454. package/dist/system/crypto.error.js.map +0 -1
  455. package/dist/system/cryptoError.base.d.ts.map +0 -1
  456. package/dist/system/cryptoError.base.js.map +0 -1
  457. package/dist/system/cryptoError.factory.d.ts.map +0 -1
  458. package/dist/system/cryptoError.factory.js.map +0 -1
  459. package/dist/system/index.d.ts.map +0 -1
  460. package/dist/system/index.js.map +0 -1
  461. package/dist/system/logging/index.d.ts.map +0 -1
  462. package/dist/system/logging/index.js.map +0 -1
  463. package/dist/system/logging/logging.error.d.ts.map +0 -1
  464. package/dist/system/logging/logging.error.js.map +0 -1
  465. package/dist/system/runtime.error.d.ts.map +0 -1
  466. package/dist/system/runtime.error.js.map +0 -1
  467. package/dist/system/runtimeError.base.d.ts.map +0 -1
  468. package/dist/system/runtimeError.base.js.map +0 -1
  469. package/dist/system/runtimeError.types.d.ts.map +0 -1
  470. package/dist/system/runtimeError.types.js.map +0 -1
  471. package/dist/system/system.error.d.ts.map +0 -1
  472. package/dist/system/system.error.js.map +0 -1
  473. package/dist/system/systemError.base.d.ts.map +0 -1
  474. package/dist/system/systemError.base.js.map +0 -1
  475. package/dist/system/systemError.factory.d.ts.map +0 -1
  476. package/dist/system/systemError.factory.js.map +0 -1
  477. package/dist/utils/errorHandler.core.d.ts.map +0 -1
  478. package/dist/utils/errorHandler.core.js.map +0 -1
  479. package/dist/utils/errorHandler.factory.d.ts.map +0 -1
  480. package/dist/utils/errorHandler.factory.js.map +0 -1
  481. package/dist/utils/errorHandler.types.d.ts.map +0 -1
  482. package/dist/utils/errorHandler.types.js.map +0 -1
  483. package/dist/utils/errorMapper.core.d.ts.map +0 -1
  484. package/dist/utils/errorMapper.core.js.map +0 -1
  485. package/dist/utils/errorMapper.mappers.d.ts.map +0 -1
  486. package/dist/utils/errorMapper.mappers.js.map +0 -1
  487. package/dist/utils/errorMapper.registry.d.ts.map +0 -1
  488. package/dist/utils/errorMapper.registry.js.map +0 -1
  489. package/dist/utils/errorMapper.types.d.ts.map +0 -1
  490. package/dist/utils/errorMapper.types.js.map +0 -1
  491. package/dist/utils/errorSerializer.core.d.ts.map +0 -1
  492. package/dist/utils/errorSerializer.core.js.map +0 -1
  493. package/dist/utils/errorSerializer.factory.d.ts.map +0 -1
  494. package/dist/utils/errorSerializer.factory.js.map +0 -1
  495. package/dist/utils/errorSerializer.types.d.ts.map +0 -1
  496. package/dist/utils/errorSerializer.types.js.map +0 -1
  497. package/dist/utils/errorUtils.extraction.d.ts.map +0 -1
  498. package/dist/utils/errorUtils.extraction.js.map +0 -1
  499. package/dist/utils/errorUtils.helper.d.ts.map +0 -1
  500. package/dist/utils/errorUtils.helper.js.map +0 -1
  501. package/dist/utils/errorUtils.transform.d.ts.map +0 -1
  502. package/dist/utils/errorUtils.transform.js.map +0 -1
  503. package/dist/utils/errorUtils.typeCheck.d.ts.map +0 -1
  504. package/dist/utils/errorUtils.typeCheck.js.map +0 -1
  505. package/dist/utils/index.d.ts.map +0 -1
  506. package/dist/utils/index.js.map +0 -1
@@ -5,11 +5,13 @@ import { BaseError } from "../../base/core/baseError.core.js";
5
5
  import { ErrorCategory } from "../../base/types/errorCategory.type.js";
6
6
  import { ErrorCode } from "../../base/types/errorCode.type.js";
7
7
  import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
8
+ import { safeErrorMessage } from "../shared/domainError.helpers.js";
8
9
  /** Base error for all message subsystem failures. */
9
10
  export class MessageError extends BaseError {
10
11
  messageType;
11
12
  messageId;
12
13
  handlerId;
14
+ middlewareId;
13
15
  constructor(message, options = {}) {
14
16
  super(message, {
15
17
  ...options,
@@ -23,6 +25,7 @@ export class MessageError extends BaseError {
23
25
  this.messageType = options.messageType;
24
26
  this.messageId = options.messageId;
25
27
  this.handlerId = options.handlerId;
28
+ this.middlewareId = options.middlewareId;
26
29
  }
27
30
  toJSON() {
28
31
  return {
@@ -32,6 +35,9 @@ export class MessageError extends BaseError {
32
35
  : {}),
33
36
  ...(this.messageId !== undefined ? { messageId: this.messageId } : {}),
34
37
  ...(this.handlerId !== undefined ? { handlerId: this.handlerId } : {}),
38
+ ...(this.middlewareId !== undefined
39
+ ? { middlewareId: this.middlewareId }
40
+ : {}),
35
41
  };
36
42
  }
37
43
  }
@@ -48,15 +54,7 @@ export function toMessageError(error, options = {}) {
48
54
  if (error instanceof MessageError) {
49
55
  return error;
50
56
  }
51
- if (error instanceof Error) {
52
- return new MessageError(options.message ?? error.message, {
53
- code: options.code,
54
- messageType: options.messageType,
55
- messageId: options.messageId,
56
- cause: error,
57
- });
58
- }
59
- return new MessageError(options.message ?? String(error), {
57
+ return new MessageError(options.message ?? safeErrorMessage(error), {
60
58
  code: options.code,
61
59
  messageType: options.messageType,
62
60
  messageId: options.messageId,
@@ -13,17 +13,26 @@ export declare class MessageHandlerError extends MessageError {
13
13
  }
14
14
  /** Creates a message handler error from an unknown failure. */
15
15
  export declare function createMessageHandlerError(handlerId: string, messageType: string, messageId: string, cause: unknown): MessageHandlerError;
16
- /** Error thrown when a message handler cannot be found. */
16
+ /**
17
+ * Error thrown when a message handler cannot be found.
18
+ *
19
+ * Handler registration is a server-side concern, so this is an internal
20
+ * (non-exposed, non-operational) failure.
21
+ */
17
22
  export declare class MessageHandlerNotFoundError extends MessageError {
18
23
  constructor(handlerId: string);
19
24
  }
20
- /** Error thrown when a message handler is already registered. */
25
+ /**
26
+ * Error thrown when a message handler is already registered.
27
+ *
28
+ * Handler registration is a server-side concern, so this is an internal
29
+ * (non-exposed, non-operational) failure.
30
+ */
21
31
  export declare class DuplicateMessageHandlerError extends MessageError {
22
32
  constructor(handlerId: string);
23
33
  }
24
34
  /** Error thrown when message middleware fails. */
25
35
  export declare class MessageMiddlewareError extends MessageError {
26
- readonly middlewareId?: string;
27
36
  constructor(message: string, options?: {
28
37
  middlewareId?: string;
29
38
  messageType?: string;
@@ -7,7 +7,7 @@ import { MessageError } from "./messageError.base.js";
7
7
  export class MessageHandlerError extends MessageError {
8
8
  constructor(message, options) {
9
9
  super(message, {
10
- code: ErrorCode.MESSAGE_HANDLER_NOT_FOUND,
10
+ code: ErrorCode.MESSAGE_HANDLER_FAILED,
11
11
  handlerId: options.handlerId,
12
12
  messageType: options.messageType,
13
13
  messageId: options.messageId,
@@ -19,40 +19,50 @@ export class MessageHandlerError extends MessageError {
19
19
  export function createMessageHandlerError(handlerId, messageType, messageId, cause) {
20
20
  return new MessageHandlerError(`Message handler "${handlerId}" failed while processing "${messageType}".`, { handlerId, messageType, messageId, cause });
21
21
  }
22
- /** Error thrown when a message handler cannot be found. */
22
+ /**
23
+ * Error thrown when a message handler cannot be found.
24
+ *
25
+ * Handler registration is a server-side concern, so this is an internal
26
+ * (non-exposed, non-operational) failure.
27
+ */
23
28
  export class MessageHandlerNotFoundError extends MessageError {
24
29
  constructor(handlerId) {
25
30
  super(`Message handler "${handlerId}" was not found.`, {
26
- code: ErrorCode.RESOURCE_NOT_FOUND,
31
+ code: ErrorCode.MESSAGE_HANDLER_NOT_FOUND,
27
32
  handlerId,
28
- statusCode: 404,
29
- expose: true,
33
+ statusCode: 500,
34
+ expose: false,
35
+ isOperational: false,
30
36
  });
31
37
  }
32
38
  }
33
- /** Error thrown when a message handler is already registered. */
39
+ /**
40
+ * Error thrown when a message handler is already registered.
41
+ *
42
+ * Handler registration is a server-side concern, so this is an internal
43
+ * (non-exposed, non-operational) failure.
44
+ */
34
45
  export class DuplicateMessageHandlerError extends MessageError {
35
46
  constructor(handlerId) {
36
47
  super(`Message handler "${handlerId}" is already registered.`, {
37
- code: ErrorCode.CONFLICT,
48
+ code: ErrorCode.MESSAGE_DUPLICATE_HANDLER,
38
49
  handlerId,
39
- statusCode: 409,
40
- expose: true,
50
+ statusCode: 500,
51
+ expose: false,
52
+ isOperational: false,
41
53
  });
42
54
  }
43
55
  }
44
56
  /** Error thrown when message middleware fails. */
45
57
  export class MessageMiddlewareError extends MessageError {
46
- middlewareId;
47
58
  constructor(message, options = {}) {
48
59
  super(message, {
49
- code: ErrorCode.MIDDLEWARE_EXECUTION,
60
+ code: ErrorCode.MESSAGE_MIDDLEWARE_FAILED,
50
61
  middlewareId: options.middlewareId,
51
62
  messageType: options.messageType,
52
63
  messageId: options.messageId,
53
64
  cause: options.cause,
54
65
  });
55
- this.middlewareId = options.middlewareId;
56
66
  }
57
67
  }
58
68
  //# sourceMappingURL=messageError.handler.js.map
@@ -14,7 +14,11 @@ export declare class InvalidMessageError extends MessageError {
14
14
  cause?: unknown;
15
15
  });
16
16
  }
17
- /** Error thrown when a message type is not registered. */
17
+ /**
18
+ * Error thrown when a message type is not registered.
19
+ *
20
+ * Message registration is a server-side concern; reported as internal.
21
+ */
18
22
  export declare class MessageTypeNotFoundError extends MessageError {
19
23
  constructor(messageType: string);
20
24
  }
@@ -2,6 +2,7 @@
2
2
  * Message lifecycle error classes — dispatch, timeout, validation.
3
3
  */
4
4
  import { ErrorCode } from "../../base/types/errorCode.type.js";
5
+ import { assertFiniteNonNegative } from "../shared/domainError.helpers.js";
5
6
  import { MessageError } from "./messageError.base.js";
6
7
  /** Error raised when message dispatch fails. */
7
8
  export class MessageDispatchError extends MessageError {
@@ -17,7 +18,7 @@ export class MessageDispatchError extends MessageError {
17
18
  export class InvalidMessageError extends MessageError {
18
19
  constructor(message, options = {}) {
19
20
  super(message, {
20
- code: ErrorCode.INVALID_INPUT,
21
+ code: ErrorCode.MESSAGE_INVALID,
21
22
  messageType: options.messageType,
22
23
  messageId: options.messageId,
23
24
  cause: options.cause,
@@ -26,14 +27,19 @@ export class InvalidMessageError extends MessageError {
26
27
  });
27
28
  }
28
29
  }
29
- /** Error thrown when a message type is not registered. */
30
+ /**
31
+ * Error thrown when a message type is not registered.
32
+ *
33
+ * Message registration is a server-side concern; reported as internal.
34
+ */
30
35
  export class MessageTypeNotFoundError extends MessageError {
31
36
  constructor(messageType) {
32
37
  super(`Message type "${messageType}" is not registered.`, {
33
- code: ErrorCode.NOT_FOUND,
38
+ code: ErrorCode.MESSAGE_TYPE_NOT_FOUND,
34
39
  messageType,
35
- statusCode: 404,
36
- expose: true,
40
+ statusCode: 500,
41
+ expose: false,
42
+ isOperational: false,
37
43
  });
38
44
  }
39
45
  }
@@ -41,7 +47,7 @@ export class MessageTypeNotFoundError extends MessageError {
41
47
  export class MessageDispatchAbortedError extends MessageError {
42
48
  constructor(message = "Message dispatch was aborted.", options = {}) {
43
49
  super(message, {
44
- code: ErrorCode.OPERATION_CANCELLED,
50
+ code: ErrorCode.MESSAGE_ABORTED,
45
51
  messageType: options.messageType,
46
52
  messageId: options.messageId,
47
53
  statusCode: 499,
@@ -53,7 +59,7 @@ export class MessageDispatchAbortedError extends MessageError {
53
59
  export class MessageBusDisposedError extends MessageError {
54
60
  constructor() {
55
61
  super("Message bus has already been disposed.", {
56
- code: ErrorCode.OPERATION_FAILED,
62
+ code: ErrorCode.MESSAGE_BUS_DISPOSED,
57
63
  statusCode: 500,
58
64
  isOperational: false,
59
65
  });
@@ -63,8 +69,9 @@ export class MessageBusDisposedError extends MessageError {
63
69
  export class MessageTimeoutError extends MessageError {
64
70
  timeoutMs;
65
71
  constructor(timeoutMs, options = {}) {
72
+ assertFiniteNonNegative("timeoutMs", timeoutMs);
66
73
  super(`Message processing exceeded the timeout of ${timeoutMs}ms.`, {
67
- code: ErrorCode.TIMEOUT,
74
+ code: ErrorCode.MESSAGE_TIMEOUT,
68
75
  messageType: options.messageType,
69
76
  messageId: options.messageId,
70
77
  metadata: { timeoutMs },
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Message serialization and deserialization error classes.
3
+ */
4
+ import { MessageError } from "./messageError.base.js";
5
+ /** Error thrown when message serialization fails. */
6
+ export declare class MessageSerializationError extends MessageError {
7
+ constructor(message: string, options?: {
8
+ messageType?: string;
9
+ messageId?: string;
10
+ cause?: unknown;
11
+ });
12
+ }
13
+ /**
14
+ * Error thrown when message deserialization fails.
15
+ *
16
+ * Malformed serialized input is a client/input problem, so this is a
17
+ * 400 that may be exposed.
18
+ */
19
+ export declare class MessageDeserializationError extends MessageError {
20
+ constructor(message: string, options?: {
21
+ messageType?: string;
22
+ messageId?: string;
23
+ cause?: unknown;
24
+ });
25
+ }
26
+ //# sourceMappingURL=messageError.serialization.d.ts.map
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Message serialization and deserialization error classes.
3
+ */
4
+ import { ErrorCode } from "../../base/types/errorCode.type.js";
5
+ import { MessageError } from "./messageError.base.js";
6
+ /** Error thrown when message serialization fails. */
7
+ export class MessageSerializationError extends MessageError {
8
+ constructor(message, options = {}) {
9
+ super(message, {
10
+ code: ErrorCode.MESSAGE_SERIALIZATION_FAILED,
11
+ messageType: options.messageType,
12
+ messageId: options.messageId,
13
+ cause: options.cause,
14
+ });
15
+ }
16
+ }
17
+ /**
18
+ * Error thrown when message deserialization fails.
19
+ *
20
+ * Malformed serialized input is a client/input problem, so this is a
21
+ * 400 that may be exposed.
22
+ */
23
+ export class MessageDeserializationError extends MessageError {
24
+ constructor(message, options = {}) {
25
+ super(message, {
26
+ code: ErrorCode.MESSAGE_DESERIALIZATION_FAILED,
27
+ messageType: options.messageType,
28
+ messageId: options.messageId,
29
+ cause: options.cause,
30
+ statusCode: 400,
31
+ expose: true,
32
+ });
33
+ }
34
+ }
35
+ //# sourceMappingURL=messageError.serialization.js.map
@@ -3,6 +3,12 @@
3
3
  */
4
4
  import { ErrorCode } from "../../base/types/errorCode.type.js";
5
5
  import { PluginError } from "./pluginError.base.js";
6
+ /*
7
+ * Plugin registration, lookup, dependency and state errors describe server
8
+ * configuration problems. They are reported as internal (500, not exposed,
9
+ * non-operational) so that plugin names and dependency graphs never reach
10
+ * clients and so that a misconfigured server is not blamed on the request.
11
+ */
6
12
  /** Error thrown when a plugin registration fails. */
7
13
  export class PluginRegistrationError extends PluginError {
8
14
  constructor(message, pluginName, options = {}) {
@@ -10,10 +16,10 @@ export class PluginRegistrationError extends PluginError {
10
16
  ...options,
11
17
  code: ErrorCode.PLUGIN_REGISTRATION,
12
18
  pluginName,
13
- statusCode: 400,
14
- expose: true,
19
+ statusCode: 500,
20
+ expose: false,
21
+ isOperational: false,
15
22
  });
16
- this.name = "PluginRegistrationError";
17
23
  }
18
24
  }
19
25
  /** Error thrown when a plugin is already registered. */
@@ -23,10 +29,10 @@ export class PluginAlreadyRegisteredError extends PluginError {
23
29
  ...options,
24
30
  code: ErrorCode.PLUGIN_ALREADY_REGISTERED,
25
31
  pluginName,
26
- statusCode: 409,
27
- expose: true,
32
+ statusCode: 500,
33
+ expose: false,
34
+ isOperational: false,
28
35
  });
29
- this.name = "PluginAlreadyRegisteredError";
30
36
  }
31
37
  }
32
38
  /** Error thrown when a plugin is not found. */
@@ -36,10 +42,10 @@ export class PluginNotFoundError extends PluginError {
36
42
  ...options,
37
43
  code: ErrorCode.PLUGIN_NOT_FOUND,
38
44
  pluginName,
39
- statusCode: 404,
40
- expose: true,
45
+ statusCode: 500,
46
+ expose: false,
47
+ isOperational: false,
41
48
  });
42
- this.name = "PluginNotFoundError";
43
49
  }
44
50
  }
45
51
  /** Error thrown when a plugin dependency is missing. */
@@ -49,11 +55,11 @@ export class PluginDependencyError extends PluginError {
49
55
  ...options,
50
56
  code: ErrorCode.PLUGIN_DEPENDENCY,
51
57
  pluginName,
52
- statusCode: 400,
53
- expose: true,
54
- metadata: { dependencyName },
58
+ statusCode: 500,
59
+ expose: false,
60
+ isOperational: false,
61
+ metadata: { ...options.metadata, dependencyName },
55
62
  });
56
- this.name = "PluginDependencyError";
57
63
  }
58
64
  }
59
65
  /** Error thrown when a circular plugin dependency is detected. */
@@ -62,11 +68,11 @@ export class PluginDependencyCycleError extends PluginError {
62
68
  super(`Circular plugin dependency detected: ${cycle.join(" -> ")}.`, {
63
69
  ...options,
64
70
  code: ErrorCode.PLUGIN_DEPENDENCY_CYCLE,
65
- statusCode: 400,
66
- expose: true,
67
- metadata: { cycle: [...cycle] },
71
+ statusCode: 500,
72
+ expose: false,
73
+ isOperational: false,
74
+ metadata: { ...options.metadata, cycle: [...cycle] },
68
75
  });
69
- this.name = "PluginDependencyCycleError";
70
76
  }
71
77
  }
72
78
  /** Error thrown when a plugin initialization fails. */
@@ -79,7 +85,6 @@ export class PluginInitializationError extends PluginError {
79
85
  statusCode: 500,
80
86
  expose: false,
81
87
  });
82
- this.name = "PluginInitializationError";
83
88
  }
84
89
  }
85
90
  /** Error thrown when a plugin start fails. */
@@ -92,7 +97,6 @@ export class PluginStartError extends PluginError {
92
97
  statusCode: 500,
93
98
  expose: false,
94
99
  });
95
- this.name = "PluginStartError";
96
100
  }
97
101
  }
98
102
  /** Error thrown when a plugin stop fails. */
@@ -105,7 +109,6 @@ export class PluginStopError extends PluginError {
105
109
  statusCode: 500,
106
110
  expose: false,
107
111
  });
108
- this.name = "PluginStopError";
109
112
  }
110
113
  }
111
114
  /** Error thrown when a plugin dispose fails. */
@@ -118,7 +121,6 @@ export class PluginDisposeError extends PluginError {
118
121
  statusCode: 500,
119
122
  expose: false,
120
123
  });
121
- this.name = "PluginDisposeError";
122
124
  }
123
125
  }
124
126
  //# sourceMappingURL=pluginError.lifecycle.js.map
@@ -6,7 +6,11 @@ import { PluginError, type PluginErrorOptions } from "./pluginError.base.js";
6
6
  export declare class PluginTimeoutError extends PluginError {
7
7
  constructor(pluginName: string, timeout: number, options?: PluginErrorOptions);
8
8
  }
9
- /** Error thrown when an invalid plugin state transition is attempted. */
9
+ /**
10
+ * Error thrown when an invalid plugin state transition is attempted.
11
+ *
12
+ * Plugin state is server-side; reported as internal (500, not exposed).
13
+ */
10
14
  export declare class PluginStateError extends PluginError {
11
15
  constructor(pluginName: string, fromState: string, toState: string, options?: PluginErrorOptions);
12
16
  }
@@ -2,33 +2,38 @@
2
2
  * Plugin runtime error classes — timeout, state transitions.
3
3
  */
4
4
  import { ErrorCode } from "../../base/types/errorCode.type.js";
5
+ import { assertFiniteNonNegative } from "../shared/domainError.helpers.js";
5
6
  import { PluginError } from "./pluginError.base.js";
6
7
  /** Error thrown when a plugin operation times out. */
7
8
  export class PluginTimeoutError extends PluginError {
8
9
  constructor(pluginName, timeout, options = {}) {
10
+ assertFiniteNonNegative("timeout", timeout);
9
11
  super(`Plugin "${pluginName}" timed out after ${timeout}ms.`, {
10
12
  ...options,
11
13
  code: ErrorCode.PLUGIN_TIMEOUT,
12
14
  pluginName,
13
15
  statusCode: 504,
14
16
  expose: false,
15
- metadata: { timeout },
17
+ metadata: { ...options.metadata, timeout },
16
18
  });
17
- this.name = "PluginTimeoutError";
18
19
  }
19
20
  }
20
- /** Error thrown when an invalid plugin state transition is attempted. */
21
+ /**
22
+ * Error thrown when an invalid plugin state transition is attempted.
23
+ *
24
+ * Plugin state is server-side; reported as internal (500, not exposed).
25
+ */
21
26
  export class PluginStateError extends PluginError {
22
27
  constructor(pluginName, fromState, toState, options = {}) {
23
28
  super(`Cannot transition plugin "${pluginName}" from "${fromState}" to "${toState}".`, {
24
29
  ...options,
25
30
  code: ErrorCode.PLUGIN_STATE,
26
31
  pluginName,
27
- statusCode: 400,
28
- expose: true,
29
- metadata: { fromState, toState },
32
+ statusCode: 500,
33
+ expose: false,
34
+ isOperational: false,
35
+ metadata: { ...options.metadata, fromState, toState },
30
36
  });
31
- this.name = "PluginStateError";
32
37
  }
33
38
  }
34
39
  //# sourceMappingURL=pluginError.runtime.js.map
@@ -4,17 +4,36 @@
4
4
  import { BaseError } from "../../base/core/baseError.core.js";
5
5
  import type { BaseErrorOptions } from "../../base/types/baseError.type.js";
6
6
  import { ErrorCategory } from "../../base/types/errorCategory.type.js";
7
+ import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
7
8
  /** Options for creating a queue error. */
8
9
  export interface QueueErrorOptions extends Omit<BaseErrorOptions, "category"> {
9
10
  readonly category?: ErrorCategory;
10
11
  readonly queueName?: string;
11
12
  readonly jobId?: string;
13
+ readonly workerId?: string;
12
14
  }
13
15
  /** Base error for all queue subsystem failures. */
14
16
  export declare class QueueError extends BaseError {
15
17
  readonly queueName?: string;
16
18
  readonly jobId?: string;
19
+ readonly workerId?: string;
17
20
  constructor(message: string, options?: QueueErrorOptions);
21
+ toJSON(): {
22
+ name: string;
23
+ message: string;
24
+ code: string;
25
+ category: ErrorCategory;
26
+ severity: ErrorSeverity;
27
+ statusCode: number;
28
+ expose: boolean;
29
+ isOperational: boolean;
30
+ metadata: Readonly<import("../../index.js").ErrorMetadata>;
31
+ stack?: string;
32
+ cause?: import("../../base/types/baseError.type.js").SerializedBaseError | unknown;
33
+ queueName?: string | undefined;
34
+ jobId?: string | undefined;
35
+ workerId?: string | undefined;
36
+ };
18
37
  }
19
38
  /** Check if an error is a QueueError. */
20
39
  export declare function isQueueError(error: unknown): error is QueueError;
@@ -5,22 +5,43 @@ import { BaseError } from "../../base/core/baseError.core.js";
5
5
  import { ErrorCategory } from "../../base/types/errorCategory.type.js";
6
6
  import { ErrorCode } from "../../base/types/errorCode.type.js";
7
7
  import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
8
+ import { safeErrorMessage } from "../shared/domainError.helpers.js";
8
9
  /** Base error for all queue subsystem failures. */
9
10
  export class QueueError extends BaseError {
10
11
  queueName;
11
12
  jobId;
13
+ workerId;
12
14
  constructor(message, options = {}) {
13
15
  super(message, {
16
+ ...options,
14
17
  code: options.code ?? ErrorCode.QUEUE_ERROR,
15
18
  category: options.category ?? ErrorCategory.QUEUE,
16
19
  severity: options.severity ?? ErrorSeverity.WARNING,
17
- cause: options.cause,
18
- metadata: options.metadata,
20
+ statusCode: options.statusCode ?? 500,
19
21
  expose: options.expose ?? false,
20
22
  isOperational: options.isOperational ?? true,
23
+ metadata: {
24
+ ...options.metadata,
25
+ ...(options.queueName !== undefined
26
+ ? { queueName: options.queueName }
27
+ : {}),
28
+ ...(options.jobId !== undefined ? { jobId: options.jobId } : {}),
29
+ ...(options.workerId !== undefined
30
+ ? { workerId: options.workerId }
31
+ : {}),
32
+ },
21
33
  });
22
34
  this.queueName = options.queueName;
23
35
  this.jobId = options.jobId;
36
+ this.workerId = options.workerId;
37
+ }
38
+ toJSON() {
39
+ return {
40
+ ...super.toJSON(),
41
+ ...(this.queueName !== undefined ? { queueName: this.queueName } : {}),
42
+ ...(this.jobId !== undefined ? { jobId: this.jobId } : {}),
43
+ ...(this.workerId !== undefined ? { workerId: this.workerId } : {}),
44
+ };
24
45
  }
25
46
  }
26
47
  /** Check if an error is a QueueError. */
@@ -32,8 +53,7 @@ export function toQueueError(error, options = {}) {
32
53
  if (error instanceof QueueError) {
33
54
  return error;
34
55
  }
35
- const message = error instanceof Error ? error.message : String(error);
36
- return new QueueError(message, {
56
+ return new QueueError(safeErrorMessage(error), {
37
57
  cause: error,
38
58
  ...options,
39
59
  });
@@ -2,6 +2,7 @@
2
2
  * Job-specific error classes.
3
3
  */
4
4
  import { ErrorCode } from "../../base/types/errorCode.type.js";
5
+ import { assertFiniteNonNegative } from "../shared/domainError.helpers.js";
5
6
  import { QueueError } from "./queueError.base.js";
6
7
  /** Error thrown for general job failures. */
7
8
  export class JobError extends QueueError {
@@ -30,6 +31,7 @@ export class JobNotFoundError extends QueueError {
30
31
  export class JobTimeoutError extends QueueError {
31
32
  timeoutMs;
32
33
  constructor(jobId, timeoutMs, options = {}) {
34
+ assertFiniteNonNegative("timeoutMs", timeoutMs);
33
35
  super(`Job "${jobId}" exceeded the timeout of ${timeoutMs}ms.`, {
34
36
  code: ErrorCode.JOB_TIMEOUT,
35
37
  queueName: options.queueName,
@@ -4,16 +4,22 @@
4
4
  import { QueueError } from "./queueError.base.js";
5
5
  /** Error thrown for worker failures. */
6
6
  export declare class WorkerError extends QueueError {
7
- readonly workerId?: string;
8
7
  constructor(message: string, options?: {
9
8
  workerId?: string;
10
9
  queueName?: string;
11
10
  cause?: unknown;
12
11
  });
13
12
  }
14
- /** Error thrown when a worker is not found. */
13
+ /**
14
+ * Error thrown when a worker is not found.
15
+ *
16
+ * Workers are server-side components, so this is reported as an internal
17
+ * failure and is not exposed to clients.
18
+ */
15
19
  export declare class WorkerNotFoundError extends QueueError {
16
- constructor(workerId: string);
20
+ constructor(workerId: string, options?: {
21
+ queueName?: string;
22
+ });
17
23
  }
18
24
  /** Error thrown for worker lifecycle failures. */
19
25
  export declare class WorkerLifecycleError extends QueueError {
@@ -5,23 +5,30 @@ import { ErrorCode } from "../../base/types/errorCode.type.js";
5
5
  import { QueueError } from "./queueError.base.js";
6
6
  /** Error thrown for worker failures. */
7
7
  export class WorkerError extends QueueError {
8
- workerId;
9
8
  constructor(message, options = {}) {
10
9
  super(message, {
11
10
  code: ErrorCode.WORKER_ERROR,
12
11
  queueName: options.queueName,
12
+ workerId: options.workerId,
13
13
  cause: options.cause,
14
14
  });
15
- this.workerId = options.workerId;
16
15
  }
17
16
  }
18
- /** Error thrown when a worker is not found. */
17
+ /**
18
+ * Error thrown when a worker is not found.
19
+ *
20
+ * Workers are server-side components, so this is reported as an internal
21
+ * failure and is not exposed to clients.
22
+ */
19
23
  export class WorkerNotFoundError extends QueueError {
20
- constructor(workerId) {
24
+ constructor(workerId, options = {}) {
21
25
  super(`Worker "${workerId}" was not found.`, {
22
26
  code: ErrorCode.WORKER_NOT_FOUND,
23
- statusCode: 404,
24
- expose: true,
27
+ workerId,
28
+ queueName: options.queueName,
29
+ statusCode: 500,
30
+ expose: false,
31
+ isOperational: false,
25
32
  });
26
33
  }
27
34
  }
@@ -31,6 +38,7 @@ export class WorkerLifecycleError extends QueueError {
31
38
  super(message, {
32
39
  code: ErrorCode.WORKER_LIFECYCLE,
33
40
  queueName: options.queueName,
41
+ workerId: options.workerId,
34
42
  cause: options.cause,
35
43
  });
36
44
  }
@@ -46,7 +46,6 @@ export class RPCProcedureNotFoundError extends RPCError {
46
46
  statusCode: 404,
47
47
  expose: true,
48
48
  });
49
- this.name = "RPCProcedureNotFoundError";
50
49
  }
51
50
  }
52
51
  /** Error thrown when an RPC request is invalid. */
@@ -58,7 +57,6 @@ export class RPCInvalidRequestError extends RPCError {
58
57
  statusCode: 400,
59
58
  expose: true,
60
59
  });
61
- this.name = "RPCInvalidRequestError";
62
60
  }
63
61
  }
64
62
  //# sourceMappingURL=rpcError.base.js.map