@venizia/ignis-helpers 0.4.8-0 → 0.4.8-2

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 (332) hide show
  1. package/README.md +1 -0
  2. package/dist/esm/common/constants/app.d.ts +15 -0
  3. package/dist/esm/common/constants/app.js +14 -0
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/duration.d.ts +2 -0
  6. package/dist/esm/common/constants/duration.js.map +1 -1
  7. package/dist/esm/common/constants/grpc.d.ts +3 -0
  8. package/dist/esm/common/constants/grpc.js +1 -0
  9. package/dist/esm/common/constants/grpc.js.map +1 -1
  10. package/dist/esm/common/constants/http.d.ts +4 -0
  11. package/dist/esm/common/constants/http.js +1 -0
  12. package/dist/esm/common/constants/http.js.map +1 -1
  13. package/dist/esm/common/constants/mime.d.ts +4 -0
  14. package/dist/esm/common/constants/mime.js +1 -0
  15. package/dist/esm/common/constants/mime.js.map +1 -1
  16. package/dist/esm/common/redact.d.ts +2 -0
  17. package/dist/esm/common/redact.js +2 -0
  18. package/dist/esm/common/redact.js.map +1 -1
  19. package/dist/esm/common/resolvers.d.ts +1 -0
  20. package/dist/esm/common/resolvers.js +1 -0
  21. package/dist/esm/common/resolvers.js.map +1 -1
  22. package/dist/esm/common/types/class.d.ts +6 -0
  23. package/dist/esm/common/types/class.js.map +1 -1
  24. package/dist/esm/common/types/const-value.d.ts +3 -0
  25. package/dist/esm/common/types/const-value.js.map +1 -1
  26. package/dist/esm/common/types/field-mapping.d.ts +3 -0
  27. package/dist/esm/common/types/field-mapping.js.map +1 -1
  28. package/dist/esm/common/types/injection.d.ts +2 -0
  29. package/dist/esm/common/types/injection.js.map +1 -1
  30. package/dist/esm/common/types/utility.d.ts +9 -0
  31. package/dist/esm/common/types/utility.js.map +1 -1
  32. package/dist/esm/modules/base.d.ts +1 -0
  33. package/dist/esm/modules/base.js +1 -0
  34. package/dist/esm/modules/base.js.map +1 -1
  35. package/dist/esm/modules/cron/helper.d.ts +7 -0
  36. package/dist/esm/modules/cron/helper.js +1 -0
  37. package/dist/esm/modules/cron/helper.js.map +1 -1
  38. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts +2 -0
  39. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  40. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts +1 -0
  41. package/dist/esm/modules/crypto/algorithms/base.algorithm.js +1 -0
  42. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  43. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts +12 -4
  44. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js +4 -4
  45. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js.map +1 -1
  46. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts +3 -0
  47. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
  48. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts +1 -0
  49. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
  50. package/dist/esm/modules/crypto/common/constants.d.ts +12 -1
  51. package/dist/esm/modules/crypto/common/constants.js +9 -1
  52. package/dist/esm/modules/crypto/common/constants.js.map +1 -1
  53. package/dist/esm/modules/crypto/common/types.d.ts +1 -0
  54. package/dist/esm/modules/crypto/common/types.js.map +1 -1
  55. package/dist/esm/modules/env/app-env.d.ts +3 -0
  56. package/dist/esm/modules/env/app-env.js +3 -0
  57. package/dist/esm/modules/env/app-env.js.map +1 -1
  58. package/dist/esm/modules/env/common/types.d.ts +1 -0
  59. package/dist/esm/modules/env/common/types.js.map +1 -1
  60. package/dist/esm/modules/logger/common/constants.d.ts +3 -0
  61. package/dist/esm/modules/logger/common/constants.js +2 -0
  62. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  63. package/dist/esm/modules/logger/common/types.d.ts +2 -0
  64. package/dist/esm/modules/logger/common/types.js +1 -0
  65. package/dist/esm/modules/logger/common/types.js.map +1 -1
  66. package/dist/esm/modules/logger/formatting/deep-splat.d.ts +1 -0
  67. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -0
  68. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  69. package/dist/esm/modules/logger/hf/common/types.d.ts +7 -2
  70. package/dist/esm/modules/logger/hf/common/types.js.map +1 -1
  71. package/dist/esm/modules/logger/winston/common/types.d.ts +31 -3
  72. package/dist/esm/modules/logger/winston/common/types.js.map +1 -1
  73. package/dist/esm/modules/logger/winston/define.d.ts +1 -0
  74. package/dist/esm/modules/logger/winston/define.js +1 -0
  75. package/dist/esm/modules/logger/winston/define.js.map +1 -1
  76. package/dist/esm/modules/logger/winston/logger.d.ts +1 -0
  77. package/dist/esm/modules/logger/winston/logger.js +1 -0
  78. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  79. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -0
  80. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -0
  81. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  82. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +1 -0
  83. package/dist/esm/modules/network/http-request/base-network-request.helper.js +1 -0
  84. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  85. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +8 -8
  86. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +2 -0
  87. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  88. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -0
  89. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  90. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +5 -1
  91. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +2 -0
  92. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  93. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +11 -0
  94. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -0
  95. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  96. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -0
  97. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +1 -0
  98. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  99. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts +1 -0
  100. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js +1 -0
  101. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js.map +1 -1
  102. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts +1 -0
  103. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js +1 -0
  104. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js.map +1 -1
  105. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts +1 -0
  106. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js +1 -0
  107. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js.map +1 -1
  108. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts +1 -0
  109. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js +1 -0
  110. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js.map +1 -1
  111. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts +4 -0
  112. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +4 -0
  113. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  114. package/dist/esm/modules/network/utilities/query-string.d.ts +13 -2
  115. package/dist/esm/modules/network/utilities/query-string.js +2 -1
  116. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  117. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +2 -1
  118. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +1 -1
  119. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  120. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +18 -5
  121. package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
  122. package/dist/esm/modules/pool/common/types.d.ts +5 -1
  123. package/dist/esm/modules/pool/common/types.js.map +1 -1
  124. package/dist/esm/modules/queue/bullmq/helper.d.ts +13 -0
  125. package/dist/esm/modules/queue/bullmq/helper.js +4 -0
  126. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  127. package/dist/esm/modules/queue/common/hook.d.ts +1 -0
  128. package/dist/esm/modules/queue/common/hook.js +1 -0
  129. package/dist/esm/modules/queue/common/hook.js.map +1 -1
  130. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +8 -0
  131. package/dist/esm/modules/queue/internal/sequential/common/types.js +1 -0
  132. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  133. package/dist/esm/modules/queue/internal/sequential/helper.d.ts +4 -0
  134. package/dist/esm/modules/queue/internal/sequential/helper.js +4 -0
  135. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  136. package/dist/esm/modules/queue/kafka/base.d.ts +5 -0
  137. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  138. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts +3 -0
  139. package/dist/esm/modules/queue/kafka/bundler/common/constants.js +3 -0
  140. package/dist/esm/modules/queue/kafka/bundler/common/constants.js.map +1 -1
  141. package/dist/esm/modules/queue/kafka/common/constants.d.ts +8 -0
  142. package/dist/esm/modules/queue/kafka/common/constants.js +5 -0
  143. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  144. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts +1 -0
  145. package/dist/esm/modules/queue/kafka/common/types/admin.js.map +1 -1
  146. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts +12 -0
  147. package/dist/esm/modules/queue/kafka/common/types/callbacks.js.map +1 -1
  148. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts +2 -0
  149. package/dist/esm/modules/queue/kafka/common/types/connection.js.map +1 -1
  150. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts +62 -0
  151. package/dist/esm/modules/queue/kafka/common/types/consumer.js.map +1 -1
  152. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts +1 -0
  153. package/dist/esm/modules/queue/kafka/common/types/producer.js.map +1 -1
  154. package/dist/esm/modules/queue/mqtt/helper.d.ts +2 -0
  155. package/dist/esm/modules/queue/mqtt/helper.js +1 -0
  156. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  157. package/dist/esm/modules/redis/base/abstract.helper.d.ts +2 -0
  158. package/dist/esm/modules/redis/base/abstract.helper.js +2 -0
  159. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  160. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -0
  161. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -0
  162. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  163. package/dist/esm/modules/redis/common/constants.d.ts +4 -0
  164. package/dist/esm/modules/redis/common/constants.js +2 -0
  165. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  166. package/dist/esm/modules/redis/common/interfaces.d.ts +12 -0
  167. package/dist/esm/modules/redis/common/interfaces.js.map +1 -1
  168. package/dist/esm/modules/redis/common/types.d.ts +21 -1
  169. package/dist/esm/modules/redis/common/types.js.map +1 -1
  170. package/dist/esm/modules/redis/factory.d.ts +2 -0
  171. package/dist/esm/modules/redis/factory.js +1 -0
  172. package/dist/esm/modules/redis/factory.js.map +1 -1
  173. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -0
  174. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -0
  175. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  176. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -0
  177. package/dist/esm/modules/redis/single/single.helper.js +1 -0
  178. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  179. package/dist/esm/modules/redis/utility.d.ts +1 -0
  180. package/dist/esm/modules/redis/utility.js +1 -0
  181. package/dist/esm/modules/redis/utility.js.map +1 -1
  182. package/dist/esm/modules/retry/common/constants.d.ts +4 -0
  183. package/dist/esm/modules/retry/common/constants.js +2 -0
  184. package/dist/esm/modules/retry/common/constants.js.map +1 -1
  185. package/dist/esm/modules/retry/common/types.d.ts +19 -5
  186. package/dist/esm/modules/retry/common/types.js.map +1 -1
  187. package/dist/esm/modules/retry/helper.d.ts +4 -4
  188. package/dist/esm/modules/retry/helper.js.map +1 -1
  189. package/dist/esm/modules/secrets/base/abstract.helper.d.ts +1 -0
  190. package/dist/esm/modules/secrets/base/abstract.helper.js +1 -0
  191. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  192. package/dist/esm/modules/secrets/common/constants.d.ts +4 -0
  193. package/dist/esm/modules/secrets/common/constants.js +2 -0
  194. package/dist/esm/modules/secrets/common/constants.js.map +1 -1
  195. package/dist/esm/modules/secrets/common/types/helper.d.ts +13 -0
  196. package/dist/esm/modules/secrets/common/types/helper.js.map +1 -1
  197. package/dist/esm/modules/secrets/common/types/lease.d.ts +2 -0
  198. package/dist/esm/modules/secrets/common/types/lease.js.map +1 -1
  199. package/dist/esm/modules/secrets/common/types/registration.d.ts +13 -2
  200. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  201. package/dist/esm/modules/secrets/common/types/timer.d.ts +1 -0
  202. package/dist/esm/modules/secrets/common/types/timer.js.map +1 -1
  203. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts +8 -0
  204. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -0
  205. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  206. package/dist/esm/modules/secrets/factory.d.ts +1 -0
  207. package/dist/esm/modules/secrets/factory.js +1 -0
  208. package/dist/esm/modules/secrets/factory.js.map +1 -1
  209. package/dist/esm/modules/secrets/hashicorp/auth.d.ts +2 -0
  210. package/dist/esm/modules/secrets/hashicorp/auth.js +1 -0
  211. package/dist/esm/modules/secrets/hashicorp/auth.js.map +1 -1
  212. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +2 -0
  213. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +1 -0
  214. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  215. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts +1 -0
  216. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js +1 -0
  217. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
  218. package/dist/esm/modules/slug/common/constants.d.ts +1 -0
  219. package/dist/esm/modules/slug/common/constants.js +1 -0
  220. package/dist/esm/modules/slug/common/constants.js.map +1 -1
  221. package/dist/esm/modules/socket/socket-io/common/constants.d.ts +2 -0
  222. package/dist/esm/modules/socket/socket-io/common/constants.js +2 -0
  223. package/dist/esm/modules/socket/socket-io/common/constants.js.map +1 -1
  224. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +5 -0
  225. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  226. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts +4 -0
  227. package/dist/esm/modules/socket/socket-io/common/types/hooks.js.map +1 -1
  228. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +6 -0
  229. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  230. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +1 -0
  231. package/dist/esm/modules/socket/socket-io/server/helper.js +1 -0
  232. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  233. package/dist/esm/modules/socket/websocket/common/constants.d.ts +7 -0
  234. package/dist/esm/modules/socket/websocket/common/constants.js +5 -0
  235. package/dist/esm/modules/socket/websocket/common/constants.js.map +1 -1
  236. package/dist/esm/modules/socket/websocket/common/types/client.d.ts +4 -0
  237. package/dist/esm/modules/socket/websocket/common/types/client.js.map +1 -1
  238. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts +7 -0
  239. package/dist/esm/modules/socket/websocket/common/types/hooks.js.map +1 -1
  240. package/dist/esm/modules/socket/websocket/common/types/server.d.ts +30 -0
  241. package/dist/esm/modules/socket/websocket/common/types/server.js.map +1 -1
  242. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts +1 -0
  243. package/dist/esm/modules/socket/websocket/emitter/helper.js +1 -0
  244. package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
  245. package/dist/esm/modules/socket/websocket/server/helper.d.ts +1 -0
  246. package/dist/esm/modules/socket/websocket/server/helper.js +1 -0
  247. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  248. package/dist/esm/modules/storage/base.d.ts +6 -1
  249. package/dist/esm/modules/storage/base.js +1 -0
  250. package/dist/esm/modules/storage/base.js.map +1 -1
  251. package/dist/esm/modules/storage/bun-s3/helper.d.ts +9 -1
  252. package/dist/esm/modules/storage/bun-s3/helper.js +2 -1
  253. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  254. package/dist/esm/modules/storage/common/constants.d.ts +1 -0
  255. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  256. package/dist/esm/modules/storage/common/types.d.ts +17 -1
  257. package/dist/esm/modules/storage/common/types.js.map +1 -1
  258. package/dist/esm/modules/storage/common/utility.d.ts +1 -0
  259. package/dist/esm/modules/storage/common/utility.js +1 -0
  260. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  261. package/dist/esm/modules/storage/disk/helper.d.ts +2 -0
  262. package/dist/esm/modules/storage/disk/helper.js +1 -0
  263. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  264. package/dist/esm/modules/temporal/abstract.d.ts +5 -0
  265. package/dist/esm/modules/temporal/abstract.js +2 -1
  266. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  267. package/dist/esm/modules/temporal/common/constants.d.ts +3 -0
  268. package/dist/esm/modules/temporal/common/constants.js.map +1 -1
  269. package/dist/esm/modules/tree/common/types.d.ts +6 -0
  270. package/dist/esm/modules/tree/common/types.js.map +1 -1
  271. package/dist/esm/modules/uid/common/constants.d.ts +1 -0
  272. package/dist/esm/modules/uid/common/constants.js.map +1 -1
  273. package/dist/esm/modules/uid/common/types.d.ts +28 -7
  274. package/dist/esm/modules/uid/common/types.js.map +1 -1
  275. package/dist/esm/modules/uid/helper.d.ts +12 -0
  276. package/dist/esm/modules/uid/helper.js.map +1 -1
  277. package/dist/esm/modules/uid/uuid/v4.d.ts +1 -0
  278. package/dist/esm/modules/uid/uuid/v4.js +1 -0
  279. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  280. package/dist/esm/modules/uid/uuid/v5.d.ts +1 -0
  281. package/dist/esm/modules/uid/uuid/v5.js +1 -0
  282. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  283. package/dist/esm/modules/uid/uuid/v7.d.ts +1 -0
  284. package/dist/esm/modules/uid/uuid/v7.js +1 -0
  285. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  286. package/dist/esm/modules/worker-thread/bus/abstract.d.ts +1 -0
  287. package/dist/esm/modules/worker-thread/bus/abstract.js +1 -0
  288. package/dist/esm/modules/worker-thread/bus/abstract.js.map +1 -1
  289. package/dist/esm/modules/worker-thread/bus/base.d.ts +1 -0
  290. package/dist/esm/modules/worker-thread/bus/base.js +1 -0
  291. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  292. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts +1 -0
  293. package/dist/esm/modules/worker-thread/bus/handler/abstract.js +1 -0
  294. package/dist/esm/modules/worker-thread/bus/handler/abstract.js.map +1 -1
  295. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts +1 -0
  296. package/dist/esm/modules/worker-thread/bus/handler/base.js +1 -0
  297. package/dist/esm/modules/worker-thread/bus/handler/base.js.map +1 -1
  298. package/dist/esm/modules/worker-thread/common/types.d.ts +4 -0
  299. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  300. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +1 -0
  301. package/dist/esm/modules/worker-thread/thread/abstract.js +1 -0
  302. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  303. package/dist/esm/modules/worker-thread/thread/base.d.ts +1 -0
  304. package/dist/esm/modules/worker-thread/thread/base.js +1 -0
  305. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  306. package/dist/esm/modules/worker-thread/worker/abstract.d.ts +1 -0
  307. package/dist/esm/modules/worker-thread/worker/abstract.js +1 -0
  308. package/dist/esm/modules/worker-thread/worker/abstract.js.map +1 -1
  309. package/dist/esm/modules/worker-thread/worker/base.d.ts +1 -0
  310. package/dist/esm/modules/worker-thread/worker/base.js +1 -0
  311. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  312. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -0
  313. package/dist/esm/modules/worker-thread/worker-pool.js +1 -0
  314. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  315. package/dist/esm/utilities/error.utility.d.ts +1 -0
  316. package/dist/esm/utilities/error.utility.js +1 -0
  317. package/dist/esm/utilities/error.utility.js.map +1 -1
  318. package/dist/esm/utilities/form-body.utility.d.ts +1 -0
  319. package/dist/esm/utilities/form-body.utility.js +1 -0
  320. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  321. package/dist/esm/utilities/hr-time.utility.d.ts +1 -0
  322. package/dist/esm/utilities/hr-time.utility.js +1 -0
  323. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  324. package/dist/esm/utilities/performance.utility.d.ts +1 -0
  325. package/dist/esm/utilities/performance.utility.js +1 -0
  326. package/dist/esm/utilities/performance.utility.js.map +1 -1
  327. package/dist/esm/utilities/promise.utility.d.ts +1 -0
  328. package/dist/esm/utilities/promise.utility.js.map +1 -1
  329. package/dist/esm/utilities/request.utility.d.ts +2 -0
  330. package/dist/esm/utilities/request.utility.js +1 -0
  331. package/dist/esm/utilities/request.utility.js.map +1 -1
  332. package/package.json +3 -3
