@farm.js/core 0.1.60 → 0.1.61

package/dist/observability.d-B2363jB6.d.ts

@@ -1,448 +0,0 @@
-import { Attributes, SpanKind } from '@opentelemetry/api';
-
-/**
- * Recognizes AI agents and crawlers by the token they put in User-Agent.
- *
- * These are declarations, not proof of identity: any client can send them. Use
- * the result to understand traffic and tailor responses, never to grant access.
- */
-interface FarmAgentIdentity {
-    family: "unknown" | "openai" | "anthropic" | "google" | "microsoft" | "perplexity" | "other";
-    /** `crawler` indexes or trains; `agent` fetches on a person's request. */
-    category: "unknown" | "crawler" | "agent" | "harness";
-    identity: "unknown" | "self-reported";
-}
-/** Classifies a User-Agent header value. Ambiguous or unknown values are `unknown`. */
-declare function classifyFarmAgent(userAgent: string | null | undefined): FarmAgentIdentity;
-
-type FarmTraceSpanKind = "request" | "render" | "middleware" | "api" | "integration" | "storage" | "ppr" | "build" | "plugin";
-interface FarmTracingConfig {
-    /** Enable Farm's OpenTelemetry spans. */
-    enabled?: boolean;
-    /** Span families to record. All families are enabled by default. */
-    spans?: readonly FarmTraceSpanKind[];
-    /** Add Farm lifecycle events to the active span. Defaults to true. */
-    recordEvents?: boolean;
-    /** Static attributes added to every Farm-created span. */
-    attributes?: Attributes;
-    /** Path prefixes that should not create request spans. */
-    ignorePaths?: readonly string[];
-}
-type FarmTracingUserConfig = boolean | FarmTracingConfig;
-interface FarmResolvedTracingConfig {
-    enabled: boolean;
-    spans: ReadonlySet<FarmTraceSpanKind>;
-    recordEvents: boolean;
-    attributes: Attributes;
-    ignorePaths: readonly string[];
-}
-interface FarmTraceContext {
-    traceId: string;
-    spanId: string;
-    traceSampled: boolean;
-}
-interface FarmRequestSpanOptions {
-    getStatusCode?: () => number | undefined;
-    onStart?: () => void;
-    onComplete?: (status: number, durationMs: number) => void;
-    onError?: (error: unknown, durationMs: number) => void;
-}
-interface FarmSpanOptions {
-    kind?: FarmTraceSpanKind;
-    attributes?: Attributes;
-    spanKind?: SpanKind;
-}
-declare function normalizeFarmTracingConfig(config: FarmTracingUserConfig | undefined): FarmResolvedTracingConfig;
-declare function configureFarmTracing(config: FarmTracingUserConfig | FarmResolvedTracingConfig | undefined): void;
-declare function getFarmTraceContext(): FarmTraceContext | undefined;
-declare function runWithFarmSpan<T>(name: string, handler: () => T | Promise<T>, options?: FarmSpanOptions): Promise<T>;
-
-type FarmEventLevel = "debug" | "info" | "warn" | "error";
-interface FarmEventBase {
-    type: string;
-    timestamp: number;
-    level: FarmEventLevel;
-    requestId?: string;
-    traceId?: string;
-    spanId?: string;
-    traceSampled?: boolean;
-    route?: string;
-    pathname?: string;
-}
-type FarmRequestEvent = (FarmEventBase & {
-    type: "request.start";
-    method: string;
-    pathname: string;
-}) | (FarmEventBase & {
-    type: "request.complete";
-    method: string;
-    pathname: string;
-    status: number;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "request.error";
-    method: string;
-    pathname: string;
-    durationMs: number;
-    error: unknown;
-});
-type FarmServerEvent = (FarmEventBase & {
-    type: "server.start";
-    mode: "dev" | "preview" | "production";
-    port?: number;
-}) | (FarmEventBase & {
-    type: "server.ready";
-    url?: string;
-}) | (FarmEventBase & {
-    type: "server.shutdown";
-    reason?: string;
-});
-type FarmRouteEvent = (FarmEventBase & {
-    type: "route.discovered";
-    route: string;
-    filePath: string;
-}) | (FarmEventBase & {
-    type: "route.matched";
-    pathname: string;
-    route: string;
-    params?: Record<string, string>;
-}) | (FarmEventBase & {
-    type: "route.notFound";
-    pathname: string;
-}) | (FarmEventBase & {
-    type: "route.redirect";
-    from: string;
-    to: string;
-    status?: number;
-}) | (FarmEventBase & {
-    type: "route.rewrite";
-    from: string;
-    to: string;
-});
-type FarmRenderEvent = (FarmEventBase & {
-    type: "render.start";
-    route: string;
-    pathname?: string;
-}) | (FarmEventBase & {
-    type: "render.complete";
-    route: string;
-    durationMs: number;
-    status?: number;
-}) | (FarmEventBase & {
-    type: "render.error";
-    route?: string;
-    error: unknown;
-}) | (FarmEventBase & {
-    type: "render.stream.start";
-    route: string;
-}) | (FarmEventBase & {
-    type: "render.stream.shellReady";
-    route: string;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "render.stream.complete";
-    route: string;
-    durationMs: number;
-});
-type FarmCacheEvent = (FarmEventBase & {
-    type: "cache.hit";
-    key: string;
-    route?: string;
-    tags?: readonly string[];
-    revalidate?: number | false;
-    stale?: boolean;
-}) | (FarmEventBase & {
-    type: "cache.miss";
-    key: string;
-    route?: string;
-    reason?: string;
-}) | (FarmEventBase & {
-    type: "cache.set";
-    key: string;
-    route?: string;
-    tags?: readonly string[];
-    revalidate?: number | false;
-}) | (FarmEventBase & {
-    type: "cache.dedupe";
-    key: string;
-}) | (FarmEventBase & {
-    type: "cache.bypass";
-    key?: string;
-    route?: string;
-    reason: string;
-}) | (FarmEventBase & {
-    type: "cache.stale";
-    key: string;
-    route?: string;
-    tags?: readonly string[];
-    revalidate?: number | false;
-}) | (FarmEventBase & {
-    type: "cache.revalidatePath";
-    path: string;
-    count: number;
-}) | (FarmEventBase & {
-    type: "cache.revalidateTag";
-    tag: string;
-    profile?: unknown;
-    count: number;
-}) | (FarmEventBase & {
-    type: "cache.updateTag";
-    tag: string;
-    count: number;
-}) | (FarmEventBase & {
-    type: "cache.invalidated";
-    key?: string;
-    route?: string;
-    tag?: string;
-    reason?: string;
-    count?: number;
-}) | (FarmEventBase & {
-    type: "cache.delete";
-    key: string;
-    deleted: boolean;
-}) | (FarmEventBase & {
-    type: "cache.clear";
-    count: number;
-}) | (FarmEventBase & {
-    type: "cache.error";
-    key?: string;
-    operation: "get" | "set" | "delete" | "revalidate";
-    error: unknown;
-});
-type FarmPPREvent = (FarmEventBase & {
-    type: "ppr.shell.hit";
-    route: string;
-    key: string;
-}) | (FarmEventBase & {
-    type: "ppr.shell.miss";
-    route: string;
-    key: string;
-}) | (FarmEventBase & {
-    type: "ppr.shell.cached";
-    route: string;
-    key: string;
-    revalidate?: number;
-}) | (FarmEventBase & {
-    type: "ppr.shell.bypass";
-    route: string;
-    reason: string;
-}) | (FarmEventBase & {
-    type: "ppr.shell.invalidated";
-    route: string;
-    reason?: string;
-    count?: number;
-}) | (FarmEventBase & {
-    type: "ppr.suspense.holeDetected";
-    route: string;
-}) | (FarmEventBase & {
-    type: "ppr.refresh.start";
-    route: string;
-}) | (FarmEventBase & {
-    type: "ppr.refresh.complete";
-    route: string;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "ppr.refresh.error";
-    route: string;
-    error: unknown;
-});
-type FarmAPIEvent = (FarmEventBase & {
-    type: "api.request.start";
-    route: string;
-    method: string;
-}) | (FarmEventBase & {
-    type: "api.request.complete";
-    route: string;
-    method: string;
-    status: number;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "api.validation.failed";
-    route: string;
-    method: string;
-    issues?: unknown;
-}) | (FarmEventBase & {
-    type: "api.error";
-    route: string;
-    method: string;
-    durationMs: number;
-    error: unknown;
-});
-type FarmIntegrationEvent = (FarmEventBase & {
-    type: "integration.registered";
-    name: string;
-}) | (FarmEventBase & {
-    type: "integration.config.validated";
-    name: string;
-}) | (FarmEventBase & {
-    type: "integration.ready";
-    name: string;
-}) | (FarmEventBase & {
-    type: "integration.disposed";
-    name: string;
-}) | (FarmEventBase & {
-    type: "integration.api.call.start";
-    integration: string;
-    operation: string;
-}) | (FarmEventBase & {
-    type: "integration.api.call.complete";
-    integration: string;
-    operation: string;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "integration.api.call.error";
-    integration: string;
-    operation: string;
-    error: unknown;
-}) | (FarmEventBase & {
-    type: "integration.webhook.received";
-    integration: string;
-    event?: string;
-}) | (FarmEventBase & {
-    type: "integration.webhook.verified";
-    integration: string;
-    event?: string;
-}) | (FarmEventBase & {
-    type: "integration.webhook.failed";
-    integration: string;
-    reason: string;
-});
-/** A registered MCP tool callback completed; not an HTTP response or an agent run. */
-type FarmMCPEvent = FarmEventBase & {
-    type: "mcp.tool.complete";
-    /** Configured transport path, never a raw request URL. */
-    route: string;
-    server: string;
-    tool: string;
-    outcome: "success" | "error";
-    durationMs: number;
-};
-/**
- * An agent surface answered a request: a Markdown mirror or `page.md`, llms.txt,
- * llms-full.txt, the API catalog, the AI catalog (`ai-catalog.json` or `ard.json`),
- * or an MCP server card. `agent` is what the User-Agent declares,
- * not a verified identity.
- */
-type FarmAgentEvent = FarmEventBase & {
-    type: "agent.read";
-    surface: "markdown" | "llms" | "llms-full" | "api-catalog" | "ai-catalog" | "mcp-server-card";
-    /** The path served, such as `/pricing.md`; never the query string. */
-    route: string;
-    /** For Markdown, the partial view asked for. */
-    view?: "outline" | "section" | "parts" | "actions";
-    status: number;
-    agent: FarmAgentIdentity;
-};
-type FarmMiddlewareEvent = (FarmEventBase & {
-    type: "middleware.start";
-    route?: string;
-    name?: string;
-}) | (FarmEventBase & {
-    type: "middleware.complete";
-    route?: string;
-    name?: string;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "middleware.shortCircuit";
-    route?: string;
-    name?: string;
-    status?: number;
-}) | (FarmEventBase & {
-    type: "middleware.error";
-    route?: string;
-    name?: string;
-    error: unknown;
-});
-type FarmStorageEvent = (FarmEventBase & {
-    type: "storage.query.start";
-    integration?: string;
-    operation: string;
-}) | (FarmEventBase & {
-    type: "storage.query.complete";
-    integration?: string;
-    operation: string;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "storage.query.error";
-    integration?: string;
-    operation: string;
-    error: unknown;
-}) | (FarmEventBase & {
-    type: "storage.schema.ready";
-    integration?: string;
-}) | (FarmEventBase & {
-    type: "storage.schema.error";
-    integration?: string;
-    error: unknown;
-});
-type FarmBuildEvent = (FarmEventBase & {
-    type: "build.start";
-    target?: string;
-}) | (FarmEventBase & {
-    type: "build.complete";
-    target?: string;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "build.error";
-    target?: string;
-    error: unknown;
-}) | (FarmEventBase & {
-    type: "routes.generated";
-    pageCount: number;
-    apiCount?: number;
-}) | (FarmEventBase & {
-    type: "types.generated";
-    filePath: string;
-}) | (FarmEventBase & {
-    type: "manifest.generated";
-    routeCount: number;
-});
-type FarmPluginEvent = (FarmEventBase & {
-    type: "plugin.hook.start";
-    plugin: string;
-    hook: string;
-}) | (FarmEventBase & {
-    type: "plugin.hook.complete";
-    plugin: string;
-    hook: string;
-    durationMs: number;
-}) | (FarmEventBase & {
-    type: "plugin.hook.error";
-    plugin: string;
-    hook: string;
-    error: unknown;
-});
-type FarmErrorEvent = FarmEventBase & {
-    type: "error";
-    source: string;
-    error: unknown;
-    route?: string;
-};
-type FarmEvent = FarmRequestEvent | FarmServerEvent | FarmRouteEvent | FarmRenderEvent | FarmCacheEvent | FarmPPREvent | FarmAPIEvent | FarmIntegrationEvent | FarmMCPEvent | FarmAgentEvent | FarmMiddlewareEvent | FarmStorageEvent | FarmBuildEvent | FarmPluginEvent | FarmErrorEvent;
-type FarmEventType = FarmEvent["type"];
-type FarmEventHandler = (event: FarmEvent) => void | Promise<void>;
-type FarmEventInput = FarmEvent extends infer T ? T extends FarmEvent ? Omit<T, "timestamp" | "level"> & Partial<Pick<T, "timestamp" | "level">> : never : never;
-type FarmObservabilityUserConfig = boolean | {
-    logs?: boolean;
-    onEvent?: FarmEventHandler | readonly FarmEventHandler[];
-    events?: readonly FarmEventType[];
-    tracing?: FarmTracingUserConfig;
-};
-interface FarmResolvedObservabilityConfig {
-    logs: boolean;
-    handlers: FarmEventHandler[];
-    events?: Set<FarmEventType>;
-    tracing: FarmResolvedTracingConfig;
-}
-interface FarmEventSubscriptionOptions {
-    /** Receive events even when they are excluded by `observability.events`. */
-    unfiltered?: boolean;
-}
-declare function configureFarmObservability(config: FarmObservabilityUserConfig | undefined): void;
-declare function normalizeFarmObservabilityConfig(config: FarmObservabilityUserConfig | undefined): FarmResolvedObservabilityConfig;
-declare function onFarmEvent(handler: FarmEventHandler, options?: FarmEventSubscriptionOptions): () => void;
-declare function resetFarmObservability(): void;
-declare function emitFarmEvent(input: FarmEventInput): FarmEvent;
-declare function runWithFarmRequestSpan<T>(request: Request, handler: () => T | Promise<T>, options?: FarmRequestSpanOptions): Promise<T>;
-
-export { type FarmStorageEvent as A, type FarmTraceContext as B, type FarmTraceSpanKind as C, type FarmTracingConfig as D, type FarmTracingUserConfig as E, type FarmAPIEvent as F, classifyFarmAgent as G, configureFarmObservability as H, configureFarmTracing as I, emitFarmEvent as J, getFarmTraceContext as K, normalizeFarmObservabilityConfig as L, normalizeFarmTracingConfig as M, onFarmEvent as N, resetFarmObservability as O, runWithFarmRequestSpan as P, runWithFarmSpan as Q, type FarmAgentEvent as a, type FarmAgentIdentity as b, type FarmBuildEvent as c, type FarmCacheEvent as d, type FarmErrorEvent as e, type FarmEvent as f, type FarmEventBase as g, type FarmEventHandler as h, type FarmEventInput as i, type FarmEventLevel as j, type FarmEventSubscriptionOptions as k, type FarmEventType as l, type FarmIntegrationEvent as m, type FarmMCPEvent as n, type FarmMiddlewareEvent as o, type FarmObservabilityUserConfig as p, type FarmPPREvent as q, type FarmPluginEvent as r, type FarmRenderEvent as s, type FarmRequestEvent as t, type FarmRequestSpanOptions as u, type FarmResolvedObservabilityConfig as v, type FarmResolvedTracingConfig as w, type FarmRouteEvent as x, type FarmServerEvent as y, type FarmSpanOptions as z };

