@develia/commons 0.4.26 → 0.6.1

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 (114) hide show
  1. package/dist/array.d.ts +10 -0
  2. package/dist/array.d.ts.map +1 -1
  3. package/dist/array.js +18 -0
  4. package/dist/array.js.map +1 -1
  5. package/dist/async-pool-executor.d.ts +3 -5
  6. package/dist/async-pool-executor.d.ts.map +1 -1
  7. package/dist/async-pool-executor.js +9 -9
  8. package/dist/async-pool-executor.js.map +1 -1
  9. package/dist/browser/form-utilities.d.ts +0 -2
  10. package/dist/browser/form-utilities.d.ts.map +1 -1
  11. package/dist/browser/form-utilities.js +3 -23
  12. package/dist/browser/form-utilities.js.map +1 -1
  13. package/dist/browser/geo-location.js +3 -3
  14. package/dist/browser/geo-location.js.map +1 -1
  15. package/dist/browser/native-bridge.d.ts +1 -1
  16. package/dist/browser/native-bridge.d.ts.map +1 -1
  17. package/dist/browser/native-bridge.js +2 -2
  18. package/dist/browser/native-bridge.js.map +1 -1
  19. package/dist/cancellable-promise.d.ts +8 -2
  20. package/dist/cancellable-promise.d.ts.map +1 -1
  21. package/dist/cancellable-promise.js +9 -3
  22. package/dist/cancellable-promise.js.map +1 -1
  23. package/dist/clean-url-search-params.js +3 -3
  24. package/dist/clean-url-search-params.js.map +1 -1
  25. package/dist/collections/from.d.ts +16 -5
  26. package/dist/collections/from.d.ts.map +1 -1
  27. package/dist/collections/from.js +69 -38
  28. package/dist/collections/from.js.map +1 -1
  29. package/dist/draft.d.ts +2 -2
  30. package/dist/draft.d.ts.map +1 -1
  31. package/dist/draft.js +2 -2
  32. package/dist/draft.js.map +1 -1
  33. package/dist/functions.d.ts +2 -2
  34. package/dist/functions.d.ts.map +1 -1
  35. package/dist/functions.js +1 -1
  36. package/dist/functions.js.map +1 -1
  37. package/dist/index.d.ts +2 -1
  38. package/dist/index.d.ts.map +1 -1
  39. package/dist/index.js +2 -1
  40. package/dist/index.js.map +1 -1
  41. package/dist/math.d.ts +14 -5
  42. package/dist/math.d.ts.map +1 -1
  43. package/dist/math.js +16 -5
  44. package/dist/math.js.map +1 -1
  45. package/dist/parse.d.ts +62 -44
  46. package/dist/parse.d.ts.map +1 -1
  47. package/dist/parse.js +95 -59
  48. package/dist/parse.js.map +1 -1
  49. package/dist/range.d.ts +2 -10
  50. package/dist/range.d.ts.map +1 -1
  51. package/dist/range.js +0 -12
  52. package/dist/range.js.map +1 -1
  53. package/dist/stopwatch.d.ts +2 -2
  54. package/dist/stopwatch.d.ts.map +1 -1
  55. package/dist/stopwatch.js +9 -9
  56. package/dist/stopwatch.js.map +1 -1
  57. package/dist/string.d.ts +15 -0
  58. package/dist/string.d.ts.map +1 -1
  59. package/dist/string.js +28 -3
  60. package/dist/string.js.map +1 -1
  61. package/dist/timespan.d.ts +10 -15
  62. package/dist/timespan.d.ts.map +1 -1
  63. package/dist/timespan.js +10 -15
  64. package/dist/timespan.js.map +1 -1
  65. package/dist/triggers.d.ts +6 -15
  66. package/dist/triggers.d.ts.map +1 -1
  67. package/dist/triggers.js +8 -22
  68. package/dist/triggers.js.map +1 -1
  69. package/dist/types.d.ts +0 -1
  70. package/dist/types.d.ts.map +1 -1
  71. package/dist/types.js.map +1 -1
  72. package/dist/utilities.d.ts +7 -6
  73. package/dist/utilities.d.ts.map +1 -1
  74. package/dist/utilities.js +19 -20
  75. package/dist/utilities.js.map +1 -1
  76. package/dist/uuid.d.ts +73 -0
  77. package/dist/uuid.d.ts.map +1 -0
  78. package/dist/uuid.js +129 -0
  79. package/dist/uuid.js.map +1 -0
  80. package/package.json +5 -1
  81. package/src/array.ts +19 -0
  82. package/src/async-pool-executor.ts +9 -9
  83. package/src/browser/form-utilities.ts +3 -32
  84. package/src/browser/geo-location.ts +3 -3
  85. package/src/browser/index.ts +0 -0
  86. package/src/browser/native-bridge.ts +2 -2
  87. package/src/cancellable-promise.ts +9 -3
  88. package/src/clean-url-search-params.ts +3 -3
  89. package/src/collections/cache-dictionary.ts +0 -0
  90. package/src/collections/default-map.ts +0 -0
  91. package/src/collections/default-weak-map.ts +0 -0
  92. package/src/collections/from.ts +70 -38
  93. package/src/collections/index.ts +0 -0
  94. package/src/draft.ts +3 -3
  95. package/src/event-bus.ts +0 -0
  96. package/src/functions.ts +3 -3
  97. package/src/index.ts +2 -1
  98. package/src/key-value-pair.ts +0 -0
  99. package/src/lazy.ts +0 -0
  100. package/src/math.ts +17 -5
  101. package/src/order.ts +0 -0
  102. package/src/parse.ts +108 -66
  103. package/src/patch.ts +0 -0
  104. package/src/range.ts +2 -16
  105. package/src/stopwatch.ts +9 -9
  106. package/src/string.ts +33 -3
  107. package/src/timer.ts +0 -0
  108. package/src/timespan.ts +10 -15
  109. package/src/triggers.ts +10 -24
  110. package/src/type-code.ts +0 -0
  111. package/src/type.ts +0 -0
  112. package/src/types.ts +0 -1
  113. package/src/utilities.ts +22 -25
  114. package/src/uuid.ts +153 -0
