@catbee/utils 0.0.6 → 0.0.8-next.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 (249) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +77 -1107
  3. package/build/index.cjs +6888 -0
  4. package/build/index.d.ts +5242 -0
  5. package/build/index.mjs +6615 -0
  6. package/package.json +26 -95
  7. package/build/esm/config.d.ts +0 -130
  8. package/build/esm/config.js +0 -145
  9. package/build/esm/config.js.map +0 -1
  10. package/build/esm/index.d.ts +0 -27
  11. package/build/esm/index.js +0 -50
  12. package/build/esm/index.js.map +0 -1
  13. package/build/esm/servers/server.builder.d.ts +0 -625
  14. package/build/esm/servers/server.builder.js +0 -722
  15. package/build/esm/servers/server.builder.js.map +0 -1
  16. package/build/esm/servers/server.d.ts +0 -256
  17. package/build/esm/servers/server.js +0 -1211
  18. package/build/esm/servers/server.js.map +0 -1
  19. package/build/esm/types/api-response.d.ts +0 -124
  20. package/build/esm/types/api-response.js +0 -25
  21. package/build/esm/types/api-response.js.map +0 -1
  22. package/build/esm/types/index.d.ts +0 -125
  23. package/build/esm/types/index.js +0 -25
  24. package/build/esm/types/index.js.map +0 -1
  25. package/build/esm/types/server.d.ts +0 -285
  26. package/build/esm/types/server.js +0 -25
  27. package/build/esm/types/server.js.map +0 -1
  28. package/build/esm/utils/array.utils.d.ts +0 -168
  29. package/build/esm/utils/array.utils.js +0 -382
  30. package/build/esm/utils/array.utils.js.map +0 -1
  31. package/build/esm/utils/async.utils.d.ts +0 -174
  32. package/build/esm/utils/async.utils.js +0 -652
  33. package/build/esm/utils/async.utils.js.map +0 -1
  34. package/build/esm/utils/cache.utils.d.ts +0 -153
  35. package/build/esm/utils/cache.utils.js +0 -499
  36. package/build/esm/utils/cache.utils.js.map +0 -1
  37. package/build/esm/utils/context-store.utils.d.ts +0 -186
  38. package/build/esm/utils/context-store.utils.js +0 -304
  39. package/build/esm/utils/context-store.utils.js.map +0 -1
  40. package/build/esm/utils/crypto.utils.d.ts +0 -160
  41. package/build/esm/utils/crypto.utils.js +0 -375
  42. package/build/esm/utils/crypto.utils.js.map +0 -1
  43. package/build/esm/utils/decorators.utils.d.ts +0 -315
  44. package/build/esm/utils/decorators.utils.js +0 -666
  45. package/build/esm/utils/decorators.utils.js.map +0 -1
  46. package/build/esm/utils/dir.utils.d.ts +0 -196
  47. package/build/esm/utils/dir.utils.js +0 -998
  48. package/build/esm/utils/dir.utils.js.map +0 -1
  49. package/build/esm/utils/env.utils.d.ts +0 -377
  50. package/build/esm/utils/env.utils.js +0 -873
  51. package/build/esm/utils/env.utils.js.map +0 -1
  52. package/build/esm/utils/exception.utils.d.ts +0 -230
  53. package/build/esm/utils/exception.utils.js +0 -559
  54. package/build/esm/utils/exception.utils.js.map +0 -1
  55. package/build/esm/utils/fs.utils.d.ts +0 -164
  56. package/build/esm/utils/fs.utils.js +0 -580
  57. package/build/esm/utils/fs.utils.js.map +0 -1
  58. package/build/esm/utils/http-status-codes.d.ts +0 -266
  59. package/build/esm/utils/http-status-codes.js +0 -295
  60. package/build/esm/utils/http-status-codes.js.map +0 -1
  61. package/build/esm/utils/id.utils.d.ts +0 -36
  62. package/build/esm/utils/id.utils.js +0 -87
  63. package/build/esm/utils/id.utils.js.map +0 -1
  64. package/build/esm/utils/logger.utils.d.ts +0 -166
  65. package/build/esm/utils/logger.utils.js +0 -347
  66. package/build/esm/utils/logger.utils.js.map +0 -1
  67. package/build/esm/utils/middleware.utils.d.ts +0 -83
  68. package/build/esm/utils/middleware.utils.js +0 -205
  69. package/build/esm/utils/middleware.utils.js.map +0 -1
  70. package/build/esm/utils/obj.utils.d.ts +0 -124
  71. package/build/esm/utils/obj.utils.js +0 -519
  72. package/build/esm/utils/obj.utils.js.map +0 -1
  73. package/build/esm/utils/request.utils.d.ts +0 -77
  74. package/build/esm/utils/request.utils.js +0 -196
  75. package/build/esm/utils/request.utils.js.map +0 -1
  76. package/build/esm/utils/response.utils.d.ts +0 -163
  77. package/build/esm/utils/response.utils.js +0 -284
  78. package/build/esm/utils/response.utils.js.map +0 -1
  79. package/build/esm/utils/string.utils.d.ts +0 -93
  80. package/build/esm/utils/string.utils.js +0 -169
  81. package/build/esm/utils/string.utils.js.map +0 -1
  82. package/build/esm/utils/url.utils.d.ts +0 -141
  83. package/build/esm/utils/url.utils.js +0 -381
  84. package/build/esm/utils/url.utils.js.map +0 -1
  85. package/build/esm/utils/validate.utils.d.ts +0 -177
  86. package/build/esm/utils/validate.utils.js +0 -336
  87. package/build/esm/utils/validate.utils.js.map +0 -1
  88. package/build/esnext/config.d.ts +0 -130
  89. package/build/esnext/config.js +0 -145
  90. package/build/esnext/config.js.map +0 -1
  91. package/build/esnext/index.d.ts +0 -27
  92. package/build/esnext/index.js +0 -50
  93. package/build/esnext/index.js.map +0 -1
  94. package/build/esnext/servers/server.builder.d.ts +0 -625
  95. package/build/esnext/servers/server.builder.js +0 -677
  96. package/build/esnext/servers/server.builder.js.map +0 -1
  97. package/build/esnext/servers/server.d.ts +0 -256
  98. package/build/esnext/servers/server.js +0 -918
  99. package/build/esnext/servers/server.js.map +0 -1
  100. package/build/esnext/types/api-response.d.ts +0 -124
  101. package/build/esnext/types/api-response.js +0 -25
  102. package/build/esnext/types/api-response.js.map +0 -1
  103. package/build/esnext/types/index.d.ts +0 -125
  104. package/build/esnext/types/index.js +0 -25
  105. package/build/esnext/types/index.js.map +0 -1
  106. package/build/esnext/types/server.d.ts +0 -285
  107. package/build/esnext/types/server.js +0 -25
  108. package/build/esnext/types/server.js.map +0 -1
  109. package/build/esnext/utils/array.utils.d.ts +0 -168
  110. package/build/esnext/utils/array.utils.js +0 -345
  111. package/build/esnext/utils/array.utils.js.map +0 -1
  112. package/build/esnext/utils/async.utils.d.ts +0 -174
  113. package/build/esnext/utils/async.utils.js +0 -430
  114. package/build/esnext/utils/async.utils.js.map +0 -1
  115. package/build/esnext/utils/cache.utils.d.ts +0 -153
  116. package/build/esnext/utils/cache.utils.js +0 -293
  117. package/build/esnext/utils/cache.utils.js.map +0 -1
  118. package/build/esnext/utils/context-store.utils.d.ts +0 -186
  119. package/build/esnext/utils/context-store.utils.js +0 -286
  120. package/build/esnext/utils/context-store.utils.js.map +0 -1
  121. package/build/esnext/utils/crypto.utils.d.ts +0 -160
  122. package/build/esnext/utils/crypto.utils.js +0 -276
  123. package/build/esnext/utils/crypto.utils.js.map +0 -1
  124. package/build/esnext/utils/decorators.utils.d.ts +0 -315
  125. package/build/esnext/utils/decorators.utils.js +0 -504
  126. package/build/esnext/utils/decorators.utils.js.map +0 -1
  127. package/build/esnext/utils/dir.utils.d.ts +0 -196
  128. package/build/esnext/utils/dir.utils.js +0 -477
  129. package/build/esnext/utils/dir.utils.js.map +0 -1
  130. package/build/esnext/utils/env.utils.d.ts +0 -377
  131. package/build/esnext/utils/env.utils.js +0 -785
  132. package/build/esnext/utils/env.utils.js.map +0 -1
  133. package/build/esnext/utils/exception.utils.d.ts +0 -230
  134. package/build/esnext/utils/exception.utils.js +0 -381
  135. package/build/esnext/utils/exception.utils.js.map +0 -1
  136. package/build/esnext/utils/fs.utils.d.ts +0 -164
  137. package/build/esnext/utils/fs.utils.js +0 -349
  138. package/build/esnext/utils/fs.utils.js.map +0 -1
  139. package/build/esnext/utils/http-status-codes.d.ts +0 -266
  140. package/build/esnext/utils/http-status-codes.js +0 -295
  141. package/build/esnext/utils/http-status-codes.js.map +0 -1
  142. package/build/esnext/utils/id.utils.d.ts +0 -36
  143. package/build/esnext/utils/id.utils.js +0 -84
  144. package/build/esnext/utils/id.utils.js.map +0 -1
  145. package/build/esnext/utils/logger.utils.d.ts +0 -166
  146. package/build/esnext/utils/logger.utils.js +0 -306
  147. package/build/esnext/utils/logger.utils.js.map +0 -1
  148. package/build/esnext/utils/middleware.utils.d.ts +0 -83
  149. package/build/esnext/utils/middleware.utils.js +0 -198
  150. package/build/esnext/utils/middleware.utils.js.map +0 -1
  151. package/build/esnext/utils/obj.utils.d.ts +0 -124
  152. package/build/esnext/utils/obj.utils.js +0 -413
  153. package/build/esnext/utils/obj.utils.js.map +0 -1
  154. package/build/esnext/utils/request.utils.d.ts +0 -77
  155. package/build/esnext/utils/request.utils.js +0 -168
  156. package/build/esnext/utils/request.utils.js.map +0 -1
  157. package/build/esnext/utils/response.utils.d.ts +0 -163
  158. package/build/esnext/utils/response.utils.js +0 -247
  159. package/build/esnext/utils/response.utils.js.map +0 -1
  160. package/build/esnext/utils/string.utils.d.ts +0 -93
  161. package/build/esnext/utils/string.utils.js +0 -165
  162. package/build/esnext/utils/string.utils.js.map +0 -1
  163. package/build/esnext/utils/url.utils.d.ts +0 -141
  164. package/build/esnext/utils/url.utils.js +0 -304
  165. package/build/esnext/utils/url.utils.js.map +0 -1
  166. package/build/esnext/utils/validate.utils.d.ts +0 -177
  167. package/build/esnext/utils/validate.utils.js +0 -320
  168. package/build/esnext/utils/validate.utils.js.map +0 -1
  169. package/build/src/config.d.ts +0 -130
  170. package/build/src/config.js +0 -150
  171. package/build/src/config.js.map +0 -1
  172. package/build/src/index.d.ts +0 -27
  173. package/build/src/index.js +0 -69
  174. package/build/src/index.js.map +0 -1
  175. package/build/src/servers/server.builder.d.ts +0 -625
  176. package/build/src/servers/server.builder.js +0 -681
  177. package/build/src/servers/server.builder.js.map +0 -1
  178. package/build/src/servers/server.d.ts +0 -256
  179. package/build/src/servers/server.js +0 -958
  180. package/build/src/servers/server.js.map +0 -1
  181. package/build/src/types/api-response.d.ts +0 -124
  182. package/build/src/types/api-response.js +0 -26
  183. package/build/src/types/api-response.js.map +0 -1
  184. package/build/src/types/index.d.ts +0 -125
  185. package/build/src/types/index.js +0 -26
  186. package/build/src/types/index.js.map +0 -1
  187. package/build/src/types/server.d.ts +0 -285
  188. package/build/src/types/server.js +0 -26
  189. package/build/src/types/server.js.map +0 -1
  190. package/build/src/utils/array.utils.d.ts +0 -168
  191. package/build/src/utils/array.utils.js +0 -364
  192. package/build/src/utils/array.utils.js.map +0 -1
  193. package/build/src/utils/async.utils.d.ts +0 -174
  194. package/build/src/utils/async.utils.js +0 -447
  195. package/build/src/utils/async.utils.js.map +0 -1
  196. package/build/src/utils/cache.utils.d.ts +0 -153
  197. package/build/src/utils/cache.utils.js +0 -297
  198. package/build/src/utils/cache.utils.js.map +0 -1
  199. package/build/src/utils/context-store.utils.d.ts +0 -186
  200. package/build/src/utils/context-store.utils.js +0 -293
  201. package/build/src/utils/context-store.utils.js.map +0 -1
  202. package/build/src/utils/crypto.utils.d.ts +0 -160
  203. package/build/src/utils/crypto.utils.js +0 -293
  204. package/build/src/utils/crypto.utils.js.map +0 -1
  205. package/build/src/utils/decorators.utils.d.ts +0 -315
  206. package/build/src/utils/decorators.utils.js +0 -516
  207. package/build/src/utils/decorators.utils.js.map +0 -1
  208. package/build/src/utils/dir.utils.d.ts +0 -196
  209. package/build/src/utils/dir.utils.js +0 -501
  210. package/build/src/utils/dir.utils.js.map +0 -1
  211. package/build/src/utils/env.utils.d.ts +0 -377
  212. package/build/src/utils/env.utils.js +0 -789
  213. package/build/src/utils/env.utils.js.map +0 -1
  214. package/build/src/utils/exception.utils.d.ts +0 -230
  215. package/build/src/utils/exception.utils.js +0 -407
  216. package/build/src/utils/exception.utils.js.map +0 -1
  217. package/build/src/utils/fs.utils.d.ts +0 -164
  218. package/build/src/utils/fs.utils.js +0 -372
  219. package/build/src/utils/fs.utils.js.map +0 -1
  220. package/build/src/utils/http-status-codes.d.ts +0 -266
  221. package/build/src/utils/http-status-codes.js +0 -298
  222. package/build/src/utils/http-status-codes.js.map +0 -1
  223. package/build/src/utils/id.utils.d.ts +0 -36
  224. package/build/src/utils/id.utils.js +0 -91
  225. package/build/src/utils/id.utils.js.map +0 -1
  226. package/build/src/utils/logger.utils.d.ts +0 -166
  227. package/build/src/utils/logger.utils.js +0 -352
  228. package/build/src/utils/logger.utils.js.map +0 -1
  229. package/build/src/utils/middleware.utils.d.ts +0 -83
  230. package/build/src/utils/middleware.utils.js +0 -205
  231. package/build/src/utils/middleware.utils.js.map +0 -1
  232. package/build/src/utils/obj.utils.d.ts +0 -124
  233. package/build/src/utils/obj.utils.js +0 -429
  234. package/build/src/utils/obj.utils.js.map +0 -1
  235. package/build/src/utils/request.utils.d.ts +0 -77
  236. package/build/src/utils/request.utils.js +0 -175
  237. package/build/src/utils/request.utils.js.map +0 -1
  238. package/build/src/utils/response.utils.d.ts +0 -163
  239. package/build/src/utils/response.utils.js +0 -260
  240. package/build/src/utils/response.utils.js.map +0 -1
  241. package/build/src/utils/string.utils.d.ts +0 -93
  242. package/build/src/utils/string.utils.js +0 -179
  243. package/build/src/utils/string.utils.js.map +0 -1
  244. package/build/src/utils/url.utils.d.ts +0 -141
  245. package/build/src/utils/url.utils.js +0 -317
  246. package/build/src/utils/url.utils.js.map +0 -1
  247. package/build/src/utils/validate.utils.d.ts +0 -177
  248. package/build/src/utils/validate.utils.js +0 -345
  249. package/build/src/utils/validate.utils.js.map +0 -1
