@farm.js/core 0.1.0-beta.21 → 0.1.0-beta.22

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/agent-runtime.d.mts

@@ -0,0 +1,96 @@
+import { ChildProcess } from 'node:child_process';
+import { _ as BundleResultPayload, $ as FarmPlugin, a0 as FarmIntegration } from './client-plugins-QQntVkrv.mjs';
+import './plugin-BJDf43dc.mjs';
+import 'react';
+import 'http';
+import './types-D1A6-XvH.mjs';
+import 'db0';
+import 'unstorage';
+import './integration-api-CHT2OKAf.mjs';
+import '@farming-labs/orm';
+import './types-DTzm4TCl.mjs';
+import '@farming-labs/docs';
+import './markdown.mjs';
+import './observability.mjs';
+import 'vite';
+import './workflows-CusFV6mn.mjs';
+import './cron.mjs';
+import './env.mjs';
+import './server-action-security.mjs';
+import './server-fn-error-DDh14a0V.mjs';
+import './image-config-Duob7wER.mjs';
+import './types-BMxWr97v.mjs';
+import './cache.mjs';
+import './route-runtime-DoOHzCAD.mjs';
+import './font.mjs';
+
+interface FarmAgentRuntimeInstance {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+    getOrigin(): string | undefined;
+}
+interface FarmManagedAgentRuntime {
+    readonly origin: string;
+    readonly process?: ChildProcess;
+    stop(): Promise<void>;
+}
+interface FarmAgentRuntimeStartContext {
+    readonly root: string;
+    readonly log: {
+        info(message: string, meta?: Record<string, unknown>): void;
+        warn(message: string, meta?: Record<string, unknown>): void;
+        error(message: string, meta?: Record<string, unknown>): void;
+    };
+}
+interface FarmAgentRuntimeBuildContext extends BundleResultPayload {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+}
+interface FarmAgentRuntimeIntegrationOptions {
+    provider: string;
+    routePrefix: string;
+    /** Whether Farm's production server must dispatch this runtime's proxy routes. */
+    serverRuntime?: boolean;
+    additionalRoutePrefixes?: readonly string[];
+    origin?: string;
+    originEnv?: string | readonly string[];
+    webSockets?: boolean;
+    startDev?(context: FarmAgentRuntimeStartContext): Promise<FarmManagedAgentRuntime>;
+    afterBuild?(context: FarmAgentRuntimeBuildContext): Promise<void> | void;
+    plugins?: readonly FarmPlugin[];
+    instance?: Record<string, unknown>;
+}
+interface FarmManagedProcessOptions {
+    command: string;
+    args?: readonly string[];
+    cwd: string;
+    env?: Record<string, string | undefined>;
+    label: string;
+    origin?: string;
+    resolveOrigin?(output: string): string | undefined;
+    healthPath?: string;
+    timeoutMs?: number;
+    stopTimeoutMs?: number;
+    onOutput?(line: string, stream: "stdout" | "stderr"): void;
+}
+interface FarmAgentProxyOptions {
+    fetch?: typeof globalThis.fetch;
+}
+declare function createAgentRuntimeIntegration(options: FarmAgentRuntimeIntegrationOptions): FarmIntegration;
+declare function applyAgentRuntimeViteProxy(config: {
+    vite?: Record<string, any>;
+}, input: {
+    origin: string;
+    routePrefix: string;
+    webSockets?: boolean;
+}): void;
+declare function proxyAgentRuntimeRequest(request: Request, origin: string, options?: FarmAgentProxyOptions): Promise<Response>;
+declare function startManagedAgentRuntime(options: FarmManagedProcessOptions): Promise<FarmManagedAgentRuntime>;
+declare function findAvailableAgentRuntimePort(host?: string): Promise<number>;
+declare function resolveProjectPackageBin(projectRoot: string, packageName: string, binName?: string): Promise<string>;
+declare function normalizeAgentOrigin(value: string): string;
+declare function normalizeAgentRoutePrefix(value: string): string;
+
+export { type FarmAgentProxyOptions, type FarmAgentRuntimeBuildContext, type FarmAgentRuntimeInstance, type FarmAgentRuntimeIntegrationOptions, type FarmAgentRuntimeStartContext, type FarmManagedAgentRuntime, type FarmManagedProcessOptions, applyAgentRuntimeViteProxy, createAgentRuntimeIntegration, findAvailableAgentRuntimePort, normalizeAgentOrigin, normalizeAgentRoutePrefix, proxyAgentRuntimeRequest, resolveProjectPackageBin, startManagedAgentRuntime };