package/dist/observability.d.mts

@@ -1,2 +0,0 @@
-export { F as FarmAPIEvent, a as FarmAgentEvent, c as FarmBuildEvent, d as FarmCacheEvent, e as FarmErrorEvent, f as FarmEvent, g as FarmEventBase, h as FarmEventHandler, i as FarmEventInput, j as FarmEventLevel, k as FarmEventSubscriptionOptions, l as FarmEventType, m as FarmIntegrationEvent, n as FarmMCPEvent, o as FarmMiddlewareEvent, p as FarmObservabilityUserConfig, q as FarmPPREvent, r as FarmPluginEvent, s as FarmRenderEvent, t as FarmRequestEvent, u as FarmRequestSpanOptions, v as FarmResolvedObservabilityConfig, w as FarmResolvedTracingConfig, x as FarmRouteEvent, y as FarmServerEvent, z as FarmSpanOptions, A as FarmStorageEvent, B as FarmTraceContext, C as FarmTraceSpanKind, D as FarmTracingConfig, E as FarmTracingUserConfig, H as configureFarmObservability, I as configureFarmTracing, J as emitFarmEvent, K as getFarmTraceContext, L as normalizeFarmObservabilityConfig, M as normalizeFarmTracingConfig, N as onFarmEvent, O as resetFarmObservability, P as runWithFarmRequestSpan, Q as runWithFarmSpan } from './observability.d-B2363jB6.mjs';
-import '@opentelemetry/api';

