@unchainedshop/utils 5.0.0-alpha.1 → 5.0.0-alpha.3

package/lib/generate-random-hash.js

@@ -1,7 +1,3 @@
-import Hashids from 'hashids';
-const hashids = new Hashids('unchained', 6, 'ABCDEFGHIJKLMNPQRSTUVWXYZ23456789');
-export default () => {
-    const randomBytes = crypto.getRandomValues(new Uint32Array(1));
-    const randomNumber = (randomBytes[0] % 999999998) + 1;
-    return hashids.encode(randomNumber);
-};
+import { randomInt } from 'node:crypto';
+const ALPHABET = 'ABCDEFGHIJKLMNPQRSTUVWXYZ23456789';
+export default () => Array.from({ length: 6 }, () => ALPHABET[randomInt(ALPHABET.length)]).join('');

package/lib/memoize-with-ttl.d.ts

@@ -1,8 +1,9 @@
-type AsyncFunction = (...args: any[]) => Promise<any>;
-interface MemoizeOptions {
-    cacheKey?: (args: any[]) => string;
-}
-export declare function memoizeWithTTL<T extends AsyncFunction>(fn: T, ttlMs: number, options?: MemoizeOptions): T & {
+export interface MemoizedWithTTL<A extends unknown[], R> {
+    (...args: A): Promise<R>;
     clear: () => void;
-};
-export {};
+    delete: (key: unknown) => boolean;
+}
+export default function memoizeWithTTL<A extends unknown[], R>(fn: (...args: A) => Promise<R>, { ttl, cacheKey }: {
+    ttl: number;
+    cacheKey?: (args: A) => unknown;
+}): MemoizedWithTTL<A, R>;

package/lib/memoize-with-ttl.js

@@ -1,35 +1,27 @@
-function createTTLCache(ttlMs) {
-    const store = new Map();
-    return {
-        get(key) {
-            const entry = store.get(key);
-            if (!entry)
-                return undefined;
-            if (Date.now() > entry.expiry) {
-                store.delete(key);
-                return undefined;
-            }
-            return entry.value;
-        },
-        set(key, value) {
-            store.set(key, { value, expiry: Date.now() + ttlMs });
-        },
-        clear() {
-            store.clear();
-        },
-    };
-}
-export function memoizeWithTTL(fn, ttlMs, options) {
-    const cache = createTTLCache(ttlMs);
-    const memoized = async function (...args) {
-        const key = options?.cacheKey ? options.cacheKey(args) : JSON.stringify(args);
-        const cached = cache.get(key);
-        if (cached !== undefined)
-            return cached;
-        const result = await fn(...args);
-        cache.set(key, result);
-        return result;
+export default function memoizeWithTTL(fn, { ttl, cacheKey = (args) => args[0] }) {
+    const cache = new Map();
+    const memoized = (...args) => {
+        const key = cacheKey(args);
+        const now = Date.now();
+        const hit = cache.get(key);
+        if (hit && (!hit.settled || hit.expires > now))
+            return hit.promise;
+        for (const [expiredKey, entry] of cache) {
+            if (entry.settled && entry.expires <= now)
+                cache.delete(expiredKey);
+        }
+        const entry = { promise: fn(...args), settled: false, expires: Infinity };
+        cache.set(key, entry);
+        entry.promise.then(() => {
+            entry.settled = true;
+            entry.expires = Date.now() + ttl;
+        }, () => {
+            if (cache.get(key) === entry)
+                cache.delete(key);
+        });
+        return entry.promise;
     };
     memoized.clear = () => cache.clear();
+    memoized.delete = (key) => cache.delete(key);
     return memoized;
 }

package/lib/phone-number.d.ts

@@ -0,0 +1,5 @@
+export declare const normalizePhoneNumber: (value?: string | null, defaultCountry?: string | null) => string | undefined;
+export declare const phoneNumberToParts: (value?: string | null, defaultCountry?: string | null) => {
+    cc: string;
+    subscriber: string;
+} | undefined;

package/lib/phone-number.js

@@ -0,0 +1,17 @@
+import { parsePhoneNumberFromString } from 'libphonenumber-js';
+export const normalizePhoneNumber = (value, defaultCountry) => {
+    if (!value)
+        return undefined;
+    const parsed = parsePhoneNumberFromString(value, (defaultCountry || undefined));
+    if (!parsed?.isValid())
+        return undefined;
+    return parsed.number;
+};
+export const phoneNumberToParts = (value, defaultCountry) => {
+    if (!value)
+        return undefined;
+    const parsed = parsePhoneNumberFromString(value, (defaultCountry || undefined));
+    if (!parsed?.isValid())
+        return undefined;
+    return { cc: parsed.countryCallingCode, subscriber: parsed.nationalNumber };
+};

package/lib/utils-index.d.ts

@@ -9,7 +9,8 @@ export { default as buildObfuscatedFieldsFilter } from './build-obfuscated-field
 export { default as sha256 } from './sha256.ts';
 export { default as sha1 } from './sha1.ts';
 export { timingSafeEqual, timingSafeStringEqual } from './timing-safe-equal.ts';
-export { memoizeWithTTL } from './memoize-with-ttl.ts';
+export { normalizePhoneNumber, phoneNumberToParts } from './phone-number.ts';
+export { default as memoizeWithTTL } from './memoize-with-ttl.ts';
 export declare const SortDirection: {
     readonly ASC: "ASC";
     readonly DESC: "DESC";

package/lib/utils-index.js

@@ -9,7 +9,8 @@ export { default as buildObfuscatedFieldsFilter } from "./build-obfuscated-field
 export { default as sha256 } from "./sha256.js";
 export { default as sha1 } from "./sha1.js";
 export { timingSafeEqual, timingSafeStringEqual } from "./timing-safe-equal.js";
-export { memoizeWithTTL } from "./memoize-with-ttl.js";
+export { normalizePhoneNumber, phoneNumberToParts } from "./phone-number.js";
+export { default as memoizeWithTTL } from "./memoize-with-ttl.js";
 export const SortDirection = {
     ASC: 'ASC',
     DESC: 'DESC',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unchainedshop/utils",
   "description": "Common utility functions and base classes for the Unchained Engine",
-  "version": "5.0.0-alpha.1",
+  "version": "5.0.0-alpha.3",
   "main": "lib/utils-index.js",
   "types": "lib/utils-index.d.ts",
   "type": "module",
@@ -30,10 +30,10 @@
   "homepage": "https://github.com/unchainedshop/unchained#readme",
   "dependencies": {
     "@unchainedshop/logger": "^5.0.0-alpha.1",
-    "hashids": "^2.3.0"
+    "libphonenumber-js": "^1.11.0"
   },
   "devDependencies": {
-    "@types/node": "^25.0.0",
+    "@types/node": "^26.2.0",
     "typescript": "^5.8.3"
   }
 }