@@ -1 +1 @@
1
- {"version":3,"file":"field-mapping.js","sourceRoot":"","sources":["../../../../src/common/types/field-mapping.ts"],"names":[],"mappings":"AAEA,6CAA6C;AAC7C,MAAM,OAAO,qBAAqB;aAChB,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,YAAO,GAAG,SAAS,CAAC;aACpB,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,OAAO;KACb,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import type { TConstValue } from './const-value';\n\n/** The value kinds a field mapping reads. */\nexport class FieldMappingDataTypes {\n static readonly STRING = 'string';\n static readonly NUMBER = 'number';\n static readonly STRINGS = 'strings';\n static readonly NUMBERS = 'numbers';\n static readonly BOOLEAN = 'boolean';\n\n static readonly SCHEME_SET = new Set<string>([\n this.STRING,\n this.NUMBER,\n this.STRINGS,\n this.NUMBERS,\n this.BOOLEAN,\n ]);\n\n static isValid(value: string): boolean {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** Valid field mapping data type values. */\nexport type TFieldMappingDataType = TConstValue<typeof FieldMappingDataTypes>;\n\nexport interface IFieldMapping {\n name: string;\n type: TFieldMappingDataType;\n default?: string | number | Array<string> | Array<number> | boolean;\n}\n\nexport type TFieldMappingNames<T extends Array<IFieldMapping>> = Extract<\n T[number],\n { type: Exclude<T[number]['type'], undefined> }\n>['name'];\n\nexport type TObjectFromFieldMappings<\n T extends readonly {\n name: string;\n type: string;\n [extra: string | symbol]: any;\n }[],\n> = {\n [K in T[number]['name']]: T extends {\n name: K;\n type: 'string';\n [extra: string | symbol]: any;\n }\n ? string\n : T extends { name: K; type: 'number'; [extra: string | symbol]: any }\n ? number\n : T extends { name: K; type: 'boolean'; [extra: string | symbol]: any }\n ? boolean\n : T extends { name: K; type: 'strings'; [extra: string | symbol]: any }\n ? string[]\n : T extends {\n name: K;\n type: 'numbers';\n [extra: string | symbol]: any;\n }\n ? number[]\n : never;\n};\n"]}
1
+ {"version":3,"file":"field-mapping.js","sourceRoot":"","sources":["../../../../src/common/types/field-mapping.ts"],"names":[],"mappings":"AAEA,6CAA6C;AAC7C,MAAM,OAAO,qBAAqB;aAChB,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,YAAO,GAAG,SAAS,CAAC;aACpB,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,OAAO;KACb,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import type { TConstValue } from './const-value';\n\n/** The value kinds a field mapping reads. */\nexport class FieldMappingDataTypes {\n static readonly STRING = 'string';\n static readonly NUMBER = 'number';\n static readonly STRINGS = 'strings';\n static readonly NUMBERS = 'numbers';\n static readonly BOOLEAN = 'boolean';\n\n static readonly SCHEME_SET = new Set<string>([\n this.STRING,\n this.NUMBER,\n this.STRINGS,\n this.NUMBERS,\n this.BOOLEAN,\n ]);\n\n static isValid(value: string): boolean {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** Valid field mapping data type values. */\nexport type TFieldMappingDataType = TConstValue<typeof FieldMappingDataTypes>;\n\n/** Describes one field to read: its `name`, its value `type`, and an optional `default`. */\nexport interface IFieldMapping {\n name: string;\n type: TFieldMappingDataType;\n default?: string | number | Array<string> | Array<number> | boolean;\n}\n\n/** The union of `name` values in a list of field mappings. */\nexport type TFieldMappingNames<T extends Array<IFieldMapping>> = Extract<\n T[number],\n { type: Exclude<T[number]['type'], undefined> }\n>['name'];\n\n/** The object a list of field mappings yields: one key per `name`, typed from its `type` (`string`, `number`, `boolean`, `strings` or `numbers`). Needs the list typed as a literal (`as const`) to narrow. */\nexport type TObjectFromFieldMappings<\n T extends readonly {\n name: string;\n type: string;\n [extra: string | symbol]: any;\n }[],\n> = {\n [K in T[number]['name']]: T extends {\n name: K;\n type: 'string';\n [extra: string | symbol]: any;\n }\n ? string\n : T extends { name: K; type: 'number'; [extra: string | symbol]: any }\n ? number\n : T extends { name: K; type: 'boolean'; [extra: string | symbol]: any }\n ? boolean\n : T extends { name: K; type: 'strings'; [extra: string | symbol]: any }\n ? string[]\n : T extends {\n name: K;\n type: 'numbers';\n [extra: string | symbol]: any;\n }\n ? number[]\n : never;\n};\n"]}
@@ -1,7 +1,9 @@
1
1
  import type { ValueOrPromise } from './utility.js';
2
+ /** Reads one value by binding `key` from the container; the caller supplies `T`. */
2
3
  export type TInjectionGetter = <T>(opts: {
3
4
  key: string | symbol;
4
5
  }) => T;
6
+ /** Something set up by a `configure` call, which may be asynchronous. */
5
7
  export interface IConfigurable<Options extends object = any, Result = any> {
6
8
  configure(opts?: Options): ValueOrPromise<Result>;
7
9
  }
@@ -1 +1 @@
1
- {"version":3,"file":"injection.js","sourceRoot":"","sources":["../../../../src/common/types/injection.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueOrPromise } from './utility';\n\nexport type TInjectionGetter = <T>(opts: { key: string | symbol }) => T;\n\nexport interface IConfigurable<Options extends object = any, Result = any> {\n configure(opts?: Options): ValueOrPromise<Result>;\n}\n"]}
1
+ {"version":3,"file":"injection.js","sourceRoot":"","sources":["../../../../src/common/types/injection.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueOrPromise } from './utility';\n\n/** Reads one value by binding `key` from the container; the caller supplies `T`. */\nexport type TInjectionGetter = <T>(opts: { key: string | symbol }) => T;\n\n/** Something set up by a `configure` call, which may be asynchronous. */\nexport interface IConfigurable<Options extends object = any, Result = any> {\n configure(opts?: Options): ValueOrPromise<Result>;\n}\n"]}
@@ -1,11 +1,20 @@
1
+ /** `T`, `undefined` or `null`. */
1
2
  export type TNullable<T> = T | undefined | null;
3
+ /** Escape hatch for a value of unknown shape; prefer a real type. */
2
4
  export type AnyType = any;
5
+ /** An object with any string, number or symbol keys. */
3
6
  export type AnyObject = Record<string | symbol | number, any>;
7
+ /** An options object of shape `T`; empty by default. */
4
8
  export type TOptions<T extends object = {}> = T;
9
+ /** `T` or a promise of `T`; `await` it to get `T` either way. */
5
10
  export type ValueOrPromise<T> = T | Promise<T>;
11
+ /** The union of the property value types of `T`. */
6
12
  export type ValueOf<T> = T[keyof T];
13
+ /** `T` with the keys `K` made optional. */
7
14
  export type ValueOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
15
+ /** `T` with every key optional except `K`. */
8
16
  export type ValueOptionalExcept<T, K extends keyof T> = Pick<T, K> & Partial<Omit<T, K>>;
17
+ /** Flattens an intersection of types into one object type, for readable hovers. */
9
18
  export type TPrettify<T> = {
10
19
  [K in keyof T]: T[K];
11
20
  } & {};