@@ -1,652 +0,0 @@
1
- /*
2
- * The MIT License
3
- *
4
- * Copyright (c) 2025 Catbee Technologies
5
- *
6
- * Permission is hereby granted, free of charge, to any person obtaining a copy
7
- * of this software and associated documentation files (the "Software"), to deal
8
- * in the Software without restriction, including without limitation the rights
9
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
- * copies of the Software, and to permit persons to whom the Software is
11
- * furnished to do so, subject to the following conditions:
12
- *
13
- * The above copyright notice and this permission notice shall be included in all
14
- * copies or substantial portions of the Software.
15
- *
16
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
- * SOFTWARE.
23
- */
24
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
25
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
26
- return new (P || (P = Promise))(function (resolve, reject) {
27
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
28
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
29
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
30
- step((generator = generator.apply(thisArg, _arguments || [])).next());
31
- });
32
- };
33
- var __generator = (this && this.__generator) || function (thisArg, body) {
34
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
35
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
36
- function verb(n) { return function (v) { return step([n, v]); }; }
37
- function step(op) {
38
- if (f) throw new TypeError("Generator is already executing.");
39
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
40
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
41
- if (y = 0, t) op = [op[0] & 2, t.value];
42
- switch (op[0]) {
43
- case 0: case 1: t = op; break;
44
- case 4: _.label++; return { value: op[1], done: false };
45
- case 5: _.label++; y = op[1]; op = [0]; continue;
46
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
47
- default:
48
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
49
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
50
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
51
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
52
- if (t[2]) _.ops.pop();
53
- _.trys.pop(); continue;
54
- }
55
- op = body.call(thisArg, _);
56
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
57
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
58
- }
59
- };
60
- var __read = (this && this.__read) || function (o, n) {
61
- var m = typeof Symbol === "function" && o[Symbol.iterator];
62
- if (!m) return o;
63
- var i = m.call(o), r, ar = [], e;
64
- try {
65
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
66
- }
67
- catch (error) { e = { error: error }; }
68
- finally {
69
- try {
70
- if (r && !r.done && (m = i["return"])) m.call(i);
71
- }
72
- finally { if (e) throw e.error; }
73
- }
74
- return ar;
75
- };
76
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
77
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
78
- if (ar || !(i in from)) {
79
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
80
- ar[i] = from[i];
81
- }
82
- }
83
- return to.concat(ar || Array.prototype.slice.call(from));
84
- };
85
- var __values = (this && this.__values) || function(o) {
86
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
87
- if (m) return m.call(o);
88
- if (o && typeof o.length === "number") return {
89
- next: function () {
90
- if (o && i >= o.length) o = void 0;
91
- return { value: o && o[i++], done: !o };
92
- }
93
- };
94
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
95
- };
96
- /**
97
- * Delays execution for a specified number of milliseconds.
98
- *
99
- * @param {number} ms - The number of milliseconds to sleep.
100
- * @returns {Promise<void>} A Promise that resolves after the given time.
101
- */
102
- export function sleep(ms) {
103
- return new Promise(function (resolve) { return setTimeout(resolve, ms); });
104
- }
105
- /**
106
- * Creates a debounced version of a function that delays its execution.
107
- * Provides `.cancel()` and `.flush()` methods.
108
- *
109
- * @template T
110
- * @param {T} fn - The function to debounce.
111
- * @param {number} delay - Delay in milliseconds.
112
- * @returns {T & { cancel: () => void; flush: () => void }} A debounced function.
113
- */
114
- export function debounce(fn, delay) {
115
- var timer = null;
116
- var pendingArgs = null;
117
- function debounced() {
118
- var args = [];
119
- for (var _i = 0; _i < arguments.length; _i++) {
120
- args[_i] = arguments[_i];
121
- }
122
- pendingArgs = args;
123
- if (timer)
124
- clearTimeout(timer);
125
- timer = setTimeout(function () {
126
- fn.apply(void 0, __spreadArray([], __read(pendingArgs), false));
127
- timer = null;
128
- }, delay);
129
- }
130
- debounced.cancel = function () {
131
- if (timer)
132
- clearTimeout(timer);
133
- timer = null;
134
- pendingArgs = null;
135
- };
136
- debounced.flush = function () {
137
- if (timer) {
138
- clearTimeout(timer);
139
- fn.apply(void 0, __spreadArray([], __read(pendingArgs), false));
140
- timer = null;
141
- pendingArgs = null;
142
- }
143
- };
144
- return debounced;
145
- }
146
- /**
147
- * Creates a throttled version of a function that limits its execution rate.
148
- * Allows control over leading/trailing invocation.
149
- *
150
- * @template T
151
- * @param {T} fn - The function to throttle.
152
- * @param {number} limit - Minimum time between calls in milliseconds.
153
- * @param {{ leading?: boolean, trailing?: boolean }} [opts] - Options for leading/trailing edge throttling.
154
- * @returns {(...args: Parameters<T>) => void} A throttled function.
155
- */
156
- export function throttle(fn, limit, opts) {
157
- if (opts === void 0) { opts = {
158
- leading: true,
159
- trailing: false
160
- }; }
161
- var lastCall = 0;
162
- var timer = null;
163
- var savedArgs = null;
164
- return function () {
165
- var args = [];
166
- for (var _i = 0; _i < arguments.length; _i++) {
167
- args[_i] = arguments[_i];
168
- }
169
- var now = Date.now();
170
- var _a = opts.leading, leading = _a === void 0 ? true : _a, _b = opts.trailing, trailing = _b === void 0 ? false : _b;
171
- if (!lastCall && !leading)
172
- lastCall = now;
173
- var remaining = limit - (now - lastCall);
174
- if (remaining <= 0) {
175
- if (timer) {
176
- clearTimeout(timer);
177
- timer = null;
178
- }
179
- lastCall = now;
180
- fn.apply(void 0, __spreadArray([], __read(args), false));
181
- }
182
- else if (trailing) {
183
- savedArgs = args;
184
- if (!timer) {
185
- timer = setTimeout(function () {
186
- lastCall = leading ? Date.now() : 0;
187
- timer = null;
188
- if (savedArgs)
189
- fn.apply(void 0, __spreadArray([], __read(savedArgs), false));
190
- }, remaining);
191
- }
192
- }
193
- };
194
- }
195
- /**
196
- * Retries an asynchronous function a given number of times with optional delay/backoff.
197
- *
198
- * @template T
199
- * @param {() => Promise<T>} fn - The async function to retry.
200
- * @param {number} [retries=3] - Number of retry attempts.
201
- * @param {number} [delay=500] - Delay in milliseconds between retries.
202
- * @param {boolean} [backoff=false] - Use exponential backoff between attempts.
203
- * @param {(error: unknown, attempt: number) => void} [onRetry] - Callback for each retry attempt.
204
- * @returns {Promise<T>} The result of the async function if successful.
205
- * @throws {*} The last encountered error if all retries fail.
206
- */
207
- export function retry(fn_1) {
208
- return __awaiter(this, arguments, void 0, function (fn, retries, delay, backoff, onRetry) {
209
- var i, e_1;
210
- if (retries === void 0) { retries = 3; }
211
- if (delay === void 0) { delay = 500; }
212
- if (backoff === void 0) { backoff = false; }
213
- return __generator(this, function (_a) {
214
- switch (_a.label) {
215
- case 0:
216
- i = 0;
217
- _a.label = 1;
218
- case 1:
219
- if (!(i < retries)) return [3 /*break*/, 7];
220
- _a.label = 2;
221
- case 2:
222
- _a.trys.push([2, 4, , 6]);
223
- return [4 /*yield*/, fn()];
224
- case 3: return [2 /*return*/, _a.sent()];
225
- case 4:
226
- e_1 = _a.sent();
227
- if (i === retries - 1)
228
- throw e_1;
229
- if (onRetry)
230
- onRetry(e_1, i + 1);
231
- return [4 /*yield*/, sleep(backoff ? delay * Math.pow(2, i) : delay)];
232
- case 5:
233
- _a.sent();
234
- return [3 /*break*/, 6];
235
- case 6:
236
- i++;
237
- return [3 /*break*/, 1];
238
- case 7: throw new Error('Retry failed'); // should never reach here
239
- }
240
- });
241
- });
242
- }
243
- /**
244
- * Wraps a promise and rejects it if it doesn't resolve within the specified timeout.
245
- *
246
- * @template T
247
- * @param {Promise<T>} promise - The original promise.
248
- * @param {number} ms - Timeout in milliseconds.
249
- * @param {string} [message="Operation timed out"] - Optional timeout message.
250
- * @returns {Promise<T>} A promise that resolves or rejects within the timeout.
251
- */
252
- export function withTimeout(promise, ms, message) {
253
- if (message === void 0) { message = 'Operation timed out'; }
254
- return new Promise(function (resolve, reject) {
255
- var timeoutHandle = setTimeout(function () { return reject(new Error(message)); }, ms);
256
- promise
257
- .then(function (result) {
258
- clearTimeout(timeoutHandle);
259
- resolve(result);
260
- })
261
- .catch(function (err) {
262
- clearTimeout(timeoutHandle);
263
- reject(err);
264
- });
265
- });
266
- }
267
- /**
268
- * Executes async tasks in true batches.
269
- * Each batch runs in parallel, but batches run sequentially.
270
- * All tasks in a batch start at the same time, next batch waits for full completion.
271
- * NOTE: For more granular concurrency, use a "queue" or "pooled" approach.
272
- *
273
- * @template T
274
- * @param {Array<() => Promise<T>>} tasks - An array of functions that return Promises.
275
- * @param {number} limit - Number of tasks to run in parallel per batch.
276
- * @returns {Promise<T[]>} A promise that resolves to an array of resolved values.
277
- */
278
- export function runInBatches(tasks, limit) {
279
- return __awaiter(this, void 0, void 0, function () {
280
- var results, i, batch, batchResults;
281
- return __generator(this, function (_a) {
282
- switch (_a.label) {
283
- case 0:
284
- results = [];
285
- i = 0;
286
- _a.label = 1;
287
- case 1:
288
- if (!(i < tasks.length)) return [3 /*break*/, 4];
289
- batch = tasks.slice(i, i + limit);
290
- return [4 /*yield*/, Promise.all(batch.map(function (fn) { return fn(); }))];
291
- case 2:
292
- batchResults = _a.sent();
293
- results.push.apply(results, __spreadArray([], __read(batchResults), false));
294
- _a.label = 3;
295
- case 3:
296
- i += limit;
297
- return [3 /*break*/, 1];
298
- case 4: return [2 /*return*/, results];
299
- }
300
- });
301
- });
302
- }
303
- /**
304
- * Wraps a function and ensures it is only called once at a time.
305
- * Calls made while one is in progress will wait for the same Promise.
306
- * Optionally, new calls can be dropped while in progress (drop=true).
307
- *
308
- * @template TArgs
309
- * @template TResult
310
- * @param {(...args: TArgs) => Promise<TResult>} fn - The async function to wrap.
311
- * @param {boolean} [drop=false] - If true, new calls while one is pending are rejected.
312
- * @returns {(...args: TArgs) => Promise<TResult>} A wrapped function with singleton behavior.
313
- */
314
- export function singletonAsync(fn, drop) {
315
- var _this = this;
316
- if (drop === void 0) { drop = false; }
317
- var promise = null;
318
- return function () {
319
- var args = [];
320
- for (var _i = 0; _i < arguments.length; _i++) {
321
- args[_i] = arguments[_i];
322
- }
323
- return __awaiter(_this, void 0, void 0, function () {
324
- return __generator(this, function (_a) {
325
- if (!promise) {
326
- promise = fn.apply(void 0, __spreadArray([], __read(args), false)).finally(function () {
327
- promise = null;
328
- });
329
- }
330
- else if (drop) {
331
- return [2 /*return*/, Promise.reject(new Error('Busy: function already running'))];
332
- }
333
- return [2 /*return*/, promise];
334
- });
335
- });
336
- };
337
- }
338
- /**
339
- * Resolves a list of async tasks in parallel, returning both resolved and rejected results.
340
- *
341
- * @template T
342
- * @param {Array<() => Promise<T>>} tasks - Array of promise-returning functions.
343
- * @returns {Promise<PromiseSettledResult<T>[]>} Results including status and value/reason.
344
- */
345
- export function settleAll(tasks) {
346
- return __awaiter(this, void 0, void 0, function () {
347
- return __generator(this, function (_a) {
348
- return [2 /*return*/, Promise.allSettled(tasks.map(function (task) { return task(); }))];
349
- });
350
- });
351
- }
352
- /**
353
- * A simple task queue that executes async tasks with a concurrency limit.
354
- * Exposes pause, resume, and queue length getters.
355
- *
356
- * @param {number} limit - Maximum number of concurrent tasks.
357
- * @returns {function & { pause: () => void, resume: () => void, length: number, isPaused: boolean }}
358
- * Enqueue function plus queue controls.
359
- */
360
- export function createTaskQueue(limit) {
361
- var queue = [];
362
- var activeCount = 0;
363
- var paused = false;
364
- var state = {
365
- /**
366
- * Pause task processing.
367
- */
368
- pause: function () {
369
- paused = true;
370
- },
371
- /**
372
- * Resume task processing.
373
- */
374
- resume: function () {
375
- paused = false;
376
- next();
377
- },
378
- /**
379
- * The current length of the queue.
380
- * @type {number}
381
- */
382
- get length() {
383
- return queue.length;
384
- },
385
- /**
386
- * Whether the queue is currently paused.
387
- * @type {boolean}
388
- */
389
- get isPaused() {
390
- return paused;
391
- }
392
- };
393
- var next = function () {
394
- if (paused || queue.length === 0 || activeCount >= limit)
395
- return;
396
- var task = queue.shift();
397
- activeCount++;
398
- task().finally(function () {
399
- activeCount--;
400
- next();
401
- });
402
- };
403
- /**
404
- * Enqueues a new async task to the queue.
405
- *
406
- * @template T
407
- * @param {() => Promise<T>} taskFn - The async task function.
408
- * @returns {Promise<T>} Promise resolving when task completes.
409
- */
410
- var enqueue = function (taskFn) {
411
- return __awaiter(this, void 0, void 0, function () {
412
- var _this = this;
413
- return __generator(this, function (_a) {
414
- return [2 /*return*/, new Promise(function (resolve, reject) {
415
- queue.push(function () { return __awaiter(_this, void 0, void 0, function () {
416
- var result, err_1;
417
- return __generator(this, function (_a) {
418
- switch (_a.label) {
419
- case 0:
420
- _a.trys.push([0, 2, , 3]);
421
- return [4 /*yield*/, taskFn()];
422
- case 1:
423
- result = _a.sent();
424
- resolve(result);
425
- return [3 /*break*/, 3];
426
- case 2:
427
- err_1 = _a.sent();
428
- reject(err_1);
429
- return [3 /*break*/, 3];
430
- case 3: return [2 /*return*/];
431
- }
432
- });
433
- }); });
434
- next();
435
- })];
436
- });
437
- });
438
- };
439
- enqueue.pause = state.pause;
440
- enqueue.resume = state.resume;
441
- Object.defineProperty(enqueue, 'length', {
442
- get: function () { return queue.length; }
443
- });
444
- Object.defineProperty(enqueue, 'isPaused', {
445
- get: function () { return paused; }
446
- });
447
- return enqueue;
448
- }
449
- /**
450
- * Executes async functions sequentially and collects results.
451
- * Useful when order matters or tasks depend on each other.
452
- *
453
- * @template T
454
- * @param {Array<() => Promise<T>>} tasks - Array of promise-returning functions.
455
- * @returns {Promise<T[]>} Array of resolved values.
456
- */
457
- export function runInSeries(tasks) {
458
- return __awaiter(this, void 0, void 0, function () {
459
- var results, tasks_1, tasks_1_1, task, _a, _b, e_2_1;
460
- var e_2, _c;
461
- return __generator(this, function (_d) {
462
- switch (_d.label) {
463
- case 0:
464
- results = [];
465
- _d.label = 1;
466
- case 1:
467
- _d.trys.push([1, 6, 7, 8]);
468
- tasks_1 = __values(tasks), tasks_1_1 = tasks_1.next();
469
- _d.label = 2;
470
- case 2:
471
- if (!!tasks_1_1.done) return [3 /*break*/, 5];
472
- task = tasks_1_1.value;
473
- _b = (_a = results).push;
474
- return [4 /*yield*/, task()];
475
- case 3:
476
- _b.apply(_a, [_d.sent()]);
477
- _d.label = 4;
478
- case 4:
479
- tasks_1_1 = tasks_1.next();
480
- return [3 /*break*/, 2];
481
- case 5: return [3 /*break*/, 8];
482
- case 6:
483
- e_2_1 = _d.sent();
484
- e_2 = { error: e_2_1 };
485
- return [3 /*break*/, 8];
486
- case 7:
487
- try {
488
- if (tasks_1_1 && !tasks_1_1.done && (_c = tasks_1.return)) _c.call(tasks_1);
489
- }
490
- finally { if (e_2) throw e_2.error; }
491
- return [7 /*endfinally*/];
492
- case 8: return [2 /*return*/, results];
493
- }
494
- });
495
- });
496
- }
497
- /**
498
- * Memoizes an async function, caching results for repeated calls with identical arguments.
499
- * Optional TTL (time-to-live) for cached entries.
500
- *
501
- * @template T Function return type
502
- * @template Args Function arguments types
503
- * @param {(...args: Args) => Promise<T>} fn - The async function to memoize
504
- * @param {object} [options] - Memoization options
505
- * @param {number} [options.ttl] - Cache TTL in milliseconds (optional)
506
- * @param {(args: Args) => string} [options.keyFn] - Custom key generator function
507
- * @returns {(...args: Args) => Promise<T>} Memoized function
508
- */
509
- export function memoizeAsync(fn, options) {
510
- if (options === void 0) { options = {}; }
511
- var cache = new Map();
512
- var ttl = options.ttl, _a = options.keyFn, keyFn = _a === void 0 ? JSON.stringify : _a;
513
- return function () {
514
- var args = [];
515
- for (var _i = 0; _i < arguments.length; _i++) {
516
- args[_i] = arguments[_i];
517
- }
518
- return __awaiter(this, void 0, void 0, function () {
519
- var key, cached, result;
520
- return __generator(this, function (_a) {
521
- switch (_a.label) {
522
- case 0:
523
- key = keyFn(args);
524
- cached = cache.get(key);
525
- if (cached && (!ttl || Date.now() < cached.expires)) {
526
- return [2 /*return*/, cached.value];
527
- }
528
- return [4 /*yield*/, fn.apply(void 0, __spreadArray([], __read(args), false))];
529
- case 1:
530
- result = _a.sent();
531
- cache.set(key, {
532
- value: result,
533
- expires: ttl ? Date.now() + ttl : Infinity
534
- });
535
- return [2 /*return*/, result];
536
- }
537
- });
538
- });
539
- };
540
- }
541
- /**
542
- * Creates an abortable version of a promise that can be cancelled using an AbortController.
543
- *
544
- * @template T
545
- * @param {Promise<T>} promise - The promise to make abortable
546
- * @param {AbortSignal} signal - AbortSignal from AbortController
547
- * @param {any} [abortValue] - Value to use when rejecting on abort
548
- * @returns {Promise<T>} Promise that rejects if the signal is aborted
549
- */
550
- export function abortable(promise, signal, abortValue) {
551
- if (abortValue === void 0) { abortValue = new Error('Operation aborted'); }
552
- if (signal.aborted) {
553
- return Promise.reject(abortValue);
554
- }
555
- return Promise.race([
556
- promise,
557
- new Promise(function (_, reject) {
558
- var abort = function () { return reject(abortValue); };
559
- signal.addEventListener('abort', abort, { once: true });
560
- promise.finally(function () { return signal.removeEventListener('abort', abort); });
561
- })
562
- ]);
563
- }
564
- /**
565
- * Creates a promise with external resolve/reject functions.
566
- * Useful for creating promises that can be resolved or rejected from outside.
567
- *
568
- * @template T
569
- * @returns {[Promise<T>, (value: T | PromiseLike<T>) => void, (reason?: any) => void]}
570
- * Tuple of [promise, resolve, reject]
571
- */
572
- export function createDeferred() {
573
- var resolve;
574
- var reject;
575
- var promise = new Promise(function (res, rej) {
576
- resolve = res;
577
- reject = rej;
578
- });
579
- return [promise, resolve, reject];
580
- }
581
- /**
582
- * Chains a series of async functions, passing the result of each to the next.
583
- * Similar to function composition but for async functions.
584
- *
585
- * @template T
586
- * @param {Array<(input: any) => Promise<any>>} fns - Array of async functions to compose
587
- * @returns {(input: any) => Promise<T>} Composed function
588
- */
589
- export function waterfall(fns) {
590
- var _this = this;
591
- return function (initialValue) { return __awaiter(_this, void 0, void 0, function () {
592
- var _this = this;
593
- return __generator(this, function (_a) {
594
- return [2 /*return*/, fns.reduce(function (acc, fn) { return __awaiter(_this, void 0, void 0, function () { var _a; return __generator(this, function (_b) {
595
- switch (_b.label) {
596
- case 0:
597
- _a = fn;
598
- return [4 /*yield*/, acc];
599
- case 1: return [2 /*return*/, _a.apply(void 0, [_b.sent()])];
600
- }
601
- }); }); }, Promise.resolve(initialValue))];
602
- });
603
- }); };
604
- }
605
- /**
606
- * Creates a rate limiter that ensures functions aren't called more than
607
- * a specified number of times per interval.
608
- *
609
- * @template T
610
- * @param {(...args: any[]) => Promise<T>} fn - Function to rate limit
611
- * @param {number} maxCalls - Maximum calls allowed per interval
612
- * @param {number} interval - Time interval in milliseconds
613
- * @returns {(...args: any[]) => Promise<T>} Rate limited function
614
- */
615
- export function rateLimit(fn, maxCalls, interval) {
616
- var calls = [];
617
- return function () {
618
- var args = [];
619
- for (var _i = 0; _i < arguments.length; _i++) {
620
- args[_i] = arguments[_i];
621
- }
622
- return __awaiter(this, void 0, void 0, function () {
623
- var now, oldestCall, delay, currentTime_1, nextDelay;
624
- return __generator(this, function (_a) {
625
- switch (_a.label) {
626
- case 0:
627
- now = Date.now();
628
- calls.splice.apply(calls, __spreadArray([0, calls.length], __read(calls.filter(function (time) { return now - time < interval; })), false));
629
- if (!(calls.length >= maxCalls)) return [3 /*break*/, 3];
630
- oldestCall = calls[0];
631
- delay = interval - (now - oldestCall);
632
- return [4 /*yield*/, sleep(Math.max(1, delay))];
633
- case 1:
634
- _a.sent();
635
- currentTime_1 = Date.now();
636
- calls.splice.apply(calls, __spreadArray([0, calls.length], __read(calls.filter(function (time) { return currentTime_1 - time < interval; })), false));
637
- if (!(calls.length >= maxCalls)) return [3 /*break*/, 3];
638
- nextDelay = interval - (currentTime_1 - calls[0]);
639
- return [4 /*yield*/, sleep(Math.max(1, nextDelay))];
640
- case 2:
641
- _a.sent();
642
- calls.splice.apply(calls, __spreadArray([0, calls.length], __read(calls.filter(function (time) { return Date.now() - time < interval; })), false));
643
- _a.label = 3;
644
- case 3:
645
- calls.push(Date.now());
646
- return [2 /*return*/, fn.apply(void 0, __spreadArray([], __read(args), false))];
647
- }
648
- });
649
- });
650
- };
651
- }
652
- //# sourceMappingURL=async.utils.js.map