package/dist/observability.d.ts

@@ -1,2 +0,0 @@
-export { F as FarmAPIEvent, a as FarmAgentEvent, c as FarmBuildEvent, d as FarmCacheEvent, e as FarmErrorEvent, f as FarmEvent, g as FarmEventBase, h as FarmEventHandler, i as FarmEventInput, j as FarmEventLevel, k as FarmEventSubscriptionOptions, l as FarmEventType, m as FarmIntegrationEvent, n as FarmMCPEvent, o as FarmMiddlewareEvent, p as FarmObservabilityUserConfig, q as FarmPPREvent, r as FarmPluginEvent, s as FarmRenderEvent, t as FarmRequestEvent, u as FarmRequestSpanOptions, v as FarmResolvedObservabilityConfig, w as FarmResolvedTracingConfig, x as FarmRouteEvent, y as FarmServerEvent, z as FarmSpanOptions, A as FarmStorageEvent, B as FarmTraceContext, C as FarmTraceSpanKind, D as FarmTracingConfig, E as FarmTracingUserConfig, H as configureFarmObservability, I as configureFarmTracing, J as emitFarmEvent, K as getFarmTraceContext, L as normalizeFarmObservabilityConfig, M as normalizeFarmTracingConfig, N as onFarmEvent, O as resetFarmObservability, P as runWithFarmRequestSpan, Q as runWithFarmSpan } from './observability.d-B2363jB6.js';
-import '@opentelemetry/api';

