@bleedingdev/modern-js-runtime-utils 3.2.0-ultramodern.0

package/dist/types/universal/cache.d.ts

@@ -0,0 +1,68 @@
+export declare const CacheSize: {
+    readonly KB: 1024;
+    readonly MB: number;
+    readonly GB: number;
+};
+export declare const CacheTime: {
+    readonly SECOND: 1000;
+    readonly MINUTE: number;
+    readonly HOUR: number;
+    readonly DAY: number;
+    readonly WEEK: number;
+    readonly MONTH: number;
+};
+export type CacheStatus = 'hit' | 'stale' | 'miss';
+export interface CacheStatsInfo {
+    status: CacheStatus;
+    key: string;
+    params: any[];
+    result: any;
+    /**
+     * Cache miss reason:
+     * 1: Caching is disabled for the current request
+     * 2: Item not found in cache
+     * 3: Item found in cache but has expired
+     * 4: Failed to parse data from cache
+     * 5: Execution error
+     */
+    reason?: number;
+}
+export interface Container {
+    get: (key: string) => Promise<any | undefined | null>;
+    set: (key: string, value: any, options?: {
+        ttl?: number;
+    }) => Promise<any>;
+    has: (key: string) => Promise<boolean>;
+    delete: (key: string) => Promise<boolean>;
+    clear: () => Promise<void>;
+}
+interface CacheOptions<T extends (...args: any[]) => any> {
+    tag?: string | string[];
+    maxAge?: number;
+    revalidate?: number;
+    getKey?: (...args: Parameters<T>) => string;
+    customKey?: (options: {
+        params: Parameters<T>;
+        fn: T;
+        generatedKey: string;
+    }) => string;
+    onCache?: (info: CacheStatsInfo) => void;
+    unstable_shouldCache?: (info: {
+        params: Parameters<T>;
+        result: Awaited<ReturnType<T>>;
+    }) => boolean | Promise<boolean>;
+}
+interface CacheConfig {
+    maxSize?: number;
+    container?: Container;
+    unstable_shouldDisable?: ({ request, }: {
+        request: Request;
+    }) => boolean | Promise<boolean>;
+}
+export declare function configureCache(config: CacheConfig): void;
+export declare function generateKey(args: unknown[]): string;
+export declare function cache<T extends (...args: any[]) => Promise<any>>(fn: T, options?: CacheOptions<T>): T;
+export declare function withRequestCache<T extends (req: Request, ...args: any[]) => Promise<any>>(handler: T): T;
+export declare function revalidateTag(tag: string): Promise<void>;
+export declare function clearStore(): Promise<void>;
+export {};

package/dist/types/universal/request.d.ts

@@ -0,0 +1,17 @@
+export type Query = Record<string, string>;
+export declare function parseQuery(req: Request): Query;
+export type HeadersData = Record<string, string | undefined>;
+export declare function parseHeaders(request: Request): HeadersData;
+/**
+ * The function is modified based on
+ * https://github.com/honojs/hono/blob/main/src/utils/url.ts
+ *
+ * MIT Licensed
+ * https://github.com/honojs/hono/blob/main/LICENSE
+ *
+ */
+export declare function getPathname(request: Request): string;
+export declare function getHost(request: Request): string;
+type Cookie = Record<string, string>;
+export declare function parseCookie(req: Request): Cookie;
+export {};

package/dist/types/url.d.ts

@@ -0,0 +1,11 @@
+/**
+ * we use `pathname.replace(/\/+$/, '')` to remove the '/' with end.
+ *
+ * examples:
+ *
+ * pathname1: '/api', pathname2: '/api/',
+ * pathname1 as same as pathname2
+ *
+ * pathname3: '/', the nomalizeResult also as '/'
+ */
+export declare function normalizePathname(pathname: string): string;

package/package.json

