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

package/dist/cron.d.ts

@@ -0,0 +1,78 @@
+type FarmCronSchedule = string | string[];
+interface FarmCronJobConfig {
+    /** Portable five-field cron expression, or a list of expressions. */
+    schedule: FarmCronSchedule;
+    /** Farm API route invoked with GET when the schedule fires. */
+    path: string;
+    /** Human-readable purpose shown by local tooling and deployment manifests. */
+    description?: string;
+    /** Disable this schedule without removing its configuration. */
+    enabled?: boolean;
+}
+type FarmCronUserConfig = Record<string, FarmCronJobConfig>;
+interface FarmCronJob {
+    name: string;
+    schedule: string[];
+    path: string;
+    description?: string;
+}
+interface FarmCronResolvedConfig {
+    enabled: boolean;
+    secretEnv: typeof DEFAULT_FARM_CRON_SECRET_ENV;
+    jobs: FarmCronJob[];
+}
+interface PreparedFarmCron {
+    jobs: FarmCronJob[];
+    tasks: Record<string, {
+        handler: string;
+        description: string;
+    }>;
+    scheduledTasks: Record<string, string | string[]>;
+    manifestPath?: string;
+}
+interface FarmCronRouteOptions {
+    /** Environment variable containing the bearer token. */
+    secretEnv?: string;
+    /** Inline token, primarily useful in tests. Environment variables are preferred. */
+    secret?: string;
+    /** Allow a production route without a secret. Defaults to false. */
+    allowUnsecured?: boolean;
+}
+interface FarmCronCloudflareConfig {
+    deployConfig: true;
+    wrangler: {
+        triggers: {
+            crons: string[];
+        };
+    };
+}
+declare const DEFAULT_FARM_CRON_SECRET_ENV = "CRON_SECRET";
+declare const FARM_CRON_MANIFEST = "cron-manifest.json";
+declare function resolveCronConfig(cron: FarmCronResolvedConfig | FarmCronUserConfig | false | undefined): FarmCronResolvedConfig;
+declare function prepareFarmCronForNitro(config: {
+    root?: string;
+    distDir?: string;
+    cron?: FarmCronResolvedConfig | FarmCronUserConfig | false;
+}): Promise<PreparedFarmCron>;
+declare function createFarmCronManifest(cron: FarmCronResolvedConfig): {
+    schemaVersion: number;
+    secretEnv: "CRON_SECRET";
+    jobs: {
+        name: string;
+        schedule: string[];
+        path: string;
+        description: string | null;
+    }[];
+};
+declare function createFarmCronVercelCrons(jobs: FarmCronJob[]): Array<{
+    path: string;
+    schedule: string;
+}>;
+declare function applyFarmCronVercelCrons(vercelConfig: Record<string, any>, jobs: FarmCronJob[]): Record<string, any>;
+declare function createFarmCronCloudflareTriggers(jobs: FarmCronJob[]): string[];
+declare function createFarmCronCloudflareConfig(jobs: FarmCronJob[]): FarmCronCloudflareConfig | undefined;
+declare function mergeScheduledTasks(...maps: Array<Record<string, string | string[]> | undefined>): Record<string, string | string[]>;
+declare function isCronRequestAuthorized(request: Request, options?: FarmCronRouteOptions): boolean;
+declare function cronRoute<TArgs extends unknown[], TResult>(handler: (request: Request, ...args: TArgs) => TResult, options?: FarmCronRouteOptions): (request: Request, ...args: TArgs) => TResult | Promise<Response>;
+
+export { DEFAULT_FARM_CRON_SECRET_ENV, FARM_CRON_MANIFEST, type FarmCronCloudflareConfig, type FarmCronJob, type FarmCronJobConfig, type FarmCronResolvedConfig, type FarmCronRouteOptions, type FarmCronSchedule, type FarmCronUserConfig, type PreparedFarmCron, applyFarmCronVercelCrons, createFarmCronCloudflareConfig, createFarmCronCloudflareTriggers, createFarmCronManifest, createFarmCronVercelCrons, cronRoute, isCronRequestAuthorized, mergeScheduledTasks, prepareFarmCronForNitro, resolveCronConfig };

