@farm.js/core 0.1.0-beta.3 → 0.1.0-beta.4

package/dist/plugin.d.mts

@@ -1,4 +1,4 @@
-export { aI as APIHandlerLifecyclePayload, aE as APIRouteDiscoveredPayload, aL as BundleLifecyclePayload, U as BundleResultPayload, aJ as ErrorLifecyclePayload, V as FarmPlugin, ay as FarmPluginBuildHooks, aA as FarmPluginClientConfig, ad as FarmPluginContext, az as FarmPluginDevHooks, av as FarmPluginDiscoveredRoute, ax as FarmPluginRenderHooks, ah as FarmPluginRouteRuntimePayload, aw as FarmPluginRouterHooks, an as FarmPluginRuntimeAfterEvent, ak as FarmPluginRuntimeBaseEvent, am as FarmPluginRuntimeBeforeEvent, aq as FarmPluginRuntimeCloseEvent, al as FarmPluginRuntimeContextEvent, ao as FarmPluginRuntimeErrorEvent, ar as FarmPluginRuntimeHooks, ag as FarmPluginRuntimeKind, at as FarmPluginRuntimeRequestHandler, as as FarmPluginRuntimeRequestOptions, au as FarmPluginRuntimeSession, ap as FarmPluginRuntimeStartEvent, ai as FarmPluginSetupContext, aj as FarmPluginStateContext, ae as FarmRequestPluginContext, af as FarmRequestStore, aK as HMRUpdatePayload, aD as MiddlewareDiscoveredPayload, aM as NitroBuildLifecyclePayload, a2 as PluginManager, ac as PluginRequestContext, aH as RenderLifecyclePayload, aB as RouteDiscoveredPayload, aF as RouteMatchPayload, aG as RouteMatchResultPayload, aC as RoutesGeneratedPayload, aN as ShutdownPayload, a1 as definePlugin, f as farmPlugin } from './client-plugins-Cnr0D3kk.mjs';
+export { aI as APIHandlerLifecyclePayload, aE as APIRouteDiscoveredPayload, aL as BundleLifecyclePayload, U as BundleResultPayload, aJ as ErrorLifecyclePayload, V as FarmPlugin, ay as FarmPluginBuildHooks, aA as FarmPluginClientConfig, ad as FarmPluginContext, az as FarmPluginDevHooks, av as FarmPluginDiscoveredRoute, ax as FarmPluginRenderHooks, ah as FarmPluginRouteRuntimePayload, aw as FarmPluginRouterHooks, an as FarmPluginRuntimeAfterEvent, ak as FarmPluginRuntimeBaseEvent, am as FarmPluginRuntimeBeforeEvent, aq as FarmPluginRuntimeCloseEvent, al as FarmPluginRuntimeContextEvent, ao as FarmPluginRuntimeErrorEvent, ar as FarmPluginRuntimeHooks, ag as FarmPluginRuntimeKind, at as FarmPluginRuntimeRequestHandler, as as FarmPluginRuntimeRequestOptions, au as FarmPluginRuntimeSession, ap as FarmPluginRuntimeStartEvent, ai as FarmPluginSetupContext, aj as FarmPluginStateContext, ae as FarmRequestPluginContext, af as FarmRequestStore, aK as HMRUpdatePayload, aD as MiddlewareDiscoveredPayload, aM as NitroBuildLifecyclePayload, a2 as PluginManager, ac as PluginRequestContext, aH as RenderLifecyclePayload, aB as RouteDiscoveredPayload, aF as RouteMatchPayload, aG as RouteMatchResultPayload, aC as RoutesGeneratedPayload, aN as ShutdownPayload, a1 as definePlugin, f as farmPlugin } from './client-plugins-DQQ1adXM.mjs';
 import 'vite';
 import './plugin-BJDf43dc.mjs';
 import './env.mjs';
