@farm.js/core 0.1.61 → 0.1.62

package/dist/deferred.d.ts

@@ -0,0 +1,44 @@
+declare const FARM_DEFERRED_CONTENT_TYPE = "application/x-farm-deferred+json";
+declare const FARM_DEFERRED_ERROR_CODE = "FARM_DEFERRED_DATA_ERROR";
+declare const FARM_DEFERRED_BRAND: unique symbol;
+interface Deferred<T> extends Promise<T> {
+    readonly [FARM_DEFERRED_BRAND]: true;
+}
+interface PreparedDeferredData {
+    data: unknown;
+    records: readonly DeferredRecord[];
+}
+interface DeferredRecord {
+    id: string;
+    promise: Deferred<unknown>;
+}
+type DeferredSettlement = {
+    status: "fulfilled";
+    value: unknown;
+} | {
+    status: "rejected";
+    error: {
+        code: typeof FARM_DEFERRED_ERROR_CODE;
+        message: string;
+    };
+};
+type DeferredSettlements = Record<string, DeferredSettlement>;
+interface DeferredDataResponseOptions {
+    onError?: (error: unknown, id: string) => void;
+    /** Called only after a deferred response reaches the end of its stream. */
+    onComplete?: () => void;
+}
+declare class DeferredDataError extends Error {
+    readonly name = "DeferredDataError";
+    readonly code = "FARM_DEFERRED_DATA_ERROR";
+    constructor(message?: string);
+}
+declare function defer<T>(value: PromiseLike<T>): Deferred<Awaited<T>>;
+declare function isDeferred<T = unknown>(value: unknown): value is Deferred<T>;
+declare function prepareDeferredData(value: unknown): PreparedDeferredData;
+declare function snapshotDeferredData(records: readonly DeferredRecord[]): DeferredSettlements;
+declare function reviveDeferredData<T>(value: T, settlements: DeferredSettlements): T;
+declare function createDeferredDataResponse(value: unknown, init?: ResponseInit, options?: DeferredDataResponseOptions): Response;
+declare function readDeferredDataResponse<T>(response: Response, options?: DeferredDataResponseOptions): Promise<T>;
+
+export { type Deferred, DeferredDataError, type DeferredDataResponseOptions, type DeferredRecord, type DeferredSettlement, type DeferredSettlements, FARM_DEFERRED_BRAND, FARM_DEFERRED_CONTENT_TYPE, FARM_DEFERRED_ERROR_CODE, type PreparedDeferredData, createDeferredDataResponse, defer, isDeferred, prepareDeferredData, readDeferredDataResponse, reviveDeferredData, snapshotDeferredData };

package/dist/deferred.mjs

