@farm.js/core 0.1.39 → 0.1.41

package/dist/app-markdown.mjs

@@ -1,7 +1,7 @@
 import {
   createFarmMarkdownRouteModuleFromFile,
   loadFarmMdxComponents
-} from "./chunk-IVLZZZEI.mjs";
+} from "./chunk-IM7DY3ED.mjs";
 import {
   FARM_MARKDOWN_ANONYMOUS_CLIENT_ADDRESS,
   createFarmMarkdownRouteModule,
@@ -12,7 +12,8 @@ import {
   normalizeFarmMarkdownRoutePath,
   parseMarkdownFrontmatter,
   titleFromMarkdown
-} from "./chunk-QFW2IH5E.mjs";
+} from "./chunk-GZTUT75U.mjs";
+import "./chunk-BRYPZIMB.mjs";
 import {
   resolveFarmMdxComponentsModulePath,
   resolveMdxConfig
@@ -21,10 +22,10 @@ import {
   FARM_MARKDOWN_CONTENT_TYPE,
   createFarmMarkdownErrorBody,
   farmRequestWantsMarkdown
-} from "./chunk-VNGH5MLF.mjs";
-import "./chunk-MVL2RAJW.mjs";
+} from "./chunk-I6UVKUYK.mjs";
+import "./chunk-KYN5ODF6.mjs";
 import "./chunk-ZLAT2CWY.mjs";
-import "./chunk-FUZEBRP3.mjs";
+import "./chunk-4GP3XZ4Z.mjs";
 import "./chunk-BTHHUD7Q.mjs";
 import "./chunk-O7BH5O46.mjs";
 import "./chunk-7LTCDQRS.mjs";

package/dist/cache.cjs

@@ -15,8 +15,9 @@
 
 
 
-var _chunkYWN746UScjs = require('./chunk-YWN746US.cjs');
-require('./chunk-E3UK5IIB.cjs');
+
+var _chunk6MVFHNYZcjs = require('./chunk-6MVFHNYZ.cjs');
+require('./chunk-GS3WR5HX.cjs');
 require('./chunk-LIUGYUX3.cjs');
 
 
@@ -25,6 +26,7 @@ var _chunkNYJMY3JAcjs = require('./chunk-NYJMY3JA.cjs');
 
 
 var _chunkZEG3OPIBcjs = require('./chunk-ZEG3OPIB.cjs');
+require('./chunk-6IZWX6ES.cjs');
 require('./chunk-S3JO3N4H.cjs');
 
 
@@ -46,4 +48,5 @@ require('./chunk-S3JO3N4H.cjs');
 
 
 
-exports.FarmDataCache = _chunkYWN746UScjs.FarmDataCache; exports.applyFarmCacheInvalidationTargets = _chunkYWN746UScjs.applyFarmCacheInvalidationTargets; exports.applyFarmCacheInvalidations = _chunkZEG3OPIBcjs.applyFarmCacheInvalidations; exports.configureFarmCache = _chunkYWN746UScjs.configureFarmCache; exports.createFarmCacheInvalidationStream = _chunkYWN746UScjs.createFarmCacheInvalidationStream; exports.createFarmCacheKey = _chunkNYJMY3JAcjs.createFarmCacheKey; exports.createPathCacheTag = _chunkYWN746UScjs.createPathCacheTag; exports.createRouteDataCacheKey = _chunkNYJMY3JAcjs.createRouteDataCacheKey; exports.createRouteDataCacheTag = _chunkYWN746UScjs.createRouteDataCacheTag; exports.defineCacheKey = _chunkYWN746UScjs.defineCacheKey; exports.getFarmDataCache = _chunkYWN746UScjs.getFarmDataCache; exports.invalidate = _chunkYWN746UScjs.invalidate; exports.invalidateRouteData = _chunkYWN746UScjs.invalidateRouteData; exports.normalizeRevalidatePath = _chunkYWN746UScjs.normalizeRevalidatePath; exports.revalidatePath = _chunkYWN746UScjs.revalidatePath; exports.revalidateTag = _chunkYWN746UScjs.revalidateTag; exports.storageCacheAdapter = _chunkYWN746UScjs.storageCacheAdapter; exports.unstable_cache = _chunkYWN746UScjs.unstable_cache; exports.updateTag = _chunkYWN746UScjs.updateTag;
+
+exports.FarmDataCache = _chunk6MVFHNYZcjs.FarmDataCache; exports.PPR_SHELL_ADAPTER_TTL_SECONDS = _chunk6MVFHNYZcjs.PPR_SHELL_ADAPTER_TTL_SECONDS; exports.applyFarmCacheInvalidationTargets = _chunk6MVFHNYZcjs.applyFarmCacheInvalidationTargets; exports.applyFarmCacheInvalidations = _chunkZEG3OPIBcjs.applyFarmCacheInvalidations; exports.configureFarmCache = _chunk6MVFHNYZcjs.configureFarmCache; exports.createFarmCacheInvalidationStream = _chunk6MVFHNYZcjs.createFarmCacheInvalidationStream; exports.createFarmCacheKey = _chunkNYJMY3JAcjs.createFarmCacheKey; exports.createPathCacheTag = _chunk6MVFHNYZcjs.createPathCacheTag; exports.createRouteDataCacheKey = _chunkNYJMY3JAcjs.createRouteDataCacheKey; exports.createRouteDataCacheTag = _chunk6MVFHNYZcjs.createRouteDataCacheTag; exports.defineCacheKey = _chunk6MVFHNYZcjs.defineCacheKey; exports.getFarmDataCache = _chunk6MVFHNYZcjs.getFarmDataCache; exports.invalidate = _chunk6MVFHNYZcjs.invalidate; exports.invalidateRouteData = _chunk6MVFHNYZcjs.invalidateRouteData; exports.normalizeRevalidatePath = _chunk6MVFHNYZcjs.normalizeRevalidatePath; exports.revalidatePath = _chunk6MVFHNYZcjs.revalidatePath; exports.revalidateTag = _chunk6MVFHNYZcjs.revalidateTag; exports.storageCacheAdapter = _chunk6MVFHNYZcjs.storageCacheAdapter; exports.unstable_cache = _chunk6MVFHNYZcjs.unstable_cache; exports.updateTag = _chunk6MVFHNYZcjs.updateTag;