package/dist/og.d.mts

@@ -1 +0,0 @@
-export { ImageResponse, ImageResponseOptions } from '@vercel/og';

package/dist/og.d.ts

@@ -1 +0,0 @@
-export { ImageResponse, ImageResponseOptions } from '@vercel/og';

package/dist/params.d-BALtrRim.d.ts

@@ -1,15 +0,0 @@
-import { Parser } from './query/parsers.js';
-
-type RouteParamsInput = Record<string, string | undefined> | URLSearchParams | Promise<Record<string, string | undefined> | URLSearchParams>;
-declare function loadRouteParams<T extends Record<string, Parser<any>>>(input: RouteParamsInput, parsers: T, options?: {
-    strict?: boolean;
-}): Promise<{
-    [K in keyof T]: ReturnType<T[K]["parse"]>;
-}>;
-declare function parseRouteParams<T extends Record<string, Parser<any>>>(input: Record<string, string | undefined> | URLSearchParams, parsers: T, options?: {
-    strict?: boolean;
-}): {
-    [K in keyof T]: ReturnType<T[K]["parse"]>;
-};
-
-export { type RouteParamsInput as R, loadRouteParams as l, parseRouteParams as p };

package/dist/params.d-ry-lxqmy.d.mts

@@ -1,15 +0,0 @@
-import { Parser } from './query/parsers.mjs';
-
-type RouteParamsInput = Record<string, string | undefined> | URLSearchParams | Promise<Record<string, string | undefined> | URLSearchParams>;
-declare function loadRouteParams<T extends Record<string, Parser<any>>>(input: RouteParamsInput, parsers: T, options?: {
-    strict?: boolean;
-}): Promise<{
-    [K in keyof T]: ReturnType<T[K]["parse"]>;
-}>;
-declare function parseRouteParams<T extends Record<string, Parser<any>>>(input: Record<string, string | undefined> | URLSearchParams, parsers: T, options?: {
-    strict?: boolean;
-}): {
-    [K in keyof T]: ReturnType<T[K]["parse"]>;
-};
-
-export { type RouteParamsInput as R, loadRouteParams as l, parseRouteParams as p };