package/dist/agent-runtime.d.ts

@@ -0,0 +1,96 @@
+import { ChildProcess } from 'node:child_process';
+import { _ as BundleResultPayload, $ as FarmPlugin, a0 as FarmIntegration } from './client-plugins-CbRum1fj.js';
+import './plugin-BJDf43dc.js';
+import 'react';
+import 'http';
+import './types-D1A6-XvH.js';
+import 'db0';
+import 'unstorage';
+import './integration-api-CHT2OKAf.js';
+import '@farming-labs/orm';
+import './types-DTzm4TCl.js';
+import '@farming-labs/docs';
+import './markdown.js';
+import './observability.js';
+import 'vite';
+import './workflows-CusFV6mn.js';
+import './cron.js';
+import './env.js';
+import './server-action-security.js';
+import './server-fn-error-DDh14a0V.js';
+import './image-config-Duob7wER.js';
+import './types-BMxWr97v.js';
+import './cache.js';
+import './route-runtime-DoOHzCAD.js';
+import './font.js';
+
+interface FarmAgentRuntimeInstance {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+    getOrigin(): string | undefined;
+}
+interface FarmManagedAgentRuntime {
+    readonly origin: string;
+    readonly process?: ChildProcess;
+    stop(): Promise<void>;
+}
+interface FarmAgentRuntimeStartContext {
+    readonly root: string;
+    readonly log: {
+        info(message: string, meta?: Record<string, unknown>): void;
+        warn(message: string, meta?: Record<string, unknown>): void;
+        error(message: string, meta?: Record<string, unknown>): void;
+    };
+}
+interface FarmAgentRuntimeBuildContext extends BundleResultPayload {
+    readonly provider: string;
+    readonly routePrefix: string;
+    readonly routePrefixes: readonly string[];
+}
+interface FarmAgentRuntimeIntegrationOptions {
+    provider: string;
+    routePrefix: string;
+    /** Whether Farm's production server must dispatch this runtime's proxy routes. */
+    serverRuntime?: boolean;
+    additionalRoutePrefixes?: readonly string[];
+    origin?: string;
+    originEnv?: string | readonly string[];
+    webSockets?: boolean;
+    startDev?(context: FarmAgentRuntimeStartContext): Promise<FarmManagedAgentRuntime>;
+    afterBuild?(context: FarmAgentRuntimeBuildContext): Promise<void> | void;
+    plugins?: readonly FarmPlugin[];
+    instance?: Record<string, unknown>;
+}
+interface FarmManagedProcessOptions {
+    command: string;
+    args?: readonly string[];
+    cwd: string;
+    env?: Record<string, string | undefined>;
+    label: string;
+    origin?: string;
+    resolveOrigin?(output: string): string | undefined;
+    healthPath?: string;
+    timeoutMs?: number;
+    stopTimeoutMs?: number;
+    onOutput?(line: string, stream: "stdout" | "stderr"): void;
+}
+interface FarmAgentProxyOptions {
+    fetch?: typeof globalThis.fetch;
+}
+declare function createAgentRuntimeIntegration(options: FarmAgentRuntimeIntegrationOptions): FarmIntegration;
+declare function applyAgentRuntimeViteProxy(config: {
+    vite?: Record<string, any>;
+}, input: {
+    origin: string;
+    routePrefix: string;
+    webSockets?: boolean;
+}): void;
+declare function proxyAgentRuntimeRequest(request: Request, origin: string, options?: FarmAgentProxyOptions): Promise<Response>;
+declare function startManagedAgentRuntime(options: FarmManagedProcessOptions): Promise<FarmManagedAgentRuntime>;
+declare function findAvailableAgentRuntimePort(host?: string): Promise<number>;
+declare function resolveProjectPackageBin(projectRoot: string, packageName: string, binName?: string): Promise<string>;
+declare function normalizeAgentOrigin(value: string): string;
+declare function normalizeAgentRoutePrefix(value: string): string;
+
+export { type FarmAgentProxyOptions, type FarmAgentRuntimeBuildContext, type FarmAgentRuntimeInstance, type FarmAgentRuntimeIntegrationOptions, type FarmAgentRuntimeStartContext, type FarmManagedAgentRuntime, type FarmManagedProcessOptions, applyAgentRuntimeViteProxy, createAgentRuntimeIntegration, findAvailableAgentRuntimePort, normalizeAgentOrigin, normalizeAgentRoutePrefix, proxyAgentRuntimeRequest, resolveProjectPackageBin, startManagedAgentRuntime };