package/dist/cache.d.mts

@@ -88,7 +88,8 @@ interface FarmCacheEntry<T = unknown> {
     revalidate?: number | false;
     /**
      * Epoch milliseconds after which no reader can use the entry, so shared
-     * storage may drop it. Set only for entries with a finite `revalidate`.
+     * storage may drop it. Set for entries with a finite `revalidate`, and for PPR shells
+     * stored through an adapter (see {@link PPR_SHELL_ADAPTER_TTL_SECONDS}).
      * Adapters with native expiry (Redis PX, unstorage `ttl`) should honor it.
      */
     expiresAt?: number;
@@ -163,6 +164,11 @@ interface StorageFarmCacheAdapterOptions {
  * their atomic increment/transaction primitives for tag invalidation.
  */
 declare function storageCacheAdapter(storage: FarmCacheStorage, options?: StorageFarmCacheAdapterOptions): FarmCacheAdapter;
+/**
+ * How long a PPR shell without `revalidate` stays in a shared cache adapter. Every query
+ * string variant stores its own shell, so without an expiry they would pile up forever.
+ */
+declare const PPR_SHELL_ADAPTER_TTL_SECONDS = 86400;
 interface GetFarmCacheEntryOptions {
     allowStale?: boolean;
     now?: number;
@@ -186,9 +192,19 @@ declare class FarmDataCache {
     private namespace;
     private local;
     private maxEntries;
+    private config;
+    /** PPR shells, kept apart so query-string variants never evict app entries. */
+    private shells?;
+    private isShellCache;
     private lease;
     constructor(config?: FarmCacheUserConfig);
     configure(config?: FarmCacheUserConfig): void;
+    /**
+     * Where PPR shells live: the same adapter and namespace, so path and tag invalidation
+     * reaches them, but their own in-memory LRU of `maxEntries`.
+     * @internal
+     */
+    get pprShellCache(): FarmDataCache;
     get adapterName(): string;
     get hasAdapter(): boolean;
     get size(): number;
@@ -201,6 +217,7 @@ declare class FarmDataCache {
     delete(key: string): boolean;
     deleteAsync(key: string): Promise<boolean>;
     clear(): void;
+    private resetLocal;
     clearAsync(): Promise<void>;
     isStale(entry: FarmCacheStaleEntry, now?: number): boolean;
     isStaleAsync(entry: FarmCacheEntry, now?: number): Promise<boolean>;
@@ -269,6 +286,10 @@ declare function configureFarmCache(config: FarmCacheUserConfig | undefined): vo
  * Values passed as call arguments already participate in the key and do not
  * need to be repeated in `keyParts`.
  *
+ * The result is shared by every request, so the function cannot read the
+ * request: `cookies()`, `headers()`, `getCspNonce()`, and `getCurrentRequest()`
+ * throw inside it. Read them outside and pass what you need as an argument.
+ *
  * @param fn The async function to memoize.
  * @param keyParts Extra values that identify this call site. Include every
  *   variable the function closes over that is not one of its arguments.
@@ -308,4 +329,4 @@ declare function createPathCacheTag(routePath: string): string;
 declare function createRouteDataCacheTag(key: RouteDataCacheKey): string;
 declare function normalizeRevalidatePath(routePath: string): string;
 
-export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };
+export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, PPR_SHELL_ADAPTER_TTL_SECONDS, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };

package/dist/cache.d.ts

@@ -88,7 +88,8 @@ interface FarmCacheEntry<T = unknown> {
     revalidate?: number | false;
     /**
      * Epoch milliseconds after which no reader can use the entry, so shared
-     * storage may drop it. Set only for entries with a finite `revalidate`.
+     * storage may drop it. Set for entries with a finite `revalidate`, and for PPR shells
+     * stored through an adapter (see {@link PPR_SHELL_ADAPTER_TTL_SECONDS}).
      * Adapters with native expiry (Redis PX, unstorage `ttl`) should honor it.
      */
     expiresAt?: number;
@@ -163,6 +164,11 @@ interface StorageFarmCacheAdapterOptions {
  * their atomic increment/transaction primitives for tag invalidation.
  */
 declare function storageCacheAdapter(storage: FarmCacheStorage, options?: StorageFarmCacheAdapterOptions): FarmCacheAdapter;
+/**
+ * How long a PPR shell without `revalidate` stays in a shared cache adapter. Every query
+ * string variant stores its own shell, so without an expiry they would pile up forever.
+ */
+declare const PPR_SHELL_ADAPTER_TTL_SECONDS = 86400;
 interface GetFarmCacheEntryOptions {
     allowStale?: boolean;
     now?: number;
@@ -186,9 +192,19 @@ declare class FarmDataCache {
     private namespace;
     private local;
     private maxEntries;
+    private config;
+    /** PPR shells, kept apart so query-string variants never evict app entries. */
+    private shells?;
+    private isShellCache;
     private lease;
     constructor(config?: FarmCacheUserConfig);
     configure(config?: FarmCacheUserConfig): void;
+    /**
+     * Where PPR shells live: the same adapter and namespace, so path and tag invalidation
+     * reaches them, but their own in-memory LRU of `maxEntries`.
+     * @internal
+     */
+    get pprShellCache(): FarmDataCache;
     get adapterName(): string;
     get hasAdapter(): boolean;
     get size(): number;
@@ -201,6 +217,7 @@ declare class FarmDataCache {
     delete(key: string): boolean;
     deleteAsync(key: string): Promise<boolean>;
     clear(): void;
+    private resetLocal;
     clearAsync(): Promise<void>;
     isStale(entry: FarmCacheStaleEntry, now?: number): boolean;
     isStaleAsync(entry: FarmCacheEntry, now?: number): Promise<boolean>;
@@ -269,6 +286,10 @@ declare function configureFarmCache(config: FarmCacheUserConfig | undefined): vo
  * Values passed as call arguments already participate in the key and do not
  * need to be repeated in `keyParts`.
  *
+ * The result is shared by every request, so the function cannot read the
+ * request: `cookies()`, `headers()`, `getCspNonce()`, and `getCurrentRequest()`
+ * throw inside it. Read them outside and pass what you need as an argument.
+ *
  * @param fn The async function to memoize.
  * @param keyParts Extra values that identify this call site. Include every
  *   variable the function closes over that is not one of its arguments.
@@ -308,4 +329,4 @@ declare function createPathCacheTag(routePath: string): string;
 declare function createRouteDataCacheTag(key: RouteDataCacheKey): string;
 declare function normalizeRevalidatePath(routePath: string): string;
 
-export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };
+export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, PPR_SHELL_ADAPTER_TTL_SECONDS, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };

package/dist/cache.mjs

@@ -1,5 +1,6 @@
 import {
   FarmDataCache,
+  PPR_SHELL_ADAPTER_TTL_SECONDS,
   applyFarmCacheInvalidationTargets,
   configureFarmCache,
   createFarmCacheInvalidationStream,
@@ -15,8 +16,8 @@ import {
   storageCacheAdapter,
   unstable_cache,
   updateTag
-} from "./chunk-MSSFIQGM.mjs";
-import "./chunk-FUZEBRP3.mjs";
+} from "./chunk-B2GSRB3P.mjs";
+import "./chunk-4GP3XZ4Z.mjs";
 import "./chunk-C4NCTZLM.mjs";
 import {
   createFarmCacheKey,
@@ -25,9 +26,11 @@ import {
 import {
   applyFarmCacheInvalidations
 } from "./chunk-4SIYUGRY.mjs";
+import "./chunk-6LVRDOAW.mjs";
 import "./chunk-LPEX4YW6.mjs";
 export {
   FarmDataCache,
+  PPR_SHELL_ADAPTER_TTL_SECONDS,
   applyFarmCacheInvalidationTargets,
   applyFarmCacheInvalidations,
   configureFarmCache,

package/dist/{chunk-EGCTIS5F.mjs → chunk-24SP5TGU.mjs}

@@ -1,6 +1,6 @@
 import {
   useRouter
-} from "./chunk-VWBHM3F6.mjs";
+} from "./chunk-6PKXK4TY.mjs";
 import {
   getRouter
 } from "./chunk-TS4JHGUJ.mjs";

package/dist/{chunk-2ZYGC6SS.cjs → chunk-25LPIZSX.cjs}

@@ -4,7 +4,7 @@
 var _chunkFJ3M4CUXcjs = require('./chunk-FJ3M4CUX.cjs');
 
 
-var _chunkULASELLAcjs = require('./chunk-ULASELLA.cjs');
+var _chunk6IZWX6EScjs = require('./chunk-6IZWX6ES.cjs');
 
 
 var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
@@ -143,11 +143,11 @@ function addFarmCspNonceToScriptTags(html, nonce) {
   return createFarmScriptTagRewriter((tag) => stampScriptTag(tag, nonce)).write(html, true);
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, addFarmCspNonceToScriptTags, "addFarmCspNonceToScriptTags");
-function stampFarmCspNonce(html, nonce = _chunkULASELLAcjs._resolveCurrentCspNonce.call(void 0, )) {
+function stampFarmCspNonce(html, nonce = _chunk6IZWX6EScjs._resolveCurrentCspNonce.call(void 0, )) {
   return nonce && html ? addFarmCspNonceToScriptTags(html, nonce) : html;
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, stampFarmCspNonce, "stampFarmCspNonce");
-function replaceFarmCspNonceMarker(html, marker, nonce = _chunkULASELLAcjs._resolveCurrentCspNonce.call(void 0, )) {
+function replaceFarmCspNonceMarker(html, marker, nonce = _chunk6IZWX6EScjs._resolveCurrentCspNonce.call(void 0, )) {
   validateCspNonce(marker);
   if (nonce) validateCspNonce(nonce);
   return createFarmScriptTagRewriter((tag) => {

package/dist/{chunk-ARC7I3O2.mjs → chunk-26RUNDIR.mjs}

@@ -34,7 +34,7 @@ import {
 } from "./chunk-4SIYUGRY.mjs";
 import {
   _resolveCurrentRequest
-} from "./chunk-QRKIMN7T.mjs";
+} from "./chunk-6LVRDOAW.mjs";
 import {
   __name
 } from "./chunk-LPEX4YW6.mjs";

package/dist/{chunk-472NCAZ7.cjs → chunk-2FUIT2G2.cjs}

@@ -9,7 +9,7 @@ var _chunk7W3CPVXScjs = require('./chunk-7W3CPVXS.cjs');
 var _chunkAI7QMY7Ocjs = require('./chunk-AI7QMY7O.cjs');
 
 
-var _chunk6XWDE2P2cjs = require('./chunk-6XWDE2P2.cjs');
+var _chunkZTP3BJG6cjs = require('./chunk-ZTP3BJG6.cjs');
 
 
 var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
@@ -20,12 +20,12 @@ function _setDefaultFarmThemeConfig(config, basePath = "/") {
   defaultThemeConfig = _chunkOI6CMLWXcjs.resolveFarmThemeConfig.call(void 0, config, basePath);
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, _setDefaultFarmThemeConfig, "_setDefaultFarmThemeConfig");
-function getTheme(request = _chunk6XWDE2P2cjs.getCurrentRequestOrNull.call(void 0, )) {
+function getTheme(request = _chunkZTP3BJG6cjs.getCurrentRequestOrNull.call(void 0, )) {
   if (!request) return defaultThemeConfig.default;
   return readFarmThemePreference(request, defaultThemeConfig);
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, getTheme, "getTheme");
-function getThemeSnapshot(request = _chunk6XWDE2P2cjs.getCurrentRequestOrNull.call(void 0, )) {
+function getThemeSnapshot(request = _chunkZTP3BJG6cjs.getCurrentRequestOrNull.call(void 0, )) {
   const theme = request ? readFarmThemePreference(request, defaultThemeConfig) : defaultThemeConfig.default;
   return {
     theme,