package/dist/platform.cjs

@@ -1,29 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(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 = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }require('./chunk-BTZ5O6VM.cjs');
-
-// src/platform.ts
-var _fs = require('fs');
-var PLATFORM_ENV = "FARM_PLATFORM";
-var DESKTOP_DATA_DIR_ENV = "FARM_DESKTOP_DATA_DIR";
-var DATA_DIR_ENV = "FARM_DATA_DIR";
-function readEnv(name) {
-  const value = _optionalChain([globalThis, 'access', _ => _.process, 'optionalAccess', _2 => _2.env, 'optionalAccess', _3 => _3[name]]);
-  return typeof value === "string" && value ? value : void 0;
-}
-function platform() {
-  const value = readEnv(PLATFORM_ENV);
-  return value === "desktop" || value === "mobile" ? value : "web";
-}
-function appDataDir() {
-  const dir = platform() === "desktop" ? readEnv(DESKTOP_DATA_DIR_ENV) : readEnv(DATA_DIR_ENV);
-  if (!dir) {
-    throw new Error(
-      platform() === "desktop" ? "[Farm] appDataDir(): the desktop shell did not pass a data directory. Start the app with `farm dev --desktop` or from its packaged build." : '[Farm] appDataDir() has no directory on the web. Set FARM_DATA_DIR to a writable directory, or check platform() === "desktop" first.'
-    );
-  }
-  _fs.mkdirSync.call(void 0, dir, { recursive: true });
-  return dir;
-}
-
-
-
-exports.appDataDir = appDataDir; exports.platform = platform;

