@farm.js/core 0.1.0-beta.14 → 0.1.0-beta.17

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-278AvYHE.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.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-CTQAkr7R.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.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 };