@@ -1 +1 @@
1
- {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../src/common/types/utility.ts"],"names":[],"mappings":"","sourcesContent":["export type TNullable<T> = T | undefined | null;\n\nexport type AnyType = any;\nexport type AnyObject = Record<string | symbol | number, any>;\n\nexport type TOptions<T extends object = {}> = T;\n\nexport type ValueOrPromise<T> = T | Promise<T>;\nexport type ValueOf<T> = T[keyof T];\n\nexport type ValueOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\nexport type ValueOptionalExcept<T, K extends keyof T> = Pick<T, K> & Partial<Omit<T, K>>;\n\nexport type TPrettify<T> = { [K in keyof T]: T[K] } & {};\n"]}
1
+ {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../src/common/types/utility.ts"],"names":[],"mappings":"","sourcesContent":["/** `T`, `undefined` or `null`. */\nexport type TNullable<T> = T | undefined | null;\n\n/** Escape hatch for a value of unknown shape; prefer a real type. */\nexport type AnyType = any;\n/** An object with any string, number or symbol keys. */\nexport type AnyObject = Record<string | symbol | number, any>;\n\n/** An options object of shape `T`; empty by default. */\nexport type TOptions<T extends object = {}> = T;\n\n/** `T` or a promise of `T`; `await` it to get `T` either way. */\nexport type ValueOrPromise<T> = T | Promise<T>;\n/** The union of the property value types of `T`. */\nexport type ValueOf<T> = T[keyof T];\n\n/** `T` with the keys `K` made optional. */\nexport type ValueOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\n/** `T` with every key optional except `K`. */\nexport type ValueOptionalExcept<T, K extends keyof T> = Pick<T, K> & Partial<Omit<T, K>>;\n\n/** Flattens an intersection of types into one object type, for readable hovers. */\nexport type TPrettify<T> = { [K in keyof T]: T[K] } & {};\n"]}
@@ -1,4 +1,5 @@
1
1
  import { type ILogger } from './logger/common/types.js';
2
+ /** Base for helpers: carries a `scope` and an `identifier`, and a `logger` scoped to both. */
2
3
  export declare class BaseHelper {
3
4
  scope: string;
4
5
  identifier: string;
@@ -8,6 +8,7 @@ const pinLogger = (opts) => {
8
8
  enumerable: false,
9
9
  });
10
10
  };
11
+ /** Base for helpers: carries a `scope` and an `identifier`, and a `logger` scoped to both. */
11
12
  export class BaseHelper {
12
13
  constructor(opts) {
13
14
  this.scope = opts.scope ?? '';
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,wNAAwN;AACxN,MAAM,SAAS,GAAG,CAAC,IAAyC,EAAQ,EAAE;IACpE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC3C,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,OAAO,UAAU;IAIrB,YAAY,IAA4C;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,+FAA+F;IAC/F,IAAI,MAAM;QACR,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CACjD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CACzD,CAAC;QACF,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE/C,qGAAqG;QACrG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YACjC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kGAAkG;IAClG,IAAI,MAAM,CAAC,KAAc;QACvB,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF","sourcesContent":["import { LoggerFactory } from '@/modules/logger/factory';\nimport { type ILogger } from '@/modules/logger/common/types';\n\n/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. A module function, not a private static: a mixin that extends `BaseHelper` could not be emitted with a private member. */\nconst pinLogger = (opts: { helper: object; logger: ILogger }): void => {\n Object.defineProperty(opts.helper, 'logger', {\n value: opts.logger,\n writable: true,\n configurable: true,\n enumerable: false,\n });\n};\n\nexport class BaseHelper {\n scope: string;\n identifier: string;\n\n constructor(opts: { scope: string; identifier?: string }) {\n this.scope = opts.scope ?? '';\n this.identifier = opts.identifier ?? '';\n }\n\n /** The helper's logger, resolved on first read - a helper that never logs never builds one. */\n get logger(): ILogger {\n const scopes = [this.scope, this.identifier].filter(\n (scope) => typeof scope === 'string' && scope.length > 0,\n );\n const logger = LoggerFactory.getLogger(scopes);\n\n // Read off a prototype (reflection walks them), pinning would shadow this getter for every instance.\n if (Object.hasOwn(this, 'scope')) {\n pinLogger({ helper: this, logger });\n }\n\n return logger;\n }\n\n /** Installs one logger on this helper - a test spy, or a host overriding the factory's logger. */\n set logger(value: ILogger) {\n pinLogger({ helper: this, logger: value });\n }\n\n getIdentifier() {\n return this.identifier;\n }\n\n getLogger(): ILogger {\n return this.logger;\n }\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,wNAAwN;AACxN,MAAM,SAAS,GAAG,CAAC,IAAyC,EAAQ,EAAE;IACpE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC3C,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,8FAA8F;AAC9F,MAAM,OAAO,UAAU;IAIrB,YAAY,IAA4C;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,+FAA+F;IAC/F,IAAI,MAAM;QACR,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CACjD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CACzD,CAAC;QACF,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE/C,qGAAqG;QACrG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YACjC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kGAAkG;IAClG,IAAI,MAAM,CAAC,KAAc;QACvB,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF","sourcesContent":["import { LoggerFactory } from '@/modules/logger/factory';\nimport { type ILogger } from '@/modules/logger/common/types';\n\n/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. A module function, not a private static: a mixin that extends `BaseHelper` could not be emitted with a private member. */\nconst pinLogger = (opts: { helper: object; logger: ILogger }): void => {\n Object.defineProperty(opts.helper, 'logger', {\n value: opts.logger,\n writable: true,\n configurable: true,\n enumerable: false,\n });\n};\n\n/** Base for helpers: carries a `scope` and an `identifier`, and a `logger` scoped to both. */\nexport class BaseHelper {\n scope: string;\n identifier: string;\n\n constructor(opts: { scope: string; identifier?: string }) {\n this.scope = opts.scope ?? '';\n this.identifier = opts.identifier ?? '';\n }\n\n /** The helper's logger, resolved on first read - a helper that never logs never builds one. */\n get logger(): ILogger {\n const scopes = [this.scope, this.identifier].filter(\n (scope) => typeof scope === 'string' && scope.length > 0,\n );\n const logger = LoggerFactory.getLogger(scopes);\n\n // Read off a prototype (reflection walks them), pinning would shadow this getter for every instance.\n if (Object.hasOwn(this, 'scope')) {\n pinLogger({ helper: this, logger });\n }\n\n return logger;\n }\n\n /** Installs one logger on this helper - a test spy, or a host overriding the factory's logger. */\n set logger(value: ILogger) {\n pinLogger({ helper: this, logger: value });\n }\n\n getIdentifier() {\n return this.identifier;\n }\n\n getLogger(): ILogger {\n return this.logger;\n }\n}\n"]}
@@ -1,13 +1,20 @@
1
1
  import { BaseHelper } from '../base.js';
2
2
  import { CronJob, type CronOnCompleteCommand } from 'cron';
3
+ /** Options for `CronHelper`. */
3
4
  export interface ICronHelperOptions {
4
5
  cronTime: string;
5
6
  onTick: () => void | Promise<void>;
6
7
  onCompleted?: CronOnCompleteCommand | null;
8
+ /**
9
+ * Starts the job on construction.
10
+ * @default false
11
+ */
7
12
  autoStart?: boolean;
13
+ /** The time zone the schedule is read in. */
8
14
  tz?: string;
9
15
  errorHandler?: (error: unknown) => void | null;
10
16
  }
17
+ /** Wraps one cron job. The constructor throws an `ApplicationError` when `cronTime` is empty or not a valid cron expression. */
11
18
  export declare class CronHelper extends BaseHelper {
12
19
  private cronTime;
13
20
  private onTick;
@@ -3,6 +3,7 @@ import { BaseHelper } from '../base.js';
3
3
  import { PromiseUtility } from '../../utilities/promise.utility.js';
4
4
  import { CronJob, CronTime } from 'cron';
5
5
  import { ApplicationError } from '../error/index.js';
6
+ /** Wraps one cron job. The constructor throws an `ApplicationError` when `cronTime` is empty or not a valid cron expression. */
6
7
  export class CronHelper extends BaseHelper {
7
8
  constructor(opts) {
8
9
  super({ scope: CronHelper.name, identifier: opts.cronTime ?? CronHelper.name });
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/cron/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport { BaseHelper } from '@/modules/base';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { CronJob, type CronOnCompleteCommand, CronTime } from 'cron';\nimport { ApplicationError } from '../error';\n\nexport interface ICronHelperOptions {\n cronTime: string;\n onTick: () => void | Promise<void>;\n onCompleted?: CronOnCompleteCommand | null;\n autoStart?: boolean;\n tz?: string;\n errorHandler?: (error: unknown) => void | null;\n}\n\nexport class CronHelper extends BaseHelper {\n private cronTime: string;\n private onTick: () => void | Promise<void>;\n private onCompleted?: CronOnCompleteCommand | null;\n private autoStart: boolean;\n private tz?: string;\n private errorHandler?: (error: unknown) => void | null;\n\n public instance: CronJob;\n\n constructor(opts: ICronHelperOptions) {\n super({ scope: CronHelper.name, identifier: opts.cronTime ?? CronHelper.name });\n\n const { cronTime, onTick, onCompleted, autoStart = false, tz, errorHandler } = opts;\n this.cronTime = cronTime;\n this.onTick = onTick;\n this.onCompleted = onCompleted;\n this.autoStart = autoStart ?? false;\n this.tz = tz;\n this.errorHandler = errorHandler;\n\n this.buildInstance();\n }\n\n static newInstance(opts: ICronHelperOptions) {\n return new CronHelper(opts);\n }\n\n /** Builds the job. Synchronous, so the constructor still THROWS on a bad cronTime. */\n protected buildInstance(): void {\n if (!this.cronTime || ObjectUtility.isEmpty({ value: this.cronTime })) {\n throw ApplicationError.getError({\n message: '[CronHelper][configure] Invalid cronTime to configure application cron!',\n });\n }\n\n try {\n this.instance = CronJob.from({\n cronTime: this.cronTime,\n onTick: this.onTick,\n onComplete: this.onCompleted,\n start: this.autoStart,\n errorHandler: this.errorHandler,\n timeZone: this.tz,\n });\n } catch (error) {\n throw ApplicationError.getError({\n message: `[CronHelper][configure] Invalid cron expression | cronTime: ${this.cronTime} | error: ${error}`,\n });\n }\n }\n\n /** Async because `CronJob.stop()` resolves only once an in-flight tick finishes; fire-and-forgetting it would let the replacement job start while the old handler is still running. */\n async configure(): Promise<void> {\n if (this.instance) {\n await this.instance.stop();\n }\n\n this.buildInstance();\n }\n\n start() {\n if (!this.instance) {\n this.logger.for('start').error(' Invalid cron instance to start cronjob!');\n\n return;\n }\n\n this.instance.start();\n }\n\n async stop() {\n if (!this.instance) {\n this.logger.for(this.stop.name).error('Invalid cron instance to stop cronjob!');\n\n return;\n }\n\n await this.instance.stop();\n }\n\n modifyCronTime(opts: { cronTime: string; shouldFireOnTick?: boolean }) {\n const { cronTime, shouldFireOnTick = false } = opts;\n\n let nextCronTime: CronTime;\n\n try {\n nextCronTime = new CronTime(cronTime, this.tz);\n } catch (error) {\n throw ApplicationError.getError({\n message: `[CronHelper][modifyCronTime] Invalid cron expression | cronTime: ${cronTime} | error: ${error}`,\n });\n }\n\n this.instance.setTime(nextCronTime);\n this.cronTime = cronTime;\n\n if (shouldFireOnTick) {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.modifyCronTime.name,\n execution: this.instance.fireOnTick(),\n });\n }\n }\n\n duplicate(opts: { cronTime: string }) {\n const { cronTime } = opts;\n\n const options: ICronHelperOptions = {\n cronTime: cronTime,\n onTick: this.onTick,\n onCompleted: this.onCompleted,\n autoStart: this.autoStart,\n tz: this.tz,\n errorHandler: this.errorHandler,\n };\n\n return CronHelper.newInstance(options);\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/cron/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport { BaseHelper } from '@/modules/base';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { CronJob, type CronOnCompleteCommand, CronTime } from 'cron';\nimport { ApplicationError } from '../error';\n\n/** Options for `CronHelper`. */\nexport interface ICronHelperOptions {\n cronTime: string;\n onTick: () => void | Promise<void>;\n onCompleted?: CronOnCompleteCommand | null;\n /**\n * Starts the job on construction.\n * @default false\n */\n autoStart?: boolean;\n /** The time zone the schedule is read in. */\n tz?: string;\n errorHandler?: (error: unknown) => void | null;\n}\n\n/** Wraps one cron job. The constructor throws an `ApplicationError` when `cronTime` is empty or not a valid cron expression. */\nexport class CronHelper extends BaseHelper {\n private cronTime: string;\n private onTick: () => void | Promise<void>;\n private onCompleted?: CronOnCompleteCommand | null;\n private autoStart: boolean;\n private tz?: string;\n private errorHandler?: (error: unknown) => void | null;\n\n public instance: CronJob;\n\n constructor(opts: ICronHelperOptions) {\n super({ scope: CronHelper.name, identifier: opts.cronTime ?? CronHelper.name });\n\n const { cronTime, onTick, onCompleted, autoStart = false, tz, errorHandler } = opts;\n this.cronTime = cronTime;\n this.onTick = onTick;\n this.onCompleted = onCompleted;\n this.autoStart = autoStart ?? false;\n this.tz = tz;\n this.errorHandler = errorHandler;\n\n this.buildInstance();\n }\n\n static newInstance(opts: ICronHelperOptions) {\n return new CronHelper(opts);\n }\n\n /** Builds the job. Synchronous, so the constructor still THROWS on a bad cronTime. */\n protected buildInstance(): void {\n if (!this.cronTime || ObjectUtility.isEmpty({ value: this.cronTime })) {\n throw ApplicationError.getError({\n message: '[CronHelper][configure] Invalid cronTime to configure application cron!',\n });\n }\n\n try {\n this.instance = CronJob.from({\n cronTime: this.cronTime,\n onTick: this.onTick,\n onComplete: this.onCompleted,\n start: this.autoStart,\n errorHandler: this.errorHandler,\n timeZone: this.tz,\n });\n } catch (error) {\n throw ApplicationError.getError({\n message: `[CronHelper][configure] Invalid cron expression | cronTime: ${this.cronTime} | error: ${error}`,\n });\n }\n }\n\n /** Async because `CronJob.stop()` resolves only once an in-flight tick finishes; fire-and-forgetting it would let the replacement job start while the old handler is still running. */\n async configure(): Promise<void> {\n if (this.instance) {\n await this.instance.stop();\n }\n\n this.buildInstance();\n }\n\n start() {\n if (!this.instance) {\n this.logger.for('start').error(' Invalid cron instance to start cronjob!');\n\n return;\n }\n\n this.instance.start();\n }\n\n async stop() {\n if (!this.instance) {\n this.logger.for(this.stop.name).error('Invalid cron instance to stop cronjob!');\n\n return;\n }\n\n await this.instance.stop();\n }\n\n modifyCronTime(opts: { cronTime: string; shouldFireOnTick?: boolean }) {\n const { cronTime, shouldFireOnTick = false } = opts;\n\n let nextCronTime: CronTime;\n\n try {\n nextCronTime = new CronTime(cronTime, this.tz);\n } catch (error) {\n throw ApplicationError.getError({\n message: `[CronHelper][modifyCronTime] Invalid cron expression | cronTime: ${cronTime} | error: ${error}`,\n });\n }\n\n this.instance.setTime(nextCronTime);\n this.cronTime = cronTime;\n\n if (shouldFireOnTick) {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.modifyCronTime.name,\n execution: this.instance.fireOnTick(),\n });\n }\n }\n\n duplicate(opts: { cronTime: string }) {\n const { cronTime } = opts;\n\n const options: ICronHelperOptions = {\n cronTime: cronTime,\n onTick: this.onTick,\n onCompleted: this.onCompleted,\n autoStart: this.autoStart,\n tz: this.tz,\n errorHandler: this.errorHandler,\n };\n\n return CronHelper.newInstance(options);\n }\n}\n"]}
@@ -13,10 +13,12 @@ interface IAESDecryptOptions {
13
13
  interface IAESExtraOptions extends IAESDecryptOptions {
14
14
  iv?: Buffer;
15
15
  }
16
+ /** One key in a keyring: `id` is written into the ciphertext so decrypt can pick the matching `secret`. */
16
17
  export interface IAESKeyringEntry {
17
18
  id: string;
18
19
  secret: string;
19
20
  }
21
+ /** A single secret string, or a keyring. Encrypt uses the first keyring entry; decrypt uses the entry whose `id` matches the ciphertext. */
20
22
  export type TAESSecret = string | IAESKeyringEntry[];
21
23
  export { AESAlgorithms, type AESAlgorithmType };
22
24
  /** `encrypt` and `decrypt` are async: key derivation and the cipher run over `crypto.subtle`. */
@@ -1 +1 @@
1
- {"version":3,"file":"aes.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { AESAlgorithms, type AESAlgorithmType } from './aes.constants';\nimport { ObjectUtility } from '@venizia/ignis-inversion';\nimport fs from 'node:fs';\nimport { getError } from '@/modules/error';\nimport { AesEngine } from './aes.engine';\nimport { BaseCryptoAlgorithm } from './base.algorithm';\n\nconst DEFAULT_LENGTH = 16;\nconst CIPHERTEXT_VERSION = 0x01;\nconst DEFAULT_KEY_ID = '0';\n\ninterface IAESDecryptOptions {\n inputEncoding?: BufferEncoding;\n outputEncoding?: BufferEncoding;\n doThrow?: boolean;\n /** Per-deployment PBKDF2 salt override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfSalt?: string;\n /** PBKDF2 iteration count override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfIterations?: number;\n}\n\n/** `iv` is encrypt-only: the envelope carries the IV, so decrypt reads it from there and a supplied one would be silently ignored. */\ninterface IAESExtraOptions extends IAESDecryptOptions {\n iv?: Buffer;\n}\n\nexport interface IAESKeyringEntry {\n id: string;\n secret: string;\n}\n\nexport type TAESSecret = string | IAESKeyringEntry[];\n\nexport { AESAlgorithms, type AESAlgorithmType };\n\n/** `encrypt` and `decrypt` are async: key derivation and the cipher run over `crypto.subtle`. */\nexport class AES extends BaseCryptoAlgorithm<\n AESAlgorithmType,\n string,\n string,\n TAESSecret,\n Promise<string>,\n Promise<string>,\n IAESExtraOptions\n> {\n constructor(opts: { algorithm: AESAlgorithmType }) {\n super({ scope: AES.name, ...opts });\n }\n\n static withAlgorithm(algorithm: AESAlgorithmType) {\n return new AES({ algorithm });\n }\n\n protected async resolveEncryptKey(opts: {\n secret: TAESSecret;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Promise<{ id: string; key: Buffer }> {\n const { secret, kdfSalt, kdfIterations } = opts;\n const entry = Array.isArray(secret) ? secret[0] : { id: DEFAULT_KEY_ID, secret };\n\n if (!entry || ObjectUtility.isEmpty({ value: entry.secret })) {\n throw getError({ message: '[AES][resolveEncryptKey] Missing secret or empty keyring' });\n }\n\n const key = await this.normalizeSecretKey({\n secret: entry.secret,\n length: this.getAlgorithmKeySize(),\n kdfSalt,\n kdfIterations,\n });\n\n return { id: entry.id, key };\n }\n\n protected async resolveDecryptKey(opts: {\n secret: TAESSecret;\n id: string;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Promise<Buffer> {\n const { secret, id, kdfSalt, kdfIterations } = opts;\n const length = this.getAlgorithmKeySize();\n\n if (!Array.isArray(secret)) {\n return this.normalizeSecretKey({ secret, length, kdfSalt, kdfIterations });\n }\n\n const entry = secret.find((e) => e.id === id);\n\n if (!entry) {\n throw getError({\n message: `[AES][resolveDecryptKey] No key in keyring matches ciphertext key id \"${id}\"`,\n });\n }\n\n // Without this the empty secret derives a key from '' and fails as an opaque OpenSSL error, hiding a plain configuration mistake.\n if (ObjectUtility.isEmpty({ value: entry.secret })) {\n throw getError({\n message: `[AES][resolveDecryptKey] Keyring entry for key id \"${id}\" has an empty secret`,\n });\n }\n\n return this.normalizeSecretKey({\n secret: entry.secret,\n length,\n kdfSalt,\n kdfIterations,\n });\n }\n\n async encrypt(opts: {\n message: string;\n secret: TAESSecret;\n opts?: IAESExtraOptions;\n }): Promise<string> {\n const { message, secret } = opts;\n const {\n iv = Buffer.from(crypto.getRandomValues(new Uint8Array(DEFAULT_LENGTH))),\n inputEncoding = 'utf-8',\n outputEncoding = 'base64',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const { id, key } = await this.resolveEncryptKey({ secret, kdfSalt, kdfIterations });\n const idBuffer = Buffer.from(id, 'utf-8');\n\n if (idBuffer.length > 0xff) {\n throw getError({ message: '[AES][encrypt] Key id too long (max 255 bytes)' });\n }\n\n // `decrypt` reads exactly DEFAULT_LENGTH bytes of IV from the envelope, so any other length would write a ciphertext nothing can read.\n if (iv.length !== DEFAULT_LENGTH) {\n throw getError({\n message: `[AES][encrypt] The IV must be ${DEFAULT_LENGTH} bytes, got ${iv.length}`,\n });\n }\n\n const { cipherText, authTag } = await AesEngine.seal({\n algorithm: this.algorithm,\n key,\n iv,\n plain: Buffer.from(message, inputEncoding),\n });\n\n // Envelope: [version(1)][idLen(1)][id(idLen)][iv(16)][authTag(16, gcm only)][cipher]\n const header = Buffer.from([CIPHERTEXT_VERSION, idBuffer.length]);\n const parts: Uint8Array[] = [header, idBuffer, iv];\n\n if (authTag !== null) {\n parts.push(authTag);\n }\n\n parts.push(cipherText);\n\n return Buffer.concat(parts).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n async encryptFile(opts: { absolutePath: string; secret: TAESSecret }): Promise<string> {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || ObjectUtility.isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n\n return this.encrypt({ message: fileContent, secret });\n }\n\n async decrypt(opts: {\n message: string;\n secret: TAESSecret;\n opts?: IAESDecryptOptions;\n }): Promise<string> {\n const { message, secret } = opts;\n const {\n inputEncoding = 'base64',\n outputEncoding = 'utf-8',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const raw = Buffer.from(message, inputEncoding);\n\n const version = raw[0];\n\n if (version !== CIPHERTEXT_VERSION) {\n throw getError({ message: `[AES][decrypt] Unsupported ciphertext version: ${version}` });\n }\n\n const idLength = raw[1];\n let cursor = 2;\n\n const id = raw.subarray(cursor, cursor + idLength).toString('utf-8');\n cursor += idLength;\n\n const iv = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n\n const key = await this.resolveDecryptKey({ secret, id, kdfSalt, kdfIterations });\n\n let authTag: Uint8Array | null = null;\n\n if (this.algorithm === AESAlgorithms.AES_256_GCM) {\n authTag = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n }\n\n const plain = await AesEngine.open({\n algorithm: this.algorithm,\n key,\n iv,\n cipherText: raw.subarray(cursor),\n authTag,\n });\n\n return Buffer.from(plain).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n async decryptFile(opts: { absolutePath: string; secret: TAESSecret }): Promise<string> {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || ObjectUtility.isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n\n return this.decrypt({ message: fileContent, secret });\n }\n}\n"]}
1
+ {"version":3,"file":"aes.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { AESAlgorithms, type AESAlgorithmType } from './aes.constants';\nimport { ObjectUtility } from '@venizia/ignis-inversion';\nimport fs from 'node:fs';\nimport { getError } from '@/modules/error';\nimport { AesEngine } from './aes.engine';\nimport { BaseCryptoAlgorithm } from './base.algorithm';\n\nconst DEFAULT_LENGTH = 16;\nconst CIPHERTEXT_VERSION = 0x01;\nconst DEFAULT_KEY_ID = '0';\n\ninterface IAESDecryptOptions {\n inputEncoding?: BufferEncoding;\n outputEncoding?: BufferEncoding;\n doThrow?: boolean;\n /** Per-deployment PBKDF2 salt override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfSalt?: string;\n /** PBKDF2 iteration count override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfIterations?: number;\n}\n\n/** `iv` is encrypt-only: the envelope carries the IV, so decrypt reads it from there and a supplied one would be silently ignored. */\ninterface IAESExtraOptions extends IAESDecryptOptions {\n iv?: Buffer;\n}\n\n/** One key in a keyring: `id` is written into the ciphertext so decrypt can pick the matching `secret`. */\nexport interface IAESKeyringEntry {\n id: string;\n secret: string;\n}\n\n/** A single secret string, or a keyring. Encrypt uses the first keyring entry; decrypt uses the entry whose `id` matches the ciphertext. */\nexport type TAESSecret = string | IAESKeyringEntry[];\n\nexport { AESAlgorithms, type AESAlgorithmType };\n\n/** `encrypt` and `decrypt` are async: key derivation and the cipher run over `crypto.subtle`. */\nexport class AES extends BaseCryptoAlgorithm<\n AESAlgorithmType,\n string,\n string,\n TAESSecret,\n Promise<string>,\n Promise<string>,\n IAESExtraOptions\n> {\n constructor(opts: { algorithm: AESAlgorithmType }) {\n super({ scope: AES.name, ...opts });\n }\n\n static withAlgorithm(algorithm: AESAlgorithmType) {\n return new AES({ algorithm });\n }\n\n protected async resolveEncryptKey(opts: {\n secret: TAESSecret;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Promise<{ id: string; key: Buffer }> {\n const { secret, kdfSalt, kdfIterations } = opts;\n const entry = Array.isArray(secret) ? secret[0] : { id: DEFAULT_KEY_ID, secret };\n\n if (!entry || ObjectUtility.isEmpty({ value: entry.secret })) {\n throw getError({ message: '[AES][resolveEncryptKey] Missing secret or empty keyring' });\n }\n\n const key = await this.normalizeSecretKey({\n secret: entry.secret,\n length: this.getAlgorithmKeySize(),\n kdfSalt,\n kdfIterations,\n });\n\n return { id: entry.id, key };\n }\n\n protected async resolveDecryptKey(opts: {\n secret: TAESSecret;\n id: string;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Promise<Buffer> {\n const { secret, id, kdfSalt, kdfIterations } = opts;\n const length = this.getAlgorithmKeySize();\n\n if (!Array.isArray(secret)) {\n return this.normalizeSecretKey({ secret, length, kdfSalt, kdfIterations });\n }\n\n const entry = secret.find((e) => e.id === id);\n\n if (!entry) {\n throw getError({\n message: `[AES][resolveDecryptKey] No key in keyring matches ciphertext key id \"${id}\"`,\n });\n }\n\n // Without this the empty secret derives a key from '' and fails as an opaque OpenSSL error, hiding a plain configuration mistake.\n if (ObjectUtility.isEmpty({ value: entry.secret })) {\n throw getError({\n message: `[AES][resolveDecryptKey] Keyring entry for key id \"${id}\" has an empty secret`,\n });\n }\n\n return this.normalizeSecretKey({\n secret: entry.secret,\n length,\n kdfSalt,\n kdfIterations,\n });\n }\n\n async encrypt(opts: {\n message: string;\n secret: TAESSecret;\n opts?: IAESExtraOptions;\n }): Promise<string> {\n const { message, secret } = opts;\n const {\n iv = Buffer.from(crypto.getRandomValues(new Uint8Array(DEFAULT_LENGTH))),\n inputEncoding = 'utf-8',\n outputEncoding = 'base64',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const { id, key } = await this.resolveEncryptKey({ secret, kdfSalt, kdfIterations });\n const idBuffer = Buffer.from(id, 'utf-8');\n\n if (idBuffer.length > 0xff) {\n throw getError({ message: '[AES][encrypt] Key id too long (max 255 bytes)' });\n }\n\n // `decrypt` reads exactly DEFAULT_LENGTH bytes of IV from the envelope, so any other length would write a ciphertext nothing can read.\n if (iv.length !== DEFAULT_LENGTH) {\n throw getError({\n message: `[AES][encrypt] The IV must be ${DEFAULT_LENGTH} bytes, got ${iv.length}`,\n });\n }\n\n const { cipherText, authTag } = await AesEngine.seal({\n algorithm: this.algorithm,\n key,\n iv,\n plain: Buffer.from(message, inputEncoding),\n });\n\n // Envelope: [version(1)][idLen(1)][id(idLen)][iv(16)][authTag(16, gcm only)][cipher]\n const header = Buffer.from([CIPHERTEXT_VERSION, idBuffer.length]);\n const parts: Uint8Array[] = [header, idBuffer, iv];\n\n if (authTag !== null) {\n parts.push(authTag);\n }\n\n parts.push(cipherText);\n\n return Buffer.concat(parts).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n async encryptFile(opts: { absolutePath: string; secret: TAESSecret }): Promise<string> {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || ObjectUtility.isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n\n return this.encrypt({ message: fileContent, secret });\n }\n\n async decrypt(opts: {\n message: string;\n secret: TAESSecret;\n opts?: IAESDecryptOptions;\n }): Promise<string> {\n const { message, secret } = opts;\n const {\n inputEncoding = 'base64',\n outputEncoding = 'utf-8',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const raw = Buffer.from(message, inputEncoding);\n\n const version = raw[0];\n\n if (version !== CIPHERTEXT_VERSION) {\n throw getError({ message: `[AES][decrypt] Unsupported ciphertext version: ${version}` });\n }\n\n const idLength = raw[1];\n let cursor = 2;\n\n const id = raw.subarray(cursor, cursor + idLength).toString('utf-8');\n cursor += idLength;\n\n const iv = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n\n const key = await this.resolveDecryptKey({ secret, id, kdfSalt, kdfIterations });\n\n let authTag: Uint8Array | null = null;\n\n if (this.algorithm === AESAlgorithms.AES_256_GCM) {\n authTag = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n }\n\n const plain = await AesEngine.open({\n algorithm: this.algorithm,\n key,\n iv,\n cipherText: raw.subarray(cursor),\n authTag,\n });\n\n return Buffer.from(plain).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n async decryptFile(opts: { absolutePath: string; secret: TAESSecret }): Promise<string> {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || ObjectUtility.isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n\n return this.decrypt({ message: fileContent, secret });\n }\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { AbstractCryptoAlgorithm } from './abstract.algorithm.js';
2
2
  export { AbstractCryptoAlgorithm } from './abstract.algorithm.js';
3
+ /** Base for the symmetric algorithms: validates the algorithm name and derives a key of a given length from a secret with PBKDF2. */
3
4
  export declare abstract class BaseCryptoAlgorithm<AlgorithmType extends string, EncryptInputType = unknown, DecryptInputType = unknown, SecretKeyType = unknown, EncryptReturnType = unknown, DecryptReturnType = unknown, ExtraOptions = unknown> extends AbstractCryptoAlgorithm<AlgorithmType, EncryptInputType, DecryptInputType, SecretKeyType, EncryptReturnType, DecryptReturnType, ExtraOptions> {
4
5
  constructor(opts: {
5
6
  scope: string;
@@ -8,6 +8,7 @@ const MAXIMUM_KDF_ITERATIONS = 2 ** 31 - 1;
8
8
  const KDF_HASH_NAMES = { sha256: 'SHA-256' };
9
9
  /** One entry per derivation. It holds the promise, so callers that arrive while it runs share it. */
10
10
  const DERIVED_KEY_CACHE = new Map();
11
+ /** Base for the symmetric algorithms: validates the algorithm name and derives a key of a given length from a secret with PBKDF2. */
11
12
  export class BaseCryptoAlgorithm extends AbstractCryptoAlgorithm {
12
13
  constructor(opts) {
13
14
  super({
@@ -1 +1 @@
1
- {"version":3,"file":"base.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/base.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { ParseUtility } from '@/utilities';\nimport {\n DEFAULT_CIPHER_BITS,\n DEFAULT_KDF_DIGEST,\n DEFAULT_KDF_ITERATIONS,\n DEFAULT_KDF_SALT,\n MINIMUM_KDF_SALT_BYTES,\n} from '../common';\nimport { AbstractCryptoAlgorithm } from './abstract.algorithm';\n\nexport { AbstractCryptoAlgorithm } from './abstract.algorithm';\n\nconst MAXIMUM_KDF_ITERATIONS = 2 ** 31 - 1;\n\n/** The Web Crypto name of each digest `DEFAULT_KDF_DIGEST` may hold. */\nconst KDF_HASH_NAMES: Record<string, string> = { sha256: 'SHA-256' };\n\n/** One entry per derivation. It holds the promise, so callers that arrive while it runs share it. */\nconst DERIVED_KEY_CACHE = new Map<string, Promise<Buffer>>();\n\nexport abstract class BaseCryptoAlgorithm<\n AlgorithmType extends string,\n EncryptInputType = unknown,\n DecryptInputType = unknown,\n SecretKeyType = unknown,\n EncryptReturnType = unknown,\n DecryptReturnType = unknown,\n ExtraOptions = unknown,\n> extends AbstractCryptoAlgorithm<\n AlgorithmType,\n EncryptInputType,\n DecryptInputType,\n SecretKeyType,\n EncryptReturnType,\n DecryptReturnType,\n ExtraOptions\n> {\n constructor(opts: { scope: string; algorithm: AlgorithmType }) {\n super({\n scope: opts.scope ?? opts.algorithm ?? BaseCryptoAlgorithm.name,\n identifier: opts.algorithm,\n });\n this.validateAlgorithmName({ algorithm: opts.algorithm });\n\n this.algorithm = opts.algorithm;\n }\n\n validateAlgorithmName(opts: { algorithm: AlgorithmType }) {\n const { algorithm } = opts;\n\n if (!algorithm) {\n throw getError({\n message: `[validateAlgorithmName] Invalid algorithm name | algorithm: ${algorithm}`,\n });\n }\n }\n\n /**\n * Omit `kdfSalt`/`kdfIterations` for the shipped default (byte-identical to every prior release). Supplying either requires supplying the same value again on decrypt.\n * Derived with PBKDF2 over `crypto.subtle`, once per secret: a second call, even one that starts while the first runs, shares its result.\n */\n async normalizeSecretKey(opts: {\n secret: string;\n length: number;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Promise<Buffer> {\n const { secret, length, kdfSalt, kdfIterations } = opts;\n\n if (kdfSalt !== undefined) {\n this.validateKdfSalt({ kdfSalt });\n }\n\n const salt = kdfSalt ?? DEFAULT_KDF_SALT;\n const iterations = kdfIterations ?? DEFAULT_KDF_ITERATIONS;\n\n // `pbkdf2Sync` refused anything but an integer from 1 up to 2^31 - 1; Web Crypto would round a fraction down and take up to 2^32 - 1.\n if (!Number.isInteger(iterations) || iterations < 1 || iterations > MAXIMUM_KDF_ITERATIONS) {\n throw getError({\n message: `[BaseCryptoAlgorithm][normalizeSecretKey] kdfIterations must be an integer from 1 to ${MAXIMUM_KDF_ITERATIONS}, got ${iterations}`,\n });\n }\n\n const cacheKey = `${DEFAULT_KDF_DIGEST}:${iterations}:${length}:${salt}:${secret}`;\n\n return this.deriveOnce({\n cacheKey,\n derive: () => this.derivePbkdf2({ secret, salt, iterations, length }),\n });\n }\n\n /** Runs `derive` once per `cacheKey`. A failed derivation leaves nothing behind, so the next call tries again. */\n private deriveOnce(opts: { cacheKey: string; derive: () => Promise<Buffer> }): Promise<Buffer> {\n const { cacheKey, derive } = opts;\n const pending = DERIVED_KEY_CACHE.get(cacheKey);\n\n if (pending) {\n return pending;\n }\n\n const derived = derive();\n DERIVED_KEY_CACHE.set(cacheKey, derived);\n derived.catch(() => {\n if (DERIVED_KEY_CACHE.get(cacheKey) === derived) {\n DERIVED_KEY_CACHE.delete(cacheKey);\n }\n });\n\n return derived;\n }\n\n private async derivePbkdf2(opts: {\n secret: string;\n salt: string;\n iterations: number;\n length: number;\n }): Promise<Buffer> {\n const { secret, salt, iterations, length } = opts;\n const hash = KDF_HASH_NAMES[DEFAULT_KDF_DIGEST];\n\n if (hash === undefined) {\n throw getError({\n message: `[BaseCryptoAlgorithm][derivePbkdf2] No Web Crypto name for the digest \"${DEFAULT_KDF_DIGEST}\"`,\n });\n }\n\n const encoder = new TextEncoder();\n const material = await crypto.subtle.importKey('raw', encoder.encode(secret), 'PBKDF2', false, [\n 'deriveBits',\n ]);\n const bits = await crypto.subtle.deriveBits(\n { name: 'PBKDF2', hash, salt: encoder.encode(salt), iterations },\n material,\n length * 8,\n );\n\n return Buffer.from(bits);\n }\n\n /** Rejects a `kdfSalt` short enough to look configured while giving up most of the protection a salt exists for (NIST SP 800-132: 128-bit minimum). */\n private validateKdfSalt(opts: { kdfSalt: string }): void {\n const { kdfSalt } = opts;\n const byteLength = Buffer.byteLength(kdfSalt, 'utf-8');\n\n if (byteLength < MINIMUM_KDF_SALT_BYTES) {\n throw getError({\n message: `[BaseCryptoAlgorithm][validateKdfSalt] kdfSalt must be at least ${MINIMUM_KDF_SALT_BYTES} bytes, got ${byteLength}`,\n });\n }\n }\n\n getAlgorithmKeySize() {\n const b = ParseUtility.toInt({ input: this.algorithm?.split('-')?.[1] ?? DEFAULT_CIPHER_BITS });\n\n return ParseUtility.toInt({ input: b / 8 });\n }\n}\n"]}
1
+ {"version":3,"file":"base.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/base.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { ParseUtility } from '@/utilities';\nimport {\n DEFAULT_CIPHER_BITS,\n DEFAULT_KDF_DIGEST,\n DEFAULT_KDF_ITERATIONS,\n DEFAULT_KDF_SALT,\n MINIMUM_KDF_SALT_BYTES,\n} from '../common';\nimport { AbstractCryptoAlgorithm } from './abstract.algorithm';\n\nexport { AbstractCryptoAlgorithm } from './abstract.algorithm';\n\nconst MAXIMUM_KDF_ITERATIONS = 2 ** 31 - 1;\n\n/** The Web Crypto name of each digest `DEFAULT_KDF_DIGEST` may hold. */\nconst KDF_HASH_NAMES: Record<string, string> = { sha256: 'SHA-256' };\n\n/** One entry per derivation. It holds the promise, so callers that arrive while it runs share it. */\nconst DERIVED_KEY_CACHE = new Map<string, Promise<Buffer>>();\n\n/** Base for the symmetric algorithms: validates the algorithm name and derives a key of a given length from a secret with PBKDF2. */\nexport abstract class BaseCryptoAlgorithm<\n AlgorithmType extends string,\n EncryptInputType = unknown,\n DecryptInputType = unknown,\n SecretKeyType = unknown,\n EncryptReturnType = unknown,\n DecryptReturnType = unknown,\n ExtraOptions = unknown,\n> extends AbstractCryptoAlgorithm<\n AlgorithmType,\n EncryptInputType,\n DecryptInputType,\n SecretKeyType,\n EncryptReturnType,\n DecryptReturnType,\n ExtraOptions\n> {\n constructor(opts: { scope: string; algorithm: AlgorithmType }) {\n super({\n scope: opts.scope ?? opts.algorithm ?? BaseCryptoAlgorithm.name,\n identifier: opts.algorithm,\n });\n this.validateAlgorithmName({ algorithm: opts.algorithm });\n\n this.algorithm = opts.algorithm;\n }\n\n validateAlgorithmName(opts: { algorithm: AlgorithmType }) {\n const { algorithm } = opts;\n\n if (!algorithm) {\n throw getError({\n message: `[validateAlgorithmName] Invalid algorithm name | algorithm: ${algorithm}`,\n });\n }\n }\n\n /**\n * Omit `kdfSalt`/`kdfIterations` for the shipped default (byte-identical to every prior release). Supplying either requires supplying the same value again on decrypt.\n * Derived with PBKDF2 over `crypto.subtle`, once per secret: a second call, even one that starts while the first runs, shares its result.\n */\n async normalizeSecretKey(opts: {\n secret: string;\n length: number;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Promise<Buffer> {\n const { secret, length, kdfSalt, kdfIterations } = opts;\n\n if (kdfSalt !== undefined) {\n this.validateKdfSalt({ kdfSalt });\n }\n\n const salt = kdfSalt ?? DEFAULT_KDF_SALT;\n const iterations = kdfIterations ?? DEFAULT_KDF_ITERATIONS;\n\n // `pbkdf2Sync` refused anything but an integer from 1 up to 2^31 - 1; Web Crypto would round a fraction down and take up to 2^32 - 1.\n if (!Number.isInteger(iterations) || iterations < 1 || iterations > MAXIMUM_KDF_ITERATIONS) {\n throw getError({\n message: `[BaseCryptoAlgorithm][normalizeSecretKey] kdfIterations must be an integer from 1 to ${MAXIMUM_KDF_ITERATIONS}, got ${iterations}`,\n });\n }\n\n const cacheKey = `${DEFAULT_KDF_DIGEST}:${iterations}:${length}:${salt}:${secret}`;\n\n return this.deriveOnce({\n cacheKey,\n derive: () => this.derivePbkdf2({ secret, salt, iterations, length }),\n });\n }\n\n /** Runs `derive` once per `cacheKey`. A failed derivation leaves nothing behind, so the next call tries again. */\n private deriveOnce(opts: { cacheKey: string; derive: () => Promise<Buffer> }): Promise<Buffer> {\n const { cacheKey, derive } = opts;\n const pending = DERIVED_KEY_CACHE.get(cacheKey);\n\n if (pending) {\n return pending;\n }\n\n const derived = derive();\n DERIVED_KEY_CACHE.set(cacheKey, derived);\n derived.catch(() => {\n if (DERIVED_KEY_CACHE.get(cacheKey) === derived) {\n DERIVED_KEY_CACHE.delete(cacheKey);\n }\n });\n\n return derived;\n }\n\n private async derivePbkdf2(opts: {\n secret: string;\n salt: string;\n iterations: number;\n length: number;\n }): Promise<Buffer> {\n const { secret, salt, iterations, length } = opts;\n const hash = KDF_HASH_NAMES[DEFAULT_KDF_DIGEST];\n\n if (hash === undefined) {\n throw getError({\n message: `[BaseCryptoAlgorithm][derivePbkdf2] No Web Crypto name for the digest \"${DEFAULT_KDF_DIGEST}\"`,\n });\n }\n\n const encoder = new TextEncoder();\n const material = await crypto.subtle.importKey('raw', encoder.encode(secret), 'PBKDF2', false, [\n 'deriveBits',\n ]);\n const bits = await crypto.subtle.deriveBits(\n { name: 'PBKDF2', hash, salt: encoder.encode(salt), iterations },\n material,\n length * 8,\n );\n\n return Buffer.from(bits);\n }\n\n /** Rejects a `kdfSalt` short enough to look configured while giving up most of the protection a salt exists for (NIST SP 800-132: 128-bit minimum). */\n private validateKdfSalt(opts: { kdfSalt: string }): void {\n const { kdfSalt } = opts;\n const byteLength = Buffer.byteLength(kdfSalt, 'utf-8');\n\n if (byteLength < MINIMUM_KDF_SALT_BYTES) {\n throw getError({\n message: `[BaseCryptoAlgorithm][validateKdfSalt] kdfSalt must be at least ${MINIMUM_KDF_SALT_BYTES} bytes, got ${byteLength}`,\n });\n }\n }\n\n getAlgorithmKeySize() {\n const b = ParseUtility.toInt({ input: this.algorithm?.split('-')?.[1] ?? DEFAULT_CIPHER_BITS });\n\n return ParseUtility.toInt({ input: b / 8 });\n }\n}\n"]}
@@ -1,7 +1,7 @@
1
1
  import { type TCredentialAlgorithm } from '../common/index.js';
2
2
  /**
3
- * Storing and checking a credential (a password) over `Bun.password`. `hash` writes an argon2id hash with
4
- * Bun's default parameters unless `algorithm: 'bcrypt'` asks for bcrypt (`$2b$`, 60 characters, the stored
3
+ * Storing and checking a credential (a password) over `Bun.password`. `hash` writes an argon2id hash (Bun's
4
+ * default parameters), or bcrypt when `algorithm: 'bcrypt'` asks for it (`$2b$`, 60 characters, the stored
5
5
  * format of the `bcrypt` package). `verify` reads every existing bcrypt and argon2 hash, whichever
6
6
  * algorithm `hash` wrote, so a stored password is never rehashed or migrated. Needs Bun: it throws on
7
7
  * another runtime.
@@ -21,13 +21,21 @@ import { type TCredentialAlgorithm } from '../common/index.js';
21
21
  */
22
22
  export declare class CredentialHelper {
23
23
  /**
24
- * A hash of `password`: argon2id by default (Bun's default parameters), bcrypt with `algorithm: 'bcrypt'`.
25
- * For bcrypt, `cost` (4 to 31, default 10) is the work factor, `2 ** cost` rounds. `cost` with argon2id
24
+ * A hash of `password`: argon2id (Bun's default parameters), or bcrypt with `algorithm: 'bcrypt'`.
25
+ * For bcrypt, `cost` (4 to 31) is the work factor, `2 ** cost` rounds. `cost` with argon2id
26
26
  * is refused rather than ignored: a caller who tuned a cost is told the default changed.
27
27
  */
28
28
  static hash(opts: {
29
29
  password: string;
30
+ /**
31
+ * The hashing scheme.
32
+ * @default DEFAULT_CREDENTIAL_ALGORITHM
33
+ */
30
34
  algorithm?: TCredentialAlgorithm;
35
+ /**
36
+ * The bcrypt work factor; refused with argon2id.
37
+ * @default 10
38
+ */
31
39
  cost?: number;
32
40
  }): Promise<string>;
33
41
  /**
@@ -9,8 +9,8 @@ const MIN_COST = 4;
9
9
  const MAX_COST = 31;
10
10
  const DEFAULT_COST = 10;
11
11
  /**
12
- * Storing and checking a credential (a password) over `Bun.password`. `hash` writes an argon2id hash with
13
- * Bun's default parameters unless `algorithm: 'bcrypt'` asks for bcrypt (`$2b$`, 60 characters, the stored
12
+ * Storing and checking a credential (a password) over `Bun.password`. `hash` writes an argon2id hash (Bun's
13
+ * default parameters), or bcrypt when `algorithm: 'bcrypt'` asks for it (`$2b$`, 60 characters, the stored
14
14
  * format of the `bcrypt` package). `verify` reads every existing bcrypt and argon2 hash, whichever
15
15
  * algorithm `hash` wrote, so a stored password is never rehashed or migrated. Needs Bun: it throws on
16
16
  * another runtime.
@@ -30,8 +30,8 @@ const DEFAULT_COST = 10;
30
30
  */
31
31
  export class CredentialHelper {
32
32
  /**
33
- * A hash of `password`: argon2id by default (Bun's default parameters), bcrypt with `algorithm: 'bcrypt'`.
34
- * For bcrypt, `cost` (4 to 31, default 10) is the work factor, `2 ** cost` rounds. `cost` with argon2id
33
+ * A hash of `password`: argon2id (Bun's default parameters), or bcrypt with `algorithm: 'bcrypt'`.
34
+ * For bcrypt, `cost` (4 to 31) is the work factor, `2 ** cost` rounds. `cost` with argon2id
35
35
  * is refused rather than ignored: a caller who tuned a cost is told the default changed.
36
36
  */
37
37
  static async hash(opts) {
@@ -1 +1 @@
1
- {"version":3,"file":"credential.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/credential.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants';\nimport { getError } from '@/modules/error';\nimport {\n CredentialAlgorithms,\n DEFAULT_CREDENTIAL_ALGORITHM,\n type TCredentialAlgorithm,\n} from '../common';\n\n/** The bcrypt versions the `bcrypt` package writes. */\nconst BCRYPT_PREFIX = /^\\$2[aby]\\$/;\n\n/** bcrypt reads only the first 72 bytes of a password. */\nconst BCRYPT_MAX_PASSWORD_BYTES = 72;\nconst MIN_COST = 4;\nconst MAX_COST = 31;\nconst DEFAULT_COST = 10;\n\n/**\n * Storing and checking a credential (a password) over `Bun.password`. `hash` writes an argon2id hash with\n * Bun's default parameters unless `algorithm: 'bcrypt'` asks for bcrypt (`$2b$`, 60 characters, the stored\n * format of the `bcrypt` package). `verify` reads every existing bcrypt and argon2 hash, whichever\n * algorithm `hash` wrote, so a stored password is never rehashed or migrated. Needs Bun: it throws on\n * another runtime.\n *\n * Passwords longer than 72 bytes are where Bun and the `bcrypt` package differ, and it only matters for\n * bcrypt. The package keeps only the first 72 bytes; Bun keeps all of them, by hashing a longer password\n * before bcrypt sees it. Two things follow, and they are the whole truth about \"the same format\":\n *\n * - A hash `hash` writes for a password longer than 72 bytes is read by Bun only. The `bcrypt` package\n * cannot verify it, so rolling back to that package, or another service reading the same column, locks\n * those users out. Up to 72 bytes the two read each other's hashes.\n * - A hash the `bcrypt` package wrote for a longer password fails a plain `Bun.password.verify` with the full\n * password. `verify` therefore retries a bcrypt hash with the first 72 bytes when the password is longer.\n * That retry is for the legacy hashes. A hash `hash` wrote never needs it, because Bun reads its own hash on\n * the first attempt. The retry has one price: a hash of a password of exactly 72 bytes also accepts that\n * password followed by anything, the way bcrypt itself always has.\n */\nexport class CredentialHelper {\n /**\n * A hash of `password`: argon2id by default (Bun's default parameters), bcrypt with `algorithm: 'bcrypt'`.\n * For bcrypt, `cost` (4 to 31, default 10) is the work factor, `2 ** cost` rounds. `cost` with argon2id\n * is refused rather than ignored: a caller who tuned a cost is told the default changed.\n */\n static async hash(opts: {\n password: string;\n algorithm?: TCredentialAlgorithm;\n cost?: number;\n }): Promise<string> {\n const { password, algorithm = DEFAULT_CREDENTIAL_ALGORITHM, cost } = opts;\n\n CredentialHelper.assertBun({ caller: 'hash' });\n\n if (typeof password !== 'string' || password.length === 0) {\n throw getError({\n message: '[CredentialHelper.hash] Invalid password | Expected a non-empty string',\n });\n }\n\n if (typeof algorithm !== 'string' || !CredentialAlgorithms.isValid(algorithm)) {\n throw getError({\n message: `[CredentialHelper.hash] Invalid algorithm | Expected one of ${[...CredentialAlgorithms.SCHEME_SET].join(', ')} | Got: ${String(algorithm)}`,\n });\n }\n\n if (algorithm === CredentialAlgorithms.ARGON2ID) {\n if (cost !== undefined && cost !== null) {\n throw getError({\n message: `[CredentialHelper.hash] Invalid cost | cost applies to bcrypt only | Pass algorithm: 'bcrypt' to keep a bcrypt cost, or drop cost for argon2id`,\n });\n }\n\n return Bun.password.hash(password, { algorithm: 'argon2id' });\n }\n\n const bcryptCost = cost ?? DEFAULT_COST;\n\n if (!Number.isInteger(bcryptCost) || bcryptCost < MIN_COST || bcryptCost > MAX_COST) {\n throw getError({\n message: `[CredentialHelper.hash] Invalid cost | Expected an integer from ${MIN_COST} to ${MAX_COST} | Got: ${bcryptCost}`,\n });\n }\n\n return Bun.password.hash(password, { algorithm: 'bcrypt', cost: bcryptCost });\n }\n\n /**\n * Whether `password` matches `hash`. Nothing to match is `false`: an empty or non-string password, an empty\n * or non-string hash. A stored value that is not a password hash is a server fault (500), so a corrupt row is\n * never answered like a wrong password, and the runtime's own message stays out of it.\n */\n static async verify(opts: { password: string; hash: string }): Promise<boolean> {\n const { password, hash } = opts;\n\n CredentialHelper.assertBun({ caller: 'verify' });\n\n if (typeof password !== 'string' || password.length === 0) {\n return false;\n }\n\n if (typeof hash !== 'string' || hash.length === 0) {\n return false;\n }\n\n const matched = await CredentialHelper.verifyHash({ password, hash });\n\n if (matched || !BCRYPT_PREFIX.test(hash)) {\n return matched;\n }\n\n const bytes = Buffer.from(password, 'utf8');\n\n if (bytes.length <= BCRYPT_MAX_PASSWORD_BYTES) {\n return false;\n }\n\n return CredentialHelper.verifyHash({\n password: bytes.subarray(0, BCRYPT_MAX_PASSWORD_BYTES),\n hash,\n });\n }\n\n private static async verifyHash(opts: {\n password: string | Uint8Array;\n hash: string;\n }): Promise<boolean> {\n const { password, hash } = opts;\n\n try {\n const matched = await Bun.password.verify(password, hash);\n\n return matched;\n } catch (error) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[CredentialHelper.verify] Invalid hash | The stored value is not a password hash',\n cause: error,\n });\n }\n }\n\n private static assertBun(opts: { caller: string }): void {\n if (typeof Bun === 'undefined') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[CredentialHelper.${opts.caller}] Unsupported runtime | CredentialHelper needs Bun.password`,\n });\n }\n }\n}\n"]}
1
+ {"version":3,"file":"credential.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/credential.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants';\nimport { getError } from '@/modules/error';\nimport {\n CredentialAlgorithms,\n DEFAULT_CREDENTIAL_ALGORITHM,\n type TCredentialAlgorithm,\n} from '../common';\n\n/** The bcrypt versions the `bcrypt` package writes. */\nconst BCRYPT_PREFIX = /^\\$2[aby]\\$/;\n\n/** bcrypt reads only the first 72 bytes of a password. */\nconst BCRYPT_MAX_PASSWORD_BYTES = 72;\nconst MIN_COST = 4;\nconst MAX_COST = 31;\nconst DEFAULT_COST = 10;\n\n/**\n * Storing and checking a credential (a password) over `Bun.password`. `hash` writes an argon2id hash (Bun's\n * default parameters), or bcrypt when `algorithm: 'bcrypt'` asks for it (`$2b$`, 60 characters, the stored\n * format of the `bcrypt` package). `verify` reads every existing bcrypt and argon2 hash, whichever\n * algorithm `hash` wrote, so a stored password is never rehashed or migrated. Needs Bun: it throws on\n * another runtime.\n *\n * Passwords longer than 72 bytes are where Bun and the `bcrypt` package differ, and it only matters for\n * bcrypt. The package keeps only the first 72 bytes; Bun keeps all of them, by hashing a longer password\n * before bcrypt sees it. Two things follow, and they are the whole truth about \"the same format\":\n *\n * - A hash `hash` writes for a password longer than 72 bytes is read by Bun only. The `bcrypt` package\n * cannot verify it, so rolling back to that package, or another service reading the same column, locks\n * those users out. Up to 72 bytes the two read each other's hashes.\n * - A hash the `bcrypt` package wrote for a longer password fails a plain `Bun.password.verify` with the full\n * password. `verify` therefore retries a bcrypt hash with the first 72 bytes when the password is longer.\n * That retry is for the legacy hashes. A hash `hash` wrote never needs it, because Bun reads its own hash on\n * the first attempt. The retry has one price: a hash of a password of exactly 72 bytes also accepts that\n * password followed by anything, the way bcrypt itself always has.\n */\nexport class CredentialHelper {\n /**\n * A hash of `password`: argon2id (Bun's default parameters), or bcrypt with `algorithm: 'bcrypt'`.\n * For bcrypt, `cost` (4 to 31) is the work factor, `2 ** cost` rounds. `cost` with argon2id\n * is refused rather than ignored: a caller who tuned a cost is told the default changed.\n */\n static async hash(opts: {\n password: string;\n /**\n * The hashing scheme.\n * @default DEFAULT_CREDENTIAL_ALGORITHM\n */\n algorithm?: TCredentialAlgorithm;\n /**\n * The bcrypt work factor; refused with argon2id.\n * @default 10\n */\n cost?: number;\n }): Promise<string> {\n const { password, algorithm = DEFAULT_CREDENTIAL_ALGORITHM, cost } = opts;\n\n CredentialHelper.assertBun({ caller: 'hash' });\n\n if (typeof password !== 'string' || password.length === 0) {\n throw getError({\n message: '[CredentialHelper.hash] Invalid password | Expected a non-empty string',\n });\n }\n\n if (typeof algorithm !== 'string' || !CredentialAlgorithms.isValid(algorithm)) {\n throw getError({\n message: `[CredentialHelper.hash] Invalid algorithm | Expected one of ${[...CredentialAlgorithms.SCHEME_SET].join(', ')} | Got: ${String(algorithm)}`,\n });\n }\n\n if (algorithm === CredentialAlgorithms.ARGON2ID) {\n if (cost !== undefined && cost !== null) {\n throw getError({\n message: `[CredentialHelper.hash] Invalid cost | cost applies to bcrypt only | Pass algorithm: 'bcrypt' to keep a bcrypt cost, or drop cost for argon2id`,\n });\n }\n\n return Bun.password.hash(password, { algorithm: 'argon2id' });\n }\n\n const bcryptCost = cost ?? DEFAULT_COST;\n\n if (!Number.isInteger(bcryptCost) || bcryptCost < MIN_COST || bcryptCost > MAX_COST) {\n throw getError({\n message: `[CredentialHelper.hash] Invalid cost | Expected an integer from ${MIN_COST} to ${MAX_COST} | Got: ${bcryptCost}`,\n });\n }\n\n return Bun.password.hash(password, { algorithm: 'bcrypt', cost: bcryptCost });\n }\n\n /**\n * Whether `password` matches `hash`. Nothing to match is `false`: an empty or non-string password, an empty\n * or non-string hash. A stored value that is not a password hash is a server fault (500), so a corrupt row is\n * never answered like a wrong password, and the runtime's own message stays out of it.\n */\n static async verify(opts: { password: string; hash: string }): Promise<boolean> {\n const { password, hash } = opts;\n\n CredentialHelper.assertBun({ caller: 'verify' });\n\n if (typeof password !== 'string' || password.length === 0) {\n return false;\n }\n\n if (typeof hash !== 'string' || hash.length === 0) {\n return false;\n }\n\n const matched = await CredentialHelper.verifyHash({ password, hash });\n\n if (matched || !BCRYPT_PREFIX.test(hash)) {\n return matched;\n }\n\n const bytes = Buffer.from(password, 'utf8');\n\n if (bytes.length <= BCRYPT_MAX_PASSWORD_BYTES) {\n return false;\n }\n\n return CredentialHelper.verifyHash({\n password: bytes.subarray(0, BCRYPT_MAX_PASSWORD_BYTES),\n hash,\n });\n }\n\n private static async verifyHash(opts: {\n password: string | Uint8Array;\n hash: string;\n }): Promise<boolean> {\n const { password, hash } = opts;\n\n try {\n const matched = await Bun.password.verify(password, hash);\n\n return matched;\n } catch (error) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[CredentialHelper.verify] Invalid hash | The stored value is not a password hash',\n cause: error,\n });\n }\n }\n\n private static assertBun(opts: { caller: string }): void {\n if (typeof Bun === 'undefined') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[CredentialHelper.${opts.caller}] Unsupported runtime | CredentialHelper needs Bun.password`,\n });\n }\n }\n}\n"]}
@@ -1,9 +1,12 @@
1
1
  import { AbstractCryptoAlgorithm } from './abstract.algorithm.js';
2
+ /** The algorithm name of `ECDH`. */
2
3
  export type ECDHAlgorithmType = 'ecdh-p256';
4
+ /** An `ECDH` ciphertext: `iv` and `ct` (ciphertext) are both base64 strings. */
3
5
  export interface IECDHEncryptedPayload {
4
6
  iv: string;
5
7
  ct: string;
6
8
  }
9
+ /** AES-GCM options for `ECDH` `encrypt` and `decrypt`. `additionalData` is authenticated but not encrypted; `decrypt` must receive the same string or it fails. An empty string is ignored. */
7
10
  export interface IECDHExtraOptions {
8
11
  additionalData?: string;
9
12
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ecdh.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/ecdh.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { AbstractCryptoAlgorithm } from './abstract.algorithm';\n\nconst CURVE = { name: 'ECDH', namedCurve: 'P-256' } as const;\nconst CIPHER = 'AES-GCM' as const;\nconst KEY_BITS = 256;\nconst IV_BYTES = 12;\nconst DEFAULT_HKDF_INFO = 'ignis-ecdh-p256-aes-256-gcm-v1';\nconst SALT_BYTES = 32;\nconst TAG_BITS = 128;\nconst BASE64_CHUNK = 0x8000;\n\nexport type ECDHAlgorithmType = 'ecdh-p256';\n\nexport interface IECDHEncryptedPayload {\n iv: string;\n ct: string;\n}\n\nexport interface IECDHExtraOptions {\n additionalData?: string;\n}\n\n/**\n * ECDH P-256 key exchange with HKDF-derived AES-256-GCM session encryption. It runs in a browser or a Worker as\n * well as on the server: `crypto.subtle`, `btoa` and `atob` only, no `Buffer` and no `node:*`, so it rides\n * `@venizia/ignis-helpers/core`. Server and client both use this class and speak one wire format.\n */\nexport class ECDH extends AbstractCryptoAlgorithm<\n ECDHAlgorithmType,\n string,\n IECDHEncryptedPayload,\n CryptoKey,\n Promise<IECDHEncryptedPayload>,\n Promise<string>,\n IECDHExtraOptions\n> {\n private static readonly encoder = new TextEncoder();\n private static readonly decoder = new TextDecoder();\n private readonly hkdfInfo: Uint8Array;\n\n constructor(opts?: { algorithm: ECDHAlgorithmType; hkdfInfo?: string }) {\n super({\n scope: ECDH.name,\n identifier: 'ecdh-p256',\n });\n\n this.algorithm = 'ecdh-p256';\n this.hkdfInfo = ECDH.encoder.encode(opts?.hkdfInfo ?? DEFAULT_HKDF_INFO);\n }\n\n static withAlgorithm(opts?: { algorithm: ECDHAlgorithmType; hkdfInfo?: string }) {\n return new ECDH(opts);\n }\n\n async generateKeyPair(): Promise<{ keyPair: CryptoKeyPair; publicKeyB64: string }> {\n const keyPair = await crypto.subtle.generateKey(CURVE, false, ['deriveBits']);\n const raw = await crypto.subtle.exportKey('raw', keyPair.publicKey);\n\n return { keyPair, publicKeyB64: ECDH.toBase64(raw) };\n }\n\n async importPublicKey(opts: { rawKeyB64: string }): Promise<CryptoKey> {\n return crypto.subtle.importKey('raw', ECDH.fromBase64(opts.rawKeyB64), CURVE, false, []);\n }\n\n async deriveAESKey(opts: {\n privateKey: CryptoKey;\n peerPublicKey: CryptoKey;\n salt?: string;\n }): Promise<{ key: CryptoKey; salt: string }> {\n const { privateKey, peerPublicKey, salt: saltB64 } = opts;\n\n const salt = saltB64\n ? new Uint8Array(ECDH.fromBase64(saltB64))\n : crypto.getRandomValues(new Uint8Array(SALT_BYTES));\n\n const sharedBits = await crypto.subtle.deriveBits(\n { name: 'ECDH', public: peerPublicKey },\n privateKey,\n KEY_BITS,\n );\n\n const hkdfKey = await crypto.subtle.importKey('raw', sharedBits, 'HKDF', false, ['deriveKey']);\n\n const key = await crypto.subtle.deriveKey(\n {\n name: 'HKDF',\n hash: 'SHA-256',\n salt: salt as Uint8Array<ArrayBuffer>,\n info: this.hkdfInfo as Uint8Array<ArrayBuffer>,\n },\n hkdfKey,\n { name: CIPHER, length: KEY_BITS },\n false,\n ['encrypt', 'decrypt'],\n );\n\n return { key, salt: ECDH.toBase64(salt) };\n }\n\n async encrypt(opts: {\n message: string;\n secret: CryptoKey;\n opts?: IECDHExtraOptions;\n }): Promise<IECDHEncryptedPayload> {\n const { message, secret: key, opts: extra } = opts;\n const iv = crypto.getRandomValues(new Uint8Array(IV_BYTES));\n const ct = await crypto.subtle.encrypt(\n {\n name: CIPHER,\n iv,\n tagLength: TAG_BITS,\n ...(extra?.additionalData && {\n additionalData: ECDH.encoder.encode(extra.additionalData),\n }),\n },\n key,\n ECDH.encoder.encode(message),\n );\n\n return { iv: ECDH.toBase64(iv), ct: ECDH.toBase64(ct) };\n }\n\n async decrypt(opts: {\n message: IECDHEncryptedPayload;\n secret: CryptoKey;\n opts?: IECDHExtraOptions;\n }): Promise<string> {\n const { message: payload, secret: key, opts: extra } = opts;\n const decrypted = await crypto.subtle.decrypt(\n {\n name: CIPHER,\n iv: new Uint8Array(ECDH.fromBase64(payload.iv)),\n tagLength: TAG_BITS,\n ...(extra?.additionalData && {\n additionalData: ECDH.encoder.encode(extra.additionalData),\n }),\n },\n key,\n ECDH.fromBase64(payload.ct),\n );\n\n return ECDH.decoder.decode(decrypted);\n }\n\n private static toBase64(data: ArrayBuffer | Uint8Array): string {\n const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);\n let binary = '';\n\n for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {\n binary += String.fromCharCode(...bytes.subarray(i, i + BASE64_CHUNK));\n }\n\n return btoa(binary);\n }\n\n private static fromBase64(base64: string): ArrayBuffer {\n if (!base64.length || base64.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(base64)) {\n throw getError({ message: '[ECDH.fromBase64] Invalid base64 input' });\n }\n\n const binary = atob(base64);\n const bytes = new Uint8Array(binary.length);\n\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n\n return bytes.buffer;\n }\n}\n"]}
1
+ {"version":3,"file":"ecdh.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/ecdh.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { AbstractCryptoAlgorithm } from './abstract.algorithm';\n\nconst CURVE = { name: 'ECDH', namedCurve: 'P-256' } as const;\nconst CIPHER = 'AES-GCM' as const;\nconst KEY_BITS = 256;\nconst IV_BYTES = 12;\nconst DEFAULT_HKDF_INFO = 'ignis-ecdh-p256-aes-256-gcm-v1';\nconst SALT_BYTES = 32;\nconst TAG_BITS = 128;\nconst BASE64_CHUNK = 0x8000;\n\n/** The algorithm name of `ECDH`. */\nexport type ECDHAlgorithmType = 'ecdh-p256';\n\n/** An `ECDH` ciphertext: `iv` and `ct` (ciphertext) are both base64 strings. */\nexport interface IECDHEncryptedPayload {\n iv: string;\n ct: string;\n}\n\n/** AES-GCM options for `ECDH` `encrypt` and `decrypt`. `additionalData` is authenticated but not encrypted; `decrypt` must receive the same string or it fails. An empty string is ignored. */\nexport interface IECDHExtraOptions {\n additionalData?: string;\n}\n\n/**\n * ECDH P-256 key exchange with HKDF-derived AES-256-GCM session encryption. It runs in a browser or a Worker as\n * well as on the server: `crypto.subtle`, `btoa` and `atob` only, no `Buffer` and no `node:*`, so it rides\n * `@venizia/ignis-helpers/core`. Server and client both use this class and speak one wire format.\n */\nexport class ECDH extends AbstractCryptoAlgorithm<\n ECDHAlgorithmType,\n string,\n IECDHEncryptedPayload,\n CryptoKey,\n Promise<IECDHEncryptedPayload>,\n Promise<string>,\n IECDHExtraOptions\n> {\n private static readonly encoder = new TextEncoder();\n private static readonly decoder = new TextDecoder();\n private readonly hkdfInfo: Uint8Array;\n\n constructor(opts?: { algorithm: ECDHAlgorithmType; hkdfInfo?: string }) {\n super({\n scope: ECDH.name,\n identifier: 'ecdh-p256',\n });\n\n this.algorithm = 'ecdh-p256';\n this.hkdfInfo = ECDH.encoder.encode(opts?.hkdfInfo ?? DEFAULT_HKDF_INFO);\n }\n\n static withAlgorithm(opts?: { algorithm: ECDHAlgorithmType; hkdfInfo?: string }) {\n return new ECDH(opts);\n }\n\n async generateKeyPair(): Promise<{ keyPair: CryptoKeyPair; publicKeyB64: string }> {\n const keyPair = await crypto.subtle.generateKey(CURVE, false, ['deriveBits']);\n const raw = await crypto.subtle.exportKey('raw', keyPair.publicKey);\n\n return { keyPair, publicKeyB64: ECDH.toBase64(raw) };\n }\n\n async importPublicKey(opts: { rawKeyB64: string }): Promise<CryptoKey> {\n return crypto.subtle.importKey('raw', ECDH.fromBase64(opts.rawKeyB64), CURVE, false, []);\n }\n\n async deriveAESKey(opts: {\n privateKey: CryptoKey;\n peerPublicKey: CryptoKey;\n salt?: string;\n }): Promise<{ key: CryptoKey; salt: string }> {\n const { privateKey, peerPublicKey, salt: saltB64 } = opts;\n\n const salt = saltB64\n ? new Uint8Array(ECDH.fromBase64(saltB64))\n : crypto.getRandomValues(new Uint8Array(SALT_BYTES));\n\n const sharedBits = await crypto.subtle.deriveBits(\n { name: 'ECDH', public: peerPublicKey },\n privateKey,\n KEY_BITS,\n );\n\n const hkdfKey = await crypto.subtle.importKey('raw', sharedBits, 'HKDF', false, ['deriveKey']);\n\n const key = await crypto.subtle.deriveKey(\n {\n name: 'HKDF',\n hash: 'SHA-256',\n salt: salt as Uint8Array<ArrayBuffer>,\n info: this.hkdfInfo as Uint8Array<ArrayBuffer>,\n },\n hkdfKey,\n { name: CIPHER, length: KEY_BITS },\n false,\n ['encrypt', 'decrypt'],\n );\n\n return { key, salt: ECDH.toBase64(salt) };\n }\n\n async encrypt(opts: {\n message: string;\n secret: CryptoKey;\n opts?: IECDHExtraOptions;\n }): Promise<IECDHEncryptedPayload> {\n const { message, secret: key, opts: extra } = opts;\n const iv = crypto.getRandomValues(new Uint8Array(IV_BYTES));\n const ct = await crypto.subtle.encrypt(\n {\n name: CIPHER,\n iv,\n tagLength: TAG_BITS,\n ...(extra?.additionalData && {\n additionalData: ECDH.encoder.encode(extra.additionalData),\n }),\n },\n key,\n ECDH.encoder.encode(message),\n );\n\n return { iv: ECDH.toBase64(iv), ct: ECDH.toBase64(ct) };\n }\n\n async decrypt(opts: {\n message: IECDHEncryptedPayload;\n secret: CryptoKey;\n opts?: IECDHExtraOptions;\n }): Promise<string> {\n const { message: payload, secret: key, opts: extra } = opts;\n const decrypted = await crypto.subtle.decrypt(\n {\n name: CIPHER,\n iv: new Uint8Array(ECDH.fromBase64(payload.iv)),\n tagLength: TAG_BITS,\n ...(extra?.additionalData && {\n additionalData: ECDH.encoder.encode(extra.additionalData),\n }),\n },\n key,\n ECDH.fromBase64(payload.ct),\n );\n\n return ECDH.decoder.decode(decrypted);\n }\n\n private static toBase64(data: ArrayBuffer | Uint8Array): string {\n const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);\n let binary = '';\n\n for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {\n binary += String.fromCharCode(...bytes.subarray(i, i + BASE64_CHUNK));\n }\n\n return btoa(binary);\n }\n\n private static fromBase64(base64: string): ArrayBuffer {\n if (!base64.length || base64.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(base64)) {\n throw getError({ message: '[ECDH.fromBase64] Invalid base64 input' });\n }\n\n const binary = atob(base64);\n const bytes = new Uint8Array(binary.length);\n\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n\n return bytes.buffer;\n }\n}\n"]}
@@ -7,6 +7,7 @@ interface IRSAExtraOptions {
7
7
  outputEncoding?: BufferEncoding;
8
8
  doThrow?: boolean;
9
9
  }
10
+ /** The algorithm name `RSA` reports as its `algorithm`. */
10
11
  export type RSAAlgorithmType = 'rsa';
11
12
  /** `generateDERKeyPair`, `encrypt` and `decrypt` are async: they run over `crypto.subtle`. */
12
13
  export declare class RSA extends BaseCryptoAlgorithm<RSAAlgorithmType, string, string, string, Promise<string>, Promise<string>, IRSAExtraOptions> {
@@ -1 +1 @@
1
- {"version":3,"file":"rsa.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/rsa.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { MINIMUM_RSA_MODULUS_BITS } from '../common/constants';\nimport { BaseCryptoAlgorithm } from './base.algorithm';\n\ninterface IRSAExtraOptions {\n inputEncoding?: { key: BufferEncoding; message: BufferEncoding };\n outputEncoding?: BufferEncoding;\n doThrow?: boolean;\n}\n\nexport type RSAAlgorithmType = 'rsa';\n\n/**\n * OAEP with SHA-1 for both the label hash and MGF1, and the public exponent 65537: what Node's\n * `publicEncrypt`/`privateDecrypt` and `generateKeyPairSync('rsa')` used by default, so keys and\n * ciphertext written by earlier releases still work. Do not change them: every ciphertext stored under\n * them would stop decrypting.\n */\nconst OAEP = { name: 'RSA-OAEP', hash: 'SHA-1' } as const;\nconst PUBLIC_EXPONENT = new Uint8Array([0x01, 0x00, 0x01]);\n\n/** `generateDERKeyPair`, `encrypt` and `decrypt` are async: they run over `crypto.subtle`. */\nexport class RSA extends BaseCryptoAlgorithm<\n RSAAlgorithmType,\n string,\n string,\n string,\n Promise<string>,\n Promise<string>,\n IRSAExtraOptions\n> {\n constructor(opts: { algorithm: RSAAlgorithmType }) {\n super({ scope: RSA.name, ...opts });\n }\n\n static withAlgorithm() {\n return new RSA({ algorithm: 'rsa' });\n }\n\n /**\n * Rejects a modulus below `MINIMUM_RSA_MODULUS_BITS` rather than generating it - a weak key still\n * works, signs, and verifies, so this is the only point where the size is ever checked.\n */\n async generateDERKeyPair(opts?: { modulus: number }) {\n const modulus = opts?.modulus ?? MINIMUM_RSA_MODULUS_BITS;\n\n if (modulus < MINIMUM_RSA_MODULUS_BITS) {\n throw getError({\n message: `[RSA][generateDERKeyPair] Modulus ${modulus} is below the ${MINIMUM_RSA_MODULUS_BITS}-bit minimum`,\n });\n }\n\n const keys = await crypto.subtle.generateKey(\n { ...OAEP, modulusLength: modulus, publicExponent: PUBLIC_EXPONENT },\n true,\n ['encrypt', 'decrypt'],\n );\n\n const publicKey = await crypto.subtle.exportKey('spki', keys.publicKey);\n const privateKey = await crypto.subtle.exportKey('pkcs8', keys.privateKey);\n\n return { publicKey: Buffer.from(publicKey), privateKey: Buffer.from(privateKey) };\n }\n\n async encrypt(opts: {\n message: string;\n secret: string;\n opts?: IRSAExtraOptions;\n }): Promise<string> {\n const { message, secret: pubKey } = opts;\n const {\n inputEncoding = { key: 'base64', message: 'utf-8' },\n outputEncoding = 'base64',\n doThrow = true,\n } = opts.opts ?? {};\n\n try {\n const key = await crypto.subtle.importKey(\n 'spki',\n Buffer.from(pubKey, inputEncoding.key),\n OAEP,\n false,\n ['encrypt'],\n );\n const cipherBytes = await crypto.subtle.encrypt(\n { name: OAEP.name },\n key,\n Buffer.from(message, inputEncoding.message),\n );\n\n return Buffer.from(cipherBytes).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n async decrypt(opts: {\n message: string;\n secret: string;\n opts?: IRSAExtraOptions;\n }): Promise<string> {\n const { message, secret: privKey } = opts;\n const {\n inputEncoding = { key: 'base64', message: 'base64' },\n outputEncoding = 'utf-8',\n doThrow = true,\n } = opts.opts ?? {};\n\n try {\n const key = await crypto.subtle.importKey(\n 'pkcs8',\n Buffer.from(privKey, inputEncoding.key),\n OAEP,\n false,\n ['decrypt'],\n );\n const plainBytes = await crypto.subtle.decrypt(\n { name: OAEP.name },\n key,\n Buffer.from(message, inputEncoding.message),\n );\n\n return Buffer.from(plainBytes).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n}\n"]}
1
+ {"version":3,"file":"rsa.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/rsa.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { MINIMUM_RSA_MODULUS_BITS } from '../common/constants';\nimport { BaseCryptoAlgorithm } from './base.algorithm';\n\ninterface IRSAExtraOptions {\n inputEncoding?: { key: BufferEncoding; message: BufferEncoding };\n outputEncoding?: BufferEncoding;\n doThrow?: boolean;\n}\n\n/** The algorithm name `RSA` reports as its `algorithm`. */\nexport type RSAAlgorithmType = 'rsa';\n\n/**\n * OAEP with SHA-1 for both the label hash and MGF1, and the public exponent 65537: what Node's\n * `publicEncrypt`/`privateDecrypt` and `generateKeyPairSync('rsa')` used by default, so keys and\n * ciphertext written by earlier releases still work. Do not change them: every ciphertext stored under\n * them would stop decrypting.\n */\nconst OAEP = { name: 'RSA-OAEP', hash: 'SHA-1' } as const;\nconst PUBLIC_EXPONENT = new Uint8Array([0x01, 0x00, 0x01]);\n\n/** `generateDERKeyPair`, `encrypt` and `decrypt` are async: they run over `crypto.subtle`. */\nexport class RSA extends BaseCryptoAlgorithm<\n RSAAlgorithmType,\n string,\n string,\n string,\n Promise<string>,\n Promise<string>,\n IRSAExtraOptions\n> {\n constructor(opts: { algorithm: RSAAlgorithmType }) {\n super({ scope: RSA.name, ...opts });\n }\n\n static withAlgorithm() {\n return new RSA({ algorithm: 'rsa' });\n }\n\n /**\n * Rejects a modulus below `MINIMUM_RSA_MODULUS_BITS` rather than generating it - a weak key still\n * works, signs, and verifies, so this is the only point where the size is ever checked.\n */\n async generateDERKeyPair(opts?: { modulus: number }) {\n const modulus = opts?.modulus ?? MINIMUM_RSA_MODULUS_BITS;\n\n if (modulus < MINIMUM_RSA_MODULUS_BITS) {\n throw getError({\n message: `[RSA][generateDERKeyPair] Modulus ${modulus} is below the ${MINIMUM_RSA_MODULUS_BITS}-bit minimum`,\n });\n }\n\n const keys = await crypto.subtle.generateKey(\n { ...OAEP, modulusLength: modulus, publicExponent: PUBLIC_EXPONENT },\n true,\n ['encrypt', 'decrypt'],\n );\n\n const publicKey = await crypto.subtle.exportKey('spki', keys.publicKey);\n const privateKey = await crypto.subtle.exportKey('pkcs8', keys.privateKey);\n\n return { publicKey: Buffer.from(publicKey), privateKey: Buffer.from(privateKey) };\n }\n\n async encrypt(opts: {\n message: string;\n secret: string;\n opts?: IRSAExtraOptions;\n }): Promise<string> {\n const { message, secret: pubKey } = opts;\n const {\n inputEncoding = { key: 'base64', message: 'utf-8' },\n outputEncoding = 'base64',\n doThrow = true,\n } = opts.opts ?? {};\n\n try {\n const key = await crypto.subtle.importKey(\n 'spki',\n Buffer.from(pubKey, inputEncoding.key),\n OAEP,\n false,\n ['encrypt'],\n );\n const cipherBytes = await crypto.subtle.encrypt(\n { name: OAEP.name },\n key,\n Buffer.from(message, inputEncoding.message),\n );\n\n return Buffer.from(cipherBytes).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n async decrypt(opts: {\n message: string;\n secret: string;\n opts?: IRSAExtraOptions;\n }): Promise<string> {\n const { message, secret: privKey } = opts;\n const {\n inputEncoding = { key: 'base64', message: 'base64' },\n outputEncoding = 'utf-8',\n doThrow = true,\n } = opts.opts ?? {};\n\n try {\n const key = await crypto.subtle.importKey(\n 'pkcs8',\n Buffer.from(privKey, inputEncoding.key),\n OAEP,\n false,\n ['decrypt'],\n );\n const plainBytes = await crypto.subtle.decrypt(\n { name: OAEP.name },\n key,\n Buffer.from(message, inputEncoding.message),\n );\n\n return Buffer.from(plainBytes).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n}\n"]}
@@ -1,4 +1,5 @@
1
1
  import type { TConstValue } from '../../../common/index.js';
2
+ /** Key size in bits assumed when an algorithm name carries no size suffix (see `getAlgorithmKeySize`). */
2
3
  export declare const DEFAULT_CIPHER_BITS = 256;
3
4
  /**
4
5
  * Public and identical across every deployment, so it stops a bare dictionary attack but not a
@@ -6,12 +7,15 @@ export declare const DEFAULT_CIPHER_BITS = 256;
6
7
  * change this: every ciphertext already encrypted under it becomes undecryptable.
7
8
  */
8
9
  export declare const DEFAULT_KDF_SALT = "ignis-kdf-salt-v1";
10
+ /** PBKDF2 iteration count used when `kdfIterations` is omitted. Changing it makes ciphertext encrypted under the old count undecryptable. */
9
11
  export declare const DEFAULT_KDF_ITERATIONS = 100000;
12
+ /** PBKDF2 digest for key derivation; it is not configurable per call. */
10
13
  export declare const DEFAULT_KDF_DIGEST = "sha256";
11
14
  /** NIST SP 800-132 minimum recommended salt size (128 bits) for a caller-supplied `kdfSalt`. */
12
15
  export declare const MINIMUM_KDF_SALT_BYTES = 16;
13
16
  /** NIST SP 800-57 Part 1 floor for RSA past 2030. */
14
17
  export declare const MINIMUM_RSA_MODULUS_BITS = 2048;
18
+ /** Digest names the hash algorithm accepts. `isValid` narrows a string to `THashAlgorithm`. */
15
19
  export declare class HashAlgorithms {
16
20
  /** Cryptographically broken - kept only for wire-protocol compatibility (VNPay checksums); never use for security decisions. */
17
21
  static readonly MD5 = "md5";
@@ -23,7 +27,9 @@ export declare class HashAlgorithms {
23
27
  static readonly SCHEME_SET: Set<string>;
24
28
  static isValid(value: string): value is THashAlgorithm;
25
29
  }
30
+ /** One of the `HashAlgorithms` values. */
26
31
  export type THashAlgorithm = TConstValue<typeof HashAlgorithms>;
32
+ /** Text encodings a digest can be written in. `isValid` narrows a string to `THashOutputEncoding`. */
27
33
  export declare class HashOutputEncodings {
28
34
  static readonly HEX = "hex";
29
35
  static readonly BASE64 = "base64";
@@ -31,15 +37,20 @@ export declare class HashOutputEncodings {
31
37
  static readonly SCHEME_SET: Set<string>;
32
38
  static isValid(value: string): value is THashOutputEncoding;
33
39
  }
40
+ /** One of the `HashOutputEncodings` values. */
34
41
  export type THashOutputEncoding = TConstValue<typeof HashOutputEncodings>;
42
+ /** Encoding used when `outputEncoding` is omitted. */
35
43
  export declare const DEFAULT_HASH_OUTPUT_ENCODING: THashOutputEncoding;
44
+ /** Password-hash schemes `CredentialHelper` accepts. `isValid` narrows a string to `TCredentialAlgorithm`. */
36
45
  export declare class CredentialAlgorithms {
37
- /** What `Bun.password` writes by default, with its default parameters. */
46
+ /** What `Bun.password` writes with its default parameters; the scheme `hash` uses unless told otherwise. */
38
47
  static readonly ARGON2ID = "argon2id";
39
48
  static readonly BCRYPT = "bcrypt";
40
49
  static readonly SCHEME_SET: Set<string>;
41
50
  static isValid(value: string): value is TCredentialAlgorithm;
42
51
  }
52
+ /** One of the `CredentialAlgorithms` values. */
43
53
  export type TCredentialAlgorithm = TConstValue<typeof CredentialAlgorithms>;
54
+ /** Scheme `CredentialHelper.hash` uses when `algorithm` is omitted. */
44
55
  export declare const DEFAULT_CREDENTIAL_ALGORITHM: TCredentialAlgorithm;
45
56
  //# sourceMappingURL=constants.d.ts.map