@@ -10,8 +10,8 @@ import {
   readDeferredDataResponse,
   reviveDeferredData,
   snapshotDeferredData
-} from "./chunk-JNZ4TDWM.mjs";
-import "./chunk-LPEX4YW6.mjs";
+} from "./chunk-K5EW7GUU.mjs";
+import "./chunk-Y6FXYEAI.mjs";
 export {
   DeferredDataError,
   FARM_DEFERRED_BRAND,

package/dist/deployment.cjs

@@ -16,8 +16,8 @@
 
 
 
-var _chunkC5GUTBZKcjs = require('./chunk-C5GUTBZK.cjs');
-require('./chunk-S3JO3N4H.cjs');
+var _chunkE552H232cjs = require('./chunk-E552H232.cjs');
+require('./chunk-BTZ5O6VM.cjs');
 
 
 
@@ -36,4 +36,4 @@ require('./chunk-S3JO3N4H.cjs');
 
 
 
-exports.FARM_DEPLOYMENT_COOKIE = _chunkC5GUTBZKcjs.FARM_DEPLOYMENT_COOKIE; exports.FARM_DEPLOYMENT_ID_HEADER = _chunkC5GUTBZKcjs.FARM_DEPLOYMENT_ID_HEADER; exports.FARM_DEPLOYMENT_MISMATCH_CODE = _chunkC5GUTBZKcjs.FARM_DEPLOYMENT_MISMATCH_CODE; exports.FARM_DEPLOYMENT_MISMATCH_HEADER = _chunkC5GUTBZKcjs.FARM_DEPLOYMENT_MISMATCH_HEADER; exports.FARM_DEPLOYMENT_MISMATCH_STATUS = _chunkC5GUTBZKcjs.FARM_DEPLOYMENT_MISMATCH_STATUS; exports.FarmDeploymentMismatchError = _chunkC5GUTBZKcjs.FarmDeploymentMismatchError; exports.createFarmDeploymentCookie = _chunkC5GUTBZKcjs.createFarmDeploymentCookie; exports.createFarmDeploymentMismatchError = _chunkC5GUTBZKcjs.createFarmDeploymentMismatchError; exports.createFarmDeploymentMismatchResponse = _chunkC5GUTBZKcjs.createFarmDeploymentMismatchResponse; exports.createFarmDeploymentRequestHeaders = _chunkC5GUTBZKcjs.createFarmDeploymentRequestHeaders; exports.getFarmDeploymentMismatch = _chunkC5GUTBZKcjs.getFarmDeploymentMismatch; exports.getFarmPresetRuntime = _chunkC5GUTBZKcjs.getFarmPresetRuntime; exports.getFarmRequestDeploymentId = _chunkC5GUTBZKcjs.getFarmRequestDeploymentId; exports.getFarmResponseDeploymentId = _chunkC5GUTBZKcjs.getFarmResponseDeploymentId; exports.isFarmDeploymentMismatchResponse = _chunkC5GUTBZKcjs.isFarmDeploymentMismatchResponse; exports.normalizeFarmDeploymentId = _chunkC5GUTBZKcjs.normalizeFarmDeploymentId; exports.withFarmDeploymentResponse = _chunkC5GUTBZKcjs.withFarmDeploymentResponse;
+exports.FARM_DEPLOYMENT_COOKIE = _chunkE552H232cjs.FARM_DEPLOYMENT_COOKIE; exports.FARM_DEPLOYMENT_ID_HEADER = _chunkE552H232cjs.FARM_DEPLOYMENT_ID_HEADER; exports.FARM_DEPLOYMENT_MISMATCH_CODE = _chunkE552H232cjs.FARM_DEPLOYMENT_MISMATCH_CODE; exports.FARM_DEPLOYMENT_MISMATCH_HEADER = _chunkE552H232cjs.FARM_DEPLOYMENT_MISMATCH_HEADER; exports.FARM_DEPLOYMENT_MISMATCH_STATUS = _chunkE552H232cjs.FARM_DEPLOYMENT_MISMATCH_STATUS; exports.FarmDeploymentMismatchError = _chunkE552H232cjs.FarmDeploymentMismatchError; exports.createFarmDeploymentCookie = _chunkE552H232cjs.createFarmDeploymentCookie; exports.createFarmDeploymentMismatchError = _chunkE552H232cjs.createFarmDeploymentMismatchError; exports.createFarmDeploymentMismatchResponse = _chunkE552H232cjs.createFarmDeploymentMismatchResponse; exports.createFarmDeploymentRequestHeaders = _chunkE552H232cjs.createFarmDeploymentRequestHeaders; exports.getFarmDeploymentMismatch = _chunkE552H232cjs.getFarmDeploymentMismatch; exports.getFarmPresetRuntime = _chunkE552H232cjs.getFarmPresetRuntime; exports.getFarmRequestDeploymentId = _chunkE552H232cjs.getFarmRequestDeploymentId; exports.getFarmResponseDeploymentId = _chunkE552H232cjs.getFarmResponseDeploymentId; exports.isFarmDeploymentMismatchResponse = _chunkE552H232cjs.isFarmDeploymentMismatchResponse; exports.normalizeFarmDeploymentId = _chunkE552H232cjs.normalizeFarmDeploymentId; exports.withFarmDeploymentResponse = _chunkE552H232cjs.withFarmDeploymentResponse;

package/dist/deployment.d.mts

@@ -0,0 +1,36 @@
+declare const FARM_DEPLOYMENT_ID_HEADER = "x-farm-deployment-id";
+declare const FARM_DEPLOYMENT_MISMATCH_HEADER = "x-farm-deployment-mismatch";
+declare const FARM_DEPLOYMENT_COOKIE = "__farm_deployment";
+declare const FARM_DEPLOYMENT_MISMATCH_CODE = "FARM_DEPLOYMENT_MISMATCH";
+declare const FARM_DEPLOYMENT_MISMATCH_STATUS = 409;
+type FarmPresetRuntime = "node" | "edge" | "unknown";
+declare function getFarmPresetRuntime(preset: string): FarmPresetRuntime;
+interface FarmDeploymentMismatch {
+    clientDeploymentId: string;
+    serverDeploymentId: string;
+}
+interface FarmDeploymentResponseOptions {
+    setCookie?: boolean;
+    cookiePath?: string;
+    secureCookie?: boolean;
+}
+declare class FarmDeploymentMismatchError extends Error {
+    readonly clientDeploymentId: string;
+    readonly serverDeploymentId: string;
+    readonly name = "FarmDeploymentMismatchError";
+    readonly code = "FARM_DEPLOYMENT_MISMATCH";
+    readonly retryable = false;
+    constructor(clientDeploymentId: string, serverDeploymentId: string);
+}
+declare function normalizeFarmDeploymentId(value: unknown): string;
+declare function createFarmDeploymentRequestHeaders(deploymentId: string | undefined, init?: HeadersInit): Headers;
+declare function getFarmRequestDeploymentId(request: Pick<Request, "headers" | "method">): string | undefined;
+declare function getFarmDeploymentMismatch(request: Pick<Request, "headers" | "method">, serverDeploymentId: string | undefined): FarmDeploymentMismatch | null;
+declare function createFarmDeploymentMismatchResponse(mismatch: FarmDeploymentMismatch): Response;
+declare function withFarmDeploymentResponse(response: Response, deploymentId: string | undefined, options?: FarmDeploymentResponseOptions): Response;
+declare function getFarmResponseDeploymentId(response: Pick<Response, "headers">): string | undefined;
+declare function isFarmDeploymentMismatchResponse(response: Pick<Response, "headers" | "status">, clientDeploymentId: string | undefined): boolean;
+declare function createFarmDeploymentMismatchError(response: Pick<Response, "headers">, clientDeploymentId: string): FarmDeploymentMismatchError;
+declare function createFarmDeploymentCookie(deploymentId: string, path?: string, secure?: boolean): string;
+
+export { FARM_DEPLOYMENT_COOKIE, FARM_DEPLOYMENT_ID_HEADER, FARM_DEPLOYMENT_MISMATCH_CODE, FARM_DEPLOYMENT_MISMATCH_HEADER, FARM_DEPLOYMENT_MISMATCH_STATUS, type FarmDeploymentMismatch, FarmDeploymentMismatchError, type FarmDeploymentResponseOptions, type FarmPresetRuntime, createFarmDeploymentCookie, createFarmDeploymentMismatchError, createFarmDeploymentMismatchResponse, createFarmDeploymentRequestHeaders, getFarmDeploymentMismatch, getFarmPresetRuntime, getFarmRequestDeploymentId, getFarmResponseDeploymentId, isFarmDeploymentMismatchResponse, normalizeFarmDeploymentId, withFarmDeploymentResponse };

package/dist/deployment.d.ts

@@ -0,0 +1,36 @@
+declare const FARM_DEPLOYMENT_ID_HEADER = "x-farm-deployment-id";
+declare const FARM_DEPLOYMENT_MISMATCH_HEADER = "x-farm-deployment-mismatch";
+declare const FARM_DEPLOYMENT_COOKIE = "__farm_deployment";
+declare const FARM_DEPLOYMENT_MISMATCH_CODE = "FARM_DEPLOYMENT_MISMATCH";
+declare const FARM_DEPLOYMENT_MISMATCH_STATUS = 409;
+type FarmPresetRuntime = "node" | "edge" | "unknown";
+declare function getFarmPresetRuntime(preset: string): FarmPresetRuntime;
+interface FarmDeploymentMismatch {
+    clientDeploymentId: string;
+    serverDeploymentId: string;
+}
+interface FarmDeploymentResponseOptions {
+    setCookie?: boolean;
+    cookiePath?: string;
+    secureCookie?: boolean;
+}
+declare class FarmDeploymentMismatchError extends Error {
+    readonly clientDeploymentId: string;
+    readonly serverDeploymentId: string;
+    readonly name = "FarmDeploymentMismatchError";
+    readonly code = "FARM_DEPLOYMENT_MISMATCH";
+    readonly retryable = false;
+    constructor(clientDeploymentId: string, serverDeploymentId: string);
+}
+declare function normalizeFarmDeploymentId(value: unknown): string;
+declare function createFarmDeploymentRequestHeaders(deploymentId: string | undefined, init?: HeadersInit): Headers;
+declare function getFarmRequestDeploymentId(request: Pick<Request, "headers" | "method">): string | undefined;
+declare function getFarmDeploymentMismatch(request: Pick<Request, "headers" | "method">, serverDeploymentId: string | undefined): FarmDeploymentMismatch | null;
+declare function createFarmDeploymentMismatchResponse(mismatch: FarmDeploymentMismatch): Response;
+declare function withFarmDeploymentResponse(response: Response, deploymentId: string | undefined, options?: FarmDeploymentResponseOptions): Response;
+declare function getFarmResponseDeploymentId(response: Pick<Response, "headers">): string | undefined;
+declare function isFarmDeploymentMismatchResponse(response: Pick<Response, "headers" | "status">, clientDeploymentId: string | undefined): boolean;
+declare function createFarmDeploymentMismatchError(response: Pick<Response, "headers">, clientDeploymentId: string): FarmDeploymentMismatchError;
+declare function createFarmDeploymentCookie(deploymentId: string, path?: string, secure?: boolean): string;
+
+export { FARM_DEPLOYMENT_COOKIE, FARM_DEPLOYMENT_ID_HEADER, FARM_DEPLOYMENT_MISMATCH_CODE, FARM_DEPLOYMENT_MISMATCH_HEADER, FARM_DEPLOYMENT_MISMATCH_STATUS, type FarmDeploymentMismatch, FarmDeploymentMismatchError, type FarmDeploymentResponseOptions, type FarmPresetRuntime, createFarmDeploymentCookie, createFarmDeploymentMismatchError, createFarmDeploymentMismatchResponse, createFarmDeploymentRequestHeaders, getFarmDeploymentMismatch, getFarmPresetRuntime, getFarmRequestDeploymentId, getFarmResponseDeploymentId, isFarmDeploymentMismatchResponse, normalizeFarmDeploymentId, withFarmDeploymentResponse };

package/dist/deployment.mjs

@@ -16,8 +16,8 @@ import {
   isFarmDeploymentMismatchResponse,
   normalizeFarmDeploymentId,
   withFarmDeploymentResponse
-} from "./chunk-2A3EQHXX.mjs";
-import "./chunk-LPEX4YW6.mjs";
+} from "./chunk-UAQD67HM.mjs";
+import "./chunk-Y6FXYEAI.mjs";
 export {
   FARM_DEPLOYMENT_COOKIE,
   FARM_DEPLOYMENT_ID_HEADER,

package/dist/desktop.cjs

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-BTZ5O6VM.cjs');
+
+// src/desktop/index.ts
+function defineDesktop(hooks) {
+  return hooks;
+}
+function defineDesktopShell(shell) {
+  return shell;
+}
+
+
+
+exports.defineDesktop = defineDesktop; exports.defineDesktopShell = defineDesktopShell;

package/dist/desktop.d.mts

@@ -0,0 +1,120 @@
+import { R as ResolvedFarmDesktopConfig } from './client-plugins.d-CWyYBxXf.mjs';
+export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins.d-CWyYBxXf.mjs';
+import './lifecycle.d-C2aLBOwu.mjs';
+import './route.d-BaVH3V0w.mjs';
+import './endpoint.d-BkMSCRf6.mjs';
+import './cache.mjs';
+import './renderer.mjs';
+import './deployment.mjs';
+import 'http';
+import './server-fn.mjs';
+import './server-fn-error.d-DrcH9cc1.mjs';
+import './server-query.mjs';
+import './types.d-BnIqOn9w.mjs';
+import 'db0';
+import 'unstorage';
+import './schema.mjs';
+import 'react';
+import '@farming-labs/orm';
+import '@farming-labs/docs';
+import './observability.d-B2363jB6.mjs';
+import '@opentelemetry/api';
+import 'vite';
+import './workflows.d-CRMzQZ3k.mjs';
+import './cron.mjs';
+import './env.mjs';
+import './server-action-security.mjs';
+import './layers.d-CcS42OGR.mjs';
+import 'rolldown/utils';
+import 'rolldown';
+import './image-config.d-CeDgNyX4.mjs';
+import './types.d-C41ePjvP.mjs';
+import './config.d-qt-mE8O5.mjs';
+import './types.d-DQnyD3VD.mjs';
+import './font.mjs';
+
+/**
+ * `@farm.js/core/desktop`: the hook file contract (`src/desktop.ts`) and the interface desktop
+ * shell adapters implement. Types and an identity helper only; nothing here runs in a web build.
+ */
+
+/** The running Farm server, as the shell sees it. */
+interface DesktopServerInfo {
+    origin: string;
+    port: number;
+}
+/** Context passed to `onReady` in `src/desktop.ts`. */
+interface DesktopReadyContext<Window = unknown> {
+    /** The shell's window object (an Electrobun `BrowserWindow`, for example). */
+    window: Window;
+    server: DesktopServerInfo;
+    /** `"development"` under `farm dev --desktop`, otherwise `"production"`. */
+    mode: "development" | "production";
+}
+interface DesktopHooks<Window = unknown> {
+    /** Runs in the shell process after the window opened on the app. */
+    onReady?(context: DesktopReadyContext<Window>): void | Promise<void>;
+}
+/** Typed helper for `src/desktop.ts`. Hooks run in the shell process, never in the browser. */
+declare function defineDesktop<Window = unknown>(hooks: DesktopHooks<Window>): DesktopHooks<Window>;
+/** A file a shell adapter generates, relative to the shell output directory. */
+interface DesktopGeneratedFile {
+    path: string;
+    /** Text, or bytes for binary files such as the app icon. */
+    contents: string | Uint8Array;
+}
+interface DesktopShellContext {
+    /** App root. */
+    root: string;
+    desktop: ResolvedFarmDesktopConfig;
+    /** The app's basePath ("" or "/base"). */
+    basePath: string;
+    /** Directory the generated shell files are written to (`.farm/output/desktop/shell`). */
+    shellDir: string;
+    /** Farm server output (`.farm/output/desktop/server`); its entry exports `start()`. */
+    serverDir: string;
+    /** Absolute path of `src/desktop.ts` (or .js, .mts), when the app has one. */
+    hooksFile?: string;
+}
+interface DesktopDevContext extends DesktopShellContext {
+    /** Origin of the running `farm dev` server, such as `http://localhost:3000`. */
+    devUrl: string;
+    /** Session secret the dev server's guard expects as the cookie. */
+    secret: string;
+    /** One-time token for the handshake URL. */
+    handshakeToken: string;
+    /** Data directory for `appDataDir()` in this dev session. */
+    dataDir: string;
+    /** Environment for the shell process (already includes the values above). */
+    env: NodeJS.ProcessEnv;
+}
+interface DesktopPackageContext extends DesktopShellContext {
+    /** Directory for packaged apps and installers (`.farm/output/desktop/dist`). */
+    distDir: string;
+}
+interface DesktopArtifacts {
+    /** Absolute paths of the produced apps, installers, and update archives. */
+    files: string[];
+}
+/** A running shell started by `dev()`. */
+interface DesktopDevSession {
+    /** Resolves when the shell exits by itself (the user closed the app). */
+    exited: Promise<number>;
+    close(): Promise<void>;
+}
+/** What a desktop shell package (such as `@farm.js/desktop/electrobun`) default-exports. */
+interface DesktopShell {
+    name: string;
+    /** The runtime the shell embeds the Farm server in; selects the `bun` or `node-server` preset. */
+    runtime: "bun" | "node";
+    /** Shell main process and config, written into `shellDir`. */
+    generateMain(context: DesktopShellContext): DesktopGeneratedFile[] | Promise<DesktopGeneratedFile[]>;
+    /** Start the shell with its window on `farm dev`. */
+    dev(context: DesktopDevContext): Promise<DesktopDevSession>;
+    /** Package the generated shell and server into an app. */
+    package(context: DesktopPackageContext): Promise<DesktopArtifacts>;
+}
+/** Typed helper for shell adapter packages. */
+declare function defineDesktopShell(shell: DesktopShell): DesktopShell;
+
+export { type DesktopArtifacts, type DesktopDevContext, type DesktopDevSession, type DesktopGeneratedFile, type DesktopHooks, type DesktopPackageContext, type DesktopReadyContext, type DesktopServerInfo, type DesktopShell, type DesktopShellContext, ResolvedFarmDesktopConfig, defineDesktop, defineDesktopShell };

package/dist/desktop.d.ts

@@ -0,0 +1,120 @@
+import { R as ResolvedFarmDesktopConfig } from './client-plugins.d-BcqIy4au.js';
+export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins.d-BcqIy4au.js';
+import './lifecycle.d-C2aLBOwu.js';
+import './route.d-DBTEqifW.js';
+import './endpoint.d-BgHn0lhl.js';
+import './cache.js';
+import './renderer.js';
+import './deployment.js';
+import 'http';
+import './server-fn.js';
+import './server-fn-error.d-DrcH9cc1.js';
+import './server-query.js';
+import './types.d-BnIqOn9w.js';
+import 'db0';
+import 'unstorage';
+import './schema.js';
+import 'react';
+import '@farming-labs/orm';
+import '@farming-labs/docs';
+import './observability.d-B2363jB6.js';
+import '@opentelemetry/api';
+import 'vite';
+import './workflows.d-CRMzQZ3k.js';
+import './cron.js';
+import './env.js';
+import './server-action-security.js';
+import './layers.d-CcS42OGR.js';
+import 'rolldown/utils';
+import 'rolldown';
+import './image-config.d-CeDgNyX4.js';
+import './types.d-C41ePjvP.js';
+import './config.d-qt-mE8O5.js';
+import './types.d-DQnyD3VD.js';
+import './font.js';
+
+/**
+ * `@farm.js/core/desktop`: the hook file contract (`src/desktop.ts`) and the interface desktop
+ * shell adapters implement. Types and an identity helper only; nothing here runs in a web build.
+ */
+
+/** The running Farm server, as the shell sees it. */
+interface DesktopServerInfo {
+    origin: string;
+    port: number;
+}
+/** Context passed to `onReady` in `src/desktop.ts`. */
+interface DesktopReadyContext<Window = unknown> {
+    /** The shell's window object (an Electrobun `BrowserWindow`, for example). */
+    window: Window;
+    server: DesktopServerInfo;
+    /** `"development"` under `farm dev --desktop`, otherwise `"production"`. */
+    mode: "development" | "production";
+}
+interface DesktopHooks<Window = unknown> {
+    /** Runs in the shell process after the window opened on the app. */
+    onReady?(context: DesktopReadyContext<Window>): void | Promise<void>;
+}
+/** Typed helper for `src/desktop.ts`. Hooks run in the shell process, never in the browser. */
+declare function defineDesktop<Window = unknown>(hooks: DesktopHooks<Window>): DesktopHooks<Window>;
+/** A file a shell adapter generates, relative to the shell output directory. */
+interface DesktopGeneratedFile {
+    path: string;
+    /** Text, or bytes for binary files such as the app icon. */
+    contents: string | Uint8Array;
+}
+interface DesktopShellContext {
+    /** App root. */
+    root: string;
+    desktop: ResolvedFarmDesktopConfig;
+    /** The app's basePath ("" or "/base"). */
+    basePath: string;
+    /** Directory the generated shell files are written to (`.farm/output/desktop/shell`). */
+    shellDir: string;
+    /** Farm server output (`.farm/output/desktop/server`); its entry exports `start()`. */
+    serverDir: string;
+    /** Absolute path of `src/desktop.ts` (or .js, .mts), when the app has one. */
+    hooksFile?: string;
+}
+interface DesktopDevContext extends DesktopShellContext {
+    /** Origin of the running `farm dev` server, such as `http://localhost:3000`. */
+    devUrl: string;
+    /** Session secret the dev server's guard expects as the cookie. */
+    secret: string;
+    /** One-time token for the handshake URL. */
+    handshakeToken: string;
+    /** Data directory for `appDataDir()` in this dev session. */
+    dataDir: string;
+    /** Environment for the shell process (already includes the values above). */
+    env: NodeJS.ProcessEnv;
+}
+interface DesktopPackageContext extends DesktopShellContext {
+    /** Directory for packaged apps and installers (`.farm/output/desktop/dist`). */
+    distDir: string;
+}
+interface DesktopArtifacts {
+    /** Absolute paths of the produced apps, installers, and update archives. */
+    files: string[];
+}
+/** A running shell started by `dev()`. */
+interface DesktopDevSession {
+    /** Resolves when the shell exits by itself (the user closed the app). */
+    exited: Promise<number>;
+    close(): Promise<void>;
+}
+/** What a desktop shell package (such as `@farm.js/desktop/electrobun`) default-exports. */
+interface DesktopShell {
+    name: string;
+    /** The runtime the shell embeds the Farm server in; selects the `bun` or `node-server` preset. */
+    runtime: "bun" | "node";
+    /** Shell main process and config, written into `shellDir`. */
+    generateMain(context: DesktopShellContext): DesktopGeneratedFile[] | Promise<DesktopGeneratedFile[]>;
+    /** Start the shell with its window on `farm dev`. */
+    dev(context: DesktopDevContext): Promise<DesktopDevSession>;
+    /** Package the generated shell and server into an app. */
+    package(context: DesktopPackageContext): Promise<DesktopArtifacts>;
+}
+/** Typed helper for shell adapter packages. */
+declare function defineDesktopShell(shell: DesktopShell): DesktopShell;
+
+export { type DesktopArtifacts, type DesktopDevContext, type DesktopDevSession, type DesktopGeneratedFile, type DesktopHooks, type DesktopPackageContext, type DesktopReadyContext, type DesktopServerInfo, type DesktopShell, type DesktopShellContext, ResolvedFarmDesktopConfig, defineDesktop, defineDesktopShell };

package/dist/desktop.mjs

@@ -0,0 +1,13 @@
+import "./chunk-Y6FXYEAI.mjs";
+
+// src/desktop/index.ts
+function defineDesktop(hooks) {
+  return hooks;
+}
+function defineDesktopShell(shell) {
+  return shell;
+}
+export {
+  defineDesktop,
+  defineDesktopShell
+};

package/dist/dev-guard-2UW2KERP.cjs

@@ -0,0 +1,59 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } 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; }
+
+var _chunkOY5XDG24cjs = require('./chunk-OY5XDG24.cjs');
+
+
+var _chunkAQLHD6HZcjs = require('./chunk-AQLHD6HZ.cjs');
+require('./chunk-YKHRCY4T.cjs');
+require('./chunk-SHIWRBFI.cjs');
+
+
+var _chunkYIHRZBD7cjs = require('./chunk-YIHRZBD7.cjs');
+require('./chunk-R5U7OIPI.cjs');
+require('./chunk-BTZ5O6VM.cjs');
+
+// src/desktop/dev-guard.ts
+function getFarmDesktopDevSession() {
+  return globalThis[_chunkAQLHD6HZcjs.FARM_DESKTOP_DEV_SESSION];
+}
+function createFarmDesktopDevGuard(server, options) {
+  const session = getFarmDesktopDevSession();
+  if (!session) {
+    throw new Error(
+      "[Farm] FARM_PLATFORM=desktop without a desktop session. Start desktop development with `farm dev --desktop`."
+    );
+  }
+  const guard = _chunkOY5XDG24cjs.createFarmDesktopGuard.call(void 0, {
+    secret: session.secret,
+    handshakeToken: session.handshakeToken,
+    basePath: options.basePath,
+    handshakeState: session,
+    port: () => {
+      const address = _optionalChain([server, 'access', _ => _.httpServer, 'optionalAccess', _2 => _2.address, 'call', _3 => _3()]);
+      return address && typeof address === "object" ? address.port : void 0;
+    }
+  });
+  return (request, response, next) => {
+    const blocked = guard({
+      method: request.method || "GET",
+      url: request.url || "/",
+      headers: {
+        get(name) {
+          const value = request.headers[name];
+          return Array.isArray(value) ? value.join(", ") : _nullishCoalesce(value, () => ( null));
+        }
+      }
+    });
+    if (!blocked) return next();
+    server.config.logger.warn(
+      `[farm] desktop guard refused ${request.method} ${(request.url || "/").split("?")[0]}: ${_nullishCoalesce(blocked.headers.get("x-farm-desktop-guard"), () => ( "forbidden"))}`,
+      { timestamp: true }
+    );
+    _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, response, blocked).catch(next);
+  };
+}
+
+
+
+
+exports.FARM_DESKTOP_DEV_SESSION = _chunkAQLHD6HZcjs.FARM_DESKTOP_DEV_SESSION; exports.createFarmDesktopDevGuard = createFarmDesktopDevGuard; exports.getFarmDesktopDevSession = getFarmDesktopDevSession;