@@ -18,4 +18,5 @@ import './cron.mjs';
 import './server-action-security.mjs';
 import './image-config-Duob7wER.mjs';
 import './types-BH1lhg5G.mjs';
+import './cache.mjs';
 import './route-runtime-DoOHzCAD.mjs';

package/dist/plugin.d.ts

@@ -1,4 +1,4 @@
-export { aI as APIHandlerLifecyclePayload, aE as APIRouteDiscoveredPayload, aL as BundleLifecyclePayload, U as BundleResultPayload, aJ as ErrorLifecyclePayload, V as FarmPlugin, ay as FarmPluginBuildHooks, aA as FarmPluginClientConfig, ad as FarmPluginContext, az as FarmPluginDevHooks, av as FarmPluginDiscoveredRoute, ax as FarmPluginRenderHooks, ah as FarmPluginRouteRuntimePayload, aw as FarmPluginRouterHooks, an as FarmPluginRuntimeAfterEvent, ak as FarmPluginRuntimeBaseEvent, am as FarmPluginRuntimeBeforeEvent, aq as FarmPluginRuntimeCloseEvent, al as FarmPluginRuntimeContextEvent, ao as FarmPluginRuntimeErrorEvent, ar as FarmPluginRuntimeHooks, ag as FarmPluginRuntimeKind, at as FarmPluginRuntimeRequestHandler, as as FarmPluginRuntimeRequestOptions, au as FarmPluginRuntimeSession, ap as FarmPluginRuntimeStartEvent, ai as FarmPluginSetupContext, aj as FarmPluginStateContext, ae as FarmRequestPluginContext, af as FarmRequestStore, aK as HMRUpdatePayload, aD as MiddlewareDiscoveredPayload, aM as NitroBuildLifecyclePayload, a2 as PluginManager, ac as PluginRequestContext, aH as RenderLifecyclePayload, aB as RouteDiscoveredPayload, aF as RouteMatchPayload, aG as RouteMatchResultPayload, aC as RoutesGeneratedPayload, aN as ShutdownPayload, a1 as definePlugin, f as farmPlugin } from './client-plugins-CTnsZz_A.js';
+export { aI as APIHandlerLifecyclePayload, aE as APIRouteDiscoveredPayload, aL as BundleLifecyclePayload, U as BundleResultPayload, aJ as ErrorLifecyclePayload, V as FarmPlugin, ay as FarmPluginBuildHooks, aA as FarmPluginClientConfig, ad as FarmPluginContext, az as FarmPluginDevHooks, av as FarmPluginDiscoveredRoute, ax as FarmPluginRenderHooks, ah as FarmPluginRouteRuntimePayload, aw as FarmPluginRouterHooks, an as FarmPluginRuntimeAfterEvent, ak as FarmPluginRuntimeBaseEvent, am as FarmPluginRuntimeBeforeEvent, aq as FarmPluginRuntimeCloseEvent, al as FarmPluginRuntimeContextEvent, ao as FarmPluginRuntimeErrorEvent, ar as FarmPluginRuntimeHooks, ag as FarmPluginRuntimeKind, at as FarmPluginRuntimeRequestHandler, as as FarmPluginRuntimeRequestOptions, au as FarmPluginRuntimeSession, ap as FarmPluginRuntimeStartEvent, ai as FarmPluginSetupContext, aj as FarmPluginStateContext, ae as FarmRequestPluginContext, af as FarmRequestStore, aK as HMRUpdatePayload, aD as MiddlewareDiscoveredPayload, aM as NitroBuildLifecyclePayload, a2 as PluginManager, ac as PluginRequestContext, aH as RenderLifecyclePayload, aB as RouteDiscoveredPayload, aF as RouteMatchPayload, aG as RouteMatchResultPayload, aC as RoutesGeneratedPayload, aN as ShutdownPayload, a1 as definePlugin, f as farmPlugin } from './client-plugins-Cw4qUGsw.js';
 import 'vite';
 import './plugin-BJDf43dc.js';
 import './env.js';