package/dist/api/route-manager.d.mts

@@ -0,0 +1,68 @@
+import { ViteDevServer } from 'vite';
+import { F as FarmRouteRuntimeConfig } from '../route-runtime-DoOHzCAD.mjs';
+import '../types-BMxWr97v.mjs';
+import { F as FarmI18nRuntime } from '../runtime-Cxpq6xZN.mjs';
+import { A as APIRouteMatch } from '../runtime-Q3u74Nbq.mjs';
+export { c as APIRouteParamValue, b as APIRouteParams, i as invokeAPIRouteEndpoint, a as isWebResponse, m as matchAPIRoute, n as normalizeRouteResponse } from '../runtime-Q3u74Nbq.mjs';
+import '../resolver-DJqjLMg_.mjs';
+import '../cache.mjs';
+import '../transport-BmbGTXA5.mjs';
+
+interface APIRoute extends FarmRouteRuntimeConfig {
+    path: string;
+    filePath: string;
+    methods: string[];
+    endpoints: Record<string, any>;
+}
+interface APIRouteManagerOptions {
+    throwOnLoadError?: boolean;
+    i18n?: FarmI18nRuntime;
+    bodySizeLimit?: number;
+}
+declare const API_ROUTE_METHODS: readonly ["GET", "HEAD", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"];
+declare class APIRouteManager {
+    private routes;
+    private viteServer?;
+    private appDirs;
+    private throwOnLoadError;
+    private i18n?;
+    private bodySizeLimit?;
+    constructor(appDir: string | readonly string[], viteServer?: ViteDevServer, options?: APIRouteManagerOptions);
+    /**
+     * Discover route.ts files in /app/api and explicit endpoints in root routes.ts
+     */
+    discoverRoutes(): Promise<void>;
+    /**
+     * Recursively find all route.ts files
+     */
+    private findRouteFiles;
+    /**
+     * Load a route.ts file and extract HTTP method exports
+     */
+    private loadRoute;
+    /**
+     * Load explicit-path endpoints from src/routes.ts-style files.
+     */
+    private loadRootRoutes;
+    private loadProgrammaticApiRoutes;
+    private handleLoadError;
+    private findRootRoutesFile;
+    private loadModule;
+    private addEndpoint;
+    private addProgrammaticApiRoute;
+    /**
+     * Get the handler that directly invokes endpoint handlers
+     */
+    getHandler(): ((req: Request) => Promise<Response>) | null;
+    /**
+     * Check if a path is an API route
+     */
+    isAPIRoute(pathname: string): boolean;
+    matchRoute(pathname: string): APIRouteMatch<APIRoute> | null;
+    /**
+     * Get all routes for client type generation
+     */
+    getRoutes(): Map<string, APIRoute>;
+}
+
+export { type APIRoute, APIRouteManager, type APIRouteManagerOptions, APIRouteMatch, API_ROUTE_METHODS };

package/dist/api/route-manager.d.ts

@@ -0,0 +1,68 @@
+import { ViteDevServer } from 'vite';
+import { F as FarmRouteRuntimeConfig } from '../route-runtime-DoOHzCAD.js';
+import '../types-BMxWr97v.js';
+import { F as FarmI18nRuntime } from '../runtime-bv63eUiO.js';
+import { A as APIRouteMatch } from '../runtime-Bpp-c28k.js';
+export { c as APIRouteParamValue, b as APIRouteParams, i as invokeAPIRouteEndpoint, a as isWebResponse, m as matchAPIRoute, n as normalizeRouteResponse } from '../runtime-Bpp-c28k.js';
+import '../resolver-IH4RmPEl.js';
+import '../cache.js';
+import '../transport-BmbGTXA5.js';
+
+interface APIRoute extends FarmRouteRuntimeConfig {
+    path: string;
+    filePath: string;
+    methods: string[];
+    endpoints: Record<string, any>;
+}
+interface APIRouteManagerOptions {
+    throwOnLoadError?: boolean;
+    i18n?: FarmI18nRuntime;
+    bodySizeLimit?: number;
+}
+declare const API_ROUTE_METHODS: readonly ["GET", "HEAD", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"];
+declare class APIRouteManager {
+    private routes;
+    private viteServer?;
+    private appDirs;
+    private throwOnLoadError;
+    private i18n?;
+    private bodySizeLimit?;
+    constructor(appDir: string | readonly string[], viteServer?: ViteDevServer, options?: APIRouteManagerOptions);
+    /**
+     * Discover route.ts files in /app/api and explicit endpoints in root routes.ts
+     */
+    discoverRoutes(): Promise<void>;
+    /**
+     * Recursively find all route.ts files
+     */
+    private findRouteFiles;
+    /**
+     * Load a route.ts file and extract HTTP method exports
+     */
+    private loadRoute;
+    /**
+     * Load explicit-path endpoints from src/routes.ts-style files.
+     */
+    private loadRootRoutes;
+    private loadProgrammaticApiRoutes;
+    private handleLoadError;
+    private findRootRoutesFile;
+    private loadModule;
+    private addEndpoint;
+    private addProgrammaticApiRoute;
+    /**
+     * Get the handler that directly invokes endpoint handlers
+     */
+    getHandler(): ((req: Request) => Promise<Response>) | null;
+    /**
+     * Check if a path is an API route
+     */
+    isAPIRoute(pathname: string): boolean;
+    matchRoute(pathname: string): APIRouteMatch<APIRoute> | null;
+    /**
+     * Get all routes for client type generation
+     */
+    getRoutes(): Map<string, APIRoute>;
+}
+
+export { type APIRoute, APIRouteManager, type APIRouteManagerOptions, APIRouteMatch, API_ROUTE_METHODS };

package/dist/api/runtime.d.mts

@@ -0,0 +1,3 @@
+export { A as APIRouteMatch, c as APIRouteParamValue, b as APIRouteParams, C as createEndpointFailureResponse, i as invokeAPIRouteEndpoint, a as isWebResponse, m as matchAPIRoute, n as normalizeRouteResponse } from '../runtime-Q3u74Nbq.mjs';
+import '../cache.mjs';
+import '../transport-BmbGTXA5.mjs';

package/dist/api/runtime.d.ts

@@ -0,0 +1,3 @@
+export { A as APIRouteMatch, c as APIRouteParamValue, b as APIRouteParams, C as createEndpointFailureResponse, i as invokeAPIRouteEndpoint, a as isWebResponse, m as matchAPIRoute, n as normalizeRouteResponse } from '../runtime-Bpp-c28k.js';
+import '../cache.js';
+import '../transport-BmbGTXA5.js';

package/dist/api.cjs

@@ -3955,6 +3955,13 @@ function _withAfterNodeMiddleware(handler) {
 }
 __name(_withAfterNodeMiddleware, "_withAfterNodeMiddleware");
 
+// src/cli-colors.ts
+var import_picocolors = __toESM(require("picocolors"));
+function createCliColors(interactive = process.stdout.isTTY === true) {
+  return import_picocolors.default.createColors(interactive);
+}
+__name(createCliColors, "createCliColors");
+
 // src/api/vite-plugin.ts
 function farmApiPlugin(options = {}) {
   const srcDir = options.srcDir ?? "src";
@@ -3969,25 +3976,21 @@ function farmApiPlugin(options = {}) {
   const log = /* @__PURE__ */ __name((_message) => {
   }, "log");
   const logResponse = /* @__PURE__ */ __name((method, urlPath, status, duration) => {
-    try {
-      const pc = require("picocolors");
-      let statusColor = pc.green;
-      if (status >= 500) statusColor = pc.red;
-      else if (status >= 400) statusColor = pc.yellow;
-      else if (status >= 300) statusColor = pc.cyan;
-      const logMsg = [
-        pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.cyan("API")) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
-        pc.gray(urlPath),
-        pc.dim("-"),
-        statusColor(status.toString()),
-        pc.dim(`(${duration}ms)`)
-      ].join(" ");
-      console.log(logMsg);
-    } catch {
-      console.log(`[FARM] [API] [${method}] ${urlPath} - ${status} (${duration}ms)`);
-    }
+    const pc = createCliColors();
+    let statusColor = pc.green;
+    if (status >= 500) statusColor = pc.red;
+    else if (status >= 400) statusColor = pc.yellow;
+    else if (status >= 300) statusColor = pc.cyan;
+    const logMsg = [
+      pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.cyan("API")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
+      pc.gray(urlPath),
+      pc.dim("-"),
+      statusColor(status.toString()),
+      pc.dim(`(${duration}ms)`)
+    ].join(" ");
+    console.log(logMsg);
   }, "logResponse");
   const addEndpoint = /* @__PURE__ */ __name((routePath, filePath, method, endpoint) => {
     const normalizedMethod = method.toUpperCase();