@farm.js/core 0.1.16 → 0.1.18

package/dist/{chunk-Q3MDL7TM.mjs → chunk-ZCNJKLA2.mjs}

@@ -2,7 +2,7 @@ import {
   getFarmMarkdownMirrorPath,
   isFarmMarkdownMirrorExposed,
   matchesFarmMarkdownRoutePattern
-} from "./chunk-6SCB2MXB.mjs";
+} from "./chunk-SXHV42UQ.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-4RB44K6Z.mjs";
@@ -949,6 +949,7 @@ function manageFarmHtmlPreloads(html, config) {
       {
         index,
         kind,
+        href: readHtmlAttribute(element.value, "href"),
         highPriority: readHtmlAttribute(element.value, "fetchpriority")?.toLowerCase() === "high"
       }
     ] : [];
@@ -972,6 +973,7 @@ function manageFarmLinkHeaderPreloads(value, config) {
       {
         index,
         kind,
+        href: getLinkHeaderTarget(link),
         highPriority: getLinkHeaderParameter(link, "fetchpriority")?.toLowerCase() === "high"
       }
     ] : [];
@@ -994,6 +996,7 @@ function manageFarmDocumentPreloads(html, linkHeader, config) {
     candidates.push({
       index,
       kind,
+      href: readHtmlAttribute(element.value, "href"),
       highPriority: readHtmlAttribute(element.value, "fetchpriority")?.toLowerCase() === "high"
     });
   }
@@ -1003,6 +1006,7 @@ function manageFarmDocumentPreloads(html, linkHeader, config) {
     candidates.push({
       index: headerOffset + index,
       kind,
+      href: getLinkHeaderTarget(link),
       highPriority: getLinkHeaderParameter(link, "fetchpriority")?.toLowerCase() === "high"
     });
   }