@@ -18,4 +18,5 @@ import './cron.js';
 import './server-action-security.js';
 import './image-config-Duob7wER.js';
 import './types-BH1lhg5G.js';
+import './cache.js';
 import './route-runtime-DoOHzCAD.js';

package/dist/plugin.mjs

@@ -5,20 +5,20 @@ import {
 import "./chunk-RSKVYESE.mjs";
 import {
   farmPlugin
-} from "./chunk-XJSHJN4M.mjs";
+} from "./chunk-AOBXKNS5.mjs";
 import "./chunk-LGHEOHBU.mjs";
 import "./chunk-FRPWCMMG.mjs";
 import "./chunk-V6WE6JSZ.mjs";
 import "./chunk-3XNTL3FQ.mjs";
 import "./chunk-BHG3LVHH.mjs";
 import "./chunk-USWZZUEH.mjs";
-import "./chunk-5QH4IKY3.mjs";
+import "./chunk-3U3ZUQAQ.mjs";
 import "./chunk-7HO6AEOP.mjs";
 import "./chunk-74YTBPTY.mjs";
 import "./chunk-7MABZJIM.mjs";
 import "./chunk-YW7OBE6Q.mjs";
 import "./chunk-GY2STC2S.mjs";
-import "./chunk-45LKHSHJ.mjs";
+import "./chunk-UB5UOSHB.mjs";
 import "./chunk-LLC7BNXW.mjs";
 import "./chunk-QGQX7SFC.mjs";
 import "./chunk-XIVV5IWN.mjs";
@@ -29,27 +29,28 @@ import "./chunk-P7QDS5AT.mjs";
 import "./chunk-T4QJQK76.mjs";
 import "./chunk-E6EPN5BT.mjs";
 import "./chunk-QGOHVJ6J.mjs";
-import "./chunk-LG3YINQN.mjs";
+import "./chunk-Z5CQMP54.mjs";
 import "./chunk-2ED5Q2GH.mjs";
 import "./chunk-GN72QAIH.mjs";
 import "./chunk-FQYDHKKU.mjs";
-import "./chunk-CSU4KJJF.mjs";
+import "./chunk-C2ROET2V.mjs";
 import "./chunk-QKVUNGAH.mjs";
 import "./chunk-GQVGIUSN.mjs";
 import "./chunk-J4FNJ5IU.mjs";
-import "./chunk-LWMGIEJA.mjs";
+import "./chunk-PFE6GMNE.mjs";
 import "./chunk-RHIFZZUI.mjs";
 import "./chunk-LM2YNO4U.mjs";
-import "./chunk-JNYVN7YP.mjs";
-import "./chunk-5FW6PQ3J.mjs";
+import "./chunk-W4UIVMVI.mjs";
+import "./chunk-VVKWFZAH.mjs";
 import "./chunk-ITN462YM.mjs";
 import "./chunk-B232I2GP.mjs";
 import "./chunk-JK25YEN6.mjs";
 import "./chunk-GS6K5OCM.mjs";
 import "./chunk-44ZCFSKE.mjs";
-import "./chunk-GZWT6VI5.mjs";
+import "./chunk-ALCLXXTY.mjs";
+import "./chunk-V3XURYJO.mjs";
 import "./chunk-WZ5QFROO.mjs";
-import "./chunk-SHRJG6OG.mjs";
+import "./chunk-RBRLLZL5.mjs";
 import "./chunk-7ZY5AIJO.mjs";
 import "./chunk-ZBE6MLHL.mjs";
 import "./chunk-CGILA3WO.mjs";

package/dist/{production-runtime-BqTnUTai.d.ts → production-runtime-BoJDc5mc.d.ts}

