@modern-js/runtime-utils 2.69.4 → 3.0.0-alpha.0

package/dist/esm/node/storer/storage.mjs

@@ -0,0 +1,53 @@
+class Storage {
+    async keys() {
+        const _keys = [];
+        this.forEach?.((_, k)=>{
+            _keys.push(k);
+        });
+        return _keys;
+    }
+    async values() {
+        const _values = [];
+        this.forEach?.((v)=>{
+            _values.push(v);
+        });
+        return _values;
+    }
+    get(key) {
+        const uniqueKey = this.computedUniqueKey(key);
+        return this.container.get(uniqueKey);
+    }
+    async set(key, value) {
+        const uniqueKey = this.computedUniqueKey(key);
+        await this.container.set(uniqueKey, value);
+        return this;
+    }
+    has(key) {
+        const uniqueKey = this.computedUniqueKey(key);
+        return this.container.has(uniqueKey);
+    }
+    delete(key) {
+        const uniqueKey = this.computedUniqueKey(key);
+        return this.container.delete(uniqueKey);
+    }
+    async clear() {
+        const keys = await this.keys?.();
+        await Promise.all(keys?.map(async (key)=>this.container.delete(key)) || []);
+    }
+    forEach(fallbackFn) {
+        this.container.forEach?.((v, k)=>{
+            if (this.checkIsOwnkey(k)) fallbackFn(v, k, this);
+        });
+    }
+    computedUniqueKey(k) {
+        return `${this.namespace}:${k}`;
+    }
+    checkIsOwnkey(k) {
+        return k.startsWith(this.namespace);
+    }
+    constructor(namespace, container){
+        this.namespace = namespace;
+        this.container = container;
+    }
+}
+export { Storage };

package/dist/esm/node/stream.mjs

@@ -0,0 +1,68 @@
+import { Stream } from "stream";
+const createReadableStreamFromReadable = (source)=>{
+    const pump = new StreamPump(source);
+    const stream = new ReadableStream(pump, pump);
+    return stream;
+};
+class StreamPump {
+    size(chunk) {
+        return chunk?.byteLength || 0;
+    }
+    start(controller) {
+        this.controller = controller;
+        this.stream.on('data', this.enqueue);
+        this.stream.once('error', this.error);
+        this.stream.once('end', this.close);
+        this.stream.once('close', this.close);
+    }
+    pull() {
+        this.resume();
+    }
+    cancel(reason) {
+        if (this.stream.destroy) this.stream.destroy(reason);
+        process.nextTick(()=>{
+            this.stream.off('data', this.enqueue);
+            this.stream.off('error', this.error);
+            this.stream.off('end', this.close);
+            this.stream.off('close', this.close);
+        });
+    }
+    enqueue(chunk) {
+        if (this.controller) try {
+            const bytes = chunk instanceof Uint8Array ? chunk : Buffer.from(chunk);
+            const available = (this.controller.desiredSize || 0) - bytes.byteLength;
+            this.controller.enqueue(bytes);
+            if (available <= 0) this.pause();
+        } catch (error) {
+            this.controller.error(new Error('Could not create Buffer, chunk must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object'));
+            this.cancel();
+        }
+    }
+    pause() {
+        if (this.stream.pause) this.stream.pause();
+    }
+    resume() {
+        if (this.stream.readable && this.stream.resume) this.stream.resume();
+    }
+    close() {
+        if (this.controller) {
+            this.controller.close();
+            delete this.controller;
+        }
+    }
+    error(error) {
+        if (this.controller) {
+            this.controller.error(error);
+            delete this.controller;
+        }
+    }
+    constructor(stream){
+        this.highWaterMark = stream.readableHighWaterMark || new Stream.Readable().readableHighWaterMark;
+        this.accumalatedSize = 0;
+        this.stream = stream;
+        this.enqueue = this.enqueue.bind(this);
+        this.error = this.error.bind(this);
+        this.close = this.close.bind(this);
+    }
+}
+export { createReadableStreamFromReadable };

package/dist/esm/parsed.mjs

@@ -0,0 +1,12 @@
+const parsedJSONFromElement = (id)=>{
+    const elements = document.querySelectorAll(`#${id}`);
+    if (0 === elements.length) return;
+    const element = elements[elements.length - 1];
+    if (element) try {
+        const parsed = JSON.parse(element?.textContent || '');
+        return parsed;
+    } catch (e) {
+        console.error(`parse ${id} error`, e);
+    }
+};
+export { parsedJSONFromElement };

