vinext 0.0.29 → 0.0.31

package/dist/shims/cache-runtime.d.ts

@@ -1,47 +1,20 @@
-/**
- * "use cache" runtime
- *
- * This module provides the runtime for "use cache" directive support.
- * Functions marked with "use cache" are transformed by the vinext:use-cache
- * Vite plugin to wrap them with `registerCachedFunction()`.
- *
- * The runtime:
- * 1. Generates a cache key from function identity + serialized arguments
- * 2. Checks the CacheHandler for a cached value
- * 3. On HIT: returns the cached value (deserialized via RSC stream)
- * 4. On MISS: creates an AsyncLocalStorage context for cacheLife/cacheTag,
- *    calls the original function, serializes the result via RSC stream,
- *    collects metadata, stores the result
- *
- * Serialization uses the RSC protocol (renderToReadableStream /
- * createFromReadableStream / encodeReply) from @vitejs/plugin-rsc.
- * This correctly handles React elements, client references, Promises,
- * and all RSC-serializable types — unlike JSON.stringify which silently
- * drops $$typeof Symbols and function values.
- *
- * When RSC APIs are unavailable (e.g. in unit tests), falls back to
- * JSON.stringify/parse with the same stableStringify cache key generation.
- *
- * Cache variants:
- * - "use cache"           — shared cache (default profile)
- * - "use cache: remote"   — shared cache (explicit)
- * - "use cache: private"  — per-request cache (not shared across requests)
- */
+import { CacheLifeConfig } from "./cache.js";
 import { AsyncLocalStorage } from "node:async_hooks";
-import { type CacheLifeConfig } from "./cache.js";
-export interface CacheContext {
-    /** Tags collected via cacheTag() during execution */
-    tags: string[];
-    /** Cache life configs collected via cacheLife() — minimum-wins rule applies */
-    lifeConfigs: CacheLifeConfig[];
-    /** Cache variant: "default" | "remote" | "private" */
-    variant: string;
+
+//#region src/shims/cache-runtime.d.ts
+interface CacheContext {
+  /** Tags collected via cacheTag() during execution */
+  tags: string[];
+  /** Cache life configs collected via cacheLife() — minimum-wins rule applies */
+  lifeConfigs: CacheLifeConfig[];
+  /** Cache variant: "default" | "remote" | "private" */
+  variant: string;
 }
-export declare const cacheContextStorage: AsyncLocalStorage<CacheContext>;
+declare const cacheContextStorage: AsyncLocalStorage<CacheContext>;
 /**
  * Get the current cache context. Returns null if not inside a "use cache" function.
  */
-export declare function getCacheContext(): CacheContext | null;
+declare function getCacheContext(): CacheContext | null;
 /**
  * Convert an encodeReply result (string | FormData) to a cache key string.
  * For FormData (binary args), produces a deterministic SHA-256 hash over
@@ -50,18 +23,21 @@ export declare function getCacheContext(): CacheContext | null;
  *
  * Exported for testing.
  */
-export declare function replyToCacheKey(reply: string | FormData): Promise<string>;
+declare function replyToCacheKey(reply: string | FormData): Promise<string>;
+interface PrivateCacheState {
+  _privateCache: Map<string, unknown> | null;
+}
 /**
  * Run a function within a private cache ALS scope.
  * Ensures per-request isolation for "use cache: private" entries
  * on concurrent runtimes.
  */
-export declare function runWithPrivateCache<T>(fn: () => T | Promise<T>): T | Promise<T>;
+declare function runWithPrivateCache<T>(fn: () => T | Promise<T>): T | Promise<T>;
 /**
  * Clear the private per-request cache. Should be called at the start of each request.
  * Only needed when not using runWithPrivateCache() (legacy path).
  */
-export declare function clearPrivateCache(): void;
+declare function clearPrivateCache(): void;
 /**
  * Register a function as a cached function. This is called by the Vite
  * transform for each "use cache" function.
@@ -71,5 +47,7 @@ export declare function clearPrivateCache(): void;
  * @param variant - Cache variant: "" (default/shared), "remote", "private"
  * @returns A wrapper function that checks cache before calling the original
  */
-export declare function registerCachedFunction<T extends (...args: any[]) => Promise<any>>(fn: T, id: string, variant?: string): T;
+declare function registerCachedFunction<T extends (...args: any[]) => Promise<any>>(fn: T, id: string, variant?: string): T;
+//#endregion
+export { CacheContext, PrivateCacheState, cacheContextStorage, clearPrivateCache, getCacheContext, registerCachedFunction, replyToCacheKey, runWithPrivateCache };
 //# sourceMappingURL=cache-runtime.d.ts.map