@@ -0,0 +1,197 @@
+{
+  "name": "@bleedingdev/modern-js-runtime-utils",
+  "description": "A Progressive React Framework for modern web development.",
+  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "bugs": {
+    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "directory": "packages/toolkit/utils"
+  },
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "framework",
+    "modern",
+    "modern.js"
+  ],
+  "version": "3.2.0-ultramodern.0",
+  "_comment": "Provide ESM and CJS exports, ESM is used by runtime package, for treeshaking",
+  "exports": {
+    "./router": {
+      "types": "./dist/types/router.d.ts",
+      "modern:source": "./src/router.ts",
+      "default": "./dist/esm/router.mjs"
+    },
+    "./router/rsc": {
+      "types": "./dist/types/rsc.d.ts",
+      "modern:source": "./src/rsc.ts",
+      "default": "./dist/esm/rsc.mjs"
+    },
+    "./browser": {
+      "types": "./dist/types/browser/index.d.ts",
+      "modern:source": "./src/browser/index.ts",
+      "default": "./dist/esm/browser/index.mjs"
+    },
+    "./node": {
+      "types": "./dist/types/node/index.d.ts",
+      "modern:source": "./src/node/index.ts",
+      "default": "./dist/esm/node/index.mjs"
+    },
+    "./server": {
+      "types": "./dist/types/server/index.d.ts",
+      "modern:source": "./src/server/index.ts",
+      "node": {
+        "module": "./dist/esm/server/index.mjs",
+        "import": "./dist/esm-node/server/index.mjs",
+        "require": "./dist/cjs/server/index.js"
+      },
+      "default": "./dist/esm/server/index.mjs"
+    },
+    "./time": {
+      "types": "./dist/types/time.d.ts",
+      "modern:source": "./src/time.ts",
+      "node": {
+        "module": "./dist/esm/time.mjs",
+        "import": "./dist/esm-node/time.mjs",
+        "require": "./dist/cjs/time.js"
+      },
+      "default": "./dist/esm/time.mjs"
+    },
+    "./universal/request": {
+      "types": "./dist/types/universal/request.d.ts",
+      "modern:source": "./src/universal/request.ts",
+      "default": "./dist/esm/universal/request.mjs"
+    },
+    "./parsed": {
+      "types": "./dist/types/parsed.d.ts",
+      "modern:source": "./src/parsed.ts",
+      "default": "./dist/esm/parsed.mjs"
+    },
+    "./storer": {
+      "types": "./dist/types/node/storer/index.d.ts",
+      "modern:source": "./src/node/storer/index.ts",
+      "node": {
+        "import": "./dist/esm-node/node/storer/index.mjs",
+        "require": "./dist/cjs/node/storer/index.js"
+      },
+      "default": "./dist/cjs/node/storer/index.js"
+    },
+    "./fileReader": {
+      "types": "./dist/types/node/fileReader.d.ts",
+      "modern:source": "./src/node/fileReader.ts",
+      "node": {
+        "import": "./dist/esm-node/node/fileReader.mjs",
+        "require": "./dist/cjs/node/fileReader.js"
+      },
+      "default": "./dist/cjs/node/fileReader.js"
+    },
+    "./url": {
+      "types": "./dist/types/url.d.ts",
+      "modern:source": "./src/url.ts",
+      "default": "./dist/esm/url.mjs"
+    },
+    "./merge": {
+      "types": "./dist/types/merge.d.ts",
+      "modern:source": "./src/merge.ts",
+      "default": "./dist/esm/merge.mjs"
+    },
+    "./cache": {
+      "types": "./dist/types/universal/cache.d.ts",
+      "modern:source": "./src/universal/cache.ts",
+      "node": {
+        "module": "./dist/esm/universal/cache.mjs",
+        "import": "./dist/esm-node/universal/cache.mjs",
+        "require": "./dist/cjs/universal/cache.js"
+      },
+      "default": "./dist/esm/universal/cache.mjs"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "typesVersions": {
+    "*": {
+      "router": [
+        "./dist/types/router.d.ts"
+      ],
+      "router/rsc": [
+        "./dist/types/rsc.d.ts"
+      ],
+      "browser": [
+        "./dist/types/browser/index.d.ts"
+      ],
+      "node": [
+        "./dist/types/node/index.d.ts"
+      ],
+      "server": [
+        "./dist/types/server/index.d.ts"
+      ],
+      "universal/request": [
+        "./dist/types/universal/request.d.ts"
+      ],
+      "time": [
+        "./dist/types/time.d.ts"
+      ],
+      "parsed": [
+        "./dist/types/parsed.d.ts"
+      ],
+      "storer": [
+        "./dist/types/node/storer/index.d.ts"
+      ],
+      "fileReader": [
+        "./dist/types/node/fileReader.d.ts"
+      ],
+      "url": [
+        "./dist/types/url.d.ts"
+      ],
+      "merge": [
+        "./dist/types/merge.d.ts"
+      ],
+      "cache": [
+        "./dist/types/universal/cache.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "@swc/helpers": "^0.5.21",
+    "lru-cache": "^11.3.6",
+    "react-router": "7.15.1",
+    "serialize-javascript": "^7.0.5",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.2.0-ultramodern.0",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.0"
+  },
+  "peerDependencies": {
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@rslib/core": "0.21.5",
+    "@types/ioredis-mock": "^8.2.7",
+    "@types/node": "^25.8.0",
+    "@types/serialize-javascript": "^5.0.4",
+    "@typescript/native-preview": "7.0.0-dev.20260516.1",
+    "ioredis-mock": "^8.13.1",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "@scripts/rstest-config": "2.66.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "dev": "rslib build --watch",
+    "build": "rslib build",
+    "test": "rstest --passWithNoTests"
+  },
+  "types": "./dist/types/index.d.ts"
+}

package/rslib.config.mts

@@ -0,0 +1,28 @@
+import { rslibConfig } from '@modern-js/rslib';
+import { defineConfig } from '@rslib/core';
+
+export default defineConfig({
+  ...rslibConfig,
+  lib: rslibConfig.lib?.map(libConfig => {
+    const isWebTarget = libConfig.output?.target === 'web';
+
+    return {
+      ...libConfig,
+      ...(isWebTarget && {
+        source: {
+          define: {
+            ...(libConfig.source?.define || {}),
+            IS_WEB: 'true',
+          },
+        },
+      }),
+      output: {
+        ...libConfig.output,
+        externals: {
+          async_hooks: 'async_hooks',
+          './async_storage.server': './async_storage.server',
+        },
+      },
+    };
+  }),
+});

package/rstest.config.mts

@@ -0,0 +1,26 @@
+import { withTestPreset } from '@scripts/rstest-config';
+
+export default {
+  projects: [
+    withTestPreset({
+      name: 'runtime-utils-node',
+      root: __dirname,
+      testEnvironment: 'node',
+      exclude: [
+        'tests/universal/cache-client.test.ts',
+        'tests/browser/**/*.{test,spec}.{js,cjs,mjs,ts,tsx}',
+      ],
+      globals: true,
+    }),
+    withTestPreset({
+      name: 'runtime-utils-client',
+      root: __dirname,
+      testEnvironment: 'jsdom',
+      include: [
+        'tests/universal/cache-client.test.ts',
+        'tests/browser/**/*.{test,spec}.{js,cjs,mjs,ts,tsx}',
+      ],
+      globals: true,
+    }),
+  ],
+};