package/dist/esm/router.mjs

@@ -0,0 +1,18 @@
+export * from "react-router";
+const DEFERRED_SYMBOL = Symbol('deferred');
+const json = (data, init)=>{
+    const responseInit = init ? 'number' == typeof init ? {
+        status: init
+    } : init : void 0;
+    return new Response(JSON.stringify(data), responseInit);
+};
+const defer = (data, init)=>{
+    if (void 0 === init) return data;
+    {
+        const responseInit = init ? 'number' == typeof init ? {
+            status: init
+        } : init : void 0;
+        return new Response(JSON.stringify(data), responseInit);
+    }
+};
+export { DEFERRED_SYMBOL, defer, json };

package/dist/esm/rsc.mjs

@@ -0,0 +1 @@
+export * from "react-router";

package/dist/esm/server/nestedRoutes.mjs

@@ -0,0 +1,15 @@
+function sortByUrlPath(entries) {
+    entries.sort(function(a, b) {
+        const length1 = a.urlPath.length;
+        const length2 = b.urlPath.length;
+        if (length1 < length2) return 1;
+        if (length1 > length2) return -1;
+        return 0;
+    });
+    return entries;
+}
+const matchEntry = (pathname, entries)=>{
+    sortByUrlPath(entries);
+    return entries.find((entry)=>pathname.startsWith(entry.urlPath));
+};
+export { matchEntry };

package/dist/esm/time.mjs

@@ -0,0 +1,27 @@
+function processHrtime(previousTimestamp) {
+    const now = new Date().getTime();
+    const clocktime = 1e-3 * now;
+    let seconds = Math.floor(clocktime);
+    let nanoseconds = Math.floor(clocktime % 1 * 1e9);
+    if (previousTimestamp) {
+        seconds -= previousTimestamp[0];
+        nanoseconds -= previousTimestamp[1];
+        if (nanoseconds < 0) {
+            seconds--;
+            nanoseconds += 1e9;
+        }
+    }
+    return [
+        seconds,
+        nanoseconds
+    ];
+}
+const getLatency = (hrtime)=>{
+    const [s, ns] = processHrtime(hrtime);
+    return 1e3 * s + ns / 1e6;
+};
+const time = ()=>{
+    const hrtime = processHrtime();
+    return ()=>getLatency(hrtime);
+};
+export { time };

package/dist/esm/universal/async_storage.mjs

@@ -0,0 +1,7 @@
+const isBrowser = "u" > typeof window && void 0 !== window.document;
+const getAsyncLocalStorage = async ()=>{
+    if (!isBrowser) return null;
+    console.error('You should not get async storage in browser');
+    return null;
+};
+export { getAsyncLocalStorage };

package/dist/esm/universal/async_storage.server.mjs

@@ -0,0 +1,32 @@
+import { AsyncLocalStorage } from "async_hooks";
+const createStorage = ()=>{
+    let storage;
+    if (void 0 !== AsyncLocalStorage) storage = new AsyncLocalStorage();
+    const run = (context, cb)=>{
+        if (!storage) throw new Error(`Unable to use async_hook, please confirm the node version >= 12.17
+        `);
+        return new Promise((resolve, reject)=>{
+            storage.run(context, ()=>{
+                try {
+                    return resolve(cb());
+                } catch (error) {
+                    return reject(error);
+                }
+            });
+        });
+    };
+    const useContext = ()=>{
+        if (!storage) throw new Error(`Unable to use async_hook, please confirm the node version >= 12.17
+        `);
+        const context = storage?.getStore();
+        if (!context) throw new Error("Can't call useContext out of scope, make sure @modern-js/runtime-utils is a single version in node_modules");
+        return context;
+    };
+    return {
+        run,
+        useContext
+    };
+};
+const async_storage_server_storage = createStorage();
+const getAsyncLocalStorage = async ()=>async_storage_server_storage;
+export { getAsyncLocalStorage, async_storage_server_storage as storage };

package/dist/esm/universal/cache.mjs