package/dist/dev-guard-ONNMVQUN.mjs

@@ -0,0 +1,59 @@
+import {
+  createFarmDesktopGuard
+} from "./chunk-7PZVXMWG.mjs";
+import {
+  FARM_DESKTOP_DEV_SESSION
+} from "./chunk-SMUW7UST.mjs";
+import "./chunk-UB7RVEMX.mjs";
+import "./chunk-YP7YO3S3.mjs";
+import {
+  sendWebResponse
+} from "./chunk-CO6UYM2D.mjs";
+import "./chunk-AY2YD5ZX.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+
+// src/desktop/dev-guard.ts
+function getFarmDesktopDevSession() {
+  return globalThis[FARM_DESKTOP_DEV_SESSION];
+}
+function createFarmDesktopDevGuard(server, options) {
+  const session = getFarmDesktopDevSession();
+  if (!session) {
+    throw new Error(
+      "[Farm] FARM_PLATFORM=desktop without a desktop session. Start desktop development with `farm dev --desktop`."
+    );
+  }
+  const guard = createFarmDesktopGuard({
+    secret: session.secret,
+    handshakeToken: session.handshakeToken,
+    basePath: options.basePath,
+    handshakeState: session,
+    port: () => {
+      const address = server.httpServer?.address();
+      return address && typeof address === "object" ? address.port : void 0;
+    }
+  });
+  return (request, response, next) => {
+    const blocked = guard({
+      method: request.method || "GET",
+      url: request.url || "/",
+      headers: {
+        get(name) {
+          const value = request.headers[name];
+          return Array.isArray(value) ? value.join(", ") : value ?? null;
+        }
+      }
+    });
+    if (!blocked) return next();
+    server.config.logger.warn(
+      `[farm] desktop guard refused ${request.method} ${(request.url || "/").split("?")[0]}: ${blocked.headers.get("x-farm-desktop-guard") ?? "forbidden"}`,
+      { timestamp: true }
+    );
+    sendWebResponse(response, blocked).catch(next);
+  };
+}
+export {
+  FARM_DESKTOP_DEV_SESSION,
+  createFarmDesktopDevGuard,
+  getFarmDesktopDevSession
+};