@@ -1 +1 @@
1
- {"version":3,"file":"utilities.js","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection JSUnusedGlobalSymbols\n\n\nimport KeyValuePair from \"./key-value-pair.js\";\nimport type {Resolvable, Constructor} from \"./types.js\";\nimport Type from \"./type.js\";\n\nexport function lazy<T extends object>(factory: () => T): T {\n let created = false;\n let instance: T;\n\n const getInstance = (): T => {\n if (!created) {\n instance = factory();\n created = true;\n }\n return instance;\n };\n\n return new Proxy({} as T, {\n get(_, prop, receiver) {\n return Reflect.get(getInstance(), prop, receiver);\n },\n set(_, prop, value) {\n return Reflect.set(getInstance(), prop, value, getInstance());\n },\n defineProperty(_, prop, descriptor) {\n return Reflect.defineProperty(getInstance(), prop, descriptor);\n },\n has(_, prop) {\n return Reflect.has(getInstance(), prop);\n },\n deleteProperty(_, prop) {\n return Reflect.deleteProperty(getInstance(), prop);\n },\n ownKeys() {\n return Reflect.ownKeys(getInstance());\n },\n getOwnPropertyDescriptor(_, prop) {\n const descriptor = Reflect.getOwnPropertyDescriptor(getInstance(), prop);\n if (descriptor == null || descriptor.configurable) {\n return descriptor;\n }\n return {...descriptor, configurable: true};\n },\n getPrototypeOf() {\n return Reflect.getPrototypeOf(getInstance());\n },\n });\n}\n\n/**\n * Checks if an object is iterable.\n *\n * @param {any} obj - The object to check.\n * @return {boolean} - Returns true if the object is iterable, otherwise false.\n */\nexport function isIterable(obj: any): boolean {\n return obj != null && typeof obj[Symbol.iterator] === 'function';\n}\n\n/**\n * Checks if a given value is a string.\n *\n * @param {*} value - The value to check.\n * @return {boolean} - Returns true if the value is a string, otherwise returns false.\n */\nexport function isString(value: any): value is string {\n return typeof value === 'string';\n}\n\n/**\n * Checks if a value is a number.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is a number, otherwise false.\n */\nexport function isNumber(value: any): value is number {\n return typeof value === 'number';\n}\n\n/**\n * Checks if a given value is a boolean.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - Returns true if the value is a boolean, otherwise false.\n */\nexport function isBoolean(value: any): value is boolean {\n return typeof value === 'boolean';\n}\n\n/**\n * Checks if a value is an object.\n * @param {any} value - The value to be checked.\n * @returns {boolean} - Returns true if the value is an object, otherwise returns false.\n */\nexport function isObject(value: any): value is object {\n return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Determines if a value is an array.\n *\n * @param value - The value to be checked.\n *\n * @return Whether the value is an array.\n */\nexport function isArray(value: any): value is any[] {\n return Array.isArray(value);\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a function, otherwise returns false.\n */\nexport function isFunction(value: any): value is Function {\n return typeof value === 'function';\n}\n\n\n/**\n * Structural deep equality check.\n *\n * Compares primitives by value, and objects/arrays/Maps/Sets/Dates/RegExps\n * by structure. Handles circular references.\n *\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared. Defaults to `true`.\n * @returns `true` if `a` and `b` are structurally equal.\n */\nexport function deepEqual(a: unknown, b: unknown, includeInherited = true): boolean {\n return _deepEqual(a, b, includeInherited);\n}\n\n/**\n * Internal implementation of deep equality check.\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepEqual(\n a: unknown,\n b: unknown,\n includeInherited: boolean,\n seen: Map<object, unknown> = new Map()\n): boolean {\n if (a === b) return true;\n if (a === null || b === null) return false;\n if (typeof a !== typeof b) return false;\n if (typeof a !== \"object\") return false;\n\n if (a instanceof Date || b instanceof Date) {\n return a instanceof Date && b instanceof Date && a.getTime() === b.getTime();\n }\n\n if (a instanceof RegExp || b instanceof RegExp) {\n return a instanceof RegExp && b instanceof RegExp && a.toString() === b.toString();\n }\n\n if (Array.isArray(a) !== Array.isArray(b)) return false;\n\n if (a instanceof Map || b instanceof Map) {\n if (!(a instanceof Map) || !(b instanceof Map)) return false;\n }\n\n if (a instanceof Set || b instanceof Set) {\n if (!(a instanceof Set) || !(b instanceof Set)) return false;\n }\n\n const objA = a as object;\n if (seen.has(objA)) return seen.get(objA) === b;\n seen.set(objA, b);\n\n if (a instanceof Map && b instanceof Map) {\n return _deepEqualMap(a, b, includeInherited, seen);\n }\n\n if (a instanceof Set && b instanceof Set) {\n return _deepEqualSet(a, b, includeInherited, seen);\n }\n\n const objB = b as object;\n const keysA = _deepEqualKeys(objA, includeInherited);\n const keysB = _deepEqualKeys(objB, includeInherited);\n if (keysA.length !== keysB.length) return false;\n\n for (const key of keysA) {\n if (!_deepEqualHasKey(objB, key, includeInherited)) return false;\n if (!_deepEqual((a as any)[key], (b as any)[key], includeInherited, seen)) return false;\n }\n\n return true;\n}\n\nfunction _deepEqualMap(\n a: Map<unknown, unknown>,\n b: Map<unknown, unknown>,\n includeInherited: boolean,\n seen: Map<object, unknown>\n): boolean {\n if (a.size !== b.size) return false;\n\n const entriesB = Array.from(b.entries());\n const matched = new Set<number>();\n\n for (const [keyA, valueA] of a) {\n let found = false;\n\n for (let i = 0; i < entriesB.length; i++) {\n if (matched.has(i)) continue;\n\n const [keyB, valueB] = entriesB[i];\n const candidateSeen = new Map(seen);\n if (\n _deepEqual(keyA, keyB, includeInherited, candidateSeen) &&\n _deepEqual(valueA, valueB, includeInherited, candidateSeen)\n ) {\n matched.add(i);\n _mergeDeepEqualSeen(candidateSeen, seen);\n found = true;\n break;\n }\n }\n\n if (!found) return false;\n }\n\n return true;\n}\n\nfunction _deepEqualSet(\n a: Set<unknown>,\n b: Set<unknown>,\n includeInherited: boolean,\n seen: Map<object, unknown>\n): boolean {\n if (a.size !== b.size) return false;\n\n const valuesB = Array.from(b.values());\n const matched = new Set<number>();\n\n for (const valueA of a) {\n let found = false;\n\n for (let i = 0; i < valuesB.length; i++) {\n if (matched.has(i)) continue;\n\n const candidateSeen = new Map(seen);\n if (_deepEqual(valueA, valuesB[i], includeInherited, candidateSeen)) {\n matched.add(i);\n _mergeDeepEqualSeen(candidateSeen, seen);\n found = true;\n break;\n }\n }\n\n if (!found) return false;\n }\n\n return true;\n}\n\nfunction _deepEqualKeys(value: object, includeInherited: boolean): PropertyKey[] {\n const keys: PropertyKey[] = [];\n const seen = new Set<PropertyKey>();\n const addKey = (key: PropertyKey) => {\n if (seen.has(key)) return;\n seen.add(key);\n keys.push(key);\n };\n\n for (const key of Reflect.ownKeys(value)) {\n addKey(key);\n }\n\n if (!includeInherited) return keys;\n\n let prototype = Object.getPrototypeOf(value);\n while (prototype !== null) {\n for (const key of Reflect.ownKeys(prototype)) {\n const descriptor = Object.getOwnPropertyDescriptor(prototype, key);\n if (descriptor?.enumerable) addKey(key);\n }\n prototype = Object.getPrototypeOf(prototype);\n }\n\n return keys;\n}\n\nfunction _deepEqualHasKey(value: object, key: PropertyKey, includeInherited: boolean): boolean {\n return includeInherited\n ? key in value\n : Object.prototype.hasOwnProperty.call(value, key);\n}\n\nfunction _mergeDeepEqualSeen(source: Map<object, unknown>, target: Map<object, unknown>): void {\n for (const [key, value] of source) {\n target.set(key, value);\n }\n}\n\n\n/**\n * Submits an HTML form programmatically using the specified HTTP method (default is POST),\n * without using AJAX. Supports nested objects and arrays using bracket notation (e.g., `user[name]`, `tags[]`).\n *\n * @param url - The destination URL where the form will be submitted.\n * @param data - An object containing key-value pairs. Supports nested structures and arrays.\n * @param method - HTTP method to use: 'POST' or 'GET' (default: 'POST').\n * @param target - Optional parameter specifying the target for the form submission (e.g., '_blank', '_self', '_parent', '_top').\n */\n\n\n/**\n * Compares two objects or arrays to check if they have the same immediate fields and values,\n * or the same immediate elements if they are arrays (shallow equality check).\n *\n * @param {any} a - The first object or array.\n * @param {any} b - The second object or array.\n * @return {boolean} - Returns true if the objects/arrays are shallowly equal, otherwise false.\n */\nexport function shallowEqual(a: any, b: any): boolean {\n if (a === b) {\n return true;\n }\n\n if (a === null || b === null || typeof a !== typeof b) {\n return false;\n }\n\n if (Array.isArray(a) && Array.isArray(b)) {\n if (a.length !== b.length) {\n return false;\n }\n return a.every((value, index) => value === b[index]);\n }\n\n if (typeof a === \"object\" && typeof b === \"object\") {\n const keysA = Object.keys(a);\n const keysB = Object.keys(b);\n\n if (keysA.length !== keysB.length) {\n return false;\n }\n return keysA.every(key => Object.prototype.hasOwnProperty.call(b, key) && a[key] === b[key]);\n }\n\n return false;\n}\n\n\n/**\n * Pauses the execution of an asynchronous function for a specified duration.\n *\n * When `signal` is provided, the returned promise rejects with `signal.reason`\n * as soon as the signal is aborted (or immediately if it is already aborted),\n * and the pending timer is cleared.\n *\n * @param ms - The delay duration in milliseconds.\n * @param signal - Optional signal that cancels the wait.\n * @return A promise that resolves after the specified delay.\n */\nexport function delay(ms: number, signal?: AbortSignal): Promise<void> {\n return new Promise<void>((resolve, reject) => {\n if (signal === undefined) {\n setTimeout(resolve, ms);\n return;\n }\n\n if (signal.aborted) {\n reject(signal.reason);\n return;\n }\n\n const onAbort = (): void => {\n clearTimeout(timer);\n reject(signal.reason);\n };\n const timer = setTimeout(() => {\n signal.removeEventListener(\"abort\", onAbort);\n resolve();\n }, ms);\n\n signal.addEventListener(\"abort\", onAbort, {once: true});\n });\n}\n\n/**\n * Checks if a value is undefined.\n *\n * @param {any} value - The value to check.\n * @returns {boolean} - True if the value is undefined, false otherwise.\n */\nexport function isUndefined(value: any): value is undefined {\n return typeof value === 'undefined';\n}\n\n/**\n * Checks if a value is defined or not.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - True if the value is defined, false otherwise.\n */\nexport function isDefined<T>(value: T): value is Exclude<T, undefined> {\n return typeof value !== 'undefined';\n}\n\n/**\n * Checks if a given value is null.\n *\n * @param {any} value - The value to check for null.\n * @return {boolean} - Returns true if the value is null, otherwise returns false.\n */\nexport function isNull(value: any): value is null {\n return value === null;\n}\n\n\n/**\n * Determines whether the given value is of type bigint.\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is of type bigint, false otherwise.\n */\nexport function isBigInt(value: any): value is bigint {\n return typeof value === 'bigint';\n}\n\n/**\n * Checks if a given value is a symbol.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a symbol, false otherwise.\n */\nexport function isSymbol(value: any): value is symbol {\n return typeof value === 'symbol';\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n * @deprecated\n */\nexport function isNullOrUndefined(value: any): boolean {\n return isNullish(value);\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n\n */\nexport function isNullish(value: any): boolean {\n return value === null || typeof value === 'undefined';\n}\n\n/**\n * Checks if a given value is empty.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is empty, otherwise returns false.\n */\nexport function isEmpty(value: any): boolean {\n if (isNullish(value)) return true;\n if (Array.isArray(value)) return value.length === 0;\n if (typeof value === 'string') return value === '';\n return false;\n}\n\n/**\n * Check if a value is empty or contains only whitespace characters.\n *\n * @param {any} value - The value to check.\n * @return {boolean} Returns true if the value is empty or contains only whitespace characters, otherwise returns false.\n */\nexport function isEmptyOrWhitespace(value: any): boolean {\n if (typeof value === 'string') return value.trim() === '';\n return isEmpty(value);\n}\n\n\n/**\n * Converts an object into an array of key-value pairs.\n *\n * @template TValue - The type of the property values.\n * @param {Record<string, TValue>} obj - The object to convert.\n * @return {KeyValuePair<string, TValue>[]} - The array of key-value pairs.\n */\nexport function toPairs<TValue>(obj: Record<string, TValue>): KeyValuePair<string, TValue>[] {\n\n const output: KeyValuePair<string, TValue>[] = [];\n for (const key in obj) {\n output.push(new KeyValuePair(key, obj[key]));\n }\n return output;\n\n}\n\n/**\n * Creates an object composed of the picked object properties.\n *\n * @template T - The type of the source object.\n * @template K - The type of the keys to pick.\n * @param obj - The source object.\n * @param props - The property names to pick.\n * @returns A new object with the picked properties.\n */\nexport function pick<T extends object, K extends keyof T>(obj: T, props: K[]): Pick<T, K> {\n const result = {} as Pick<T, K>;\n if (obj === null || typeof obj !== 'object') {\n return result;\n }\n\n for (const key of props) {\n if (key in obj) {\n result[key] = obj[key];\n }\n }\n return result;\n}\n\n/**\n * Converts a given thing into a Promise.\n * @template T\n * @param {any} thing - The thing to be converted into a Promise.\n * @returns {Promise<T>} - A Promise representing the given thing.\n */\nexport function promisify<T>(thing: Resolvable<T>): Promise<T> {\n\n if (thing instanceof Promise)\n return thing;\n\n\n if (isFunction(thing)) {\n return new Promise<T>((resolve, reject) => {\n try {\n const result = thing();\n resolve(result);\n } catch (error) {\n reject(error);\n }\n });\n }\n\n return Promise.resolve(thing);\n}\n\n\n/**\n * Create a deep, independent copy of a value.\n *\n * Supports primitives, plain objects, arrays, `Date`, `RegExp`, `Map`, `Set`,\n * symbol-keyed properties and circular references. Functions are copied by\n * reference. Class instances preserve their prototype.\n *\n * @template T - The value's type.\n * @param value - The value to clone.\n * @returns A deep clone of `value`.\n */\nexport function deepClone<T>(value: T): T {\n return _deepClone(value);\n}\n\n/**\n * Internal implementation of deep clone.\n * @param value - The value to clone.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepClone<T>(\n value: T,\n seen: WeakMap<object, unknown> = new WeakMap()\n): T {\n if (value === null || typeof value !== \"object\") return value;\n\n const obj = value as unknown as object;\n if (seen.has(obj)) return seen.get(obj) as T;\n\n if (value instanceof Date) return new Date(value) as T;\n if (value instanceof RegExp) {\n const copy = new RegExp(value);\n copy.lastIndex = value.lastIndex;\n return copy as T;\n }\n\n if (value instanceof Map) {\n const copy = new Map();\n seen.set(value, copy);\n for (const [k, v] of value) {\n copy.set(_deepClone(k, seen), _deepClone(v, seen));\n }\n return copy as T;\n }\n\n if (value instanceof Set) {\n const copy = new Set();\n seen.set(value, copy);\n for (const v of value) {\n copy.add(_deepClone(v, seen));\n }\n return copy as T;\n }\n\n const copy: any = Array.isArray(value)\n ? []\n : Object.create(Object.getPrototypeOf(value));\n\n seen.set(obj, copy);\n\n for (const key of Reflect.ownKeys(obj)) {\n copy[key] = _deepClone((value as any)[key], seen);\n }\n\n return copy as T;\n}\n\n\n/**\n * Returns the type of the given value.\n *\n * @param {any} value - The value to determine the type of.\n * @return {Type} - The type of the given value.\n * @deprecated use Type.of(...)\n */\nexport function getType(value: any): Type {\n\n return Type.of(value);\n}\n\n/**\n * Patches a method onto a class prototype.\n *\n * This function allows adding new methods to existing classes (monkey-patching).\n * If the method name already exists on the prototype, a warning is issued\n * and the method is not overwritten.\n *\n * If `method` is a function, its name is extracted (if not provided) and\n * it is wrapped to pass the instance (`this`) as the first argument.\n *\n * @template T - The type of the class constructor.\n * @param {T} target - The class constructor whose prototype will be patched.\n * @param {any} method - The implementation or value to patch.\n * @param {string | symbol} [name] - Optional name for the method. If not provided and method is a function, method.name is used.\n * @returns {boolean} Returns `true` if the method was successfully added, or `false` if it already existed.\n */\nexport function monkeyPatch<T extends Constructor>(\n target: T,\n method: any,\n name?: string | symbol\n): boolean {\n\n let methodName;\n let methodValue = method;\n\n if (typeof method === 'function') {\n methodName = name ?? (method as Function).name;\n methodValue = function (this: any, ...args: any[]) {\n return method.apply(this, [this, ...args]);\n };\n } else {\n methodName = name;\n }\n\n if (!methodName) {\n throw new Error(\"Monkey patch failed: No name provided and could not be extracted from function.\");\n }\n\n if (methodName in target.prototype) {\n console.warn(`Method '${String(methodName)}' already exists on ${target.name}`);\n return false;\n }\n\n Object.defineProperty(target.prototype, methodName, {\n value: methodValue,\n writable: true,\n configurable: true,\n enumerable: false\n });\n\n return true;\n}"]}
1
+ {"version":3,"file":"utilities.js","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection JSUnusedGlobalSymbols\n\n\nimport KeyValuePair from \"./key-value-pair.js\";\nimport type {Constructor} from \"./types.js\";\nimport Type from \"./type.js\";\n\nexport function lazy<T extends object>(factory: () => T): T {\n let created = false;\n let instance: T;\n\n const getInstance = (): T => {\n if (!created) {\n instance = factory();\n created = true;\n }\n return instance;\n };\n\n return new Proxy({} as T, {\n get(_, prop, receiver) {\n return Reflect.get(getInstance(), prop, receiver);\n },\n set(_, prop, value) {\n return Reflect.set(getInstance(), prop, value, getInstance());\n },\n defineProperty(_, prop, descriptor) {\n return Reflect.defineProperty(getInstance(), prop, descriptor);\n },\n has(_, prop) {\n return Reflect.has(getInstance(), prop);\n },\n deleteProperty(_, prop) {\n return Reflect.deleteProperty(getInstance(), prop);\n },\n ownKeys() {\n return Reflect.ownKeys(getInstance());\n },\n getOwnPropertyDescriptor(_, prop) {\n const descriptor = Reflect.getOwnPropertyDescriptor(getInstance(), prop);\n if (descriptor == null || descriptor.configurable) {\n return descriptor;\n }\n return {...descriptor, configurable: true};\n },\n getPrototypeOf() {\n return Reflect.getPrototypeOf(getInstance());\n },\n });\n}\n\n/**\n * Checks if an object is iterable.\n *\n * @param {any} obj - The object to check.\n * @return {boolean} - Returns true if the object is iterable, otherwise false.\n */\nexport function isIterable(obj: any): boolean {\n return obj != null && typeof obj[Symbol.iterator] === 'function';\n}\n\n/**\n * Checks if a given value is a string.\n *\n * @param {*} value - The value to check.\n * @return {boolean} - Returns true if the value is a string, otherwise returns false.\n */\nexport function isString(value: any): value is string {\n return typeof value === 'string';\n}\n\n/**\n * Checks if a value is a number.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is a number, otherwise false.\n */\nexport function isNumber(value: any): value is number {\n return typeof value === 'number';\n}\n\n/**\n * Checks if a given value is a boolean.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - Returns true if the value is a boolean, otherwise false.\n */\nexport function isBoolean(value: any): value is boolean {\n return typeof value === 'boolean';\n}\n\n/**\n * Checks if a value is an object.\n * @param {any} value - The value to be checked.\n * @returns {boolean} - Returns true if the value is an object, otherwise returns false.\n */\nexport function isObject(value: any): value is object {\n return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Determines if a value is an array.\n *\n * @param value - The value to be checked.\n *\n * @return Whether the value is an array.\n */\nexport function isArray(value: any): value is any[] {\n return Array.isArray(value);\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a function, otherwise returns false.\n */\nexport function isFunction(value: any): value is Function {\n return typeof value === 'function';\n}\n\n\n/**\n * Structural deep equality check.\n *\n * Compares primitives by value, and objects/arrays/Maps/Sets/Dates/RegExps\n * by structure. Handles circular references.\n *\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared. Defaults to `true`.\n * @returns `true` if `a` and `b` are structurally equal.\n */\nexport function deepEqual(a: unknown, b: unknown, includeInherited = true): boolean {\n return _deepEqual(a, b, includeInherited);\n}\n\n/**\n * Internal implementation of deep equality check.\n * @param a - First value.\n * @param b - Second value.\n * @param includeInherited - Whether inherited enumerable properties are compared.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepEqual(\n a: unknown,\n b: unknown,\n includeInherited: boolean,\n seen: Map<object, unknown> = new Map()\n): boolean {\n if (a === b) return true;\n if (a === null || b === null) return false;\n if (typeof a !== typeof b) return false;\n if (typeof a !== \"object\") return false;\n\n if (a instanceof Date || b instanceof Date) {\n return a instanceof Date && b instanceof Date && a.getTime() === b.getTime();\n }\n\n if (a instanceof RegExp || b instanceof RegExp) {\n return a instanceof RegExp && b instanceof RegExp && a.toString() === b.toString();\n }\n\n if (Array.isArray(a) !== Array.isArray(b)) return false;\n\n if (a instanceof Map || b instanceof Map) {\n if (!(a instanceof Map) || !(b instanceof Map)) return false;\n }\n\n if (a instanceof Set || b instanceof Set) {\n if (!(a instanceof Set) || !(b instanceof Set)) return false;\n }\n\n const objA = a as object;\n if (seen.has(objA)) return seen.get(objA) === b;\n seen.set(objA, b);\n\n if (a instanceof Map && b instanceof Map) {\n return _deepEqualMap(a, b, includeInherited, seen);\n }\n\n if (a instanceof Set && b instanceof Set) {\n return _deepEqualSet(a, b, includeInherited, seen);\n }\n\n const objB = b as object;\n const keysA = _collectComparableKeys(objA, includeInherited);\n const keysB = _collectComparableKeys(objB, includeInherited);\n if (keysA.length !== keysB.length) return false;\n\n for (const key of keysA) {\n if (!_deepEqualHasKey(objB, key, includeInherited)) return false;\n if (!_deepEqual((a as any)[key], (b as any)[key], includeInherited, seen)) return false;\n }\n\n return true;\n}\n\nfunction _deepEqualMap(\n a: Map<unknown, unknown>,\n b: Map<unknown, unknown>,\n includeInherited: boolean,\n seen: Map<object, unknown>\n): boolean {\n if (a.size !== b.size) return false;\n\n const entriesB = Array.from(b.entries());\n const matched = new Set<number>();\n\n for (const [keyA, valueA] of a) {\n let found = false;\n\n for (let i = 0; i < entriesB.length; i++) {\n if (matched.has(i)) continue;\n\n const [keyB, valueB] = entriesB[i];\n const candidateSeen = new Map(seen);\n if (\n _deepEqual(keyA, keyB, includeInherited, candidateSeen) &&\n _deepEqual(valueA, valueB, includeInherited, candidateSeen)\n ) {\n matched.add(i);\n _mergeDeepEqualSeen(candidateSeen, seen);\n found = true;\n break;\n }\n }\n\n if (!found) return false;\n }\n\n return true;\n}\n\nfunction _deepEqualSet(\n a: Set<unknown>,\n b: Set<unknown>,\n includeInherited: boolean,\n seen: Map<object, unknown>\n): boolean {\n if (a.size !== b.size) return false;\n\n const valuesB = Array.from(b.values());\n const matched = new Set<number>();\n\n for (const valueA of a) {\n let found = false;\n\n for (let i = 0; i < valuesB.length; i++) {\n if (matched.has(i)) continue;\n\n const candidateSeen = new Map(seen);\n if (_deepEqual(valueA, valuesB[i], includeInherited, candidateSeen)) {\n matched.add(i);\n _mergeDeepEqualSeen(candidateSeen, seen);\n found = true;\n break;\n }\n }\n\n if (!found) return false;\n }\n\n return true;\n}\n\nfunction _collectComparableKeys(value: object, includeInherited: boolean): PropertyKey[] {\n const keys: PropertyKey[] = [];\n const seen = new Set<PropertyKey>();\n const addKey = (key: PropertyKey) => {\n if (seen.has(key)) return;\n seen.add(key);\n keys.push(key);\n };\n\n for (const key of Reflect.ownKeys(value)) {\n addKey(key);\n }\n\n if (!includeInherited) return keys;\n\n let prototype = Object.getPrototypeOf(value);\n while (prototype !== null) {\n for (const key of Reflect.ownKeys(prototype)) {\n const descriptor = Object.getOwnPropertyDescriptor(prototype, key);\n if (descriptor?.enumerable) addKey(key);\n }\n prototype = Object.getPrototypeOf(prototype);\n }\n\n return keys;\n}\n\nfunction _deepEqualHasKey(value: object, key: PropertyKey, includeInherited: boolean): boolean {\n return includeInherited\n ? key in value\n : Object.prototype.hasOwnProperty.call(value, key);\n}\n\nfunction _mergeDeepEqualSeen(source: Map<object, unknown>, target: Map<object, unknown>): void {\n for (const [key, value] of source) {\n target.set(key, value);\n }\n}\n\n\n/**\n * Submits an HTML form programmatically using the specified HTTP method (default is POST),\n * without using AJAX. Supports nested objects and arrays using bracket notation (e.g., `user[name]`, `tags[]`).\n *\n * @param url - The destination URL where the form will be submitted.\n * @param data - An object containing key-value pairs. Supports nested structures and arrays.\n * @param method - HTTP method to use: 'POST' or 'GET' (default: 'POST').\n * @param target - Optional parameter specifying the target for the form submission (e.g., '_blank', '_self', '_parent', '_top').\n */\n\n\n/**\n * Compares two objects or arrays to check if they have the same immediate fields and values,\n * or the same immediate elements if they are arrays (shallow equality check).\n *\n * @param {any} a - The first object or array.\n * @param {any} b - The second object or array.\n * @return {boolean} - Returns true if the objects/arrays are shallowly equal, otherwise false.\n */\nexport function shallowEqual(a: any, b: any): boolean {\n if (a === b) {\n return true;\n }\n\n if (a === null || b === null || typeof a !== typeof b) {\n return false;\n }\n\n if (Array.isArray(a) && Array.isArray(b)) {\n if (a.length !== b.length) {\n return false;\n }\n return a.every((value, index) => value === b[index]);\n }\n\n if (typeof a === \"object\" && typeof b === \"object\") {\n const keysA = Object.keys(a);\n const keysB = Object.keys(b);\n\n if (keysA.length !== keysB.length) {\n return false;\n }\n return keysA.every(key => Object.prototype.hasOwnProperty.call(b, key) && a[key] === b[key]);\n }\n\n return false;\n}\n\n\n/**\n * Pauses the execution of an asynchronous function for a specified duration.\n *\n * When `signal` is provided, the returned promise rejects with `signal.reason`\n * as soon as the signal is aborted (or immediately if it is already aborted),\n * and the pending timer is cleared.\n *\n * @param ms - The delay duration in milliseconds.\n * @param signal - Optional signal that cancels the wait.\n * @return A promise that resolves after the specified delay.\n */\nexport function delay(ms: number, signal?: AbortSignal): Promise<void> {\n return new Promise<void>((resolve, reject) => {\n if (signal === undefined) {\n setTimeout(resolve, ms);\n return;\n }\n\n if (signal.aborted) {\n reject(signal.reason);\n return;\n }\n\n const onAbort = (): void => {\n clearTimeout(timer);\n reject(signal.reason);\n };\n const timer = setTimeout(() => {\n signal.removeEventListener(\"abort\", onAbort);\n resolve();\n }, ms);\n\n signal.addEventListener(\"abort\", onAbort, {once: true});\n });\n}\n\n/**\n * Checks if a value is undefined.\n *\n * @param {any} value - The value to check.\n * @returns {boolean} - True if the value is undefined, false otherwise.\n */\nexport function isUndefined(value: any): value is undefined {\n return typeof value === 'undefined';\n}\n\n/**\n * Checks if a value is defined or not.\n *\n * @param {any} value - The value to be checked.\n *\n * @return {boolean} - True if the value is defined, false otherwise.\n */\nexport function isDefined<T>(value: T): value is Exclude<T, undefined> {\n return typeof value !== 'undefined';\n}\n\n/**\n * Checks if a given value is null.\n *\n * @param {any} value - The value to check for null.\n * @return {boolean} - Returns true if the value is null, otherwise returns false.\n */\nexport function isNull(value: any): value is null {\n return value === null;\n}\n\n\n/**\n * Determines whether the given value is of type bigint.\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is of type bigint, false otherwise.\n */\nexport function isBigInt(value: any): value is bigint {\n return typeof value === 'bigint';\n}\n\n/**\n * Checks if a given value is a symbol.\n *\n * @param {any} value - The value to be checked.\n * @return {boolean} - Returns true if the value is a symbol, false otherwise.\n */\nexport function isSymbol(value: any): value is symbol {\n return typeof value === 'symbol';\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n * @deprecated\n */\nexport function isNullOrUndefined(value: any): boolean {\n return isNullish(value);\n}\n\n/**\n * Checks if a value is null or undefined.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is null or undefined, false otherwise.\n\n */\nexport function isNullish(value: any): boolean {\n return value === null || typeof value === 'undefined';\n}\n\n/**\n * Checks if a given value is empty.\n *\n * @param {any} value - The value to check.\n * @return {boolean} - Returns true if the value is empty, otherwise returns false.\n */\nexport function isEmpty(value: any): boolean {\n if (isNullish(value)) return true;\n if (Array.isArray(value)) return value.length === 0;\n if (typeof value === 'string') return value === '';\n return false;\n}\n\n/**\n * Check if a value is empty or contains only whitespace characters.\n *\n * @param {any} value - The value to check.\n * @return {boolean} Returns true if the value is empty or contains only whitespace characters, otherwise returns false.\n */\nexport function isEmptyOrWhitespace(value: any): boolean {\n if (typeof value === 'string') return value.trim() === '';\n return isEmpty(value);\n}\n\n\n/**\n * Converts an object into an array of key-value pairs.\n *\n * @template TValue - The type of the property values.\n * @param {Record<string, TValue>} obj - The object to convert.\n * @return {KeyValuePair<string, TValue>[]} - The array of key-value pairs.\n */\nexport function toPairs<TValue>(obj: Record<string, TValue>): KeyValuePair<string, TValue>[] {\n\n const output: KeyValuePair<string, TValue>[] = [];\n for (const key in obj) {\n output.push(new KeyValuePair(key, obj[key]));\n }\n return output;\n\n}\n\n/**\n * Creates an object composed of the picked object properties.\n *\n * @template T - The type of the source object.\n * @template K - The type of the keys to pick.\n * @param obj - The source object.\n * @param props - The property names to pick.\n * @returns A new object with the picked properties.\n */\nexport function pick<T extends object, K extends keyof T>(obj: T, props: K[]): Pick<T, K> {\n const result = {} as Pick<T, K>;\n if (obj === null || typeof obj !== 'object') {\n return result;\n }\n\n for (const key of props) {\n if (key in obj) {\n result[key] = obj[key];\n }\n }\n return result;\n}\n\n/**\n * Turns a function that takes a Node-style callback as its last argument (`(error, result) => void`) into one that\n * returns a promise, as Node's `util.promisify`: it resolves with the result, or rejects with the error the callback\n * receives. The function keeps the `this` it is called with.\n * @param fn - The function to wrap.\n * @returns The function that returns a promise.\n */\nexport function promisify<TArgs extends unknown[], TResult>(\n fn: (...args: [...TArgs, (error: unknown, result: TResult) => void]) => void,\n): (...args: TArgs) => Promise<TResult> {\n return function (this: unknown, ...args: TArgs): Promise<TResult> {\n return new Promise<TResult>((resolve, reject) => {\n fn.call(this, ...args, (error: unknown, result: TResult) => {\n if (error !== null && error !== undefined) {\n reject(error);\n } else {\n resolve(result);\n }\n });\n });\n };\n}\n\n\n/**\n * Create a deep, independent copy of a value.\n *\n * Supports primitives, plain objects, arrays, `Date`, `RegExp`, `Map`, `Set`,\n * symbol-keyed properties and circular references. Functions are copied by\n * reference. Class instances preserve their prototype.\n *\n * @template T - The value's type.\n * @param value - The value to clone.\n * @returns A deep clone of `value`.\n */\nexport function deepClone<T>(value: T): T {\n return _deepClone(value);\n}\n\n/**\n * Internal implementation of deep clone.\n * @param value - The value to clone.\n * @param seen - Internal map used to handle circular references.\n */\nfunction _deepClone<T>(\n value: T,\n seen: WeakMap<object, unknown> = new WeakMap()\n): T {\n if (value === null || typeof value !== \"object\") return value;\n\n const obj = value as unknown as object;\n if (seen.has(obj)) return seen.get(obj) as T;\n\n if (value instanceof Date) return new Date(value) as T;\n if (value instanceof RegExp) {\n const copy = new RegExp(value);\n copy.lastIndex = value.lastIndex;\n return copy as T;\n }\n\n if (value instanceof Map) {\n const copy = new Map();\n seen.set(value, copy);\n for (const [k, v] of value) {\n copy.set(_deepClone(k, seen), _deepClone(v, seen));\n }\n return copy as T;\n }\n\n if (value instanceof Set) {\n const copy = new Set();\n seen.set(value, copy);\n for (const v of value) {\n copy.add(_deepClone(v, seen));\n }\n return copy as T;\n }\n\n const copy: any = Array.isArray(value)\n ? []\n : Object.create(Object.getPrototypeOf(value));\n\n seen.set(obj, copy);\n\n for (const key of Reflect.ownKeys(obj)) {\n copy[key] = _deepClone((value as any)[key], seen);\n }\n\n return copy as T;\n}\n\n\n/**\n * Returns the type of the given value.\n *\n * @param {any} value - The value to determine the type of.\n * @return {Type} - The type of the given value.\n * @deprecated use Type.of(...)\n */\nexport function getType(value: any): Type {\n\n return Type.of(value);\n}\n\n/**\n * Patches a method onto a class prototype.\n *\n * This function allows adding new methods to existing classes (monkey-patching).\n * If the method name already exists on the prototype, a warning is issued\n * and the method is not overwritten.\n *\n * If `method` is a function, its name is extracted (if not provided) and\n * it is wrapped to pass the instance (`this`) as the first argument.\n *\n * @template T - The type of the class constructor.\n * @param {T} target - The class constructor whose prototype will be patched.\n * @param {any} method - The implementation or value to patch.\n * @param {string | symbol} [name] - Optional name for the method. If not provided and method is a function, method.name is used.\n * @returns {boolean} Returns `true` if the method was successfully added, or `false` if it already existed.\n */\nexport function monkeyPatch<T extends Constructor>(\n target: T,\n method: any,\n name?: string | symbol\n): boolean {\n\n let methodName;\n let methodValue = method;\n\n if (typeof method === 'function') {\n methodName = name ?? (method as Function).name;\n methodValue = function (this: any, ...args: any[]) {\n return method.apply(this, [this, ...args]);\n };\n } else {\n methodName = name;\n }\n\n if (!methodName) {\n throw new Error(\"Monkey patch failed: No name provided and could not be extracted from function.\");\n }\n\n if (methodName in target.prototype) {\n console.warn(`Method '${String(methodName)}' already exists on ${target.name}`);\n return false;\n }\n\n Object.defineProperty(target.prototype, methodName, {\n value: methodValue,\n writable: true,\n configurable: true,\n enumerable: false\n });\n\n return true;\n}"]}
package/dist/uuid.d.ts ADDED
@@ -0,0 +1,73 @@
1
+ import { Nullable } from './types.js';
2
+ /**
3
+ * Immutable universally unique identifier (RFC 9562), kept in lowercase canonical form,
4
+ * such as `019a4f8b-4bae-7d2e-9f10-4a5b6c7d8e9f`.
5
+ *
6
+ * It serializes to its string with `JSON.stringify`, so DTOs carry it as text; read those
7
+ * strings back with {@link Uuid.parse} or {@link Uuid.tryParse}.
8
+ */
9
+ export default class Uuid {
10
+ private readonly value;
11
+ private constructor();
12
+ /**
13
+ * Generates a version 4 UUID from 122 random bits of a cryptographically secure source.
14
+ *
15
+ * Unlike `crypto.randomUUID()`, it also works in browser contexts that are not secure, such as
16
+ * a development site served over HTTP.
17
+ */
18
+ static generateV4(): Uuid;
19
+ /**
20
+ * Generates a version 7 UUID: a 48-bit Unix timestamp in milliseconds followed by 74 random bits
21
+ * from a cryptographically secure source, so identifiers sort by creation time.
22
+ *
23
+ * Identifiers generated within the same millisecond keep no particular order among themselves.
24
+ *
25
+ * @param date Moment the UUID encodes; the current time when omitted.
26
+ * @throws {RangeError} If the date is invalid, before the Unix epoch or beyond the 48-bit range.
27
+ */
28
+ static generateV7(date?: Date): Uuid;
29
+ /**
30
+ * Checks if a value is a UUID in canonical form, in any letter case: one of RFC 9562 versions 1 to 8,
31
+ * or its Nil UUID (all zeros) or Max UUID (all ones).
32
+ *
33
+ * It returns a plain boolean rather than a type guard: a string that is not a UUID is still a
34
+ * string, which a guard would narrow to `never`.
35
+ */
36
+ static isValid(value: unknown): boolean;
37
+ /**
38
+ * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.
39
+ *
40
+ * @throws {SyntaxError} If the value is not a UUID.
41
+ */
42
+ static parse(value: string): Uuid;
43
+ /**
44
+ * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.
45
+ *
46
+ * @returns The UUID, or `undefined` when the value is not one.
47
+ */
48
+ static tryParse(value: unknown): Uuid | undefined;
49
+ /**
50
+ * The RFC 9562 version, from 1 to 8, or 0 for the Nil UUID and 15 for the Max UUID.
51
+ */
52
+ get version(): number;
53
+ /**
54
+ * The moment a version 7 UUID encodes, with millisecond precision.
55
+ *
56
+ * It is `null` for other versions.
57
+ */
58
+ get date(): Nullable<Date>;
59
+ equals(other: Uuid): boolean;
60
+ /**
61
+ * Returns the UUID in lowercase canonical form.
62
+ */
63
+ toString(): string;
64
+ toJSON(): string;
65
+ /**
66
+ * Sets the version and the RFC 9562 variant bits of 16 bytes and wraps them as a UUID.
67
+ *
68
+ * @param bytes Exactly 16 bytes; only the version and variant bits are overwritten.
69
+ * @param version From 1 to 8.
70
+ */
71
+ private static createWithVersion;
72
+ }
73
+ //# sourceMappingURL=uuid.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAQpC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAOzB;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,GAAE,IAAiB,GAAG,IAAI;IAiBhD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIvC;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASjC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS;IAQjD;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAOzB;IAED,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAI5B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAWnC"}
package/dist/uuid.js ADDED
@@ -0,0 +1,129 @@
1
+ /** Versions 1 to 8 with the RFC variant, plus the Nil and Max UUIDs of RFC 9562 sections 5.9 and 5.10. */
2
+ const PATTERN = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$/i;
3
+ /** Largest Unix timestamp in milliseconds that fits in the 48 bits of a version 7 UUID. */
4
+ const MAX_V7_MILLISECONDS = 0xffffffffffff;
5
+ /**
6
+ * Immutable universally unique identifier (RFC 9562), kept in lowercase canonical form,
7
+ * such as `019a4f8b-4bae-7d2e-9f10-4a5b6c7d8e9f`.
8
+ *
9
+ * It serializes to its string with `JSON.stringify`, so DTOs carry it as text; read those
10
+ * strings back with {@link Uuid.parse} or {@link Uuid.tryParse}.
11
+ */
12
+ export default class Uuid {
13
+ constructor(value) {
14
+ this.value = value;
15
+ }
16
+ /**
17
+ * Generates a version 4 UUID from 122 random bits of a cryptographically secure source.
18
+ *
19
+ * Unlike `crypto.randomUUID()`, it also works in browser contexts that are not secure, such as
20
+ * a development site served over HTTP.
21
+ */
22
+ static generateV4() {
23
+ const bytes = new Uint8Array(16);
24
+ globalThis.crypto.getRandomValues(bytes);
25
+ return Uuid.createWithVersion(bytes, 4);
26
+ }
27
+ /**
28
+ * Generates a version 7 UUID: a 48-bit Unix timestamp in milliseconds followed by 74 random bits
29
+ * from a cryptographically secure source, so identifiers sort by creation time.
30
+ *
31
+ * Identifiers generated within the same millisecond keep no particular order among themselves.
32
+ *
33
+ * @param date Moment the UUID encodes; the current time when omitted.
34
+ * @throws {RangeError} If the date is invalid, before the Unix epoch or beyond the 48-bit range.
35
+ */
36
+ static generateV7(date = new Date()) {
37
+ const milliseconds = date.getTime();
38
+ if (!Number.isInteger(milliseconds) || milliseconds < 0 || milliseconds > MAX_V7_MILLISECONDS) {
39
+ throw new RangeError('A version 7 UUID can only encode a valid date from the Unix epoch on.');
40
+ }
41
+ const bytes = new Uint8Array(16);
42
+ globalThis.crypto.getRandomValues(bytes);
43
+ let remaining = milliseconds;
44
+ for (let index = 5; index >= 0; index--) {
45
+ bytes[index] = remaining % 256;
46
+ remaining = Math.floor(remaining / 256);
47
+ }
48
+ return Uuid.createWithVersion(bytes, 7);
49
+ }
50
+ /**
51
+ * Checks if a value is a UUID in canonical form, in any letter case: one of RFC 9562 versions 1 to 8,
52
+ * or its Nil UUID (all zeros) or Max UUID (all ones).
53
+ *
54
+ * It returns a plain boolean rather than a type guard: a string that is not a UUID is still a
55
+ * string, which a guard would narrow to `never`.
56
+ */
57
+ static isValid(value) {
58
+ return typeof value === 'string' && PATTERN.test(value);
59
+ }
60
+ /**
61
+ * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.
62
+ *
63
+ * @throws {SyntaxError} If the value is not a UUID.
64
+ */
65
+ static parse(value) {
66
+ const uuid = Uuid.tryParse(value);
67
+ if (uuid === undefined) {
68
+ throw new SyntaxError(`Invalid UUID "${value}".`);
69
+ }
70
+ return uuid;
71
+ }
72
+ /**
73
+ * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.
74
+ *
75
+ * @returns The UUID, or `undefined` when the value is not one.
76
+ */
77
+ static tryParse(value) {
78
+ if (typeof value !== 'string' || !Uuid.isValid(value)) {
79
+ return undefined;
80
+ }
81
+ return new Uuid(value.toLowerCase());
82
+ }
83
+ /**
84
+ * The RFC 9562 version, from 1 to 8, or 0 for the Nil UUID and 15 for the Max UUID.
85
+ */
86
+ get version() {
87
+ return Number.parseInt(this.value.charAt(14), 16);
88
+ }
89
+ /**
90
+ * The moment a version 7 UUID encodes, with millisecond precision.
91
+ *
92
+ * It is `null` for other versions.
93
+ */
94
+ get date() {
95
+ if (this.version !== 7) {
96
+ return null;
97
+ }
98
+ const milliseconds = Number.parseInt(this.value.slice(0, 8) + this.value.slice(9, 13), 16);
99
+ return new Date(milliseconds);
100
+ }
101
+ equals(other) {
102
+ return this.value === other.value;
103
+ }
104
+ /**
105
+ * Returns the UUID in lowercase canonical form.
106
+ */
107
+ toString() {
108
+ return this.value;
109
+ }
110
+ toJSON() {
111
+ return this.value;
112
+ }
113
+ /**
114
+ * Sets the version and the RFC 9562 variant bits of 16 bytes and wraps them as a UUID.
115
+ *
116
+ * @param bytes Exactly 16 bytes; only the version and variant bits are overwritten.
117
+ * @param version From 1 to 8.
118
+ */
119
+ static createWithVersion(bytes, version) {
120
+ bytes[6] = (bytes[6] & 0x0f) | (version << 4);
121
+ bytes[8] = (bytes[8] & 0x3f) | 0x80;
122
+ let hex = '';
123
+ for (const byte of bytes) {
124
+ hex += byte.toString(16).padStart(2, '0');
125
+ }
126
+ return new Uuid(`${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`);
127
+ }
128
+ }
129
+ //# sourceMappingURL=uuid.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uuid.js","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"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","sourcesContent":["import {Nullable} from './types.js';\n\n/** Versions 1 to 8 with the RFC variant, plus the Nil and Max UUIDs of RFC 9562 sections 5.9 and 5.10. */\nconst PATTERN = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$/i;\n\n/** Largest Unix timestamp in milliseconds that fits in the 48 bits of a version 7 UUID. */\nconst MAX_V7_MILLISECONDS = 0xffffffffffff;\n\n/**\n * Immutable universally unique identifier (RFC 9562), kept in lowercase canonical form,\n * such as `019a4f8b-4bae-7d2e-9f10-4a5b6c7d8e9f`.\n *\n * It serializes to its string with `JSON.stringify`, so DTOs carry it as text; read those\n * strings back with {@link Uuid.parse} or {@link Uuid.tryParse}.\n */\nexport default class Uuid {\n private readonly value: string;\n\n private constructor(value: string) {\n this.value = value;\n }\n\n /**\n * Generates a version 4 UUID from 122 random bits of a cryptographically secure source.\n *\n * Unlike `crypto.randomUUID()`, it also works in browser contexts that are not secure, such as\n * a development site served over HTTP.\n */\n static generateV4(): Uuid {\n const bytes = new Uint8Array(16);\n globalThis.crypto.getRandomValues(bytes);\n\n return Uuid.createWithVersion(bytes, 4);\n }\n\n /**\n * Generates a version 7 UUID: a 48-bit Unix timestamp in milliseconds followed by 74 random bits\n * from a cryptographically secure source, so identifiers sort by creation time.\n *\n * Identifiers generated within the same millisecond keep no particular order among themselves.\n *\n * @param date Moment the UUID encodes; the current time when omitted.\n * @throws {RangeError} If the date is invalid, before the Unix epoch or beyond the 48-bit range.\n */\n static generateV7(date: Date = new Date()): Uuid {\n const milliseconds = date.getTime();\n if (!Number.isInteger(milliseconds) || milliseconds < 0 || milliseconds > MAX_V7_MILLISECONDS) {\n throw new RangeError('A version 7 UUID can only encode a valid date from the Unix epoch on.');\n }\n\n const bytes = new Uint8Array(16);\n globalThis.crypto.getRandomValues(bytes);\n let remaining = milliseconds;\n for (let index = 5; index >= 0; index--) {\n bytes[index] = remaining % 256;\n remaining = Math.floor(remaining / 256);\n }\n\n return Uuid.createWithVersion(bytes, 7);\n }\n\n /**\n * Checks if a value is a UUID in canonical form, in any letter case: one of RFC 9562 versions 1 to 8,\n * or its Nil UUID (all zeros) or Max UUID (all ones).\n *\n * It returns a plain boolean rather than a type guard: a string that is not a UUID is still a\n * string, which a guard would narrow to `never`.\n */\n static isValid(value: unknown): boolean {\n return typeof value === 'string' && PATTERN.test(value);\n }\n\n /**\n * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.\n *\n * @throws {SyntaxError} If the value is not a UUID.\n */\n static parse(value: string): Uuid {\n const uuid = Uuid.tryParse(value);\n if (uuid === undefined) {\n throw new SyntaxError(`Invalid UUID \"${value}\".`);\n }\n\n return uuid;\n }\n\n /**\n * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.\n *\n * @returns The UUID, or `undefined` when the value is not one.\n */\n static tryParse(value: unknown): Uuid | undefined {\n if (typeof value !== 'string' || !Uuid.isValid(value)) {\n return undefined;\n }\n\n return new Uuid(value.toLowerCase());\n }\n\n /**\n * The RFC 9562 version, from 1 to 8, or 0 for the Nil UUID and 15 for the Max UUID.\n */\n get version(): number {\n return Number.parseInt(this.value.charAt(14), 16);\n }\n\n /**\n * The moment a version 7 UUID encodes, with millisecond precision.\n *\n * It is `null` for other versions.\n */\n get date(): Nullable<Date> {\n if (this.version !== 7) {\n return null;\n }\n\n const milliseconds = Number.parseInt(this.value.slice(0, 8) + this.value.slice(9, 13), 16);\n return new Date(milliseconds);\n }\n\n equals(other: Uuid): boolean {\n return this.value === other.value;\n }\n\n /**\n * Returns the UUID in lowercase canonical form.\n */\n toString(): string {\n return this.value;\n }\n\n toJSON(): string {\n return this.value;\n }\n\n /**\n * Sets the version and the RFC 9562 variant bits of 16 bytes and wraps them as a UUID.\n *\n * @param bytes Exactly 16 bytes; only the version and variant bits are overwritten.\n * @param version From 1 to 8.\n */\n private static createWithVersion(bytes: Uint8Array, version: number): Uuid {\n bytes[6] = (bytes[6] & 0x0f) | (version << 4);\n bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n let hex = '';\n for (const byte of bytes) {\n hex += byte.toString(16).padStart(2, '0');\n }\n\n return new Uuid(`${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`);\n }\n}\n"]}
package/package.json CHANGED
@@ -1,12 +1,15 @@
1
1
  {
2
2
  "name": "@develia/commons",
3
- "version": "0.4.26",
3
+ "version": "0.6.1",
4
4
  "author": {
5
5
  "name": "Antonio Gil Espinosa",
6
6
  "email": "antonio.gil.espinosa@gmail.com",
7
7
  "url": "https://antoniogilespinosa.com"
8
8
  },
9
9
  "type": "module",
10
+ "engines": {
11
+ "node": ">=20"
12
+ },
10
13
  "main": "./dist/index.js",
11
14
  "types": "./dist/index.d.ts",
12
15
  "exports": {
@@ -17,6 +20,7 @@
17
20
  "./parse": "./dist/parse.js",
18
21
  "./string": "./dist/string.js",
19
22
  "./math": "./dist/math.js",
23
+ "./uuid": "./dist/uuid.js",
20
24
  "./collections": "./dist/collections/index.js",
21
25
  "./browser": "./dist/browser/index.js"
22
26
  },
package/src/array.ts CHANGED
@@ -49,6 +49,25 @@ export function chunk<T>(array: Array<T>, size: number): Array<Array<T>> {
49
49
  return result;
50
50
  }
51
51
 
52
+ /**
53
+ * A copy of the array with the element at one index moved to another, the others shifting to make room; the array
54
+ * stays as it was. An index out of the array leaves the copy in the same order.
55
+ * @template T
56
+ * @param {ReadonlyArray<T>} array - The array.
57
+ * @param {number} fromIndex - Index of the element to move.
58
+ * @param {number} toIndex - Index the element ends at.
59
+ * @return {Array<T>} The copy, in the new order.
60
+ */
61
+ export function moveItem<T>(array: ReadonlyArray<T>, fromIndex: number, toIndex: number): Array<T> {
62
+ const result = [...array];
63
+ if (fromIndex < 0 || fromIndex >= result.length || toIndex < 0 || toIndex >= result.length) {
64
+ return result;
65
+ }
66
+ const [item] = result.splice(fromIndex, 1);
67
+ result.splice(toIndex, 0, item as T);
68
+ return result;
69
+ }
70
+
52
71
  /**
53
72
  * Removes all elements from the array, mutating it.
54
73
  * @template T
@@ -7,11 +7,11 @@ type QueuedTask<T> = {
7
7
  reject: (reason?: any) => void;
8
8
  };
9
9
 
10
- function normalizeMaxConcurrency(value: number): number {
10
+ /** @throws {RangeError} When it is not a positive integer. */
11
+ function assertValidMaxConcurrency(value: number): void {
11
12
  if (!Number.isInteger(value) || value < 1) {
12
13
  throw new RangeError("maxConcurrency must be a positive integer");
13
14
  }
14
- return value;
15
15
  }
16
16
 
17
17
  function normalizeCheckInterval(value: number): number {
@@ -26,7 +26,8 @@ export default class AsyncPoolExecutor {
26
26
  }
27
27
 
28
28
  set maxConcurrency(value: number) {
29
- this._maxConcurrency = normalizeMaxConcurrency(value);
29
+ assertValidMaxConcurrency(value);
30
+ this._maxConcurrency = value;
30
31
 
31
32
  }
32
33
 
@@ -41,7 +42,8 @@ export default class AsyncPoolExecutor {
41
42
  * @param {number} [checkInterval=50] - The interval, in milliseconds, to check for capacity to run new tasks. Defaults to 50 ms.
42
43
  */
43
44
  constructor(maxConcurrency: number, checkInterval: number = 50) {
44
- this._maxConcurrency = normalizeMaxConcurrency(maxConcurrency);
45
+ assertValidMaxConcurrency(maxConcurrency);
46
+ this._maxConcurrency = maxConcurrency;
45
47
  this._checkIntervalMs = normalizeCheckInterval(checkInterval);
46
48
  this._activeTasks = 0;
47
49
  }
@@ -94,12 +96,10 @@ export default class AsyncPoolExecutor {
94
96
 
95
97
 
96
98
  /**
97
- * Waits until all tasks (both queued and active) are completed.
98
- * This method resolves only when there are no pending tasks.
99
- *
100
- * @return {Promise<void>} A promise that resolves when all tasks are complete.
99
+ * Waits until the queue is empty and no task is running, checking every check interval. It does not stop the
100
+ * executor: tasks submitted meanwhile are run and waited for too.
101
101
  */
102
- public async shutdown(): Promise<void> {
102
+ public async drain(): Promise<void> {
103
103
  while (this._taskQueue.length > 0 || this._activeTasks > 0) {
104
104
  await delay(this._checkIntervalMs);
105
105
  }
@@ -125,13 +125,13 @@ function _appendFormDataValue(formData: FormData, key: string, value: any): void
125
125
  _appendFormDataValue(formData, `${key}[${index}]`, value[index]);
126
126
  }
127
127
  } else if (value !== null && typeof value === 'object') {
128
- _objectToFormData(value, formData, key);
128
+ _appendToFormData(value, formData, key);
129
129
  } else {
130
130
  formData.append(key, value);
131
131
  }
132
132
  }
133
133
 
134
- function _objectToFormData(data: Record<string, any>, formData: FormData, parentKey: string = ''): FormData {
134
+ function _appendToFormData(data: Record<string, any>, formData: FormData, parentKey: string = ''): FormData {
135
135
  for (const key in data) {
136
136
  if (Object.prototype.hasOwnProperty.call(data, key)) {
137
137
  _appendFormDataValue(formData, parentKey ? `${parentKey}[${key}]` : key, data[key]);
@@ -149,34 +149,5 @@ function _objectToFormData(data: Record<string, any>, formData: FormData, parent
149
149
  */
150
150
  export function objectToFormData(data: Record<string, any>): FormData {
151
151
  let formData = new FormData();
152
- return _objectToFormData(data, formData);
152
+ return _appendToFormData(data, formData);
153
153
  }
154
-
155
- export function ajaxSubmission(
156
- selectorOrElement: HTMLFormElement | string,
157
- onSuccess?: Consumer<any>,
158
- onFailure?: Consumer<any>
159
- ): void {
160
-
161
- const forms: HTMLFormElement[] = typeof selectorOrElement === 'string'
162
- ? Array.from(document.querySelectorAll(selectorOrElement))
163
- .filter(el => el instanceof HTMLFormElement) as HTMLFormElement[]
164
- : [selectorOrElement];
165
-
166
- for (const form of forms) {
167
- form.addEventListener('submit', async (event) => {
168
- event.preventDefault();
169
-
170
- try {
171
- let result = await ajaxSubmit(event.currentTarget as HTMLFormElement);
172
- if (onSuccess)
173
- onSuccess(result);
174
- } catch (e) {
175
- if (onFailure)
176
- onFailure(e);
177
- }
178
-
179
-
180
- });
181
- }
182
- }
@@ -33,7 +33,7 @@ function positionToGeoLocation(position: GeolocationPosition): GeoLocation {
33
33
  };
34
34
  }
35
35
 
36
- function geolocationError(error: GeolocationPositionError): Error {
36
+ function toGeolocationError(error: GeolocationPositionError): Error {
37
37
  switch (error.code) {
38
38
  case error.PERMISSION_DENIED:
39
39
  return new Error('Has denegado el permiso de ubicación.');
@@ -50,7 +50,7 @@ function requestPosition(options: PositionOptions): Promise<GeoLocation> {
50
50
  return new Promise((resolve, reject) => {
51
51
  navigator.geolocation.getCurrentPosition(
52
52
  (position) => resolve(positionToGeoLocation(position)),
53
- (error) => reject(geolocationError(error)),
53
+ (error) => reject(toGeolocationError(error)),
54
54
  options,
55
55
  );
56
56
  });
@@ -87,7 +87,7 @@ async function ensurePermission(): Promise<void> {
87
87
  },
88
88
  (error) => {
89
89
  permission.onchange = null;
90
- reject(geolocationError(error));
90
+ reject(toGeolocationError(error));
91
91
  },
92
92
  {timeout: 30000},
93
93
  );
File without changes
@@ -34,7 +34,7 @@ export default class NativeBridge {
34
34
  }
35
35
 
36
36
  (window as any)[callbackName] = (id: number, error: any, result: any) => {
37
- this._callback(id, error, result);
37
+ this._settlePendingCall(id, error, result);
38
38
  };
39
39
 
40
40
  // Proxy: cualquier propiedad no existente se convierte en call()
@@ -49,7 +49,7 @@ export default class NativeBridge {
49
49
  }
50
50
 
51
51
 
52
- private _callback(id: number, error: any, result: any) {
52
+ private _settlePendingCall(id: number, error: any, result: any) {
53
53
 
54
54
  const pending = this._pending.get(id);
55
55
  if (!pending) {
@@ -36,9 +36,14 @@ export default class CancellablePromise<T> extends Promise<T> {
36
36
  }
37
37
  }
38
38
 
39
- static async compete<T>(promises: CancellablePromise<T>[]): Promise<T> {
39
+ /**
40
+ * Resolves or rejects as the first of the promises to settle (Promise.race), and cancels all the others, also when
41
+ * the first one fails.
42
+ * @throws {Error} When there are no promises.
43
+ */
44
+ static async raceAndCancelOthers<T>(promises: CancellablePromise<T>[]): Promise<T> {
40
45
  if (promises.length === 0) {
41
- throw new Error("No promises to compete.");
46
+ throw new Error("No promises to race.");
42
47
  }
43
48
 
44
49
  const result = await Promise.race(
@@ -61,7 +66,8 @@ export default class CancellablePromise<T> extends Promise<T> {
61
66
  return result.value;
62
67
  }
63
68
 
64
- static async cooperate<T>(promises: CancellablePromise<T>[]): Promise<T[]> {
69
+ /** Resolves with all the results (Promise.all); when one fails, cancels all of them and rejects with its error. */
70
+ static async allOrCancelAll<T>(promises: CancellablePromise<T>[]): Promise<T[]> {
65
71
  try {
66
72
  return await Promise.all(promises);
67
73
  } catch (error) {