@@ -0,0 +1,326 @@
+import { LRUCache } from "lru-cache";
+import { getAsyncLocalStorage } from "./async_storage";
+const CacheSize = {
+    KB: 1024,
+    MB: 1048576,
+    GB: 1073741824
+};
+const CacheTime = {
+    SECOND: 1000,
+    MINUTE: 60000,
+    HOUR: 3600000,
+    DAY: 86400000,
+    WEEK: 604800000,
+    MONTH: 2592000000
+};
+function estimateObjectSize(data) {
+    const type = typeof data;
+    if ('number' === type) return 8;
+    if ('boolean' === type) return 4;
+    if ('string' === type) return Math.max(2 * data.length, 1);
+    if (null == data) return 1;
+    if (ArrayBuffer.isView(data)) return Math.max(data.byteLength, 1);
+    if (Array.isArray(data)) return Math.max(data.reduce((acc, item)=>acc + estimateObjectSize(item), 0), 1);
+    if (data instanceof Map || data instanceof Set) return 1024;
+    if (data instanceof Date) return 8;
+    if ('object' === type) return Math.max(Object.entries(data).reduce((acc, [key, value])=>acc + 2 * key.length + estimateObjectSize(value), 0), 1);
+    return 1;
+}
+class MemoryContainer {
+    async get(key) {
+        return this.lru.get(key);
+    }
+    async set(key, value, options) {
+        if (options?.ttl) this.lru.set(key, value, {
+            ttl: 1000 * options.ttl
+        });
+        else this.lru.set(key, value);
+    }
+    async has(key) {
+        return this.lru.has(key);
+    }
+    async delete(key) {
+        return this.lru.delete(key);
+    }
+    async clear() {
+        this.lru.clear();
+    }
+    constructor(options){
+        this.lru = new LRUCache({
+            maxSize: options?.maxSize ?? CacheSize.GB,
+            sizeCalculation: estimateObjectSize,
+            updateAgeOnGet: true,
+            updateAgeOnHas: true
+        });
+    }
+}
+const isServer = "u" < typeof window;
+const requestCacheMap = new WeakMap();
+const TAG_PREFIX = 'tag:';
+const CACHE_PREFIX = 'modernjs_cache:';
+const ongoingRevalidations = new Map();
+let cache_storage;
+let cacheConfig = {
+    maxSize: CacheSize.GB
+};
+function getStorage() {
+    if (cache_storage) return cache_storage;
+    cache_storage = cacheConfig.container ? cacheConfig.container : new MemoryContainer({
+        maxSize: cacheConfig.maxSize
+    });
+    return cache_storage;
+}
+function configureCache(config) {
+    cacheConfig = {
+        ...cacheConfig,
+        ...config
+    };
+    cache_storage = void 0;
+}
+function generateKey(args) {
+    return JSON.stringify(args, (_, value)=>{
+        if (value && 'object' == typeof value && !Array.isArray(value)) return Object.keys(value).sort().reduce((result, key)=>{
+            result[key] = value[key];
+            return result;
+        }, {});
+        return value;
+    });
+}
+function generateStableFunctionId(fn) {
+    const fnString = fn.toString();
+    let hash = 0;
+    for(let i = 0; i < fnString.length; i++){
+        const char = fnString.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash &= hash;
+    }
+    return `fn_${fn.name || 'anonymous'}_${Math.abs(hash).toString(36)}`;
+}
+function cache(fn, options) {
+    return async (...args)=>{
+        if (isServer && void 0 === options) {
+            const storage = await getAsyncLocalStorage();
+            const request = storage?.useContext()?.request;
+            if (request) {
+                let shouldDisableCaching = false;
+                if (cacheConfig.unstable_shouldDisable) shouldDisableCaching = await cacheConfig.unstable_shouldDisable({
+                    request
+                });
+                if (shouldDisableCaching) return fn(...args);
+                let requestCache = requestCacheMap.get(request);
+                if (!requestCache) {
+                    requestCache = new Map();
+                    requestCacheMap.set(request, requestCache);
+                }
+                let fnCache = requestCache.get(fn);
+                if (!fnCache) {
+                    fnCache = new Map();
+                    requestCache.set(fn, fnCache);
+                }
+                const key = generateKey(args);
+                if (fnCache.has(key)) return fnCache.get(key);
+                const promise = fn(...args);
+                fnCache.set(key, promise);
+                try {
+                    const data = await promise;
+                    return data;
+                } catch (error) {
+                    fnCache.delete(key);
+                    throw error;
+                }
+            }
+        } else if (void 0 !== options) try {
+            const { tag, maxAge = 5 * CacheTime.MINUTE, revalidate = 0, customKey, onCache, getKey, unstable_shouldCache } = options;
+            let missReason;
+            const currentStorage = getStorage();
+            const now = Date.now();
+            const tags = tag ? Array.isArray(tag) ? tag : [
+                tag
+            ] : [];
+            const genKey = getKey ? getKey(...args) : generateKey(args);
+            let finalKey;
+            if (customKey) finalKey = customKey({
+                params: args,
+                fn,
+                generatedKey: genKey
+            });
+            else {
+                const functionId = generateStableFunctionId(fn);
+                finalKey = `${functionId}:${genKey}`;
+            }
+            const storageKey = `${CACHE_PREFIX}${finalKey}`;
+            let shouldDisableCaching = false;
+            if (isServer && cacheConfig.unstable_shouldDisable) {
+                const asyncStorage = await getAsyncLocalStorage();
+                const request = asyncStorage?.useContext()?.request;
+                if (request) shouldDisableCaching = await cacheConfig.unstable_shouldDisable({
+                    request
+                });
+            }
+            if (shouldDisableCaching) missReason = 1;
+            else {
+                const cached = await currentStorage.get(storageKey);
+                if (cached) try {
+                    const cacheItem = cached;
+                    const age = now - cacheItem.timestamp;
+                    if (age < maxAge) {
+                        onCache?.({
+                            status: 'hit',
+                            key: finalKey,
+                            params: args,
+                            result: cacheItem.data
+                        });
+                        return cacheItem.data;
+                    }
+                    if (revalidate > 0 && age < maxAge + revalidate) {
+                        onCache?.({
+                            status: 'stale',
+                            key: finalKey,
+                            params: args,
+                            result: cacheItem.data
+                        });
+                        if (!ongoingRevalidations.has(storageKey)) {
+                            const revalidationPromise = (async ()=>{
+                                try {
+                                    const newData = await fn(...args);
+                                    let shouldCache = true;
+                                    if (unstable_shouldCache) shouldCache = await unstable_shouldCache({
+                                        params: args,
+                                        result: newData
+                                    });
+                                    if (shouldCache) await setCacheItem(currentStorage, storageKey, newData, tags, maxAge, revalidate);
+                                } catch (error) {
+                                    if (isServer) {
+                                        const asyncStorage = await getAsyncLocalStorage();
+                                        asyncStorage?.useContext()?.monitors?.error(error.message);
+                                    } else console.error('Background revalidation failed:', error);
+                                } finally{
+                                    ongoingRevalidations.delete(storageKey);
+                                }
+                            })();
+                            ongoingRevalidations.set(storageKey, revalidationPromise);
+                        }
+                        return cacheItem.data;
+                    }
+                    missReason = 3;
+                } catch (error) {
+                    console.warn('Failed to parse cached data:', error);
+                    missReason = 4;
+                }
+                else missReason = 2;
+            }
+            const data = await fn(...args);
+            if (!shouldDisableCaching) {
+                let shouldCache = true;
+                if (unstable_shouldCache) shouldCache = await unstable_shouldCache({
+                    params: args,
+                    result: data
+                });
+                if (shouldCache) await setCacheItem(currentStorage, storageKey, data, tags, maxAge, revalidate);
+            }
+            onCache?.({
+                status: 'miss',
+                key: finalKey,
+                params: args,
+                result: data,
+                reason: missReason
+            });
+            return data;
+        } catch (error) {
+            console.warn('Cache operation failed, falling back to direct execution:', error);
+            const data = await fn(...args);
+            const { onCache } = options;
+            try {
+                onCache?.({
+                    status: 'miss',
+                    key: 'cache_failed',
+                    params: args,
+                    result: data,
+                    reason: 5
+                });
+            } catch (callbackError) {
+                console.warn('Failed to call onCache callback:', callbackError);
+            }
+            return data;
+        }
+        else {
+            console.warn('The cache function will not work because it runs on the browser and there are no options are provided.');
+            return fn(...args);
+        }
+    };
+}
+async function setCacheItem(storage, storageKey, data, tags, maxAge, revalidate) {
+    const newItem = {
+        data,
+        timestamp: Date.now(),
+        tags: tags.length > 0 ? tags : void 0
+    };
+    const ttl = (maxAge + revalidate) / 1000;
+    await storage.set(storageKey, newItem, {
+        ttl: ttl > 0 ? ttl : void 0
+    });
+    await updateTagRelationships(storage, storageKey, tags);
+}
+async function updateTagRelationships(storage, storageKey, tags) {
+    for (const tag of tags){
+        const tagStoreKey = `${TAG_PREFIX}${tag}`;
+        const keyList = await storage.get(tagStoreKey);
+        const keyArray = keyList || [];
+        if (!keyArray.includes(storageKey)) keyArray.push(storageKey);
+        await storage.set(tagStoreKey, keyArray);
+    }
+}
+async function removeKeyFromTags(storage, storageKey, tags) {
+    for (const tag of tags){
+        const tagStoreKey = `${TAG_PREFIX}${tag}`;
+        const keyList = await storage.get(tagStoreKey);
+        if (keyList) try {
+            const keyArray = Array.isArray(keyList) ? keyList : [];
+            const updatedKeyList = keyArray.filter((key)=>key !== storageKey);
+            if (updatedKeyList.length > 0) await storage.set(tagStoreKey, updatedKeyList);
+            else await storage.delete(tagStoreKey);
+        } catch (error) {
+            console.warn(`Failed to process tag key list for tag ${tag}:`, error);
+        }
+    }
+}
+function withRequestCache(handler) {
+    if (!isServer) return handler;
+    return async (req, ...args)=>{
+        const storage = await getAsyncLocalStorage();
+        return storage.run({
+            request: req
+        }, ()=>handler(req, ...args));
+    };
+}
+async function revalidateTag(tag) {
+    const currentStorage = getStorage();
+    const tagStoreKey = `${TAG_PREFIX}${tag}`;
+    const keyList = await currentStorage.get(tagStoreKey);
+    if (keyList) try {
+        const keyArray = Array.isArray(keyList) ? keyList : [];
+        for (const cacheKey of keyArray){
+            const cached = await currentStorage.get(cacheKey);
+            if (cached) try {
+                const cacheItem = cached;
+                if (cacheItem.tags) {
+                    const otherTags = cacheItem.tags.filter((t)=>t !== tag);
+                    await removeKeyFromTags(currentStorage, cacheKey, otherTags);
+                }
+            } catch (error) {
+                console.warn('Failed to parse cached data while revalidating:', error);
+            }
+            await currentStorage.delete(cacheKey);
+        }
+        await currentStorage.delete(tagStoreKey);
+    } catch (error) {
+        console.warn('Failed to process tag key list:', error);
+    }
+}
+async function clearStore() {
+    const currentStorage = getStorage();
+    await currentStorage.clear();
+    cache_storage = void 0;
+    ongoingRevalidations.clear();
+}
+export { CacheSize, CacheTime, cache, clearStore, configureCache, generateKey, revalidateTag, withRequestCache };