@@ -1,4 +1,4 @@
-import { X as ReadonlyMiddlewareStore, Y as FarmMiddlewareConfig, Z as MiddlewareModule } from './client-plugins-CTnsZz_A.js';
+import { X as ReadonlyMiddlewareStore, Y as FarmMiddlewareConfig, Z as MiddlewareModule } from './client-plugins-Cw4qUGsw.js';
 import { R as ResolvedFarmI18nConfig } from './types-BH1lhg5G.js';
 
 /**

package/dist/{production-runtime-DtDdG9fc.d.mts → production-runtime-DPfgMV9Y.d.mts}

@@ -1,4 +1,4 @@
-import { X as ReadonlyMiddlewareStore, Y as FarmMiddlewareConfig, Z as MiddlewareModule } from './client-plugins-Cnr0D3kk.mjs';
+import { X as ReadonlyMiddlewareStore, Y as FarmMiddlewareConfig, Z as MiddlewareModule } from './client-plugins-DQQ1adXM.mjs';
 import { R as ResolvedFarmI18nConfig } from './types-BH1lhg5G.mjs';
 
 /**

package/dist/routes.cjs

@@ -162,11 +162,51 @@ __name(formatError, "formatError");
 
 // src/cache.ts
 var _FarmDataCache = class _FarmDataCache {
-  constructor() {
+  constructor(config = {}) {
     this.entries = /* @__PURE__ */ new Map();
     this.inflight = /* @__PURE__ */ new Map();
     this.invalidatedTagVersions = /* @__PURE__ */ new Map();
     this.version = 0;
+    this.namespace = "farm";
+    this.local = true;
+    this.lease = {
+      enabled: true,
+      ttlMs: 1e4,
+      waitTimeoutMs: 1e4,
+      pollIntervalMs: 25
+    };
+    this.configure(config);
+  }
+  configure(config = {}) {
+    this.adapter = config.adapter;
+    this.namespace = normalizeCacheNamespace(config.namespace || "farm");
+    this.local = !config.adapter;
+    this.lease = config.lease === false ? { ...this.lease, enabled: false } : {
+      enabled: true,
+      ttlMs: normalizePositiveDuration(config.lease?.ttlMs, 1e4, "cache.lease.ttlMs"),
+      waitTimeoutMs: normalizePositiveDuration(
+        config.lease?.waitTimeoutMs,
+        1e4,
+        "cache.lease.waitTimeoutMs"
+      ),
+      pollIntervalMs: normalizePositiveDuration(
+        config.lease?.pollIntervalMs,
+        25,
+        "cache.lease.pollIntervalMs"
+      )
+    };
+    if (!this.local) {
+      this.entries.clear();
+      this.inflight.clear();
+      this.invalidatedTagVersions.clear();
+      this.version = 0;
+    }
+  }
+  get adapterName() {
+    return this.adapter?.name || (this.adapter ? "custom" : "memory");
+  }
+  get hasAdapter() {
+    return this.adapter !== void 0;
   }
   get size() {
     return this.entries.size;
@@ -202,6 +242,45 @@ var _FarmDataCache = class _FarmDataCache {
     });
     return this.toPublicEntry(entry);
   }