package/dist/platform.d.mts

@@ -1,24 +0,0 @@
-/**
- * Where this code runs: `"desktop"` in `farm dev --desktop` and `farm build --desktop`,
- * `"mobile"` under `FARM_PLATFORM=mobile` (the mobile shell's client build), otherwise `"web"`.
- *
- * In browser code the build replaces this module with one that returns a literal, so
- * `platform() === "desktop"` branches fold away in the client bundle. A mobile app's pages
- * render on its web deployment, whose server reports `"web"`.
- */
-type FarmPlatform = "web" | "desktop" | "mobile";
-declare function platform(): FarmPlatform;
-/**
- * A directory the app may write to, created on first use.
- *
- * | Mode                 | Directory                                         |
- * | -------------------- | ------------------------------------------------- |
- * | desktop build        | the OS user data directory the shell passes in    |
- * | `farm dev --desktop` | `.farm/data/desktop`                              |
- * | web                  | `FARM_DATA_DIR`, otherwise this throws            |
- *
- * Server only. A desktop app's bundle is read-only and signed, so never write next to the code.
- */
-declare function appDataDir(): string;
-
-export { type FarmPlatform, appDataDir, platform };

package/dist/platform.d.ts

@@ -1,24 +0,0 @@
-/**
- * Where this code runs: `"desktop"` in `farm dev --desktop` and `farm build --desktop`,
- * `"mobile"` under `FARM_PLATFORM=mobile` (the mobile shell's client build), otherwise `"web"`.
- *
- * In browser code the build replaces this module with one that returns a literal, so
- * `platform() === "desktop"` branches fold away in the client bundle. A mobile app's pages
- * render on its web deployment, whose server reports `"web"`.
- */
-type FarmPlatform = "web" | "desktop" | "mobile";
-declare function platform(): FarmPlatform;
-/**
- * A directory the app may write to, created on first use.
- *
- * | Mode                 | Directory                                         |
- * | -------------------- | ------------------------------------------------- |
- * | desktop build        | the OS user data directory the shell passes in    |
- * | `farm dev --desktop` | `.farm/data/desktop`                              |
- * | web                  | `FARM_DATA_DIR`, otherwise this throws            |
- *
- * Server only. A desktop app's bundle is read-only and signed, so never write next to the code.
- */
-declare function appDataDir(): string;
-
-export { type FarmPlatform, appDataDir, platform };

package/dist/platform.mjs