package/dist/esm/universal/request.mjs

@@ -0,0 +1,40 @@
+function parseQuery(req) {
+    const query = {};
+    const { url } = req;
+    const q = url.split('?')[1];
+    if (q) {
+        const search = new URLSearchParams(q);
+        search.forEach((v, k)=>{
+            query[k] = v;
+        });
+    }
+    return query;
+}
+function parseHeaders(request) {
+    const headersData = {};
+    request.headers.forEach((value, key)=>{
+        headersData[key] = value;
+    });
+    return headersData;
+}
+function getPathname(request) {
+    const match = request.url.match(/^https?:\/\/[^/]+(\/[^?]*)/);
+    return match ? match[1] : '/';
+}
+function getHost(request) {
+    const { headers } = request;
+    let host = headers.get('X-Forwarded-Host');
+    if (!host) host = headers.get('Host');
+    host = host?.split(/\s*,\s*/, 1)[0] || 'undefined';
+    return host;
+}
+function parseCookie(req) {
+    const _cookie = req.headers.get('Cookie');
+    const cookie = {};
+    _cookie?.trim().split(';').forEach((item)=>{
+        const [k, v] = item.trim().split('=');
+        if (k) cookie[k] = v;
+    });
+    return cookie;
+}
+export { getHost, getPathname, parseCookie, parseHeaders, parseQuery };

package/dist/esm/url.mjs

@@ -0,0 +1,5 @@
+function normalizePathname(pathname) {
+    const normalized = '/' + pathname.replace(/^\/+|\/+$/g, '');
+    return normalized;
+}
+export { normalizePathname };