@@ -1051,24 +1055,33 @@ function selectPreloadsWithinBudget(candidates, config) {
   const removed = /* @__PURE__ */ new Set();
   const warnings = [];
   for (const kind of ["image", "font"]) {
-    const matching = candidates.filter((candidate) => candidate.kind === kind);
+    const resources = /* @__PURE__ */ new Map();
+    for (const candidate of candidates) {
+      if (candidate.kind !== kind) continue;
+      const key = candidate.href ?? `#${candidate.index}`;
+      const hints = resources.get(key);
+      if (hints) hints.push(candidate);
+      else resources.set(key, [candidate]);
+    }
     const limit = kind === "image" ? config.maxImages : config.maxFonts;
-    if (matching.length <= limit) continue;
-    const retained = new Set(
-      [...matching].sort(
-        (left, right) => Number(right.highPriority) - Number(left.highPriority) || left.index - right.index
-      ).slice(0, limit).map((candidate) => candidate.index)
+    if (resources.size <= limit) continue;
+    const ranked = [...resources.values()].map((hints) => ({
+      hints,
+      index: hints[0].index,
+      highPriority: hints.some((hint) => hint.highPriority)
+    })).sort(
+      (left, right) => Number(right.highPriority) - Number(left.highPriority) || left.index - right.index
     );
     if (config.mode === "enforce") {
-      for (const candidate of matching) {
-        if (!retained.has(candidate.index)) removed.add(candidate.index);
+      for (const resource of ranked.slice(limit)) {
+        for (const hint of resource.hints) removed.add(hint.index);
       }
     }
     warnings.push({
       kind,
-      count: matching.length,
+      count: resources.size,
       budget: limit,
-      removed: config.mode === "enforce" ? matching.length - retained.size : 0
+      removed: config.mode === "enforce" ? resources.size - limit : 0
     });
   }
   return { removed, warnings };
@@ -1086,6 +1099,12 @@ function getLinkHeaderPreloadKind(link) {
   return normalizePreloadKind(getLinkHeaderParameter(link, "as"));
 }
 __name(getLinkHeaderPreloadKind, "getLinkHeaderPreloadKind");
+function getLinkHeaderTarget(link) {
+  const start = link.indexOf("<");
+  const end = link.indexOf(">", start + 1);
+  return start === -1 || end === -1 ? void 0 : link.slice(start + 1, end).trim();
+}
+__name(getLinkHeaderTarget, "getLinkHeaderTarget");
 function getLinkHeaderParameter(link, name) {
   const uriEnd = link.indexOf(">");
   if (uriEnd === -1) return void 0;

package/dist/chunk-ZEG3OPIB.cjs

@@ -0,0 +1,93 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/cache-invalidation.ts
+var FARM_CACHE_INVALIDATION_HEADER = "x-farm-cache-invalidations";
+var FARM_CACHE_INVALIDATION_STATE = /* @__PURE__ */ Symbol.for("farm.cacheInvalidationState");
+var globalState = globalThis;
+function getFarmCacheInvalidationState() {
+  return _nullishCoalesce(globalState[FARM_CACHE_INVALIDATION_STATE], () => ( (globalState[FARM_CACHE_INVALIDATION_STATE] = {
+    listeners: /* @__PURE__ */ new Set(),
+    taskListeners: /* @__PURE__ */ new Set()
+  })));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getFarmCacheInvalidationState, "getFarmCacheInvalidationState");
+function warnFarmCacheListenerError(scope, error) {
+  const detail = error instanceof Error ? _nullishCoalesce(error.stack, () => ( error.message)) : String(error);
+  console.warn(`[farm:cache] ${scope} listener failed: ${detail}`);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, warnFarmCacheListenerError, "warnFarmCacheListenerError");
+function notifyFarmCacheInvalidation(key, source = "local") {
+  if (typeof key !== "string" || key.length === 0) return;
+  for (const listener of getFarmCacheInvalidationState().listeners) {
+    try {
+      listener(key, source);
+    } catch (error) {
+      warnFarmCacheListenerError("invalidation", error);
+    }
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, notifyFarmCacheInvalidation, "notifyFarmCacheInvalidation");
+function notifyFarmCacheTask(task) {
+  for (const listener of getFarmCacheInvalidationState().taskListeners) {
+    try {
+      listener(task);
+    } catch (error) {
+      warnFarmCacheListenerError("task", error);
+    }
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, notifyFarmCacheTask, "notifyFarmCacheTask");
+function applyFarmCacheInvalidations(keys, source = "local") {
+  if (!Array.isArray(keys)) return;
+  for (const key of keys) {
+    if (typeof key === "string") {
+      notifyFarmCacheInvalidation(key, source);
+    }
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, applyFarmCacheInvalidations, "applyFarmCacheInvalidations");
+function encodeFarmCacheInvalidations(keys) {
+  const normalized = Array.from(
+    new Set(keys.filter((key) => typeof key === "string" && key.length > 0))
+  );
+  if (normalized.length === 0) return null;
+  return encodeURIComponent(JSON.stringify(normalized));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, encodeFarmCacheInvalidations, "encodeFarmCacheInvalidations");
+function decodeFarmCacheInvalidations(value) {
+  if (!value) return [];
+  try {
+    const parsed = JSON.parse(decodeURIComponent(value));
+    return Array.isArray(parsed) ? Array.from(
+      new Set(parsed.filter((key) => typeof key === "string" && key.length > 0))
+    ) : [];
+  } catch (e) {
+    return [];
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, decodeFarmCacheInvalidations, "decodeFarmCacheInvalidations");
+function subscribeFarmCacheInvalidation(listener) {
+  const state = getFarmCacheInvalidationState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, subscribeFarmCacheInvalidation, "subscribeFarmCacheInvalidation");
+function subscribeFarmCacheTask(listener) {
+  const state = getFarmCacheInvalidationState();
+  state.taskListeners.add(listener);
+  return () => state.taskListeners.delete(listener);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, subscribeFarmCacheTask, "subscribeFarmCacheTask");
+
+
+
+
+
+
+
+
+
+
+exports.FARM_CACHE_INVALIDATION_HEADER = FARM_CACHE_INVALIDATION_HEADER; exports.notifyFarmCacheInvalidation = notifyFarmCacheInvalidation; exports.notifyFarmCacheTask = notifyFarmCacheTask; exports.applyFarmCacheInvalidations = applyFarmCacheInvalidations; exports.encodeFarmCacheInvalidations = encodeFarmCacheInvalidations; exports.decodeFarmCacheInvalidations = decodeFarmCacheInvalidations; exports.subscribeFarmCacheInvalidation = subscribeFarmCacheInvalidation; exports.subscribeFarmCacheTask = subscribeFarmCacheTask;

package/dist/chunk-ZMN3H73H.cjs

@@ -0,0 +1,155 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } async function _asyncOptionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = await fn(value); } else if (op === 'call' || op === 'optionalCall') { value = await fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+var _chunkG3HRIVEYcjs = require('./chunk-G3HRIVEY.cjs');
+
+
+var _chunkSK35NQKKcjs = require('./chunk-SK35NQKK.cjs');
+
+
+var _chunkT5CERMEHcjs = require('./chunk-T5CERMEH.cjs');
+
+
+
+
+
+var _chunkH6G5INWMcjs = require('./chunk-H6G5INWM.cjs');
+
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/server-query.ts
+var FARM_SERVER_QUERY_SYMBOL = /* @__PURE__ */ Symbol.for("farm.server-query");
+var requestInflight = /* @__PURE__ */ new WeakMap();
+var detachedInflight = /* @__PURE__ */ new Map();
+function createServerQuery(options) {
+  if (!options || typeof options.handler !== "function") {
+    throw new TypeError("createServerQuery requires a handler function");
+  }
+  if (typeof options.key !== "function") {
+    throw new TypeError("createServerQuery requires a key function");
+  }
+  const staleTime = normalizeServerQueryStaleTime(options.staleTime);
+  const execute = _chunkG3HRIVEYcjs.createServerFn.call(void 0, {
+    input: options.input,
+    middleware: options.middleware,
+    handler: /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async (context) => {
+      const routeKey = await options.key(context);
+      assertServerQueryKey(routeKey);
+      const clientKey = _chunkH6G5INWMcjs.createRouteDataCacheKey.call(void 0, routeKey);
+      const cacheKey = _chunkH6G5INWMcjs.createFarmCacheKey.call(void 0, ["route-data", routeKey]);
+      const producer = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async () => {
+        const value = await options.handler(context);
+        return _chunkG3HRIVEYcjs._parseServerFnSchema.call(void 0, options.output, value, "output", "createServerQuery");
+      }, "producer");
+      let data;
+      let updatedAt;
+      if (staleTime === 0) {
+        data = await dedupeServerQueryRequest(cacheKey, context.request, producer);
+        updatedAt = Date.now();
+      } else {
+        const cache = _chunkH6G5INWMcjs.getFarmDataCache.call(void 0, );
+        data = await cache.getOrSet(cacheKey, producer, {
+          tags: [_chunkH6G5INWMcjs.createRouteDataCacheTag.call(void 0, routeKey)],
+          revalidate: staleTime === false ? false : staleTime / 1e3
+        });
+        updatedAt = await _asyncNullishCoalesce(await _asyncOptionalChain([(await cache.getEntryAsync(cacheKey, { allowStale: true })), 'optionalAccess', async _ => _.createdAt]), async () => ( Date.now()));
+      }
+      return _chunkSK35NQKKcjs.createFarmServerQueryResult.call(void 0, data, {
+        key: clientKey,
+        staleTime,
+        updatedAt,
+        ...options.persist === true ? { persist: true } : {}
+      });
+    }, "handler")
+  });
+  const query = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async (input) => {
+    const result = await execute(input);
+    return _chunkT5CERMEHcjs.getServerActionExecutionContext.call(void 0, ) ? result : result.data;
+  }, "query");
+  Object.defineProperties(query, {
+    [FARM_SERVER_QUERY_SYMBOL]: {
+      value: true,
+      enumerable: false
+    },
+    __farmServerQuery: {
+      value: true,
+      enumerable: false
+    },
+    __farmServerQueryInput: {
+      value: options.input,
+      enumerable: false
+    },
+    __farmServerQueryOutput: {
+      value: options.output,
+      enumerable: false
+    }
+  });
+  _chunkG3HRIVEYcjs._attachServerFunctionDescriptor.call(void 0, 
+    query,
+    _chunkG3HRIVEYcjs.createServerFunctionDescriptor.call(void 0, "query", options, async (value) => {
+      const result = await _chunkG3HRIVEYcjs._runServerFunctionForCaller.call(void 0, 
+        execute,
+        value
+      );
+      return result.data;
+    })
+  );
+  return query;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createServerQuery, "createServerQuery");
+async function dedupeServerQueryRequest(key, request, producer) {
+  let inflight;
+  if (request) {
+    inflight = _nullishCoalesce(requestInflight.get(request), () => ( /* @__PURE__ */ new Map()));
+    requestInflight.set(request, inflight);
+  } else {
+    inflight = detachedInflight;
+  }
+  const existing = inflight.get(key);
+  if (existing) return existing;
+  const promise = Promise.resolve().then(producer);
+  inflight.set(key, promise);
+  try {
+    return await promise;
+  } finally {
+    inflight.delete(key);
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, dedupeServerQueryRequest, "dedupeServerQueryRequest");
+function normalizeServerQueryStaleTime(value) {
+  if (value === false) return false;
+  if (value === void 0) return 0;
+  if (typeof value === "number") {
+    if (!Number.isFinite(value) || value < 0) {
+      throw new TypeError("createServerQuery staleTime must be a non-negative duration");
+    }
+    return value;
+  }
+  const match = value.match(/^(\d+(?:\.\d+)?)(ms|s|m|h)$/);
+  if (!match) {
+    throw new TypeError('createServerQuery staleTime must look like "250ms", "30s", "5m", or "1h"');
+  }
+  const amount = Number(match[1]);
+  const unit = match[2];
+  const multiplier = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : 36e5;
+  return amount * multiplier;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeServerQueryStaleTime, "normalizeServerQueryStaleTime");
+function assertServerQueryKey(key) {
+  if (typeof key === "string") {
+    if (key.trim().length > 0) return;
+  } else if (Array.isArray(key)) {
+    return;
+  }
+  throw new TypeError("createServerQuery key must return a non-empty string or an array");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, assertServerQueryKey, "assertServerQueryKey");
+
+
+
+
+exports.FARM_SERVER_QUERY_SYMBOL = FARM_SERVER_QUERY_SYMBOL; exports.createServerQuery = createServerQuery;

package/dist/client/lifecycle.cjs

@@ -1,37 +1,8 @@
-"use strict";
-"use client";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-// src/client/lifecycle.ts
-var lifecycle_exports = {};
-__export(lifecycle_exports, {
-  defineClient: () => defineClient
-});
-module.exports = __toCommonJS(lifecycle_exports);
 
-// src/client/plugin.ts
-function defineClient(definition) {
-  return definition;
-}
-__name(defineClient, "defineClient");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  defineClient
-});
+var _chunkVB6UCX3Vcjs = require('../chunk-VB6UCX3V.cjs');
+require('../chunk-S3JO3N4H.cjs');
+
+
+exports.defineClient = _chunkVB6UCX3Vcjs.defineClient;

package/dist/{client-plugins-CqVtZi5X.d.ts → client-plugins-C089bQhN.d.ts}

@@ -1,6 +1,6 @@
 import { n as FarmClientPlugin } from './lifecycle-DK06VuKP.js';
-import { R as RouteMethod, g as PluginRoutes, P as PluginRoutesFactory } from './route-BxNJT447.js';
-import { T as TypedEndpoint, d as EndpointMCPMetadata, R as RouteSchema, a as RouteSchemaOutput, c as RouteSchemaInput, Y as OpenAPISecurityMode } from './endpoint-kSAxE52R.js';
+import { R as RouteMethod, g as PluginRoutes, P as PluginRoutesFactory } from './route-DOEpbyWZ.js';
+import { T as TypedEndpoint, d as EndpointMCPMetadata, R as RouteSchema, a as RouteSchemaOutput, c as RouteSchemaInput, Y as OpenAPISecurityMode } from './endpoint-1zA994xL.js';
 import { FarmRenderer } from './renderer.js';
 import { IncomingMessage, ServerResponse } from 'http';
 import { FarmMarkdownResolvedConfig, FarmMarkdownUserConfig } from './markdown.js';

package/dist/{client-plugins-CIPRtSsW.d.mts → client-plugins-JXXmZliS.d.mts}

@@ -1,6 +1,6 @@
 import { n as FarmClientPlugin } from './lifecycle-DK06VuKP.mjs';
-import { R as RouteMethod, g as PluginRoutes, P as PluginRoutesFactory } from './route-C_eLaFTZ.mjs';
-import { T as TypedEndpoint, d as EndpointMCPMetadata, R as RouteSchema, a as RouteSchemaOutput, c as RouteSchemaInput, Y as OpenAPISecurityMode } from './endpoint-Bu3XgeMK.mjs';
+import { R as RouteMethod, g as PluginRoutes, P as PluginRoutesFactory } from './route-B0XrsrFk.mjs';
+import { T as TypedEndpoint, d as EndpointMCPMetadata, R as RouteSchema, a as RouteSchemaOutput, c as RouteSchemaInput, Y as OpenAPISecurityMode } from './endpoint-DAc96i93.mjs';
 import { FarmRenderer } from './renderer.mjs';
 import { IncomingMessage, ServerResponse } from 'http';
 import { FarmMarkdownResolvedConfig, FarmMarkdownUserConfig } from './markdown.mjs';