@farm.js/core 0.1.15 → 0.1.16

package/dist/docs.cjs

@@ -4640,6 +4640,7 @@ var import_node_path6 = require("path");
 
 // src/env.ts
 var FARM_ENV_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env");
+var FARM_ENV_RUNTIME_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env.runtime");
 var farmEnvGlobal = globalThis;
 var currentEnv = getInitialEnv();
 var env = createEnvProxy("server");
@@ -4653,7 +4654,7 @@ function createEnvProxy(scope) {
           return void 0;
         }
         const env2 = getEnvScope(scope);
-        return env2[property];
+        return scope === "server" ? readServerEnvKey(env2, property) : env2[property];
       },
       ownKeys() {
         return Reflect.ownKeys(getEnvScope(scope));
@@ -4677,12 +4678,75 @@ function createEnvProxy(scope) {
 }
 __name(createEnvProxy, "createEnvProxy");
 function getEnvScope(scope) {
+  const env2 = getCurrentEnv();
   if (scope === "server") {
     assertServerEnvAccess();
+    readRuntimeServerEnv(env2);
   }
-  return getCurrentEnv()[scope] || {};
+  return env2[scope] || {};
 }
 __name(getEnvScope, "getEnvScope");
+function readServerEnvKey(server, key) {
+  const value = server[key];
+  if (value === void 0) {
+    const state = getCurrentEnv()[FARM_ENV_RUNTIME_SYMBOL];
+    if (state && key in state.pending && !state.warned.has(key)) {
+      state.warned.add(key);
+      console.warn(
+        `[Farm] Server env "${key}" was set when this app was built but is not set where the server runs, so it reads as undefined. Farm reads server env at runtime and does not store it in the build output; set "${key}" in the server's environment.`
+      );
+    }
+  }
+  return value;
+}
+__name(readServerEnvKey, "readServerEnvKey");
+function readRuntimeServerEnv(env2) {
+  const state = env2[FARM_ENV_RUNTIME_SYMBOL];
+  if (!state) return;
+  const source = getProcessEnv();
+  for (const [key, type] of Object.entries(state.pending)) {
+    const raw = source[key];
+    if (raw === void 0) continue;
+    env2.server[key] = coerceRuntimeEnvValue(raw, type);
+    delete state.pending[key];
+  }
+}
+__name(readRuntimeServerEnv, "readRuntimeServerEnv");
+function coerceRuntimeEnvValue(raw, type) {
+  if (type === "number") {
+    const value = Number(raw);
+    return raw.trim() !== "" && Number.isFinite(value) ? value : raw;
+  }
+  if (type === "boolean") {
+    if (/^(true|1)$/i.test(raw.trim())) return true;
+    if (/^(false|0|)$/i.test(raw.trim())) return false;
+    return raw;
+  }
+  if (type === "json") {
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+  return raw;
+}
+__name(coerceRuntimeEnvValue, "coerceRuntimeEnvValue");
+function prepareEnv(env2) {
+  const normalized = normalizeResolvedEnv(env2);
+  const runtime = env2.runtime?.server;
+  if (!isRecord(runtime) || Object.keys(runtime).length === 0) return normalized;
+  const prepared = { server: { ...normalized.server }, public: normalized.public };
+  Object.defineProperty(prepared, FARM_ENV_RUNTIME_SYMBOL, {
+    value: {
+      pending: { ...runtime },
+      warned: /* @__PURE__ */ new Set()
+    },
+    enumerable: false
+  });
+  return prepared;
+}
+__name(prepareEnv, "prepareEnv");
 function assertServerEnvAccess() {
   if (typeof window !== "undefined") {
     throw new Error("Farm server env is not available in the browser. Use publicEnv.");
@@ -4713,7 +4777,7 @@ __name(getCurrentEnv, "getCurrentEnv");
 function getInjectedEnv() {
   try {
     if (typeof __FARM_ENV__ !== "undefined" && __FARM_ENV__) {
-      return normalizeResolvedEnv(__FARM_ENV__);
+      return prepareEnv(__FARM_ENV__);
     }
   } catch {
   }
@@ -4741,6 +4805,13 @@ function isRecord(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 __name(isRecord, "isRecord");
+function getProcessEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env;
+  }
+  return {};
+}
+__name(getProcessEnv, "getProcessEnv");
 
 // src/app-markdown-config.ts
 var import_node_path7 = __toESM(require("path"));

package/dist/docs.mjs

@@ -4,7 +4,7 @@ import {
   createFarmDocsAdapterHandler,
   hasFarmDocsRuntimeAdapter,
   isFarmDocsAPIRequest
-} from "./chunk-NJ47VORC.mjs";
+} from "./chunk-NUD6XBMO.mjs";
 import {
   createFarmDocsHandler,
   discoverFarmDocsPages,
@@ -16,7 +16,7 @@ import {
 } from "./chunk-MOQNHLTS.mjs";
 import "./chunk-UP4CW6WP.mjs";
 import "./chunk-TFQG7TBC.mjs";
-import "./chunk-GNTPTTLA.mjs";
+import "./chunk-IXTEENRS.mjs";
 import "./chunk-XZNTNMHT.mjs";
 import "./chunk-TVGP4BBZ.mjs";
 import "./chunk-FZC7EEPM.mjs";
@@ -28,7 +28,7 @@ import "./chunk-Q3MDL7TM.mjs";
 import "./chunk-G2KY33I6.mjs";
 import "./chunk-4L7SZOHZ.mjs";
 import "./chunk-QCFFHV5H.mjs";
-import "./chunk-FOGLGRDS.mjs";
+import "./chunk-7HDZYYS4.mjs";
 import "./chunk-FA2W42OV.mjs";
 import "./chunk-6SCB2MXB.mjs";
 import "./chunk-MUUZJLCI.mjs";

package/dist/{route-C6UClI1z.d.mts → endpoint-Bu3XgeMK.d.mts}

@@ -129,7 +129,7 @@ type MaybePromise<T> = T | Promise<T>;
 type Simplify<T> = {
     [TKey in keyof T]: T[TKey];
 } & {};
-type UnionToIntersection$1<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
+type UnionToIntersection<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
 type InferOutput<T> = RouteSchemaOutput<T>;
 type InferInput<T> = T extends {
     _input: infer I;
@@ -222,7 +222,7 @@ type ValidateEndpointMiddlewares<TMiddlewares extends readonly AnyEndpointMiddle
 };
 type ContextFromMiddlewareResult<TResult> = Exclude<TResult, Response | boolean> extends infer TContext ? [TContext] extends [never] ? {} : TContext extends object ? TContext : {} : {};
 type ContextFromMiddleware<TMiddleware> = TMiddleware extends (...args: any[]) => infer TResult ? ContextFromMiddlewareResult<Awaited<TResult>> : {};
-type InferEndpointMiddlewareContext<TMiddlewares extends readonly ((...args: any[]) => any)[], TContext extends object = {}> = TMiddlewares extends readonly [infer TMiddleware, ...infer TRest] ? TMiddleware extends (...args: any[]) => any ? TRest extends readonly ((...args: any[]) => any)[] ? InferEndpointMiddlewareContext<TRest, Simplify<TContext & ContextFromMiddleware<TMiddleware>>> : Simplify<TContext> : Simplify<TContext> : number extends TMiddlewares["length"] ? Simplify<TContext & UnionToIntersection$1<ContextFromMiddleware<TMiddlewares[number]>>> : Simplify<TContext>;
+type InferEndpointMiddlewareContext<TMiddlewares extends readonly ((...args: any[]) => any)[], TContext extends object = {}> = TMiddlewares extends readonly [infer TMiddleware, ...infer TRest] ? TMiddleware extends (...args: any[]) => any ? TRest extends readonly ((...args: any[]) => any)[] ? InferEndpointMiddlewareContext<TRest, Simplify<TContext & ContextFromMiddleware<TMiddleware>>> : Simplify<TContext> : Simplify<TContext> : number extends TMiddlewares["length"] ? Simplify<TContext & UnionToIntersection<ContextFromMiddleware<TMiddlewares[number]>>> : Simplify<TContext>;
 type EndpointOptions<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TMiddlewares extends readonly AnyEndpointMiddleware[] = readonly [], TErrors extends EndpointErrorDefinitions = {}> = {
     method?: "GET" | "HEAD" | "QUERY" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS";
     body?: TBody;
@@ -364,129 +364,4 @@ declare function OPTIONS<T = any>(handler: EndpointHandler<never, never, never,
 declare function OPTIONS<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
 declare function OPTIONS<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
 
-type RouteMethod = "GET" | "HEAD" | "QUERY" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
-type RoutePathParams<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? RoutePathParams<Head> & RoutePathParams<Tail> : Path extends `[[...${infer Name}]]` ? {
-    [K in Name]?: string[];
-} : Path extends `[...${infer Name}]` ? {
-    [K in Name]: string[];
-} : Path extends `[${infer Name}]` ? {
-    [K in Name]: string;
-} : {};
-interface RouteInputSchemas {
-    body?: RouteSchema;
-    query?: RouteSchema;
-    params?: RouteSchema;
-    headers?: RouteSchema;
-}
-type Input<I, K extends PropertyKey> = K extends keyof I ? RouteSchemaInput<I[K]> : never;
-type Output<I, K extends PropertyKey, Fallback = unknown> = K extends keyof I ? RouteSchemaOutput<I[K]> : Fallback;
-/** JSON responses have wire types, not server-side instances such as Date. */
-type RouteJSON<T> = T extends Response ? unknown : T extends {
-    toJSON(): infer J;
-} ? RouteJSON<J> : T extends bigint | symbol | ((...args: any[]) => any) ? never : T extends readonly (infer V)[] ? RouteJSON<V>[] : T extends object ? {
-    [K in keyof T]: RouteJSON<T[K]>;
-} : T;
-type RouteDefinition<P extends string = string, M extends RouteMethod = RouteMethod, E = any> = {
-    readonly path: P;
-    readonly method: M;
-    readonly endpoint: E;
-};
-type RouteEndpoint<P extends string, I extends RouteInputSchemas, R> = TypedEndpoint<Output<I, "body">, Input<I, "query">, RouteJSON<R>, Input<I, "headers">, never, Input<I, "body">> & {
-    __types: {
-        params: RoutePathParams<P>;
-        inputHeaders: Input<I, "headers">;
-    };
-};
-type TrimStart<P extends string> = P extends `/${infer Rest}` ? TrimStart<Rest> : P;
-type Join<P extends string, C extends string> = C extends "" ? P : `${P}/${TrimStart<C>}`;
-type ParamsCheck<P extends string, I extends RouteInputSchemas> = I extends {
-    params: infer S;
-} ? Exclude<keyof RoutePathParams<P>, keyof RouteSchemaOutput<S>> extends never ? Exclude<keyof RouteSchemaOutput<S>, keyof RoutePathParams<P>> extends never ? unknown : {
-    __error_unknown_route_params: never;
-} : {
-    __error_missing_route_params: never;
-} : unknown;
-type RouteMiddlewareResults = readonly (EndpointMiddlewareResult | Promise<EndpointMiddlewareResult>)[];
-type RouteMiddlewares<Results extends readonly unknown[]> = {
-    readonly [K in keyof Results]: (context: Parameters<AnyEndpointMiddleware>[0]) => Results[K];
-};
-type RouteOptions<P extends string, I extends RouteInputSchemas, O extends RouteSchema | undefined, R, MiddlewareResults extends RouteMiddlewareResults = RouteMiddlewareResults> = {
-    input?: I & ParamsCheck<P, I>;
-    /** Validate plain JSON handler results. Raw Response/stream results are never buffered. */
-    output?: O;
-    /** Opt this app-owned endpoint into an installed MCP transport. */
-    mcp?: EndpointMCPOptions;
-    middleware?: RouteMiddlewares<MiddlewareResults>;
-    handler(request: Request, context: {
-        input: {
-            body: Output<I, "body">;
-            query: Output<I, "query", Record<string, string | string[]>>;
-            headers: Output<I, "headers", Record<string, string>>;
-            params: Output<I, "params", RoutePathParams<P>>;
-        };
-        params: Output<I, "params", RoutePathParams<P>>;
-        context: Readonly<InferEndpointMiddlewareContext<RouteMiddlewares<MiddlewareResults>>>;
-    }): R | Promise<R>;
-};
-type RouteBuilder<P extends string, M extends RouteMethod> = <const C extends string, const MiddlewareResults extends RouteMiddlewareResults, const I extends RouteInputSchemas = {}, O extends RouteSchema | undefined = undefined, R = unknown>(path: C, options: RouteOptions<Join<P, C>, I, O, R, MiddlewareResults>) => RouteDefinition<Join<P, C>, M, RouteEndpoint<Join<P, C>, I, Extract<Awaited<R>, Response> extends never ? O extends RouteSchema ? RouteSchemaOutput<O> : Awaited<R> : unknown>>;
-type RouteFactory<P extends string = ""> = {
-    [M in Lowercase<RouteMethod>]: RouteBuilder<P, Uppercase<M> & RouteMethod>;
-} & {
-    /** Return a new builder; never mutate the parent scope. */
-    scope<const C extends string>(path: C): RouteFactory<Join<P, C>>;
-};
-type PluginRoutes = readonly RouteDefinition[];
-interface PluginLocalAPIEndpoint {
-    readonly path: string;
-    readonly method: RouteMethod;
-    readonly input: Readonly<RouteInputSchemas>;
-    readonly output?: RouteSchema;
-    readonly mcp?: EndpointMCPOptions;
-    invoke(request: Request, params?: Readonly<Record<string, string | string[]>>): Promise<Response>;
-}
-/**
- * Read-only access to app-owned API endpoints while plugin routes are mounted.
- * Plugin routes are intentionally excluded so a plugin cannot recurse through
- * itself or depend on plugin registration order.
- */
-interface PluginLocalAPI {
-    /** False during type-only route discovery, where app endpoint modules are unavailable. */
-    readonly available: boolean;
-    get(method: RouteMethod, path: string): PluginLocalAPIEndpoint | undefined;
-    /** Enumerate app-owned endpoints. Plugin routes are excluded. */
-    list(): readonly PluginLocalAPIEndpoint[];
-}
-type PluginRoutesFactory<R extends PluginRoutes = PluginRoutes> = (context: {
-    route: RouteFactory;
-    api: PluginLocalAPI;
-}) => R;
-declare function createRouteFactory(): RouteFactory;
-type UnionToIntersection<U> = (U extends unknown ? (v: U) => void : never) extends (v: infer I) => void ? I : never;
-type RouteTree<P extends string, M extends string, E> = P extends `${infer Head}/${infer Tail}` ? {
-    [K in Head]: RouteTree<Tail, M, E>;
-} : P extends "" ? {
-    [K in Lowercase<M>]: E;
-} : {
-    [K in P]: {
-        [Method in Lowercase<M>]: E;
-    };
-};
-type HasMethodSegment<P extends string> = P extends `${infer H}/${infer T}` ? H extends Lowercase<RouteMethod> ? true : HasMethodSegment<T> : P extends Lowercase<RouteMethod> ? true : false;
-type DefinitionTree<D> = D extends RouteDefinition<infer P, infer M, infer E> ? string extends P ? {} : (P extends `/api/integrations${string}` ? true : HasMethodSegment<P>) extends true ? {
-    [K in P extends `/api/${infer C}` ? `/${C}` : "/"]: {
-        [Method in Lowercase<M>]: E;
-    };
-} : RouteTree<P extends `/api/${infer C}` ? C : "", M, E> : {};
-type PluginAPIRouter<C> = C extends {
-    plugins: readonly (infer P)[];
-} ? UnionToIntersection<P extends {
-    routes?: PluginRoutesFactory<infer R>;
-} ? DefinitionTree<R[number]> : {}> : {};
-declare function resolvePluginRoutes(plugins?: readonly {
-    name: string;
-    routes?: PluginRoutesFactory;
-}[], context?: {
-    api?: PluginLocalAPI;
-}): PluginRoutes;
-
-export { type RouteOptions as $, type AnyEndpointMiddleware as A, type TypedFormData as B, type MultipartSchema as C, DELETE as D, EndpointFailure as E, type FarmStreamResponse as F, GET as G, HEAD as H, type InferEndpointMiddlewareContext as I, type FarmAPIStream as J, multipart as K, isMultipartSchema as L, type MultipartField as M, toFormData as N, OPTIONS as O, type PluginRoutesFactory as P, QUERY as Q, jsonStream as R, isJSONStreamResponse as S, type TypedEndpoint as T, readJSONStream as U, isFarmAPIStream as V, type RouteMethod as W, type RoutePathParams as X, type RouteInputSchemas as Y, type RouteJSON as Z, type RouteDefinition as _, type EndpointOpenAPIMetadata as a, type RouteFactory as a0, type PluginRoutes as a1, type PluginLocalAPIEndpoint as a2, type PluginLocalAPI as a3, createRouteFactory as a4, type PluginAPIRouter as a5, resolvePluginRoutes as a6, type RouteSchema as a7, type RouteSchemaOutput as a8, type RouteSchemaInput as a9, type OpenAPISecurityMode as aa, type EndpointErrorSchema as b, type EndpointErrorDefinition as c, type EndpointErrorDefinitions as d, type EndpointErrorContracts as e, type EndpointErrorHandler as f, type EndpointFail as g, type EndpointParamValue as h, isEndpointFailure as i, type EndpointParams as j, type EndpointMiddlewareContext as k, type EndpointMiddlewareResult as l, type EndpointMiddleware as m, type EndpointInvalidationTarget as n, type EndpointInvalidationContext as o, parseRouteSchema as p, type EndpointInvalidations as q, type EndpointMCPMetadata as r, type EndpointMCPOptions as s, type EndpointOptions as t, type EndpointHandler as u, createEndpoint as v, POST as w, PUT as x, PATCH as y, type MultipartValues as z };
+export { type AnyEndpointMiddleware as A, type MultipartValues as B, type TypedFormData as C, DELETE as D, type EndpointMiddlewareResult as E, type MultipartSchema as F, GET as G, HEAD as H, type InferEndpointMiddlewareContext as I, type FarmStreamResponse as J, type FarmAPIStream as K, multipart as L, type MultipartField as M, isMultipartSchema as N, OPTIONS as O, POST as P, QUERY as Q, type RouteSchema as R, toFormData as S, type TypedEndpoint as T, jsonStream as U, isJSONStreamResponse as V, readJSONStream as W, isFarmAPIStream as X, type OpenAPISecurityMode as Y, type RouteSchemaOutput as a, type EndpointMCPOptions as b, type RouteSchemaInput as c, type EndpointMCPMetadata as d, EndpointFailure as e, type EndpointOpenAPIMetadata as f, type EndpointErrorSchema as g, type EndpointErrorDefinition as h, type EndpointErrorDefinitions as i, type EndpointErrorContracts as j, type EndpointErrorHandler as k, type EndpointFail as l, isEndpointFailure as m, type EndpointParamValue as n, type EndpointParams as o, parseRouteSchema as p, type EndpointMiddlewareContext as q, type EndpointMiddleware as r, type EndpointInvalidationTarget as s, type EndpointInvalidationContext as t, type EndpointInvalidations as u, type EndpointOptions as v, type EndpointHandler as w, createEndpoint as x, PUT as y, PATCH as z };

package/dist/{route-CHBaW55F.d.ts → endpoint-kSAxE52R.d.ts}

@@ -129,7 +129,7 @@ type MaybePromise<T> = T | Promise<T>;
 type Simplify<T> = {
     [TKey in keyof T]: T[TKey];
 } & {};
-type UnionToIntersection$1<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
+type UnionToIntersection<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
 type InferOutput<T> = RouteSchemaOutput<T>;
 type InferInput<T> = T extends {
     _input: infer I;
@@ -222,7 +222,7 @@ type ValidateEndpointMiddlewares<TMiddlewares extends readonly AnyEndpointMiddle
 };
 type ContextFromMiddlewareResult<TResult> = Exclude<TResult, Response | boolean> extends infer TContext ? [TContext] extends [never] ? {} : TContext extends object ? TContext : {} : {};
 type ContextFromMiddleware<TMiddleware> = TMiddleware extends (...args: any[]) => infer TResult ? ContextFromMiddlewareResult<Awaited<TResult>> : {};
-type InferEndpointMiddlewareContext<TMiddlewares extends readonly ((...args: any[]) => any)[], TContext extends object = {}> = TMiddlewares extends readonly [infer TMiddleware, ...infer TRest] ? TMiddleware extends (...args: any[]) => any ? TRest extends readonly ((...args: any[]) => any)[] ? InferEndpointMiddlewareContext<TRest, Simplify<TContext & ContextFromMiddleware<TMiddleware>>> : Simplify<TContext> : Simplify<TContext> : number extends TMiddlewares["length"] ? Simplify<TContext & UnionToIntersection$1<ContextFromMiddleware<TMiddlewares[number]>>> : Simplify<TContext>;
+type InferEndpointMiddlewareContext<TMiddlewares extends readonly ((...args: any[]) => any)[], TContext extends object = {}> = TMiddlewares extends readonly [infer TMiddleware, ...infer TRest] ? TMiddleware extends (...args: any[]) => any ? TRest extends readonly ((...args: any[]) => any)[] ? InferEndpointMiddlewareContext<TRest, Simplify<TContext & ContextFromMiddleware<TMiddleware>>> : Simplify<TContext> : Simplify<TContext> : number extends TMiddlewares["length"] ? Simplify<TContext & UnionToIntersection<ContextFromMiddleware<TMiddlewares[number]>>> : Simplify<TContext>;
 type EndpointOptions<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TMiddlewares extends readonly AnyEndpointMiddleware[] = readonly [], TErrors extends EndpointErrorDefinitions = {}> = {
     method?: "GET" | "HEAD" | "QUERY" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS";
     body?: TBody;
@@ -364,129 +364,4 @@ declare function OPTIONS<T = any>(handler: EndpointHandler<never, never, never,
 declare function OPTIONS<const TOptions extends MethodlessEndpointOptions, TResponse = any>(options: TOptions, handler: ValidatedEndpointHandlerFromOptions<TOptions, TResponse>): CreatedEndpointFromOptions<TOptions, TResponse>;
 declare function OPTIONS<TBody extends AnySchema = never, TQuery extends AnySchema = never, THeaders extends AnySchema = never, TResponse = any>(options: Omit<EndpointOptions<TBody, TQuery, THeaders, readonly []>, "method">, handler: EndpointHandler<TBody, TQuery, THeaders, TResponse>): CreatedEndpoint<TBody, TQuery, THeaders, TResponse>;
 
-type RouteMethod = "GET" | "HEAD" | "QUERY" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
-type RoutePathParams<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? RoutePathParams<Head> & RoutePathParams<Tail> : Path extends `[[...${infer Name}]]` ? {
-    [K in Name]?: string[];
-} : Path extends `[...${infer Name}]` ? {
-    [K in Name]: string[];
-} : Path extends `[${infer Name}]` ? {
-    [K in Name]: string;
-} : {};
-interface RouteInputSchemas {
-    body?: RouteSchema;
-    query?: RouteSchema;
-    params?: RouteSchema;
-    headers?: RouteSchema;
-}
-type Input<I, K extends PropertyKey> = K extends keyof I ? RouteSchemaInput<I[K]> : never;
-type Output<I, K extends PropertyKey, Fallback = unknown> = K extends keyof I ? RouteSchemaOutput<I[K]> : Fallback;
-/** JSON responses have wire types, not server-side instances such as Date. */
-type RouteJSON<T> = T extends Response ? unknown : T extends {
-    toJSON(): infer J;
-} ? RouteJSON<J> : T extends bigint | symbol | ((...args: any[]) => any) ? never : T extends readonly (infer V)[] ? RouteJSON<V>[] : T extends object ? {
-    [K in keyof T]: RouteJSON<T[K]>;
-} : T;
-type RouteDefinition<P extends string = string, M extends RouteMethod = RouteMethod, E = any> = {
-    readonly path: P;
-    readonly method: M;
-    readonly endpoint: E;
-};
-type RouteEndpoint<P extends string, I extends RouteInputSchemas, R> = TypedEndpoint<Output<I, "body">, Input<I, "query">, RouteJSON<R>, Input<I, "headers">, never, Input<I, "body">> & {
-    __types: {
-        params: RoutePathParams<P>;
-        inputHeaders: Input<I, "headers">;
-    };
-};
-type TrimStart<P extends string> = P extends `/${infer Rest}` ? TrimStart<Rest> : P;
-type Join<P extends string, C extends string> = C extends "" ? P : `${P}/${TrimStart<C>}`;
-type ParamsCheck<P extends string, I extends RouteInputSchemas> = I extends {
-    params: infer S;
-} ? Exclude<keyof RoutePathParams<P>, keyof RouteSchemaOutput<S>> extends never ? Exclude<keyof RouteSchemaOutput<S>, keyof RoutePathParams<P>> extends never ? unknown : {
-    __error_unknown_route_params: never;
-} : {
-    __error_missing_route_params: never;
-} : unknown;
-type RouteMiddlewareResults = readonly (EndpointMiddlewareResult | Promise<EndpointMiddlewareResult>)[];
-type RouteMiddlewares<Results extends readonly unknown[]> = {
-    readonly [K in keyof Results]: (context: Parameters<AnyEndpointMiddleware>[0]) => Results[K];
-};
-type RouteOptions<P extends string, I extends RouteInputSchemas, O extends RouteSchema | undefined, R, MiddlewareResults extends RouteMiddlewareResults = RouteMiddlewareResults> = {
-    input?: I & ParamsCheck<P, I>;
-    /** Validate plain JSON handler results. Raw Response/stream results are never buffered. */
-    output?: O;
-    /** Opt this app-owned endpoint into an installed MCP transport. */
-    mcp?: EndpointMCPOptions;
-    middleware?: RouteMiddlewares<MiddlewareResults>;
-    handler(request: Request, context: {
-        input: {
-            body: Output<I, "body">;
-            query: Output<I, "query", Record<string, string | string[]>>;
-            headers: Output<I, "headers", Record<string, string>>;
-            params: Output<I, "params", RoutePathParams<P>>;
-        };
-        params: Output<I, "params", RoutePathParams<P>>;
-        context: Readonly<InferEndpointMiddlewareContext<RouteMiddlewares<MiddlewareResults>>>;
-    }): R | Promise<R>;
-};
-type RouteBuilder<P extends string, M extends RouteMethod> = <const C extends string, const MiddlewareResults extends RouteMiddlewareResults, const I extends RouteInputSchemas = {}, O extends RouteSchema | undefined = undefined, R = unknown>(path: C, options: RouteOptions<Join<P, C>, I, O, R, MiddlewareResults>) => RouteDefinition<Join<P, C>, M, RouteEndpoint<Join<P, C>, I, Extract<Awaited<R>, Response> extends never ? O extends RouteSchema ? RouteSchemaOutput<O> : Awaited<R> : unknown>>;
-type RouteFactory<P extends string = ""> = {
-    [M in Lowercase<RouteMethod>]: RouteBuilder<P, Uppercase<M> & RouteMethod>;
-} & {
-    /** Return a new builder; never mutate the parent scope. */
-    scope<const C extends string>(path: C): RouteFactory<Join<P, C>>;
-};
-type PluginRoutes = readonly RouteDefinition[];
-interface PluginLocalAPIEndpoint {
-    readonly path: string;
-    readonly method: RouteMethod;
-    readonly input: Readonly<RouteInputSchemas>;
-    readonly output?: RouteSchema;
-    readonly mcp?: EndpointMCPOptions;
-    invoke(request: Request, params?: Readonly<Record<string, string | string[]>>): Promise<Response>;
-}
-/**
- * Read-only access to app-owned API endpoints while plugin routes are mounted.
- * Plugin routes are intentionally excluded so a plugin cannot recurse through
- * itself or depend on plugin registration order.
- */
-interface PluginLocalAPI {
-    /** False during type-only route discovery, where app endpoint modules are unavailable. */
-    readonly available: boolean;
-    get(method: RouteMethod, path: string): PluginLocalAPIEndpoint | undefined;
-    /** Enumerate app-owned endpoints. Plugin routes are excluded. */
-    list(): readonly PluginLocalAPIEndpoint[];
-}
-type PluginRoutesFactory<R extends PluginRoutes = PluginRoutes> = (context: {
-    route: RouteFactory;
-    api: PluginLocalAPI;
-}) => R;
-declare function createRouteFactory(): RouteFactory;
-type UnionToIntersection<U> = (U extends unknown ? (v: U) => void : never) extends (v: infer I) => void ? I : never;
-type RouteTree<P extends string, M extends string, E> = P extends `${infer Head}/${infer Tail}` ? {
-    [K in Head]: RouteTree<Tail, M, E>;
-} : P extends "" ? {
-    [K in Lowercase<M>]: E;
-} : {
-    [K in P]: {
-        [Method in Lowercase<M>]: E;
-    };
-};
-type HasMethodSegment<P extends string> = P extends `${infer H}/${infer T}` ? H extends Lowercase<RouteMethod> ? true : HasMethodSegment<T> : P extends Lowercase<RouteMethod> ? true : false;
-type DefinitionTree<D> = D extends RouteDefinition<infer P, infer M, infer E> ? string extends P ? {} : (P extends `/api/integrations${string}` ? true : HasMethodSegment<P>) extends true ? {
-    [K in P extends `/api/${infer C}` ? `/${C}` : "/"]: {
-        [Method in Lowercase<M>]: E;
-    };
-} : RouteTree<P extends `/api/${infer C}` ? C : "", M, E> : {};
-type PluginAPIRouter<C> = C extends {
-    plugins: readonly (infer P)[];
-} ? UnionToIntersection<P extends {
-    routes?: PluginRoutesFactory<infer R>;
-} ? DefinitionTree<R[number]> : {}> : {};
-declare function resolvePluginRoutes(plugins?: readonly {
-    name: string;
-    routes?: PluginRoutesFactory;
-}[], context?: {
-    api?: PluginLocalAPI;
-}): PluginRoutes;
-
-export { type RouteOptions as $, type AnyEndpointMiddleware as A, type TypedFormData as B, type MultipartSchema as C, DELETE as D, EndpointFailure as E, type FarmStreamResponse as F, GET as G, HEAD as H, type InferEndpointMiddlewareContext as I, type FarmAPIStream as J, multipart as K, isMultipartSchema as L, type MultipartField as M, toFormData as N, OPTIONS as O, type PluginRoutesFactory as P, QUERY as Q, jsonStream as R, isJSONStreamResponse as S, type TypedEndpoint as T, readJSONStream as U, isFarmAPIStream as V, type RouteMethod as W, type RoutePathParams as X, type RouteInputSchemas as Y, type RouteJSON as Z, type RouteDefinition as _, type EndpointOpenAPIMetadata as a, type RouteFactory as a0, type PluginRoutes as a1, type PluginLocalAPIEndpoint as a2, type PluginLocalAPI as a3, createRouteFactory as a4, type PluginAPIRouter as a5, resolvePluginRoutes as a6, type RouteSchema as a7, type RouteSchemaOutput as a8, type RouteSchemaInput as a9, type OpenAPISecurityMode as aa, type EndpointErrorSchema as b, type EndpointErrorDefinition as c, type EndpointErrorDefinitions as d, type EndpointErrorContracts as e, type EndpointErrorHandler as f, type EndpointFail as g, type EndpointParamValue as h, isEndpointFailure as i, type EndpointParams as j, type EndpointMiddlewareContext as k, type EndpointMiddlewareResult as l, type EndpointMiddleware as m, type EndpointInvalidationTarget as n, type EndpointInvalidationContext as o, parseRouteSchema as p, type EndpointInvalidations as q, type EndpointMCPMetadata as r, type EndpointMCPOptions as s, type EndpointOptions as t, type EndpointHandler as u, createEndpoint as v, POST as w, PUT as x, PATCH as y, type MultipartValues as z };
+export { type AnyEndpointMiddleware as A, type MultipartValues as B, type TypedFormData as C, DELETE as D, type EndpointMiddlewareResult as E, type MultipartSchema as F, GET as G, HEAD as H, type InferEndpointMiddlewareContext as I, type FarmStreamResponse as J, type FarmAPIStream as K, multipart as L, type MultipartField as M, isMultipartSchema as N, OPTIONS as O, POST as P, QUERY as Q, type RouteSchema as R, toFormData as S, type TypedEndpoint as T, jsonStream as U, isJSONStreamResponse as V, readJSONStream as W, isFarmAPIStream as X, type OpenAPISecurityMode as Y, type RouteSchemaOutput as a, type EndpointMCPOptions as b, type RouteSchemaInput as c, type EndpointMCPMetadata as d, EndpointFailure as e, type EndpointOpenAPIMetadata as f, type EndpointErrorSchema as g, type EndpointErrorDefinition as h, type EndpointErrorDefinitions as i, type EndpointErrorContracts as j, type EndpointErrorHandler as k, type EndpointFail as l, isEndpointFailure as m, type EndpointParamValue as n, type EndpointParams as o, parseRouteSchema as p, type EndpointMiddlewareContext as q, type EndpointMiddleware as r, type EndpointInvalidationTarget as s, type EndpointInvalidationContext as t, type EndpointInvalidations as u, type EndpointOptions as v, type EndpointHandler as w, createEndpoint as x, PUT as y, PATCH as z };

package/dist/env.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/env.ts
 var env_exports = {};
 __export(env_exports, {
+  createBundledEnv: () => createBundledEnv,
   env: () => env,
   getEnv: () => getEnv,
   getPublicEnv: () => getPublicEnv,
@@ -32,6 +33,7 @@ __export(env_exports, {
 });
 module.exports = __toCommonJS(env_exports);
 var FARM_ENV_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env");
+var FARM_ENV_RUNTIME_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env.runtime");
 var farmEnvGlobal = globalThis;
 var currentEnv = getInitialEnv();
 function resolveEnv(config, source = getProcessEnv()) {
@@ -42,23 +44,43 @@ function resolveEnv(config, source = getProcessEnv()) {
   return resolved;
 }
 __name(resolveEnv, "resolveEnv");
+function createBundledEnv(env2, source = getProcessEnv()) {
+  const resolved = normalizeResolvedEnv(env2 ?? {});
+  const server = {};
+  const runtime = {};
+  for (const [key, value] of Object.entries(resolved.server)) {
+    if (source[key] === void 0) {
+      server[key] = value;
+    } else {
+      runtime[key] = getRuntimeEnvType(value);
+    }
+  }
+  return {
+    server,
+    public: resolved.public,
+    ...Object.keys(runtime).length > 0 ? { runtime: { server: runtime } } : {}
+  };
+}
+__name(createBundledEnv, "createBundledEnv");
 function setEnv(env2) {
-  currentEnv = normalizeResolvedEnv(env2);
+  currentEnv = prepareEnv(env2);
   if (typeof window === "undefined") {
     farmEnvGlobal[FARM_ENV_SYMBOL] = currentEnv;
   }
 }
 __name(setEnv, "setEnv");
 function getResolvedEnv() {
-  return getCurrentEnv();
+  const env2 = getCurrentEnv();
+  if (typeof window === "undefined") readRuntimeServerEnv(env2);
+  return env2;
 }
 __name(getResolvedEnv, "getResolvedEnv");
 function getEnv(key) {
-  assertServerEnvAccess();
+  const server = getEnvScope("server");
   if (key === void 0) {
-    return getCurrentEnv().server;
+    return server;
   }
-  return getCurrentEnv().server[key];
+  return readServerEnvKey(server, key);
 }
 __name(getEnv, "getEnv");
 function getPublicEnv(key) {
@@ -106,7 +128,7 @@ function createEnvProxy(scope) {
           return void 0;
         }
         const env2 = getEnvScope(scope);
-        return env2[property];
+        return scope === "server" ? readServerEnvKey(env2, property) : env2[property];
       },
       ownKeys() {
         return Reflect.ownKeys(getEnvScope(scope));
@@ -130,12 +152,82 @@ function createEnvProxy(scope) {
 }
 __name(createEnvProxy, "createEnvProxy");
 function getEnvScope(scope) {
+  const env2 = getCurrentEnv();
   if (scope === "server") {
     assertServerEnvAccess();
+    readRuntimeServerEnv(env2);
   }
-  return getCurrentEnv()[scope] || {};
+  return env2[scope] || {};
 }
 __name(getEnvScope, "getEnvScope");
+function readServerEnvKey(server, key) {
+  const value = server[key];
+  if (value === void 0) {
+    const state = getCurrentEnv()[FARM_ENV_RUNTIME_SYMBOL];
+    if (state && key in state.pending && !state.warned.has(key)) {
+      state.warned.add(key);
+      console.warn(
+        `[Farm] Server env "${key}" was set when this app was built but is not set where the server runs, so it reads as undefined. Farm reads server env at runtime and does not store it in the build output; set "${key}" in the server's environment.`
+      );
+    }
+  }
+  return value;
+}
+__name(readServerEnvKey, "readServerEnvKey");
+function readRuntimeServerEnv(env2) {
+  const state = env2[FARM_ENV_RUNTIME_SYMBOL];
+  if (!state) return;
+  const source = getProcessEnv();
+  for (const [key, type] of Object.entries(state.pending)) {
+    const raw = source[key];
+    if (raw === void 0) continue;
+    env2.server[key] = coerceRuntimeEnvValue(raw, type);
+    delete state.pending[key];
+  }
+}
+__name(readRuntimeServerEnv, "readRuntimeServerEnv");
+function getRuntimeEnvType(value) {
+  if (typeof value === "number") return "number";
+  if (typeof value === "boolean") return "boolean";
+  if (value !== null && typeof value === "object" && !(value instanceof Date)) return "json";
+  return "string";
+}
+__name(getRuntimeEnvType, "getRuntimeEnvType");
+function coerceRuntimeEnvValue(raw, type) {
+  if (type === "number") {
+    const value = Number(raw);
+    return raw.trim() !== "" && Number.isFinite(value) ? value : raw;
+  }
+  if (type === "boolean") {
+    if (/^(true|1)$/i.test(raw.trim())) return true;
+    if (/^(false|0|)$/i.test(raw.trim())) return false;
+    return raw;
+  }
+  if (type === "json") {
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+  return raw;
+}
+__name(coerceRuntimeEnvValue, "coerceRuntimeEnvValue");
+function prepareEnv(env2) {
+  const normalized = normalizeResolvedEnv(env2);
+  const runtime = env2.runtime?.server;
+  if (!isRecord(runtime) || Object.keys(runtime).length === 0) return normalized;
+  const prepared = { server: { ...normalized.server }, public: normalized.public };
+  Object.defineProperty(prepared, FARM_ENV_RUNTIME_SYMBOL, {
+    value: {
+      pending: { ...runtime },
+      warned: /* @__PURE__ */ new Set()
+    },
+    enumerable: false
+  });
+  return prepared;
+}
+__name(prepareEnv, "prepareEnv");
 function assertServerEnvAccess() {
   if (typeof window !== "undefined") {
     throw new Error("Farm server env is not available in the browser. Use publicEnv.");
@@ -166,7 +258,7 @@ __name(getCurrentEnv, "getCurrentEnv");
 function getInjectedEnv() {
   try {
     if (typeof __FARM_ENV__ !== "undefined" && __FARM_ENV__) {
-      return normalizeResolvedEnv(__FARM_ENV__);
+      return prepareEnv(__FARM_ENV__);
     }
   } catch {
   }
@@ -203,6 +295,7 @@ function getProcessEnv() {
 __name(getProcessEnv, "getProcessEnv");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createBundledEnv,
   env,
   getEnv,
   getPublicEnv,

package/dist/env.d.mts

@@ -31,8 +31,26 @@ type FarmPublicEnv = FarmEnvTypes extends {
     public: infer TPublic;
 } ? TPublic extends Record<string, any> ? TPublic : Record<string, unknown> : Record<string, unknown>;
 type FarmTypedEnv = ResolvedFarmEnv<FarmServerEnv, FarmPublicEnv>;
+type FarmEnvRuntimeType = "string" | "number" | "boolean" | "json";
+/**
+ * The env a server bundle carries. `runtime.server` lists server keys that are
+ * read from the server's environment instead of being stored in the bundle,
+ * with the type their parsed value had at build time.
+ */
+interface BundledFarmEnv extends ResolvedFarmEnv {
+    runtime?: {
+        server: Record<string, FarmEnvRuntimeType>;
+    };
+}
 declare function resolveEnv<TConfig extends FarmEnvConfig<any, any> | undefined>(config: TConfig, source?: Record<string, string | undefined>): InferEnv<NonNullable<TConfig>>;
-declare function setEnv(env: ResolvedFarmEnv): void;
+/**
+ * Prepare resolved env for a server bundle. Server values that came from the
+ * build environment are left out and read from `process.env` when the server
+ * uses them, so secrets never land in build output and a restart picks up a
+ * rotated value. Values a parser produced without an env var (defaults) stay.
+ */
+declare function createBundledEnv(env: ResolvedFarmEnv | FarmEnvConfig<any, any> | undefined, source?: Record<string, string | undefined>): BundledFarmEnv;
+declare function setEnv(env: ResolvedFarmEnv | BundledFarmEnv): void;
 declare function getResolvedEnv<TEnv extends ResolvedFarmEnv = FarmTypedEnv>(): TEnv;
 declare function getEnv<TServer extends Record<string, any> = FarmServerEnv>(): TServer;
 declare function getEnv<TKey extends Extract<keyof FarmServerEnv, string>>(key: TKey): FarmServerEnv[TKey];
@@ -42,4 +60,4 @@ declare const env: FarmServerEnv;
 declare const serverEnv: Record<string, unknown>;
 declare const publicEnv: FarmPublicEnv;
 
-export { type EnvParser, type EnvSchema, type EnvShape, type FarmEnvConfig, type FarmEnvTypes, type FarmPublicEnv, type FarmServerEnv, type FarmTypedEnv, type InferEnv, type InferEnvParser, type InferEnvShape, type ResolvedFarmEnv, env, getEnv, getPublicEnv, getResolvedEnv, publicEnv, resolveEnv, serverEnv, setEnv };
+export { type BundledFarmEnv, type EnvParser, type EnvSchema, type EnvShape, type FarmEnvConfig, type FarmEnvRuntimeType, type FarmEnvTypes, type FarmPublicEnv, type FarmServerEnv, type FarmTypedEnv, type InferEnv, type InferEnvParser, type InferEnvShape, type ResolvedFarmEnv, createBundledEnv, env, getEnv, getPublicEnv, getResolvedEnv, publicEnv, resolveEnv, serverEnv, setEnv };