@noeldemartin/utils 0.7.3 → 0.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 (234) hide show
  1. package/dist/_virtual/_rolldown/runtime.js +13 -0
  2. package/dist/fluent/FluentArray.d.ts +48 -0
  3. package/dist/fluent/FluentArray.js +48 -0
  4. package/dist/fluent/FluentArray.js.map +1 -0
  5. package/dist/fluent/FluentObject.d.ts +16 -0
  6. package/dist/fluent/FluentObject.js +45 -0
  7. package/dist/fluent/FluentObject.js.map +1 -0
  8. package/dist/fluent/FluentString.d.ts +21 -0
  9. package/dist/fluent/FluentString.js +28 -0
  10. package/dist/fluent/FluentString.js.map +1 -0
  11. package/dist/fluent/facade.d.ts +17 -0
  12. package/dist/fluent/facade.js +45 -0
  13. package/dist/fluent/facade.js.map +1 -0
  14. package/dist/fluent/index.d.ts +29 -0
  15. package/dist/fluent/index.js +41 -0
  16. package/dist/fluent/index.js.map +1 -0
  17. package/dist/fluent/invade.d.ts +6 -0
  18. package/dist/fluent/invade.js +8 -0
  19. package/dist/fluent/invade.js.map +1 -0
  20. package/dist/fluent/lazyFacade.d.ts +16 -0
  21. package/dist/fluent/lazyFacade.js +67 -0
  22. package/dist/fluent/lazyFacade.js.map +1 -0
  23. package/dist/fluent/noop.d.ts +4 -0
  24. package/dist/fluent/noop.js +6 -0
  25. package/dist/fluent/noop.js.map +1 -0
  26. package/dist/fluent/required.d.ts +5 -0
  27. package/dist/fluent/required.js +32 -0
  28. package/dist/fluent/required.js.map +1 -0
  29. package/dist/fluent/tap.d.ts +7 -0
  30. package/dist/fluent/tap.js +22 -0
  31. package/dist/fluent/tap.js.map +1 -0
  32. package/dist/fluent/value.d.ts +5 -0
  33. package/dist/fluent/value.js +8 -0
  34. package/dist/fluent/value.js.map +1 -0
  35. package/dist/fluent/when.d.ts +6 -0
  36. package/dist/fluent/when.js +11 -0
  37. package/dist/fluent/when.js.map +1 -0
  38. package/dist/helpers/InMemoryStorageService.d.ts +8 -0
  39. package/dist/helpers/InMemoryStorageService.js +16 -0
  40. package/dist/helpers/InMemoryStorageService.js.map +1 -0
  41. package/dist/helpers/IndexedDBMap.d.ts +17 -0
  42. package/dist/helpers/IndexedDBMap.js +52 -0
  43. package/dist/helpers/IndexedDBMap.js.map +1 -0
  44. package/dist/helpers/JSError.d.ts +14 -0
  45. package/dist/helpers/JSError.js +14 -0
  46. package/dist/helpers/JSError.js.map +1 -0
  47. package/dist/helpers/ListenersManager.d.ts +15 -0
  48. package/dist/helpers/ListenersManager.js +23 -0
  49. package/dist/helpers/ListenersManager.js.map +1 -0
  50. package/dist/helpers/MagicObject.d.ts +29 -0
  51. package/dist/helpers/MagicObject.js +77 -0
  52. package/dist/helpers/MagicObject.js.map +1 -0
  53. package/dist/helpers/ObjectsMap.d.ts +28 -0
  54. package/dist/helpers/ObjectsMap.js +86 -0
  55. package/dist/helpers/ObjectsMap.js.map +1 -0
  56. package/dist/helpers/PromisedValue.d.ts +32 -0
  57. package/dist/helpers/PromisedValue.js +68 -0
  58. package/dist/helpers/PromisedValue.js.map +1 -0
  59. package/dist/helpers/Semaphore.d.ts +14 -0
  60. package/dist/helpers/Semaphore.js +45 -0
  61. package/dist/helpers/Semaphore.js.map +1 -0
  62. package/dist/helpers/Storage.d.ts +17 -0
  63. package/dist/helpers/Storage.js +39 -0
  64. package/dist/helpers/Storage.js.map +1 -0
  65. package/dist/helpers/array_helpers.d.ts +57 -0
  66. package/dist/helpers/array_helpers.js +208 -0
  67. package/dist/helpers/array_helpers.js.map +1 -0
  68. package/dist/helpers/boolean_helpers.d.ts +4 -0
  69. package/dist/helpers/boolean_helpers.js +10 -0
  70. package/dist/helpers/boolean_helpers.js.map +1 -0
  71. package/dist/helpers/caching_helpers.d.ts +17 -0
  72. package/dist/helpers/caching_helpers.js +55 -0
  73. package/dist/helpers/caching_helpers.js.map +1 -0
  74. package/dist/helpers/chaos_helpers.d.ts +6 -0
  75. package/dist/helpers/chaos_helpers.js +11 -0
  76. package/dist/helpers/chaos_helpers.js.map +1 -0
  77. package/dist/helpers/date_helpers.d.ts +4 -0
  78. package/dist/helpers/date_helpers.js +15 -0
  79. package/dist/helpers/date_helpers.js.map +1 -0
  80. package/dist/helpers/deprecated.d.ts +24 -0
  81. package/dist/helpers/env.d.ts +9 -0
  82. package/dist/helpers/env.js +42 -0
  83. package/dist/helpers/env.js.map +1 -0
  84. package/dist/helpers/error_helpers.d.ts +12 -0
  85. package/dist/helpers/error_helpers.js +20 -0
  86. package/dist/helpers/error_helpers.js.map +1 -0
  87. package/dist/helpers/escape_helpers.d.ts +5 -0
  88. package/dist/helpers/escape_helpers.js +11 -0
  89. package/dist/helpers/escape_helpers.js.map +1 -0
  90. package/dist/helpers/file_helpers.d.ts +4 -0
  91. package/dist/helpers/file_helpers.js +16 -0
  92. package/dist/helpers/file_helpers.js.map +1 -0
  93. package/dist/helpers/format_helpers.d.ts +7 -0
  94. package/dist/helpers/format_helpers.js +28 -0
  95. package/dist/helpers/format_helpers.js.map +1 -0
  96. package/dist/helpers/hash_helpers.d.ts +4 -0
  97. package/dist/helpers/hash_helpers.js +156 -0
  98. package/dist/helpers/hash_helpers.js.map +1 -0
  99. package/dist/helpers/identity_helpers.d.ts +5 -0
  100. package/dist/helpers/identity_helpers.js +15 -0
  101. package/dist/helpers/identity_helpers.js.map +1 -0
  102. package/dist/helpers/location_helpers.d.ts +8 -0
  103. package/dist/helpers/location_helpers.js +37 -0
  104. package/dist/helpers/location_helpers.js.map +1 -0
  105. package/dist/helpers/logical_helpers.d.ts +4 -0
  106. package/dist/helpers/logical_helpers.js +13 -0
  107. package/dist/helpers/logical_helpers.js.map +1 -0
  108. package/dist/helpers/math_helpers.d.ts +5 -0
  109. package/dist/helpers/math_helpers.js +12 -0
  110. package/dist/helpers/math_helpers.js.map +1 -0
  111. package/dist/helpers/mixin_helpers.d.ts +20 -0
  112. package/dist/helpers/mixin_helpers.js +43 -0
  113. package/dist/helpers/mixin_helpers.js.map +1 -0
  114. package/dist/helpers/network_helpers.d.ts +4 -0
  115. package/dist/helpers/network_helpers.js +8 -0
  116. package/dist/helpers/network_helpers.js.map +1 -0
  117. package/dist/helpers/object_helpers.d.ts +58 -0
  118. package/dist/helpers/object_helpers.js +179 -0
  119. package/dist/helpers/object_helpers.js.map +1 -0
  120. package/dist/helpers/promise_helpers.d.ts +10 -0
  121. package/dist/helpers/promise_helpers.js +25 -0
  122. package/dist/helpers/promise_helpers.js.map +1 -0
  123. package/dist/helpers/replacements-scope.js +21 -0
  124. package/dist/helpers/replacements-scope.js.map +1 -0
  125. package/dist/helpers/replacements.d.ts +5 -0
  126. package/dist/helpers/replacements.js +34 -0
  127. package/dist/helpers/replacements.js.map +1 -0
  128. package/dist/helpers/runtime_helpers.d.ts +4 -0
  129. package/dist/helpers/runtime_helpers.js +8 -0
  130. package/dist/helpers/runtime_helpers.js.map +1 -0
  131. package/dist/helpers/string_helpers.d.ts +17 -0
  132. package/dist/helpers/string_helpers.js +42 -0
  133. package/dist/helpers/string_helpers.js.map +1 -0
  134. package/dist/helpers/time_constants.d.ts +15 -0
  135. package/dist/helpers/time_constants.js +17 -0
  136. package/dist/helpers/time_constants.js.map +1 -0
  137. package/dist/helpers/time_helpers.d.ts +24 -0
  138. package/dist/helpers/time_helpers.js +57 -0
  139. package/dist/helpers/time_helpers.js.map +1 -0
  140. package/dist/helpers/url_helpers.d.ts +24 -0
  141. package/dist/helpers/url_helpers.js +90 -0
  142. package/dist/helpers/url_helpers.js.map +1 -0
  143. package/dist/helpers/value_helpers.d.ts +7 -0
  144. package/dist/helpers/value_helpers.js +11 -0
  145. package/dist/helpers/value_helpers.js.map +1 -0
  146. package/dist/index.d.ts +53 -0
  147. package/dist/index.js +49 -0
  148. package/dist/types/arrays.d.ts +12 -0
  149. package/dist/types/classes.d.ts +12 -0
  150. package/dist/types/helpers.d.ts +36 -0
  151. package/dist/types/helpers.js +6 -0
  152. package/dist/types/helpers.js.map +1 -0
  153. package/dist/types/objects.d.ts +8 -0
  154. package/package.json +38 -52
  155. package/src/fluent/FluentArray.test.ts +2 -9
  156. package/src/fluent/FluentArray.ts +6 -5
  157. package/src/fluent/FluentObject.ts +2 -4
  158. package/src/fluent/FluentString.test.ts +1 -8
  159. package/src/fluent/FluentString.ts +0 -2
  160. package/src/fluent/facade.test.ts +16 -4
  161. package/src/fluent/facade.ts +6 -4
  162. package/src/fluent/index.test.ts +3 -8
  163. package/src/fluent/index.ts +3 -3
  164. package/src/fluent/invade.test.ts +1 -5
  165. package/src/fluent/invade.ts +1 -1
  166. package/src/fluent/lazyFacade.test.ts +191 -0
  167. package/src/fluent/lazyFacade.ts +115 -0
  168. package/src/fluent/required.test.ts +1 -5
  169. package/src/fluent/required.ts +2 -4
  170. package/src/fluent/tap.test.ts +2 -9
  171. package/src/fluent/tap.ts +4 -3
  172. package/src/fluent/value.test.ts +1 -4
  173. package/src/fluent/when.test.ts +1 -6
  174. package/src/fluent/when.ts +2 -2
  175. package/src/helpers/InMemoryStorageService.ts +13 -0
  176. package/src/helpers/IndexedDBMap.ts +0 -2
  177. package/src/helpers/JSError.test.ts +1 -6
  178. package/src/helpers/JSError.ts +0 -2
  179. package/src/helpers/ListenersManager.test.ts +3 -7
  180. package/src/helpers/ListenersManager.ts +2 -4
  181. package/src/helpers/MagicObject.test.ts +14 -8
  182. package/src/helpers/MagicObject.ts +12 -3
  183. package/src/helpers/ObjectsMap.test.ts +1 -3
  184. package/src/helpers/ObjectsMap.ts +1 -5
  185. package/src/helpers/PromisedValue.test.ts +1 -3
  186. package/src/helpers/PromisedValue.ts +5 -6
  187. package/src/helpers/Semaphore.test.ts +6 -10
  188. package/src/helpers/Semaphore.ts +0 -2
  189. package/src/helpers/Storage.test.ts +47 -0
  190. package/src/helpers/Storage.ts +11 -19
  191. package/src/helpers/array_helpers.test.ts +127 -38
  192. package/src/helpers/array_helpers.ts +137 -78
  193. package/src/helpers/caching_helpers.test.ts +1 -3
  194. package/src/helpers/caching_helpers.ts +2 -2
  195. package/src/helpers/date_helpers.test.ts +1 -4
  196. package/src/helpers/date_helpers.ts +1 -1
  197. package/src/helpers/env.ts +5 -1
  198. package/src/helpers/error_helpers.test.ts +9 -8
  199. package/src/helpers/error_helpers.ts +11 -11
  200. package/src/helpers/format_helpers.test.ts +2 -4
  201. package/src/helpers/hash_helpers.test.ts +1 -4
  202. package/src/helpers/hash_helpers.ts +3 -3
  203. package/src/helpers/identity_helpers.test.ts +1 -3
  204. package/src/helpers/index.ts +3 -0
  205. package/src/helpers/logical_helpers.test.ts +1 -3
  206. package/src/helpers/logical_helpers.ts +1 -1
  207. package/src/helpers/math_helpers.test.ts +1 -3
  208. package/src/helpers/mixin_helpers.stubs.ts +1 -13
  209. package/src/helpers/mixin_helpers.test.ts +2 -7
  210. package/src/helpers/mixin_helpers.ts +6 -9
  211. package/src/helpers/object_helpers.test.ts +32 -19
  212. package/src/helpers/object_helpers.ts +43 -21
  213. package/src/helpers/promise_helpers.test.ts +1 -4
  214. package/src/helpers/promise_helpers.ts +9 -9
  215. package/src/helpers/replacements-scope.ts +15 -0
  216. package/src/helpers/replacements.test.ts +23 -0
  217. package/src/helpers/replacements.ts +52 -0
  218. package/src/helpers/runtime_helpers.ts +3 -3
  219. package/src/helpers/string_helpers.test.ts +3 -5
  220. package/src/helpers/time_constants.ts +13 -0
  221. package/src/helpers/time_helpers.ts +35 -0
  222. package/src/helpers/url_helpers.test.ts +12 -4
  223. package/src/helpers/url_helpers.ts +9 -15
  224. package/src/helpers/value_helpers.test.ts +12 -0
  225. package/src/helpers/value_helpers.ts +6 -0
  226. package/src/types/arrays.test.ts +1 -4
  227. package/src/types/classes.ts +1 -0
  228. package/src/types/helpers.test.ts +1 -6
  229. package/src/types/helpers.ts +6 -5
  230. package/src/types/objects.test.ts +1 -4
  231. package/src/types/objects.ts +3 -3
  232. package/dist/noeldemartin-utils.d.ts +0 -901
  233. package/dist/noeldemartin-utils.js +0 -1473
  234. package/dist/noeldemartin-utils.js.map +0 -1