+  async getEntryAsync(key, options = {}) {
+    if (this.local) {
+      const localEntry = this.getEntry(key, options);
+      if (localEntry) return localEntry;
+    }
+    if (!this.adapter) {
+      return this.local ? void 0 : this.getEntry(key, options);
+    }
+    const entry = await this.adapter.get(this.createAdapterKey(key));
+    if (!entry) {
+      emitFarmEvent({ type: "cache.miss", key });
+      return void 0;
+    }
+    assertFarmCacheEntry(entry, key);
+    const stale = await this.isAdapterEntryStale(entry, options.now);
+    if (stale) {
+      emitFarmEvent({
+        type: "cache.stale",
+        key,
+        tags: [...entry.tags],
+        revalidate: entry.revalidate
+      });
+      if (!options.allowStale) {
+        emitFarmEvent({ type: "cache.miss", key, reason: "stale" });
+        return void 0;
+      }
+    }
+    emitFarmEvent({
+      type: "cache.hit",
+      key,
+      tags: [...entry.tags],
+      revalidate: entry.revalidate,
+      stale
+    });
+    if (this.local && !stale) {
+      this.hydrateLocalEntry(entry);
+    }
+    return { ...entry, key };
+  }
   set(key, value, options = {}) {
     const tags = /* @__PURE__ */ new Set();
     for (const tag of options.tags ?? []) {
@@ -214,6 +293,7 @@ var _FarmDataCache = class _FarmDataCache {
       key,
       value,
       tags,
+      tagVersions: void 0,
       createdAt: options.createdAt ?? Date.now(),
       createdVersion: ++this.version,
       revalidate: normalizeRevalidate(options.revalidate)
@@ -227,11 +307,45 @@ var _FarmDataCache = class _FarmDataCache {
     });
     return this.toPublicEntry(entry);
   }
+  async setAsync(key, value, options = {}, tagVersions) {
+    const tags = normalizeCacheOptionsTags(options);
+    const capturedVersions = tagVersions ?? await this.getAdapterTagVersions(Array.from(tags.values()));
+    const entry = {
+      key,
+      value,
+      tags: Array.from(tags),
+      tagVersions: capturedVersions,
+      createdAt: options.createdAt ?? Date.now(),
+      createdVersion: ++this.version,
+      revalidate: normalizeRevalidate(options.revalidate)
+    };
+    if (this.local) {
+      this.hydrateLocalEntry(entry);
+    }
+    if (this.adapter) {
+      await this.adapter.set(this.createAdapterKey(key), entry);
+    }
+    emitFarmEvent({
+      type: "cache.set",
+      key,
+      tags: [...entry.tags],
+      revalidate: entry.revalidate
+    });
+    return entry;
+  }
   delete(key) {
     const deleted = this.entries.delete(key);
     emitFarmEvent({ type: "cache.delete", key, deleted });
     return deleted;
   }
+  async deleteAsync(key) {
+    const deleted = this.entries.delete(key);
+    if (this.adapter) {
+      await this.adapter.delete(this.createAdapterKey(key));
+    }
+    emitFarmEvent({ type: "cache.delete", key, deleted: this.adapter ? true : deleted });
+    return this.adapter ? true : deleted;
+  }
   clear() {
     const count = this.entries.size;
     this.entries.clear();
@@ -240,6 +354,10 @@ var _FarmDataCache = class _FarmDataCache {
     this.version = 0;
     emitFarmEvent({ type: "cache.clear", count });
   }
+  async clearAsync() {
+    this.clear();
+    await this.adapter?.clear?.();
+  }
   isStale(entry, now = Date.now()) {
     if (typeof entry.revalidate === "number" && entry.revalidate > 0 && now - entry.createdAt >= entry.revalidate * 1e3) {
       return true;
@@ -252,6 +370,12 @@ var _FarmDataCache = class _FarmDataCache {
     }
     return false;
   }
+  async isStaleAsync(entry, now = Date.now()) {
+    if (this.adapter) {
+      return this.isAdapterEntryStale(entry, now);
+    }
+    return this.isStale(entry, now);
+  }
   revalidateTag(tag, options = {}) {
     const normalized = normalizeCacheTag(tag);
     const count = this.invalidateTag(normalized);
@@ -260,6 +384,15 @@ var _FarmDataCache = class _FarmDataCache {
     );
     return count;
   }
+  async revalidateTagAsync(tag, options = {}) {
+    const normalized = normalizeCacheTag(tag);
+    const count = this.invalidateTag(normalized);
+    await this.adapter?.invalidateTags?.([this.createAdapterTag(normalized)]);
+    emitFarmEvent(
+      options.source === "updateTag" ? { type: "cache.updateTag", tag: normalized, count } : { type: "cache.revalidateTag", tag: normalized, profile: options.profile, count }
+    );
+    return count;
+  }
   revalidatePath(routePath) {
     const normalizedPath = normalizeRevalidatePath(routePath);
     const pathTag = createPathCacheTag(normalizedPath);
@@ -276,8 +409,25 @@ var _FarmDataCache = class _FarmDataCache {
     }
     return count;
   }
+  async revalidatePathAsync(routePath) {
+    const normalizedPath = normalizeRevalidatePath(routePath);
+    const pathTag = createPathCacheTag(normalizedPath);
+    const pprCount = this.countEntriesForTags([pathTag, "ppr"]);
+    const count = this.invalidateTag(pathTag);
+    await this.adapter?.invalidateTags?.([this.createAdapterTag(pathTag)]);
+    emitFarmEvent({ type: "cache.revalidatePath", path: normalizedPath, count });
+    if (pprCount > 0) {
+      emitFarmEvent({
+        type: "ppr.shell.invalidated",
+        route: normalizedPath,
+        reason: "revalidatePath",
+        count: pprCount
+      });
+    }
+    return count;
+  }
   async getOrSet(key, producer, options = {}) {
-    const cached = this.getEntry(key);
+    const cached = await this.getEntryAsync(key);
     if (cached) {
       return cached.value;
     }
@@ -286,10 +436,8 @@ var _FarmDataCache = class _FarmDataCache {
       emitFarmEvent({ type: "cache.dedupe", key });
       return inflight;
     }
-    const promise = Promise.resolve().then(producer).then((value) => {
-      this.set(key, value, options);
-      return value;
-    }).catch((error) => {
+    const tags = Array.from(normalizeCacheOptionsTags(options));
+    const promise = this.fillCacheEntry(key, producer, options, tags).catch((error) => {
       emitFarmEvent({ type: "cache.error", key, operation: "set", error });
       throw error;
     }).finally(() => {
@@ -298,6 +446,40 @@ var _FarmDataCache = class _FarmDataCache {
     this.inflight.set(key, promise);
     return promise;
   }
+  async fillCacheEntry(key, producer, options, tags) {
+    const leaseKey = `${this.namespace}:lease:${key}`;
+    let leaseToken;
+    if (this.adapter?.acquireLease && this.adapter.releaseLease && this.lease.enabled) {
+      leaseToken = await this.adapter.acquireLease(leaseKey, this.lease.ttlMs);
+      if (!leaseToken) {
+        const shared = await this.waitForAdapterEntry(key);
+        if (shared) {
+          emitFarmEvent({ type: "cache.dedupe", key });
+          return shared.value;
+        }
+        leaseToken = await this.adapter.acquireLease(leaseKey, this.lease.ttlMs);
+      }
+    }
+    try {
+      const initialTagVersions = await this.getAdapterTagVersions(tags);
+      const value = await producer();
+      await this.setAsync(key, value, options, initialTagVersions);
+      return value;
+    } finally {
+      if (leaseToken && this.adapter?.releaseLease) {
+        await this.adapter.releaseLease(leaseKey, leaseToken);
+      }
+    }
+  }
+  async waitForAdapterEntry(key) {
+    const deadline = Date.now() + this.lease.waitTimeoutMs;
+    while (Date.now() < deadline) {
+      await delay(this.lease.pollIntervalMs);
+      const entry = await this.getEntryAsync(key);
+      if (entry) return entry;
+    }
+    return void 0;
+  }
   countEntriesForTag(tag) {
     let count = 0;
     for (const entry of this.entries.values()) {
@@ -325,11 +507,53 @@ var _FarmDataCache = class _FarmDataCache {
       key: entry.key,
       value: entry.value,
       tags: Array.from(entry.tags),
+      tagVersions: entry.tagVersions,
       createdAt: entry.createdAt,
       createdVersion: entry.createdVersion,
       revalidate: entry.revalidate
     };
   }
+  hydrateLocalEntry(entry) {
+    this.entries.set(entry.key, {
+      key: entry.key,
+      value: entry.value,
+      tags: new Set(entry.tags.map(normalizeCacheTag)),
+      tagVersions: entry.tagVersions,
+      createdAt: entry.createdAt,
+      createdVersion: entry.createdVersion ?? ++this.version,
+      revalidate: normalizeRevalidate(entry.revalidate)
+    });
+  }
+  createAdapterKey(key) {
+    return `${this.namespace}:entry:${key}`;
+  }
+  createAdapterTag(tag) {
+    return `${this.namespace}:tag:${tag}`;
+  }
+  async getAdapterTagVersions(tags) {
+    if (!this.adapter?.getTagVersions || tags.length === 0) return {};
+    const normalized = tags.map(normalizeCacheTag);
+    const physicalTags = normalized.map((tag) => this.createAdapterTag(tag));
+    const versions = await this.adapter.getTagVersions(physicalTags);
+    return Object.fromEntries(
+      normalized.map((tag, index) => [
+        tag,
+        normalizeAdapterVersion(versions[physicalTags[index]])
+      ])
+    );
+  }
+  async isAdapterEntryStale(entry, now = Date.now()) {
+    if (typeof entry.revalidate === "number" && entry.revalidate > 0 && now - entry.createdAt >= entry.revalidate * 1e3) {
+      return true;
+    }
+    const currentVersions = await this.getAdapterTagVersions(entry.tags);
+    for (const tag of entry.tags) {
+      if (normalizeAdapterVersion(currentVersions[tag]) > normalizeAdapterVersion(entry.tagVersions?.[tag])) {
+        return true;
+      }
+    }
+    return false;
+  }
 };
 __name(_FarmDataCache, "FarmDataCache");
 var FarmDataCache = _FarmDataCache;
@@ -402,6 +626,52 @@ function normalizeCacheTag(tag) {
   return normalized;
 }
 __name(normalizeCacheTag, "normalizeCacheTag");
+function normalizeCacheNamespace(namespace) {
+  if (typeof namespace !== "string") {
+    throw new TypeError("Cache namespace must be a string.");
+  }
+  const normalized = namespace.trim().replace(/:+$/g, "");
+  if (!normalized) {
+    throw new Error("Cache namespace cannot be empty.");
+  }
+  return normalized;
+}
+__name(normalizeCacheNamespace, "normalizeCacheNamespace");
+function normalizeAdapterVersion(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
+}
+__name(normalizeAdapterVersion, "normalizeAdapterVersion");
+function normalizePositiveDuration(value, fallback, name) {
+  if (value === void 0) return fallback;
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new TypeError(`${name} must be a positive number of milliseconds.`);
+  }
+  return Math.floor(value);
+}
+__name(normalizePositiveDuration, "normalizePositiveDuration");
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+__name(delay, "delay");
+function normalizeCacheOptionsTags(options) {
+  const tags = /* @__PURE__ */ new Set();
+  for (const tag of options.tags ?? []) {
+    tags.add(normalizeCacheTag(tag));
+  }
+  for (const routePath of options.paths ?? []) {
+    tags.add(createPathCacheTag(routePath));
+  }
+  return tags;
+}
+__name(normalizeCacheOptionsTags, "normalizeCacheOptionsTags");
+function assertFarmCacheEntry(entry, expectedKey) {
+  if (!entry || typeof entry !== "object" || entry.key !== expectedKey || !Array.isArray(entry.tags) || typeof entry.createdAt !== "number") {
+    throw new TypeError(
+      `Cache adapter returned an invalid entry for ${JSON.stringify(expectedKey)}.`
+    );
+  }
+}
+__name(assertFarmCacheEntry, "assertFarmCacheEntry");
 function getFunctionCacheIdentity(fn) {
   if (fn.name) {
     return `name:${fn.name}`;