package/dist/deferred.d.mts

@@ -0,0 +1,42 @@
+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;
+}
+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): 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.d.ts

@@ -0,0 +1,42 @@
+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;
+}
+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): 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/deployment.cjs

@@ -32,6 +32,7 @@ __export(deployment_exports, {
   createFarmDeploymentMismatchResponse: () => createFarmDeploymentMismatchResponse,
   createFarmDeploymentRequestHeaders: () => createFarmDeploymentRequestHeaders,
   getFarmDeploymentMismatch: () => getFarmDeploymentMismatch,
+  getFarmPresetRuntime: () => getFarmPresetRuntime,
   getFarmRequestDeploymentId: () => getFarmRequestDeploymentId,
   getFarmResponseDeploymentId: () => getFarmResponseDeploymentId,
   isFarmDeploymentMismatchResponse: () => isFarmDeploymentMismatchResponse,
@@ -44,6 +45,16 @@ var FARM_DEPLOYMENT_MISMATCH_HEADER = "x-farm-deployment-mismatch";
 var FARM_DEPLOYMENT_COOKIE = "__farm_deployment";
 var FARM_DEPLOYMENT_MISMATCH_CODE = "FARM_DEPLOYMENT_MISMATCH";
 var FARM_DEPLOYMENT_MISMATCH_STATUS = 409;
+function getFarmPresetRuntime(preset) {
+  if (preset === "cloudflare" || preset === "cloudflare-pages" || preset === "cloudflare-module" || preset === "netlify-edge" || preset === "vercel-edge" || preset === "deno") {
+    return "edge";
+  }
+  if (preset === "node-server" || preset === "vercel" || preset === "netlify" || preset === "aws-lambda" || preset === "azure" || preset === "firebase" || preset === "bun" || preset === "self-host" || preset === "farm") {
+    return "node";
+  }
+  return "unknown";
+}
+__name(getFarmPresetRuntime, "getFarmPresetRuntime");
 var _FarmDeploymentMismatchError = class _FarmDeploymentMismatchError extends Error {
   constructor(clientDeploymentId, serverDeploymentId) {
     super("The application was updated while this page was open. Refresh before trying again.");
@@ -190,6 +201,7 @@ __name(isSafeRequestMethod, "isSafeRequestMethod");
   createFarmDeploymentMismatchResponse,
   createFarmDeploymentRequestHeaders,
   getFarmDeploymentMismatch,
+  getFarmPresetRuntime,
   getFarmRequestDeploymentId,
   getFarmResponseDeploymentId,
   isFarmDeploymentMismatchResponse,

package/dist/deployment.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/deployment.ts"],"sourcesContent":["export const FARM_DEPLOYMENT_ID_HEADER = \"x-farm-deployment-id\";\nexport const FARM_DEPLOYMENT_MISMATCH_HEADER = \"x-farm-deployment-mismatch\";\nexport const FARM_DEPLOYMENT_COOKIE = \"__farm_deployment\";\nexport const FARM_DEPLOYMENT_MISMATCH_CODE = \"FARM_DEPLOYMENT_MISMATCH\";\nexport const FARM_DEPLOYMENT_MISMATCH_STATUS = 409;\n\nexport interface FarmDeploymentMismatch {\n  clientDeploymentId: string;\n  serverDeploymentId: string;\n}\n\nexport interface FarmDeploymentResponseOptions {\n  setCookie?: boolean;\n  cookiePath?: string;\n  secureCookie?: boolean;\n}\n\nexport class FarmDeploymentMismatchError extends Error {\n  readonly name = \"FarmDeploymentMismatchError\";\n  readonly code = FARM_DEPLOYMENT_MISMATCH_CODE;\n  readonly retryable = false;\n\n  constructor(\n    readonly clientDeploymentId: string,\n    readonly serverDeploymentId: string,\n  ) {\n    super(\"The application was updated while this page was open. Refresh before trying again.\");\n  }\n}\n\nexport function normalizeFarmDeploymentId(value: unknown): string {\n  if (typeof value !== \"string\" || value.trim() === \"\") {\n    throw new TypeError(\"Farm deploymentId must be a non-empty string\");\n  }\n\n  const normalized = value.trim();\n  if (normalized.length > 200 || /[\\u0000-\\u001f\\u007f]/.test(normalized)) {\n    throw new TypeError(\"Farm deploymentId must be at most 200 characters without control bytes\");\n  }\n\n  return normalized;\n}\n\nexport function createFarmDeploymentRequestHeaders(\n  deploymentId: string | undefined,\n  init?: HeadersInit,\n): Headers {\n  const headers = new Headers(init);\n  if (deploymentId) {\n    headers.set(FARM_DEPLOYMENT_ID_HEADER, deploymentId);\n  }\n  return headers;\n}\n\nexport function getFarmRequestDeploymentId(\n  request: Pick<Request, \"headers\" | \"method\">,\n): string | undefined {\n  const headerValue = request.headers.get(FARM_DEPLOYMENT_ID_HEADER)?.trim();\n  if (headerValue) return headerValue;\n\n  if (isSafeRequestMethod(request.method)) return undefined;\n  return readCookie(request.headers.get(\"cookie\"), FARM_DEPLOYMENT_COOKIE);\n}\n\nexport function getFarmDeploymentMismatch(\n  request: Pick<Request, \"headers\" | \"method\">,\n  serverDeploymentId: string | undefined,\n): FarmDeploymentMismatch | null {\n  if (!serverDeploymentId) return null;\n\n  const clientDeploymentId = getFarmRequestDeploymentId(request);\n  if (!clientDeploymentId || clientDeploymentId === serverDeploymentId) return null;\n\n  return { clientDeploymentId, serverDeploymentId };\n}\n\nexport function createFarmDeploymentMismatchResponse(mismatch: FarmDeploymentMismatch): Response {\n  return new Response(\n    JSON.stringify({\n      error: FARM_DEPLOYMENT_MISMATCH_CODE,\n      message: \"The application deployment changed. Refresh before retrying this request.\",\n    }),\n    {\n      status: FARM_DEPLOYMENT_MISMATCH_STATUS,\n      headers: {\n        \"Cache-Control\": \"no-store\",\n        \"Content-Type\": \"application/json; charset=utf-8\",\n        [FARM_DEPLOYMENT_ID_HEADER]: mismatch.serverDeploymentId,\n        [FARM_DEPLOYMENT_MISMATCH_HEADER]: \"1\",\n      },\n    },\n  );\n}\n\nexport function withFarmDeploymentResponse(\n  response: Response,\n  deploymentId: string | undefined,\n  options: FarmDeploymentResponseOptions = {},\n): Response {\n  if (!deploymentId) return response;\n\n  const headers = new Headers(response.headers);\n  headers.set(FARM_DEPLOYMENT_ID_HEADER, deploymentId);\n  if (options.setCookie) {\n    headers.append(\n      \"Set-Cookie\",\n      createFarmDeploymentCookie(\n        deploymentId,\n        options.cookiePath ?? \"/\",\n        options.secureCookie ?? false,\n      ),\n    );\n  }\n\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\nexport function getFarmResponseDeploymentId(\n  response: Pick<Response, \"headers\">,\n): string | undefined {\n  return response.headers.get(FARM_DEPLOYMENT_ID_HEADER)?.trim() || undefined;\n}\n\nexport function isFarmDeploymentMismatchResponse(\n  response: Pick<Response, \"headers\" | \"status\">,\n  clientDeploymentId: string | undefined,\n): boolean {\n  const serverDeploymentId = getFarmResponseDeploymentId(response);\n  if (clientDeploymentId && serverDeploymentId && clientDeploymentId !== serverDeploymentId) {\n    return true;\n  }\n\n  return (\n    response.status === FARM_DEPLOYMENT_MISMATCH_STATUS &&\n    response.headers.get(FARM_DEPLOYMENT_MISMATCH_HEADER) === \"1\"\n  );\n}\n\nexport function createFarmDeploymentMismatchError(\n  response: Pick<Response, \"headers\">,\n  clientDeploymentId: string,\n): FarmDeploymentMismatchError {\n  return new FarmDeploymentMismatchError(\n    clientDeploymentId,\n    getFarmResponseDeploymentId(response) || \"unknown\",\n  );\n}\n\nexport function createFarmDeploymentCookie(\n  deploymentId: string,\n  path = \"/\",\n  secure = false,\n): string {\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return [\n    `${FARM_DEPLOYMENT_COOKIE}=${encodeURIComponent(deploymentId)}`,\n    `Path=${normalizedPath}`,\n    \"HttpOnly\",\n    \"SameSite=Lax\",\n    secure ? \"Secure\" : \"\",\n  ]\n    .filter(Boolean)\n    .join(\"; \");\n}\n\nfunction readCookie(cookieHeader: string | null, name: string): string | undefined {\n  if (!cookieHeader) return undefined;\n\n  for (const part of cookieHeader.split(\";\")) {\n    const separator = part.indexOf(\"=\");\n    if (separator === -1 || part.slice(0, separator).trim() !== name) continue;\n\n    const value = part.slice(separator + 1).trim();\n    try {\n      return decodeURIComponent(value);\n    } catch {\n      return value;\n    }\n  }\n\n  return undefined;\n}\n\nfunction isSafeRequestMethod(method: string): boolean {\n  return [\"GET\", \"HEAD\", \"OPTIONS\"].includes(method.toUpperCase());\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/deployment.ts"],"sourcesContent":["export const FARM_DEPLOYMENT_ID_HEADER = \"x-farm-deployment-id\";\nexport const FARM_DEPLOYMENT_MISMATCH_HEADER = \"x-farm-deployment-mismatch\";\nexport const FARM_DEPLOYMENT_COOKIE = \"__farm_deployment\";\nexport const FARM_DEPLOYMENT_MISMATCH_CODE = \"FARM_DEPLOYMENT_MISMATCH\";\nexport const FARM_DEPLOYMENT_MISMATCH_STATUS = 409;\n\nexport type FarmPresetRuntime = \"node\" | \"edge\" | \"unknown\";\n\nexport function getFarmPresetRuntime(preset: string): FarmPresetRuntime {\n  if (\n    preset === \"cloudflare\" ||\n    preset === \"cloudflare-pages\" ||\n    preset === \"cloudflare-module\" ||\n    preset === \"netlify-edge\" ||\n    preset === \"vercel-edge\" ||\n    preset === \"deno\"\n  ) {\n    return \"edge\";\n  }\n\n  if (\n    preset === \"node-server\" ||\n    preset === \"vercel\" ||\n    preset === \"netlify\" ||\n    preset === \"aws-lambda\" ||\n    preset === \"azure\" ||\n    preset === \"firebase\" ||\n    preset === \"bun\" ||\n    preset === \"self-host\" ||\n    preset === \"farm\"\n  ) {\n    return \"node\";\n  }\n\n  return \"unknown\";\n}\n\nexport interface FarmDeploymentMismatch {\n  clientDeploymentId: string;\n  serverDeploymentId: string;\n}\n\nexport interface FarmDeploymentResponseOptions {\n  setCookie?: boolean;\n  cookiePath?: string;\n  secureCookie?: boolean;\n}\n\nexport class FarmDeploymentMismatchError extends Error {\n  readonly name = \"FarmDeploymentMismatchError\";\n  readonly code = FARM_DEPLOYMENT_MISMATCH_CODE;\n  readonly retryable = false;\n\n  constructor(\n    readonly clientDeploymentId: string,\n    readonly serverDeploymentId: string,\n  ) {\n    super(\"The application was updated while this page was open. Refresh before trying again.\");\n  }\n}\n\nexport function normalizeFarmDeploymentId(value: unknown): string {\n  if (typeof value !== \"string\" || value.trim() === \"\") {\n    throw new TypeError(\"Farm deploymentId must be a non-empty string\");\n  }\n\n  const normalized = value.trim();\n  if (normalized.length > 200 || /[\\u0000-\\u001f\\u007f]/.test(normalized)) {\n    throw new TypeError(\"Farm deploymentId must be at most 200 characters without control bytes\");\n  }\n\n  return normalized;\n}\n\nexport function createFarmDeploymentRequestHeaders(\n  deploymentId: string | undefined,\n  init?: HeadersInit,\n): Headers {\n  const headers = new Headers(init);\n  if (deploymentId) {\n    headers.set(FARM_DEPLOYMENT_ID_HEADER, deploymentId);\n  }\n  return headers;\n}\n\nexport function getFarmRequestDeploymentId(\n  request: Pick<Request, \"headers\" | \"method\">,\n): string | undefined {\n  const headerValue = request.headers.get(FARM_DEPLOYMENT_ID_HEADER)?.trim();\n  if (headerValue) return headerValue;\n\n  if (isSafeRequestMethod(request.method)) return undefined;\n  return readCookie(request.headers.get(\"cookie\"), FARM_DEPLOYMENT_COOKIE);\n}\n\nexport function getFarmDeploymentMismatch(\n  request: Pick<Request, \"headers\" | \"method\">,\n  serverDeploymentId: string | undefined,\n): FarmDeploymentMismatch | null {\n  if (!serverDeploymentId) return null;\n\n  const clientDeploymentId = getFarmRequestDeploymentId(request);\n  if (!clientDeploymentId || clientDeploymentId === serverDeploymentId) return null;\n\n  return { clientDeploymentId, serverDeploymentId };\n}\n\nexport function createFarmDeploymentMismatchResponse(mismatch: FarmDeploymentMismatch): Response {\n  return new Response(\n    JSON.stringify({\n      error: FARM_DEPLOYMENT_MISMATCH_CODE,\n      message: \"The application deployment changed. Refresh before retrying this request.\",\n    }),\n    {\n      status: FARM_DEPLOYMENT_MISMATCH_STATUS,\n      headers: {\n        \"Cache-Control\": \"no-store\",\n        \"Content-Type\": \"application/json; charset=utf-8\",\n        [FARM_DEPLOYMENT_ID_HEADER]: mismatch.serverDeploymentId,\n        [FARM_DEPLOYMENT_MISMATCH_HEADER]: \"1\",\n      },\n    },\n  );\n}\n\nexport function withFarmDeploymentResponse(\n  response: Response,\n  deploymentId: string | undefined,\n  options: FarmDeploymentResponseOptions = {},\n): Response {\n  if (!deploymentId) return response;\n\n  const headers = new Headers(response.headers);\n  headers.set(FARM_DEPLOYMENT_ID_HEADER, deploymentId);\n  if (options.setCookie) {\n    headers.append(\n      \"Set-Cookie\",\n      createFarmDeploymentCookie(\n        deploymentId,\n        options.cookiePath ?? \"/\",\n        options.secureCookie ?? false,\n      ),\n    );\n  }\n\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\nexport function getFarmResponseDeploymentId(\n  response: Pick<Response, \"headers\">,\n): string | undefined {\n  return response.headers.get(FARM_DEPLOYMENT_ID_HEADER)?.trim() || undefined;\n}\n\nexport function isFarmDeploymentMismatchResponse(\n  response: Pick<Response, \"headers\" | \"status\">,\n  clientDeploymentId: string | undefined,\n): boolean {\n  const serverDeploymentId = getFarmResponseDeploymentId(response);\n  if (clientDeploymentId && serverDeploymentId && clientDeploymentId !== serverDeploymentId) {\n    return true;\n  }\n\n  return (\n    response.status === FARM_DEPLOYMENT_MISMATCH_STATUS &&\n    response.headers.get(FARM_DEPLOYMENT_MISMATCH_HEADER) === \"1\"\n  );\n}\n\nexport function createFarmDeploymentMismatchError(\n  response: Pick<Response, \"headers\">,\n  clientDeploymentId: string,\n): FarmDeploymentMismatchError {\n  return new FarmDeploymentMismatchError(\n    clientDeploymentId,\n    getFarmResponseDeploymentId(response) || \"unknown\",\n  );\n}\n\nexport function createFarmDeploymentCookie(\n  deploymentId: string,\n  path = \"/\",\n  secure = false,\n): string {\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return [\n    `${FARM_DEPLOYMENT_COOKIE}=${encodeURIComponent(deploymentId)}`,\n    `Path=${normalizedPath}`,\n    \"HttpOnly\",\n    \"SameSite=Lax\",\n    secure ? \"Secure\" : \"\",\n  ]\n    .filter(Boolean)\n    .join(\"; \");\n}\n\nfunction readCookie(cookieHeader: string | null, name: string): string | undefined {\n  if (!cookieHeader) return undefined;\n\n  for (const part of cookieHeader.split(\";\")) {\n    const separator = part.indexOf(\"=\");\n    if (separator === -1 || part.slice(0, separator).trim() !== name) continue;\n\n    const value = part.slice(separator + 1).trim();\n    try {\n      return decodeURIComponent(value);\n    } catch {\n      return value;\n    }\n  }\n\n  return undefined;\n}\n\nfunction isSafeRequestMethod(method: string): boolean {\n  return [\"GET\", \"HEAD\", \"OPTIONS\"].includes(method.toUpperCase());\n}\n"],"mappings":"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","names":[]}

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

@@ -10,12 +10,13 @@ import {
   createFarmDeploymentMismatchResponse,
   createFarmDeploymentRequestHeaders,
   getFarmDeploymentMismatch,
+  getFarmPresetRuntime,
   getFarmRequestDeploymentId,
   getFarmResponseDeploymentId,
   isFarmDeploymentMismatchResponse,
   normalizeFarmDeploymentId,
   withFarmDeploymentResponse
-} from "./chunk-B232I2GP.mjs";
+} from "./chunk-3HIVDX7J.mjs";
 import "./chunk-CGILA3WO.mjs";
 export {
   FARM_DEPLOYMENT_COOKIE,
@@ -29,6 +30,7 @@ export {
   createFarmDeploymentMismatchResponse,
   createFarmDeploymentRequestHeaders,
   getFarmDeploymentMismatch,
+  getFarmPresetRuntime,
   getFarmRequestDeploymentId,
   getFarmResponseDeploymentId,
   isFarmDeploymentMismatchResponse,

package/dist/{devtools-GAZ7F3KL.mjs → devtools-K2ERKGNI.mjs}

@@ -1,15 +1,15 @@
 import {
   getDeployTargetForPreset
-} from "./chunk-L2PE36GQ.mjs";
+} from "./chunk-PZXBQKCH.mjs";
 import "./chunk-UVCIEUJC.mjs";
 import "./chunk-RQ633A5I.mjs";
-import "./chunk-I4CUBGVF.mjs";
+import "./chunk-E257KFBU.mjs";
 import "./chunk-7MABZJIM.mjs";
 import "./chunk-YW7OBE6Q.mjs";
 import "./chunk-74YTBPTY.mjs";
 import "./chunk-7ZVN3YZI.mjs";
 import "./chunk-GY2STC2S.mjs";
-import "./chunk-UB5UOSHB.mjs";
+import "./chunk-ZVMV3THA.mjs";
 import "./chunk-ZVWA4ZQ3.mjs";
 import "./chunk-7FBJLMQH.mjs";
 import "./chunk-XIVV5IWN.mjs";
@@ -24,7 +24,7 @@ import {
   resolveFarmRouteRuleRuntimeConfig,
   resolveFarmRouteRuntimeConfig
 } from "./chunk-GQVGIUSN.mjs";
-import "./chunk-B232I2GP.mjs";
+import "./chunk-3HIVDX7J.mjs";
 import "./chunk-JK25YEN6.mjs";
 import "./chunk-RBRLLZL5.mjs";
 import {
@@ -369,4 +369,4 @@ __name(createFarmDevtoolsSnapshot, "createFarmDevtoolsSnapshot");
 export {
   createFarmDevtoolsSnapshot
 };
-//# sourceMappingURL=devtools-GAZ7F3KL.mjs.map
+//# sourceMappingURL=devtools-K2ERKGNI.mjs.map