@venizia/ignis-helpers 0.4.7 → 0.4.8-0

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 (401) hide show
  1. package/README.md +2 -2
  2. package/dist/esm/common/constants/mime.js.map +1 -1
  3. package/dist/esm/common/redact.js.map +1 -1
  4. package/dist/esm/common/resolvers.js.map +1 -1
  5. package/dist/esm/modules/base.js.map +1 -1
  6. package/dist/esm/modules/cron/helper.js.map +1 -1
  7. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  8. package/dist/esm/modules/crypto/algorithms/aes.engine.js.map +1 -1
  9. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  10. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
  11. package/dist/esm/modules/crypto/algorithms/hash.algorithm.js.map +1 -1
  12. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
  13. package/dist/esm/modules/env/app-env.js.map +1 -1
  14. package/dist/esm/modules/logger/base/base.js.map +1 -1
  15. package/dist/esm/modules/logger/base/console.js.map +1 -1
  16. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  17. package/dist/esm/modules/logger/common/debug-gate.js.map +1 -1
  18. package/dist/esm/modules/logger/factory.js.map +1 -1
  19. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  20. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  21. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  22. package/dist/esm/modules/logger/hf/ring.js.map +1 -1
  23. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  24. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  25. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  26. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  27. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  28. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  29. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  30. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  31. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  32. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  33. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  34. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  35. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  36. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  37. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  38. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  39. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  40. package/dist/esm/modules/pool/abstract.js.map +1 -1
  41. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  42. package/dist/esm/modules/queue/internal/hf/helper.js.map +1 -1
  43. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  44. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  45. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  46. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  47. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  48. package/dist/esm/modules/redis/utility.js.map +1 -1
  49. package/dist/esm/modules/retry/helper.js.map +1 -1
  50. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  51. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  52. package/dist/esm/modules/secrets/factory.js.map +1 -1
  53. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  54. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
  55. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  56. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  57. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  58. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  59. package/dist/esm/modules/storage/base.js.map +1 -1
  60. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  61. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  62. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  63. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  64. package/dist/esm/modules/temporal/adapters/dayjs.js.map +1 -1
  65. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  66. package/dist/esm/modules/temporal/adapters/luxon.js.map +1 -1
  67. package/dist/esm/modules/temporal/adapters/native.js.map +1 -1
  68. package/dist/esm/modules/temporal/calendar/calendar.js.map +1 -1
  69. package/dist/esm/modules/temporal/common/types.js.map +1 -1
  70. package/dist/esm/modules/temporal/duration/duration.js.map +1 -1
  71. package/dist/esm/modules/temporal/helper.js.map +1 -1
  72. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  73. package/dist/esm/modules/temporal/pattern/pattern.js.map +1 -1
  74. package/dist/esm/modules/temporal/pattern/tokens.js.map +1 -1
  75. package/dist/esm/modules/tree/builder.js.map +1 -1
  76. package/dist/esm/modules/uid/helper.js.map +1 -1
  77. package/dist/esm/modules/uid/opaque.js.map +1 -1
  78. package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
  79. package/dist/esm/modules/uid/uuid/sha1.js.map +1 -1
  80. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  81. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  82. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  83. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  84. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  85. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  86. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  87. package/dist/esm/utilities/error.utility.js.map +1 -1
  88. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  89. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  90. package/dist/esm/utilities/module.utility.js.map +1 -1
  91. package/dist/esm/utilities/parse.utility.js.map +1 -1
  92. package/dist/esm/utilities/performance.utility.js.map +1 -1
  93. package/dist/esm/utilities/promise.utility.js.map +1 -1
  94. package/dist/esm/utilities/request.utility.js.map +1 -1
  95. package/package.json +4 -4
  96. package/dist/esm/common/constants/app.d.ts.map +0 -1
  97. package/dist/esm/common/constants/duration.d.ts.map +0 -1
  98. package/dist/esm/common/constants/grpc.d.ts.map +0 -1
  99. package/dist/esm/common/constants/http.d.ts.map +0 -1
  100. package/dist/esm/common/constants/index.d.ts.map +0 -1
  101. package/dist/esm/common/constants/mime.d.ts.map +0 -1
  102. package/dist/esm/common/index.d.ts.map +0 -1
  103. package/dist/esm/common/jsx.d.ts.map +0 -1
  104. package/dist/esm/common/redact.d.ts.map +0 -1
  105. package/dist/esm/common/resolvers.d.ts.map +0 -1
  106. package/dist/esm/common/types/class.d.ts.map +0 -1
  107. package/dist/esm/common/types/const-value.d.ts.map +0 -1
  108. package/dist/esm/common/types/field-mapping.d.ts.map +0 -1
  109. package/dist/esm/common/types/index.d.ts.map +0 -1
  110. package/dist/esm/common/types/injection.d.ts.map +0 -1
  111. package/dist/esm/common/types/resolver.d.ts.map +0 -1
  112. package/dist/esm/common/types/utility.d.ts.map +0 -1
  113. package/dist/esm/core.d.ts.map +0 -1
  114. package/dist/esm/index.d.ts.map +0 -1
  115. package/dist/esm/modules/base.d.ts.map +0 -1
  116. package/dist/esm/modules/cron/helper.d.ts.map +0 -1
  117. package/dist/esm/modules/cron/index.d.ts.map +0 -1
  118. package/dist/esm/modules/crypto/algorithms/abstract.algorithm.d.ts.map +0 -1
  119. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts.map +0 -1
  120. package/dist/esm/modules/crypto/algorithms/aes.constants.d.ts.map +0 -1
  121. package/dist/esm/modules/crypto/algorithms/aes.engine.d.ts.map +0 -1
  122. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts.map +0 -1
  123. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts.map +0 -1
  124. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts.map +0 -1
  125. package/dist/esm/modules/crypto/algorithms/hash.algorithm.d.ts.map +0 -1
  126. package/dist/esm/modules/crypto/algorithms/index.d.ts.map +0 -1
  127. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts.map +0 -1
  128. package/dist/esm/modules/crypto/common/constants.d.ts.map +0 -1
  129. package/dist/esm/modules/crypto/common/index.d.ts.map +0 -1
  130. package/dist/esm/modules/crypto/common/types.d.ts.map +0 -1
  131. package/dist/esm/modules/crypto/index.d.ts.map +0 -1
  132. package/dist/esm/modules/env/app-env.d.ts.map +0 -1
  133. package/dist/esm/modules/env/common/index.d.ts.map +0 -1
  134. package/dist/esm/modules/env/common/types.d.ts.map +0 -1
  135. package/dist/esm/modules/env/index.d.ts.map +0 -1
  136. package/dist/esm/modules/env/names.d.ts.map +0 -1
  137. package/dist/esm/modules/error/index.d.ts.map +0 -1
  138. package/dist/esm/modules/index.d.ts.map +0 -1
  139. package/dist/esm/modules/logger/base/abstract.d.ts.map +0 -1
  140. package/dist/esm/modules/logger/base/base.d.ts.map +0 -1
  141. package/dist/esm/modules/logger/base/console.d.ts.map +0 -1
  142. package/dist/esm/modules/logger/base/index.d.ts.map +0 -1
  143. package/dist/esm/modules/logger/common/constants.d.ts.map +0 -1
  144. package/dist/esm/modules/logger/common/debug-gate.d.ts.map +0 -1
  145. package/dist/esm/modules/logger/common/index.d.ts.map +0 -1
  146. package/dist/esm/modules/logger/common/types.d.ts.map +0 -1
  147. package/dist/esm/modules/logger/factory.d.ts.map +0 -1
  148. package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +0 -1
  149. package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +0 -1
  150. package/dist/esm/modules/logger/formatting/index.d.ts.map +0 -1
  151. package/dist/esm/modules/logger/hf/common/constants.d.ts.map +0 -1
  152. package/dist/esm/modules/logger/hf/common/index.d.ts.map +0 -1
  153. package/dist/esm/modules/logger/hf/common/types.d.ts.map +0 -1
  154. package/dist/esm/modules/logger/hf/flusher.d.ts.map +0 -1
  155. package/dist/esm/modules/logger/hf/index.d.ts.map +0 -1
  156. package/dist/esm/modules/logger/hf/logger.d.ts.map +0 -1
  157. package/dist/esm/modules/logger/hf/ring.d.ts.map +0 -1
  158. package/dist/esm/modules/logger/index.d.ts.map +0 -1
  159. package/dist/esm/modules/logger/pino/backing.d.ts.map +0 -1
  160. package/dist/esm/modules/logger/pino/common/constants.d.ts.map +0 -1
  161. package/dist/esm/modules/logger/pino/common/index.d.ts.map +0 -1
  162. package/dist/esm/modules/logger/pino/common/types.d.ts.map +0 -1
  163. package/dist/esm/modules/logger/pino/destination.d.ts.map +0 -1
  164. package/dist/esm/modules/logger/pino/index.d.ts.map +0 -1
  165. package/dist/esm/modules/logger/pino/logger.d.ts.map +0 -1
  166. package/dist/esm/modules/logger/winston/common/constants.d.ts.map +0 -1
  167. package/dist/esm/modules/logger/winston/common/index.d.ts.map +0 -1
  168. package/dist/esm/modules/logger/winston/common/types.d.ts.map +0 -1
  169. package/dist/esm/modules/logger/winston/define.d.ts.map +0 -1
  170. package/dist/esm/modules/logger/winston/formats.d.ts.map +0 -1
  171. package/dist/esm/modules/logger/winston/index.d.ts.map +0 -1
  172. package/dist/esm/modules/logger/winston/logger-factory.d.ts.map +0 -1
  173. package/dist/esm/modules/logger/winston/logger.d.ts.map +0 -1
  174. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts.map +0 -1
  175. package/dist/esm/modules/logger/winston/transports/index.d.ts.map +0 -1
  176. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts.map +0 -1
  177. package/dist/esm/modules/network/http-request/common/constants.d.ts.map +0 -1
  178. package/dist/esm/modules/network/http-request/common/index.d.ts.map +0 -1
  179. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +0 -1
  180. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +0 -1
  181. package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts.map +0 -1
  182. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts.map +0 -1
  183. package/dist/esm/modules/network/http-request/fetcher/index.d.ts.map +0 -1
  184. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +0 -1
  185. package/dist/esm/modules/network/http-request/index.d.ts.map +0 -1
  186. package/dist/esm/modules/network/index.d.ts.map +0 -1
  187. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts.map +0 -1
  188. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +0 -1
  189. package/dist/esm/modules/network/tcp-socket/index.d.ts.map +0 -1
  190. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts.map +0 -1
  191. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts.map +0 -1
  192. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts.map +0 -1
  193. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts.map +0 -1
  194. package/dist/esm/modules/network/udp-socket/index.d.ts.map +0 -1
  195. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts.map +0 -1
  196. package/dist/esm/modules/network/utilities/index.d.ts.map +0 -1
  197. package/dist/esm/modules/network/utilities/query-string.d.ts.map +0 -1
  198. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts.map +0 -1
  199. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +0 -1
  200. package/dist/esm/modules/network/utilities/url-safety/common/index.d.ts.map +0 -1
  201. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts.map +0 -1
  202. package/dist/esm/modules/network/utilities/url-safety/index.d.ts.map +0 -1
  203. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +0 -1
  204. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +0 -1
  205. package/dist/esm/modules/pool/abstract.d.ts.map +0 -1
  206. package/dist/esm/modules/pool/base.d.ts.map +0 -1
  207. package/dist/esm/modules/pool/common/index.d.ts.map +0 -1
  208. package/dist/esm/modules/pool/common/types.d.ts.map +0 -1
  209. package/dist/esm/modules/pool/index.d.ts.map +0 -1
  210. package/dist/esm/modules/queue/bullmq/helper.d.ts.map +0 -1
  211. package/dist/esm/modules/queue/bullmq/index.d.ts.map +0 -1
  212. package/dist/esm/modules/queue/common/constants.d.ts.map +0 -1
  213. package/dist/esm/modules/queue/common/hook.d.ts.map +0 -1
  214. package/dist/esm/modules/queue/common/index.d.ts.map +0 -1
  215. package/dist/esm/modules/queue/index.d.ts.map +0 -1
  216. package/dist/esm/modules/queue/internal/hf/common/index.d.ts.map +0 -1
  217. package/dist/esm/modules/queue/internal/hf/common/types.d.ts.map +0 -1
  218. package/dist/esm/modules/queue/internal/hf/helper.d.ts.map +0 -1
  219. package/dist/esm/modules/queue/internal/hf/index.d.ts.map +0 -1
  220. package/dist/esm/modules/queue/internal/index.d.ts.map +0 -1
  221. package/dist/esm/modules/queue/internal/sequential/common/index.d.ts.map +0 -1
  222. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts.map +0 -1
  223. package/dist/esm/modules/queue/internal/sequential/helper.d.ts.map +0 -1
  224. package/dist/esm/modules/queue/internal/sequential/index.d.ts.map +0 -1
  225. package/dist/esm/modules/queue/kafka/admin.d.ts.map +0 -1
  226. package/dist/esm/modules/queue/kafka/base.d.ts.map +0 -1
  227. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts.map +0 -1
  228. package/dist/esm/modules/queue/kafka/bundler/common/index.d.ts.map +0 -1
  229. package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +0 -1
  230. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +0 -1
  231. package/dist/esm/modules/queue/kafka/common/constants.d.ts.map +0 -1
  232. package/dist/esm/modules/queue/kafka/common/index.d.ts.map +0 -1
  233. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts.map +0 -1
  234. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts.map +0 -1
  235. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts.map +0 -1
  236. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts.map +0 -1
  237. package/dist/esm/modules/queue/kafka/common/types/index.d.ts.map +0 -1
  238. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts.map +0 -1
  239. package/dist/esm/modules/queue/kafka/consumer.d.ts.map +0 -1
  240. package/dist/esm/modules/queue/kafka/index.d.ts.map +0 -1
  241. package/dist/esm/modules/queue/kafka/producer.d.ts.map +0 -1
  242. package/dist/esm/modules/queue/kafka/schema/index.d.ts.map +0 -1
  243. package/dist/esm/modules/queue/kafka/schema/registry.d.ts.map +0 -1
  244. package/dist/esm/modules/queue/mqtt/helper.d.ts.map +0 -1
  245. package/dist/esm/modules/queue/mqtt/index.d.ts.map +0 -1
  246. package/dist/esm/modules/redis/base/abstract.helper.d.ts.map +0 -1
  247. package/dist/esm/modules/redis/base/index.d.ts.map +0 -1
  248. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts.map +0 -1
  249. package/dist/esm/modules/redis/cluster/index.d.ts.map +0 -1
  250. package/dist/esm/modules/redis/common/constants.d.ts.map +0 -1
  251. package/dist/esm/modules/redis/common/index.d.ts.map +0 -1
  252. package/dist/esm/modules/redis/common/interfaces.d.ts.map +0 -1
  253. package/dist/esm/modules/redis/common/types.d.ts.map +0 -1
  254. package/dist/esm/modules/redis/factory.d.ts.map +0 -1
  255. package/dist/esm/modules/redis/index.d.ts.map +0 -1
  256. package/dist/esm/modules/redis/sentinel/index.d.ts.map +0 -1
  257. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts.map +0 -1
  258. package/dist/esm/modules/redis/single/index.d.ts.map +0 -1
  259. package/dist/esm/modules/redis/single/single.helper.d.ts.map +0 -1
  260. package/dist/esm/modules/redis/utility.d.ts.map +0 -1
  261. package/dist/esm/modules/retry/common/constants.d.ts.map +0 -1
  262. package/dist/esm/modules/retry/common/index.d.ts.map +0 -1
  263. package/dist/esm/modules/retry/common/types.d.ts.map +0 -1
  264. package/dist/esm/modules/retry/helper.d.ts.map +0 -1
  265. package/dist/esm/modules/retry/index.d.ts.map +0 -1
  266. package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +0 -1
  267. package/dist/esm/modules/secrets/base/index.d.ts.map +0 -1
  268. package/dist/esm/modules/secrets/common/constants.d.ts.map +0 -1
  269. package/dist/esm/modules/secrets/common/index.d.ts.map +0 -1
  270. package/dist/esm/modules/secrets/common/types/helper.d.ts.map +0 -1
  271. package/dist/esm/modules/secrets/common/types/index.d.ts.map +0 -1
  272. package/dist/esm/modules/secrets/common/types/lease.d.ts.map +0 -1
  273. package/dist/esm/modules/secrets/common/types/registration.d.ts.map +0 -1
  274. package/dist/esm/modules/secrets/common/types/timer.d.ts.map +0 -1
  275. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts.map +0 -1
  276. package/dist/esm/modules/secrets/dotenv/index.d.ts.map +0 -1
  277. package/dist/esm/modules/secrets/factory.d.ts.map +0 -1
  278. package/dist/esm/modules/secrets/hashicorp/auth.d.ts.map +0 -1
  279. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +0 -1
  280. package/dist/esm/modules/secrets/hashicorp/index.d.ts.map +0 -1
  281. package/dist/esm/modules/secrets/index.d.ts.map +0 -1
  282. package/dist/esm/modules/secrets/system-envs/index.d.ts.map +0 -1
  283. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts.map +0 -1
  284. package/dist/esm/modules/slug/common/constants.d.ts.map +0 -1
  285. package/dist/esm/modules/slug/common/index.d.ts.map +0 -1
  286. package/dist/esm/modules/slug/helper.d.ts.map +0 -1
  287. package/dist/esm/modules/slug/index.d.ts.map +0 -1
  288. package/dist/esm/modules/socket/index.d.ts.map +0 -1
  289. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +0 -1
  290. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +0 -1
  291. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +0 -1
  292. package/dist/esm/modules/socket/socket-io/client/index.d.ts.map +0 -1
  293. package/dist/esm/modules/socket/socket-io/common/constants.d.ts.map +0 -1
  294. package/dist/esm/modules/socket/socket-io/common/index.d.ts.map +0 -1
  295. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts.map +0 -1
  296. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts.map +0 -1
  297. package/dist/esm/modules/socket/socket-io/common/types/index.d.ts.map +0 -1
  298. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts.map +0 -1
  299. package/dist/esm/modules/socket/socket-io/index.d.ts.map +0 -1
  300. package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +0 -1
  301. package/dist/esm/modules/socket/socket-io/server/index.d.ts.map +0 -1
  302. package/dist/esm/modules/socket/websocket/common/constants.d.ts.map +0 -1
  303. package/dist/esm/modules/socket/websocket/common/index.d.ts.map +0 -1
  304. package/dist/esm/modules/socket/websocket/common/types/client.d.ts.map +0 -1
  305. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts.map +0 -1
  306. package/dist/esm/modules/socket/websocket/common/types/index.d.ts.map +0 -1
  307. package/dist/esm/modules/socket/websocket/common/types/message.d.ts.map +0 -1
  308. package/dist/esm/modules/socket/websocket/common/types/server.d.ts.map +0 -1
  309. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +0 -1
  310. package/dist/esm/modules/socket/websocket/emitter/index.d.ts.map +0 -1
  311. package/dist/esm/modules/socket/websocket/index.d.ts.map +0 -1
  312. package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +0 -1
  313. package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +0 -1
  314. package/dist/esm/modules/socket/websocket/server/index.d.ts.map +0 -1
  315. package/dist/esm/modules/storage/base.d.ts.map +0 -1
  316. package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +0 -1
  317. package/dist/esm/modules/storage/bun-s3/index.d.ts.map +0 -1
  318. package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +0 -1
  319. package/dist/esm/modules/storage/common/constants.d.ts.map +0 -1
  320. package/dist/esm/modules/storage/common/errors.d.ts.map +0 -1
  321. package/dist/esm/modules/storage/common/index.d.ts.map +0 -1
  322. package/dist/esm/modules/storage/common/types.d.ts.map +0 -1
  323. package/dist/esm/modules/storage/common/utility.d.ts.map +0 -1
  324. package/dist/esm/modules/storage/disk/helper.d.ts.map +0 -1
  325. package/dist/esm/modules/storage/disk/index.d.ts.map +0 -1
  326. package/dist/esm/modules/storage/in-memory/helper.d.ts.map +0 -1
  327. package/dist/esm/modules/storage/in-memory/index.d.ts.map +0 -1
  328. package/dist/esm/modules/storage/index.d.ts.map +0 -1
  329. package/dist/esm/modules/temporal/abstract.d.ts.map +0 -1
  330. package/dist/esm/modules/temporal/adapters/dayjs.d.ts.map +0 -1
  331. package/dist/esm/modules/temporal/adapters/index.d.ts.map +0 -1
  332. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +0 -1
  333. package/dist/esm/modules/temporal/adapters/luxon.d.ts.map +0 -1
  334. package/dist/esm/modules/temporal/adapters/native.d.ts.map +0 -1
  335. package/dist/esm/modules/temporal/calendar/calendar.d.ts.map +0 -1
  336. package/dist/esm/modules/temporal/calendar/index.d.ts.map +0 -1
  337. package/dist/esm/modules/temporal/common/constants.d.ts.map +0 -1
  338. package/dist/esm/modules/temporal/common/index.d.ts.map +0 -1
  339. package/dist/esm/modules/temporal/common/types.d.ts.map +0 -1
  340. package/dist/esm/modules/temporal/duration/duration.d.ts.map +0 -1
  341. package/dist/esm/modules/temporal/duration/index.d.ts.map +0 -1
  342. package/dist/esm/modules/temporal/helper.d.ts.map +0 -1
  343. package/dist/esm/modules/temporal/index.d.ts.map +0 -1
  344. package/dist/esm/modules/temporal/locale/index.d.ts.map +0 -1
  345. package/dist/esm/modules/temporal/locale/locale.d.ts.map +0 -1
  346. package/dist/esm/modules/temporal/pattern/common/constants.d.ts.map +0 -1
  347. package/dist/esm/modules/temporal/pattern/common/index.d.ts.map +0 -1
  348. package/dist/esm/modules/temporal/pattern/common/types.d.ts.map +0 -1
  349. package/dist/esm/modules/temporal/pattern/index.d.ts.map +0 -1
  350. package/dist/esm/modules/temporal/pattern/pattern.d.ts.map +0 -1
  351. package/dist/esm/modules/temporal/pattern/tokens.d.ts.map +0 -1
  352. package/dist/esm/modules/tree/builder.d.ts.map +0 -1
  353. package/dist/esm/modules/tree/common/index.d.ts.map +0 -1
  354. package/dist/esm/modules/tree/common/types.d.ts.map +0 -1
  355. package/dist/esm/modules/tree/index.d.ts.map +0 -1
  356. package/dist/esm/modules/tree/walk.d.ts.map +0 -1
  357. package/dist/esm/modules/uid/common/constants.d.ts.map +0 -1
  358. package/dist/esm/modules/uid/common/index.d.ts.map +0 -1
  359. package/dist/esm/modules/uid/common/types.d.ts.map +0 -1
  360. package/dist/esm/modules/uid/helper.d.ts.map +0 -1
  361. package/dist/esm/modules/uid/index.d.ts.map +0 -1
  362. package/dist/esm/modules/uid/opaque.d.ts.map +0 -1
  363. package/dist/esm/modules/uid/request-id.d.ts.map +0 -1
  364. package/dist/esm/modules/uid/uuid/common/constants.d.ts.map +0 -1
  365. package/dist/esm/modules/uid/uuid/common/index.d.ts.map +0 -1
  366. package/dist/esm/modules/uid/uuid/common/types.d.ts.map +0 -1
  367. package/dist/esm/modules/uid/uuid/helper.d.ts.map +0 -1
  368. package/dist/esm/modules/uid/uuid/index.d.ts.map +0 -1
  369. package/dist/esm/modules/uid/uuid/sha1.d.ts.map +0 -1
  370. package/dist/esm/modules/uid/uuid/v4.d.ts.map +0 -1
  371. package/dist/esm/modules/uid/uuid/v5.d.ts.map +0 -1
  372. package/dist/esm/modules/uid/uuid/v7.d.ts.map +0 -1
  373. package/dist/esm/modules/worker-thread/bus/abstract.d.ts.map +0 -1
  374. package/dist/esm/modules/worker-thread/bus/base.d.ts.map +0 -1
  375. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts.map +0 -1
  376. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts.map +0 -1
  377. package/dist/esm/modules/worker-thread/bus/handler/index.d.ts.map +0 -1
  378. package/dist/esm/modules/worker-thread/bus/index.d.ts.map +0 -1
  379. package/dist/esm/modules/worker-thread/common/index.d.ts.map +0 -1
  380. package/dist/esm/modules/worker-thread/common/types.d.ts.map +0 -1
  381. package/dist/esm/modules/worker-thread/index.d.ts.map +0 -1
  382. package/dist/esm/modules/worker-thread/thread/abstract.d.ts.map +0 -1
  383. package/dist/esm/modules/worker-thread/thread/base.d.ts.map +0 -1
  384. package/dist/esm/modules/worker-thread/thread/index.d.ts.map +0 -1
  385. package/dist/esm/modules/worker-thread/worker/abstract.d.ts.map +0 -1
  386. package/dist/esm/modules/worker-thread/worker/base.d.ts.map +0 -1
  387. package/dist/esm/modules/worker-thread/worker/index.d.ts.map +0 -1
  388. package/dist/esm/modules/worker-thread/worker-pool.d.ts.map +0 -1
  389. package/dist/esm/temporal.d.ts.map +0 -1
  390. package/dist/esm/utilities/build-info.utility.d.ts.map +0 -1
  391. package/dist/esm/utilities/error.utility.d.ts.map +0 -1
  392. package/dist/esm/utilities/form-body.utility.d.ts.map +0 -1
  393. package/dist/esm/utilities/hr-time.utility.d.ts.map +0 -1
  394. package/dist/esm/utilities/index.d.ts.map +0 -1
  395. package/dist/esm/utilities/module.utility.d.ts.map +0 -1
  396. package/dist/esm/utilities/parse.utility.d.ts.map +0 -1
  397. package/dist/esm/utilities/performance.utility.d.ts.map +0 -1
  398. package/dist/esm/utilities/project-root.utility.d.ts.map +0 -1
  399. package/dist/esm/utilities/promise.utility.d.ts.map +0 -1
  400. package/dist/esm/utilities/request.utility.d.ts.map +0 -1
  401. package/dist/esm/uuid.d.ts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDuration } from '@/common';\nimport { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport { S3Client } from 'bun';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport type {\n IBucketInfo,\n IBucketRef,\n IFileStat,\n IListObjectsOptions,\n IObjectInfo,\n IObjectLocation,\n IObjectRef,\n IPostPolicy,\n IStorageHelperOptions,\n IUploadFile,\n} from '../common';\nimport { S3Audiences, StorageUtility, StoragePresignDefaults } from '../common';\nimport type { TS3Audience } from '../common';\nimport { S3SignatureUtility } from './utility';\n\nexport interface IBunS3HelperOptions extends IStorageHelperOptions {\n accessKey: string;\n secretKey: string;\n region?: string;\n sessionToken?: string;\n /** `default` is the host THIS process talks to; `public` is the host a browser is handed. `host` is inside every SigV4 signature, so a URL signed against an internal name cannot be rewritten later - which is why the two are separate rather than one value patched afterwards. */\n endpoint: { default: string; public?: string };\n\n /** `https://<bucket>.<endpoint>/<key>` instead of `<endpoint>/<bucket>/<key>`. AWS requires it; MinIO and R2 do not. */\n virtualHostedStyle?: boolean;\n partSize?: number;\n queueSize?: number;\n\n /** Retries Bun performs on a failed part before the write fails. */\n retry?: number;\n}\n\nexport class BunS3Helper extends BaseStorageHelper {\n private client: S3Client;\n private credentials: {\n accessKey: string;\n secretKey: string;\n endpoint: { default: string; public: string };\n region: string;\n sessionToken?: string;\n virtualHostedStyle: boolean;\n };\n\n /** Undefined leaves Bun's own defaults in force. */\n private transfer: { partSize?: number; queueSize?: number; retry?: number };\n\n constructor(options: IBunS3HelperOptions) {\n super({\n scope: options.scope ?? BunS3Helper.name,\n identifier: options.identifier ?? BunS3Helper.name,\n });\n\n this.credentials = {\n accessKey: options.accessKey,\n secretKey: options.secretKey,\n endpoint: {\n default: options.endpoint.default,\n // Falls back to the default, so one reachable host still serves both audiences.\n public: options.endpoint.public ?? options.endpoint.default,\n },\n region: options.region ?? 'us-east-1',\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle ?? false,\n };\n\n this.transfer = {\n partSize: options.partSize,\n queueSize: options.queueSize,\n retry: options.retry,\n };\n\n this.client = new S3Client({\n accessKeyId: options.accessKey,\n secretAccessKey: options.secretKey,\n endpoint: options.endpoint.default,\n region: options.region,\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle,\n });\n }\n\n /** One bucket's objects, in either addressing style. `audience` picks the host: `server` for a call this process makes, `browser` for a URL it hands out. Virtual-hosted derives the per-bucket host, because the bucket arrives per call. */\n private objectEndpoint(opts: { bucket: string; audience: TS3Audience }): {\n endpoint: string;\n pathPrefix: string;\n } {\n const { endpoint, virtualHostedStyle } = this.credentials;\n const host = opts.audience === S3Audiences.BROWSER ? endpoint.public : endpoint.default;\n\n if (!virtualHostedStyle) {\n return { endpoint: host, pathPrefix: `/${opts.bucket}` };\n }\n\n const parsed = new URL(host);\n parsed.hostname = `${opts.bucket}.${parsed.hostname}`;\n return { endpoint: parsed.origin, pathPrefix: '' };\n }\n\n /** Per-call overrides, so one client serves every bucket in either addressing style. */\n private presignOptions(opts: { bucket: string }): {\n bucket: string;\n endpoint: string;\n virtualHostedStyle?: boolean;\n } {\n const { virtualHostedStyle } = this.credentials;\n const { endpoint } = this.objectEndpoint({\n bucket: opts.bucket,\n audience: S3Audiences.BROWSER,\n });\n\n return {\n bucket: opts.bucket,\n endpoint,\n ...(virtualHostedStyle ? { virtualHostedStyle: true } : {}),\n };\n }\n\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n try {\n await this.client.list({ maxKeys: 1 }, { bucket: name });\n return true;\n } catch (error) {\n // A missing bucket is the answer; a credentials or network failure is not, and must not vanish.\n if (!StorageUtility.isNotFoundError({ error })) {\n this.logger.warn(\n '[hasBucket] Cannot determine bucket existence - reporting false | bucket: %s | %s',\n name,\n ErrorPrettier.format({ error }),\n );\n }\n\n return false;\n }\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: '/',\n accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n const xml = await response.text();\n\n if (!response.ok) {\n throw getError({ message: `[getBuckets] S3 error: ${xml}` });\n }\n\n const buckets: IBucketInfo[] = [];\n const bucketMatches = xml.matchAll(\n /<Bucket>\\s*<Name>(.*?)<\\/Name>\\s*<CreationDate>(.*?)<\\/CreationDate>\\s*<\\/Bucket>/gs,\n );\n\n for (const match of bucketMatches) {\n buckets.push({\n name: match[1],\n creationDate: new Date(match[2]),\n });\n }\n\n return buckets;\n }\n\n /** S3 exposes a creation date only through `ListBuckets`, so one full listing is the cheapest correct answer. */\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const buckets = await this.getBuckets();\n return buckets.find((bucket) => bucket.name === name) ?? null;\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[createBucket] Invalid name to create bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'PUT', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[createBucket] S3 error: ${xml}` });\n }\n\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[removeBucket] Invalid name to remove bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'DELETE',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey: secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'DELETE', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[removeBucket] S3 error: ${xml}` });\n }\n\n return true;\n }\n\n override async copyObject(opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n const { bucket, source, destination } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.SERVER,\n });\n\n // `x-amz-copy-source` is what makes this server side: S3 reads the source itself, so a 500 MB\n // object never travels through this process. The encoded value is both signed and sent.\n const request = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${destination.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n headers: {\n 'x-amz-copy-source': S3SignatureUtility.buildCopySource({\n bucket: bucket.name,\n key: source.key,\n }),\n },\n });\n\n const response = await fetch(request.url, { method: 'PUT', headers: request.headers });\n if (!response.ok) {\n throw getError({\n message: `[copyObject] Copy failed | bucket: ${bucket.name} | source: ${source.key} | status: ${response.status}`,\n });\n }\n }\n\n override async presignPost(opts: {\n bucket: IBucketRef;\n keyPrefix: string;\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n }): Promise<IPostPolicy> {\n const {\n bucket,\n keyPrefix,\n maxBytes,\n contentType,\n expiresIn = StoragePresignDefaults.POST_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // The browser posts to the BUCKET, not to an object - the key travels as a form field, because\n // the policy only constrains its prefix.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n const { formData, expiresAt } = await S3SignatureUtility.buildPostPolicy({\n bucket: bucket.name,\n keyPrefix,\n maxBytes,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPost' }),\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n });\n\n return { postURL: `${endpoint.replace(/\\/$/, '')}${pathPrefix}`, formData, expiresAt };\n }\n\n override async presignPut(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n tagging,\n contentLength,\n contentType,\n expiresIn = StoragePresignDefaults.PUT_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // Not `client.presign`: its options are method and expiry only, and a tag that is merely SENT\n // is a tag S3 ignores. These two have to be inside the signature to exist at all.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n\n return S3SignatureUtility.buildPresignedUrl({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${object.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPut' }),\n headers: {\n ...(tagging\n ? { 'x-amz-tagging': S3SignatureUtility.buildTaggingHeader({ tags: tagging }) }\n : {}),\n ...(contentLength === undefined ? {} : { 'content-length': String(contentLength) }),\n ...(contentType ? { 'content-type': contentType } : {}),\n },\n });\n }\n\n override async presignGet(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n responseContentType?: string;\n responseContentDisposition?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n expiresIn = StoragePresignDefaults.GET_EXPIRES_IN,\n responseContentType,\n responseContentDisposition,\n } = opts;\n\n return this.client.presign(object.key, {\n ...this.presignOptions({ bucket: bucket.name }),\n method: 'GET',\n expiresIn: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignGet' }),\n ...(responseContentType ? { type: responseContentType } : {}),\n ...(responseContentDisposition ? { contentDisposition: responseContentDisposition } : {}),\n });\n }\n\n override async getObjectTags(opts: IObjectLocation): Promise<Record<string, string>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n\n // S3 answers a missing tag set with 404: the empty case, not a failure.\n if (response.status === 404) {\n return {};\n }\n\n const body = await response.text();\n if (!response.ok) {\n throw getError({\n message: `[getObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n\n return S3SignatureUtility.parseTaggingXml({ xml: body });\n }\n\n override async replaceObjectTags(\n opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { tags } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n const requestBody = S3SignatureUtility.buildTaggingXml({ tags });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n body: requestBody,\n });\n\n const response = await fetch(url, { method: 'PUT', headers, body: requestBody });\n\n if (!response.ok) {\n const body = await response.text();\n throw getError({\n message: `[replaceObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-assets/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { file } = opts;\n const bucketName = opts.bucket.name;\n const { mimetype: mimeType, buffer } = file;\n\n await this.client.write(opts.object.key, buffer, {\n bucket: bucketName,\n type: mimeType,\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** Streams without holding the object in memory. `upload` carries a `Buffer`, so it cannot; this is the path for anything large. */\n override async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n\n // The same depth rule `upload` applies: one object, two doors, one answer.\n if (!this.isValidObjectKey({ object, maxDepth: opts.maxFolderDepth })) {\n throw getError({ message: `[writeStream] Invalid object name | key: ${object.key}` });\n }\n\n // Bun's `write` takes a Response, not a bare ReadableStream; wrapping streams, never buffers.\n const body = source instanceof ReadableStream ? new Response(source) : source;\n\n await this.client.write(object.key, body, {\n bucket: bucket.name,\n ...(contentType ? { type: contentType } : {}),\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** `S3File.stream()` is lazy: it reaches the network on first read, so a `try` here never sees a 404 - the failure arrives on the stream. */\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const source = this.client.file(key, { bucket: bucketName }).stream();\n\n return Readable.fromWeb(source as ReadableStream<Uint8Array>, {\n // Keeps backpressure meaningful rather than draining S3 into memory.\n objectMode: false,\n });\n }\n\n /** The conversion-free path a `Response` body wants. `slice` makes it a ranged GET, so only the requested bytes leave S3. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { range } = opts;\n const file = this.client.file(key, { bucket: bucketName });\n\n if (!range) {\n return file.stream() as ReadableStream<Uint8Array>;\n }\n\n // HTTP ranges include `end`; `slice` excludes it.\n const window =\n range.end === undefined ? file.slice(range.start) : file.slice(range.start, range.end + 1);\n\n return window.stream() as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n const stat = await this.client.stat(key, { bucket: bucketName });\n return {\n size: stat.size,\n // One key, not two spellings. The served type comes from the object name; this is diagnostic.\n metadata: { mimetype: stat.type },\n lastModified: stat.lastModified,\n etag: stat.etag,\n };\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'getStat',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n await this.client.delete(key, { bucket: bucketName });\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'removeObject',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n /** S3 caps a call at 1000 keys and continues through `nextContinuationToken`. `useRecursive: false` maps to `delimiter: '/'`. */\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { prefix, useRecursive = true, maxKeys } = opts;\n const bucketName = opts.bucket.name;\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n if (limit <= 0) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n let continuationToken: string | undefined;\n\n do {\n const remaining = limit - objects.length;\n const response = await this.client.list(\n {\n prefix,\n continuationToken,\n ...(useRecursive ? {} : { delimiter: '/' }),\n ...(Number.isFinite(remaining) ? { maxKeys: Math.min(remaining, 1000) } : {}),\n },\n { bucket: bucketName },\n );\n\n const responseContents = response.contents ?? [];\n for (const entry of responseContents) {\n objects.push({\n name: entry.key,\n size: entry.size,\n lastModified: entry.lastModified ? new Date(entry.lastModified) : undefined,\n etag: entry.eTag,\n });\n }\n\n continuationToken = response.isTruncated ? response.nextContinuationToken : undefined;\n } while (continuationToken && objects.length < limit);\n\n return objects;\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IDuration } from '@/common';\nimport { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport { S3Client } from 'bun';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport type {\n IBucketInfo,\n IBucketRef,\n IFileStat,\n IListObjectsOptions,\n IObjectInfo,\n IObjectLocation,\n IObjectRef,\n IPostPolicy,\n IStorageHelperOptions,\n IUploadFile,\n} from '../common';\nimport { S3Audiences, StorageUtility, StoragePresignDefaults } from '../common';\nimport type { TS3Audience } from '../common';\nimport { S3SignatureUtility } from './utility';\n\nexport interface IBunS3HelperOptions extends IStorageHelperOptions {\n accessKey: string;\n secretKey: string;\n region?: string;\n sessionToken?: string;\n /** `default` is the host THIS process talks to; `public` is the host a browser is handed. `host` is inside every SigV4 signature, so a URL signed against an internal name cannot be rewritten later - which is why the two are separate rather than one value patched afterwards. */\n endpoint: { default: string; public?: string };\n\n /** `https://<bucket>.<endpoint>/<key>` instead of `<endpoint>/<bucket>/<key>`. AWS requires it; MinIO and R2 do not. */\n virtualHostedStyle?: boolean;\n partSize?: number;\n queueSize?: number;\n\n /** Retries Bun performs on a failed part before the write fails. */\n retry?: number;\n}\n\nexport class BunS3Helper extends BaseStorageHelper {\n private client: S3Client;\n private credentials: {\n accessKey: string;\n secretKey: string;\n endpoint: { default: string; public: string };\n region: string;\n sessionToken?: string;\n virtualHostedStyle: boolean;\n };\n\n /** Undefined leaves Bun's own defaults in force. */\n private transfer: { partSize?: number; queueSize?: number; retry?: number };\n\n constructor(options: IBunS3HelperOptions) {\n super({\n scope: options.scope ?? BunS3Helper.name,\n identifier: options.identifier ?? BunS3Helper.name,\n });\n\n this.credentials = {\n accessKey: options.accessKey,\n secretKey: options.secretKey,\n endpoint: {\n default: options.endpoint.default,\n // Falls back to the default, so one reachable host still serves both audiences.\n public: options.endpoint.public ?? options.endpoint.default,\n },\n region: options.region ?? 'us-east-1',\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle ?? false,\n };\n\n this.transfer = {\n partSize: options.partSize,\n queueSize: options.queueSize,\n retry: options.retry,\n };\n\n this.client = new S3Client({\n accessKeyId: options.accessKey,\n secretAccessKey: options.secretKey,\n endpoint: options.endpoint.default,\n region: options.region,\n sessionToken: options.sessionToken,\n virtualHostedStyle: options.virtualHostedStyle,\n });\n }\n\n /** One bucket's objects, in either addressing style. `audience` picks the host: `server` for a call this process makes, `browser` for a URL it hands out. Virtual-hosted derives the per-bucket host, because the bucket arrives per call. */\n private objectEndpoint(opts: { bucket: string; audience: TS3Audience }): {\n endpoint: string;\n pathPrefix: string;\n } {\n const { endpoint, virtualHostedStyle } = this.credentials;\n const host = opts.audience === S3Audiences.BROWSER ? endpoint.public : endpoint.default;\n\n if (!virtualHostedStyle) {\n return { endpoint: host, pathPrefix: `/${opts.bucket}` };\n }\n\n const parsed = new URL(host);\n parsed.hostname = `${opts.bucket}.${parsed.hostname}`;\n\n return { endpoint: parsed.origin, pathPrefix: '' };\n }\n\n /** Per-call overrides, so one client serves every bucket in either addressing style. */\n private presignOptions(opts: { bucket: string }): {\n bucket: string;\n endpoint: string;\n virtualHostedStyle?: boolean;\n } {\n const { virtualHostedStyle } = this.credentials;\n const { endpoint } = this.objectEndpoint({\n bucket: opts.bucket,\n audience: S3Audiences.BROWSER,\n });\n\n return {\n bucket: opts.bucket,\n endpoint,\n ...(virtualHostedStyle ? { virtualHostedStyle: true } : {}),\n };\n }\n\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n try {\n await this.client.list({ maxKeys: 1 }, { bucket: name });\n\n return true;\n } catch (error) {\n // A missing bucket is the answer; a credentials or network failure is not, and must not vanish.\n if (!StorageUtility.isNotFoundError({ error })) {\n this.logger.warn(\n '[hasBucket] Cannot determine bucket existence - reporting false | bucket: %s | %s',\n name,\n ErrorPrettier.format({ error }),\n );\n }\n\n return false;\n }\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: '/',\n accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n const xml = await response.text();\n\n if (!response.ok) {\n throw getError({ message: `[getBuckets] S3 error: ${xml}` });\n }\n\n const buckets: IBucketInfo[] = [];\n const bucketMatches = xml.matchAll(\n /<Bucket>\\s*<Name>(.*?)<\\/Name>\\s*<CreationDate>(.*?)<\\/CreationDate>\\s*<\\/Bucket>/gs,\n );\n\n for (const match of bucketMatches) {\n buckets.push({\n name: match[1],\n creationDate: new Date(match[2]),\n });\n }\n\n return buckets;\n }\n\n /** S3 exposes a creation date only through `ListBuckets`, so one full listing is the cheapest correct answer. */\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const buckets = await this.getBuckets();\n\n return buckets.find((bucket) => bucket.name === name) ?? null;\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[createBucket] Invalid name to create bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'PUT', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[createBucket] S3 error: ${xml}` });\n }\n\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({ message: '[removeBucket] Invalid name to remove bucket!' });\n }\n\n // A bucket operation is a call this process makes, so it goes to the default host.\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const endpoint = this.credentials.endpoint.default;\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'DELETE',\n endpoint,\n path: `/${name}`,\n accessKey: accessKey,\n secretKey: secretKey,\n region,\n sessionToken,\n });\n\n const response = await fetch(url, { method: 'DELETE', headers });\n\n if (!response.ok) {\n const xml = await response.text();\n throw getError({ message: `[removeBucket] S3 error: ${xml}` });\n }\n\n return true;\n }\n\n override async copyObject(opts: {\n bucket: IBucketRef;\n source: IObjectRef;\n destination: IObjectRef;\n }): Promise<void> {\n const { bucket, source, destination } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.SERVER,\n });\n\n // `x-amz-copy-source` is what makes this server side: S3 reads the source itself, so a 500 MB\n // object never travels through this process. The encoded value is both signed and sent.\n const request = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${destination.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n headers: {\n 'x-amz-copy-source': S3SignatureUtility.buildCopySource({\n bucket: bucket.name,\n key: source.key,\n }),\n },\n });\n\n const response = await fetch(request.url, { method: 'PUT', headers: request.headers });\n\n if (!response.ok) {\n throw getError({\n message: `[copyObject] Copy failed | bucket: ${bucket.name} | source: ${source.key} | status: ${response.status}`,\n });\n }\n }\n\n override async presignPost(opts: {\n bucket: IBucketRef;\n keyPrefix: string;\n maxBytes: number;\n contentType?: string;\n expiresIn?: IDuration;\n }): Promise<IPostPolicy> {\n const {\n bucket,\n keyPrefix,\n maxBytes,\n contentType,\n expiresIn = StoragePresignDefaults.POST_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // The browser posts to the BUCKET, not to an object - the key travels as a form field, because\n // the policy only constrains its prefix.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n const { formData, expiresAt } = await S3SignatureUtility.buildPostPolicy({\n bucket: bucket.name,\n keyPrefix,\n maxBytes,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPost' }),\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n });\n\n return { postURL: `${endpoint.replace(/\\/$/, '')}${pathPrefix}`, formData, expiresAt };\n }\n\n override async presignPut(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n tagging?: Record<string, string>;\n contentLength?: number;\n contentType?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n tagging,\n contentLength,\n contentType,\n expiresIn = StoragePresignDefaults.PUT_EXPIRES_IN,\n } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n\n // Not `client.presign`: its options are method and expiry only, and a tag that is merely SENT\n // is a tag S3 ignores. These two have to be inside the signature to exist at all.\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucket.name,\n audience: S3Audiences.BROWSER,\n });\n\n return S3SignatureUtility.buildPresignedUrl({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${object.key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignPut' }),\n headers: {\n ...(tagging\n ? { 'x-amz-tagging': S3SignatureUtility.buildTaggingHeader({ tags: tagging }) }\n : {}),\n ...(contentLength === undefined ? {} : { 'content-length': String(contentLength) }),\n ...(contentType ? { 'content-type': contentType } : {}),\n },\n });\n }\n\n override async presignGet(\n opts: IObjectLocation & {\n expiresIn?: IDuration;\n responseContentType?: string;\n responseContentDisposition?: string;\n },\n ): Promise<string> {\n const {\n bucket,\n object,\n expiresIn = StoragePresignDefaults.GET_EXPIRES_IN,\n responseContentType,\n responseContentDisposition,\n } = opts;\n\n return this.client.presign(object.key, {\n ...this.presignOptions({ bucket: bucket.name }),\n method: 'GET',\n expiresIn: StorageUtility.toExpirySeconds({ expiresIn, operation: 'presignGet' }),\n ...(responseContentType ? { type: responseContentType } : {}),\n ...(responseContentDisposition ? { contentDisposition: responseContentDisposition } : {}),\n });\n }\n\n override async getObjectTags(opts: IObjectLocation): Promise<Record<string, string>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'GET',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n });\n\n const response = await fetch(url, { method: 'GET', headers });\n\n // S3 answers a missing tag set with 404: the empty case, not a failure.\n if (response.status === 404) {\n return {};\n }\n\n const body = await response.text();\n\n if (!response.ok) {\n throw getError({\n message: `[getObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n\n return S3SignatureUtility.parseTaggingXml({ xml: body });\n }\n\n override async replaceObjectTags(\n opts: IObjectLocation & { tags: Record<string, string> },\n ): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { tags } = opts;\n const { accessKey, secretKey, region, sessionToken } = this.credentials;\n const { endpoint, pathPrefix } = this.objectEndpoint({\n bucket: bucketName,\n audience: S3Audiences.SERVER,\n });\n const requestBody = S3SignatureUtility.buildTaggingXml({ tags });\n\n const { url, headers } = await S3SignatureUtility.buildSignedRequest({\n method: 'PUT',\n endpoint,\n path: `${pathPrefix}/${key}`,\n accessKey,\n secretKey,\n region,\n sessionToken,\n query: { tagging: '' },\n body: requestBody,\n });\n\n const response = await fetch(url, { method: 'PUT', headers, body: requestBody });\n\n if (!response.ok) {\n const body = await response.text();\n throw getError({\n message: `[replaceObjectTags] S3 error | status: ${response.status} | body: ${body}`,\n });\n }\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-assets/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { file } = opts;\n const bucketName = opts.bucket.name;\n const { mimetype: mimeType, buffer } = file;\n\n await this.client.write(opts.object.key, buffer, {\n bucket: bucketName,\n type: mimeType,\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** Streams without holding the object in memory. `upload` carries a `Buffer`, so it cannot; this is the path for anything large. */\n override async writeStream(\n opts: IObjectLocation & {\n source: ReadableStream<Uint8Array> | Blob | Response | Request;\n contentType?: string;\n maxFolderDepth?: number;\n },\n ): Promise<void> {\n const { bucket, object, source, contentType } = opts;\n\n // The same depth rule `upload` applies: one object, two doors, one answer.\n if (!this.isValidObjectKey({ object, maxDepth: opts.maxFolderDepth })) {\n throw getError({ message: `[writeStream] Invalid object name | key: ${object.key}` });\n }\n\n // Bun's `write` takes a Response, not a bare ReadableStream; wrapping streams, never buffers.\n const body = source instanceof ReadableStream ? new Response(source) : source;\n\n await this.client.write(object.key, body, {\n bucket: bucket.name,\n ...(contentType ? { type: contentType } : {}),\n partSize: this.transfer.partSize,\n queueSize: this.transfer.queueSize,\n retry: this.transfer.retry,\n });\n }\n\n /** `S3File.stream()` is lazy: it reaches the network on first read, so a `try` here never sees a 404 - the failure arrives on the stream. */\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const source = this.client.file(key, { bucket: bucketName }).stream();\n\n return Readable.fromWeb(source as ReadableStream<Uint8Array>, {\n // Keeps backpressure meaningful rather than draining S3 into memory.\n objectMode: false,\n });\n }\n\n /** The conversion-free path a `Response` body wants. `slice` makes it a ranged GET, so only the requested bytes leave S3. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n const { range } = opts;\n const file = this.client.file(key, { bucket: bucketName });\n\n if (!range) {\n return file.stream() as ReadableStream<Uint8Array>;\n }\n\n // HTTP ranges include `end`; `slice` excludes it.\n const window =\n range.end === undefined ? file.slice(range.start) : file.slice(range.start, range.end + 1);\n\n return window.stream() as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n const stat = await this.client.stat(key, { bucket: bucketName });\n\n return {\n size: stat.size,\n // One key, not two spellings. The served type comes from the object name; this is diagnostic.\n metadata: { mimetype: stat.type },\n lastModified: stat.lastModified,\n etag: stat.etag,\n };\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'getStat',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const bucketName = opts.bucket.name;\n const key = opts.object.key;\n\n try {\n await this.client.delete(key, { bucket: bucketName });\n } catch (error) {\n throw this.asStorageError({\n error,\n operation: 'removeObject',\n bucket: opts.bucket,\n object: opts.object,\n });\n }\n }\n\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n /** S3 caps a call at 1000 keys and continues through `nextContinuationToken`. `useRecursive: false` maps to `delimiter: '/'`. */\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { prefix, useRecursive = true, maxKeys } = opts;\n const bucketName = opts.bucket.name;\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n\n if (limit <= 0) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n let continuationToken: string | undefined;\n\n do {\n const remaining = limit - objects.length;\n const response = await this.client.list(\n {\n prefix,\n continuationToken,\n ...(useRecursive ? {} : { delimiter: '/' }),\n ...(Number.isFinite(remaining) ? { maxKeys: Math.min(remaining, 1000) } : {}),\n },\n { bucket: bucketName },\n );\n\n const responseContents = response.contents ?? [];\n\n for (const entry of responseContents) {\n objects.push({\n name: entry.key,\n size: entry.size,\n lastModified: entry.lastModified ? new Date(entry.lastModified) : undefined,\n etag: entry.eTag,\n });\n }\n\n continuationToken = response.isTruncated ? response.nextContinuationToken : undefined;\n } while (continuationToken && objects.length < limit);\n\n return objects;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/utility.ts"],"names":[],"mappings":"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","sourcesContent":["// Minimal AWS Signature V4 helpers for bucket-management operations (object ops use Bun's S3Client natively).\n\nimport { getError } from '@/modules/error';\n\nexport class S3SignatureUtility {\n private static async hmacSHA256(opts: {\n key: Uint8Array<ArrayBuffer> | string;\n data: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { key, data } = opts;\n const rawKey = typeof key === 'string' ? new TextEncoder().encode(key) : key;\n const cryptoKey = await crypto.subtle.importKey(\n 'raw',\n rawKey,\n { name: 'HMAC', hash: 'SHA-256' },\n false,\n ['sign'],\n );\n const signature = await crypto.subtle.sign('HMAC', cryptoKey, new TextEncoder().encode(data));\n return new Uint8Array(signature);\n }\n\n private static toHex(opts: { bytes: Uint8Array }): string {\n return Array.from(opts.bytes)\n .map((byte) => byte.toString(16).padStart(2, '0'))\n .join('');\n }\n\n private static async sha256Hex(opts: { data: string }): Promise<string> {\n const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(opts.data));\n return S3SignatureUtility.toHex({ bytes: new Uint8Array(digest) });\n }\n\n /** SigV4 canonical form needs every reserved character `encodeURIComponent` leaves untouched also percent-encoded. */\n private static encodeSigV4Component(opts: { value: string }): string {\n return encodeURIComponent(opts.value).replace(\n /[!'()*]/g,\n (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n }\n\n /** Signing the raw path answers 403 SignatureDoesNotMatch, because `fetch` encodes it on the wire. Separators stay literal. */\n private static encodeSigV4Path(opts: { path: string }): string {\n return opts.path\n .split('/')\n .map((segment) => S3SignatureUtility.encodeSigV4Component({ value: segment }))\n .join('/');\n }\n\n /** `x-amz-copy-source`: S3 URL-decodes it once and splits `?versionId=` off, so a raw `?`, `%` or `+` names another object and a non-Latin-1 key is not a legal header value. */\n static buildCopySource(opts: { bucket: string; key: string }): string {\n return S3SignatureUtility.encodeSigV4Path({ path: `/${opts.bucket}/${opts.key}` });\n }\n\n /** Empty or absent query must sign identically to today - callers of getBuckets/createBucket/removeBucket depend on it. */\n private static buildCanonicalQueryString(opts: { query?: Record<string, string> }): string {\n const { query } = opts;\n if (!query) {\n return '';\n }\n\n const keys = Object.keys(query);\n if (keys.length === 0) {\n return '';\n }\n\n return keys\n .sort()\n .map(\n (key) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value: query[key] })}`,\n )\n .join('&');\n }\n\n /** The SigV4 four-step chain. Each step keys the next, so the final key is bound to date, region and service. */\n private static async deriveSigningKey(opts: {\n secretKey: string;\n dateStamp: string;\n region: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { secretKey, dateStamp, region } = opts;\n const dateKey = await S3SignatureUtility.hmacSHA256({\n key: `AWS4${secretKey}`,\n data: dateStamp,\n });\n const regionKey = await S3SignatureUtility.hmacSHA256({ key: dateKey, data: region });\n const serviceKey = await S3SignatureUtility.hmacSHA256({ key: regionKey, data: 's3' });\n return S3SignatureUtility.hmacSHA256({ key: serviceKey, data: 'aws4_request' });\n }\n\n /** `20130524T000000Z` and its `20130524` prefix - the two forms every signature needs. */\n private static toAmzDate(opts: { now: Date }): { amzDate: string; dateStamp: string } {\n const amzDate = opts.now\n .toISOString()\n .replace(/[-:]/g, '')\n .replace(/\\.\\d{3}Z$/, 'Z');\n\n return { amzDate, dateStamp: amzDate.slice(0, 8) };\n }\n\n static async buildSignedRequest(opts: {\n method: string;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n body?: string;\n query?: Record<string, string>;\n /** Extra headers to SIGN, not merely to send - anything outside `SignedHeaders` is refused by S3. */\n headers?: Record<string, string>;\n }): Promise<{ url: string; headers: Record<string, string> }> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n body = '',\n query,\n headers: extraHeaders,\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now: new Date() });\n\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({ query });\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const baseUrl = `${endpoint.replace(/\\/$/, '')}${canonicalPath}`;\n const url = canonicalQueryString ? `${baseUrl}?${canonicalQueryString}` : baseUrl;\n const host = new URL(endpoint).host;\n const payloadHash = await S3SignatureUtility.sha256Hex({ data: body });\n\n const canonicalHeadersMap: Record<string, string> = {\n host,\n 'x-amz-content-sha256': payloadHash,\n 'x-amz-date': amzDate,\n };\n if (sessionToken) {\n canonicalHeadersMap['x-amz-security-token'] = sessionToken;\n }\n\n const extraHeadersEntries = Object.entries(extraHeaders ?? {});\n for (const [key, value] of extraHeadersEntries) {\n canonicalHeadersMap[key.toLowerCase()] = value;\n }\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const canonicalHeaders = sortedKeys.map((k) => `${k}:${canonicalHeadersMap[k]}\\n`).join('');\n const signedHeaders = sortedKeys.join(';');\n\n const canonicalRequest = [\n method,\n canonicalPath,\n canonicalQueryString,\n canonicalHeaders,\n signedHeaders,\n payloadHash,\n ].join('\\n');\n\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n const authHeader = `AWS4-HMAC-SHA256 Credential=${accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;\n const contentLength = String(new TextEncoder().encode(body).length);\n\n return {\n url,\n headers: {\n ...canonicalHeadersMap,\n Authorization: authHeader,\n 'Content-Length': contentLength,\n },\n };\n }\n\n private static escapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&apos;');\n }\n\n /** `&amp;` decodes LAST - a literal `&lt;` in the source text must not turn into `<` through the `&amp;` step. */\n private static unescapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&lt;/g, '<')\n .replace(/&gt;/g, '>')\n .replace(/&quot;/g, '\"')\n .replace(/&apos;/g, \"'\")\n .replace(/&amp;/g, '&');\n }\n\n /** S3's PUT tagging body - no XML dependency, so this is hand-built rather than templated by a library. */\n static buildTaggingXml(opts: { tags: Record<string, string> }): string {\n const tagEntries = Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `<Tag><Key>${S3SignatureUtility.escapeXmlText({ value: key })}</Key><Value>${S3SignatureUtility.escapeXmlText({ value })}</Value></Tag>`,\n )\n .join('');\n\n return `<Tagging><TagSet>${tagEntries}</TagSet></Tagging>`;\n }\n\n /** The `x-amz-tagging` header: a URL-encoded query string, unlike the XML the tagging API takes. */\n static buildTaggingHeader(opts: { tags: Record<string, string> }): string {\n return Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value })}`,\n )\n .join('&');\n }\n\n /** S3's GET tagging response - hand-parsed rather than a full XML parser; throws rather than returning a half-parsed object. */\n static parseTaggingXml(opts: { xml: string }): Record<string, string> {\n const { xml } = opts;\n const trimmed = xml.trim();\n\n if (/<TagSet\\s*\\/>/.test(trimmed) || /<TagSet>\\s*<\\/TagSet>/.test(trimmed)) {\n return {};\n }\n\n const tagSetMatch = trimmed.match(/<TagSet>([\\s\\S]*?)<\\/TagSet>/);\n if (!tagSetMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tagging response | body: ${xml}` });\n }\n\n const tags: Record<string, string> = {};\n const tagMatches = tagSetMatch[1].matchAll(/<Tag>([\\s\\S]*?)<\\/Tag>/g);\n\n for (const tagMatch of tagMatches) {\n const keyMatch = tagMatch[1].match(/<Key>([\\s\\S]*?)<\\/Key>/);\n const valueMatch = tagMatch[1].match(/<Value>([\\s\\S]*?)<\\/Value>/);\n\n if (!keyMatch || !valueMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tag entry | body: ${xml}` });\n }\n\n const key = S3SignatureUtility.unescapeXmlText({ value: keyMatch[1].trim() });\n const value = S3SignatureUtility.unescapeXmlText({ value: valueMatch[1].trim() });\n tags[key] = value;\n }\n\n return tags;\n }\n\n /**\n * A signed POST policy: the form a browser posts straight to S3.\n *\n * This is not a presigned PUT and the difference is the point. A signed PUT binds each header to an\n * EXACT value, so `content-length` names one byte count and never a ceiling - every retry or\n * re-encode becomes an opaque 403. A policy carries `content-length-range`, so \"at most N bytes\" is\n * expressible at all.\n */\n static async buildPostPolicy(opts: {\n bucket: string;\n keyPrefix: string;\n maxBytes: number;\n expiresInSeconds: number;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n contentType?: string;\n }): Promise<{ formData: Record<string, string>; expiresAt: string }> {\n const {\n bucket,\n keyPrefix,\n maxBytes,\n expiresInSeconds,\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n } = opts;\n\n const now = new Date();\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const credential = `${accessKey}/${credentialScope}`;\n const expiresAt = new Date(now.getTime() + expiresInSeconds * 1000).toISOString();\n\n // Every field the browser posts must ALSO be a condition, or S3 refuses the form it just signed.\n const fields: Record<string, string> = {\n 'x-amz-algorithm': 'AWS4-HMAC-SHA256',\n 'x-amz-credential': credential,\n 'x-amz-date': amzDate,\n ...(sessionToken ? { 'x-amz-security-token': sessionToken } : {}),\n };\n\n const conditions: unknown[] = [\n { bucket },\n ['starts-with', '$key', keyPrefix],\n ['content-length-range', 0, maxBytes],\n ...Object.entries(fields).map(([key, value]) => ({ [key]: value })),\n ...(contentType ? [{ 'Content-Type': contentType }] : []),\n ];\n\n const policy = Buffer.from(JSON.stringify({ expiration: expiresAt, conditions })).toString(\n 'base64',\n );\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n\n const result = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: policy });\n return {\n formData: {\n ...fields,\n ...(contentType ? { 'Content-Type': contentType } : {}),\n policy,\n 'x-amz-signature': S3SignatureUtility.toHex({ bytes: result }),\n },\n expiresAt,\n };\n }\n\n /**\n * A presigned URL: the credential travels in the QUERY, so a browser needs no `Authorization` header.\n *\n * `headers` is what `S3Client.presign` cannot do. Anything named there is inside the signature and\n * listed in `X-Amz-SignedHeaders`, so the client must send it back byte for byte. A signature\n * expresses equality and nothing else, so a pinned `content-length` rejects every retry at another\n * size; for a ceiling, use {@link S3SignatureUtility.buildPostPolicy}.\n */\n static async buildPresignedUrl(opts: {\n method: string;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n expiresInSeconds: number;\n /** Headers to SIGN. The client must send each one unchanged, or S3 answers 403. */\n headers?: Record<string, string>;\n /** A fixed clock, so a signature can be checked against a published test vector. */\n now?: Date;\n }): Promise<string> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds,\n headers,\n now = new Date(),\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const origin = endpoint.replace(/\\/$/, '');\n\n // SigV4 compares header values after trimming, so signing an untrimmed one answers 403.\n const canonicalHeadersMap: Record<string, string> = { host: new URL(origin).host };\n const signedEntries = Object.entries(headers ?? {});\n for (const [key, value] of signedEntries) {\n canonicalHeadersMap[key.toLowerCase()] = String(value).trim();\n }\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const signedHeaders = sortedKeys.join(';');\n\n // `X-Amz-SignedHeaders` is itself signed, so the header list has to be settled before the query.\n const queryParameters: Record<string, string> = {\n 'X-Amz-Algorithm': 'AWS4-HMAC-SHA256',\n 'X-Amz-Credential': `${accessKey}/${credentialScope}`,\n 'X-Amz-Date': amzDate,\n 'X-Amz-Expires': String(expiresInSeconds),\n 'X-Amz-SignedHeaders': signedHeaders,\n ...(sessionToken ? { 'X-Amz-Security-Token': sessionToken } : {}),\n };\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({\n query: queryParameters,\n });\n\n // A presigned URL is signed before its body exists, so the payload is excluded by name.\n const canonicalRequest = [\n method,\n canonicalPath,\n canonicalQueryString,\n sortedKeys.map((key) => `${key}:${canonicalHeadersMap[key]}\\n`).join(''),\n signedHeaders,\n 'UNSIGNED-PAYLOAD',\n ].join('\\n');\n\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n return `${origin}${canonicalPath}?${canonicalQueryString}&X-Amz-Signature=${signature}`;\n }\n}\n"]}
1
+ {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../../src/modules/storage/bun-s3/utility.ts"],"names":[],"mappings":"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","sourcesContent":["// Minimal AWS Signature V4 helpers for bucket-management operations (object ops use Bun's S3Client natively).\n\nimport { getError } from '@/modules/error';\n\nexport class S3SignatureUtility {\n private static async hmacSHA256(opts: {\n key: Uint8Array<ArrayBuffer> | string;\n data: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { key, data } = opts;\n const rawKey = typeof key === 'string' ? new TextEncoder().encode(key) : key;\n const cryptoKey = await crypto.subtle.importKey(\n 'raw',\n rawKey,\n { name: 'HMAC', hash: 'SHA-256' },\n false,\n ['sign'],\n );\n const signature = await crypto.subtle.sign('HMAC', cryptoKey, new TextEncoder().encode(data));\n\n return new Uint8Array(signature);\n }\n\n private static toHex(opts: { bytes: Uint8Array }): string {\n return Array.from(opts.bytes)\n .map((byte) => byte.toString(16).padStart(2, '0'))\n .join('');\n }\n\n private static async sha256Hex(opts: { data: string }): Promise<string> {\n const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(opts.data));\n\n return S3SignatureUtility.toHex({ bytes: new Uint8Array(digest) });\n }\n\n /** SigV4 canonical form needs every reserved character `encodeURIComponent` leaves untouched also percent-encoded. */\n private static encodeSigV4Component(opts: { value: string }): string {\n return encodeURIComponent(opts.value).replace(\n /[!'()*]/g,\n (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n }\n\n /** Signing the raw path answers 403 SignatureDoesNotMatch, because `fetch` encodes it on the wire. Separators stay literal. */\n private static encodeSigV4Path(opts: { path: string }): string {\n return opts.path\n .split('/')\n .map((segment) => S3SignatureUtility.encodeSigV4Component({ value: segment }))\n .join('/');\n }\n\n /** `x-amz-copy-source`: S3 URL-decodes it once and splits `?versionId=` off, so a raw `?`, `%` or `+` names another object and a non-Latin-1 key is not a legal header value. */\n static buildCopySource(opts: { bucket: string; key: string }): string {\n return S3SignatureUtility.encodeSigV4Path({ path: `/${opts.bucket}/${opts.key}` });\n }\n\n /** Empty or absent query must sign identically to today - callers of getBuckets/createBucket/removeBucket depend on it. */\n private static buildCanonicalQueryString(opts: { query?: Record<string, string> }): string {\n const { query } = opts;\n\n if (!query) {\n return '';\n }\n\n const keys = Object.keys(query);\n\n if (keys.length === 0) {\n return '';\n }\n\n return keys\n .sort()\n .map(\n (key) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value: query[key] })}`,\n )\n .join('&');\n }\n\n /** The SigV4 four-step chain. Each step keys the next, so the final key is bound to date, region and service. */\n private static async deriveSigningKey(opts: {\n secretKey: string;\n dateStamp: string;\n region: string;\n }): Promise<Uint8Array<ArrayBuffer>> {\n const { secretKey, dateStamp, region } = opts;\n const dateKey = await S3SignatureUtility.hmacSHA256({\n key: `AWS4${secretKey}`,\n data: dateStamp,\n });\n const regionKey = await S3SignatureUtility.hmacSHA256({ key: dateKey, data: region });\n const serviceKey = await S3SignatureUtility.hmacSHA256({ key: regionKey, data: 's3' });\n\n return S3SignatureUtility.hmacSHA256({ key: serviceKey, data: 'aws4_request' });\n }\n\n /** `20130524T000000Z` and its `20130524` prefix - the two forms every signature needs. */\n private static toAmzDate(opts: { now: Date }): { amzDate: string; dateStamp: string } {\n const amzDate = opts.now\n .toISOString()\n .replace(/[-:]/g, '')\n .replace(/\\.\\d{3}Z$/, 'Z');\n\n return { amzDate, dateStamp: amzDate.slice(0, 8) };\n }\n\n static async buildSignedRequest(opts: {\n method: string;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n body?: string;\n query?: Record<string, string>;\n /** Extra headers to SIGN, not merely to send - anything outside `SignedHeaders` is refused by S3. */\n headers?: Record<string, string>;\n }): Promise<{ url: string; headers: Record<string, string> }> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n body = '',\n query,\n headers: extraHeaders,\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now: new Date() });\n\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({ query });\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const baseUrl = `${endpoint.replace(/\\/$/, '')}${canonicalPath}`;\n const url = canonicalQueryString ? `${baseUrl}?${canonicalQueryString}` : baseUrl;\n const host = new URL(endpoint).host;\n const payloadHash = await S3SignatureUtility.sha256Hex({ data: body });\n\n const canonicalHeadersMap: Record<string, string> = {\n host,\n 'x-amz-content-sha256': payloadHash,\n 'x-amz-date': amzDate,\n };\n\n if (sessionToken) {\n canonicalHeadersMap['x-amz-security-token'] = sessionToken;\n }\n\n const extraHeadersEntries = Object.entries(extraHeaders ?? {});\n\n for (const [key, value] of extraHeadersEntries) {\n canonicalHeadersMap[key.toLowerCase()] = value;\n }\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const canonicalHeaders = sortedKeys.map((k) => `${k}:${canonicalHeadersMap[k]}\\n`).join('');\n const signedHeaders = sortedKeys.join(';');\n\n const canonicalRequest = [\n method,\n canonicalPath,\n canonicalQueryString,\n canonicalHeaders,\n signedHeaders,\n payloadHash,\n ].join('\\n');\n\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n const authHeader = `AWS4-HMAC-SHA256 Credential=${accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;\n const contentLength = String(new TextEncoder().encode(body).length);\n\n return {\n url,\n headers: {\n ...canonicalHeadersMap,\n Authorization: authHeader,\n 'Content-Length': contentLength,\n },\n };\n }\n\n private static escapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&apos;');\n }\n\n /** `&amp;` decodes LAST - a literal `&lt;` in the source text must not turn into `<` through the `&amp;` step. */\n private static unescapeXmlText(opts: { value: string }): string {\n return opts.value\n .replace(/&lt;/g, '<')\n .replace(/&gt;/g, '>')\n .replace(/&quot;/g, '\"')\n .replace(/&apos;/g, \"'\")\n .replace(/&amp;/g, '&');\n }\n\n /** S3's PUT tagging body - no XML dependency, so this is hand-built rather than templated by a library. */\n static buildTaggingXml(opts: { tags: Record<string, string> }): string {\n const tagEntries = Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `<Tag><Key>${S3SignatureUtility.escapeXmlText({ value: key })}</Key><Value>${S3SignatureUtility.escapeXmlText({ value })}</Value></Tag>`,\n )\n .join('');\n\n return `<Tagging><TagSet>${tagEntries}</TagSet></Tagging>`;\n }\n\n /** The `x-amz-tagging` header: a URL-encoded query string, unlike the XML the tagging API takes. */\n static buildTaggingHeader(opts: { tags: Record<string, string> }): string {\n return Object.entries(opts.tags)\n .map(\n ([key, value]) =>\n `${S3SignatureUtility.encodeSigV4Component({ value: key })}=${S3SignatureUtility.encodeSigV4Component({ value })}`,\n )\n .join('&');\n }\n\n /** S3's GET tagging response - hand-parsed rather than a full XML parser; throws rather than returning a half-parsed object. */\n static parseTaggingXml(opts: { xml: string }): Record<string, string> {\n const { xml } = opts;\n const trimmed = xml.trim();\n\n if (/<TagSet\\s*\\/>/.test(trimmed) || /<TagSet>\\s*<\\/TagSet>/.test(trimmed)) {\n return {};\n }\n\n const tagSetMatch = trimmed.match(/<TagSet>([\\s\\S]*?)<\\/TagSet>/);\n\n if (!tagSetMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tagging response | body: ${xml}` });\n }\n\n const tags: Record<string, string> = {};\n const tagMatches = tagSetMatch[1].matchAll(/<Tag>([\\s\\S]*?)<\\/Tag>/g);\n\n for (const tagMatch of tagMatches) {\n const keyMatch = tagMatch[1].match(/<Key>([\\s\\S]*?)<\\/Key>/);\n const valueMatch = tagMatch[1].match(/<Value>([\\s\\S]*?)<\\/Value>/);\n\n if (!keyMatch || !valueMatch) {\n throw getError({ message: `[parseTaggingXml] Malformed tag entry | body: ${xml}` });\n }\n\n const key = S3SignatureUtility.unescapeXmlText({ value: keyMatch[1].trim() });\n const value = S3SignatureUtility.unescapeXmlText({ value: valueMatch[1].trim() });\n tags[key] = value;\n }\n\n return tags;\n }\n\n /**\n * A signed POST policy: the form a browser posts straight to S3.\n *\n * This is not a presigned PUT and the difference is the point. A signed PUT binds each header to an\n * EXACT value, so `content-length` names one byte count and never a ceiling - every retry or\n * re-encode becomes an opaque 403. A policy carries `content-length-range`, so \"at most N bytes\" is\n * expressible at all.\n */\n static async buildPostPolicy(opts: {\n bucket: string;\n keyPrefix: string;\n maxBytes: number;\n expiresInSeconds: number;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n contentType?: string;\n }): Promise<{ formData: Record<string, string>; expiresAt: string }> {\n const {\n bucket,\n keyPrefix,\n maxBytes,\n expiresInSeconds,\n accessKey,\n secretKey,\n region,\n sessionToken,\n contentType,\n } = opts;\n\n const now = new Date();\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const credential = `${accessKey}/${credentialScope}`;\n const expiresAt = new Date(now.getTime() + expiresInSeconds * 1000).toISOString();\n\n // Every field the browser posts must ALSO be a condition, or S3 refuses the form it just signed.\n const fields: Record<string, string> = {\n 'x-amz-algorithm': 'AWS4-HMAC-SHA256',\n 'x-amz-credential': credential,\n 'x-amz-date': amzDate,\n ...(sessionToken ? { 'x-amz-security-token': sessionToken } : {}),\n };\n\n const conditions: unknown[] = [\n { bucket },\n ['starts-with', '$key', keyPrefix],\n ['content-length-range', 0, maxBytes],\n ...Object.entries(fields).map(([key, value]) => ({ [key]: value })),\n ...(contentType ? [{ 'Content-Type': contentType }] : []),\n ];\n\n const policy = Buffer.from(JSON.stringify({ expiration: expiresAt, conditions })).toString(\n 'base64',\n );\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n\n const result = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: policy });\n\n return {\n formData: {\n ...fields,\n ...(contentType ? { 'Content-Type': contentType } : {}),\n policy,\n 'x-amz-signature': S3SignatureUtility.toHex({ bytes: result }),\n },\n expiresAt,\n };\n }\n\n /**\n * A presigned URL: the credential travels in the QUERY, so a browser needs no `Authorization` header.\n *\n * `headers` is what `S3Client.presign` cannot do. Anything named there is inside the signature and\n * listed in `X-Amz-SignedHeaders`, so the client must send it back byte for byte. A signature\n * expresses equality and nothing else, so a pinned `content-length` rejects every retry at another\n * size; for a ceiling, use {@link S3SignatureUtility.buildPostPolicy}.\n */\n static async buildPresignedUrl(opts: {\n method: string;\n endpoint: string;\n path: string;\n accessKey: string;\n secretKey: string;\n region: string;\n sessionToken?: string;\n expiresInSeconds: number;\n /** Headers to SIGN. The client must send each one unchanged, or S3 answers 403. */\n headers?: Record<string, string>;\n /** A fixed clock, so a signature can be checked against a published test vector. */\n now?: Date;\n }): Promise<string> {\n const {\n method,\n endpoint,\n path,\n accessKey,\n secretKey,\n region,\n sessionToken,\n expiresInSeconds,\n headers,\n now = new Date(),\n } = opts;\n\n const { amzDate, dateStamp } = S3SignatureUtility.toAmzDate({ now });\n const credentialScope = `${dateStamp}/${region}/s3/aws4_request`;\n const canonicalPath = S3SignatureUtility.encodeSigV4Path({ path });\n const origin = endpoint.replace(/\\/$/, '');\n\n // SigV4 compares header values after trimming, so signing an untrimmed one answers 403.\n const canonicalHeadersMap: Record<string, string> = { host: new URL(origin).host };\n const signedEntries = Object.entries(headers ?? {});\n\n for (const [key, value] of signedEntries) {\n canonicalHeadersMap[key.toLowerCase()] = String(value).trim();\n }\n\n const sortedKeys = Object.keys(canonicalHeadersMap).sort();\n const signedHeaders = sortedKeys.join(';');\n\n // `X-Amz-SignedHeaders` is itself signed, so the header list has to be settled before the query.\n const queryParameters: Record<string, string> = {\n 'X-Amz-Algorithm': 'AWS4-HMAC-SHA256',\n 'X-Amz-Credential': `${accessKey}/${credentialScope}`,\n 'X-Amz-Date': amzDate,\n 'X-Amz-Expires': String(expiresInSeconds),\n 'X-Amz-SignedHeaders': signedHeaders,\n ...(sessionToken ? { 'X-Amz-Security-Token': sessionToken } : {}),\n };\n const canonicalQueryString = S3SignatureUtility.buildCanonicalQueryString({\n query: queryParameters,\n });\n\n // A presigned URL is signed before its body exists, so the payload is excluded by name.\n const canonicalRequest = [\n method,\n canonicalPath,\n canonicalQueryString,\n sortedKeys.map((key) => `${key}:${canonicalHeadersMap[key]}\\n`).join(''),\n signedHeaders,\n 'UNSIGNED-PAYLOAD',\n ].join('\\n');\n\n const result = await S3SignatureUtility.sha256Hex({ data: canonicalRequest });\n const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, result].join('\\n');\n\n const signingKey = await S3SignatureUtility.deriveSigningKey({ secretKey, dateStamp, region });\n const result2 = await S3SignatureUtility.hmacSHA256({ key: signingKey, data: stringToSign });\n const signature = S3SignatureUtility.toHex({ bytes: result2 });\n\n return `${origin}${canonicalPath}?${canonicalQueryString}&X-Amz-Signature=${signature}`;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/disk/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport fs from 'node:fs';\nimport fsp from 'node:fs/promises';\nimport type { Stats } from 'node:fs';\nimport path from 'node:path';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IObjectRef,\n type IStorageHelperOptions,\n type IUploadFile,\n StorageErrors,\n} from '../common';\n\nexport interface IDiskHelperOptions extends IStorageHelperOptions {\n /** Base directory every bucket lives under. */\n basePath: string;\n}\n\nexport class DiskHelper extends BaseStorageHelper {\n private basePath: string;\n\n constructor(options: IDiskHelperOptions) {\n super({\n scope: options.scope ?? DiskHelper.name,\n identifier: options.identifier ?? DiskHelper.name,\n });\n this.basePath = path.resolve(options.basePath);\n\n if (!fs.existsSync(this.basePath)) {\n fs.mkdirSync(this.basePath, { recursive: true });\n }\n }\n\n private getBucketPath(opts: { bucket: IBucketRef }): string {\n return path.join(this.basePath, opts.bucket.name);\n }\n\n private getObjectPath(opts: IObjectLocation): string {\n return path.join(this.getBucketPath({ bucket: opts.bucket }), opts.object.key);\n }\n\n /** Validates the name AND the resolved path: containment survives a naming rule we get wrong. */\n private resolveObjectPath(opts: IObjectLocation): string {\n const { bucket, object } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({ message: `[storage] Invalid bucket name | bucket: ${bucket.name}` });\n }\n\n if (!this.isValidObjectKey({ object, maxDepth: Number.MAX_SAFE_INTEGER })) {\n throw getError({ message: `[storage] Invalid object name | key: ${object.key}` });\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const objectPath = path.resolve(bucketPath, object.key);\n\n if (objectPath !== bucketPath && !objectPath.startsWith(`${bucketPath}${path.sep}`)) {\n throw getError({ message: `[storage] Invalid object name | key: ${object.key}` });\n }\n\n return objectPath;\n }\n\n /** `null` means not there. Anything but ENOENT is logged: it may exist and be unreadable. */\n private async statOrNull(opts: { target: string }): Promise<Stats | null> {\n const { target } = opts;\n\n try {\n const result = await fsp.stat(target);\n return result;\n } catch (error) {\n if ((error as NodeJS.ErrnoException)?.code !== 'ENOENT') {\n this.logger.warn(\n '[statOrNull] Cannot determine existence, reporting missing | path: %s | %s',\n target,\n ErrorPrettier.format({ error }),\n );\n }\n\n return null;\n }\n }\n\n private async exists(opts: { target: string }): Promise<boolean> {\n const result = await this.statOrNull(opts);\n return result !== null;\n }\n\n /** One `stat` answers existence and type. */\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n const stat = await this.statOrNull({ target: this.getBucketPath(opts) });\n return stat?.isDirectory() ?? false;\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n const result = await this.exists({ target: this.basePath });\n if (!result) {\n return [];\n }\n\n const entries = await fsp.readdir(this.basePath, { withFileTypes: true });\n const buckets: IBucketInfo[] = [];\n\n for (const entry of entries) {\n if (entry.isDirectory()) {\n const bucketPath = path.join(this.basePath, entry.name);\n const stat = await fsp.stat(bucketPath);\n buckets.push({\n name: entry.name,\n creationDate: stat.birthtime,\n });\n }\n }\n\n return buckets;\n }\n\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const stat = await this.statOrNull({ target: this.getBucketPath(opts) });\n\n if (!stat?.isDirectory()) {\n return null;\n }\n\n return { name, creationDate: stat.birthtime };\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[createBucket] Invalid name to create bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.exists({ target: bucketPath });\n if (result) {\n throw getError({\n message: `[createBucket] Bucket already exists | name: ${name}`,\n });\n }\n\n await fsp.mkdir(bucketPath, { recursive: true });\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[removeBucket] Invalid name to remove bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.exists({ target: bucketPath });\n if (!result) {\n throw getError({\n message: `[removeBucket] Bucket does not exist | name: ${name}`,\n });\n }\n\n const files = await fsp.readdir(bucketPath);\n if (files.length > 0) {\n throw getError({\n message: `[removeBucket] Bucket is not empty | name: ${name}`,\n });\n }\n\n await fsp.rmdir(bucketPath);\n return true;\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-resources/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { bucket, object, file } = opts;\n const objectPath = this.getObjectPath({ bucket, object });\n\n // `recursive` succeeds on an existing directory; probing first wastes a syscall per file.\n await fsp.mkdir(path.dirname(objectPath), { recursive: true });\n await fsp.writeFile(objectPath, file.buffer);\n }\n\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const { bucket, object } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n\n const result = await this.exists({ target: objectPath });\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObject] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n return fs.createReadStream(objectPath);\n }\n\n /** `createReadStream` seeks natively, so a range never reads the bytes before it. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n\n const result = await this.exists({ target: objectPath });\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObjectStream] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n const source = fs.createReadStream(\n objectPath,\n range ? { start: range.start, end: range.end } : {},\n );\n\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const { bucket, object } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n const stat = await this.statOrNull({ target: objectPath });\n\n if (!stat) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getStat] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n return {\n size: stat.size,\n lastModified: stat.mtime,\n metadata: {\n mimetype: this.getMimeType({ filename: object.key }),\n },\n };\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const { bucket, object } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n\n const result = await this.exists({ target: objectPath });\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[removeObject] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n await fsp.unlink(objectPath);\n }\n\n // Bounded concurrency; one failure stops the batch.\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({ message: `[listObjects] Invalid bucket name | bucket: ${bucket.name}` });\n }\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n if (limit <= 0) {\n return [];\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const result = await this.exists({ target: bucketPath });\n if (!result) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n\n const scanDirectory = async (scanOptions: {\n directory: { path: string; prefix?: string };\n }): Promise<void> => {\n const { directory } = scanOptions;\n\n if (objects.length >= limit) {\n return;\n }\n\n const entries = await fsp.readdir(directory.path, { withFileTypes: true });\n\n for (const entry of entries) {\n if (objects.length >= limit) {\n return;\n }\n\n // An object key always joins on '/'; `path.join` would emit '\\' on Windows.\n const entryKey = directory.prefix ? `${directory.prefix}/${entry.name}` : entry.name;\n const entryPath = path.join(directory.path, entry.name);\n\n if (entry.isDirectory()) {\n // A prefix that cannot match below here makes descending pointless.\n const canMatch = !prefix || prefix.startsWith(entryKey) || entryKey.startsWith(prefix);\n if (useRecursive && canMatch) {\n await scanDirectory({ directory: { path: entryPath, prefix: entryKey } });\n }\n continue;\n }\n\n if (!entry.isFile() || (prefix && !entryKey.startsWith(prefix))) {\n continue;\n }\n\n const stat = await this.statOrNull({ target: entryPath });\n if (!stat) {\n continue;\n }\n\n objects.push({ name: entryKey, size: stat.size, lastModified: stat.mtime });\n }\n };\n\n await scanDirectory({ directory: { path: bucketPath } });\n return objects;\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/disk/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,kBAAkB,CAAC;AAEnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAUL,aAAa,GACd,MAAM,WAAW,CAAC;AAOnB,MAAM,OAAO,UAAW,SAAQ,iBAAiB;IAG/C,YAAY,OAA2B;QACrC,KAAK,CAAC;YACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI;YACvC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI;SAClD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAA4B;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAEO,aAAa,CAAC,IAAqB;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,iGAAiG;IACzF,iBAAiB,CAAC,IAAqB;QAC7C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAEhC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,2CAA2C,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC;YAC1E,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,wCAAwC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAExD,IAAI,UAAU,KAAK,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YACpF,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,wCAAwC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,6FAA6F;IACrF,KAAK,CAAC,UAAU,CAAC,IAAwB;QAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEtC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,4EAA4E,EAC5E,MAAM,EACN,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAChC,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,IAAwB;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE3C,OAAO,MAAM,KAAK,IAAI,CAAC;IACzB,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,SAAS,CAAC,IAA4B;QAC1C,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEzE,OAAO,IAAI,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,YAAY,EAAE,IAAI,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAA4B;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEzE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAA4B;QAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,gDAAgD,IAAI,EAAE;aAChE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAA4B;QAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,gDAAgD,IAAI,EAAE;aAChE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,8CAA8C,IAAI,EAAE;aAC9D,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAc,iBAAiB;QAC7B,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,IAA6C;QACvE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE1D,0FAA0F;QAC1F,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAyC;QACvD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,0CAA0C,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,GAAG,EAAE;aACtF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,qFAAqF;IAC5E,KAAK,CAAC,eAAe,CAC5B,IAAmE;QAEnE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,gDAAgD,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,GAAG,EAAE;aAC5F,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAChC,UAAU,EACV,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CACpD,CAAC;QAEF,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAA+B,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAqB;QACjC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,wCAAwC,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,GAAG,EAAE;aACpF,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,KAAK;YACxB,QAAQ,EAAE;gBACR,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAqB;QACtC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,aAAa,CAAC,gBAAgB;gBACrC,OAAO,EAAE,6CAA6C,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,GAAG,EAAE;aACzF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,aAAa,CAAC,IAAmD;QACrE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,IAAI,CAAC,kBAAkB,CAAC;YAC5B,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAyB;QACzC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,YAAY,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEpE,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,+CAA+C,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,0CAA0C;QAC1C,MAAM,KAAK,GAAG,OAAO,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAElD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,MAAM,aAAa,GAAG,KAAK,EAAE,WAE5B,EAAiB,EAAE;YAClB,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC;YAElC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;oBAC5B,OAAO;gBACT,CAAC;gBAED,4EAA4E;gBAC5E,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAExD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,oEAAoE;oBACpE,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;oBAEvF,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;wBAC7B,MAAM,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC5E,CAAC;oBAED,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;oBAChE,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAE1D,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBAED,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAEzD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","sourcesContent":["import { getError } from '@/modules/error';\nimport { ErrorPrettier } from '@/modules/logger';\nimport fs from 'node:fs';\nimport fsp from 'node:fs/promises';\nimport type { Stats } from 'node:fs';\nimport path from 'node:path';\nimport { Readable } from 'node:stream';\nimport { BaseStorageHelper } from '../base';\nimport {\n type IBucketInfo,\n type IBucketRef,\n type IFileStat,\n type IListObjectsOptions,\n type IObjectInfo,\n type IObjectLocation,\n type IObjectRef,\n type IStorageHelperOptions,\n type IUploadFile,\n StorageErrors,\n} from '../common';\n\nexport interface IDiskHelperOptions extends IStorageHelperOptions {\n /** Base directory every bucket lives under. */\n basePath: string;\n}\n\nexport class DiskHelper extends BaseStorageHelper {\n private basePath: string;\n\n constructor(options: IDiskHelperOptions) {\n super({\n scope: options.scope ?? DiskHelper.name,\n identifier: options.identifier ?? DiskHelper.name,\n });\n this.basePath = path.resolve(options.basePath);\n\n if (!fs.existsSync(this.basePath)) {\n fs.mkdirSync(this.basePath, { recursive: true });\n }\n }\n\n private getBucketPath(opts: { bucket: IBucketRef }): string {\n return path.join(this.basePath, opts.bucket.name);\n }\n\n private getObjectPath(opts: IObjectLocation): string {\n return path.join(this.getBucketPath({ bucket: opts.bucket }), opts.object.key);\n }\n\n /** Validates the name AND the resolved path: containment survives a naming rule we get wrong. */\n private resolveObjectPath(opts: IObjectLocation): string {\n const { bucket, object } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({ message: `[storage] Invalid bucket name | bucket: ${bucket.name}` });\n }\n\n if (!this.isValidObjectKey({ object, maxDepth: Number.MAX_SAFE_INTEGER })) {\n throw getError({ message: `[storage] Invalid object name | key: ${object.key}` });\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const objectPath = path.resolve(bucketPath, object.key);\n\n if (objectPath !== bucketPath && !objectPath.startsWith(`${bucketPath}${path.sep}`)) {\n throw getError({ message: `[storage] Invalid object name | key: ${object.key}` });\n }\n\n return objectPath;\n }\n\n /** `null` means not there. Anything but ENOENT is logged: it may exist and be unreadable. */\n private async statOrNull(opts: { target: string }): Promise<Stats | null> {\n const { target } = opts;\n\n try {\n const result = await fsp.stat(target);\n\n return result;\n } catch (error) {\n if ((error as NodeJS.ErrnoException)?.code !== 'ENOENT') {\n this.logger.warn(\n '[statOrNull] Cannot determine existence, reporting missing | path: %s | %s',\n target,\n ErrorPrettier.format({ error }),\n );\n }\n\n return null;\n }\n }\n\n private async exists(opts: { target: string }): Promise<boolean> {\n const result = await this.statOrNull(opts);\n\n return result !== null;\n }\n\n /** One `stat` answers existence and type. */\n async hasBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n if (!this.isValidBucketName(opts)) {\n return false;\n }\n\n const stat = await this.statOrNull({ target: this.getBucketPath(opts) });\n\n return stat?.isDirectory() ?? false;\n }\n\n async getBuckets(): Promise<IBucketInfo[]> {\n const result = await this.exists({ target: this.basePath });\n\n if (!result) {\n return [];\n }\n\n const entries = await fsp.readdir(this.basePath, { withFileTypes: true });\n const buckets: IBucketInfo[] = [];\n\n for (const entry of entries) {\n if (entry.isDirectory()) {\n const bucketPath = path.join(this.basePath, entry.name);\n const stat = await fsp.stat(bucketPath);\n buckets.push({\n name: entry.name,\n creationDate: stat.birthtime,\n });\n }\n }\n\n return buckets;\n }\n\n async getBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n return null;\n }\n\n const stat = await this.statOrNull({ target: this.getBucketPath(opts) });\n\n if (!stat?.isDirectory()) {\n return null;\n }\n\n return { name, creationDate: stat.birthtime };\n }\n\n async createBucket(opts: { bucket: IBucketRef }): Promise<IBucketInfo | null> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[createBucket] Invalid name to create bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.exists({ target: bucketPath });\n\n if (result) {\n throw getError({\n message: `[createBucket] Bucket already exists | name: ${name}`,\n });\n }\n\n await fsp.mkdir(bucketPath, { recursive: true });\n\n return this.getBucket(opts);\n }\n\n async removeBucket(opts: { bucket: IBucketRef }): Promise<boolean> {\n const { name } = opts.bucket;\n\n if (!this.isValidBucketName(opts)) {\n throw getError({\n message: '[removeBucket] Invalid name to remove bucket!',\n });\n }\n\n const bucketPath = this.getBucketPath(opts);\n\n const result = await this.exists({ target: bucketPath });\n\n if (!result) {\n throw getError({\n message: `[removeBucket] Bucket does not exist | name: ${name}`,\n });\n }\n\n const files = await fsp.readdir(bucketPath);\n\n if (files.length > 0) {\n throw getError({\n message: `[removeBucket] Bucket is not empty | name: ${name}`,\n });\n }\n\n await fsp.rmdir(bucketPath);\n\n return true;\n }\n\n protected get defaultLinkPrefix(): string {\n return '/static-resources/';\n }\n\n protected async writeObject(opts: IObjectLocation & { file: IUploadFile }): Promise<void> {\n const { bucket, object, file } = opts;\n const objectPath = this.getObjectPath({ bucket, object });\n\n // `recursive` succeeds on an existing directory; probing first wastes a syscall per file.\n await fsp.mkdir(path.dirname(objectPath), { recursive: true });\n await fsp.writeFile(objectPath, file.buffer);\n }\n\n async getObject(opts: IObjectLocation & { options?: any }): Promise<Readable> {\n const { bucket, object } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n\n const result = await this.exists({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObject] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n return fs.createReadStream(objectPath);\n }\n\n /** `createReadStream` seeks natively, so a range never reads the bytes before it. */\n override async getObjectStream(\n opts: IObjectLocation & { range?: { start: number; end?: number } },\n ): Promise<ReadableStream<Uint8Array>> {\n const { bucket, object, range } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n\n const result = await this.exists({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getObjectStream] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n const source = fs.createReadStream(\n objectPath,\n range ? { start: range.start, end: range.end } : {},\n );\n\n return Readable.toWeb(source) as ReadableStream<Uint8Array>;\n }\n\n async getStat(opts: IObjectLocation): Promise<IFileStat> {\n const { bucket, object } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n const stat = await this.statOrNull({ target: objectPath });\n\n if (!stat) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[getStat] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n return {\n size: stat.size,\n lastModified: stat.mtime,\n metadata: {\n mimetype: this.getMimeType({ filename: object.key }),\n },\n };\n }\n\n async removeObject(opts: IObjectLocation): Promise<void> {\n const { bucket, object } = opts;\n const objectPath = this.resolveObjectPath({ bucket, object });\n\n const result = await this.exists({ target: objectPath });\n\n if (!result) {\n throw getError({\n error: StorageErrors.OBJECT_NOT_FOUND,\n message: `[removeObject] Object not found | bucket: ${bucket.name} | key: ${object.key}`,\n });\n }\n\n await fsp.unlink(objectPath);\n }\n\n // Bounded concurrency; one failure stops the batch.\n async removeObjects(opts: { bucket: IBucketRef; objects: IObjectRef[] }): Promise<void> {\n const { bucket, objects } = opts;\n\n await this.mapWithConcurrency({\n items: objects,\n task: ({ item: object }) => this.removeObject({ bucket, object }),\n });\n }\n\n async listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]> {\n const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;\n\n if (!this.isValidBucketName({ bucket })) {\n throw getError({ message: `[listObjects] Invalid bucket name | bucket: ${bucket.name}` });\n }\n\n // `maxKeys: 0` means zero, not unlimited.\n const limit = maxKeys ?? Number.POSITIVE_INFINITY;\n\n if (limit <= 0) {\n return [];\n }\n\n const bucketPath = this.getBucketPath({ bucket });\n const result = await this.exists({ target: bucketPath });\n\n if (!result) {\n return [];\n }\n\n const objects: IObjectInfo[] = [];\n\n const scanDirectory = async (scanOptions: {\n directory: { path: string; prefix?: string };\n }): Promise<void> => {\n const { directory } = scanOptions;\n\n if (objects.length >= limit) {\n return;\n }\n\n const entries = await fsp.readdir(directory.path, { withFileTypes: true });\n\n for (const entry of entries) {\n if (objects.length >= limit) {\n return;\n }\n\n // An object key always joins on '/'; `path.join` would emit '\\' on Windows.\n const entryKey = directory.prefix ? `${directory.prefix}/${entry.name}` : entry.name;\n const entryPath = path.join(directory.path, entry.name);\n\n if (entry.isDirectory()) {\n // A prefix that cannot match below here makes descending pointless.\n const canMatch = !prefix || prefix.startsWith(entryKey) || entryKey.startsWith(prefix);\n\n if (useRecursive && canMatch) {\n await scanDirectory({ directory: { path: entryPath, prefix: entryKey } });\n }\n\n continue;\n }\n\n if (!entry.isFile() || (prefix && !entryKey.startsWith(prefix))) {\n continue;\n }\n\n const stat = await this.statOrNull({ target: entryPath });\n\n if (!stat) {\n continue;\n }\n\n objects.push({ name: entryKey, size: stat.size, lastModified: stat.mtime });\n }\n };\n\n await scanDirectory({ directory: { path: bucketPath } });\n\n return objects;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/modules/temporal/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { BaseHelper } from '@/modules/base';\nimport { getError, isApplicationError } from '@/modules/error';\nimport { IntlTemporalAdapter } from './adapters/intl';\nimport { NativeTemporalAdapter } from './adapters/native';\nimport { TemporalCalendar } from './calendar';\nimport {\n DEFAULT_TEMPORAL_LOCALE,\n DEFAULT_TEMPORAL_TZ as DEFAULT_TEMPORAL_TZ,\n TemporalUnits,\n} from './common/constants';\nimport type {\n TTemporalDurationStyle,\n TTemporalInclusivity,\n TTemporalUnit,\n} from './common/constants';\nimport type {\n ITemporalAdapter,\n ITemporalDurationParts,\n ITemporalLocaleNames,\n ITemporalParts,\n TTemporalFields,\n IZonedTemporalParts,\n TTemporalInput,\n ITemporalHelper,\n} from './common/types';\nimport { TemporalLocale } from './locale';\n\nconst DAY_MILLISECONDS = 86_400_000;\n\n/** 0001-01-01T00:00:00.000Z and 9999-12-31T23:59:59.999Z. */\nconst MIN_INSTANT = -62_135_596_800_000;\nconst MAX_INSTANT = 253_402_300_799_999;\n\nconst MAX_KNOWN_TIME_ZONES = 256;\n\n/** How many entries each `names` list must hold. */\nconst NAME_LENGTHS: Record<keyof ITemporalLocaleNames, number> = {\n months: 12,\n monthsShort: 12,\n weekdays: 7,\n weekdaysShort: 7,\n weekdaysMin: 7,\n meridiem: 2,\n};\n\nconst OUT_OF_RANGE = `outside the years ${TemporalCalendar.MIN_YEAR}-${TemporalCalendar.MAX_YEAR}`; /**\n * The machinery every temporal helper shares: the adapter, the zone and locale it holds, reading a\n * zone's offset, turning wall clocks into instants across daylight-saving gaps and repeats, and the\n * input checks. A helper extends this and supplies the operations in `ITemporalHelper`.\n */\nexport abstract class AbstractTemporalHelper extends BaseHelper implements ITemporalHelper {\n /** Validated once per process: `Intl` answers the same for a zone name every time. */\n protected static readonly knownTzs = new Set<string>();\n\n protected readonly adapter: ITemporalAdapter;\n protected readonly tz: string;\n protected readonly locale: string;\n protected readonly names: Record<string, ITemporalLocaleNames>;\n protected readonly fallback?: string;\n /** Which `names` entry each locale a call wrote in resolved to - `names` never changes after construction. */\n private readonly namesByLocale = new Map<string, ITemporalLocaleNames | undefined>();\n\n /**\n * `locale` (default `en-US`) spells month and weekday names, AM/PM, relative time and durations,\n * unless a call passes its own. `names` replaces `Intl`'s wording for a locale - month and weekday\n * names, the AM/PM marker - keyed by a locale tag; a call in another tag of the same language (`vi`\n * for a `vi-VN` entry) uses it too. `fallback` is what `format` and `formatIntl` write for a value\n * that is not a date when a call gives none; without it, such a value is a 400.\n */\n constructor(opts?: {\n adapter?: ITemporalAdapter;\n tz?: string;\n locale?: string;\n names?: Record<string, ITemporalLocaleNames>;\n fallback?: string;\n scope?: string;\n }) {\n super({ scope: opts?.scope ?? new.target.name });\n\n this.tz = AbstractTemporalHelper.ensureTz({\n tz: opts?.tz ?? DEFAULT_TEMPORAL_TZ,\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n });\n this.locale = AbstractTemporalHelper.ensureLocale({\n locale: opts?.locale ?? DEFAULT_TEMPORAL_LOCALE,\n });\n this.adapter = opts?.adapter ?? AbstractTemporalHelper.defaultAdapter();\n this.names = AbstractTemporalHelper.ensureNames({ names: opts?.names ?? {} });\n this.fallback = opts?.fallback;\n }\n\n /**\n * The zone a `Date`'s local getters use on this runtime - the browser's or the server's. The one\n * place this helper reads the host zone, and only when a wall-clock bridge is not given one.\n */\n static getHostTz(): string {\n return new Intl.DateTimeFormat().resolvedOptions().timeZone;\n }\n\n /** The instant whose wall clock in `to` reads what `value`'s wall clock reads in `from`. */\n protected moveWallClock(opts: { value: TTemporalInput; from: string; to: string }): Date {\n const from = this.resolveTz({ tz: opts.from });\n const to = this.resolveTz({ tz: opts.to });\n const date = this.toDate({ value: opts.value, tz: from });\n\n const wall = TemporalCalendar.wallClockOf({\n parts: this.zonedParts({ epoch: date.getTime(), tz: from }),\n });\n return AbstractTemporalHelper.ensureInstant({\n epoch: this.earliestOf({ parts: wall, tz: to }),\n });\n }\n\n /** Every list the right length, so a bad table fails when the helper is built, not on a screen. */\n protected static ensureNames(opts: {\n names: Record<string, ITemporalLocaleNames>;\n }): Record<string, ITemporalLocaleNames> {\n for (const [locale, names] of Object.entries(opts.names)) {\n AbstractTemporalHelper.ensureLocale({ locale });\n for (const [key, length] of Object.entries(NAME_LENGTHS)) {\n const list: unknown = Reflect.get(names, key);\n if (list === undefined) {\n continue;\n }\n if (\n !Array.isArray(list) ||\n list.length !== length ||\n !list.every((entry) => typeof entry === 'string')\n ) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalHelper] names['${locale}'].${key} must hold ${length} strings`,\n });\n }\n }\n }\n return opts.names;\n }\n\n /** The wording this helper holds for `locale`, if any. */\n protected namesOf(opts: { locale: string }): ITemporalLocaleNames | undefined {\n const { locale } = opts;\n if (Object.hasOwn(this.names, locale)) {\n return this.names[locale];\n }\n\n if (this.namesByLocale.has(locale)) {\n return this.namesByLocale.get(locale);\n }\n // A malformed tag is the caller's 400, before it reaches `Intl.Locale`.\n AbstractTemporalHelper.ensureLocale({ locale });\n\n // No entry for the exact tag: one for the same language serves - `vi` reads a `vi-VN` entry.\n const language = new Intl.Locale(locale).language;\n const match = Object.keys(this.names).find((key) => new Intl.Locale(key).language === language);\n const names = match === undefined ? undefined : this.names[match];\n this.namesByLocale.set(locale, names);\n return names;\n }\n\n /**\n * The value as a date for a writer: with a fallback - the call's, else the helper's - a value that\n * is not a date answers `null`; without one it is a 400, null included.\n */\n protected readDate(opts: {\n value: TTemporalInput | null | undefined;\n tz: string;\n fallback?: string;\n }): Date | null {\n const { value, tz } = opts;\n if ((opts.fallback ?? this.fallback) !== undefined) {\n return this.tryToDate({ value, tz });\n }\n if (value === null || value === undefined) {\n throw AbstractTemporalHelper.notADate({ value });\n }\n return this.toDate({ value, tz });\n }\n\n /** The runtime's `Temporal` where it has one; `Intl`, which every runtime has, everywhere else. */\n protected static defaultAdapter(): ITemporalAdapter {\n return NativeTemporalAdapter.isTemporalNamespace(Reflect.get(globalThis, 'Temporal'))\n ? new NativeTemporalAdapter()\n : new IntlTemporalAdapter();\n }\n\n protected static ensureLocale(opts: { locale: string }): string {\n TemporalLocale.of({ locale: opts.locale });\n return opts.locale;\n }\n\n /** A parse or input error the caller may treat as \"not a date\"; anything else is a bug and still throws. */\n protected static isRefusal(error: unknown): boolean {\n return isApplicationError(error) && error.statusCode === HTTP.ResultCodes.RS_4.BadRequest;\n }\n\n protected static ensureTz(opts: { tz: string; statusCode: number }): string {\n const { tz, statusCode } = opts;\n if (AbstractTemporalHelper.knownTzs.has(tz)) {\n return tz;\n }\n\n try {\n new Intl.DateTimeFormat('en-US', { timeZone: tz });\n } catch (error) {\n throw getError({\n statusCode,\n message: `[TemporalHelper] unknown time zone '${tz}' | ${error instanceof Error ? error.message : String(error)}`,\n });\n }\n\n if (AbstractTemporalHelper.knownTzs.size < MAX_KNOWN_TIME_ZONES) {\n AbstractTemporalHelper.knownTzs.add(tz);\n }\n return tz;\n }\n\n protected static ensureUnit(opts: { unit: string; amount?: number }): void {\n const { unit, amount } = opts;\n if (!TemporalUnits.isValid(unit)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] unknown unit '${unit}' | Supported: ${[...TemporalUnits.SCHEME_SET].join(', ')}`,\n });\n }\n if (amount === undefined) {\n return;\n }\n // Elapsed time takes a fraction (1.5 hours is 90 minutes); a calendar unit has no half.\n const isElapsed = TemporalCalendar.EXACT_UNIT_MILLISECONDS[unit] !== undefined;\n if (isElapsed ? !Number.isFinite(amount) : !Number.isInteger(amount)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: isElapsed\n ? `[TemporalHelper] amount must be a finite number - received ${amount}`\n : `[TemporalHelper] amount must be an integer for '${unit}' - received ${amount}`,\n });\n }\n }\n\n /** Every result passes here: an overflowing `add` is refused, never an Invalid Date. */\n protected static ensureInstant(opts: { epoch: number }): Date {\n const { epoch } = opts;\n if (!(epoch >= MIN_INSTANT && epoch <= MAX_INSTANT)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] ${Number.isNaN(epoch) ? 'invalid date' : OUT_OF_RANGE} - received ${epoch}`,\n });\n }\n return new Date(epoch);\n }\n\n protected static ensureYear(opts: { parts: ITemporalParts }): void {\n if (!TemporalCalendar.isSupportedYear({ year: opts.parts.year })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] year ${opts.parts.year} is ${OUT_OF_RANGE}`,\n });\n }\n }\n\n protected resolveTz(opts: { tz?: string }): string {\n return opts.tz === undefined\n ? this.tz\n : AbstractTemporalHelper.ensureTz({\n tz: opts.tz,\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n });\n }\n\n /** The adapter's one answer, rounded: an offset is whole milliseconds, a library's float may not be. */\n protected offsetAt(opts: { epoch: number; tz: string }): number {\n return Math.round(\n this.adapter.getOffsetMilliseconds({ value: new Date(opts.epoch), tz: opts.tz }),\n );\n }\n\n protected zonedParts(opts: { epoch: number; tz: string }): IZonedTemporalParts {\n const parts = TemporalCalendar.wallClockAt({\n epoch: opts.epoch,\n offsetMilliseconds: this.offsetAt(opts),\n });\n AbstractTemporalHelper.ensureYear({ parts });\n return parts;\n }\n\n /**\n * Every instant whose wall clock reads `parts` in the zone, earliest first: one as a rule, two\n * when the clock goes back, none when it jumps forward. `forward` is where a skipped time lands -\n * read with the offset from before the jump, so it moves past the gap.\n */\n protected instantsOf(opts: { parts: ITemporalParts; tz: string }): {\n instants: Array<number>;\n forward: number;\n } {\n const { parts, tz } = opts;\n const local = TemporalCalendar.epochAtOffset({ parts, offsetMilliseconds: 0 });\n const before = this.offsetAt({ epoch: local - DAY_MILLISECONDS, tz });\n const after = this.offsetAt({ epoch: local + DAY_MILLISECONDS, tz });\n\n const offsets = before === after ? [before] : [before, after];\n const instants: Array<number> = [];\n for (const offset of offsets) {\n const candidate = local - offset;\n if (this.offsetAt({ epoch: candidate, tz }) === offset) {\n instants.push(candidate);\n }\n }\n instants.sort((left, right) => left - right);\n\n return { instants, forward: local - before };\n }\n\n /** The instant wall-clock `parts` name: a skipped time moves forward, a repeated one takes the earlier. */\n protected earliestOf(opts: { parts: ITemporalParts; tz: string }): number {\n const { instants, forward } = this.instantsOf(opts);\n return instants[0] ?? forward;\n }\n\n /**\n * `[start, end)` of the unit holding `epoch`. A day or longer starts at its first instant. An hour\n * or less repeats when the clock goes back, so it starts at the latest start not after `epoch`,\n * and ends where the wall clock next shows either the following unit or this one's start again.\n */\n protected unitBounds(opts: { epoch: number; unit: TTemporalUnit; tz: string }): {\n start: number;\n end: number;\n } {\n const { epoch, unit, tz } = opts;\n const startParts = TemporalCalendar.truncate({\n parts: this.zonedParts({ epoch, tz }),\n unit,\n });\n const nextParts = TemporalCalendar.shift({ parts: startParts, amount: 1, unit });\n AbstractTemporalHelper.ensureYear({ parts: nextParts });\n\n const starts = this.instantsOf({ parts: startParts, tz });\n if (TemporalCalendar.EXACT_UNIT_MILLISECONDS[unit] === undefined) {\n const start = starts.instants[0] ?? starts.forward;\n return { start, end: this.earliestOf({ parts: nextParts, tz }) };\n }\n\n const started = starts.instants.filter((instant) => instant <= epoch);\n const start = started.at(-1) ?? starts.instants[0] ?? starts.forward;\n\n const nexts = this.instantsOf({ parts: nextParts, tz });\n const following = nexts.instants.find((instant) => instant > start) ?? nexts.forward;\n const repeated = starts.instants.find((instant) => instant > start);\n return { start, end: repeated === undefined ? following : Math.min(repeated, following) };\n }\n\n getTz(): string {\n return this.tz;\n }\n\n getLocale(): string {\n return this.locale;\n }\n\n now(): Date {\n return new Date();\n }\n\n /** The instant a value names. An ISO string without an offset is read as wall clock in the zone. */\n toDate(opts: { value: TTemporalInput; tz?: string }): Date {\n const { value } = opts;\n\n if (typeof value === 'string') {\n return this.parse({ value, tz: opts.tz });\n }\n if (value instanceof Date) {\n return AbstractTemporalHelper.ensureInstant({ epoch: value.getTime() });\n }\n if (typeof value === 'number') {\n return AbstractTemporalHelper.ensureInstant({ epoch: value });\n }\n\n // `null` above all: read as a number it would be 1970, a date nobody meant.\n throw AbstractTemporalHelper.notADate({ value });\n }\n\n protected static notADate(opts: { value: unknown }) {\n const { value } = opts;\n return getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] not a date - received ${value === null ? 'null' : typeof value}`,\n });\n }\n\n /** `toDate`, answering `null` where `toDate` refuses the value: null, undefined, bad text, NaN. */\n tryToDate(opts: { value: TTemporalInput | null | undefined; tz?: string }): Date | null {\n const { value } = opts;\n // Outside the try: a bad zone is the caller's bug, not an unreadable value.\n const tz = this.resolveTz({ tz: opts.tz });\n if (value === null || value === undefined) {\n return null;\n }\n\n try {\n return this.toDate({ value, tz });\n } catch (error) {\n if (AbstractTemporalHelper.isRefusal(error)) {\n return null;\n }\n throw error;\n }\n }\n\n /** The wall clock the value shows in the zone, with its ISO weekday and UTC offset. */\n parts(opts: { value: TTemporalInput; tz?: string }): IZonedTemporalParts {\n const tz = this.resolveTz({ tz: opts.tz });\n const date = this.toDate({ value: opts.value, tz });\n return this.zonedParts({ epoch: date.getTime(), tz });\n }\n\n /**\n * Fractional months from `other` to `value` (dayjs and moment's month difference): anchored on the\n * date with the later day of the month, whole months by `add`, the rest as a share of the month\n * it falls in.\n */\n protected monthGap(opts: { value: number; other: number; tz: string }): number {\n const { value, other, tz } = opts;\n const valueParts = this.zonedParts({ epoch: value, tz });\n const otherParts = this.zonedParts({ epoch: other, tz });\n if (valueParts.day < otherParts.day) {\n return -this.monthGap({ value: other, other: value, tz });\n }\n\n const whole = (otherParts.year - valueParts.year) * 12 + (otherParts.month - valueParts.month);\n const anchor = this.shiftMonthsFrom({ parts: valueParts, months: whole, tz });\n const isBelow = other - anchor < 0;\n const nextAnchor = this.shiftMonthsFrom({\n parts: valueParts,\n months: whole + (isBelow ? -1 : 1),\n tz,\n });\n const span = isBelow ? anchor - nextAnchor : nextAnchor - anchor;\n\n return -(whole + (other - anchor) / span) || 0;\n }\n\n /** `add` by months without the 1-9999 check: an anchor one month past the range is still a number. */\n protected shiftMonthsFrom(opts: {\n parts: IZonedTemporalParts;\n months: number;\n tz: string;\n }): number {\n const { parts, months, tz } = opts;\n const shifted = TemporalCalendar.shift({\n parts: TemporalCalendar.wallClockOf({ parts }),\n amount: months,\n unit: TemporalUnits.MONTH,\n });\n return this.earliestOf({ parts: shifted, tz });\n }\n\n abstract fromWallClock(opts: { value: TTemporalInput; sourceTz?: string; tz?: string }): Date;\n\n abstract toWallClock(opts: { value: TTemporalInput; targetTz?: string; tz?: string }): Date;\n\n abstract clone(opts: { locale?: string; tz?: string }): ITemporalHelper;\n\n abstract parse(opts: { value: string; pattern?: string; tz?: string }): Date;\n\n abstract tryParse(opts: { value: string; pattern?: string; tz?: string }): Date | null;\n\n abstract isValid(opts: {\n value: TTemporalInput | null | undefined;\n pattern?: string;\n tz?: string;\n }): boolean;\n\n abstract format(opts: {\n value: TTemporalInput | null | undefined;\n pattern?: string;\n tz?: string;\n locale?: string;\n fallback?: string;\n }): string;\n\n abstract formatIntl(opts: {\n value: TTemporalInput;\n options?: Omit<Intl.DateTimeFormatOptions, 'timeZone'>;\n tz?: string;\n locale?: string;\n }): string;\n\n abstract add(opts: {\n value: TTemporalInput;\n amount: number;\n unit: TTemporalUnit;\n tz?: string;\n }): Date;\n\n abstract subtract(opts: {\n value: TTemporalInput;\n amount: number;\n unit: TTemporalUnit;\n tz?: string;\n }): Date;\n\n abstract startOf(opts: { value: TTemporalInput; unit: TTemporalUnit; tz?: string }): Date;\n\n abstract endOf(opts: { value: TTemporalInput; unit: TTemporalUnit; tz?: string }): Date;\n\n abstract isWeekday(opts: { value: TTemporalInput; tz?: string }): boolean;\n\n abstract nextWeekday(opts: { value: TTemporalInput; tz?: string }): Date;\n\n abstract previousWeekday(opts: { value: TTemporalInput; tz?: string }): Date;\n\n abstract set(opts: { value: TTemporalInput; tz?: string } & TTemporalFields): Date;\n\n abstract isBefore(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isAfter(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isSame(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isSameOrBefore(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isSameOrAfter(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isBetween(opts: {\n value: TTemporalInput;\n from: TTemporalInput;\n to: TTemporalInput;\n unit?: TTemporalUnit;\n inclusivity?: TTemporalInclusivity;\n tz?: string;\n }): boolean;\n\n abstract diff(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit: TTemporalUnit;\n tz?: string;\n }): number;\n\n abstract compare(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): -1 | 0 | 1;\n\n abstract relative(opts: {\n value: TTemporalInput;\n base?: TTemporalInput;\n unit?: TTemporalUnit;\n numeric?: Intl.RelativeTimeFormatNumeric;\n style?: Intl.RelativeTimeFormatStyle;\n tz?: string;\n locale?: string;\n }): string;\n\n abstract durationParts(opts: { milliseconds: number }): ITemporalDurationParts;\n\n abstract formatDuration(opts: {\n milliseconds: number;\n style?: TTemporalDurationStyle;\n /** A clock face instead of words: `HH:mm:ss`, `mm:ss`, `D[d] HH:mm`. The largest token carries the rest. */\n pattern?: string;\n /** Only the largest units that are not zero: `1` writes `2 giờ` for 2 hours 5 minutes. */\n maxUnits?: number;\n locale?: string;\n }): string;\n}\n"]}
1
+ {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/modules/temporal/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { BaseHelper } from '@/modules/base';\nimport { getError, isApplicationError } from '@/modules/error';\nimport { IntlTemporalAdapter } from './adapters/intl';\nimport { NativeTemporalAdapter } from './adapters/native';\nimport { TemporalCalendar } from './calendar';\nimport {\n DEFAULT_TEMPORAL_LOCALE,\n DEFAULT_TEMPORAL_TZ as DEFAULT_TEMPORAL_TZ,\n TemporalUnits,\n} from './common/constants';\nimport type {\n TTemporalDurationStyle,\n TTemporalInclusivity,\n TTemporalUnit,\n} from './common/constants';\nimport type {\n ITemporalAdapter,\n ITemporalDurationParts,\n ITemporalLocaleNames,\n ITemporalParts,\n TTemporalFields,\n IZonedTemporalParts,\n TTemporalInput,\n ITemporalHelper,\n} from './common/types';\nimport { TemporalLocale } from './locale';\n\nconst DAY_MILLISECONDS = 86_400_000;\n\n/** 0001-01-01T00:00:00.000Z and 9999-12-31T23:59:59.999Z. */\nconst MIN_INSTANT = -62_135_596_800_000;\nconst MAX_INSTANT = 253_402_300_799_999;\n\nconst MAX_KNOWN_TIME_ZONES = 256;\n\n/** How many entries each `names` list must hold. */\nconst NAME_LENGTHS: Record<keyof ITemporalLocaleNames, number> = {\n months: 12,\n monthsShort: 12,\n weekdays: 7,\n weekdaysShort: 7,\n weekdaysMin: 7,\n meridiem: 2,\n};\n\nconst OUT_OF_RANGE = `outside the years ${TemporalCalendar.MIN_YEAR}-${TemporalCalendar.MAX_YEAR}`; /**\n * The machinery every temporal helper shares: the adapter, the zone and locale it holds, reading a\n * zone's offset, turning wall clocks into instants across daylight-saving gaps and repeats, and the\n * input checks. A helper extends this and supplies the operations in `ITemporalHelper`.\n */\nexport abstract class AbstractTemporalHelper extends BaseHelper implements ITemporalHelper {\n /** Validated once per process: `Intl` answers the same for a zone name every time. */\n protected static readonly knownTzs = new Set<string>();\n\n protected readonly adapter: ITemporalAdapter;\n protected readonly tz: string;\n protected readonly locale: string;\n protected readonly names: Record<string, ITemporalLocaleNames>;\n protected readonly fallback?: string;\n /** Which `names` entry each locale a call wrote in resolved to - `names` never changes after construction. */\n private readonly namesByLocale = new Map<string, ITemporalLocaleNames | undefined>();\n\n /**\n * `locale` (default `en-US`) spells month and weekday names, AM/PM, relative time and durations,\n * unless a call passes its own. `names` replaces `Intl`'s wording for a locale - month and weekday\n * names, the AM/PM marker - keyed by a locale tag; a call in another tag of the same language (`vi`\n * for a `vi-VN` entry) uses it too. `fallback` is what `format` and `formatIntl` write for a value\n * that is not a date when a call gives none; without it, such a value is a 400.\n */\n constructor(opts?: {\n adapter?: ITemporalAdapter;\n tz?: string;\n locale?: string;\n names?: Record<string, ITemporalLocaleNames>;\n fallback?: string;\n scope?: string;\n }) {\n super({ scope: opts?.scope ?? new.target.name });\n\n this.tz = AbstractTemporalHelper.ensureTz({\n tz: opts?.tz ?? DEFAULT_TEMPORAL_TZ,\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n });\n this.locale = AbstractTemporalHelper.ensureLocale({\n locale: opts?.locale ?? DEFAULT_TEMPORAL_LOCALE,\n });\n this.adapter = opts?.adapter ?? AbstractTemporalHelper.defaultAdapter();\n this.names = AbstractTemporalHelper.ensureNames({ names: opts?.names ?? {} });\n this.fallback = opts?.fallback;\n }\n\n /**\n * The zone a `Date`'s local getters use on this runtime - the browser's or the server's. The one\n * place this helper reads the host zone, and only when a wall-clock bridge is not given one.\n */\n static getHostTz(): string {\n return new Intl.DateTimeFormat().resolvedOptions().timeZone;\n }\n\n /** The instant whose wall clock in `to` reads what `value`'s wall clock reads in `from`. */\n protected moveWallClock(opts: { value: TTemporalInput; from: string; to: string }): Date {\n const from = this.resolveTz({ tz: opts.from });\n const to = this.resolveTz({ tz: opts.to });\n const date = this.toDate({ value: opts.value, tz: from });\n\n const wall = TemporalCalendar.wallClockOf({\n parts: this.zonedParts({ epoch: date.getTime(), tz: from }),\n });\n\n return AbstractTemporalHelper.ensureInstant({\n epoch: this.earliestOf({ parts: wall, tz: to }),\n });\n }\n\n /** Every list the right length, so a bad table fails when the helper is built, not on a screen. */\n protected static ensureNames(opts: {\n names: Record<string, ITemporalLocaleNames>;\n }): Record<string, ITemporalLocaleNames> {\n for (const [locale, names] of Object.entries(opts.names)) {\n AbstractTemporalHelper.ensureLocale({ locale });\n\n for (const [key, length] of Object.entries(NAME_LENGTHS)) {\n const list: unknown = Reflect.get(names, key);\n\n if (list === undefined) {\n continue;\n }\n\n if (\n !Array.isArray(list) ||\n list.length !== length ||\n !list.every((entry) => typeof entry === 'string')\n ) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalHelper] names['${locale}'].${key} must hold ${length} strings`,\n });\n }\n }\n }\n\n return opts.names;\n }\n\n /** The wording this helper holds for `locale`, if any. */\n protected namesOf(opts: { locale: string }): ITemporalLocaleNames | undefined {\n const { locale } = opts;\n\n if (Object.hasOwn(this.names, locale)) {\n return this.names[locale];\n }\n\n if (this.namesByLocale.has(locale)) {\n return this.namesByLocale.get(locale);\n }\n\n // A malformed tag is the caller's 400, before it reaches `Intl.Locale`.\n AbstractTemporalHelper.ensureLocale({ locale });\n\n // No entry for the exact tag: one for the same language serves - `vi` reads a `vi-VN` entry.\n const language = new Intl.Locale(locale).language;\n const match = Object.keys(this.names).find((key) => new Intl.Locale(key).language === language);\n const names = match === undefined ? undefined : this.names[match];\n this.namesByLocale.set(locale, names);\n\n return names;\n }\n\n /**\n * The value as a date for a writer: with a fallback - the call's, else the helper's - a value that\n * is not a date answers `null`; without one it is a 400, null included.\n */\n protected readDate(opts: {\n value: TTemporalInput | null | undefined;\n tz: string;\n fallback?: string;\n }): Date | null {\n const { value, tz } = opts;\n\n if ((opts.fallback ?? this.fallback) !== undefined) {\n return this.tryToDate({ value, tz });\n }\n\n if (value === null || value === undefined) {\n throw AbstractTemporalHelper.notADate({ value });\n }\n\n return this.toDate({ value, tz });\n }\n\n /** The runtime's `Temporal` where it has one; `Intl`, which every runtime has, everywhere else. */\n protected static defaultAdapter(): ITemporalAdapter {\n return NativeTemporalAdapter.isTemporalNamespace(Reflect.get(globalThis, 'Temporal'))\n ? new NativeTemporalAdapter()\n : new IntlTemporalAdapter();\n }\n\n protected static ensureLocale(opts: { locale: string }): string {\n TemporalLocale.of({ locale: opts.locale });\n\n return opts.locale;\n }\n\n /** A parse or input error the caller may treat as \"not a date\"; anything else is a bug and still throws. */\n protected static isRefusal(error: unknown): boolean {\n return isApplicationError(error) && error.statusCode === HTTP.ResultCodes.RS_4.BadRequest;\n }\n\n protected static ensureTz(opts: { tz: string; statusCode: number }): string {\n const { tz, statusCode } = opts;\n\n if (AbstractTemporalHelper.knownTzs.has(tz)) {\n return tz;\n }\n\n try {\n new Intl.DateTimeFormat('en-US', { timeZone: tz });\n } catch (error) {\n throw getError({\n statusCode,\n message: `[TemporalHelper] unknown time zone '${tz}' | ${error instanceof Error ? error.message : String(error)}`,\n });\n }\n\n if (AbstractTemporalHelper.knownTzs.size < MAX_KNOWN_TIME_ZONES) {\n AbstractTemporalHelper.knownTzs.add(tz);\n }\n\n return tz;\n }\n\n protected static ensureUnit(opts: { unit: string; amount?: number }): void {\n const { unit, amount } = opts;\n\n if (!TemporalUnits.isValid(unit)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] unknown unit '${unit}' | Supported: ${[...TemporalUnits.SCHEME_SET].join(', ')}`,\n });\n }\n\n if (amount === undefined) {\n return;\n }\n\n // Elapsed time takes a fraction (1.5 hours is 90 minutes); a calendar unit has no half.\n const isElapsed = TemporalCalendar.EXACT_UNIT_MILLISECONDS[unit] !== undefined;\n\n if (isElapsed ? !Number.isFinite(amount) : !Number.isInteger(amount)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: isElapsed\n ? `[TemporalHelper] amount must be a finite number - received ${amount}`\n : `[TemporalHelper] amount must be an integer for '${unit}' - received ${amount}`,\n });\n }\n }\n\n /** Every result passes here: an overflowing `add` is refused, never an Invalid Date. */\n protected static ensureInstant(opts: { epoch: number }): Date {\n const { epoch } = opts;\n\n if (!(epoch >= MIN_INSTANT && epoch <= MAX_INSTANT)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] ${Number.isNaN(epoch) ? 'invalid date' : OUT_OF_RANGE} - received ${epoch}`,\n });\n }\n\n return new Date(epoch);\n }\n\n protected static ensureYear(opts: { parts: ITemporalParts }): void {\n if (!TemporalCalendar.isSupportedYear({ year: opts.parts.year })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] year ${opts.parts.year} is ${OUT_OF_RANGE}`,\n });\n }\n }\n\n protected resolveTz(opts: { tz?: string }): string {\n return opts.tz === undefined\n ? this.tz\n : AbstractTemporalHelper.ensureTz({\n tz: opts.tz,\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n });\n }\n\n /** The adapter's one answer, rounded: an offset is whole milliseconds, a library's float may not be. */\n protected offsetAt(opts: { epoch: number; tz: string }): number {\n return Math.round(\n this.adapter.getOffsetMilliseconds({ value: new Date(opts.epoch), tz: opts.tz }),\n );\n }\n\n protected zonedParts(opts: { epoch: number; tz: string }): IZonedTemporalParts {\n const parts = TemporalCalendar.wallClockAt({\n epoch: opts.epoch,\n offsetMilliseconds: this.offsetAt(opts),\n });\n AbstractTemporalHelper.ensureYear({ parts });\n\n return parts;\n }\n\n /**\n * Every instant whose wall clock reads `parts` in the zone, earliest first: one as a rule, two\n * when the clock goes back, none when it jumps forward. `forward` is where a skipped time lands -\n * read with the offset from before the jump, so it moves past the gap.\n */\n protected instantsOf(opts: { parts: ITemporalParts; tz: string }): {\n instants: Array<number>;\n forward: number;\n } {\n const { parts, tz } = opts;\n const local = TemporalCalendar.epochAtOffset({ parts, offsetMilliseconds: 0 });\n const before = this.offsetAt({ epoch: local - DAY_MILLISECONDS, tz });\n const after = this.offsetAt({ epoch: local + DAY_MILLISECONDS, tz });\n\n const offsets = before === after ? [before] : [before, after];\n const instants: Array<number> = [];\n\n for (const offset of offsets) {\n const candidate = local - offset;\n\n if (this.offsetAt({ epoch: candidate, tz }) === offset) {\n instants.push(candidate);\n }\n }\n\n instants.sort((left, right) => left - right);\n\n return { instants, forward: local - before };\n }\n\n /** The instant wall-clock `parts` name: a skipped time moves forward, a repeated one takes the earlier. */\n protected earliestOf(opts: { parts: ITemporalParts; tz: string }): number {\n const { instants, forward } = this.instantsOf(opts);\n\n return instants[0] ?? forward;\n }\n\n /**\n * `[start, end)` of the unit holding `epoch`. A day or longer starts at its first instant. An hour\n * or less repeats when the clock goes back, so it starts at the latest start not after `epoch`,\n * and ends where the wall clock next shows either the following unit or this one's start again.\n */\n protected unitBounds(opts: { epoch: number; unit: TTemporalUnit; tz: string }): {\n start: number;\n end: number;\n } {\n const { epoch, unit, tz } = opts;\n const startParts = TemporalCalendar.truncate({\n parts: this.zonedParts({ epoch, tz }),\n unit,\n });\n const nextParts = TemporalCalendar.shift({ parts: startParts, amount: 1, unit });\n AbstractTemporalHelper.ensureYear({ parts: nextParts });\n\n const starts = this.instantsOf({ parts: startParts, tz });\n\n if (TemporalCalendar.EXACT_UNIT_MILLISECONDS[unit] === undefined) {\n const start = starts.instants[0] ?? starts.forward;\n\n return { start, end: this.earliestOf({ parts: nextParts, tz }) };\n }\n\n const started = starts.instants.filter((instant) => instant <= epoch);\n const start = started.at(-1) ?? starts.instants[0] ?? starts.forward;\n\n const nexts = this.instantsOf({ parts: nextParts, tz });\n const following = nexts.instants.find((instant) => instant > start) ?? nexts.forward;\n const repeated = starts.instants.find((instant) => instant > start);\n\n return { start, end: repeated === undefined ? following : Math.min(repeated, following) };\n }\n\n getTz(): string {\n return this.tz;\n }\n\n getLocale(): string {\n return this.locale;\n }\n\n now(): Date {\n return new Date();\n }\n\n /** The instant a value names. An ISO string without an offset is read as wall clock in the zone. */\n toDate(opts: { value: TTemporalInput; tz?: string }): Date {\n const { value } = opts;\n\n if (typeof value === 'string') {\n return this.parse({ value, tz: opts.tz });\n }\n\n if (value instanceof Date) {\n return AbstractTemporalHelper.ensureInstant({ epoch: value.getTime() });\n }\n\n if (typeof value === 'number') {\n return AbstractTemporalHelper.ensureInstant({ epoch: value });\n }\n\n // `null` above all: read as a number it would be 1970, a date nobody meant.\n throw AbstractTemporalHelper.notADate({ value });\n }\n\n protected static notADate(opts: { value: unknown }) {\n const { value } = opts;\n\n return getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[TemporalHelper] not a date - received ${value === null ? 'null' : typeof value}`,\n });\n }\n\n /** `toDate`, answering `null` where `toDate` refuses the value: null, undefined, bad text, NaN. */\n tryToDate(opts: { value: TTemporalInput | null | undefined; tz?: string }): Date | null {\n const { value } = opts;\n // Outside the try: a bad zone is the caller's bug, not an unreadable value.\n const tz = this.resolveTz({ tz: opts.tz });\n\n if (value === null || value === undefined) {\n return null;\n }\n\n try {\n return this.toDate({ value, tz });\n } catch (error) {\n if (AbstractTemporalHelper.isRefusal(error)) {\n return null;\n }\n\n throw error;\n }\n }\n\n /** The wall clock the value shows in the zone, with its ISO weekday and UTC offset. */\n parts(opts: { value: TTemporalInput; tz?: string }): IZonedTemporalParts {\n const tz = this.resolveTz({ tz: opts.tz });\n const date = this.toDate({ value: opts.value, tz });\n\n return this.zonedParts({ epoch: date.getTime(), tz });\n }\n\n /**\n * Fractional months from `other` to `value` (dayjs and moment's month difference): anchored on the\n * date with the later day of the month, whole months by `add`, the rest as a share of the month\n * it falls in.\n */\n protected monthGap(opts: { value: number; other: number; tz: string }): number {\n const { value, other, tz } = opts;\n const valueParts = this.zonedParts({ epoch: value, tz });\n const otherParts = this.zonedParts({ epoch: other, tz });\n\n if (valueParts.day < otherParts.day) {\n return -this.monthGap({ value: other, other: value, tz });\n }\n\n const whole = (otherParts.year - valueParts.year) * 12 + (otherParts.month - valueParts.month);\n const anchor = this.shiftMonthsFrom({ parts: valueParts, months: whole, tz });\n const isBelow = other - anchor < 0;\n const nextAnchor = this.shiftMonthsFrom({\n parts: valueParts,\n months: whole + (isBelow ? -1 : 1),\n tz,\n });\n const span = isBelow ? anchor - nextAnchor : nextAnchor - anchor;\n\n return -(whole + (other - anchor) / span) || 0;\n }\n\n /** `add` by months without the 1-9999 check: an anchor one month past the range is still a number. */\n protected shiftMonthsFrom(opts: {\n parts: IZonedTemporalParts;\n months: number;\n tz: string;\n }): number {\n const { parts, months, tz } = opts;\n const shifted = TemporalCalendar.shift({\n parts: TemporalCalendar.wallClockOf({ parts }),\n amount: months,\n unit: TemporalUnits.MONTH,\n });\n\n return this.earliestOf({ parts: shifted, tz });\n }\n\n abstract fromWallClock(opts: { value: TTemporalInput; sourceTz?: string; tz?: string }): Date;\n\n abstract toWallClock(opts: { value: TTemporalInput; targetTz?: string; tz?: string }): Date;\n\n abstract clone(opts: { locale?: string; tz?: string }): ITemporalHelper;\n\n abstract parse(opts: { value: string; pattern?: string; tz?: string }): Date;\n\n abstract tryParse(opts: { value: string; pattern?: string; tz?: string }): Date | null;\n\n abstract isValid(opts: {\n value: TTemporalInput | null | undefined;\n pattern?: string;\n tz?: string;\n }): boolean;\n\n abstract format(opts: {\n value: TTemporalInput | null | undefined;\n pattern?: string;\n tz?: string;\n locale?: string;\n fallback?: string;\n }): string;\n\n abstract formatIntl(opts: {\n value: TTemporalInput;\n options?: Omit<Intl.DateTimeFormatOptions, 'timeZone'>;\n tz?: string;\n locale?: string;\n }): string;\n\n abstract add(opts: {\n value: TTemporalInput;\n amount: number;\n unit: TTemporalUnit;\n tz?: string;\n }): Date;\n\n abstract subtract(opts: {\n value: TTemporalInput;\n amount: number;\n unit: TTemporalUnit;\n tz?: string;\n }): Date;\n\n abstract startOf(opts: { value: TTemporalInput; unit: TTemporalUnit; tz?: string }): Date;\n\n abstract endOf(opts: { value: TTemporalInput; unit: TTemporalUnit; tz?: string }): Date;\n\n abstract isWeekday(opts: { value: TTemporalInput; tz?: string }): boolean;\n\n abstract nextWeekday(opts: { value: TTemporalInput; tz?: string }): Date;\n\n abstract previousWeekday(opts: { value: TTemporalInput; tz?: string }): Date;\n\n abstract set(opts: { value: TTemporalInput; tz?: string } & TTemporalFields): Date;\n\n abstract isBefore(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isAfter(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isSame(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isSameOrBefore(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isSameOrAfter(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): boolean;\n\n abstract isBetween(opts: {\n value: TTemporalInput;\n from: TTemporalInput;\n to: TTemporalInput;\n unit?: TTemporalUnit;\n inclusivity?: TTemporalInclusivity;\n tz?: string;\n }): boolean;\n\n abstract diff(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit: TTemporalUnit;\n tz?: string;\n }): number;\n\n abstract compare(opts: {\n value: TTemporalInput;\n other: TTemporalInput;\n unit?: TTemporalUnit;\n tz?: string;\n }): -1 | 0 | 1;\n\n abstract relative(opts: {\n value: TTemporalInput;\n base?: TTemporalInput;\n unit?: TTemporalUnit;\n numeric?: Intl.RelativeTimeFormatNumeric;\n style?: Intl.RelativeTimeFormatStyle;\n tz?: string;\n locale?: string;\n }): string;\n\n abstract durationParts(opts: { milliseconds: number }): ITemporalDurationParts;\n\n abstract formatDuration(opts: {\n milliseconds: number;\n style?: TTemporalDurationStyle;\n /** A clock face instead of words: `HH:mm:ss`, `mm:ss`, `D[d] HH:mm`. The largest token carries the rest. */\n pattern?: string;\n /** Only the largest units that are not zero: `1` writes `2 giờ` for 2 hours 5 minutes. */\n maxUnits?: number;\n locale?: string;\n }): string;\n}\n"]}