@farm.js/core 0.1.61 → 0.1.62

package/dist/after.cjs

@@ -3,11 +3,11 @@
 
 
 
-var _chunkMQ3H6LT5cjs = require('./chunk-MQ3H6LT5.cjs');
-require('./chunk-S3JO3N4H.cjs');
+var _chunkP2355C6Ecjs = require('./chunk-P2355C6E.cjs');
+require('./chunk-BTZ5O6VM.cjs');
 
 
 
 
 
-exports._runWithAfterNodeResponse = _chunkMQ3H6LT5cjs._runWithAfterNodeResponse; exports._runWithAfterRequest = _chunkMQ3H6LT5cjs._runWithAfterRequest; exports._withAfterNodeMiddleware = _chunkMQ3H6LT5cjs._withAfterNodeMiddleware; exports.after = _chunkMQ3H6LT5cjs.after;
+exports._runWithAfterNodeResponse = _chunkP2355C6Ecjs._runWithAfterNodeResponse; exports._runWithAfterRequest = _chunkP2355C6Ecjs._runWithAfterRequest; exports._withAfterNodeMiddleware = _chunkP2355C6Ecjs._withAfterNodeMiddleware; exports.after = _chunkP2355C6Ecjs.after;

package/dist/after.d.mts

@@ -0,0 +1,25 @@
+import { ServerResponse, IncomingMessage } from 'node:http';
+
+type AfterCallback = () => void | Promise<void>;
+/** Runtime hooks supplied by a deployment adapter. */
+interface FarmAfterPlatformContext {
+    /** Keep a serverless invocation alive until the scheduled work settles. */
+    waitUntil?: (promise: Promise<void>) => void;
+    /** Register a callback that runs once the response has finished. */
+    onResponseFinished?: (callback: () => void) => void;
+}
+/**
+ * Schedule non-blocking work for after the current response finishes.
+ *
+ * Callbacks run in registration order. A callback failure is reported without
+ * changing the response or preventing later callbacks from running.
+ */
+declare function after(callback: AfterCallback): void;
+/** @internal Run a Web Request handler inside Farm's post-response lifecycle. */
+declare function _runWithAfterRequest(request: Request, handler: () => Response | Promise<Response>, context?: FarmAfterPlatformContext): Promise<Response>;
+/** @internal Run a Node response handler inside Farm's post-response lifecycle. */
+declare function _runWithAfterNodeResponse<T>(response: ServerResponse, handler: () => T | Promise<T>, context?: Pick<FarmAfterPlatformContext, "waitUntil">): Promise<T>;
+/** @internal Add Farm's post-response lifecycle to a Node middleware. */
+declare function _withAfterNodeMiddleware(handler: (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => void | Promise<void>): (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => Promise<void>;
+
+export { type AfterCallback, type FarmAfterPlatformContext, _runWithAfterNodeResponse, _runWithAfterRequest, _withAfterNodeMiddleware, after };

package/dist/after.d.ts

@@ -0,0 +1,25 @@
+import { ServerResponse, IncomingMessage } from 'node:http';
+
+type AfterCallback = () => void | Promise<void>;
+/** Runtime hooks supplied by a deployment adapter. */
+interface FarmAfterPlatformContext {
+    /** Keep a serverless invocation alive until the scheduled work settles. */
+    waitUntil?: (promise: Promise<void>) => void;
+    /** Register a callback that runs once the response has finished. */
+    onResponseFinished?: (callback: () => void) => void;
+}
+/**
+ * Schedule non-blocking work for after the current response finishes.
+ *
+ * Callbacks run in registration order. A callback failure is reported without
+ * changing the response or preventing later callbacks from running.
+ */
+declare function after(callback: AfterCallback): void;
+/** @internal Run a Web Request handler inside Farm's post-response lifecycle. */
+declare function _runWithAfterRequest(request: Request, handler: () => Response | Promise<Response>, context?: FarmAfterPlatformContext): Promise<Response>;
+/** @internal Run a Node response handler inside Farm's post-response lifecycle. */
+declare function _runWithAfterNodeResponse<T>(response: ServerResponse, handler: () => T | Promise<T>, context?: Pick<FarmAfterPlatformContext, "waitUntil">): Promise<T>;
+/** @internal Add Farm's post-response lifecycle to a Node middleware. */
+declare function _withAfterNodeMiddleware(handler: (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => void | Promise<void>): (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => Promise<void>;
+
+export { type AfterCallback, type FarmAfterPlatformContext, _runWithAfterNodeResponse, _runWithAfterRequest, _withAfterNodeMiddleware, after };

package/dist/after.mjs

@@ -3,8 +3,8 @@ import {
   _runWithAfterRequest,
   _withAfterNodeMiddleware,
   after
-} from "./chunk-IOEH4VWN.mjs";
-import "./chunk-LPEX4YW6.mjs";
+} from "./chunk-IYEY3JWJ.mjs";
+import "./chunk-Y6FXYEAI.mjs";
 export {
   _runWithAfterNodeResponse,
   _runWithAfterRequest,

package/dist/agent-mcp-handler-7QMX2LUY.mjs

@@ -0,0 +1,18 @@
+import {
+  handleFarmDefaultMCPRequest
+} from "./chunk-ZZ2QKCKW.mjs";
+import "./chunk-UZZ6IEQP.mjs";
+import "./chunk-KVW2M6PI.mjs";
+import "./chunk-YSXTNSXS.mjs";
+import "./chunk-C7GJDVN4.mjs";
+import "./chunk-2DA7CLY7.mjs";
+import "./chunk-2I6PUKWJ.mjs";
+import "./chunk-GUZC226X.mjs";
+import "./chunk-W6QLRQ3V.mjs";
+import "./chunk-LM55GS4R.mjs";
+import "./chunk-SF3JB56B.mjs";
+import "./chunk-AYP2YFVN.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  handleFarmDefaultMCPRequest
+};

package/dist/agent-mcp-handler-OV4WRFBL.cjs

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk6BJJYOFLcjs = require('./chunk-6BJJYOFL.cjs');
+require('./chunk-QAS7KE7J.cjs');
+require('./chunk-MEQN6DDA.cjs');
+require('./chunk-LT4VAF5Z.cjs');
+require('./chunk-LRB5OVRT.cjs');
+require('./chunk-EVIWKPJV.cjs');
+require('./chunk-2OF5RPVU.cjs');
+require('./chunk-CA7DNRHO.cjs');
+require('./chunk-PMJSG4JS.cjs');
+require('./chunk-A25FXJ7D.cjs');
+require('./chunk-D22BUQKW.cjs');
+require('./chunk-YTVSWXEZ.cjs');
+require('./chunk-BTZ5O6VM.cjs');
+
+
+exports.handleFarmDefaultMCPRequest = _chunk6BJJYOFLcjs.handleFarmDefaultMCPRequest;

package/dist/agent-mcp.d-BKZ3UNbt.d.mts

@@ -0,0 +1,115 @@
+import { M as Metadata, bp as FarmAgentJsonLd, bq as FarmMCPServerRegistration, br as FarmMarkdownResolvedConfig } from './client-plugins.d-CWyYBxXf.mjs';
+
+type MetadataImageKind = "opengraph" | "twitter";
+interface FarmMetadataImageReference {
+    kind: MetadataImageKind;
+    href: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+    contentType?: string;
+}
+interface RenderedMetadataHead {
+    title: string;
+    tags: string;
+    hasFavicon: boolean;
+    /** False when the title is the framework fallback rather than configured. */
+    hasExplicitTitle: boolean;
+    /** The viewport tag, then any theme-color and color-scheme tags. */
+    viewport: string;
+}
+type MetadataRecord = Metadata & Record<string, any>;
+/**
+ * Metadata for the not-found page, shared by the development renderer and the production
+ * server: the layouts' metadata (so a title template, description or icons carry over),
+ * then the not-found module's own `metadata` and `generateMetadata()`, titled
+ * FARM_NOT_FOUND_TITLE when the module doesn't name itself.
+ */
+declare function resolveFarmNotFoundMetadata(layoutModules: ReadonlyArray<Record<string, any> | null | undefined>, notFoundModule: Record<string, any> | null | undefined): Promise<MetadataRecord>;
+declare function mergeMetadata(base: MetadataRecord | undefined, next: MetadataRecord | undefined): MetadataRecord;
+/**
+ * Merge a layout's or page's `viewport` export and `generateViewport()` result onto the metadata
+ * collected so far, as Next.js does: each module overrides the keys it sets.
+ */
+declare function mergeModuleViewport(metadata: MetadataRecord, module: Record<string, any> | null | undefined, props: unknown): Promise<MetadataRecord>;
+/**
+ * The viewport tag Next.js renders: the default `width=device-width, initial-scale=1` with the
+ * merged `viewport` exports over it, plus `theme-color` and `color-scheme` tags when set. The tags
+ * carry FARM_METADATA_ATTRIBUTE, so client navigation replaces them but never a viewport tag the
+ * app wrote into its own document.
+ */
+declare function renderViewportHead(viewport: unknown): string;
+declare function addMetadataImageReference(metadata: MetadataRecord, reference: FarmMetadataImageReference): MetadataRecord;
+/**
+ * Advertise a page's Markdown mirror as `alternates.types["text/markdown"]`
+ * unless the page already declares one. `href` comes from the request path, so
+ * it is kept same-origin the same way the default canonical is.
+ */
+declare function addMetadataMarkdownAlternate(metadata: MetadataRecord, href: string | null | undefined): MetadataRecord;
+interface RenderMetadataHeadOptions {
+    /**
+     * Current request pathname. Used to emit a default `<link rel="canonical">`
+     * when the route does not set one, so agents and crawlers can resolve the
+     * page's identity. Combined with `metadataBase` into an absolute URL when a
+     * base is configured; otherwise emitted as a self-referential path.
+     */
+    pathname?: string;
+    /**
+     * Agent JSON-LD config. When truthy, a schema.org JSON-LD script is emitted in
+     * the head, built from this config and the page/site metadata. `true` uses the
+     * defaults; `false`/omitted (the default) emits nothing.
+     */
+    jsonLd?: FarmAgentJsonLd | boolean;
+}
+declare function renderMetadataHead(metadata: MetadataRecord | undefined, options?: RenderMetadataHeadOptions): RenderedMetadataHead;
+/**
+ * Resolve a metadata title into displayable text. Exported so client-side
+ * navigation resolves the object form the same way SSR does instead of
+ * stringifying it into "[object Object]".
+ */
+declare function resolveMetadataTitle(title: Metadata["title"]): string | undefined;
+
+interface FarmDefaultMCPPage {
+    /** The page's route path, such as `/about`. */
+    path: string;
+    title: string;
+    /** The page's absolute URL. */
+    url: string;
+    description?: string;
+    /** The absolute URL of the page's Markdown mirror, which `read_page` reads. */
+    markdownUrl: string;
+}
+interface FarmDefaultMCPPageSource {
+    pattern: string;
+    /** The page module, for its `metadata` and whether a route `guard` gates it. */
+    module?: unknown;
+}
+/**
+ * The pages the default server lists and reads: static pages with a Markdown mirror,
+ * leaving out pages whose metadata says noindex and pages behind a route `guard`, as the
+ * generated sitemap does.
+ */
+declare function collectFarmDefaultMCPPages(sources: Iterable<FarmDefaultMCPPageSource>, options: {
+    origin: string;
+    basePath?: string;
+    markdown?: FarmMarkdownResolvedConfig;
+}): FarmDefaultMCPPage[];
+/**
+ * The default server's identity, from the app's package.json when it has one. The AI
+ * catalog namespaces a plain name by the request's host, as it does for every server.
+ */
+declare function createFarmDefaultMCPServer(app: {
+    name?: unknown;
+    version?: unknown;
+} | undefined, farmVersion: string): FarmMCPServerRegistration & {
+    path: `/${string}`;
+};
+/**
+ * The default server, or undefined once any other MCP server is published or registered:
+ * `@farm.js/mcp` publishes its catalog and the docs engine registers its endpoint when the
+ * server starts. Serving and listing both ask here, so the AI catalog never names a server
+ * that does not answer.
+ */
+declare function resolveFarmDefaultMCPServer<T>(server: T | undefined | null): T | undefined;
+
+export { type FarmDefaultMCPPage as F, type MetadataImageKind as M, addMetadataImageReference as a, addMetadataMarkdownAlternate as b, createFarmDefaultMCPServer as c, collectFarmDefaultMCPPages as d, mergeModuleViewport as e, renderViewportHead as f, resolveFarmDefaultMCPServer as g, resolveFarmNotFoundMetadata as h, resolveMetadataTitle as i, mergeMetadata as m, renderMetadataHead as r };

package/dist/agent-mcp.d-C1zr_nGS.d.ts

@@ -0,0 +1,115 @@
+import { M as Metadata, bp as FarmAgentJsonLd, bq as FarmMCPServerRegistration, br as FarmMarkdownResolvedConfig } from './client-plugins.d-BcqIy4au.js';
+
+type MetadataImageKind = "opengraph" | "twitter";
+interface FarmMetadataImageReference {
+    kind: MetadataImageKind;
+    href: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+    contentType?: string;
+}
+interface RenderedMetadataHead {
+    title: string;
+    tags: string;
+    hasFavicon: boolean;
+    /** False when the title is the framework fallback rather than configured. */
+    hasExplicitTitle: boolean;
+    /** The viewport tag, then any theme-color and color-scheme tags. */
+    viewport: string;
+}
+type MetadataRecord = Metadata & Record<string, any>;
+/**
+ * Metadata for the not-found page, shared by the development renderer and the production
+ * server: the layouts' metadata (so a title template, description or icons carry over),
+ * then the not-found module's own `metadata` and `generateMetadata()`, titled
+ * FARM_NOT_FOUND_TITLE when the module doesn't name itself.
+ */
+declare function resolveFarmNotFoundMetadata(layoutModules: ReadonlyArray<Record<string, any> | null | undefined>, notFoundModule: Record<string, any> | null | undefined): Promise<MetadataRecord>;
+declare function mergeMetadata(base: MetadataRecord | undefined, next: MetadataRecord | undefined): MetadataRecord;
+/**
+ * Merge a layout's or page's `viewport` export and `generateViewport()` result onto the metadata
+ * collected so far, as Next.js does: each module overrides the keys it sets.
+ */
+declare function mergeModuleViewport(metadata: MetadataRecord, module: Record<string, any> | null | undefined, props: unknown): Promise<MetadataRecord>;
+/**
+ * The viewport tag Next.js renders: the default `width=device-width, initial-scale=1` with the
+ * merged `viewport` exports over it, plus `theme-color` and `color-scheme` tags when set. The tags
+ * carry FARM_METADATA_ATTRIBUTE, so client navigation replaces them but never a viewport tag the
+ * app wrote into its own document.
+ */
+declare function renderViewportHead(viewport: unknown): string;
+declare function addMetadataImageReference(metadata: MetadataRecord, reference: FarmMetadataImageReference): MetadataRecord;
+/**
+ * Advertise a page's Markdown mirror as `alternates.types["text/markdown"]`
+ * unless the page already declares one. `href` comes from the request path, so
+ * it is kept same-origin the same way the default canonical is.
+ */
+declare function addMetadataMarkdownAlternate(metadata: MetadataRecord, href: string | null | undefined): MetadataRecord;
+interface RenderMetadataHeadOptions {
+    /**
+     * Current request pathname. Used to emit a default `<link rel="canonical">`
+     * when the route does not set one, so agents and crawlers can resolve the
+     * page's identity. Combined with `metadataBase` into an absolute URL when a
+     * base is configured; otherwise emitted as a self-referential path.
+     */
+    pathname?: string;
+    /**
+     * Agent JSON-LD config. When truthy, a schema.org JSON-LD script is emitted in
+     * the head, built from this config and the page/site metadata. `true` uses the
+     * defaults; `false`/omitted (the default) emits nothing.
+     */
+    jsonLd?: FarmAgentJsonLd | boolean;
+}
+declare function renderMetadataHead(metadata: MetadataRecord | undefined, options?: RenderMetadataHeadOptions): RenderedMetadataHead;
+/**
+ * Resolve a metadata title into displayable text. Exported so client-side
+ * navigation resolves the object form the same way SSR does instead of
+ * stringifying it into "[object Object]".
+ */
+declare function resolveMetadataTitle(title: Metadata["title"]): string | undefined;
+
+interface FarmDefaultMCPPage {
+    /** The page's route path, such as `/about`. */
+    path: string;
+    title: string;
+    /** The page's absolute URL. */
+    url: string;
+    description?: string;
+    /** The absolute URL of the page's Markdown mirror, which `read_page` reads. */
+    markdownUrl: string;
+}
+interface FarmDefaultMCPPageSource {
+    pattern: string;
+    /** The page module, for its `metadata` and whether a route `guard` gates it. */
+    module?: unknown;
+}
+/**
+ * The pages the default server lists and reads: static pages with a Markdown mirror,
+ * leaving out pages whose metadata says noindex and pages behind a route `guard`, as the
+ * generated sitemap does.
+ */
+declare function collectFarmDefaultMCPPages(sources: Iterable<FarmDefaultMCPPageSource>, options: {
+    origin: string;
+    basePath?: string;
+    markdown?: FarmMarkdownResolvedConfig;
+}): FarmDefaultMCPPage[];
+/**
+ * The default server's identity, from the app's package.json when it has one. The AI
+ * catalog namespaces a plain name by the request's host, as it does for every server.
+ */
+declare function createFarmDefaultMCPServer(app: {
+    name?: unknown;
+    version?: unknown;
+} | undefined, farmVersion: string): FarmMCPServerRegistration & {
+    path: `/${string}`;
+};
+/**
+ * The default server, or undefined once any other MCP server is published or registered:
+ * `@farm.js/mcp` publishes its catalog and the docs engine registers its endpoint when the
+ * server starts. Serving and listing both ask here, so the AI catalog never names a server
+ * that does not answer.
+ */
+declare function resolveFarmDefaultMCPServer<T>(server: T | undefined | null): T | undefined;
+
+export { type FarmDefaultMCPPage as F, type MetadataImageKind as M, addMetadataImageReference as a, addMetadataMarkdownAlternate as b, createFarmDefaultMCPServer as c, collectFarmDefaultMCPPages as d, mergeModuleViewport as e, renderViewportHead as f, resolveFarmDefaultMCPServer as g, resolveFarmNotFoundMetadata as h, resolveMetadataTitle as i, mergeMetadata as m, renderMetadataHead as r };