@@ -0,0 +1,22 @@
1
+ import { isPromiseLike } from "../helpers/object_helpers.js";
2
+ //#region src/fluent/tap.ts
3
+ function proxyTap(target) {
4
+ const proxy = new Proxy(target, { get(_target, key, receiver) {
5
+ const prop = Reflect.get(_target, key, receiver);
6
+ if (typeof prop !== "function") return prop;
7
+ return (...params) => {
8
+ prop.call(_target, ...params);
9
+ return proxy;
10
+ };
11
+ } });
12
+ return proxy;
13
+ }
14
+ function tap(target, callback) {
15
+ if (!callback) return proxyTap(target);
16
+ const result = callback(target);
17
+ return isPromiseLike(result) ? result.then(() => target) : target;
18
+ }
19
+ //#endregion
20
+ export { tap };
21
+
22
+ //# sourceMappingURL=tap.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tap.js","names":[],"sources":["../../src/fluent/tap.ts"],"sourcesContent":["import { isPromiseLike } from '@noeldemartin/utils/helpers/object_helpers';\n\n// Typescript equivalent of Laravel's tap helper method\n// @see https://medium.com/@taylorotwell/tap-tap-tap-1fc6fc1f93a6\n// @see https://github.com/laravel/framework/blob/v7.8.0/src/Illuminate/Support/helpers.php#L422..L431\n\nexport type Tapped<Target extends object> = {\n [prop in keyof Target]: Target[prop] extends (...params: infer Params) => unknown\n ? (...params: Params) => Tapped<Target>\n : Target[prop];\n};\n\nfunction proxyTap<Target extends object>(target: Target): Tapped<Target> {\n const proxy = new Proxy(target, {\n get(_target: object, key: PropertyKey, receiver?: unknown) {\n const prop = Reflect.get(_target, key, receiver);\n\n if (typeof prop !== 'function') return prop;\n\n return (...params: any[]) => {\n prop.call(_target, ...params);\n\n return proxy;\n };\n },\n }) as Tapped<Target>;\n\n return proxy;\n}\n\nexport function tap<Target extends object>(target: Target): Tapped<Target>;\nexport function tap<Target>(target: Target, callback: (target: Target) => Promise<unknown>): Promise<Target>;\nexport function tap<Target>(target: Target, callback: (target: Target) => unknown): Target;\nexport function tap<Target extends object>(\n target: Target,\n // oxlint-disable-next-line typescript/no-redundant-type-constituents\n callback?: (target: Target) => unknown | Promise<unknown>,\n): Target | Tapped<Target> | Promise<Target> {\n if (!callback) return proxyTap(target);\n\n const result = callback(target);\n\n return isPromiseLike(result) ? (result.then(() => target) as unknown as Promise<Target>) : target;\n}\n"],"mappings":";;AAYA,SAAS,SAAgC,QAAgC;CACrE,MAAM,QAAQ,IAAI,MAAM,QAAQ,EAC5B,IAAI,SAAiB,KAAkB,UAAoB;EACvD,MAAM,OAAO,QAAQ,IAAI,SAAS,KAAK,QAAQ;EAE/C,IAAI,OAAO,SAAS,YAAY,OAAO;EAEvC,QAAQ,GAAG,WAAkB;GACzB,KAAK,KAAK,SAAS,GAAG,MAAM;GAE5B,OAAO;EACX;CACJ,EACJ,CAAC;CAED,OAAO;AACX;AAKA,SAAgB,IACZ,QAEA,UACyC;CACzC,IAAI,CAAC,UAAU,OAAO,SAAS,MAAM;CAErC,MAAM,SAAS,SAAS,MAAM;CAE9B,OAAO,cAAc,MAAM,IAAK,OAAO,WAAW,MAAM,IAAmC;AAC/F"}
@@ -0,0 +1,5 @@
1
+ //#region src/fluent/value.d.ts
2
+ export declare function value<T>(evaluator: () => T): T;
3
+ export declare function value<T>(evaluator: T): T;
4
+ //#endregion
5
+ //# sourceMappingURL=value.d.ts.map
@@ -0,0 +1,8 @@
1
+ //#region src/fluent/value.ts
2
+ function value(evaluator) {
3
+ return typeof evaluator === "function" ? evaluator() : evaluator;
4
+ }
5
+ //#endregion
6
+ export { value };
7
+
8
+ //# sourceMappingURL=value.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"value.js","names":[],"sources":["../../src/fluent/value.ts"],"sourcesContent":["export function value<T>(evaluator: () => T): T;\nexport function value<T>(evaluator: T): T;\nexport function value<T>(evaluator: T | (() => T)): T {\n return typeof evaluator === 'function' ? (evaluator as () => T)() : evaluator;\n}\n"],"mappings":";AAEA,SAAgB,MAAS,WAA6B;CAClD,OAAO,OAAO,cAAc,aAAc,UAAsB,IAAI;AACxE"}
@@ -0,0 +1,6 @@
1
+ //#region src/fluent/when.d.ts
2
+ export declare function when<T extends object>(target: T, condition: () => boolean): T;
3
+ export declare function when<T extends object>(target: T, condition: boolean): T;
4
+ export declare function when<T extends object>(target: any, condition: (t: any) => t is T): T;
5
+ //#endregion
6
+ //# sourceMappingURL=when.d.ts.map
@@ -0,0 +1,11 @@
1
+ //#region src/fluent/when.ts
2
+ function when(target, condition) {
3
+ const success = typeof condition === "function" ? condition(target) : !!condition;
4
+ return new Proxy(target, { get(_target, property, receiver) {
5
+ return success ? Reflect.get(_target, property, receiver) : () => {};
6
+ } });
7
+ }
8
+ //#endregion
9
+ export { when };
10
+
11
+ //# sourceMappingURL=when.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"when.js","names":[],"sources":["../../src/fluent/when.ts"],"sourcesContent":["export function when<T extends object>(target: T, condition: () => boolean): T;\nexport function when<T extends object>(target: T, condition: boolean): T;\n// oxlint-disable-next-line typescript/no-explicit-any, typescript/explicit-module-boundary-types\nexport function when<T extends object>(target: any, condition: (t: any) => t is T): T;\nexport function when<T extends object>(target: T, condition: unknown): T {\n const success = typeof condition === 'function' ? condition(target) : !!condition;\n\n return new Proxy(target, {\n get(_target, property, receiver) {\n // oxlint-disable-next-line typescript/no-empty-function\n return success ? Reflect.get(_target, property, receiver) : () => {};\n },\n }) as unknown as T;\n}\n"],"mappings":";AAIA,SAAgB,KAAuB,QAAW,WAAuB;CACrE,MAAM,UAAU,OAAO,cAAc,aAAa,UAAU,MAAM,IAAI,CAAC,CAAC;CAExE,OAAO,IAAI,MAAM,QAAQ,EACrB,IAAI,SAAS,UAAU,UAAU;EAE7B,OAAO,UAAU,QAAQ,IAAI,SAAS,UAAU,QAAQ,UAAU,CAAC;CACvE,EACJ,CAAC;AACL"}
@@ -0,0 +1,8 @@
1
+ import { StorageService } from "./Storage.js";
2
+ //#region src/helpers/InMemoryStorageService.d.ts
3
+ export default class InMemoryStorageService extends StorageService {
4
+ readonly items: Map<string, string>;
5
+ protected get storage(): Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
6
+ }
7
+ //#endregion
8
+ //# sourceMappingURL=InMemoryStorageService.d.ts.map
@@ -0,0 +1,16 @@
1
+ import { StorageService } from "./Storage.js";
2
+ //#region src/helpers/InMemoryStorageService.ts
3
+ var InMemoryStorageService = class extends StorageService {
4
+ items = /* @__PURE__ */ new Map();
5
+ get storage() {
6
+ return {
7
+ getItem: (key) => this.items.get(key) ?? null,
8
+ setItem: (key, value) => void this.items.set(key, value),
9
+ removeItem: (key) => void this.items.delete(key)
10
+ };
11
+ }
12
+ };
13
+ //#endregion
14
+ export { InMemoryStorageService as default };
15
+
16
+ //# sourceMappingURL=InMemoryStorageService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"InMemoryStorageService.js","names":[],"sources":["../../src/helpers/InMemoryStorageService.ts"],"sourcesContent":["import { StorageService } from '@noeldemartin/utils/helpers/Storage';\n\nexport default class InMemoryStorageService extends StorageService {\n public readonly items = new Map<string, string>();\n\n protected override get storage(): Pick<Storage, 'getItem' | 'setItem' | 'removeItem'> {\n return {\n getItem: (key) => this.items.get(key) ?? null,\n setItem: (key, value) => void this.items.set(key, value),\n removeItem: (key) => void this.items.delete(key),\n };\n }\n}\n"],"mappings":";;AAEA,IAAqB,yBAArB,cAAoD,eAAe;CAC/D,wBAAwB,IAAI,IAAoB;CAEhD,IAAuB,UAA+D;EAClF,OAAO;GACH,UAAU,QAAQ,KAAK,MAAM,IAAI,GAAG,KAAK;GACzC,UAAU,KAAK,UAAU,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK;GACvD,aAAa,QAAQ,KAAK,KAAK,MAAM,OAAO,GAAG;EACnD;CACJ;AACJ"}
@@ -0,0 +1,17 @@
1
+ //#region src/helpers/IndexedDBMap.d.ts
2
+ export default class IndexedDBMap<TItem> {
3
+ private db;
4
+ private namespace;
5
+ constructor(namespace: string);
6
+ has(key: string): Promise<boolean>;
7
+ get(key: string): Promise<TItem | undefined>;
8
+ require(key: string): Promise<TItem>;
9
+ set(key: string, value: TItem): Promise<void>;
10
+ delete(key: string): Promise<void>;
11
+ clear(): Promise<void>;
12
+ close(): void;
13
+ private getConnection;
14
+ private connect;
15
+ }
16
+ //#endregion
17
+ //# sourceMappingURL=IndexedDBMap.d.ts.map
@@ -0,0 +1,52 @@
1
+ import { fail } from "./error_helpers.js";
2
+ import { openDB } from "idb";
3
+ //#region src/helpers/IndexedDBMap.ts
4
+ const ITEMS_COLLECTION = "items";
5
+ var IndexedDBMap = class {
6
+ db = null;
7
+ namespace;
8
+ constructor(namespace) {
9
+ this.namespace = namespace;
10
+ }
11
+ async has(key) {
12
+ return await (await this.getConnection()).get(ITEMS_COLLECTION, key) !== void 0;
13
+ }
14
+ async get(key) {
15
+ return (await this.getConnection()).get(ITEMS_COLLECTION, key);
16
+ }
17
+ async require(key) {
18
+ return await this.get(key) ?? fail(`Missing required '${key}' IndexedDBMap value`);
19
+ }
20
+ async set(key, value) {
21
+ await (await this.getConnection()).put(ITEMS_COLLECTION, value, key);
22
+ }
23
+ async delete(key) {
24
+ await (await this.getConnection()).delete(ITEMS_COLLECTION, key);
25
+ }
26
+ async clear() {
27
+ await (await this.getConnection()).clear(ITEMS_COLLECTION);
28
+ }
29
+ close() {
30
+ if (!this.db) return;
31
+ this.db.close();
32
+ this.db = null;
33
+ }
34
+ async getConnection() {
35
+ this.db = this.db ?? await this.connect();
36
+ return this.db;
37
+ }
38
+ async connect() {
39
+ const databaseName = `${this.namespace}-map`;
40
+ return await openDB(databaseName, 1, {
41
+ upgrade(database) {
42
+ if (database.objectStoreNames.contains(ITEMS_COLLECTION)) return;
43
+ database.createObjectStore(ITEMS_COLLECTION);
44
+ },
45
+ blocked: () => fail(`Could not open '${databaseName}' IndexedDB`)
46
+ });
47
+ }
48
+ };
49
+ //#endregion
50
+ export { IndexedDBMap as default };
51
+
52
+ //# sourceMappingURL=IndexedDBMap.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IndexedDBMap.js","names":[],"sources":["../../src/helpers/IndexedDBMap.ts"],"sourcesContent":["import { fail } from '@noeldemartin/utils/helpers/error_helpers';\nimport { openDB } from 'idb';\nimport type { DBSchema, IDBPDatabase } from 'idb';\n\nconst ITEMS_COLLECTION = 'items';\n\ninterface DatabaseSchema<T> extends DBSchema {\n items: {\n key: string;\n value: T;\n };\n}\n\nexport default class IndexedDBMap<TItem> {\n private db: IDBPDatabase<DatabaseSchema<TItem>> | null = null;\n private namespace: string;\n\n constructor(namespace: string) {\n this.namespace = namespace;\n }\n\n public async has(key: string): Promise<boolean> {\n const db = await this.getConnection();\n const value = await db.get(ITEMS_COLLECTION, key);\n\n return value !== undefined;\n }\n\n public async get(key: string): Promise<TItem | undefined> {\n const db = await this.getConnection();\n\n return db.get(ITEMS_COLLECTION, key);\n }\n\n public async require(key: string): Promise<TItem> {\n const value = await this.get(key);\n\n return value ?? fail(`Missing required '${key}' IndexedDBMap value`);\n }\n\n public async set(key: string, value: TItem): Promise<void> {\n const db = await this.getConnection();\n\n await db.put(ITEMS_COLLECTION, value, key);\n }\n\n public async delete(key: string): Promise<void> {\n const db = await this.getConnection();\n\n await db.delete(ITEMS_COLLECTION, key);\n }\n\n public async clear(): Promise<void> {\n const db = await this.getConnection();\n\n await db.clear(ITEMS_COLLECTION);\n }\n\n public close(): void {\n if (!this.db) {\n return;\n }\n\n this.db.close();\n\n this.db = null;\n }\n\n private async getConnection(): Promise<IDBPDatabase<DatabaseSchema<TItem>>> {\n this.db = this.db ?? (await this.connect());\n\n return this.db;\n }\n\n private async connect(): Promise<IDBPDatabase<DatabaseSchema<TItem>>> {\n const databaseName = `${this.namespace}-map`;\n const db = await openDB<DatabaseSchema<TItem>>(databaseName, 1, {\n upgrade(database) {\n if (database.objectStoreNames.contains(ITEMS_COLLECTION)) {\n return;\n }\n\n database.createObjectStore(ITEMS_COLLECTION);\n },\n blocked: () => fail(`Could not open '${databaseName}' IndexedDB`),\n });\n\n return db;\n }\n}\n"],"mappings":";;;AAIA,MAAM,mBAAmB;AASzB,IAAqB,eAArB,MAAyC;CACrC,KAAyD;CACzD;CAEA,YAAY,WAAmB;EAC3B,KAAK,YAAY;CACrB;CAEA,MAAa,IAAI,KAA+B;EAI5C,OAAO,OAFa,MADH,KAAK,cAAc,EAAA,CACb,IAAI,kBAAkB,GAAG,MAE/B,KAAA;CACrB;CAEA,MAAa,IAAI,KAAyC;EAGtD,QAAO,MAFU,KAAK,cAAc,EAAA,CAE1B,IAAI,kBAAkB,GAAG;CACvC;CAEA,MAAa,QAAQ,KAA6B;EAG9C,OAAO,MAFa,KAAK,IAAI,GAAG,KAEhB,KAAK,qBAAqB,IAAI,qBAAqB;CACvE;CAEA,MAAa,IAAI,KAAa,OAA6B;EAGvD,OAAM,MAFW,KAAK,cAAc,EAAA,CAE3B,IAAI,kBAAkB,OAAO,GAAG;CAC7C;CAEA,MAAa,OAAO,KAA4B;EAG5C,OAAM,MAFW,KAAK,cAAc,EAAA,CAE3B,OAAO,kBAAkB,GAAG;CACzC;CAEA,MAAa,QAAuB;EAGhC,OAAM,MAFW,KAAK,cAAc,EAAA,CAE3B,MAAM,gBAAgB;CACnC;CAEA,QAAqB;EACjB,IAAI,CAAC,KAAK,IACN;EAGJ,KAAK,GAAG,MAAM;EAEd,KAAK,KAAK;CACd;CAEA,MAAc,gBAA8D;EACxE,KAAK,KAAK,KAAK,MAAO,MAAM,KAAK,QAAQ;EAEzC,OAAO,KAAK;CAChB;CAEA,MAAc,UAAwD;EAClE,MAAM,eAAe,GAAG,KAAK,UAAU;EAYvC,OAAO,MAXU,OAA8B,cAAc,GAAG;GAC5D,QAAQ,UAAU;IACd,IAAI,SAAS,iBAAiB,SAAS,gBAAgB,GACnD;IAGJ,SAAS,kBAAkB,gBAAgB;GAC/C;GACA,eAAe,KAAK,mBAAmB,aAAa,YAAY;EACpE,CAAC;CAGL;AACJ"}
@@ -0,0 +1,14 @@
1
+ //#region src/helpers/JSError.d.ts
2
+ export declare const RuntimeErrorClass: ErrorConstructor;
3
+ export interface JSErrorOptions {
4
+ cause?: unknown;
5
+ }
6
+ export default class JSError extends RuntimeErrorClass {
7
+ name: string;
8
+ message: string;
9
+ stack?: string;
10
+ cause?: unknown;
11
+ constructor(message?: string, options?: JSErrorOptions);
12
+ }
13
+ //#endregion
14
+ //# sourceMappingURL=JSError.d.ts.map
@@ -0,0 +1,14 @@
1
+ import { runtimeGlobal } from "./runtime_helpers.js";
2
+ //#region src/helpers/JSError.ts
3
+ const RuntimeErrorClass = runtimeGlobal().Error;
4
+ var JSError = class extends RuntimeErrorClass {
5
+ constructor(message, options) {
6
+ super(...[message, options]);
7
+ this.name = new.target.name === "JSError" ? "Error" : new.target.name;
8
+ Object.setPrototypeOf(this, new.target.prototype);
9
+ }
10
+ };
11
+ //#endregion
12
+ export { RuntimeErrorClass, JSError as default };
13
+
14
+ //# sourceMappingURL=JSError.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"JSError.js","names":[],"sources":["../../src/helpers/JSError.ts"],"sourcesContent":["import { runtimeGlobal } from '@noeldemartin/utils/helpers/runtime_helpers';\nimport type { ClosureArgs } from '@noeldemartin/utils/types';\n\nexport const RuntimeErrorClass = runtimeGlobal<typeof globalThis>().Error;\n\nexport interface JSErrorOptions {\n cause?: unknown;\n}\n\nexport default class JSError extends RuntimeErrorClass {\n declare public name: string;\n declare public message: string;\n declare public stack?: string;\n declare public cause?: unknown;\n\n constructor(message?: string, options?: JSErrorOptions) {\n super(...([message, options] as ClosureArgs));\n\n // Fix inheritance: https://stackoverflow.com/questions/41102060/typescript-extending-error-class\n this.name = new.target.name === 'JSError' ? 'Error' : new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n"],"mappings":";;AAGA,MAAa,oBAAoB,cAAiC,CAAC,CAAC;AAMpE,IAAqB,UAArB,cAAqC,kBAAkB;CAMnD,YAAY,SAAkB,SAA0B;EACpD,MAAM,GAAI,CAAC,SAAS,OAAO,CAAiB;EAG5C,KAAK,OAAO,WAAW,SAAS,YAAY,UAAU,WAAW;EACjE,OAAO,eAAe,MAAM,WAAW,SAAS;CACpD;AACJ"}
@@ -0,0 +1,15 @@
1
+ //#region src/helpers/ListenersManager.d.ts
2
+ export type ListenerEvents<TListener extends object> = Required<{ [K in keyof TListener]: NonNullable<TListener[K]> extends ((...args: any[]) => any) ? K : never; }>[keyof TListener];
3
+ export type ListenerPayload<TListener extends object, TEvent extends keyof TListener> = Required<{ [K in keyof TListener]: NonNullable<TListener[K]> extends ((...args: infer TPayload) => any) ? TPayload : never; }>[TEvent];
4
+ export interface Listeners<Listener extends object> {
5
+ add(listener: Listener): () => void;
6
+ remove(listener: Listener): void;
7
+ }
8
+ export default class ListenersManager<Listener extends object> implements Listeners<Listener> {
9
+ private listeners;
10
+ add(listener: Listener): () => void;
11
+ remove(listener: Listener): void;
12
+ emit<Event extends ListenerEvents<Listener>>(event: Event, ...payload: ListenerPayload<Listener, Event>): Promise<void>;
13
+ }
14
+ //#endregion
15
+ //# sourceMappingURL=ListenersManager.d.ts.map
@@ -0,0 +1,23 @@
1
+ import { arrayRemove } from "./array_helpers.js";
2
+ //#region src/helpers/ListenersManager.ts
3
+ var ListenersManager = class {
4
+ listeners = [];
5
+ add(listener) {
6
+ this.listeners.push(listener);
7
+ return () => this.remove(listener);
8
+ }
9
+ remove(listener) {
10
+ arrayRemove(this.listeners, listener);
11
+ }
12
+ async emit(event, ...payload) {
13
+ for (const listener of this.listeners) {
14
+ const callback = listener[event];
15
+ if (typeof callback !== "function") continue;
16
+ await callback?.call(listener, ...payload);
17
+ }
18
+ }
19
+ };
20
+ //#endregion
21
+ export { ListenersManager as default };
22
+
23
+ //# sourceMappingURL=ListenersManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ListenersManager.js","names":[],"sources":["../../src/helpers/ListenersManager.ts"],"sourcesContent":["import { arrayRemove } from './array_helpers';\n\nexport type ListenerEvents<TListener extends object> = Required<{\n // oxlint-disable-next-line typescript/no-explicit-any\n [K in keyof TListener]: NonNullable<TListener[K]> extends (...args: any[]) => any ? K : never;\n}>[keyof TListener];\n\nexport type ListenerPayload<TListener extends object, TEvent extends keyof TListener> = Required<{\n // oxlint-disable-next-line typescript/no-explicit-any\n [K in keyof TListener]: NonNullable<TListener[K]> extends (...args: infer TPayload) => any ? TPayload : never;\n}>[TEvent];\n\nexport interface Listeners<Listener extends object> {\n add(listener: Listener): () => void;\n remove(listener: Listener): void;\n}\n\nexport default class ListenersManager<Listener extends object> implements Listeners<Listener> {\n private listeners: Listener[] = [];\n\n public add(listener: Listener): () => void {\n this.listeners.push(listener);\n\n return () => this.remove(listener);\n }\n\n public remove(listener: Listener): void {\n arrayRemove(this.listeners, listener);\n }\n\n public async emit<Event extends ListenerEvents<Listener>>(\n event: Event,\n ...payload: ListenerPayload<Listener, Event>\n ): Promise<void> {\n for (const listener of this.listeners) {\n const callback = listener[event];\n\n if (typeof callback !== 'function') {\n continue;\n }\n\n await callback?.call(listener, ...payload);\n }\n }\n}\n"],"mappings":";;AAiBA,IAAqB,mBAArB,MAA8F;CAC1F,YAAgC,CAAC;CAEjC,IAAW,UAAgC;EACvC,KAAK,UAAU,KAAK,QAAQ;EAE5B,aAAa,KAAK,OAAO,QAAQ;CACrC;CAEA,OAAc,UAA0B;EACpC,YAAY,KAAK,WAAW,QAAQ;CACxC;CAEA,MAAa,KACT,OACA,GAAG,SACU;EACb,KAAK,MAAM,YAAY,KAAK,WAAW;GACnC,MAAM,WAAW,SAAS;GAE1B,IAAI,OAAO,aAAa,YACpB;GAGJ,MAAM,UAAU,KAAK,UAAU,GAAG,OAAO;EAC7C;CACJ;AACJ"}
@@ -0,0 +1,29 @@
1
+ import { ClosureArgs } from "../types/helpers.js";
2
+ import { Constructor } from "../types/classes.js";
3
+ //#region src/helpers/MagicObject.d.ts
4
+ export interface MagicObjectProxy<T> {
5
+ target: T;
6
+ instance: T;
7
+ }
8
+ export type MagicObjectConstructor<T extends MagicObject = MagicObject> = Constructor<T> & typeof MagicObject;
9
+ export default class MagicObject {
10
+ private static __conjuring;
11
+ private static __reservedProperties;
12
+ protected static isConjuring(): boolean;
13
+ private static isMagicReady;
14
+ private static prepareMagic;
15
+ protected static isReservedProperty(property: string): boolean;
16
+ protected _proxy: MagicObjectProxy<this>;
17
+ constructor(...args: ClosureArgs);
18
+ static<T extends typeof MagicObject>(): T;
19
+ static<T extends typeof MagicObject, K extends keyof T>(property: K): T[K];
20
+ protected reserveProperty(property: string): void;
21
+ protected initialize(...args: ClosureArgs): void;
22
+ protected __get(property: string): unknown;
23
+ protected __set(property: string, value: unknown): void;
24
+ protected __delete(property: string): void;
25
+ protected __has(property: string): boolean;
26
+ protected createProxy(): MagicObjectProxy<this>;
27
+ }
28
+ //#endregion
29
+ //# sourceMappingURL=MagicObject.d.ts.map
@@ -0,0 +1,77 @@
1
+ //#region src/helpers/MagicObject.ts
2
+ var MagicObject = class {
3
+ static __conjuring;
4
+ static __reservedProperties = /* @__PURE__ */ new WeakMap();
5
+ static isConjuring() {
6
+ return this.__conjuring;
7
+ }
8
+ static isMagicReady() {
9
+ return this.__reservedProperties.has(this);
10
+ }
11
+ static prepareMagic() {
12
+ this.__conjuring = true;
13
+ this.__reservedProperties.set(this, new Set(Object.getOwnPropertyNames(new this())));
14
+ this.__conjuring = false;
15
+ }
16
+ static isReservedProperty(property) {
17
+ return !!this.__reservedProperties.get(this)?.has(property);
18
+ }
19
+ constructor(...args) {
20
+ if (this.static().isConjuring()) return;
21
+ if (!this.static().isMagicReady()) this.static().prepareMagic();
22
+ this._proxy = this.createProxy();
23
+ this.initialize(...args);
24
+ return this._proxy.instance;
25
+ }
26
+ static(property) {
27
+ const constructor = this.constructor;
28
+ if (!property) return constructor;
29
+ return constructor[property];
30
+ }
31
+ reserveProperty(property) {
32
+ Object.assign(this, { [property]: null });
33
+ }
34
+ initialize(...args) {}
35
+ __get(property) {
36
+ return Reflect.get(this._proxy.target, property);
37
+ }
38
+ __set(property, value) {
39
+ Reflect.set(this._proxy.target, property, value);
40
+ }
41
+ __delete(property) {
42
+ Reflect.deleteProperty(this._proxy.target, property);
43
+ }
44
+ __has(property) {
45
+ return Reflect.has(this._proxy.target, property);
46
+ }
47
+ createProxy() {
48
+ const Static = this.static();
49
+ return {
50
+ target: this,
51
+ instance: new Proxy(this, {
52
+ get(target, property, receiver) {
53
+ if (typeof property !== "string" || property in target || Static.isReservedProperty(property)) return Reflect.get(target, property, receiver);
54
+ return target.__get(property);
55
+ },
56
+ set(target, property, value, receiver) {
57
+ if (typeof property !== "string" || property in target || Static.isReservedProperty(property)) return Reflect.set(target, property, value, receiver);
58
+ target.__set(property, value);
59
+ return true;
60
+ },
61
+ has(target, property) {
62
+ if (typeof property !== "string" || property in target || Static.isReservedProperty(property)) return Reflect.has(target, property);
63
+ return target.__has(property);
64
+ },
65
+ deleteProperty(target, property) {
66
+ if (typeof property !== "string" || property in target || Static.isReservedProperty(property)) return Reflect.deleteProperty(target, property);
67
+ target.__delete(property);
68
+ return true;
69
+ }
70
+ })
71
+ };
72
+ }
73
+ };
74
+ //#endregion
75
+ export { MagicObject as default };
76
+
77
+ //# sourceMappingURL=MagicObject.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MagicObject.js","names":[],"sources":["../../src/helpers/MagicObject.ts"],"sourcesContent":["import type { Constructor } from '../types/classes';\nimport type { ClosureArgs } from '../types/helpers';\n\nexport interface MagicObjectProxy<T> {\n target: T;\n instance: T;\n}\n\nexport type MagicObjectConstructor<T extends MagicObject = MagicObject> = Constructor<T> & typeof MagicObject;\n\nexport default class MagicObject {\n private static __conjuring: boolean;\n private static __reservedProperties: WeakMap<typeof MagicObject, Set<string>> = new WeakMap();\n\n protected static isConjuring(): boolean {\n return this.__conjuring;\n }\n\n private static isMagicReady(): boolean {\n return this.__reservedProperties.has(this);\n }\n\n private static prepareMagic(): void {\n this.__conjuring = true;\n this.__reservedProperties.set(this, new Set(Object.getOwnPropertyNames(new this())));\n this.__conjuring = false;\n }\n\n protected static isReservedProperty(property: string): boolean {\n return !!this.__reservedProperties.get(this)?.has(property);\n }\n\n declare protected _proxy: MagicObjectProxy<this>;\n\n constructor(...args: ClosureArgs) {\n if (this.static().isConjuring()) {\n return;\n }\n\n if (!this.static().isMagicReady()) {\n this.static().prepareMagic();\n }\n\n this._proxy = this.createProxy();\n\n this.initialize(...args);\n\n return this._proxy.instance;\n }\n\n public static<T extends typeof MagicObject>(): T;\n public static<T extends typeof MagicObject, K extends keyof T>(property: K): T[K];\n public static<T extends typeof MagicObject, K extends keyof T>(property?: K): T | T[K] {\n const constructor = this.constructor as T;\n\n if (!property) {\n return constructor;\n }\n\n return constructor[property];\n }\n\n protected reserveProperty(property: string): void {\n Object.assign(this, { [property]: null });\n }\n\n // oxlint-disable-next-line typescript/no-unused-vars\n protected initialize(...args: ClosureArgs): void {\n //\n }\n\n protected __get(property: string): unknown {\n return Reflect.get(this._proxy.target, property);\n }\n\n protected __set(property: string, value: unknown): void {\n Reflect.set(this._proxy.target, property, value);\n }\n\n protected __delete(property: string): void {\n Reflect.deleteProperty(this._proxy.target, property);\n }\n\n protected __has(property: string): boolean {\n return Reflect.has(this._proxy.target, property);\n }\n\n protected createProxy(): MagicObjectProxy<this> {\n const Static = this.static();\n\n return {\n target: this,\n instance: new Proxy(this, {\n get(target, property, receiver) {\n if (typeof property !== 'string' || property in target || Static.isReservedProperty(property)) {\n return Reflect.get(target, property, receiver);\n }\n\n return target.__get(property);\n },\n set(target, property, value, receiver) {\n if (typeof property !== 'string' || property in target || Static.isReservedProperty(property)) {\n return Reflect.set(target, property, value, receiver);\n }\n\n target.__set(property, value);\n\n return true;\n },\n has(target, property) {\n if (typeof property !== 'string' || property in target || Static.isReservedProperty(property)) {\n return Reflect.has(target, property);\n }\n\n return target.__has(property);\n },\n deleteProperty(target, property) {\n if (typeof property !== 'string' || property in target || Static.isReservedProperty(property)) {\n return Reflect.deleteProperty(target, property);\n }\n\n target.__delete(property);\n\n return true;\n },\n }),\n };\n }\n}\n"],"mappings":";AAUA,IAAqB,cAArB,MAAiC;CAC7B,OAAe;CACf,OAAe,uCAAiE,IAAI,QAAQ;CAE5F,OAAiB,cAAuB;EACpC,OAAO,KAAK;CAChB;CAEA,OAAe,eAAwB;EACnC,OAAO,KAAK,qBAAqB,IAAI,IAAI;CAC7C;CAEA,OAAe,eAAqB;EAChC,KAAK,cAAc;EACnB,KAAK,qBAAqB,IAAI,MAAM,IAAI,IAAI,OAAO,oBAAoB,IAAI,KAAK,CAAC,CAAC,CAAC;EACnF,KAAK,cAAc;CACvB;CAEA,OAAiB,mBAAmB,UAA2B;EAC3D,OAAO,CAAC,CAAC,KAAK,qBAAqB,IAAI,IAAI,CAAC,EAAE,IAAI,QAAQ;CAC9D;CAIA,YAAY,GAAG,MAAmB;EAC9B,IAAI,KAAK,OAAO,CAAC,CAAC,YAAY,GAC1B;EAGJ,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,aAAa,GAC5B,KAAK,OAAO,CAAC,CAAC,aAAa;EAG/B,KAAK,SAAS,KAAK,YAAY;EAE/B,KAAK,WAAW,GAAG,IAAI;EAEvB,OAAO,KAAK,OAAO;CACvB;CAIA,OAA+D,UAAwB;EACnF,MAAM,cAAc,KAAK;EAEzB,IAAI,CAAC,UACD,OAAO;EAGX,OAAO,YAAY;CACvB;CAEA,gBAA0B,UAAwB;EAC9C,OAAO,OAAO,MAAM,GAAG,WAAW,KAAK,CAAC;CAC5C;CAGA,WAAqB,GAAG,MAAyB,CAEjD;CAEA,MAAgB,UAA2B;EACvC,OAAO,QAAQ,IAAI,KAAK,OAAO,QAAQ,QAAQ;CACnD;CAEA,MAAgB,UAAkB,OAAsB;EACpD,QAAQ,IAAI,KAAK,OAAO,QAAQ,UAAU,KAAK;CACnD;CAEA,SAAmB,UAAwB;EACvC,QAAQ,eAAe,KAAK,OAAO,QAAQ,QAAQ;CACvD;CAEA,MAAgB,UAA2B;EACvC,OAAO,QAAQ,IAAI,KAAK,OAAO,QAAQ,QAAQ;CACnD;CAEA,cAAgD;EAC5C,MAAM,SAAS,KAAK,OAAO;EAE3B,OAAO;GACH,QAAQ;GACR,UAAU,IAAI,MAAM,MAAM;IACtB,IAAI,QAAQ,UAAU,UAAU;KAC5B,IAAI,OAAO,aAAa,YAAY,YAAY,UAAU,OAAO,mBAAmB,QAAQ,GACxF,OAAO,QAAQ,IAAI,QAAQ,UAAU,QAAQ;KAGjD,OAAO,OAAO,MAAM,QAAQ;IAChC;IACA,IAAI,QAAQ,UAAU,OAAO,UAAU;KACnC,IAAI,OAAO,aAAa,YAAY,YAAY,UAAU,OAAO,mBAAmB,QAAQ,GACxF,OAAO,QAAQ,IAAI,QAAQ,UAAU,OAAO,QAAQ;KAGxD,OAAO,MAAM,UAAU,KAAK;KAE5B,OAAO;IACX;IACA,IAAI,QAAQ,UAAU;KAClB,IAAI,OAAO,aAAa,YAAY,YAAY,UAAU,OAAO,mBAAmB,QAAQ,GACxF,OAAO,QAAQ,IAAI,QAAQ,QAAQ;KAGvC,OAAO,OAAO,MAAM,QAAQ;IAChC;IACA,eAAe,QAAQ,UAAU;KAC7B,IAAI,OAAO,aAAa,YAAY,YAAY,UAAU,OAAO,mBAAmB,QAAQ,GACxF,OAAO,QAAQ,eAAe,QAAQ,QAAQ;KAGlD,OAAO,SAAS,QAAQ;KAExB,OAAO;IACX;GACJ,CAAC;EACL;CACJ;AACJ"}
@@ -0,0 +1,28 @@
1
+ //#region src/helpers/ObjectsMap.d.ts
2
+ export type ObjectKeyExtractor<T> = (item: T) => string;
3
+ export default class ObjectsMap<Item extends object> {
4
+ static createFromArray<T extends object>(items: Iterable<T>, keyExtractor?: ObjectKeyExtractor<T>): ObjectsMap<T>;
5
+ static createFromArray<T extends object, S extends keyof T>(items: Iterable<T>, key: S): ObjectsMap<T>;
6
+ private keysToItems;
7
+ private itemsToKeys;
8
+ private getKey;
9
+ constructor(keyExtractor?: ObjectKeyExtractor<Item>);
10
+ [Symbol.iterator](): Iterator<[string, Item]>;
11
+ get size(): number;
12
+ items(): IterableIterator<Item>;
13
+ keys(): IterableIterator<string>;
14
+ entries(): IterableIterator<[string, Item]>;
15
+ add(item: Item): void;
16
+ require(key: string): Item;
17
+ get(key: string): Item | undefined;
18
+ getKeys(): string[];
19
+ getItems(): Item[];
20
+ hasKey(key: string): boolean;
21
+ hasItem(item: Item): boolean;
22
+ delete(item: Item): void;
23
+ filter(condition: (item: Item, key: string) => boolean): this;
24
+ clear(): void;
25
+ clone<T extends ObjectsMap<Item>>(this: T): T;
26
+ }
27
+ //#endregion
28
+ //# sourceMappingURL=ObjectsMap.d.ts.map
@@ -0,0 +1,86 @@
1
+ import { fail } from "./error_helpers.js";
2
+ import { toString } from "./object_helpers.js";
3
+ //#region src/helpers/ObjectsMap.ts
4
+ var ObjectsMap = class ObjectsMap {
5
+ static createFromArray(items, key) {
6
+ const map = new ObjectsMap(typeof key === "string" ? (item) => item[key] : key);
7
+ for (const item of items) map.add(item);
8
+ return map;
9
+ }
10
+ keysToItems;
11
+ itemsToKeys;
12
+ getKey;
13
+ constructor(keyExtractor) {
14
+ this.keysToItems = /* @__PURE__ */ new Map();
15
+ this.itemsToKeys = /* @__PURE__ */ new WeakMap();
16
+ this.getKey = keyExtractor ?? ((item) => toString(item));
17
+ }
18
+ *[Symbol.iterator]() {
19
+ yield* this.keysToItems;
20
+ }
21
+ get size() {
22
+ return this.keysToItems.size;
23
+ }
24
+ items() {
25
+ return this.keysToItems.values();
26
+ }
27
+ keys() {
28
+ return this.keysToItems.keys();
29
+ }
30
+ entries() {
31
+ return this.keysToItems.entries();
32
+ }
33
+ add(item) {
34
+ const key = this.getKey(item);
35
+ this.keysToItems.set(key, item);
36
+ this.itemsToKeys.set(item, key);
37
+ }
38
+ require(key) {
39
+ return this.keysToItems.get(key) ?? fail(`Couldn't find item with '${key}' key`);
40
+ }
41
+ get(key) {
42
+ return this.keysToItems.get(key);
43
+ }
44
+ getKeys() {
45
+ return [...this.keysToItems.keys()];
46
+ }
47
+ getItems() {
48
+ return [...this.keysToItems.values()];
49
+ }
50
+ hasKey(key) {
51
+ return this.keysToItems.has(key);
52
+ }
53
+ hasItem(item) {
54
+ return this.itemsToKeys.has(item);
55
+ }
56
+ delete(item) {
57
+ const key = this.itemsToKeys.get(item);
58
+ if (!key) return;
59
+ this.itemsToKeys.delete(item);
60
+ this.keysToItems.delete(key);
61
+ }
62
+ filter(condition) {
63
+ const filteredMap = this.constructor.createFromArray([], this.getKey);
64
+ for (const [key, item] of this.entries()) {
65
+ if (!condition(item, key)) continue;
66
+ filteredMap.add(item);
67
+ }
68
+ return filteredMap;
69
+ }
70
+ clear() {
71
+ this.itemsToKeys = /* @__PURE__ */ new WeakMap();
72
+ this.keysToItems.clear();
73
+ }
74
+ clone() {
75
+ const ThisConstructor = this.constructor;
76
+ const copy = new ThisConstructor(this.getKey);
77
+ copy.keysToItems = new Map(this.keysToItems);
78
+ copy.itemsToKeys = /* @__PURE__ */ new WeakMap();
79
+ for (const [key, item] of copy.keysToItems.entries()) copy.itemsToKeys.set(item, key);
80
+ return copy;
81
+ }
82
+ };
83
+ //#endregion
84
+ export { ObjectsMap as default };
85
+
86
+ //# sourceMappingURL=ObjectsMap.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ObjectsMap.js","names":[],"sources":["../../src/helpers/ObjectsMap.ts"],"sourcesContent":["import { fail } from '@noeldemartin/utils/helpers/error_helpers';\n\nimport { toString } from './object_helpers';\n\nexport type ObjectKeyExtractor<T> = (item: T) => string;\n\nexport default class ObjectsMap<Item extends object> {\n public static createFromArray<T extends object>(\n items: Iterable<T>,\n keyExtractor?: ObjectKeyExtractor<T>,\n ): ObjectsMap<T>;\n\n public static createFromArray<T extends object, S extends keyof T>(items: Iterable<T>, key: S): ObjectsMap<T>;\n\n public static createFromArray<T extends object, S extends keyof T>(\n items: Iterable<T>,\n key?: S | ObjectKeyExtractor<T>,\n ): ObjectsMap<T> {\n const keyExtractor = typeof key === 'string' ? (item: T) => item[key] : key;\n\n const map = new ObjectsMap(keyExtractor as ObjectKeyExtractor<T>);\n\n for (const item of items) {\n map.add(item);\n }\n\n return map;\n }\n\n private keysToItems: Map<string, Item>;\n private itemsToKeys: WeakMap<Item, string>;\n private getKey: (item: Item) => string;\n\n constructor(keyExtractor?: ObjectKeyExtractor<Item>) {\n this.keysToItems = new Map();\n this.itemsToKeys = new WeakMap();\n this.getKey = keyExtractor ?? ((item) => toString(item));\n }\n\n public *[Symbol.iterator](): Iterator<[string, Item]> {\n yield* this.keysToItems;\n }\n\n public get size(): number {\n return this.keysToItems.size;\n }\n\n public items(): IterableIterator<Item> {\n return this.keysToItems.values();\n }\n\n public keys(): IterableIterator<string> {\n return this.keysToItems.keys();\n }\n\n public entries(): IterableIterator<[string, Item]> {\n return this.keysToItems.entries();\n }\n\n public add(item: Item): void {\n const key = this.getKey(item);\n\n this.keysToItems.set(key, item);\n this.itemsToKeys.set(item, key);\n }\n\n public require(key: string): Item {\n return this.keysToItems.get(key) ?? fail(`Couldn't find item with '${key}' key`);\n }\n\n public get(key: string): Item | undefined {\n return this.keysToItems.get(key);\n }\n\n public getKeys(): string[] {\n return [...this.keysToItems.keys()];\n }\n\n public getItems(): Item[] {\n return [...this.keysToItems.values()];\n }\n\n public hasKey(key: string): boolean {\n return this.keysToItems.has(key);\n }\n\n public hasItem(item: Item): boolean {\n return this.itemsToKeys.has(item);\n }\n\n public delete(item: Item): void {\n const key = this.itemsToKeys.get(item);\n\n if (!key) return;\n\n this.itemsToKeys.delete(item);\n this.keysToItems.delete(key);\n }\n\n public filter(condition: (item: Item, key: string) => boolean): this {\n const filteredMap = (this.constructor as typeof ObjectsMap).createFromArray([], this.getKey);\n\n for (const [key, item] of this.entries()) {\n if (!condition(item, key)) {\n continue;\n }\n\n filteredMap.add(item);\n }\n\n return filteredMap as this;\n }\n\n public clear(): void {\n this.itemsToKeys = new WeakMap();\n this.keysToItems.clear();\n }\n\n public clone<T extends ObjectsMap<Item>>(this: T): T {\n const ThisConstructor = this.constructor as { new (keyExtractor: (item: Item) => string): T };\n const copy = new ThisConstructor(this.getKey);\n\n copy.keysToItems = new Map(this.keysToItems);\n copy.itemsToKeys = new WeakMap();\n\n for (const [key, item] of copy.keysToItems.entries()) {\n copy.itemsToKeys.set(item, key);\n }\n\n return copy;\n }\n}\n"],"mappings":";;;AAMA,IAAqB,aAArB,MAAqB,WAAgC;CAQjD,OAAc,gBACV,OACA,KACa;EAGb,MAAM,MAAM,IAAI,WAFK,OAAO,QAAQ,YAAY,SAAY,KAAK,OAAO,GAER;EAEhE,KAAK,MAAM,QAAQ,OACf,IAAI,IAAI,IAAI;EAGhB,OAAO;CACX;CAEA;CACA;CACA;CAEA,YAAY,cAAyC;EACjD,KAAK,8BAAc,IAAI,IAAI;EAC3B,KAAK,8BAAc,IAAI,QAAQ;EAC/B,KAAK,SAAS,kBAAkB,SAAS,SAAS,IAAI;CAC1D;CAEA,EAAS,OAAO,YAAsC;EAClD,OAAO,KAAK;CAChB;CAEA,IAAW,OAAe;EACtB,OAAO,KAAK,YAAY;CAC5B;CAEA,QAAuC;EACnC,OAAO,KAAK,YAAY,OAAO;CACnC;CAEA,OAAwC;EACpC,OAAO,KAAK,YAAY,KAAK;CACjC;CAEA,UAAmD;EAC/C,OAAO,KAAK,YAAY,QAAQ;CACpC;CAEA,IAAW,MAAkB;EACzB,MAAM,MAAM,KAAK,OAAO,IAAI;EAE5B,KAAK,YAAY,IAAI,KAAK,IAAI;EAC9B,KAAK,YAAY,IAAI,MAAM,GAAG;CAClC;CAEA,QAAe,KAAmB;EAC9B,OAAO,KAAK,YAAY,IAAI,GAAG,KAAK,KAAK,4BAA4B,IAAI,MAAM;CACnF;CAEA,IAAW,KAA+B;EACtC,OAAO,KAAK,YAAY,IAAI,GAAG;CACnC;CAEA,UAA2B;EACvB,OAAO,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC;CACtC;CAEA,WAA0B;EACtB,OAAO,CAAC,GAAG,KAAK,YAAY,OAAO,CAAC;CACxC;CAEA,OAAc,KAAsB;EAChC,OAAO,KAAK,YAAY,IAAI,GAAG;CACnC;CAEA,QAAe,MAAqB;EAChC,OAAO,KAAK,YAAY,IAAI,IAAI;CACpC;CAEA,OAAc,MAAkB;EAC5B,MAAM,MAAM,KAAK,YAAY,IAAI,IAAI;EAErC,IAAI,CAAC,KAAK;EAEV,KAAK,YAAY,OAAO,IAAI;EAC5B,KAAK,YAAY,OAAO,GAAG;CAC/B;CAEA,OAAc,WAAuD;EACjE,MAAM,cAAe,KAAK,YAAkC,gBAAgB,CAAC,GAAG,KAAK,MAAM;EAE3F,KAAK,MAAM,CAAC,KAAK,SAAS,KAAK,QAAQ,GAAG;GACtC,IAAI,CAAC,UAAU,MAAM,GAAG,GACpB;GAGJ,YAAY,IAAI,IAAI;EACxB;EAEA,OAAO;CACX;CAEA,QAAqB;EACjB,KAAK,8BAAc,IAAI,QAAQ;EAC/B,KAAK,YAAY,MAAM;CAC3B;CAEA,QAAqD;EACjD,MAAM,kBAAkB,KAAK;EAC7B,MAAM,OAAO,IAAI,gBAAgB,KAAK,MAAM;EAE5C,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW;EAC3C,KAAK,8BAAc,IAAI,QAAQ;EAE/B,KAAK,MAAM,CAAC,KAAK,SAAS,KAAK,YAAY,QAAQ,GAC/C,KAAK,YAAY,IAAI,MAAM,GAAG;EAGlC,OAAO;CACX;AACJ"}
@@ -0,0 +1,32 @@
1
+ //#region src/helpers/PromisedValue.d.ts
2
+ export type PromisedValueResolveListener<T> = (result: T) => unknown;
3
+ export type PromisedValueRejectListener = (reason?: Error) => unknown;
4
+ export type PromisedValueResetListener = () => unknown;
5
+ export default class PromisedValue<T = unknown> implements Promise<T> {
6
+ static from<T>(promise: Promise<T>): PromisedValue<T>;
7
+ private _value?;
8
+ private promise;
9
+ private _resolve;
10
+ private _reject;
11
+ private resolveListeners;
12
+ private rejectListeners;
13
+ private resetListeners;
14
+ constructor();
15
+ [Symbol.toStringTag]: string;
16
+ get value(): T | null;
17
+ isResolved(): this is {
18
+ value: T;
19
+ };
20
+ then<TResult1 = T, TResult2 = never>(onFulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onRejected?: ((reason: Error) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
21
+ catch<TResult = never>(onRejected?: ((reason: Error) => TResult | PromiseLike<TResult>) | null): Promise<T | TResult>;
22
+ finally(onFinally?: (() => void) | null): Promise<T>;
23
+ resolve(value: T): void;
24
+ reject(reason?: Error): void;
25
+ onResolve(listener: PromisedValueResolveListener<T>): () => void;
26
+ onReject(listener: PromisedValueRejectListener): () => void;
27
+ onReset(listener: PromisedValueResetListener): () => void;
28
+ reset(): void;
29
+ private setPromiseValues;
30
+ }
31
+ //#endregion
32
+ //# sourceMappingURL=PromisedValue.d.ts.map
@@ -0,0 +1,68 @@
1
+ import { arrayRemove } from "./array_helpers.js";
2
+ //#region src/helpers/PromisedValue.ts
3
+ var PromisedValue = class PromisedValue {
4
+ static from(promise) {
5
+ const promisedValue = new PromisedValue();
6
+ promise.then(promisedValue.resolve.bind(promisedValue)).catch(promisedValue.reject.bind(promisedValue));
7
+ return promisedValue;
8
+ }
9
+ resolveListeners = [];
10
+ rejectListeners = [];
11
+ resetListeners = [];
12
+ constructor() {
13
+ this.setPromiseValues();
14
+ }
15
+ get value() {
16
+ return this._value || null;
17
+ }
18
+ isResolved() {
19
+ return "_value" in this;
20
+ }
21
+ then(onFulfilled, onRejected) {
22
+ return this.promise.then(onFulfilled, onRejected);
23
+ }
24
+ catch(onRejected) {
25
+ return this.promise.catch(onRejected);
26
+ }
27
+ finally(onFinally) {
28
+ return this.promise.finally(onFinally);
29
+ }
30
+ resolve(value) {
31
+ if (this.isResolved()) this.reset();
32
+ this._value = value;
33
+ this._resolve(value);
34
+ this.resolveListeners.forEach((listener) => listener(value));
35
+ }
36
+ reject(reason) {
37
+ if (this.isResolved()) this.reset();
38
+ delete this._value;
39
+ this._reject(reason);
40
+ this.rejectListeners.forEach((listener) => listener(reason));
41
+ }
42
+ onResolve(listener) {
43
+ this.resolveListeners.push(listener);
44
+ return () => arrayRemove(this.resolveListeners, listener);
45
+ }
46
+ onReject(listener) {
47
+ this.rejectListeners.push(listener);
48
+ return () => arrayRemove(this.rejectListeners, listener);
49
+ }
50
+ onReset(listener) {
51
+ this.resetListeners.push(listener);
52
+ return () => arrayRemove(this.resetListeners, listener);
53
+ }
54
+ reset() {
55
+ this.setPromiseValues();
56
+ this.resetListeners.forEach((listener) => listener());
57
+ }
58
+ setPromiseValues() {
59
+ this.promise = new Promise((resolve, reject) => {
60
+ this._resolve = resolve;
61
+ this._reject = reject;
62
+ });
63
+ }
64
+ };
65
+ //#endregion
66
+ export { PromisedValue as default };
67
+
68
+ //# sourceMappingURL=PromisedValue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PromisedValue.js","names":[],"sources":["../../src/helpers/PromisedValue.ts"],"sourcesContent":["import { arrayRemove } from './array_helpers';\n\nexport type PromisedValueResolveListener<T> = (result: T) => unknown;\nexport type PromisedValueRejectListener = (reason?: Error) => unknown;\nexport type PromisedValueResetListener = () => unknown;\n\nexport default class PromisedValue<T = unknown> implements Promise<T> {\n public static from<T>(promise: Promise<T>): PromisedValue<T> {\n const promisedValue = new PromisedValue<T>();\n\n promise.then(promisedValue.resolve.bind(promisedValue)).catch(promisedValue.reject.bind(promisedValue));\n\n return promisedValue;\n }\n\n declare private _value?: T;\n declare private promise: Promise<T>;\n declare private _resolve: (result: T) => void;\n declare private _reject: (reason?: Error) => void;\n\n private resolveListeners: PromisedValueResolveListener<T>[] = [];\n private rejectListeners: PromisedValueRejectListener[] = [];\n private resetListeners: PromisedValueResetListener[] = [];\n\n constructor() {\n this.setPromiseValues();\n }\n\n declare public [Symbol.toStringTag]: string;\n\n public get value(): T | null {\n return this._value || null;\n }\n\n public isResolved(): this is { value: T } {\n return '_value' in this;\n }\n\n // oxlint-disable-next-line unicorn/no-thenable\n public then<TResult1 = T, TResult2 = never>(\n onFulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,\n onRejected?: ((reason: Error) => TResult2 | PromiseLike<TResult2>) | null,\n ): Promise<TResult1 | TResult2> {\n return this.promise.then(onFulfilled, onRejected);\n }\n\n public catch<TResult = never>(\n onRejected?: ((reason: Error) => TResult | PromiseLike<TResult>) | null,\n ): Promise<T | TResult> {\n return this.promise.catch(onRejected);\n }\n\n public finally(onFinally?: (() => void) | null): Promise<T> {\n return this.promise.finally(onFinally);\n }\n\n public resolve(value: T): void {\n if (this.isResolved()) {\n this.reset();\n }\n\n this._value = value;\n this._resolve(value);\n\n this.resolveListeners.forEach((listener) => listener(value));\n }\n\n public reject(reason?: Error): void {\n if (this.isResolved()) {\n this.reset();\n }\n\n delete this._value;\n this._reject(reason);\n\n this.rejectListeners.forEach((listener) => listener(reason));\n }\n\n public onResolve(listener: PromisedValueResolveListener<T>): () => void {\n this.resolveListeners.push(listener);\n\n return () => arrayRemove(this.resolveListeners, listener);\n }\n\n public onReject(listener: PromisedValueRejectListener): () => void {\n this.rejectListeners.push(listener);\n\n return () => arrayRemove(this.rejectListeners, listener);\n }\n\n public onReset(listener: PromisedValueResetListener): () => void {\n this.resetListeners.push(listener);\n\n return () => arrayRemove(this.resetListeners, listener);\n }\n\n public reset(): void {\n this.setPromiseValues();\n\n this.resetListeners.forEach((listener) => listener());\n }\n\n private setPromiseValues(): void {\n this.promise = new Promise((resolve, reject) => {\n this._resolve = resolve;\n this._reject = reject;\n });\n }\n}\n"],"mappings":";;AAMA,IAAqB,gBAArB,MAAqB,cAAiD;CAClE,OAAc,KAAQ,SAAuC;EACzD,MAAM,gBAAgB,IAAI,cAAiB;EAE3C,QAAQ,KAAK,cAAc,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,MAAM,cAAc,OAAO,KAAK,aAAa,CAAC;EAEtG,OAAO;CACX;CAOA,mBAA8D,CAAC;CAC/D,kBAAyD,CAAC;CAC1D,iBAAuD,CAAC;CAExD,cAAc;EACV,KAAK,iBAAiB;CAC1B;CAIA,IAAW,QAAkB;EACzB,OAAO,KAAK,UAAU;CAC1B;CAEA,aAA0C;EACtC,OAAO,YAAY;CACvB;CAGA,KACI,aACA,YAC4B;EAC5B,OAAO,KAAK,QAAQ,KAAK,aAAa,UAAU;CACpD;CAEA,MACI,YACoB;EACpB,OAAO,KAAK,QAAQ,MAAM,UAAU;CACxC;CAEA,QAAe,WAA6C;EACxD,OAAO,KAAK,QAAQ,QAAQ,SAAS;CACzC;CAEA,QAAe,OAAgB;EAC3B,IAAI,KAAK,WAAW,GAChB,KAAK,MAAM;EAGf,KAAK,SAAS;EACd,KAAK,SAAS,KAAK;EAEnB,KAAK,iBAAiB,SAAS,aAAa,SAAS,KAAK,CAAC;CAC/D;CAEA,OAAc,QAAsB;EAChC,IAAI,KAAK,WAAW,GAChB,KAAK,MAAM;EAGf,OAAO,KAAK;EACZ,KAAK,QAAQ,MAAM;EAEnB,KAAK,gBAAgB,SAAS,aAAa,SAAS,MAAM,CAAC;CAC/D;CAEA,UAAiB,UAAuD;EACpE,KAAK,iBAAiB,KAAK,QAAQ;EAEnC,aAAa,YAAY,KAAK,kBAAkB,QAAQ;CAC5D;CAEA,SAAgB,UAAmD;EAC/D,KAAK,gBAAgB,KAAK,QAAQ;EAElC,aAAa,YAAY,KAAK,iBAAiB,QAAQ;CAC3D;CAEA,QAAe,UAAkD;EAC7D,KAAK,eAAe,KAAK,QAAQ;EAEjC,aAAa,YAAY,KAAK,gBAAgB,QAAQ;CAC1D;CAEA,QAAqB;EACjB,KAAK,iBAAiB;EAEtB,KAAK,eAAe,SAAS,aAAa,SAAS,CAAC;CACxD;CAEA,mBAAiC;EAC7B,KAAK,UAAU,IAAI,SAAS,SAAS,WAAW;GAC5C,KAAK,WAAW;GAChB,KAAK,UAAU;EACnB,CAAC;CACL;AACJ"}