@farm.js/core 0.1.60 → 0.1.61

package/dist/chunk-ZXK2EYQW.cjs

@@ -1,8 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/schema.ts
-function defineSchema(schema) {
-  return schema;
-}
-
-
-
-exports.defineSchema = defineSchema;

package/dist/chunk-ZZ2QKCKW.mjs

@@ -1,293 +0,0 @@
-import {
-  FARM_DEFAULT_MCP_DESCRIPTION,
-  FARM_DEFAULT_MCP_PROTOCOL_VERSIONS,
-  FARM_DEFAULT_MCP_TOOLS
-} from "./chunk-UZZ6IEQP.mjs";
-import {
-  stripFarmBasePath
-} from "./chunk-SF3JB56B.mjs";
-
-// src/agent-mcp-handler.ts
-var INSTRUCTIONS = "This server reads the site's public pages. Call list_pages or search_pages to find a page, then read_page with its path to get the page as Markdown. It cannot change anything.";
-var MAX_BODY_BYTES = 64 * 1024;
-var MAX_BATCH = 16;
-var READ_TIMEOUT_MS = 3e4;
-var FarmMCPRequestError = class extends Error {
-  constructor(code, message) {
-    super(message);
-    this.code = code;
-  }
-};
-var PARSE_ERROR = -32700;
-var INVALID_REQUEST = -32600;
-var METHOD_NOT_FOUND = -32601;
-var INVALID_PARAMS = -32602;
-var INTERNAL_ERROR = -32603;
-var TRANSPORT_ERROR = -32e3;
-async function handleFarmDefaultMCPRequest(request, context) {
-  const method = request.method.toUpperCase();
-  if (method !== "POST") {
-    return transportError(405, "Method not allowed. Send MCP requests with POST.", {
-      Allow: "POST"
-    });
-  }
-  const origin = request.headers.get("origin");
-  if (origin && !isSameOrigin(origin, request.url)) {
-    return transportError(403, "Cross-origin requests are not allowed.");
-  }
-  const protocolHeader = request.headers.get("mcp-protocol-version");
-  if (protocolHeader && !FARM_DEFAULT_MCP_PROTOCOL_VERSIONS.includes(protocolHeader.trim())) {
-    return transportError(
-      400,
-      `Unsupported MCP-Protocol-Version: ${protocolHeader.slice(0, 32)}. Supported: ${FARM_DEFAULT_MCP_PROTOCOL_VERSIONS.join(", ")}.`
-    );
-  }
-  const contentType = request.headers.get("content-type") ?? "";
-  if (!/^application\/json\s*(?:;|$)/i.test(contentType.trim())) {
-    return transportError(415, "Content-Type must be application/json.");
-  }
-  const text = await readBody(request);
-  if (text === null) return transportError(413, "The request body is too large.");
-  let message;
-  try {
-    message = JSON.parse(text);
-  } catch {
-    return json(400, rpcError(null, { code: PARSE_ERROR, message: "Parse error." }));
-  }
-  if (Array.isArray(message)) {
-    if (message.length === 0 || message.length > MAX_BATCH) {
-      return json(
-        400,
-        rpcError(null, { code: INVALID_REQUEST, message: "Invalid batch of JSON-RPC messages." })
-      );
-    }
-    const replies = (await Promise.all(message.map((item) => answerMessage(item, request, context)))).filter((reply2) => reply2 !== void 0);
-    return replies.length ? json(200, replies) : new Response(null, { status: 202 });
-  }
-  const reply = await answerMessage(message, request, context);
-  return reply === void 0 ? new Response(null, { status: 202 }) : json(200, reply);
-}
-async function answerMessage(message, request, context) {
-  if (!isRecord(message) || message.jsonrpc !== "2.0") {
-    return rpcError(readId(message), { code: INVALID_REQUEST, message: "Invalid Request." });
-  }
-  const hasId = "id" in message;
-  if (typeof message.method !== "string") {
-    if (hasId && ("result" in message || "error" in message)) return void 0;
-    return rpcError(readId(message), { code: INVALID_REQUEST, message: "Invalid Request." });
-  }
-  if (!hasId) return void 0;
-  const id = readId(message);
-  if (id === void 0) {
-    return rpcError(null, { code: INVALID_REQUEST, message: "Invalid Request id." });
-  }
-  try {
-    const result = await dispatch(message.method, message.params, request, context);
-    return { jsonrpc: "2.0", id, result };
-  } catch (error) {
-    if (error instanceof FarmMCPRequestError) {
-      return rpcError(id, { code: error.code, message: error.message });
-    }
-    return rpcError(id, { code: INTERNAL_ERROR, message: "Internal error." });
-  }
-}
-async function dispatch(method, params, request, context) {
-  switch (method) {
-    case "initialize": {
-      const requested = isRecord(params) ? params.protocolVersion : void 0;
-      const protocolVersion = typeof requested === "string" && FARM_DEFAULT_MCP_PROTOCOL_VERSIONS.includes(requested) ? requested : FARM_DEFAULT_MCP_PROTOCOL_VERSIONS[0];
-      return {
-        protocolVersion,
-        capabilities: { tools: { listChanged: false } },
-        serverInfo: {
-          name: context.server.name,
-          version: context.server.version,
-          ...context.server.title ? { title: context.server.title } : {},
-          description: FARM_DEFAULT_MCP_DESCRIPTION
-        },
-        instructions: INSTRUCTIONS
-      };
-    }
-    case "ping":
-      return {};
-    case "tools/list":
-      return { tools: FARM_DEFAULT_MCP_TOOLS };
-    case "tools/call":
-      return callTool(params, request, context);
-    default:
-      throw new FarmMCPRequestError(METHOD_NOT_FOUND, `Method not found: ${method.slice(0, 64)}`);
-  }
-}
-async function callTool(params, request, context) {
-  if (!isRecord(params) || typeof params.name !== "string") {
-    throw new FarmMCPRequestError(INVALID_PARAMS, "tools/call needs a tool name.");
-  }
-  const tool = FARM_DEFAULT_MCP_TOOLS.find(({ name }) => name === params.name);
-  if (!tool) {
-    throw new FarmMCPRequestError(INVALID_PARAMS, `Unknown tool: ${params.name.slice(0, 64)}`);
-  }
-  const args = params.arguments ?? {};
-  if (!isRecord(args)) return toolError("Arguments must be an object.");
-  const allowed = new Set(Object.keys(tool.inputSchema.properties));
-  const unknown = Object.keys(args).find((key) => !allowed.has(key));
-  if (unknown) return toolError(`Unknown argument: ${unknown.slice(0, 64)}.`);
-  if (tool.name === "list_pages") return pagesResult(await context.listPages());
-  if (tool.name === "search_pages") {
-    const query = args.query;
-    if (typeof query !== "string" || !query.trim() || query.length > 200) {
-      return toolError("query must be a non-empty string of at most 200 characters.");
-    }
-    const limit = args.limit ?? 10;
-    if (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1 || limit > 50) {
-      return toolError("limit must be a whole number from 1 to 50.");
-    }
-    return pagesResult(searchPages(await context.listPages(), query, limit));
-  }
-  const path = args.path;
-  if (typeof path !== "string" || !path.trim() || path.length > 2048) {
-    return toolError('path must be a page path such as "/about".');
-  }
-  const pagePath = toPagePath(path, request.url, context.basePath);
-  const pages = await context.listPages();
-  const page = pagePath ? pages.find((candidate) => candidate.path === pagePath) : void 0;
-  if (!page) {
-    return toolError(
-      `No public page at ${JSON.stringify(path.slice(0, 200))}. Call list_pages for the pages this server can read.`
-    );
-  }
-  const markdown = await readWithTimeout(context.readMarkdown, page.markdownUrl);
-  if (markdown === null) {
-    return toolError(`${page.path} did not answer with Markdown. Try again later.`);
-  }
-  return { content: [{ type: "text", text: markdown }] };
-}
-function pagesResult(pages) {
-  const structured = {
-    pages: pages.map(({ path, title, url, description }) => ({
-      path,
-      title,
-      url,
-      ...description ? { description } : {}
-    }))
-  };
-  return {
-    content: [{ type: "text", text: JSON.stringify(structured) }],
-    structuredContent: structured
-  };
-}
-function toolError(text) {
-  return { content: [{ type: "text", text }], isError: true };
-}
-function searchPages(pages, query, limit) {
-  const terms = query.toLowerCase().split(/\s+/).filter(Boolean).slice(0, 16);
-  return pages.map((page) => {
-    const title = page.title.toLowerCase();
-    const rest = `${page.description ?? ""} ${page.path}`.toLowerCase();
-    let score = 0;
-    for (const term of terms) {
-      if (title.includes(term)) score += 2;
-      else if (rest.includes(term)) score += 1;
-      else return null;
-    }
-    return { page, score };
-  }).filter((match) => match !== null).sort(
-    (left, right) => right.score - left.score || left.page.path.localeCompare(right.page.path)
-  ).slice(0, limit).map(({ page }) => page);
-}
-function toPagePath(input, requestUrl, basePath) {
-  let url;
-  try {
-    url = new URL(input.trim(), requestUrl);
-  } catch {
-    return null;
-  }
-  if (url.origin !== new URL(requestUrl).origin) return null;
-  let path = url.pathname;
-  try {
-    path = decodeURI(path);
-  } catch {
-    return null;
-  }
-  path = stripFarmBasePath(path, basePath);
-  if (path === "/index.md") return "/";
-  if (path.toLowerCase().endsWith(".md")) path = path.slice(0, -3) || "/";
-  return path.length > 1 ? path.replace(/\/+$/, "") || "/" : path;
-}
-async function readWithTimeout(read, url) {
-  let timer;
-  const timedOut = new Promise((resolve) => {
-    timer = setTimeout(resolve, READ_TIMEOUT_MS, null);
-  });
-  try {
-    return await Promise.race([read(url), timedOut]);
-  } finally {
-    clearTimeout(timer);
-  }
-}
-async function readBody(request) {
-  const declared = Number(request.headers.get("content-length"));
-  if (Number.isFinite(declared) && declared > MAX_BODY_BYTES) {
-    await request.body?.cancel().catch(() => {
-    });
-    return null;
-  }
-  if (!request.body) return "";
-  const reader = request.body.getReader();
-  const chunks = [];
-  let size = 0;
-  for (; ; ) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    size += value.byteLength;
-    if (size > MAX_BODY_BYTES) {
-      await reader.cancel().catch(() => {
-      });
-      return null;
-    }
-    chunks.push(value);
-  }
-  const body = new Uint8Array(size);
-  let offset = 0;
-  for (const chunk of chunks) {
-    body.set(chunk, offset);
-    offset += chunk.byteLength;
-  }
-  return new TextDecoder().decode(body);
-}
-function isSameOrigin(origin, requestUrl) {
-  try {
-    return new URL(origin).host === new URL(requestUrl).host;
-  } catch {
-    return false;
-  }
-}
-function readId(message) {
-  if (!isRecord(message)) return null;
-  const { id } = message;
-  return typeof id === "string" || typeof id === "number" && Number.isFinite(id) || id === null ? id : void 0;
-}
-function rpcError(id, error) {
-  return { jsonrpc: "2.0", id: id ?? null, error };
-}
-function json(status, body) {
-  return new Response(JSON.stringify(body), {
-    status,
-    headers: {
-      "Content-Type": "application/json; charset=utf-8",
-      "Cache-Control": "no-store",
-      "X-Content-Type-Options": "nosniff"
-    }
-  });
-}
-function transportError(status, message, headers = {}) {
-  const response = json(status, rpcError(null, { code: TRANSPORT_ERROR, message }));
-  for (const [name, value] of Object.entries(headers)) response.headers.set(name, value);
-  return response;
-}
-function isRecord(value) {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-
-export {
-  handleFarmDefaultMCPRequest
-};

package/dist/chunk-recovery.d-lnQFzcQP.d.mts

@@ -1,26 +0,0 @@
-interface FarmChunkRecoveryOptions {
-    /**
-     * How long a page is considered already recovered before another chunk
-     * failure may trigger a reload. Defaults to 30 seconds.
-     */
-    maxAgeMs?: number;
-    /**
-     * Override the storage key. Mostly useful for tests and embedded runtimes.
-     */
-    storageKey?: string;
-    /**
-     * Called right before Farm reloads the page.
-     */
-    onRecover?: (error: unknown) => void;
-    /**
-     * Test hooks for browser globals.
-     */
-    reload?: () => void;
-    storage?: Pick<Storage, "getItem" | "setItem" | "removeItem"> | null;
-    location?: Pick<Location, "pathname" | "search" | "reload">;
-    now?: () => number;
-}
-declare function isChunkLoadError(errorLike: unknown): boolean;
-declare function installChunkErrorRecovery(options?: FarmChunkRecoveryOptions): () => void;
-
-export { type FarmChunkRecoveryOptions as F, isChunkLoadError as a, installChunkErrorRecovery as i };

package/dist/chunk-recovery.d-lnQFzcQP.d.ts

@@ -1,26 +0,0 @@
-interface FarmChunkRecoveryOptions {
-    /**
-     * How long a page is considered already recovered before another chunk
-     * failure may trigger a reload. Defaults to 30 seconds.
-     */
-    maxAgeMs?: number;
-    /**
-     * Override the storage key. Mostly useful for tests and embedded runtimes.
-     */
-    storageKey?: string;
-    /**
-     * Called right before Farm reloads the page.
-     */
-    onRecover?: (error: unknown) => void;
-    /**
-     * Test hooks for browser globals.
-     */
-    reload?: () => void;
-    storage?: Pick<Storage, "getItem" | "setItem" | "removeItem"> | null;
-    location?: Pick<Location, "pathname" | "search" | "reload">;
-    now?: () => number;
-}
-declare function isChunkLoadError(errorLike: unknown): boolean;
-declare function installChunkErrorRecovery(options?: FarmChunkRecoveryOptions): () => void;
-
-export { type FarmChunkRecoveryOptions as F, isChunkLoadError as a, installChunkErrorRecovery as i };

package/dist/client/lifecycle.d.mts

@@ -1 +0,0 @@
-export { h as FarmClientNavigationAction, i as FarmClientNavigationErrorEvent, j as FarmClientNavigationEvent, k as FarmClientNavigationLoadedEvent, l as FarmClientNavigationResolvedEvent, m as FarmClientNavigationSession, a as FarmClientPlugin, o as FarmClientPluginCloseEvent, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, y as defineClient } from '../lifecycle.d-C2aLBOwu.mjs';

package/dist/client/lifecycle.d.ts

@@ -1 +0,0 @@
-export { h as FarmClientNavigationAction, i as FarmClientNavigationErrorEvent, j as FarmClientNavigationEvent, k as FarmClientNavigationLoadedEvent, l as FarmClientNavigationResolvedEvent, m as FarmClientNavigationSession, a as FarmClientPlugin, o as FarmClientPluginCloseEvent, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, y as defineClient } from '../lifecycle.d-C2aLBOwu.js';

package/dist/client-cache.d-Deoqq-nM.d.ts

@@ -1,76 +0,0 @@
-import { RouteDataCacheKey } from './cache.js';
-
-type FarmClientCacheKey = RouteDataCacheKey;
-type FarmClientCacheStatus = "idle" | "pending" | "success" | "error";
-type FarmClientCacheEntry<TData = unknown> = {
-    data: TData;
-    updatedAt: number;
-    staleAt: number;
-    gcAt?: number;
-    invalidatedAt?: number;
-    status?: FarmClientCacheStatus;
-    error?: Error | null;
-    fetching?: boolean;
-    /** Marks an entry the persistence layer may write to its adapter. */
-    persist?: boolean;
-};
-/** @internal Observation seam for the client cache persistence engine. */
-type FarmClientCachePersistenceSink = {
-    onSet(key: string, entry: FarmClientCacheEntry): void;
-    onDelete(key: string): void;
-    onClear(): void;
-};
-type FarmClientCacheListener = (event?: "invalidate") => void;
-declare class FarmClientDataCache {
-    private entries;
-    private aliases;
-    private aliasesByTarget;
-    private invalidatedAt;
-    private listeners;
-    private inflight;
-    private pendingMetadataSweeps;
-    private unsubscribeInvalidation;
-    private gcTimer;
-    private readonly gcSweepIntervalMs;
-    private persistence;
-    constructor(options?: {
-        subscribeToInvalidation?: boolean;
-        gcSweepIntervalMs?: number | false;
-    });
-    private static subscribeWeakCache;
-    get size(): number;
-    /** @internal Attach or detach the persistence engine's observation sink. */
-    attachPersistence(sink: FarmClientCachePersistenceSink | undefined): void;
-    resolveKey(key: string): string;
-    get<TData = unknown>(key: string, now?: number): FarmClientCacheEntry<TData> | undefined;
-    set<TData>(key: string, entry: FarmClientCacheEntry<TData>): this;
-    delete(key: string): boolean;
-    clear(): void;
-    dispose(): void;
-    isStale(key: string, now?: number): boolean;
-    invalidate(key: string, now?: number): void;
-    private applyInvalidation;
-    private hasMetadataOwner;
-    alias(alias: string, key: string): void;
-    subscribe(key: string, listener: FarmClientCacheListener): () => void;
-    getInflight<TData>(key: string): Promise<TData> | undefined;
-    setInflight<TData>(key: string, promise: Promise<TData>): void;
-    deleteInflight(key: string): void;
-    private scheduleGcSweep;
-    private sweepExpiredEntries;
-    /**
-     * Entry eviction alone leaves the per-key metadata behind. `invalidatedAt`
-     * marks and provisional aliases are created per query invocation, so with
-     * dynamic keys they accumulate for the lifetime of the page even though the
-     * entries they describe are long gone.
-     */
-    private sweepEntryMetadata;
-    private removeAlias;
-    private sweepPendingEntryMetadata;
-    private emit;
-    private notifyListeners;
-}
-declare function getFarmClientDataCache(): FarmClientDataCache;
-declare function normalizeFarmClientCacheKey(key: FarmClientCacheKey): string;
-
-export { type FarmClientCacheStatus as F, type FarmClientCacheEntry as a, type FarmClientCacheKey as b, getFarmClientDataCache as g, normalizeFarmClientCacheKey as n };

package/dist/client-cache.d-di_Nasxa.d.mts

@@ -1,76 +0,0 @@
-import { RouteDataCacheKey } from './cache.mjs';
-
-type FarmClientCacheKey = RouteDataCacheKey;
-type FarmClientCacheStatus = "idle" | "pending" | "success" | "error";
-type FarmClientCacheEntry<TData = unknown> = {
-    data: TData;
-    updatedAt: number;
-    staleAt: number;
-    gcAt?: number;
-    invalidatedAt?: number;
-    status?: FarmClientCacheStatus;
-    error?: Error | null;
-    fetching?: boolean;
-    /** Marks an entry the persistence layer may write to its adapter. */
-    persist?: boolean;
-};
-/** @internal Observation seam for the client cache persistence engine. */
-type FarmClientCachePersistenceSink = {
-    onSet(key: string, entry: FarmClientCacheEntry): void;
-    onDelete(key: string): void;
-    onClear(): void;
-};
-type FarmClientCacheListener = (event?: "invalidate") => void;
-declare class FarmClientDataCache {
-    private entries;
-    private aliases;
-    private aliasesByTarget;
-    private invalidatedAt;
-    private listeners;
-    private inflight;
-    private pendingMetadataSweeps;
-    private unsubscribeInvalidation;
-    private gcTimer;
-    private readonly gcSweepIntervalMs;
-    private persistence;
-    constructor(options?: {
-        subscribeToInvalidation?: boolean;
-        gcSweepIntervalMs?: number | false;
-    });
-    private static subscribeWeakCache;
-    get size(): number;
-    /** @internal Attach or detach the persistence engine's observation sink. */
-    attachPersistence(sink: FarmClientCachePersistenceSink | undefined): void;
-    resolveKey(key: string): string;
-    get<TData = unknown>(key: string, now?: number): FarmClientCacheEntry<TData> | undefined;
-    set<TData>(key: string, entry: FarmClientCacheEntry<TData>): this;
-    delete(key: string): boolean;
-    clear(): void;
-    dispose(): void;
-    isStale(key: string, now?: number): boolean;
-    invalidate(key: string, now?: number): void;
-    private applyInvalidation;
-    private hasMetadataOwner;
-    alias(alias: string, key: string): void;
-    subscribe(key: string, listener: FarmClientCacheListener): () => void;
-    getInflight<TData>(key: string): Promise<TData> | undefined;
-    setInflight<TData>(key: string, promise: Promise<TData>): void;
-    deleteInflight(key: string): void;
-    private scheduleGcSweep;
-    private sweepExpiredEntries;
-    /**
-     * Entry eviction alone leaves the per-key metadata behind. `invalidatedAt`
-     * marks and provisional aliases are created per query invocation, so with
-     * dynamic keys they accumulate for the lifetime of the page even though the
-     * entries they describe are long gone.
-     */
-    private sweepEntryMetadata;
-    private removeAlias;
-    private sweepPendingEntryMetadata;
-    private emit;
-    private notifyListeners;
-}
-declare function getFarmClientDataCache(): FarmClientDataCache;
-declare function normalizeFarmClientCacheKey(key: FarmClientCacheKey): string;
-
-export { type FarmClientCacheStatus as F, type FarmClientCacheEntry as a, type FarmClientCacheKey as b, getFarmClientDataCache as g, normalizeFarmClientCacheKey as n };