@@ -1,29 +0,0 @@
-import "./chunk-Y6FXYEAI.mjs";
-
-// src/platform.ts
-import { mkdirSync } from "fs";
-var PLATFORM_ENV = "FARM_PLATFORM";
-var DESKTOP_DATA_DIR_ENV = "FARM_DESKTOP_DATA_DIR";
-var DATA_DIR_ENV = "FARM_DATA_DIR";
-function readEnv(name) {
-  const value = globalThis.process?.env?.[name];
-  return typeof value === "string" && value ? value : void 0;
-}
-function platform() {
-  const value = readEnv(PLATFORM_ENV);
-  return value === "desktop" || value === "mobile" ? value : "web";
-}
-function appDataDir() {
-  const dir = platform() === "desktop" ? readEnv(DESKTOP_DATA_DIR_ENV) : readEnv(DATA_DIR_ENV);
-  if (!dir) {
-    throw new Error(
-      platform() === "desktop" ? "[Farm] appDataDir(): the desktop shell did not pass a data directory. Start the app with `farm dev --desktop` or from its packaged build." : '[Farm] appDataDir() has no directory on the web. Set FARM_DATA_DIR to a writable directory, or check platform() === "desktop" first.'
-    );
-  }
-  mkdirSync(dir, { recursive: true });
-  return dir;
-}
-export {
-  appDataDir,
-  platform
-};

package/dist/plugin-53SY5YBS.mjs

@@ -1,32 +0,0 @@
-import {
-  FARM_NODE_RESPONSE_END_PENDING,
-  FarmRuntimeShutdownError,
-  PluginManager,
-  definePlugin
-} from "./chunk-GHNW564E.mjs";
-import "./chunk-2DLGV2ZG.mjs";
-import "./chunk-F3N52U7S.mjs";
-import "./chunk-UUMKLGUU.mjs";
-import "./chunk-XR2ZIBQK.mjs";
-import {
-  resolveFarmDevtoolsConfig
-} from "./chunk-CU5SYTJG.mjs";
-import "./chunk-N33DLJBC.mjs";
-import "./chunk-WXFY5JIY.mjs";
-import "./chunk-H4WUWLQR.mjs";
-import {
-  FarmDevEnvironmentError,
-  loadFarmDevModule
-} from "./chunk-TUOO6IK3.mjs";
-import "./chunk-D2LCAV6L.mjs";
-import "./chunk-SF3JB56B.mjs";
-import "./chunk-Y6FXYEAI.mjs";
-export {
-  FARM_NODE_RESPONSE_END_PENDING,
-  FarmDevEnvironmentError,
-  FarmRuntimeShutdownError,
-  PluginManager,
-  definePlugin,
-  loadFarmDevModule,
-  resolveFarmDevtoolsConfig
-};

package/dist/plugin-HZIBL3DW.cjs

@@ -1,32 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-var _chunk3EEET2Q5cjs = require('./chunk-3EEET2Q5.cjs');
-require('./chunk-SYW346ZN.cjs');
-require('./chunk-GBMWLDCC.cjs');
-require('./chunk-47JV57DA.cjs');
-require('./chunk-LSHX2H5G.cjs');
-
-
-var _chunkSTF6VDYQcjs = require('./chunk-STF6VDYQ.cjs');
-require('./chunk-3EIPOTZV.cjs');
-require('./chunk-2KMIJDY6.cjs');
-require('./chunk-DUIP64BF.cjs');
-
-
-
-var _chunkJYNNIGQOcjs = require('./chunk-JYNNIGQO.cjs');
-require('./chunk-JYT7AN37.cjs');
-require('./chunk-D22BUQKW.cjs');
-require('./chunk-BTZ5O6VM.cjs');
-
-
-
-
-
-
-
-
-exports.FARM_NODE_RESPONSE_END_PENDING = _chunk3EEET2Q5cjs.FARM_NODE_RESPONSE_END_PENDING; exports.FarmDevEnvironmentError = _chunkJYNNIGQOcjs.FarmDevEnvironmentError; exports.FarmRuntimeShutdownError = _chunk3EEET2Q5cjs.FarmRuntimeShutdownError; exports.PluginManager = _chunk3EEET2Q5cjs.PluginManager; exports.definePlugin = _chunk3EEET2Q5cjs.definePlugin; exports.loadFarmDevModule = _chunkJYNNIGQOcjs.loadFarmDevModule; exports.resolveFarmDevtoolsConfig = _chunkSTF6VDYQcjs.resolveFarmDevtoolsConfig;