@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":"pattern.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/pattern/pattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,gGAAgG;AAChG,MAAM,OAAO,eAAe;IAC1B,+GAA+G;aACvF,aAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE7E;;;OAGG;IACK,MAAM,CAAC,OAAO,CAAC,IAAyB;QAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,OAAO,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEpC,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;gBACjD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACd,MAAM,QAAQ,CAAC;wBACb,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;wBACrD,OAAO,EAAE,4CAA4C,OAAO,GAAG;qBAChE,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC9C,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,mFAAmF;YACnF,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;gBAC1F,OAAO,IAAI,SAAS,CAAC;gBACrB,QAAQ,IAAI,CAAC,CAAC;gBACd,SAAS;YACX,CAAC;YAED,IAAI,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;YAC1B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;YAED,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,MAAM,QAAQ,CAAC;oBACb,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;oBACrD,OAAO,EAAE,oCAAoC,GAAG,iBAAiB,OAAO,kBAAkB,cAAc,CAAC,SAAS,2BAA2B;iBAC9I,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC3B,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9B,QAAQ,GAAG,MAAM,CAAC;QACpB,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,GAAG,cAAc,CAAC,qBAAqB,EAAE,CAAC;YACzE,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qGAAqG;IACrG,MAAM,CAAC,MAAM,CAAC,IAKb;QACC,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,IAAI,QAAoC,CAAC;QACzC,MAAM,KAAK,GAAG;YACZ,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,KAAK,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;SACxE,CAAC;QAEF,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI;gBACF,SAAS,IAAI,OAAO;oBAClB,CAAC,CAAC,OAAO,CAAC,OAAO;oBACjB,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gJAAgJ;IAChJ,MAAM,CAAC,KAAK,CAAC,IAGZ;QACC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,MAAM,KAAK,GAAmB;YAC5B,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,WAAW,EAAE,CAAC;SACf,CAAC;QACF,IAAI,kBAAsC,CAAC;QAC3C,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;oBACjD,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;YAC1B,0FAA0F;YAC1F,IAAI,cAAc,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,QAAQ,CAAC;oBACb,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;oBACrD,OAAO,EAAE,sBAAsB,KAAK,iBAAiB,IAAI,CAAC,OAAO,0DAA0D;iBAC5H,CAAC,CAAC;YACL,CAAC;YAED,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,KAAK,GAAG,EAAE,CAAC,CAAC;gBACxF,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,kBAAkB,GAAG,MAAM,CAAC,YAAY,CAAC;gBACzC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;gBACvB,SAAS;YACX,CAAC;YAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5E,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,KAAK,CAAC,IAAI;oBACR,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAClF,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACtE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,CAAC;QAED,OAAO,QAAQ,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,CAAC","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { getError } from '@/modules/error';\nimport type { ITemporalLocaleNames, ITemporalParts, IZonedTemporalParts } from '../common/types';\nimport { TemporalLocale } from '../locale';\nimport { TemporalTokens } from './tokens';\nimport type { TPatternSegment } from './common/types';\n\n/** The pattern dialect: compiled once per pattern, then formatted and parsed from the cache. */\nexport class TemporalPattern {\n /** A service formats the same few patterns millions of times; capped so caller-fed patterns cannot grow it. */\n private static readonly compiled = new Map<string, Array<TPatternSegment>>();\n\n /**\n * Splits a pattern into tokens and literals. A run of one letter is one token, and an unknown run\n * is refused: `yyyy` is not `YYYY`, and `MMM` is never read as `MM` then `M`.\n */\n private static compile(opts: { pattern: string }): Array<TPatternSegment> {\n const { pattern } = opts;\n const cached = TemporalPattern.compiled.get(pattern);\n if (cached) {\n return cached;\n }\n\n const segments: Array<TPatternSegment> = [];\n let literal = '';\n let position = 0;\n\n while (position < pattern.length) {\n const character = pattern[position];\n\n if (character === '[') {\n const close = pattern.indexOf(']', position + 1);\n if (close < 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalPattern] unclosed [ in pattern '${pattern}'`,\n });\n }\n literal += pattern.slice(position + 1, close);\n position = close + 1;\n continue;\n }\n\n // `T` is the ISO date-time separator, and the one letter a pattern may carry bare.\n if (!TemporalTokens.isLetter({ code: pattern.charCodeAt(position) }) || character === 'T') {\n literal += character;\n position += 1;\n continue;\n }\n\n let runEnd = position + 1;\n while (pattern[runEnd] === character) {\n runEnd += 1;\n }\n\n const run = pattern.slice(position, runEnd);\n if (!TemporalTokens.isToken(run)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalPattern] unknown token '${run}' in pattern '${pattern}' | Supported: ${TemporalTokens.SUPPORTED}; wrap text in [brackets]`,\n });\n }\n\n if (literal) {\n segments.push({ literal });\n literal = '';\n }\n segments.push({ token: run });\n position = runEnd;\n }\n\n if (literal) {\n segments.push({ literal });\n }\n\n if (TemporalPattern.compiled.size < TemporalTokens.MAX_COMPILED_PATTERNS) {\n TemporalPattern.compiled.set(pattern, segments);\n }\n return segments;\n }\n\n /** Writes the wall clock; `locale` spells the name tokens, and is only resolved when one is used. */\n static format(opts: {\n pattern: string;\n parts: IZonedTemporalParts;\n locale: string;\n names?: ITemporalLocaleNames;\n }): string {\n const segments = TemporalPattern.compile({ pattern: opts.pattern });\n let resolved: TemporalLocale | undefined;\n const input = {\n parts: opts.parts,\n names: opts.names,\n locale: () => (resolved ??= TemporalLocale.of({ locale: opts.locale })),\n };\n\n let text = '';\n for (const segment of segments) {\n text +=\n 'literal' in segment\n ? segment.literal\n : (TemporalTokens.WRITERS.get(segment.token)?.(input) ?? '');\n }\n return text;\n }\n\n /** The fields a value spells under a pattern, or undefined when it does not match. Unset fields default to the start: month 1, day 1, 00:00. */\n static parse(opts: {\n pattern: string;\n value: string;\n }): { parts: ITemporalParts; offsetMilliseconds?: number } | undefined {\n const { value } = opts;\n const segments = TemporalPattern.compile({ pattern: opts.pattern });\n const parts: ITemporalParts = {\n year: 1970,\n month: 1,\n day: 1,\n hour: 0,\n minute: 0,\n second: 0,\n millisecond: 0,\n };\n let offsetMilliseconds: number | undefined;\n let position = 0;\n\n for (const segment of segments) {\n if ('literal' in segment) {\n if (!value.startsWith(segment.literal, position)) {\n return undefined;\n }\n position += segment.literal.length;\n continue;\n }\n\n const { token } = segment;\n // A pattern is code, not input: a write-only token here is a bug, as an unknown token is.\n if (TemporalTokens.isWriteOnlyToken(token)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalPattern] '${token}' in pattern '${opts.pattern}' is for writing only | A parse reads the numeric tokens`,\n });\n }\n\n if (token === 'Z' || token === 'ZZ') {\n const offset = TemporalTokens.readOffset({ value, position, separator: token === 'Z' });\n if (!offset) {\n return undefined;\n }\n offsetMilliseconds = offset.milliseconds;\n position = offset.next;\n continue;\n }\n\n if (token === 'YY') {\n const read = TemporalTokens.readDigits({ value, position, min: 2, max: 2 });\n if (!read) {\n return undefined;\n }\n parts.year =\n read.number + (read.number > TemporalTokens.TWO_DIGIT_YEAR_PIVOT ? 1900 : 2000);\n position = read.next;\n continue;\n }\n\n const [min, max, field] = TemporalTokens.NUMERIC_TOKENS[token];\n const read = TemporalTokens.readDigits({ value, position, min, max });\n if (!read) {\n return undefined;\n }\n parts[field] = read.number;\n position = read.next;\n }\n\n return position === value.length ? { parts, offsetMilliseconds } : undefined;\n }\n}\n"]}
1
+ {"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/pattern/pattern.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { getError } from '@/modules/error';\nimport type { ITemporalLocaleNames, ITemporalParts, IZonedTemporalParts } from '../common/types';\nimport { TemporalLocale } from '../locale';\nimport { TemporalTokens } from './tokens';\nimport type { TPatternSegment } from './common/types';\n\n/** The pattern dialect: compiled once per pattern, then formatted and parsed from the cache. */\nexport class TemporalPattern {\n /** A service formats the same few patterns millions of times; capped so caller-fed patterns cannot grow it. */\n private static readonly compiled = new Map<string, Array<TPatternSegment>>();\n\n /**\n * Splits a pattern into tokens and literals. A run of one letter is one token, and an unknown run\n * is refused: `yyyy` is not `YYYY`, and `MMM` is never read as `MM` then `M`.\n */\n private static compile(opts: { pattern: string }): Array<TPatternSegment> {\n const { pattern } = opts;\n const cached = TemporalPattern.compiled.get(pattern);\n\n if (cached) {\n return cached;\n }\n\n const segments: Array<TPatternSegment> = [];\n let literal = '';\n let position = 0;\n\n while (position < pattern.length) {\n const character = pattern[position];\n\n if (character === '[') {\n const close = pattern.indexOf(']', position + 1);\n\n if (close < 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalPattern] unclosed [ in pattern '${pattern}'`,\n });\n }\n\n literal += pattern.slice(position + 1, close);\n position = close + 1;\n continue;\n }\n\n // `T` is the ISO date-time separator, and the one letter a pattern may carry bare.\n if (!TemporalTokens.isLetter({ code: pattern.charCodeAt(position) }) || character === 'T') {\n literal += character;\n position += 1;\n continue;\n }\n\n let runEnd = position + 1;\n\n while (pattern[runEnd] === character) {\n runEnd += 1;\n }\n\n const run = pattern.slice(position, runEnd);\n\n if (!TemporalTokens.isToken(run)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalPattern] unknown token '${run}' in pattern '${pattern}' | Supported: ${TemporalTokens.SUPPORTED}; wrap text in [brackets]`,\n });\n }\n\n if (literal) {\n segments.push({ literal });\n literal = '';\n }\n\n segments.push({ token: run });\n position = runEnd;\n }\n\n if (literal) {\n segments.push({ literal });\n }\n\n if (TemporalPattern.compiled.size < TemporalTokens.MAX_COMPILED_PATTERNS) {\n TemporalPattern.compiled.set(pattern, segments);\n }\n\n return segments;\n }\n\n /** Writes the wall clock; `locale` spells the name tokens, and is only resolved when one is used. */\n static format(opts: {\n pattern: string;\n parts: IZonedTemporalParts;\n locale: string;\n names?: ITemporalLocaleNames;\n }): string {\n const segments = TemporalPattern.compile({ pattern: opts.pattern });\n let resolved: TemporalLocale | undefined;\n const input = {\n parts: opts.parts,\n names: opts.names,\n locale: () => (resolved ??= TemporalLocale.of({ locale: opts.locale })),\n };\n\n let text = '';\n\n for (const segment of segments) {\n text +=\n 'literal' in segment\n ? segment.literal\n : (TemporalTokens.WRITERS.get(segment.token)?.(input) ?? '');\n }\n\n return text;\n }\n\n /** The fields a value spells under a pattern, or undefined when it does not match. Unset fields default to the start: month 1, day 1, 00:00. */\n static parse(opts: {\n pattern: string;\n value: string;\n }): { parts: ITemporalParts; offsetMilliseconds?: number } | undefined {\n const { value } = opts;\n const segments = TemporalPattern.compile({ pattern: opts.pattern });\n const parts: ITemporalParts = {\n year: 1970,\n month: 1,\n day: 1,\n hour: 0,\n minute: 0,\n second: 0,\n millisecond: 0,\n };\n let offsetMilliseconds: number | undefined;\n let position = 0;\n\n for (const segment of segments) {\n if ('literal' in segment) {\n if (!value.startsWith(segment.literal, position)) {\n return undefined;\n }\n\n position += segment.literal.length;\n continue;\n }\n\n const { token } = segment;\n\n // A pattern is code, not input: a write-only token here is a bug, as an unknown token is.\n if (TemporalTokens.isWriteOnlyToken(token)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[TemporalPattern] '${token}' in pattern '${opts.pattern}' is for writing only | A parse reads the numeric tokens`,\n });\n }\n\n if (token === 'Z' || token === 'ZZ') {\n const offset = TemporalTokens.readOffset({ value, position, separator: token === 'Z' });\n\n if (!offset) {\n return undefined;\n }\n\n offsetMilliseconds = offset.milliseconds;\n position = offset.next;\n continue;\n }\n\n if (token === 'YY') {\n const read = TemporalTokens.readDigits({ value, position, min: 2, max: 2 });\n\n if (!read) {\n return undefined;\n }\n\n parts.year =\n read.number + (read.number > TemporalTokens.TWO_DIGIT_YEAR_PIVOT ? 1900 : 2000);\n position = read.next;\n continue;\n }\n\n const [min, max, field] = TemporalTokens.NUMERIC_TOKENS[token];\n const read = TemporalTokens.readDigits({ value, position, min, max });\n\n if (!read) {\n return undefined;\n }\n\n parts[field] = read.number;\n position = read.next;\n }\n\n return position === value.length ? { parts, offsetMilliseconds } : undefined;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/pattern/tokens.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA4C,MAAM,oBAAoB,CAAC;AAG7F,oGAAoG;AACpG,MAAM,OAAO,cAAc;aACT,cAAS,GACvB,sGAAsG,CAAC;aAEzF,sBAAiB,GAA+B,aAAa,CAAC,cAAc,CAAC;IAE7F,MAAM,CAAC,gBAAgB,CAAC,KAAoB;QAC1C,OAAO,cAAc,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;aAEe,0BAAqB,GAAG,EAAE,CAAC;IAE3C,4FAA4F;aAC5E,yBAAoB,GAAG,EAAE,CAAC;IAE1C,wFAAwF;aACxE,mBAAc,GAAkE;QAC9F,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;QACnB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;QAClB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;QACjB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAClB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;QACpB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;QACnB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;QACpB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC;KAC3B,CAAC;IAEF,MAAM,CAAC,GAAG,CAAC,IAAsC;QAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,+FAA+F;IAC/F,MAAM,CAAC,YAAY,CAAC,IAAkD;QACpE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAC1C,MAAM,IAAI,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;QAElC,MAAM,IAAI,GACR,IAAI;YACJ,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACxE,SAAS;YACT,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,OAAO,KAAK,CAAC;YAClB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,GAAG,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,kDAAkD;IAC1C,MAAM,CAAC,UAAU,CAAC,IAAsB;QAC9C,OAAO,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,sFAAsF;aACtE,YAAO,GAAG,IAAI,GAAG,CAAsD;QACrF,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAChF;YACE,MAAM;YACN,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;gBAChC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;SAC5D;QACD;YACE,KAAK;YACL,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,KAAK,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;gBACrC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;SAC7D;QACD,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC;YACE,MAAM;YACN,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;gBACtC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;SACtE;QACD;YACE,KAAK;YACL,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,KAAK,EAAE,aAAa,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;gBAC3C,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;SACvE;QACD;YACE,IAAI;YACJ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,KAAK,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;gBACzC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SACxE;QACD,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC;YACE,IAAI;YACJ,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACZ,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;SAC3F;QACD,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E;YACE,GAAG;YACH,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SACtE;QACD;YACE,GAAG;YACH,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SACzF;QACD,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAClF;YACE,GAAG;YACH,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACZ,cAAc,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;SACtF;QACD;YACE,IAAI;YACJ,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACZ,cAAc,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;SACrF;QACD,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7E,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/E,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KACpE,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,IAAsB;QACpC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,OAAO,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,IAAsB;QACnC,OAAO,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,oGAAoG;IACpG,MAAM,CAAC,UAAU,CAAC,IAKjB;QACC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3C,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OACE,IAAI,GAAG,KAAK,CAAC,MAAM;YACnB,IAAI,GAAG,QAAQ,GAAG,GAAG;YACrB,cAAc,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EACxD,CAAC;YACD,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;QACD,OAAO,IAAI,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED,sFAAsF;IAC9E,MAAM,CAAC,eAAe,CAAC,IAI9B;QACC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAC5C,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,cAAc,CAAC,UAAU,CAAC;YAC/B,KAAK;YACL,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ;YAC7C,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;SACP,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,IAIjB;QACC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjD,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAE7F,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC;YACjF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAC1F,OAAO,EAAE,YAAY,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1F,CAAC;aAEe,gBAAW,GAAwB,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE1F,MAAM,CAAC,OAAO,CAAC,GAAW;QACxB,OAAO,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC","sourcesContent":["import type { ITemporalParts } from '../common/types';\nimport { PatternTokens, type TPatternToken, type TWriteOnlyToken } from './common/constants';\nimport type { ITokenWriterInput, TNumericToken } from './common/types';\n\n/** The pattern dialect's tokens: what each one writes, and how a parse reads digits and offsets. */\nexport class TemporalTokens {\n static readonly SUPPORTED =\n 'YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ, and for writing only MMMM MMM dddd ddd dd A a hh h LL L Q';\n\n static readonly WRITE_ONLY_TOKENS: ReadonlySet<TPatternToken> = PatternTokens.WRITE_ONLY_SET;\n\n static isWriteOnlyToken(token: TPatternToken): token is TWriteOnlyToken {\n return TemporalTokens.WRITE_ONLY_TOKENS.has(token);\n }\n\n static readonly MAX_COMPILED_PATTERNS = 64;\n\n /** Two-digit years pivot as dayjs and moment do: 00-68 is 2000-2068, 69-99 is 1969-1999. */\n static readonly TWO_DIGIT_YEAR_PIVOT = 68;\n\n /** `[min digits, max digits, field]` for every numeric token a parse reads directly. */\n static readonly NUMERIC_TOKENS: Record<TNumericToken, [number, number, keyof ITemporalParts]> = {\n YYYY: [4, 4, 'year'],\n MM: [2, 2, 'month'],\n M: [1, 2, 'month'],\n DD: [2, 2, 'day'],\n D: [1, 2, 'day'],\n HH: [2, 2, 'hour'],\n H: [1, 2, 'hour'],\n mm: [2, 2, 'minute'],\n m: [1, 2, 'minute'],\n ss: [2, 2, 'second'],\n s: [1, 2, 'second'],\n SSS: [3, 3, 'millisecond'],\n };\n\n static pad(opts: { value: number; width: number }): string {\n return String(opts.value).padStart(opts.width, '0');\n }\n\n /** `+07:00`, or `+07:06:40` for an offset with seconds - historic local mean time has them. */\n static formatOffset(opts: { offsetMinutes: number; separator: string }): string {\n const { offsetMinutes, separator } = opts;\n const sign = offsetMinutes < 0 ? '-' : '+';\n const totalSeconds = Math.round(Math.abs(offsetMinutes) * 60);\n const seconds = totalSeconds % 60;\n\n const text =\n sign +\n TemporalTokens.pad({ value: Math.floor(totalSeconds / 3600), width: 2 }) +\n separator +\n TemporalTokens.pad({ value: Math.floor((totalSeconds % 3600) / 60), width: 2 });\n return seconds === 0\n ? text\n : text + separator + TemporalTokens.pad({ value: seconds, width: 2 });\n }\n\n /** The hour on a 12-hour clock: 12, 1, ... 11. */\n private static twelveHour(opts: { hour: number }): number {\n return opts.hour % 12 || 12;\n }\n\n /** One writer per token - a lookup rather than a branch per token on every format. */\n static readonly WRITERS = new Map<TPatternToken, (input: ITokenWriterInput) => string>([\n ['YYYY', ({ parts }) => TemporalTokens.pad({ value: parts.year, width: 4 })],\n ['YY', ({ parts }) => TemporalTokens.pad({ value: parts.year % 100, width: 2 })],\n [\n 'MMMM',\n ({ parts, locale, names }) =>\n names?.months?.[parts.month - 1] ??\n locale().monthName({ month: parts.month, width: 'long' }),\n ],\n [\n 'MMM',\n ({ parts, locale, names }) =>\n names?.monthsShort?.[parts.month - 1] ??\n locale().monthName({ month: parts.month, width: 'short' }),\n ],\n ['MM', ({ parts }) => TemporalTokens.pad({ value: parts.month, width: 2 })],\n ['M', ({ parts }) => String(parts.month)],\n ['DD', ({ parts }) => TemporalTokens.pad({ value: parts.day, width: 2 })],\n ['D', ({ parts }) => String(parts.day)],\n [\n 'dddd',\n ({ parts, locale, names }) =>\n names?.weekdays?.[parts.dayOfWeek - 1] ??\n locale().weekdayName({ dayOfWeek: parts.dayOfWeek, width: 'long' }),\n ],\n [\n 'ddd',\n ({ parts, locale, names }) =>\n names?.weekdaysShort?.[parts.dayOfWeek - 1] ??\n locale().weekdayName({ dayOfWeek: parts.dayOfWeek, width: 'short' }),\n ],\n [\n 'dd',\n ({ parts, locale, names }) =>\n names?.weekdaysMin?.[parts.dayOfWeek - 1] ??\n locale().weekdayName({ dayOfWeek: parts.dayOfWeek, width: 'narrow' }),\n ],\n ['HH', ({ parts }) => TemporalTokens.pad({ value: parts.hour, width: 2 })],\n ['H', ({ parts }) => String(parts.hour)],\n [\n 'hh',\n ({ parts }) =>\n TemporalTokens.pad({ value: TemporalTokens.twelveHour({ hour: parts.hour }), width: 2 }),\n ],\n ['h', ({ parts }) => String(TemporalTokens.twelveHour({ hour: parts.hour }))],\n [\n 'A',\n ({ parts, locale, names }) =>\n locale().dayPeriod({ hour: parts.hour, meridiem: names?.meridiem }),\n ],\n [\n 'a',\n ({ parts, locale, names }) =>\n locale().dayPeriod({ hour: parts.hour, meridiem: names?.meridiem, isLowerCase: true }),\n ],\n ['mm', ({ parts }) => TemporalTokens.pad({ value: parts.minute, width: 2 })],\n ['m', ({ parts }) => String(parts.minute)],\n ['ss', ({ parts }) => TemporalTokens.pad({ value: parts.second, width: 2 })],\n ['s', ({ parts }) => String(parts.second)],\n ['SSS', ({ parts }) => TemporalTokens.pad({ value: parts.millisecond, width: 3 })],\n [\n 'Z',\n ({ parts }) =>\n TemporalTokens.formatOffset({ offsetMinutes: parts.offsetMinutes, separator: ':' }),\n ],\n [\n 'ZZ',\n ({ parts }) =>\n TemporalTokens.formatOffset({ offsetMinutes: parts.offsetMinutes, separator: '' }),\n ],\n ['LL', ({ parts, locale }) => locale().writtenDate({ parts, style: 'long' })],\n ['L', ({ parts, locale }) => locale().writtenDate({ parts, style: 'numeric' })],\n ['Q', ({ parts }) => String(Math.floor((parts.month - 1) / 3) + 1)],\n ]);\n\n static isLetter(opts: { code: number }): boolean {\n const { code } = opts;\n return (code >= 65 && code <= 90) || (code >= 97 && code <= 122);\n }\n\n static isDigit(opts: { code: number }): boolean {\n return opts.code >= 48 && opts.code <= 57;\n }\n\n /** Reads `min`..`max` digits at `position`, greedily; undefined when fewer than `min` are there. */\n static readDigits(opts: {\n value: string;\n position: number;\n min: number;\n max: number;\n }): { number: number; next: number } | undefined {\n const { value, position, min, max } = opts;\n let next = position;\n let number = 0;\n while (\n next < value.length &&\n next - position < max &&\n TemporalTokens.isDigit({ code: value.charCodeAt(next) })\n ) {\n number = number * 10 + (value.charCodeAt(next) - 48);\n next += 1;\n }\n return next - position < min ? undefined : { number, next };\n }\n\n /** Reads two digits after an optional separator; undefined when either is missing. */\n private static readOffsetField(opts: {\n value: string;\n position: number;\n separator: boolean;\n }): { number: number; next: number } | undefined {\n const { value, position, separator } = opts;\n if (separator && value[position] !== ':') {\n return undefined;\n }\n return TemporalTokens.readDigits({\n value,\n position: separator ? position + 1 : position,\n min: 2,\n max: 2,\n });\n }\n\n /**\n * `Z`, `+07:00` (`Z` token) or `+0700` (`ZZ` token), seconds optional, as milliseconds east\n * of UTC. Hours past 23 and minutes or seconds past 59 are refused rather than rolled over.\n */\n static readOffset(opts: {\n value: string;\n position: number;\n separator: boolean;\n }): { milliseconds: number; next: number } | undefined {\n const { value, position, separator } = opts;\n const sign = value[position];\n if (sign === 'Z') {\n return { milliseconds: 0, next: position + 1 };\n }\n if (sign !== '+' && sign !== '-') {\n return undefined;\n }\n\n const hours = TemporalTokens.readDigits({ value, position: position + 1, min: 2, max: 2 });\n if (!hours) {\n return undefined;\n }\n const minutes = TemporalTokens.readOffsetField({ value, position: hours.next, separator });\n if (!minutes) {\n return undefined;\n }\n const seconds = TemporalTokens.readOffsetField({ value, position: minutes.next, separator });\n\n if (hours.number > 23 || minutes.number > 59 || (seconds && seconds.number > 59)) {\n return undefined;\n }\n\n const total = ((hours.number * 60 + minutes.number) * 60 + (seconds?.number ?? 0)) * 1000;\n return { milliseconds: sign === '-' ? -total : total, next: (seconds ?? minutes).next };\n }\n\n static readonly TOKEN_NAMES: ReadonlySet<string> = new Set(TemporalTokens.WRITERS.keys());\n\n static isToken(run: string): run is TPatternToken {\n return TemporalTokens.TOKEN_NAMES.has(run);\n }\n}\n"]}
1
+ {"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/pattern/tokens.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ITemporalParts } from '../common/types';\nimport { PatternTokens, type TPatternToken, type TWriteOnlyToken } from './common/constants';\nimport type { ITokenWriterInput, TNumericToken } from './common/types';\n\n/** The pattern dialect's tokens: what each one writes, and how a parse reads digits and offsets. */\nexport class TemporalTokens {\n static readonly SUPPORTED =\n 'YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ, and for writing only MMMM MMM dddd ddd dd A a hh h LL L Q';\n\n static readonly WRITE_ONLY_TOKENS: ReadonlySet<TPatternToken> = PatternTokens.WRITE_ONLY_SET;\n\n static isWriteOnlyToken(token: TPatternToken): token is TWriteOnlyToken {\n return TemporalTokens.WRITE_ONLY_TOKENS.has(token);\n }\n\n static readonly MAX_COMPILED_PATTERNS = 64;\n\n /** Two-digit years pivot as dayjs and moment do: 00-68 is 2000-2068, 69-99 is 1969-1999. */\n static readonly TWO_DIGIT_YEAR_PIVOT = 68;\n\n /** `[min digits, max digits, field]` for every numeric token a parse reads directly. */\n static readonly NUMERIC_TOKENS: Record<TNumericToken, [number, number, keyof ITemporalParts]> = {\n YYYY: [4, 4, 'year'],\n MM: [2, 2, 'month'],\n M: [1, 2, 'month'],\n DD: [2, 2, 'day'],\n D: [1, 2, 'day'],\n HH: [2, 2, 'hour'],\n H: [1, 2, 'hour'],\n mm: [2, 2, 'minute'],\n m: [1, 2, 'minute'],\n ss: [2, 2, 'second'],\n s: [1, 2, 'second'],\n SSS: [3, 3, 'millisecond'],\n };\n\n static pad(opts: { value: number; width: number }): string {\n return String(opts.value).padStart(opts.width, '0');\n }\n\n /** `+07:00`, or `+07:06:40` for an offset with seconds - historic local mean time has them. */\n static formatOffset(opts: { offsetMinutes: number; separator: string }): string {\n const { offsetMinutes, separator } = opts;\n const sign = offsetMinutes < 0 ? '-' : '+';\n const totalSeconds = Math.round(Math.abs(offsetMinutes) * 60);\n const seconds = totalSeconds % 60;\n\n const text =\n sign +\n TemporalTokens.pad({ value: Math.floor(totalSeconds / 3600), width: 2 }) +\n separator +\n TemporalTokens.pad({ value: Math.floor((totalSeconds % 3600) / 60), width: 2 });\n\n return seconds === 0\n ? text\n : text + separator + TemporalTokens.pad({ value: seconds, width: 2 });\n }\n\n /** The hour on a 12-hour clock: 12, 1, ... 11. */\n private static twelveHour(opts: { hour: number }): number {\n return opts.hour % 12 || 12;\n }\n\n /** One writer per token - a lookup rather than a branch per token on every format. */\n static readonly WRITERS = new Map<TPatternToken, (input: ITokenWriterInput) => string>([\n ['YYYY', ({ parts }) => TemporalTokens.pad({ value: parts.year, width: 4 })],\n ['YY', ({ parts }) => TemporalTokens.pad({ value: parts.year % 100, width: 2 })],\n [\n 'MMMM',\n ({ parts, locale, names }) =>\n names?.months?.[parts.month - 1] ??\n locale().monthName({ month: parts.month, width: 'long' }),\n ],\n [\n 'MMM',\n ({ parts, locale, names }) =>\n names?.monthsShort?.[parts.month - 1] ??\n locale().monthName({ month: parts.month, width: 'short' }),\n ],\n ['MM', ({ parts }) => TemporalTokens.pad({ value: parts.month, width: 2 })],\n ['M', ({ parts }) => String(parts.month)],\n ['DD', ({ parts }) => TemporalTokens.pad({ value: parts.day, width: 2 })],\n ['D', ({ parts }) => String(parts.day)],\n [\n 'dddd',\n ({ parts, locale, names }) =>\n names?.weekdays?.[parts.dayOfWeek - 1] ??\n locale().weekdayName({ dayOfWeek: parts.dayOfWeek, width: 'long' }),\n ],\n [\n 'ddd',\n ({ parts, locale, names }) =>\n names?.weekdaysShort?.[parts.dayOfWeek - 1] ??\n locale().weekdayName({ dayOfWeek: parts.dayOfWeek, width: 'short' }),\n ],\n [\n 'dd',\n ({ parts, locale, names }) =>\n names?.weekdaysMin?.[parts.dayOfWeek - 1] ??\n locale().weekdayName({ dayOfWeek: parts.dayOfWeek, width: 'narrow' }),\n ],\n ['HH', ({ parts }) => TemporalTokens.pad({ value: parts.hour, width: 2 })],\n ['H', ({ parts }) => String(parts.hour)],\n [\n 'hh',\n ({ parts }) =>\n TemporalTokens.pad({ value: TemporalTokens.twelveHour({ hour: parts.hour }), width: 2 }),\n ],\n ['h', ({ parts }) => String(TemporalTokens.twelveHour({ hour: parts.hour }))],\n [\n 'A',\n ({ parts, locale, names }) =>\n locale().dayPeriod({ hour: parts.hour, meridiem: names?.meridiem }),\n ],\n [\n 'a',\n ({ parts, locale, names }) =>\n locale().dayPeriod({ hour: parts.hour, meridiem: names?.meridiem, isLowerCase: true }),\n ],\n ['mm', ({ parts }) => TemporalTokens.pad({ value: parts.minute, width: 2 })],\n ['m', ({ parts }) => String(parts.minute)],\n ['ss', ({ parts }) => TemporalTokens.pad({ value: parts.second, width: 2 })],\n ['s', ({ parts }) => String(parts.second)],\n ['SSS', ({ parts }) => TemporalTokens.pad({ value: parts.millisecond, width: 3 })],\n [\n 'Z',\n ({ parts }) =>\n TemporalTokens.formatOffset({ offsetMinutes: parts.offsetMinutes, separator: ':' }),\n ],\n [\n 'ZZ',\n ({ parts }) =>\n TemporalTokens.formatOffset({ offsetMinutes: parts.offsetMinutes, separator: '' }),\n ],\n ['LL', ({ parts, locale }) => locale().writtenDate({ parts, style: 'long' })],\n ['L', ({ parts, locale }) => locale().writtenDate({ parts, style: 'numeric' })],\n ['Q', ({ parts }) => String(Math.floor((parts.month - 1) / 3) + 1)],\n ]);\n\n static isLetter(opts: { code: number }): boolean {\n const { code } = opts;\n\n return (code >= 65 && code <= 90) || (code >= 97 && code <= 122);\n }\n\n static isDigit(opts: { code: number }): boolean {\n return opts.code >= 48 && opts.code <= 57;\n }\n\n /** Reads `min`..`max` digits at `position`, greedily; undefined when fewer than `min` are there. */\n static readDigits(opts: {\n value: string;\n position: number;\n min: number;\n max: number;\n }): { number: number; next: number } | undefined {\n const { value, position, min, max } = opts;\n let next = position;\n let number = 0;\n\n while (\n next < value.length &&\n next - position < max &&\n TemporalTokens.isDigit({ code: value.charCodeAt(next) })\n ) {\n number = number * 10 + (value.charCodeAt(next) - 48);\n next += 1;\n }\n\n return next - position < min ? undefined : { number, next };\n }\n\n /** Reads two digits after an optional separator; undefined when either is missing. */\n private static readOffsetField(opts: {\n value: string;\n position: number;\n separator: boolean;\n }): { number: number; next: number } | undefined {\n const { value, position, separator } = opts;\n\n if (separator && value[position] !== ':') {\n return undefined;\n }\n\n return TemporalTokens.readDigits({\n value,\n position: separator ? position + 1 : position,\n min: 2,\n max: 2,\n });\n }\n\n /**\n * `Z`, `+07:00` (`Z` token) or `+0700` (`ZZ` token), seconds optional, as milliseconds east\n * of UTC. Hours past 23 and minutes or seconds past 59 are refused rather than rolled over.\n */\n static readOffset(opts: {\n value: string;\n position: number;\n separator: boolean;\n }): { milliseconds: number; next: number } | undefined {\n const { value, position, separator } = opts;\n const sign = value[position];\n\n if (sign === 'Z') {\n return { milliseconds: 0, next: position + 1 };\n }\n\n if (sign !== '+' && sign !== '-') {\n return undefined;\n }\n\n const hours = TemporalTokens.readDigits({ value, position: position + 1, min: 2, max: 2 });\n\n if (!hours) {\n return undefined;\n }\n\n const minutes = TemporalTokens.readOffsetField({ value, position: hours.next, separator });\n\n if (!minutes) {\n return undefined;\n }\n\n const seconds = TemporalTokens.readOffsetField({ value, position: minutes.next, separator });\n\n if (hours.number > 23 || minutes.number > 59 || (seconds && seconds.number > 59)) {\n return undefined;\n }\n\n const total = ((hours.number * 60 + minutes.number) * 60 + (seconds?.number ?? 0)) * 1000;\n\n return { milliseconds: sign === '-' ? -total : total, next: (seconds ?? minutes).next };\n }\n\n static readonly TOKEN_NAMES: ReadonlySet<string> = new Set(TemporalTokens.WRITERS.keys());\n\n static isToken(run: string): run is TPatternToken {\n return TemporalTokens.TOKEN_NAMES.has(run);\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/modules/tree/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n IBuildOptions,\n ILeavesOptions,\n INodeWithPath,\n IPrintOptions,\n ITreeNode,\n} from './common/types';\nimport { BaseHelper } from '@/modules/base';\n\n/**\n * Static members call each other through the class name (`TreeBuilder.xxx`), never `this` - a\n * detached static method loses its `this` binding.\n */\nexport class TreeBuilder extends BaseHelper {\n /**\n * Always async, even if `getChildren` returns a plain array, since real fetchers hit a\n * repository. De-duplicates by `getKey` rather than tracking depth - see\n * {@link IBuildOptions.getKey} for why a repeated key skips silently instead of throwing.\n */\n static async build<T>(opts: IBuildOptions<T>): Promise<ITreeNode<T>> {\n const { rootValue, getChildren, getKey } = opts;\n const seen = new Set<unknown>([getKey(rootValue)]);\n\n const buildNode = async (value: T): Promise<ITreeNode<T>> => {\n const childValues = await getChildren(value);\n const children: ITreeNode<T>[] = [];\n\n for (const childValue of childValues) {\n const key = getKey(childValue);\n if (seen.has(key)) {\n continue;\n }\n\n seen.add(key);\n const result = await buildNode(childValue);\n children.push(result);\n }\n\n return { value, children };\n };\n\n return buildNode(rootValue);\n }\n\n static leaves<T>(opts: { root: ITreeNode<T>; includePath: true }): INodeWithPath<T>[];\n static leaves<T>(opts: { root: ITreeNode<T>; includePath?: false }): ITreeNode<T>[];\n /** `includePath: true` returns the chain from the root alongside each leaf - recomputing it from the tree afterward would cost a second full traversal. */\n static leaves<T>(opts: ILeavesOptions<T>): ITreeNode<T>[] | INodeWithPath<T>[] {\n return TreeBuilder.collect({ ...opts, matches: (node) => node.children.length === 0 });\n }\n\n static nonLeaves<T>(opts: { root: ITreeNode<T>; includePath: true }): INodeWithPath<T>[];\n static nonLeaves<T>(opts: { root: ITreeNode<T>; includePath?: false }): ITreeNode<T>[];\n static nonLeaves<T>(opts: ILeavesOptions<T>): ITreeNode<T>[] | INodeWithPath<T>[] {\n return TreeBuilder.collect({ ...opts, matches: (node) => node.children.length > 0 });\n }\n\n private static collect<T>(opts: {\n root: ITreeNode<T>;\n includePath?: boolean;\n matches: (node: ITreeNode<T>) => boolean;\n }): ITreeNode<T>[] | INodeWithPath<T>[] {\n const { root, includePath, matches } = opts;\n\n if (!includePath) {\n const results: ITreeNode<T>[] = [];\n\n const walk = (node: ITreeNode<T>): void => {\n if (matches(node)) {\n results.push(node);\n }\n\n for (const child of node.children) {\n walk(child);\n }\n };\n\n walk(root);\n return results;\n }\n\n const results: INodeWithPath<T>[] = [];\n\n const walk = (node: ITreeNode<T>, path: T[]): void => {\n const nextPath = [...path, node.value];\n if (matches(node)) {\n results.push({ node, path: nextPath });\n }\n\n for (const child of node.children) {\n walk(child, nextPath);\n }\n };\n\n walk(root, []);\n return results;\n }\n\n /** Renders an ASCII tree, root on the first line, `├──`/`└──` branches below - useful for debug logs, not for parsing. */\n static print<T>(opts: IPrintOptions<T>): string {\n const { root, formatValue = (value: T) => String(value) } = opts;\n const lines: string[] = [formatValue(root.value)];\n\n const walk = (node: ITreeNode<T>, prefix: string): void => {\n node.children.forEach((child, index) => {\n const isLast = index === node.children.length - 1;\n lines.push(`${prefix}${isLast ? '└── ' : '├── '}${formatValue(child.value)}`);\n walk(child, `${prefix}${isLast ? ' ' : '│ '}`);\n });\n };\n\n walk(root, '');\n return lines.join('\\n');\n }\n}\n"]}
1
+ {"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/modules/tree/builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n IBuildOptions,\n ILeavesOptions,\n INodeWithPath,\n IPrintOptions,\n ITreeNode,\n} from './common/types';\nimport { BaseHelper } from '@/modules/base';\n\n/**\n * Static members call each other through the class name (`TreeBuilder.xxx`), never `this` - a\n * detached static method loses its `this` binding.\n */\nexport class TreeBuilder extends BaseHelper {\n /**\n * Always async, even if `getChildren` returns a plain array, since real fetchers hit a\n * repository. De-duplicates by `getKey` rather than tracking depth - see\n * {@link IBuildOptions.getKey} for why a repeated key skips silently instead of throwing.\n */\n static async build<T>(opts: IBuildOptions<T>): Promise<ITreeNode<T>> {\n const { rootValue, getChildren, getKey } = opts;\n const seen = new Set<unknown>([getKey(rootValue)]);\n\n const buildNode = async (value: T): Promise<ITreeNode<T>> => {\n const childValues = await getChildren(value);\n const children: ITreeNode<T>[] = [];\n\n for (const childValue of childValues) {\n const key = getKey(childValue);\n\n if (seen.has(key)) {\n continue;\n }\n\n seen.add(key);\n const result = await buildNode(childValue);\n children.push(result);\n }\n\n return { value, children };\n };\n\n return buildNode(rootValue);\n }\n\n static leaves<T>(opts: { root: ITreeNode<T>; includePath: true }): INodeWithPath<T>[];\n static leaves<T>(opts: { root: ITreeNode<T>; includePath?: false }): ITreeNode<T>[];\n /** `includePath: true` returns the chain from the root alongside each leaf - recomputing it from the tree afterward would cost a second full traversal. */\n static leaves<T>(opts: ILeavesOptions<T>): ITreeNode<T>[] | INodeWithPath<T>[] {\n return TreeBuilder.collect({ ...opts, matches: (node) => node.children.length === 0 });\n }\n\n static nonLeaves<T>(opts: { root: ITreeNode<T>; includePath: true }): INodeWithPath<T>[];\n static nonLeaves<T>(opts: { root: ITreeNode<T>; includePath?: false }): ITreeNode<T>[];\n static nonLeaves<T>(opts: ILeavesOptions<T>): ITreeNode<T>[] | INodeWithPath<T>[] {\n return TreeBuilder.collect({ ...opts, matches: (node) => node.children.length > 0 });\n }\n\n private static collect<T>(opts: {\n root: ITreeNode<T>;\n includePath?: boolean;\n matches: (node: ITreeNode<T>) => boolean;\n }): ITreeNode<T>[] | INodeWithPath<T>[] {\n const { root, includePath, matches } = opts;\n\n if (!includePath) {\n const results: ITreeNode<T>[] = [];\n\n const walk = (node: ITreeNode<T>): void => {\n if (matches(node)) {\n results.push(node);\n }\n\n for (const child of node.children) {\n walk(child);\n }\n };\n\n walk(root);\n\n return results;\n }\n\n const results: INodeWithPath<T>[] = [];\n\n const walk = (node: ITreeNode<T>, path: T[]): void => {\n const nextPath = [...path, node.value];\n\n if (matches(node)) {\n results.push({ node, path: nextPath });\n }\n\n for (const child of node.children) {\n walk(child, nextPath);\n }\n };\n\n walk(root, []);\n\n return results;\n }\n\n /** Renders an ASCII tree, root on the first line, `├──`/`└──` branches below - useful for debug logs, not for parsing. */\n static print<T>(opts: IPrintOptions<T>): string {\n const { root, formatValue = (value: T) => String(value) } = opts;\n const lines: string[] = [formatValue(root.value)];\n\n const walk = (node: ITreeNode<T>, prefix: string): void => {\n node.children.forEach((child, index) => {\n const isLast = index === node.children.length - 1;\n lines.push(`${prefix}${isLast ? '└── ' : '├── '}${formatValue(child.value)}`);\n walk(child, `${prefix}${isLast ? ' ' : '│ '}`);\n });\n };\n\n walk(root, '');\n\n return lines.join('\\n');\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/uid/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants';\nimport { BaseHelper } from '../base';\nimport { getError } from '../error';\n\nconst BASE62_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';\n\n/** Snowflake bit layout: 48-bit timestamp (~8,919 years), 10-bit worker ID (max 1024 workers), 12-bit sequence (4096/ms/worker). */\nexport class SnowflakeConfig {\n static readonly DEFAULT_EPOCH = BigInt(1735689600000); // 2025-01-01 00:00:00 UTC\n static readonly TIMESTAMP_BITS = BigInt(48);\n static readonly WORKER_ID_BITS = BigInt(10);\n static readonly SEQUENCE_BITS = BigInt(12);\n static readonly MAX_WORKER_ID = (BigInt(1) << BigInt(10)) - BigInt(1); // 1023\n static readonly MAX_SEQUENCE = (BigInt(1) << BigInt(12)) - BigInt(1); // 4095\n static readonly WORKER_ID_SHIFT = BigInt(12);\n static readonly TIMESTAMP_SHIFT = BigInt(22); // 10 + 12\n static readonly MAX_CLOCK_BACKWARD_MS = BigInt(100);\n\n // 48 bits max = ~8,919 years, warn 10 years before expiry (~8,909 years)\n static readonly MAX_TIMESTAMP_MS = (BigInt(1) << BigInt(48)) - BigInt(1);\n static readonly WARNING_THRESHOLD_MS = BigInt(Math.floor(8909 * 365.25 * 24 * 60 * 60 * 1000)); // ~8,909 years\n}\n\nexport interface IIdGeneratorOptions {\n workerId?: number;\n epoch?: bigint;\n}\n\nexport interface ISnowflakeParsedId {\n raw: bigint;\n timestamp: Date;\n workerId: number;\n sequence: number;\n}\n\n/** Snowflake ID generator with Base62 encoding for distributed, time-sortable unique IDs. */\nexport class SnowflakeUidHelper extends BaseHelper {\n private readonly workerId: bigint;\n private readonly epoch: bigint;\n private sequence: bigint = BigInt(0);\n private lastTimestamp: bigint = BigInt(-1);\n\n constructor(opts?: IIdGeneratorOptions) {\n super({ scope: SnowflakeUidHelper.name });\n\n const workerId = opts?.workerId ?? 199;\n const epoch = opts?.epoch ?? SnowflakeConfig.DEFAULT_EPOCH;\n\n this.validateWorkerId(workerId);\n this.workerId = BigInt(workerId);\n\n this.validateEpoch(epoch);\n this.epoch = epoch;\n\n this.logger\n .for(this.constructor.name)\n .info(\n 'Initialized | workerId: %d | epoch: %s | epochDate: %s',\n workerId,\n epoch.toString(),\n new Date(Number(epoch)).toISOString(),\n );\n }\n\n /** Generate next unique ID as Base62 string. */\n nextId(): string {\n const snowflake = this.nextSnowflake();\n return this.encodeBase62(snowflake);\n }\n\n /** Generate next unique ID as raw Snowflake bigint. */\n nextSnowflake(): bigint {\n let timestamp = this.currentTimestamp();\n\n if (timestamp < this.lastTimestamp) {\n const diff = this.lastTimestamp - timestamp;\n this.logger\n .for(this.nextSnowflake.name)\n .warn('Clock moved backward | diff: %d ms', Number(diff));\n\n if (diff <= SnowflakeConfig.MAX_CLOCK_BACKWARD_MS) {\n timestamp = this.waitForNextMs(this.lastTimestamp);\n } else {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][nextSnowflake] Clock moved backward by ${diff}ms. Refusing to generate ID.`,\n });\n }\n }\n\n if (timestamp === this.lastTimestamp) {\n this.sequence = (this.sequence + BigInt(1)) & SnowflakeConfig.MAX_SEQUENCE;\n\n if (this.sequence === BigInt(0)) {\n timestamp = this.waitForNextMs(timestamp);\n }\n } else {\n this.sequence = BigInt(0);\n }\n\n this.lastTimestamp = timestamp;\n\n this.checkExpiryWarning(timestamp);\n\n const id =\n ((timestamp - this.epoch) << SnowflakeConfig.TIMESTAMP_SHIFT) |\n (this.workerId << SnowflakeConfig.WORKER_ID_SHIFT) |\n this.sequence;\n\n return id;\n }\n\n /** Encode a bigint to Base62 string. */\n encodeBase62(num: bigint): string {\n if (num === BigInt(0)) {\n return BASE62_CHARS[0];\n }\n\n let result = '';\n let value = num;\n const base = BigInt(BASE62_CHARS.length);\n\n while (value > BigInt(0)) {\n const remainder = value % base;\n result = BASE62_CHARS[Number(remainder)] + result;\n value = value / base;\n }\n\n return result;\n }\n\n /** Decode a Base62 string to bigint. */\n decodeBase62(str: string): bigint {\n if (!str) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: '[IdGenerator][decodeBase62] Base62 input must not be empty',\n });\n }\n\n let result = BigInt(0);\n const base = BigInt(BASE62_CHARS.length);\n\n for (const char of str) {\n const index = BASE62_CHARS.indexOf(char);\n if (index === -1) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[IdGenerator][decodeBase62] Invalid Base62 character: ${char}`,\n });\n }\n result = result * base + BigInt(index);\n }\n\n return result;\n }\n\n /** Extract timestamp from a Snowflake ID. */\n extractTimestamp(id: bigint): Date {\n const timestamp = (id >> SnowflakeConfig.TIMESTAMP_SHIFT) + this.epoch;\n return new Date(Number(timestamp));\n }\n\n /** Extract worker ID from a Snowflake ID. */\n extractWorkerId(id: bigint): number {\n const extractedWorkerId =\n (id >> SnowflakeConfig.WORKER_ID_SHIFT) & SnowflakeConfig.MAX_WORKER_ID;\n return Number(extractedWorkerId);\n }\n\n /** Extract sequence from a Snowflake ID. */\n extractSequence(id: bigint): number {\n return Number(id & SnowflakeConfig.MAX_SEQUENCE);\n }\n\n /** Parse a Base62 ID and extract its components. */\n parseId(base62Id: string): ISnowflakeParsedId {\n const raw = this.decodeBase62(base62Id);\n return {\n raw,\n timestamp: this.extractTimestamp(raw),\n workerId: this.extractWorkerId(raw),\n sequence: this.extractSequence(raw),\n };\n }\n\n /** Get current worker ID. */\n getWorkerId(): number {\n return Number(this.workerId);\n }\n\n private currentTimestamp(): bigint {\n return BigInt(Date.now());\n }\n\n private waitForNextMs(lastTimestamp: bigint): bigint {\n let timestamp = this.currentTimestamp();\n while (timestamp <= lastTimestamp) {\n timestamp = this.currentTimestamp();\n }\n return timestamp;\n }\n\n private validateWorkerId(workerId: number): void {\n if (\n !Number.isInteger(workerId) ||\n workerId < 0 ||\n workerId > Number(SnowflakeConfig.MAX_WORKER_ID)\n ) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][validateWorkerId] Worker ID must be an integer between 0 and ${SnowflakeConfig.MAX_WORKER_ID} | received: ${workerId}`,\n });\n }\n }\n\n private validateEpoch(epoch: bigint): void {\n const now = BigInt(Date.now());\n\n if (epoch <= BigInt(0)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][validateEpoch] Epoch must be a positive number | received: ${epoch}`,\n });\n }\n\n if (epoch > now) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][validateEpoch] Epoch cannot be in the future | received: ${epoch} (${new Date(Number(epoch)).toISOString()}) | now: ${now}`,\n });\n }\n }\n\n private checkExpiryWarning(timestamp: bigint): void {\n const elapsedMs = timestamp - this.epoch;\n\n if (elapsedMs < SnowflakeConfig.WARNING_THRESHOLD_MS) {\n return;\n }\n\n const remainingMs = SnowflakeConfig.MAX_TIMESTAMP_MS - elapsedMs;\n const remainingYears = Number(remainingMs) / (365.25 * 24 * 60 * 60 * 1000);\n const expiryDate = new Date(Number(this.epoch + SnowflakeConfig.MAX_TIMESTAMP_MS));\n\n this.logger\n .for(this.checkExpiryWarning.name)\n .warn(\n 'Snowflake ID sequence approaching expiry | remainingYears: %.2f | expiryDate: %s | action: Plan migration to new epoch',\n remainingYears,\n expiryDate.toISOString(),\n );\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/uid/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants';\nimport { BaseHelper } from '../base';\nimport { getError } from '../error';\n\nconst BASE62_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';\n\n/** Snowflake bit layout: 48-bit timestamp (~8,919 years), 10-bit worker ID (max 1024 workers), 12-bit sequence (4096/ms/worker). */\nexport class SnowflakeConfig {\n static readonly DEFAULT_EPOCH = BigInt(1735689600000); // 2025-01-01 00:00:00 UTC\n static readonly TIMESTAMP_BITS = BigInt(48);\n static readonly WORKER_ID_BITS = BigInt(10);\n static readonly SEQUENCE_BITS = BigInt(12);\n static readonly MAX_WORKER_ID = (BigInt(1) << BigInt(10)) - BigInt(1); // 1023\n static readonly MAX_SEQUENCE = (BigInt(1) << BigInt(12)) - BigInt(1); // 4095\n static readonly WORKER_ID_SHIFT = BigInt(12);\n static readonly TIMESTAMP_SHIFT = BigInt(22); // 10 + 12\n static readonly MAX_CLOCK_BACKWARD_MS = BigInt(100);\n\n // 48 bits max = ~8,919 years, warn 10 years before expiry (~8,909 years)\n static readonly MAX_TIMESTAMP_MS = (BigInt(1) << BigInt(48)) - BigInt(1);\n static readonly WARNING_THRESHOLD_MS = BigInt(Math.floor(8909 * 365.25 * 24 * 60 * 60 * 1000)); // ~8,909 years\n}\n\nexport interface IIdGeneratorOptions {\n workerId?: number;\n epoch?: bigint;\n}\n\nexport interface ISnowflakeParsedId {\n raw: bigint;\n timestamp: Date;\n workerId: number;\n sequence: number;\n}\n\n/** Snowflake ID generator with Base62 encoding for distributed, time-sortable unique IDs. */\nexport class SnowflakeUidHelper extends BaseHelper {\n private readonly workerId: bigint;\n private readonly epoch: bigint;\n private sequence: bigint = BigInt(0);\n private lastTimestamp: bigint = BigInt(-1);\n\n constructor(opts?: IIdGeneratorOptions) {\n super({ scope: SnowflakeUidHelper.name });\n\n const workerId = opts?.workerId ?? 199;\n const epoch = opts?.epoch ?? SnowflakeConfig.DEFAULT_EPOCH;\n\n this.validateWorkerId(workerId);\n this.workerId = BigInt(workerId);\n\n this.validateEpoch(epoch);\n this.epoch = epoch;\n\n this.logger\n .for(this.constructor.name)\n .info(\n 'Initialized | workerId: %d | epoch: %s | epochDate: %s',\n workerId,\n epoch.toString(),\n new Date(Number(epoch)).toISOString(),\n );\n }\n\n /** Generate next unique ID as Base62 string. */\n nextId(): string {\n const snowflake = this.nextSnowflake();\n\n return this.encodeBase62(snowflake);\n }\n\n /** Generate next unique ID as raw Snowflake bigint. */\n nextSnowflake(): bigint {\n let timestamp = this.currentTimestamp();\n\n if (timestamp < this.lastTimestamp) {\n const diff = this.lastTimestamp - timestamp;\n this.logger\n .for(this.nextSnowflake.name)\n .warn('Clock moved backward | diff: %d ms', Number(diff));\n\n if (diff <= SnowflakeConfig.MAX_CLOCK_BACKWARD_MS) {\n timestamp = this.waitForNextMs(this.lastTimestamp);\n } else {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][nextSnowflake] Clock moved backward by ${diff}ms. Refusing to generate ID.`,\n });\n }\n }\n\n if (timestamp === this.lastTimestamp) {\n this.sequence = (this.sequence + BigInt(1)) & SnowflakeConfig.MAX_SEQUENCE;\n\n if (this.sequence === BigInt(0)) {\n timestamp = this.waitForNextMs(timestamp);\n }\n } else {\n this.sequence = BigInt(0);\n }\n\n this.lastTimestamp = timestamp;\n\n this.checkExpiryWarning(timestamp);\n\n const id =\n ((timestamp - this.epoch) << SnowflakeConfig.TIMESTAMP_SHIFT) |\n (this.workerId << SnowflakeConfig.WORKER_ID_SHIFT) |\n this.sequence;\n\n return id;\n }\n\n /** Encode a bigint to Base62 string. */\n encodeBase62(num: bigint): string {\n if (num === BigInt(0)) {\n return BASE62_CHARS[0];\n }\n\n let result = '';\n let value = num;\n const base = BigInt(BASE62_CHARS.length);\n\n while (value > BigInt(0)) {\n const remainder = value % base;\n result = BASE62_CHARS[Number(remainder)] + result;\n value = value / base;\n }\n\n return result;\n }\n\n /** Decode a Base62 string to bigint. */\n decodeBase62(str: string): bigint {\n if (!str) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: '[IdGenerator][decodeBase62] Base62 input must not be empty',\n });\n }\n\n let result = BigInt(0);\n const base = BigInt(BASE62_CHARS.length);\n\n for (const char of str) {\n const index = BASE62_CHARS.indexOf(char);\n\n if (index === -1) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[IdGenerator][decodeBase62] Invalid Base62 character: ${char}`,\n });\n }\n\n result = result * base + BigInt(index);\n }\n\n return result;\n }\n\n /** Extract timestamp from a Snowflake ID. */\n extractTimestamp(id: bigint): Date {\n const timestamp = (id >> SnowflakeConfig.TIMESTAMP_SHIFT) + this.epoch;\n\n return new Date(Number(timestamp));\n }\n\n /** Extract worker ID from a Snowflake ID. */\n extractWorkerId(id: bigint): number {\n const extractedWorkerId =\n (id >> SnowflakeConfig.WORKER_ID_SHIFT) & SnowflakeConfig.MAX_WORKER_ID;\n\n return Number(extractedWorkerId);\n }\n\n /** Extract sequence from a Snowflake ID. */\n extractSequence(id: bigint): number {\n return Number(id & SnowflakeConfig.MAX_SEQUENCE);\n }\n\n /** Parse a Base62 ID and extract its components. */\n parseId(base62Id: string): ISnowflakeParsedId {\n const raw = this.decodeBase62(base62Id);\n\n return {\n raw,\n timestamp: this.extractTimestamp(raw),\n workerId: this.extractWorkerId(raw),\n sequence: this.extractSequence(raw),\n };\n }\n\n /** Get current worker ID. */\n getWorkerId(): number {\n return Number(this.workerId);\n }\n\n private currentTimestamp(): bigint {\n return BigInt(Date.now());\n }\n\n private waitForNextMs(lastTimestamp: bigint): bigint {\n let timestamp = this.currentTimestamp();\n\n while (timestamp <= lastTimestamp) {\n timestamp = this.currentTimestamp();\n }\n\n return timestamp;\n }\n\n private validateWorkerId(workerId: number): void {\n if (\n !Number.isInteger(workerId) ||\n workerId < 0 ||\n workerId > Number(SnowflakeConfig.MAX_WORKER_ID)\n ) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][validateWorkerId] Worker ID must be an integer between 0 and ${SnowflakeConfig.MAX_WORKER_ID} | received: ${workerId}`,\n });\n }\n }\n\n private validateEpoch(epoch: bigint): void {\n const now = BigInt(Date.now());\n\n if (epoch <= BigInt(0)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][validateEpoch] Epoch must be a positive number | received: ${epoch}`,\n });\n }\n\n if (epoch > now) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[IdGenerator][validateEpoch] Epoch cannot be in the future | received: ${epoch} (${new Date(Number(epoch)).toISOString()}) | now: ${now}`,\n });\n }\n }\n\n private checkExpiryWarning(timestamp: bigint): void {\n const elapsedMs = timestamp - this.epoch;\n\n if (elapsedMs < SnowflakeConfig.WARNING_THRESHOLD_MS) {\n return;\n }\n\n const remainingMs = SnowflakeConfig.MAX_TIMESTAMP_MS - elapsedMs;\n const remainingYears = Number(remainingMs) / (365.25 * 24 * 60 * 60 * 1000);\n const expiryDate = new Date(Number(this.epoch + SnowflakeConfig.MAX_TIMESTAMP_MS));\n\n this.logger\n .for(this.checkExpiryWarning.name)\n .warn(\n 'Snowflake ID sequence approaching expiry | remainingYears: %.2f | expiryDate: %s | action: Plan migration to new epoch',\n remainingYears,\n expiryDate.toISOString(),\n );\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"opaque.js","sourceRoot":"","sources":["../../../../src/modules/uid/opaque.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants';\nimport type { ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '../base';\nimport { getError } from '../error';\nimport {\n DEFAULT_UID_DELIMITER,\n DEFAULT_UID_LENGTH,\n DEFAULT_UID_MAX_ATTEMPTS,\n MIN_UID_ALPHABET_SIZE,\n UidAlphabets,\n UidCaseForms,\n} from './common/constants';\nimport type { TUidCaseForm } from './common/constants';\nimport type { INextOpaqueUidOptions, IOpaqueUidOptions, IUidSegment } from './common/types';\n\n/** How many random bytes to draw per refill, per remaining character. Rejection throws some away, so asking for exactly `length` would round-trip to the entropy source repeatedly. */\nconst SAMPLING_OVERDRAW = 2;\n\n/** Local, not `@/utilities/promise.utility`: that module imports the logger BARREL, which reaches `node:module` and would take this browser-pure module with it. */\nconst isPromiseLike = (value: unknown): value is PromiseLike<boolean> => {\n return typeof (value as PromiseLike<boolean> | null | undefined)?.then === 'function';\n};\n\n/**\n * Fixed-length opaque ids, optionally prefixed - the counterpart to `SnowflakeUidHelper`.\n *\n * OPAQUE is the difference that matters, not the randomness. A Snowflake id is TRANSPARENT: its own\n * `parseId()` reads back the exact millisecond it was minted and the worker that minted it. That is\n * what you want in a log and not what you want on an invoice. Nothing can be read out of an id from\n * here. The cost is the ordering, which a Snowflake gives an index for free.\n *\n * `length` counts the BODY only. A prefix and a delimiter sit in front of it, so the finished string\n * is `prefix + delimiter + length` characters.\n *\n * Read {@link DEFAULT_UID_LENGTH} before accepting the default: six characters is an airline record\n * locator, and it needs the same scoping and retry that airlines give one.\n */\nexport class OpaqueUidHelper extends BaseHelper {\n private readonly alphabet: string;\n private readonly length: number;\n private readonly prefix: string;\n private readonly delimiter: string;\n\n /** Rejection mask: the smallest `2^n - 1` that covers every alphabet index. A plain `byte % size` would favour the first `256 % size` characters, which is a bias a caller cannot see and cannot undo. */\n private readonly mask: number;\n\n constructor(opts?: IOpaqueUidOptions) {\n super({ scope: OpaqueUidHelper.name });\n\n const caseForm = opts?.caseForm ?? UidCaseForms.UPPER;\n OpaqueUidHelper.assertKnownCaseForm({ caseForm });\n\n this.alphabet = OpaqueUidHelper.resolveAlphabet({\n alphabet: opts?.alphabet ?? UidAlphabets.CROCKFORD,\n exclude: opts?.exclude ?? '',\n caseForm,\n });\n\n this.length = opts?.length ?? DEFAULT_UID_LENGTH;\n if (!Number.isInteger(this.length) || this.length < 1) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] length must be a positive integer | value: ${this.length}`,\n });\n }\n\n this.prefix = OpaqueUidHelper.resolvePrefix({ prefix: opts?.prefix, caseForm });\n this.delimiter = OpaqueUidHelper.resolveDelimiter({\n delimiter: opts?.delimiter,\n hasPrefix: this.prefix.length > 0,\n alphabet: this.alphabet,\n });\n\n this.mask = (1 << Math.ceil(Math.log2(this.alphabet.length))) - 1;\n }\n\n /**\n * `prefix` replaces the configured value for this call and turns the prefix on for it; the\n * delimiter follows its own switch.\n *\n * `isAvailable` redraws until it accepts an id, up to `maxAttempts`. It LOWERS the collision rate,\n * it does not remove it: against a database the check and the insert are two statements, and\n * another request can take the id in between. The column still needs a unique index, and the\n * insert still needs to regenerate on violation.\n */\n nextId(opts?: INextOpaqueUidOptions<boolean>): string;\n nextId(opts: INextOpaqueUidOptions<Promise<boolean>>): Promise<string>;\n nextId(opts: INextOpaqueUidOptions): ValueOrPromise<string>;\n nextId(opts?: INextOpaqueUidOptions): ValueOrPromise<string> {\n const head = this.resolveHead({ prefix: opts?.prefix });\n\n const isAvailable = opts?.isAvailable;\n if (!isAvailable) {\n // Refused rather than ignored: without a check there is exactly ONE draw, so a caller who set\n // `maxAttempts` has configured a retry that cannot happen and has no way to notice.\n if (opts?.maxAttempts !== undefined) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] maxAttempts has no effect without \\`isAvailable\\` | Nothing rejects a draw, so there is only ever one`,\n });\n }\n\n return `${head}${this.randomBody()}`;\n }\n\n const maxAttempts = OpaqueUidHelper.resolveMaxAttempts({ maxAttempts: opts?.maxAttempts });\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n const id = `${head}${this.randomBody()}`;\n const verdict = isAvailable(id);\n\n // The first PENDING verdict decides the shape of the whole call. Everything before it already\n // resolved, so a synchronous check never allocates a promise and `nextId()` stays a string.\n if (isPromiseLike(verdict)) {\n return this.continueAsync({ head, isAvailable, maxAttempts, attempt, id, verdict });\n }\n\n if (verdict) {\n return id;\n }\n }\n\n throw this.buildExhaustedError({ maxAttempts });\n }\n\n /** Entered only once a verdict came back pending; every later draw is awaited from here. */\n private async continueAsync(opts: {\n head: string;\n isAvailable: (id: string) => ValueOrPromise<boolean>;\n maxAttempts: number;\n attempt: number;\n id: string;\n verdict: PromiseLike<boolean>;\n }): Promise<string> {\n const { head, isAvailable, maxAttempts, attempt, id, verdict } = opts;\n\n const result = await verdict;\n if (result) {\n return id;\n }\n\n for (let next = attempt + 1; next <= maxAttempts; next++) {\n const candidate = `${head}${this.randomBody()}`;\n\n const result2 = await isAvailable(candidate);\n if (result2) {\n return candidate;\n }\n }\n\n throw this.buildExhaustedError({ maxAttempts });\n }\n\n private resolveHead(opts: { prefix?: string }): string {\n const override = opts.prefix;\n\n if (override === '') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] An empty prefix is not how a prefix is turned off | Construct with \\`prefix: { enable: false }\\``,\n });\n }\n\n const prefix = override ?? this.prefix;\n return prefix.length > 0 ? `${prefix}${this.delimiter}` : '';\n }\n\n private static resolveMaxAttempts(opts: { maxAttempts?: number }): number {\n const maxAttempts = opts.maxAttempts ?? DEFAULT_UID_MAX_ATTEMPTS;\n\n if (!Number.isInteger(maxAttempts) || maxAttempts < 1) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] maxAttempts must be a positive integer | value: ${maxAttempts}`,\n });\n }\n\n return maxAttempts;\n }\n\n /** Bounded rather than endless: repeated rejection means the space is full, and a caller waiting forever learns that far later than a caller holding this error. */\n private buildExhaustedError(opts: { maxAttempts: number }) {\n return getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] No available id after ${opts.maxAttempts} attempts | length: ${this.length} | alphabet: ${this.alphabet.length} | The space is crowded - raise \\`length\\``,\n });\n }\n\n /** The alphabet actually in use, after the case fold and every exclusion - what `length` is measured against. */\n getAlphabet(): string {\n return this.alphabet;\n }\n\n private randomBody(): string {\n const size = this.alphabet.length;\n let body = '';\n\n while (body.length < this.length) {\n const bytes = OpaqueUidHelper.randomBytes({\n count: (this.length - body.length) * SAMPLING_OVERDRAW,\n });\n\n for (const byte of bytes) {\n const index = byte & this.mask;\n\n // Rejection, not wrap-around: an index past the alphabet is discarded so every character\n // stays equally likely.\n if (index >= size) {\n continue;\n }\n\n body += this.alphabet[index];\n if (body.length === this.length) {\n break;\n }\n }\n }\n\n return body;\n }\n\n /**\n * `crypto.getRandomValues`, never `Math.random`. Unlike `crypto.randomUUID`, this one is NOT\n * restricted to a secure context, so it works on a plain-http origin and inside a browser Worker.\n */\n private static randomBytes(opts: { count: number }): Uint8Array {\n const source = globalThis.crypto;\n\n if (typeof source?.getRandomValues !== 'function') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] No Web Crypto available | \\`crypto.getRandomValues\\` is required and \\`Math.random\\` is not an acceptable substitute for an identifier`,\n });\n }\n\n return source.getRandomValues(new Uint8Array(opts.count));\n }\n\n private static hasBothCases(opts: { alphabet: string }): boolean {\n let hasUpper = false;\n let hasLower = false;\n\n for (const character of opts.alphabet) {\n hasUpper ||= character !== character.toLowerCase();\n hasLower ||= character !== character.toUpperCase();\n\n if (hasUpper && hasLower) {\n return true;\n }\n }\n\n return false;\n }\n\n private static assertKnownCaseForm(opts: { caseForm: TUidCaseForm }): void {\n if (UidCaseForms.isValid(opts.caseForm)) {\n return;\n }\n\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] Unknown caseForm | value: ${opts.caseForm} | valid: ${[...UidCaseForms.SCHEME_SET].join(', ')}`,\n });\n }\n\n /**\n * Folds case FIRST, then excludes, then de-duplicates - folding after sampling would misreport the\n * entropy and undo the alphabet's own exclusions.\n *\n * Refuses to fold a two-case alphabet at all, because folding one puts back exactly what it took\n * out: uppercasing `BASE58` turns its lowercase letters into `I` and `O`, the two it drops to keep\n * `1` and `0` unambiguous, and lowercasing it brings back `l`. Measured - the result is 35\n * characters, not the 33 an entropy calculation would predict. A single-case alphabet folds\n * cleanly because there is nothing to collide with.\n */\n private static resolveAlphabet(opts: {\n alphabet: string;\n exclude: string;\n caseForm: TUidCaseForm;\n }): string {\n const { alphabet, exclude, caseForm } = opts;\n\n if (caseForm !== UidCaseForms.MIXED && OpaqueUidHelper.hasBothCases({ alphabet })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] caseForm '${caseForm}' cannot fold a two-case alphabet | Folding reintroduces the characters the alphabet excluded | Use \\`UidAlphabets.CROCKFORD\\` for a single-case alphabet, or \\`caseForm: '${UidCaseForms.MIXED}'\\``,\n });\n }\n\n const folded =\n caseForm === UidCaseForms.UPPER\n ? alphabet.toUpperCase()\n : caseForm === UidCaseForms.LOWER\n ? alphabet.toLowerCase()\n : alphabet;\n\n const removed = new Set(exclude);\n const resolved = [...new Set(folded)].filter((character) => !removed.has(character)).join('');\n\n if (resolved.length < MIN_UID_ALPHABET_SIZE) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] Alphabet too small | size: ${resolved.length} | minimum: ${MIN_UID_ALPHABET_SIZE} | Widen \\`alphabet\\` or shorten \\`exclude\\``,\n });\n }\n\n return resolved;\n }\n\n /** An enabled prefix in the wrong case defeats the reason for choosing one: an id meant to survive a case-insensitive column stops being one the moment its prefix disagrees. */\n private static resolvePrefix(opts: { prefix?: IUidSegment; caseForm: TUidCaseForm }): string {\n const { prefix, caseForm } = opts;\n\n if (!prefix?.enable) {\n return '';\n }\n\n const value = prefix.value ?? '';\n if (value.length === 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] prefix is enabled but carries no value`,\n });\n }\n\n const expected =\n caseForm === UidCaseForms.UPPER\n ? value.toUpperCase()\n : caseForm === UidCaseForms.LOWER\n ? value.toLowerCase()\n : value;\n\n if (value !== expected) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] prefix does not match caseForm | prefix: ${value} | caseForm: ${caseForm} | expected: ${expected}`,\n });\n }\n\n return value;\n }\n\n /**\n * Two refusals here, both because the alternative fails silently: a delimiter with no prefix is a\n * leading character that separates nothing, and a delimiter drawn from the alphabet makes the id\n * impossible to split back into prefix and body.\n */\n private static resolveDelimiter(opts: {\n delimiter?: IUidSegment;\n hasPrefix: boolean;\n alphabet: string;\n }): string {\n const { delimiter, hasPrefix, alphabet } = opts;\n\n if (!delimiter?.enable) {\n return '';\n }\n\n if (!hasPrefix) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] delimiter is enabled without a prefix | It would lead the id and separate nothing | Put the character in \\`prefix.value\\` if that is what you want`,\n });\n }\n\n const value = delimiter.value ?? DEFAULT_UID_DELIMITER;\n if (value.length === 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] delimiter is enabled but carries no value`,\n });\n }\n\n const shared = [...new Set(value)].filter((character) => alphabet.includes(character));\n if (shared.length > 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] delimiter shares characters with the alphabet | shared: ${shared.join('')} | An id built with it cannot be split back into prefix and body`,\n });\n }\n\n return value;\n }\n}\n"]}
1
+ {"version":3,"file":"opaque.js","sourceRoot":"","sources":["../../../../src/modules/uid/opaque.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants';\nimport type { ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '../base';\nimport { getError } from '../error';\nimport {\n DEFAULT_UID_DELIMITER,\n DEFAULT_UID_LENGTH,\n DEFAULT_UID_MAX_ATTEMPTS,\n MIN_UID_ALPHABET_SIZE,\n UidAlphabets,\n UidCaseForms,\n} from './common/constants';\nimport type { TUidCaseForm } from './common/constants';\nimport type { INextOpaqueUidOptions, IOpaqueUidOptions, IUidSegment } from './common/types';\n\n/** How many random bytes to draw per refill, per remaining character. Rejection throws some away, so asking for exactly `length` would round-trip to the entropy source repeatedly. */\nconst SAMPLING_OVERDRAW = 2;\n\n/** Local, not `@/utilities/promise.utility`: that module imports the logger BARREL, which reaches `node:module` and would take this browser-pure module with it. */\nconst isPromiseLike = (value: unknown): value is PromiseLike<boolean> => {\n return typeof (value as PromiseLike<boolean> | null | undefined)?.then === 'function';\n};\n\n/**\n * Fixed-length opaque ids, optionally prefixed - the counterpart to `SnowflakeUidHelper`.\n *\n * OPAQUE is the difference that matters, not the randomness. A Snowflake id is TRANSPARENT: its own\n * `parseId()` reads back the exact millisecond it was minted and the worker that minted it. That is\n * what you want in a log and not what you want on an invoice. Nothing can be read out of an id from\n * here. The cost is the ordering, which a Snowflake gives an index for free.\n *\n * `length` counts the BODY only. A prefix and a delimiter sit in front of it, so the finished string\n * is `prefix + delimiter + length` characters.\n *\n * Read {@link DEFAULT_UID_LENGTH} before accepting the default: six characters is an airline record\n * locator, and it needs the same scoping and retry that airlines give one.\n */\nexport class OpaqueUidHelper extends BaseHelper {\n private readonly alphabet: string;\n private readonly length: number;\n private readonly prefix: string;\n private readonly delimiter: string;\n\n /** Rejection mask: the smallest `2^n - 1` that covers every alphabet index. A plain `byte % size` would favour the first `256 % size` characters, which is a bias a caller cannot see and cannot undo. */\n private readonly mask: number;\n\n constructor(opts?: IOpaqueUidOptions) {\n super({ scope: OpaqueUidHelper.name });\n\n const caseForm = opts?.caseForm ?? UidCaseForms.UPPER;\n OpaqueUidHelper.assertKnownCaseForm({ caseForm });\n\n this.alphabet = OpaqueUidHelper.resolveAlphabet({\n alphabet: opts?.alphabet ?? UidAlphabets.CROCKFORD,\n exclude: opts?.exclude ?? '',\n caseForm,\n });\n\n this.length = opts?.length ?? DEFAULT_UID_LENGTH;\n\n if (!Number.isInteger(this.length) || this.length < 1) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] length must be a positive integer | value: ${this.length}`,\n });\n }\n\n this.prefix = OpaqueUidHelper.resolvePrefix({ prefix: opts?.prefix, caseForm });\n this.delimiter = OpaqueUidHelper.resolveDelimiter({\n delimiter: opts?.delimiter,\n hasPrefix: this.prefix.length > 0,\n alphabet: this.alphabet,\n });\n\n this.mask = (1 << Math.ceil(Math.log2(this.alphabet.length))) - 1;\n }\n\n /**\n * `prefix` replaces the configured value for this call and turns the prefix on for it; the\n * delimiter follows its own switch.\n *\n * `isAvailable` redraws until it accepts an id, up to `maxAttempts`. It LOWERS the collision rate,\n * it does not remove it: against a database the check and the insert are two statements, and\n * another request can take the id in between. The column still needs a unique index, and the\n * insert still needs to regenerate on violation.\n */\n nextId(opts?: INextOpaqueUidOptions<boolean>): string;\n nextId(opts: INextOpaqueUidOptions<Promise<boolean>>): Promise<string>;\n nextId(opts: INextOpaqueUidOptions): ValueOrPromise<string>;\n nextId(opts?: INextOpaqueUidOptions): ValueOrPromise<string> {\n const head = this.resolveHead({ prefix: opts?.prefix });\n\n const isAvailable = opts?.isAvailable;\n\n if (!isAvailable) {\n // Refused rather than ignored: without a check there is exactly ONE draw, so a caller who set\n // `maxAttempts` has configured a retry that cannot happen and has no way to notice.\n if (opts?.maxAttempts !== undefined) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] maxAttempts has no effect without \\`isAvailable\\` | Nothing rejects a draw, so there is only ever one`,\n });\n }\n\n return `${head}${this.randomBody()}`;\n }\n\n const maxAttempts = OpaqueUidHelper.resolveMaxAttempts({ maxAttempts: opts?.maxAttempts });\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n const id = `${head}${this.randomBody()}`;\n const verdict = isAvailable(id);\n\n // The first PENDING verdict decides the shape of the whole call. Everything before it already\n // resolved, so a synchronous check never allocates a promise and `nextId()` stays a string.\n if (isPromiseLike(verdict)) {\n return this.continueAsync({ head, isAvailable, maxAttempts, attempt, id, verdict });\n }\n\n if (verdict) {\n return id;\n }\n }\n\n throw this.buildExhaustedError({ maxAttempts });\n }\n\n /** Entered only once a verdict came back pending; every later draw is awaited from here. */\n private async continueAsync(opts: {\n head: string;\n isAvailable: (id: string) => ValueOrPromise<boolean>;\n maxAttempts: number;\n attempt: number;\n id: string;\n verdict: PromiseLike<boolean>;\n }): Promise<string> {\n const { head, isAvailable, maxAttempts, attempt, id, verdict } = opts;\n\n const result = await verdict;\n\n if (result) {\n return id;\n }\n\n for (let next = attempt + 1; next <= maxAttempts; next++) {\n const candidate = `${head}${this.randomBody()}`;\n\n const result2 = await isAvailable(candidate);\n\n if (result2) {\n return candidate;\n }\n }\n\n throw this.buildExhaustedError({ maxAttempts });\n }\n\n private resolveHead(opts: { prefix?: string }): string {\n const override = opts.prefix;\n\n if (override === '') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] An empty prefix is not how a prefix is turned off | Construct with \\`prefix: { enable: false }\\``,\n });\n }\n\n const prefix = override ?? this.prefix;\n\n return prefix.length > 0 ? `${prefix}${this.delimiter}` : '';\n }\n\n private static resolveMaxAttempts(opts: { maxAttempts?: number }): number {\n const maxAttempts = opts.maxAttempts ?? DEFAULT_UID_MAX_ATTEMPTS;\n\n if (!Number.isInteger(maxAttempts) || maxAttempts < 1) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] maxAttempts must be a positive integer | value: ${maxAttempts}`,\n });\n }\n\n return maxAttempts;\n }\n\n /** Bounded rather than endless: repeated rejection means the space is full, and a caller waiting forever learns that far later than a caller holding this error. */\n private buildExhaustedError(opts: { maxAttempts: number }) {\n return getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}][nextId] No available id after ${opts.maxAttempts} attempts | length: ${this.length} | alphabet: ${this.alphabet.length} | The space is crowded - raise \\`length\\``,\n });\n }\n\n /** The alphabet actually in use, after the case fold and every exclusion - what `length` is measured against. */\n getAlphabet(): string {\n return this.alphabet;\n }\n\n private randomBody(): string {\n const size = this.alphabet.length;\n let body = '';\n\n while (body.length < this.length) {\n const bytes = OpaqueUidHelper.randomBytes({\n count: (this.length - body.length) * SAMPLING_OVERDRAW,\n });\n\n for (const byte of bytes) {\n const index = byte & this.mask;\n\n // Rejection, not wrap-around: an index past the alphabet is discarded so every character\n // stays equally likely.\n if (index >= size) {\n continue;\n }\n\n body += this.alphabet[index];\n\n if (body.length === this.length) {\n break;\n }\n }\n }\n\n return body;\n }\n\n /**\n * `crypto.getRandomValues`, never `Math.random`. Unlike `crypto.randomUUID`, this one is NOT\n * restricted to a secure context, so it works on a plain-http origin and inside a browser Worker.\n */\n private static randomBytes(opts: { count: number }): Uint8Array {\n const source = globalThis.crypto;\n\n if (typeof source?.getRandomValues !== 'function') {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] No Web Crypto available | \\`crypto.getRandomValues\\` is required and \\`Math.random\\` is not an acceptable substitute for an identifier`,\n });\n }\n\n return source.getRandomValues(new Uint8Array(opts.count));\n }\n\n private static hasBothCases(opts: { alphabet: string }): boolean {\n let hasUpper = false;\n let hasLower = false;\n\n for (const character of opts.alphabet) {\n hasUpper ||= character !== character.toLowerCase();\n hasLower ||= character !== character.toUpperCase();\n\n if (hasUpper && hasLower) {\n return true;\n }\n }\n\n return false;\n }\n\n private static assertKnownCaseForm(opts: { caseForm: TUidCaseForm }): void {\n if (UidCaseForms.isValid(opts.caseForm)) {\n return;\n }\n\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] Unknown caseForm | value: ${opts.caseForm} | valid: ${[...UidCaseForms.SCHEME_SET].join(', ')}`,\n });\n }\n\n /**\n * Folds case FIRST, then excludes, then de-duplicates - folding after sampling would misreport the\n * entropy and undo the alphabet's own exclusions.\n *\n * Refuses to fold a two-case alphabet at all, because folding one puts back exactly what it took\n * out: uppercasing `BASE58` turns its lowercase letters into `I` and `O`, the two it drops to keep\n * `1` and `0` unambiguous, and lowercasing it brings back `l`. Measured - the result is 35\n * characters, not the 33 an entropy calculation would predict. A single-case alphabet folds\n * cleanly because there is nothing to collide with.\n */\n private static resolveAlphabet(opts: {\n alphabet: string;\n exclude: string;\n caseForm: TUidCaseForm;\n }): string {\n const { alphabet, exclude, caseForm } = opts;\n\n if (caseForm !== UidCaseForms.MIXED && OpaqueUidHelper.hasBothCases({ alphabet })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] caseForm '${caseForm}' cannot fold a two-case alphabet | Folding reintroduces the characters the alphabet excluded | Use \\`UidAlphabets.CROCKFORD\\` for a single-case alphabet, or \\`caseForm: '${UidCaseForms.MIXED}'\\``,\n });\n }\n\n const folded =\n caseForm === UidCaseForms.UPPER\n ? alphabet.toUpperCase()\n : caseForm === UidCaseForms.LOWER\n ? alphabet.toLowerCase()\n : alphabet;\n\n const removed = new Set(exclude);\n const resolved = [...new Set(folded)].filter((character) => !removed.has(character)).join('');\n\n if (resolved.length < MIN_UID_ALPHABET_SIZE) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] Alphabet too small | size: ${resolved.length} | minimum: ${MIN_UID_ALPHABET_SIZE} | Widen \\`alphabet\\` or shorten \\`exclude\\``,\n });\n }\n\n return resolved;\n }\n\n /** An enabled prefix in the wrong case defeats the reason for choosing one: an id meant to survive a case-insensitive column stops being one the moment its prefix disagrees. */\n private static resolvePrefix(opts: { prefix?: IUidSegment; caseForm: TUidCaseForm }): string {\n const { prefix, caseForm } = opts;\n\n if (!prefix?.enable) {\n return '';\n }\n\n const value = prefix.value ?? '';\n\n if (value.length === 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] prefix is enabled but carries no value`,\n });\n }\n\n const expected =\n caseForm === UidCaseForms.UPPER\n ? value.toUpperCase()\n : caseForm === UidCaseForms.LOWER\n ? value.toLowerCase()\n : value;\n\n if (value !== expected) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] prefix does not match caseForm | prefix: ${value} | caseForm: ${caseForm} | expected: ${expected}`,\n });\n }\n\n return value;\n }\n\n /**\n * Two refusals here, both because the alternative fails silently: a delimiter with no prefix is a\n * leading character that separates nothing, and a delimiter drawn from the alphabet makes the id\n * impossible to split back into prefix and body.\n */\n private static resolveDelimiter(opts: {\n delimiter?: IUidSegment;\n hasPrefix: boolean;\n alphabet: string;\n }): string {\n const { delimiter, hasPrefix, alphabet } = opts;\n\n if (!delimiter?.enable) {\n return '';\n }\n\n if (!hasPrefix) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] delimiter is enabled without a prefix | It would lead the id and separate nothing | Put the character in \\`prefix.value\\` if that is what you want`,\n });\n }\n\n const value = delimiter.value ?? DEFAULT_UID_DELIMITER;\n\n if (value.length === 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] delimiter is enabled but carries no value`,\n });\n }\n\n const shared = [...new Set(value)].filter((character) => alphabet.includes(character));\n\n if (shared.length > 0) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${OpaqueUidHelper.name}] delimiter shares characters with the alphabet | shared: ${shared.join('')} | An id built with it cannot be split back into prefix and body`,\n });\n }\n\n return value;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IAiBxC,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAVnD,+CAA+C;QACtC,OAAE,GAAiB,eAAe,CAAC,QAAQ,CAAC;QAErD,+EAA+E;QACtE,OAAE,GAA0D,eAAe,CAAC,QAAQ,CAAC;QAE9F,uGAAuG;QAC9F,OAAE,GAAiB,eAAe,CAAC,QAAQ,CAAC;IAIrD,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,UAAU,CAAC,QAAQ,KAAK,IAAI,UAAU,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,wFAAwF;IACxF,OAAO,CAAC,IAAuB;QAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;IACxD,CAAC;CACF","sourcesContent":["import { BaseHelper } from '../../base';\nimport { UUID_PATTERN } from './common/constants';\nimport type { IUuidInspection } from './common/types';\nimport { UuidV4Generator } from './v4';\nimport { UuidV5Generator } from './v5';\nimport { UuidV7Generator } from './v7';\n\n/**\n * One door for every UUID IGNIS mints: `v7()` for a database key, `v5()` for a deterministic key,\n * `v4()` for a random token.\n *\n * A facade over {@link UuidV4Generator}, {@link UuidV5Generator} and {@link UuidV7Generator} - importing one of those from\n * `@venizia/ignis-helpers/uuid` leaves the other two out of a browser bundle.\n */\nexport class UuidHelper extends BaseHelper {\n /**\n * Per module copy, not realm-wide: the facade holds no state - ordering lives in the shared v7\n * sequence - and a realm-wide slot would hand an older version's instance, and its generators,\n * to every newer caller.\n */\n private static instance?: UuidHelper;\n\n /** Random - a public identifier or a token. */\n readonly v4: () => string = UuidV4Generator.generate;\n\n /** Deterministic - same inputs, same id. Reproducible therefore not secret. */\n readonly v5: (opts: { namespace: string; name: string }) => string = UuidV5Generator.generate;\n\n /** Time-ordered - a database key. A burst past about 2048 ids per millisecond leads the wall clock. */\n readonly v7: () => string = UuidV7Generator.generate;\n\n constructor(opts?: { scope?: string }) {\n super({ scope: opts?.scope ?? UuidHelper.name });\n }\n\n static getInstance(): UuidHelper {\n UuidHelper.instance ??= new UuidHelper();\n return UuidHelper.instance;\n }\n\n /** Lowercase, version 1-8, RFC variant - the nil and max placeholders are refused. */\n static isValid(value: string): boolean {\n return UUID_PATTERN.test(value);\n }\n\n /** Reads the version, and for v7 the creation time; undefined when it is not a UUID. */\n inspect(opts: { value: string }): IUuidInspection | undefined {\n const { value } = opts;\n\n if (!UUID_PATTERN.test(value)) {\n return undefined;\n }\n\n const version = Number.parseInt(value[14], 16);\n if (version !== 7) {\n return { version };\n }\n\n const milliseconds = Number.parseInt(value.slice(0, 8) + value.slice(9, 13), 16);\n return { version, createdAt: new Date(milliseconds) };\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IAiBxC,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAVnD,+CAA+C;QACtC,OAAE,GAAiB,eAAe,CAAC,QAAQ,CAAC;QAErD,+EAA+E;QACtE,OAAE,GAA0D,eAAe,CAAC,QAAQ,CAAC;QAE9F,uGAAuG;QAC9F,OAAE,GAAiB,eAAe,CAAC,QAAQ,CAAC;IAIrD,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,UAAU,CAAC,QAAQ,KAAK,IAAI,UAAU,EAAE,CAAC;QAEzC,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,wFAAwF;IACxF,OAAO,CAAC,IAAuB;QAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAE/C,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;IACxD,CAAC;CACF","sourcesContent":["import { BaseHelper } from '../../base';\nimport { UUID_PATTERN } from './common/constants';\nimport type { IUuidInspection } from './common/types';\nimport { UuidV4Generator } from './v4';\nimport { UuidV5Generator } from './v5';\nimport { UuidV7Generator } from './v7';\n\n/**\n * One door for every UUID IGNIS mints: `v7()` for a database key, `v5()` for a deterministic key,\n * `v4()` for a random token.\n *\n * A facade over {@link UuidV4Generator}, {@link UuidV5Generator} and {@link UuidV7Generator} - importing one of those from\n * `@venizia/ignis-helpers/uuid` leaves the other two out of a browser bundle.\n */\nexport class UuidHelper extends BaseHelper {\n /**\n * Per module copy, not realm-wide: the facade holds no state - ordering lives in the shared v7\n * sequence - and a realm-wide slot would hand an older version's instance, and its generators,\n * to every newer caller.\n */\n private static instance?: UuidHelper;\n\n /** Random - a public identifier or a token. */\n readonly v4: () => string = UuidV4Generator.generate;\n\n /** Deterministic - same inputs, same id. Reproducible therefore not secret. */\n readonly v5: (opts: { namespace: string; name: string }) => string = UuidV5Generator.generate;\n\n /** Time-ordered - a database key. A burst past about 2048 ids per millisecond leads the wall clock. */\n readonly v7: () => string = UuidV7Generator.generate;\n\n constructor(opts?: { scope?: string }) {\n super({ scope: opts?.scope ?? UuidHelper.name });\n }\n\n static getInstance(): UuidHelper {\n UuidHelper.instance ??= new UuidHelper();\n\n return UuidHelper.instance;\n }\n\n /** Lowercase, version 1-8, RFC variant - the nil and max placeholders are refused. */\n static isValid(value: string): boolean {\n return UUID_PATTERN.test(value);\n }\n\n /** Reads the version, and for v7 the creation time; undefined when it is not a UUID. */\n inspect(opts: { value: string }): IUuidInspection | undefined {\n const { value } = opts;\n\n if (!UUID_PATTERN.test(value)) {\n return undefined;\n }\n\n const version = Number.parseInt(value[14], 16);\n\n if (version !== 7) {\n return { version };\n }\n\n const milliseconds = Number.parseInt(value.slice(0, 8) + value.slice(9, 13), 16);\n\n return { version, createdAt: new Date(milliseconds) };\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"sha1.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/sha1.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SHA-1 over bytes, synchronous, no host API - a host module would fail the purity gate and\n * `crypto.subtle` is async and secure-context only.\n *\n * Only UUID v5 uses it. SHA-1 is broken against a chosen-prefix collision: never sign, authenticate\n * or store a password with it.\n */\nexport class Sha1Digest {\n /** Reused: `of()` never yields, so no second call can observe it mid-flight. */\n private static readonly SCHEDULE = new Uint32Array(80);\n\n /** Padding buffer sized for a namespace plus a name; a longer input allocates. */\n private static readonly SCRATCH = new Uint8Array(512);\n\n private static readonly K = [0x5a827999, 0x6ed9eba1, 0x8f1bbcdc, 0xca62c1d6];\n\n /** Digests `bytes` into 20 big-endian bytes. */\n static of(opts: { bytes: Uint8Array }): Uint8Array {\n const { bytes } = opts;\n const length = bytes.length;\n\n // Padding: a `0x80` byte, zeroes, then the bit length in the last 8 bytes of the last block.\n const blockCount = Math.floor((length + 8) / 64) + 1;\n const paddedLength = blockCount * 64;\n\n const reusable = paddedLength <= Sha1Digest.SCRATCH.length;\n const padded = reusable ? Sha1Digest.SCRATCH : new Uint8Array(paddedLength);\n\n padded.set(bytes);\n padded[length] = 0x80;\n if (reusable) {\n // The scratch still holds the previous input past this one: zero the gap, not the whole buffer.\n padded.fill(0, length + 1, paddedLength);\n }\n\n // The bit length is 3 bits wider than 32 for inputs over 512 MB: split it arithmetically.\n const bitsHigh = Math.floor(length / 0x20000000);\n const bitsLow = (length << 3) >>> 0;\n padded[paddedLength - 8] = (bitsHigh >>> 24) & 0xff;\n padded[paddedLength - 7] = (bitsHigh >>> 16) & 0xff;\n padded[paddedLength - 6] = (bitsHigh >>> 8) & 0xff;\n padded[paddedLength - 5] = bitsHigh & 0xff;\n padded[paddedLength - 4] = (bitsLow >>> 24) & 0xff;\n padded[paddedLength - 3] = (bitsLow >>> 16) & 0xff;\n padded[paddedLength - 2] = (bitsLow >>> 8) & 0xff;\n padded[paddedLength - 1] = bitsLow & 0xff;\n\n let h0 = 0x67452301;\n let h1 = 0xefcdab89;\n let h2 = 0x98badcfe;\n let h3 = 0x10325476;\n let h4 = 0xc3d2e1f0;\n\n const schedule = Sha1Digest.SCHEDULE;\n const constants = Sha1Digest.K;\n\n for (let block = 0; block < paddedLength; block += 64) {\n for (let index = 0; index < 16; index++) {\n const at = block + index * 4;\n schedule[index] =\n ((padded[at] << 24) | (padded[at + 1] << 16) | (padded[at + 2] << 8) | padded[at + 3]) >>>\n 0;\n }\n\n for (let index = 16; index < 80; index++) {\n const mixed =\n schedule[index - 3] ^ schedule[index - 8] ^ schedule[index - 14] ^ schedule[index - 16];\n schedule[index] = (mixed << 1) | (mixed >>> 31);\n }\n\n let a = h0;\n let b = h1;\n let c = h2;\n let d = h3;\n let e = h4;\n\n for (let index = 0; index < 80; index++) {\n const round = (index / 20) | 0;\n\n let mixed: number;\n if (round === 0) {\n mixed = (b & c) | (~b & d);\n } else if (round === 2) {\n mixed = (b & c) | (b & d) | (c & d);\n } else {\n mixed = b ^ c ^ d;\n }\n\n const next =\n (((a << 5) | (a >>> 27)) + mixed + e + constants[round] + schedule[index]) >>> 0;\n\n e = d;\n d = c;\n c = (b << 30) | (b >>> 2);\n b = a;\n a = next;\n }\n\n h0 = (h0 + a) >>> 0;\n h1 = (h1 + b) >>> 0;\n h2 = (h2 + c) >>> 0;\n h3 = (h3 + d) >>> 0;\n h4 = (h4 + e) >>> 0;\n }\n\n const digest = new Uint8Array(20);\n const words = [h0, h1, h2, h3, h4];\n for (let index = 0; index < 5; index++) {\n const word = words[index];\n const at = index * 4;\n digest[at] = (word >>> 24) & 0xff;\n digest[at + 1] = (word >>> 16) & 0xff;\n digest[at + 2] = (word >>> 8) & 0xff;\n digest[at + 3] = word & 0xff;\n }\n\n return digest;\n }\n}\n"]}
1
+ {"version":3,"file":"sha1.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/sha1.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SHA-1 over bytes, synchronous, no host API - a host module would fail the purity gate and\n * `crypto.subtle` is async and secure-context only.\n *\n * Only UUID v5 uses it. SHA-1 is broken against a chosen-prefix collision: never sign, authenticate\n * or store a password with it.\n */\nexport class Sha1Digest {\n /** Reused: `of()` never yields, so no second call can observe it mid-flight. */\n private static readonly SCHEDULE = new Uint32Array(80);\n\n /** Padding buffer sized for a namespace plus a name; a longer input allocates. */\n private static readonly SCRATCH = new Uint8Array(512);\n\n private static readonly K = [0x5a827999, 0x6ed9eba1, 0x8f1bbcdc, 0xca62c1d6];\n\n /** Digests `bytes` into 20 big-endian bytes. */\n static of(opts: { bytes: Uint8Array }): Uint8Array {\n const { bytes } = opts;\n const length = bytes.length;\n\n // Padding: a `0x80` byte, zeroes, then the bit length in the last 8 bytes of the last block.\n const blockCount = Math.floor((length + 8) / 64) + 1;\n const paddedLength = blockCount * 64;\n\n const reusable = paddedLength <= Sha1Digest.SCRATCH.length;\n const padded = reusable ? Sha1Digest.SCRATCH : new Uint8Array(paddedLength);\n\n padded.set(bytes);\n padded[length] = 0x80;\n\n if (reusable) {\n // The scratch still holds the previous input past this one: zero the gap, not the whole buffer.\n padded.fill(0, length + 1, paddedLength);\n }\n\n // The bit length is 3 bits wider than 32 for inputs over 512 MB: split it arithmetically.\n const bitsHigh = Math.floor(length / 0x20000000);\n const bitsLow = (length << 3) >>> 0;\n padded[paddedLength - 8] = (bitsHigh >>> 24) & 0xff;\n padded[paddedLength - 7] = (bitsHigh >>> 16) & 0xff;\n padded[paddedLength - 6] = (bitsHigh >>> 8) & 0xff;\n padded[paddedLength - 5] = bitsHigh & 0xff;\n padded[paddedLength - 4] = (bitsLow >>> 24) & 0xff;\n padded[paddedLength - 3] = (bitsLow >>> 16) & 0xff;\n padded[paddedLength - 2] = (bitsLow >>> 8) & 0xff;\n padded[paddedLength - 1] = bitsLow & 0xff;\n\n let h0 = 0x67452301;\n let h1 = 0xefcdab89;\n let h2 = 0x98badcfe;\n let h3 = 0x10325476;\n let h4 = 0xc3d2e1f0;\n\n const schedule = Sha1Digest.SCHEDULE;\n const constants = Sha1Digest.K;\n\n for (let block = 0; block < paddedLength; block += 64) {\n for (let index = 0; index < 16; index++) {\n const at = block + index * 4;\n schedule[index] =\n ((padded[at] << 24) | (padded[at + 1] << 16) | (padded[at + 2] << 8) | padded[at + 3]) >>>\n 0;\n }\n\n for (let index = 16; index < 80; index++) {\n const mixed =\n schedule[index - 3] ^ schedule[index - 8] ^ schedule[index - 14] ^ schedule[index - 16];\n schedule[index] = (mixed << 1) | (mixed >>> 31);\n }\n\n let a = h0;\n let b = h1;\n let c = h2;\n let d = h3;\n let e = h4;\n\n for (let index = 0; index < 80; index++) {\n const round = (index / 20) | 0;\n\n let mixed: number;\n\n if (round === 0) {\n mixed = (b & c) | (~b & d);\n } else if (round === 2) {\n mixed = (b & c) | (b & d) | (c & d);\n } else {\n mixed = b ^ c ^ d;\n }\n\n const next =\n (((a << 5) | (a >>> 27)) + mixed + e + constants[round] + schedule[index]) >>> 0;\n\n e = d;\n d = c;\n c = (b << 30) | (b >>> 2);\n b = a;\n a = next;\n }\n\n h0 = (h0 + a) >>> 0;\n h1 = (h1 + b) >>> 0;\n h2 = (h2 + c) >>> 0;\n h3 = (h3 + d) >>> 0;\n h4 = (h4 + e) >>> 0;\n }\n\n const digest = new Uint8Array(20);\n const words = [h0, h1, h2, h3, h4];\n\n for (let index = 0; index < 5; index++) {\n const word = words[index];\n const at = index * 4;\n digest[at] = (word >>> 24) & 0xff;\n digest[at + 1] = (word >>> 16) & 0xff;\n digest[at + 2] = (word >>> 8) & 0xff;\n digest[at + 3] = word & 0xff;\n }\n\n return digest;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"v4.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC;AAE3B,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,MAAM;QACX,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC;QACjD,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAClD,OAAO,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,MAAM,GAAG,SAAS,CAAC;QAEvB,OAAO,GAAG,EAAE;YACV,IAAI,MAAM,GAAG,SAAS,GAAG,EAAE,EAAE,CAAC;gBAC5B,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,CAAC;YAClB,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC;YAEjB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YAC7C,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YAC7C,MAAM,GAAG,GAAG,eAAe,CAAC;YAE5B,OAAO,CACL,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,OAAO,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,OAAO,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CACnB,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;aAEuB,WAAM,GAAiB,eAAe,CAAC,MAAM,EAAE,CAAC;IAExE,kIAAkI;IAClI,MAAM,CAAC,QAAQ;QACb,OAAO,eAAe,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC","sourcesContent":["import { UUID_HEX_OCTETS } from './common/constants';\n\nconst POOL_SIZE = 16 * 256;\n\nexport class UuidV4Generator {\n /**\n * Builds a v4 generator. `crypto.randomUUID` is captured once - whether a realm is a secure context\n * never changes - and called with no argument, since Node validates it and `['a'].map(...)` would\n * throw.\n */\n static create(): () => string {\n const randomUuid = globalThis.crypto?.randomUUID;\n if (typeof randomUuid === 'function') {\n const native = randomUuid.bind(globalThis.crypto);\n return () => native();\n }\n\n const pool = new Uint8Array(POOL_SIZE);\n let offset = POOL_SIZE;\n\n return () => {\n if (offset > POOL_SIZE - 16) {\n globalThis.crypto.getRandomValues(pool);\n offset = 0;\n }\n\n const at = offset;\n offset = at + 16;\n\n const version = (pool[at + 6] & 0x0f) | 0x40;\n const variant = (pool[at + 8] & 0x3f) | 0x80;\n const hex = UUID_HEX_OCTETS;\n\n return (\n hex[pool[at]] +\n hex[pool[at + 1]] +\n hex[pool[at + 2]] +\n hex[pool[at + 3]] +\n '-' +\n hex[pool[at + 4]] +\n hex[pool[at + 5]] +\n '-' +\n hex[version] +\n hex[pool[at + 7]] +\n '-' +\n hex[variant] +\n hex[pool[at + 9]] +\n '-' +\n hex[pool[at + 10]] +\n hex[pool[at + 11]] +\n hex[pool[at + 12]] +\n hex[pool[at + 13]] +\n hex[pool[at + 14]] +\n hex[pool[at + 15]]\n );\n };\n }\n\n private static readonly shared: () => string = UuidV4Generator.create();\n\n /** Mints a random UUID v4 - a public identifier or a token. Reads no `this`, so `['a'].map(UuidV4Generator.generate)` is safe. */\n static generate(): string {\n return UuidV4Generator.shared();\n }\n}\n"]}
1
+ {"version":3,"file":"v4.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC;AAE3B,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,MAAM;QACX,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC;QAEjD,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAElD,OAAO,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,MAAM,GAAG,SAAS,CAAC;QAEvB,OAAO,GAAG,EAAE;YACV,IAAI,MAAM,GAAG,SAAS,GAAG,EAAE,EAAE,CAAC;gBAC5B,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,CAAC;YAClB,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC;YAEjB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YAC7C,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YAC7C,MAAM,GAAG,GAAG,eAAe,CAAC;YAE5B,OAAO,CACL,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,OAAO,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,OAAO,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACjB,GAAG;gBACH,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CACnB,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;aAEuB,WAAM,GAAiB,eAAe,CAAC,MAAM,EAAE,CAAC;IAExE,kIAAkI;IAClI,MAAM,CAAC,QAAQ;QACb,OAAO,eAAe,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC","sourcesContent":["import { UUID_HEX_OCTETS } from './common/constants';\n\nconst POOL_SIZE = 16 * 256;\n\nexport class UuidV4Generator {\n /**\n * Builds a v4 generator. `crypto.randomUUID` is captured once - whether a realm is a secure context\n * never changes - and called with no argument, since Node validates it and `['a'].map(...)` would\n * throw.\n */\n static create(): () => string {\n const randomUuid = globalThis.crypto?.randomUUID;\n\n if (typeof randomUuid === 'function') {\n const native = randomUuid.bind(globalThis.crypto);\n\n return () => native();\n }\n\n const pool = new Uint8Array(POOL_SIZE);\n let offset = POOL_SIZE;\n\n return () => {\n if (offset > POOL_SIZE - 16) {\n globalThis.crypto.getRandomValues(pool);\n offset = 0;\n }\n\n const at = offset;\n offset = at + 16;\n\n const version = (pool[at + 6] & 0x0f) | 0x40;\n const variant = (pool[at + 8] & 0x3f) | 0x80;\n const hex = UUID_HEX_OCTETS;\n\n return (\n hex[pool[at]] +\n hex[pool[at + 1]] +\n hex[pool[at + 2]] +\n hex[pool[at + 3]] +\n '-' +\n hex[pool[at + 4]] +\n hex[pool[at + 5]] +\n '-' +\n hex[version] +\n hex[pool[at + 7]] +\n '-' +\n hex[variant] +\n hex[pool[at + 9]] +\n '-' +\n hex[pool[at + 10]] +\n hex[pool[at + 11]] +\n hex[pool[at + 12]] +\n hex[pool[at + 13]] +\n hex[pool[at + 14]] +\n hex[pool[at + 15]]\n );\n };\n }\n\n private static readonly shared: () => string = UuidV4Generator.create();\n\n /** Mints a random UUID v4 - a public identifier or a token. Reads no `this`, so `['a'].map(UuidV4Generator.generate)` is safe. */\n static generate(): string {\n return UuidV4Generator.shared();\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"v5.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v5.ts"],"names":[],"mappings":"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","sourcesContent":["// Past the barrels: this module ships on the `./uuid` subpath and must not pull their surface.\nimport { getError } from '@venizia/ignis-inversion';\nimport { HTTP } from '@/common/constants/http';\nimport { MAX_CACHED_NAMESPACES, UUID_HEX_OCTETS, UUID_NAMESPACE_PATTERN } from './common/constants';\nimport { Sha1Digest } from './sha1';\n\n/** Fits a namespace plus a ~160-character name; a longer one allocates for its own call. */\nconst INPUT_SIZE = 512;\n\nexport class UuidV5Generator {\n /** Builds a v5 generator with its own namespace cache and buffer. */\n static create(): (opts: { namespace: string; name: string }) => string {\n const encoder = new TextEncoder();\n\n /** Parsed namespaces, capped so a caller-fed one cannot grow the map without bound. */\n const namespaces = new Map<string, Uint8Array>();\n\n const input = new Uint8Array(INPUT_SIZE);\n const nameView = input.subarray(16);\n\n const resolveNamespace = (opts: { namespace: string }): Uint8Array => {\n const { namespace } = opts;\n\n const cached = namespaces.get(namespace);\n if (cached) {\n return cached;\n }\n\n if (!UUID_NAMESPACE_PATTERN.test(namespace)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[uuidV5] namespace must be a UUID - received: ${namespace}`,\n });\n }\n\n const bytes = new Uint8Array(16);\n const hex = namespace.replaceAll('-', '');\n for (let index = 0; index < 16; index++) {\n bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);\n }\n\n if (namespaces.size < MAX_CACHED_NAMESPACES) {\n namespaces.set(namespace, bytes);\n }\n\n return bytes;\n };\n\n return (opts) => {\n const { namespace, name } = opts;\n\n const namespaceBytes = resolveNamespace({ namespace });\n\n // Encoding turns a lone surrogate into U+FFFD, so two different malformed names would share an id.\n if (typeof name.isWellFormed === 'function' && !name.isWellFormed()) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message:\n '[uuidV5] name carries a lone surrogate - it is not well-formed UTF-16 and would collide with another name',\n });\n }\n\n // UTF-8 never exceeds 3 bytes per UTF-16 code unit. An oversized name gets a buffer of its own\n // for this call only, so one huge name does not pin its size for the life of the process.\n const required = 16 + name.length * 3;\n const target = required > input.length ? new Uint8Array(required) : input;\n const targetName = target === input ? nameView : target.subarray(16);\n\n target.set(namespaceBytes);\n const { written } = encoder.encodeInto(name, targetName);\n\n const digest = Sha1Digest.of({ bytes: target.subarray(0, 16 + written) });\n digest[6] = (digest[6] & 0x0f) | 0x50;\n digest[8] = (digest[8] & 0x3f) | 0x80;\n\n const hex = UUID_HEX_OCTETS;\n\n return (\n hex[digest[0]] +\n hex[digest[1]] +\n hex[digest[2]] +\n hex[digest[3]] +\n '-' +\n hex[digest[4]] +\n hex[digest[5]] +\n '-' +\n hex[digest[6]] +\n hex[digest[7]] +\n '-' +\n hex[digest[8]] +\n hex[digest[9]] +\n '-' +\n hex[digest[10]] +\n hex[digest[11]] +\n hex[digest[12]] +\n hex[digest[13]] +\n hex[digest[14]] +\n hex[digest[15]]\n );\n };\n }\n\n private static readonly shared: (opts: { namespace: string; name: string }) => string =\n UuidV5Generator.create();\n\n /**\n * Mints a deterministic UUID v5 from `namespace` and `name` - an idempotency key.\n *\n * Reproducible therefore NOT secret: never a share link, a reset token or an API key.\n */\n static generate(opts: { namespace: string; name: string }): string {\n return UuidV5Generator.shared(opts);\n }\n}\n"]}
1
+ {"version":3,"file":"v5.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v5.ts"],"names":[],"mappings":"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","sourcesContent":["// Past the barrels: this module ships on the `./uuid` subpath and must not pull their surface.\nimport { getError } from '@venizia/ignis-inversion';\nimport { HTTP } from '@/common/constants/http';\nimport { MAX_CACHED_NAMESPACES, UUID_HEX_OCTETS, UUID_NAMESPACE_PATTERN } from './common/constants';\nimport { Sha1Digest } from './sha1';\n\n/** Fits a namespace plus a ~160-character name; a longer one allocates for its own call. */\nconst INPUT_SIZE = 512;\n\nexport class UuidV5Generator {\n /** Builds a v5 generator with its own namespace cache and buffer. */\n static create(): (opts: { namespace: string; name: string }) => string {\n const encoder = new TextEncoder();\n\n /** Parsed namespaces, capped so a caller-fed one cannot grow the map without bound. */\n const namespaces = new Map<string, Uint8Array>();\n\n const input = new Uint8Array(INPUT_SIZE);\n const nameView = input.subarray(16);\n\n const resolveNamespace = (opts: { namespace: string }): Uint8Array => {\n const { namespace } = opts;\n\n const cached = namespaces.get(namespace);\n\n if (cached) {\n return cached;\n }\n\n if (!UUID_NAMESPACE_PATTERN.test(namespace)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[uuidV5] namespace must be a UUID - received: ${namespace}`,\n });\n }\n\n const bytes = new Uint8Array(16);\n const hex = namespace.replaceAll('-', '');\n\n for (let index = 0; index < 16; index++) {\n bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);\n }\n\n if (namespaces.size < MAX_CACHED_NAMESPACES) {\n namespaces.set(namespace, bytes);\n }\n\n return bytes;\n };\n\n return (opts) => {\n const { namespace, name } = opts;\n\n const namespaceBytes = resolveNamespace({ namespace });\n\n // Encoding turns a lone surrogate into U+FFFD, so two different malformed names would share an id.\n if (typeof name.isWellFormed === 'function' && !name.isWellFormed()) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message:\n '[uuidV5] name carries a lone surrogate - it is not well-formed UTF-16 and would collide with another name',\n });\n }\n\n // UTF-8 never exceeds 3 bytes per UTF-16 code unit. An oversized name gets a buffer of its own\n // for this call only, so one huge name does not pin its size for the life of the process.\n const required = 16 + name.length * 3;\n const target = required > input.length ? new Uint8Array(required) : input;\n const targetName = target === input ? nameView : target.subarray(16);\n\n target.set(namespaceBytes);\n const { written } = encoder.encodeInto(name, targetName);\n\n const digest = Sha1Digest.of({ bytes: target.subarray(0, 16 + written) });\n digest[6] = (digest[6] & 0x0f) | 0x50;\n digest[8] = (digest[8] & 0x3f) | 0x80;\n\n const hex = UUID_HEX_OCTETS;\n\n return (\n hex[digest[0]] +\n hex[digest[1]] +\n hex[digest[2]] +\n hex[digest[3]] +\n '-' +\n hex[digest[4]] +\n hex[digest[5]] +\n '-' +\n hex[digest[6]] +\n hex[digest[7]] +\n '-' +\n hex[digest[8]] +\n hex[digest[9]] +\n '-' +\n hex[digest[10]] +\n hex[digest[11]] +\n hex[digest[12]] +\n hex[digest[13]] +\n hex[digest[14]] +\n hex[digest[15]]\n );\n };\n }\n\n private static readonly shared: (opts: { namespace: string; name: string }) => string =\n UuidV5Generator.create();\n\n /**\n * Mints a deterministic UUID v5 from `namespace` and `name` - an idempotency key.\n *\n * Reproducible therefore NOT secret: never a share link, a reset token or an API key.\n */\n static generate(opts: { namespace: string; name: string }): string {\n return UuidV5Generator.shared(opts);\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"v7.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v7.ts"],"names":[],"mappings":"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","sourcesContent":["import { UUID_HEX_OCTETS } from './common/constants';\n\n/**\n * One sequence per realm, so the CJS and ESM copies - and two helpers versions - never interleave two\n * counters. The slot holds a `() => string`; that key and shape are a contract across versions.\n */\nconst SHARED_SLOT = Symbol.for('@venizia/ignis-helpers:uuid-v7');\n\nconst POOL_SIZE = 8 * 256;\nconst MAX_COUNTER = 0xfff;\n\nexport class UuidV7Generator {\n /**\n * Builds a v7 generator with its own clock state and counter. Never `Bun.randomUUIDv7`: it is\n * slower, and it reads `(encoding, timestamp)` from whatever it is called with.\n */\n static create(): () => string {\n const pool = new Uint8Array(POOL_SIZE);\n let offset = POOL_SIZE;\n let lastMs = -1;\n let counter = 0;\n let prefix = '';\n\n /** Draws a counter seed below 0x800, leaving room to climb inside the millisecond. */\n const drawCounterSeed = (): number => {\n if (offset > POOL_SIZE - 2) {\n globalThis.crypto.getRandomValues(pool);\n offset = 0;\n }\n\n const seed = ((pool[offset] << 8) | pool[offset + 1]) & 0x7ff;\n offset += 2;\n return seed;\n };\n\n /** Renders the 48-bit timestamp half of the id. */\n const renderPrefix = (opts: { ms: number }): string => {\n const { ms } = opts;\n const hex = UUID_HEX_OCTETS;\n // 48 bits exceed the 32-bit bitwise range: split at 24 bits with arithmetic first.\n const high = Math.floor(ms / 0x1000000);\n const low = ms % 0x1000000;\n\n return (\n hex[(high >>> 16) & 0xff] +\n hex[(high >>> 8) & 0xff] +\n hex[high & 0xff] +\n hex[(low >>> 16) & 0xff] +\n '-' +\n hex[(low >>> 8) & 0xff] +\n hex[low & 0xff] +\n '-'\n );\n };\n\n return () => {\n const now = Date.now();\n\n if (now > lastMs) {\n lastMs = now;\n counter = drawCounterSeed();\n prefix = renderPrefix({ ms: now });\n } else if (++counter > MAX_COUNTER) {\n // Counter spent, or the clock stepped back: borrow the next millisecond rather than repeat.\n lastMs += 1;\n counter = drawCounterSeed();\n prefix = renderPrefix({ ms: lastMs });\n }\n\n if (offset > POOL_SIZE - 8) {\n globalThis.crypto.getRandomValues(pool);\n offset = 0;\n }\n\n const at = offset;\n offset = at + 8;\n\n const hex = UUID_HEX_OCTETS;\n\n return (\n prefix +\n hex[0x70 | (counter >>> 8)] +\n hex[counter & 0xff] +\n '-' +\n hex[(pool[at] & 0x3f) | 0x80] +\n hex[pool[at + 1]] +\n '-' +\n hex[pool[at + 2]] +\n hex[pool[at + 3]] +\n hex[pool[at + 4]] +\n hex[pool[at + 5]] +\n hex[pool[at + 6]] +\n hex[pool[at + 7]]\n );\n };\n }\n\n /** The realm's one generator: the one in the shared slot when another copy of this module put it there, else a new one that fills the slot. */\n private static resolveShared(): () => string {\n const shared: (() => string) | undefined = Reflect.get(globalThis, SHARED_SLOT);\n const resolved = shared ?? UuidV7Generator.create();\n if (!shared) {\n Reflect.set(globalThis, SHARED_SLOT, resolved);\n }\n\n return resolved;\n }\n\n private static readonly shared: () => string = UuidV7Generator.resolveShared();\n\n /**\n * Mints a time-ordered UUID v7 - the default for a string primary key. Forwards no argument: the\n * shared slot may hold another helpers version's generator.\n */\n static generate(): string {\n return UuidV7Generator.shared();\n }\n}\n"]}
1
+ {"version":3,"file":"v7.js","sourceRoot":"","sources":["../../../../../src/modules/uid/uuid/v7.ts"],"names":[],"mappings":"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","sourcesContent":["import { UUID_HEX_OCTETS } from './common/constants';\n\n/**\n * One sequence per realm, so the CJS and ESM copies - and two helpers versions - never interleave two\n * counters. The slot holds a `() => string`; that key and shape are a contract across versions.\n */\nconst SHARED_SLOT = Symbol.for('@venizia/ignis-helpers:uuid-v7');\n\nconst POOL_SIZE = 8 * 256;\nconst MAX_COUNTER = 0xfff;\n\nexport class UuidV7Generator {\n /**\n * Builds a v7 generator with its own clock state and counter. Never `Bun.randomUUIDv7`: it is\n * slower, and it reads `(encoding, timestamp)` from whatever it is called with.\n */\n static create(): () => string {\n const pool = new Uint8Array(POOL_SIZE);\n let offset = POOL_SIZE;\n let lastMs = -1;\n let counter = 0;\n let prefix = '';\n\n /** Draws a counter seed below 0x800, leaving room to climb inside the millisecond. */\n const drawCounterSeed = (): number => {\n if (offset > POOL_SIZE - 2) {\n globalThis.crypto.getRandomValues(pool);\n offset = 0;\n }\n\n const seed = ((pool[offset] << 8) | pool[offset + 1]) & 0x7ff;\n offset += 2;\n\n return seed;\n };\n\n /** Renders the 48-bit timestamp half of the id. */\n const renderPrefix = (opts: { ms: number }): string => {\n const { ms } = opts;\n const hex = UUID_HEX_OCTETS;\n // 48 bits exceed the 32-bit bitwise range: split at 24 bits with arithmetic first.\n const high = Math.floor(ms / 0x1000000);\n const low = ms % 0x1000000;\n\n return (\n hex[(high >>> 16) & 0xff] +\n hex[(high >>> 8) & 0xff] +\n hex[high & 0xff] +\n hex[(low >>> 16) & 0xff] +\n '-' +\n hex[(low >>> 8) & 0xff] +\n hex[low & 0xff] +\n '-'\n );\n };\n\n return () => {\n const now = Date.now();\n\n if (now > lastMs) {\n lastMs = now;\n counter = drawCounterSeed();\n prefix = renderPrefix({ ms: now });\n } else if (++counter > MAX_COUNTER) {\n // Counter spent, or the clock stepped back: borrow the next millisecond rather than repeat.\n lastMs += 1;\n counter = drawCounterSeed();\n prefix = renderPrefix({ ms: lastMs });\n }\n\n if (offset > POOL_SIZE - 8) {\n globalThis.crypto.getRandomValues(pool);\n offset = 0;\n }\n\n const at = offset;\n offset = at + 8;\n\n const hex = UUID_HEX_OCTETS;\n\n return (\n prefix +\n hex[0x70 | (counter >>> 8)] +\n hex[counter & 0xff] +\n '-' +\n hex[(pool[at] & 0x3f) | 0x80] +\n hex[pool[at + 1]] +\n '-' +\n hex[pool[at + 2]] +\n hex[pool[at + 3]] +\n hex[pool[at + 4]] +\n hex[pool[at + 5]] +\n hex[pool[at + 6]] +\n hex[pool[at + 7]]\n );\n };\n }\n\n /** The realm's one generator: the one in the shared slot when another copy of this module put it there, else a new one that fills the slot. */\n private static resolveShared(): () => string {\n const shared: (() => string) | undefined = Reflect.get(globalThis, SHARED_SLOT);\n const resolved = shared ?? UuidV7Generator.create();\n\n if (!shared) {\n Reflect.set(globalThis, SHARED_SLOT, resolved);\n }\n\n return resolved;\n }\n\n private static readonly shared: () => string = UuidV7Generator.resolveShared();\n\n /**\n * Mints a time-ordered UUID v7 - the default for a string primary key. Forwards no argument: the\n * shared slot may hold another helpers version's generator.\n */\n static generate(): string {\n return UuidV7Generator.shared();\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/bus/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { type MessagePort, type Transferable } from 'node:worker_threads';\nimport { type IWorkerMessageBusHandler } from '../common';\nimport { AbstractWorkerBusHelper } from './abstract';\n\nexport class BaseWorkerBusHelper<IConsumePayload, IPublishPayload> extends AbstractWorkerBusHelper<\n IConsumePayload,\n IPublishPayload\n> {\n constructor(opts: {\n scope: string;\n port: MessagePort;\n busHandler: IWorkerMessageBusHandler<IConsumePayload>;\n }) {\n super({ scope: opts.scope, identifier: opts.scope });\n\n this.port = opts.port;\n this.handler = opts.busHandler;\n\n this.port.on('message', (message) => {\n this.invokeHook({ scope: 'onMessage', execution: () => this.handler.onMessage({ message }) });\n });\n\n this.port.on('error', (error) => {\n this.invokeHook({ scope: 'onError', execution: () => this.handler.onError({ error }) });\n });\n\n this.port.on('messageerror', (error) => {\n this.invokeHook({ scope: 'onError', execution: () => this.handler.onError({ error }) });\n });\n\n this.port.on('exit', (exitCode) => {\n this.invokeHook({ scope: 'onExit', execution: () => this.handler.onExit({ exitCode }) });\n });\n\n this.port.on('close', () => {\n this.invokeHook({ scope: 'onClose', execution: () => this.handler.onClose() });\n });\n }\n\n /** Bus handlers run inside MessagePort listeners; a sync throw there is uncaught and kills the worker thread, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n PromiseUtility.voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n onBeforePostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n onAfterPostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n\n postMessage(opts: {\n message: IPublishPayload;\n transferList: readonly Transferable[] | undefined;\n }): ValueOrPromise<void> {\n if (!this.port) {\n this.logger\n .for(this.postMessage.name)\n .error('Failed to post message to main | Invalid parentPort!');\n return;\n }\n\n this.invokeHook({\n scope: this.postMessage.name,\n execution: () => this.onBeforePostMessage?.(opts),\n });\n\n if (opts.transferList) {\n this.port.postMessage(opts.message, [...opts.transferList]);\n } else {\n this.port.postMessage(opts.message);\n }\n\n this.invokeHook({\n scope: this.postMessage.name,\n execution: () => this.onAfterPostMessage?.(opts),\n });\n }\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/bus/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { type MessagePort, type Transferable } from 'node:worker_threads';\nimport { type IWorkerMessageBusHandler } from '../common';\nimport { AbstractWorkerBusHelper } from './abstract';\n\nexport class BaseWorkerBusHelper<IConsumePayload, IPublishPayload> extends AbstractWorkerBusHelper<\n IConsumePayload,\n IPublishPayload\n> {\n constructor(opts: {\n scope: string;\n port: MessagePort;\n busHandler: IWorkerMessageBusHandler<IConsumePayload>;\n }) {\n super({ scope: opts.scope, identifier: opts.scope });\n\n this.port = opts.port;\n this.handler = opts.busHandler;\n\n this.port.on('message', (message) => {\n this.invokeHook({ scope: 'onMessage', execution: () => this.handler.onMessage({ message }) });\n });\n\n this.port.on('error', (error) => {\n this.invokeHook({ scope: 'onError', execution: () => this.handler.onError({ error }) });\n });\n\n this.port.on('messageerror', (error) => {\n this.invokeHook({ scope: 'onError', execution: () => this.handler.onError({ error }) });\n });\n\n this.port.on('exit', (exitCode) => {\n this.invokeHook({ scope: 'onExit', execution: () => this.handler.onExit({ exitCode }) });\n });\n\n this.port.on('close', () => {\n this.invokeHook({ scope: 'onClose', execution: () => this.handler.onClose() });\n });\n }\n\n /** Bus handlers run inside MessagePort listeners; a sync throw there is uncaught and kills the worker thread, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n PromiseUtility.voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n onBeforePostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n onAfterPostMessage?(opts: { message: IPublishPayload }): ValueOrPromise<void>;\n\n postMessage(opts: {\n message: IPublishPayload;\n transferList: readonly Transferable[] | undefined;\n }): ValueOrPromise<void> {\n if (!this.port) {\n this.logger\n .for(this.postMessage.name)\n .error('Failed to post message to main | Invalid parentPort!');\n\n return;\n }\n\n this.invokeHook({\n scope: this.postMessage.name,\n execution: () => this.onBeforePostMessage?.(opts),\n });\n\n if (opts.transferList) {\n this.port.postMessage(opts.message, [...opts.transferList]);\n } else {\n this.port.postMessage(opts.message);\n }\n\n this.invokeHook({\n scope: this.postMessage.name,\n execution: () => this.onAfterPostMessage?.(opts),\n });\n }\n}\n"]}