@farm.js/core 0.1.0-beta.0

package/dist/testing.d.ts

@@ -0,0 +1,100 @@
+import { ReactElement } from 'react';
+import './types-BH1lhg5G.js';
+import { APIRouteParams } from './api/runtime.js';
+import { ProgrammaticPageRoute, InferProgrammaticRouteData, ProgrammaticRouteComponentProps, ProgrammaticApiRoute } from './routes.js';
+import { FarmRouterQueryValue, FarmRouterPathParams } from './router.js';
+import { ServerFn } from './server-fn.js';
+import { g as FarmContextFactory, M as MiddlewareProps, P as PluginContextProps, p as RouteModule } from './client-plugins-BZnpeTGA.js';
+import './route-runtime-DoOHzCAD.js';
+import './cache.js';
+import './plugin-BJDf43dc.js';
+import 'http';
+import './types-D1A6-XvH.js';
+import 'db0';
+import 'unstorage';
+import './integration-api-CHT2OKAf.js';
+import '@farming-labs/orm';
+import './types-C9N-nk5R.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 './image-config-Duob7wER.js';
+
+type FarmTestQuery = URLSearchParams | Record<string, FarmRouterQueryValue>;
+type FarmTestPathParams = FarmRouterPathParams;
+type FarmTestFormValues = Record<string, FormDataEntryValue | readonly FormDataEntryValue[]>;
+interface FarmTestRequestOptions extends Omit<RequestInit, "body" | "headers"> {
+    origin?: string;
+    headers?: HeadersInit;
+    query?: FarmTestQuery;
+    cookies?: Record<string, string>;
+    json?: unknown;
+    form?: FormData | FarmTestFormValues;
+    body?: BodyInit | null;
+}
+interface FarmTestHarnessOptions<TContext = unknown> {
+    origin?: string;
+    headers?: HeadersInit;
+    cookies?: Record<string, string>;
+    context?: FarmContextFactory<TContext>;
+}
+type AnyProgrammaticPageRoute = ProgrammaticPageRoute<any, any, any, any>;
+type InferFarmTestRouteParams<TRoute> = TRoute extends ProgrammaticPageRoute<infer TParams, any, any, any> ? TParams : never;
+type InferFarmTestRouteSearch<TRoute> = TRoute extends ProgrammaticPageRoute<any, infer TSearch, any, any> ? TSearch : never;
+type InferFarmTestRouteData<TRoute> = TRoute extends ProgrammaticPageRoute<any, any, infer TDataHooks, any> ? InferProgrammaticRouteData<TDataHooks> : never;
+type FarmTestRouteProps<TRoute extends AnyProgrammaticPageRoute> = ProgrammaticRouteComponentProps<InferFarmTestRouteParams<TRoute>, InferFarmTestRouteSearch<TRoute>, InferFarmTestRouteData<TRoute>>;
+type FarmTestRouteParamsInput<TRoute> = InferFarmTestRouteParams<TRoute> extends Record<string, unknown> ? Partial<InferFarmTestRouteParams<TRoute>> : FarmTestPathParams;
+type FarmTestRouteSearchInput<TRoute> = InferFarmTestRouteSearch<TRoute> extends Record<string, unknown> ? Partial<InferFarmTestRouteSearch<TRoute>> | URLSearchParams : FarmTestQuery;
+interface FarmTestRouteOptions<TRoute extends AnyProgrammaticPageRoute, TContext = unknown> extends Pick<FarmTestRequestOptions, "origin" | "headers" | "cookies" | "signal"> {
+    path?: string | URL;
+    params?: FarmTestRouteParamsInput<TRoute>;
+    search?: FarmTestRouteSearchInput<TRoute>;
+    context?: TContext;
+    middleware?: MiddlewareProps;
+    pluginContext?: PluginContextProps;
+}
+interface FarmTestRouteResult<TRoute extends AnyProgrammaticPageRoute> {
+    route: TRoute;
+    module: RouteModule;
+    request: Request;
+    props: FarmTestRouteProps<TRoute>;
+    element: ReactElement;
+    canonicalPath?: string;
+}
+interface FarmTestApiOptions extends FarmTestRequestOptions {
+    path?: string | URL;
+    params?: FarmTestPathParams;
+    throwOnError?: boolean;
+}
+interface FarmTestEndpointOptions extends FarmTestRequestOptions {
+    path?: string | URL;
+    params?: APIRouteParams;
+    throwOnError?: boolean;
+}
+interface FarmTestServerFnOptions extends Pick<FarmTestRequestOptions, "origin" | "headers" | "cookies" | "signal"> {
+    path?: string | URL;
+    request?: Request;
+}
+type FarmTestServerFnArguments<TInput> = [unknown] extends [TInput] ? [input?: TInput | FormData, options?: FarmTestServerFnOptions] : [input: TInput | FormData, options?: FarmTestServerFnOptions];
+interface FarmTestHarness<TContext = unknown> {
+    request(path?: string | URL, options?: FarmTestRequestOptions): Request;
+    route<TRoute extends AnyProgrammaticPageRoute>(route: TRoute, options?: FarmTestRouteOptions<TRoute, TContext>): Promise<FarmTestRouteResult<TRoute>>;
+    api(route: ProgrammaticApiRoute, options?: FarmTestApiOptions): Promise<Response>;
+    endpoint(endpoint: unknown, options?: FarmTestEndpointOptions): Promise<Response>;
+    serverFn<TInput, TResult>(serverFn: ServerFn<TInput, TResult>, ...args: FarmTestServerFnArguments<TInput>): Promise<TResult>;
+    clearCache(): void;
+}
+/** Create a deterministic Web Request without depending on a test runner. */
+declare function createTestRequest(path?: string | URL, options?: FarmTestRequestOptions): Request;
+/**
+ * Create test helpers that exercise Farm's real route, API, and server-function runtimes.
+ * The harness has no dependency on Vitest, Jest, or a DOM environment.
+ */
+declare function createFarmTestHarness<TContext = unknown>(options?: FarmTestHarnessOptions<TContext>): FarmTestHarness<TContext>;
+
+export { type FarmTestApiOptions, type FarmTestEndpointOptions, type FarmTestFormValues, type FarmTestHarness, type FarmTestHarnessOptions, type FarmTestPathParams, type FarmTestQuery, type FarmTestRequestOptions, type FarmTestRouteOptions, type FarmTestRouteProps, type FarmTestRouteResult, type FarmTestServerFnArguments, type FarmTestServerFnOptions, type InferFarmTestRouteData, type InferFarmTestRouteParams, type InferFarmTestRouteSearch, createFarmTestHarness, createTestRequest };

package/dist/testing.mjs

@@ -0,0 +1,324 @@
+import {
+  runWithServerActionRequest
+} from "./chunk-AGS7UJ52.mjs";
+import "./chunk-YHU7SS6L.mjs";
+import "./chunk-QF4PHCMA.mjs";
+import "./chunk-GN72QAIH.mjs";
+import "./chunk-FQYDHKKU.mjs";
+import "./chunk-J4FNJ5IU.mjs";
+import {
+  invokeAPIRouteEndpoint,
+  matchAPIRoute
+} from "./chunk-EVGBEZDF.mjs";
+import "./chunk-RHIFZZUI.mjs";
+import "./chunk-LM2YNO4U.mjs";
+import {
+  createRouteModuleFromProgrammaticPage
+} from "./chunk-B6N4ZB2H.mjs";
+import {
+  resolveFarmRouteContext,
+  withFarmRouteContext
+} from "./chunk-QKVUNGAH.mjs";
+import "./chunk-QM6VV26B.mjs";
+import "./chunk-44ZCFSKE.mjs";
+import {
+  buildFarmRoutePath,
+  matchFarmRoute
+} from "./chunk-ZBE6MLHL.mjs";
+import {
+  getFarmDataCache
+} from "./chunk-4PTK6KT4.mjs";
+import "./chunk-TXCFGOHW.mjs";
+import "./chunk-WZ5QFROO.mjs";
+import "./chunk-7ZY5AIJO.mjs";
+import {
+  __name
+} from "./chunk-CGILA3WO.mjs";
+
+// src/testing.ts
+import { createElement } from "react";
+function createTestRequest(path = "/", options = {}) {
+  const url = resolveTestURL(path, options.origin);
+  applyQuery(url.searchParams, options.query);
+  const headers = new Headers(options.headers);
+  applyCookies(headers, options.cookies);
+  const { body, hasBody } = resolveRequestBody(options, headers);
+  const method = (options.method ?? (hasBody ? "POST" : "GET")).toUpperCase();
+  if ((method === "GET" || method === "HEAD") && body != null) {
+    throw new TypeError(`Farm test requests cannot send a body with ${method}`);
+  }
+  const {
+    origin: _origin,
+    query: _query,
+    cookies: _cookies,
+    json: _json,
+    form: _form,
+    body: _body,
+    headers: _headers,
+    ...requestInit
+  } = options;
+  return new Request(url, {
+    ...requestInit,
+    method,
+    headers,
+    body
+  });
+}
+__name(createTestRequest, "createTestRequest");
+function createFarmTestHarness(options = {}) {
+  const origin = normalizeOrigin(options.origin);
+  const request = /* @__PURE__ */ __name((path = "/", requestOptions = {}) => createTestRequest(path, mergeRequestDefaults(options, origin, requestOptions)), "request");
+  return {
+    request,
+    async route(route, routeOptions = {}) {
+      const requestPath = routeOptions.path ?? buildFarmRoutePath(route.path, routeOptions.params ?? {});
+      const routeRequest = request(requestPath, {
+        origin: routeOptions.origin,
+        headers: routeOptions.headers,
+        cookies: routeOptions.cookies,
+        signal: routeOptions.signal,
+        query: routeOptions.search
+      });
+      const url = new URL(routeRequest.url);
+      const params = resolvePageParams(route.path, url.pathname, routeOptions.params);
+      const search = readSearchParams(url.searchParams);
+      const routeContext = Object.prototype.hasOwnProperty.call(routeOptions, "context") ? routeOptions.context : await resolveFarmRouteContext(
+        { context: options.context },
+        {
+          request: routeRequest,
+          params,
+          search,
+          path: url.pathname
+        }
+      );
+      const rawProps = withFarmRouteContext(
+        {
+          params,
+          searchParams: Promise.resolve(search),
+          path: url.pathname,
+          middleware: routeOptions.middleware,
+          context: routeOptions.pluginContext
+        },
+        routeContext
+      );
+      const routeModule = createRouteModuleFromProgrammaticPage(route);
+      const resolveProps = routeModule.__farmResolveRouteProps;
+      const resolvedProps = resolveProps ? await resolveProps(rawProps) : { ...rawProps, search, searchParams: Promise.resolve(search) };
+      const canonicalPath = readCanonicalPath(resolvedProps);
+      const componentProps = stripInternalRouteProps(resolvedProps);
+      return {
+        route,
+        module: routeModule,
+        request: routeRequest,
+        props: componentProps,
+        element: createElement(route.component, componentProps),
+        canonicalPath
+      };
+    },
+    async api(route, apiOptions = {}) {
+      const requestPath = apiOptions.path ?? buildFarmRoutePath(route.path, apiOptions.params ?? {});
+      const method = apiOptions.method ?? getDefaultApiMethod(route);
+      const apiRequest = request(requestPath, omitApiControlOptions({ ...apiOptions, method }));
+      const match = matchAPIRoute(/* @__PURE__ */ new Map([[route.path, route]]), new URL(apiRequest.url).pathname);
+      if (!match) {
+        return jsonErrorResponse("Not Found", 404);
+      }
+      const endpoint = match.route.methods[apiRequest.method];
+      if (!endpoint) {
+        return jsonErrorResponse("Method Not Allowed", 405);
+      }
+      return invokeTestEndpoint(endpoint, apiRequest, match.params, apiOptions.throwOnError);
+    },
+    async endpoint(endpoint, endpointOptions = {}) {
+      const endpointRecord = endpoint;
+      const endpointPath = endpointOptions.path ?? endpointRecord.__path ?? "/__farm/test/endpoint";
+      const endpointRequest = request(endpointPath, {
+        ...omitEndpointControlOptions(endpointOptions),
+        method: endpointOptions.method ?? endpointRecord.__method ?? "GET"
+      });
+      return invokeTestEndpoint(
+        endpoint,
+        endpointRequest,
+        endpointOptions.params,
+        endpointOptions.throwOnError
+      );
+    },
+    async serverFn(serverFn, ...args) {
+      const [input, serverFnOptions = {}] = args;
+      const actionRequest = serverFnOptions.request ?? request(serverFnOptions.path ?? "/__farm/test/server-fn", {
+        origin: serverFnOptions.origin,
+        headers: serverFnOptions.headers,
+        cookies: serverFnOptions.cookies,
+        signal: serverFnOptions.signal,
+        method: "POST"
+      });
+      return await runWithServerActionRequest(actionRequest, () => serverFn(input));
+    },
+    clearCache() {
+      getFarmDataCache().clear();
+    }
+  };
+}
+__name(createFarmTestHarness, "createFarmTestHarness");
+function resolveTestURL(path, origin) {
+  const url = path instanceof URL ? new URL(path) : new URL(path, `${normalizeOrigin(origin)}/`);
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new TypeError(`Farm test requests require an HTTP(S) URL, received ${url.protocol}`);
+  }
+  return url;
+}
+__name(resolveTestURL, "resolveTestURL");
+function normalizeOrigin(origin = "http://farm.test") {
+  let url;
+  try {
+    url = new URL(origin);
+  } catch {
+    throw new TypeError(`Invalid Farm test origin: ${JSON.stringify(origin)}`);
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new TypeError(`Farm test origins must use HTTP(S), received ${url.protocol}`);
+  }
+  return url.origin;
+}
+__name(normalizeOrigin, "normalizeOrigin");
+function mergeRequestDefaults(harnessOptions, origin, requestOptions) {
+  const headers = new Headers(harnessOptions.headers);
+  new Headers(requestOptions.headers).forEach((value, key) => headers.set(key, value));
+  return {
+    ...requestOptions,
+    origin: requestOptions.origin ?? origin,
+    headers,
+    cookies: {
+      ...harnessOptions.cookies,
+      ...requestOptions.cookies
+    }
+  };
+}
+__name(mergeRequestDefaults, "mergeRequestDefaults");
+function applyQuery(searchParams, query) {
+  if (!query) return;
+  if (query instanceof URLSearchParams) {
+    for (const key of new Set(query.keys())) {
+      searchParams.delete(key);
+      for (const value of query.getAll(key)) searchParams.append(key, value);
+    }
+    return;
+  }
+  for (const [key, rawValue] of Object.entries(query)) {
+    searchParams.delete(key);
+    const values = Array.isArray(rawValue) ? rawValue : [rawValue];
+    for (const value of values) {
+      if (value == null) continue;
+      if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
+        throw new TypeError(`Invalid query value for ${JSON.stringify(key)}`);
+      }
+      searchParams.append(key, String(value));
+    }
+  }
+}
+__name(applyQuery, "applyQuery");
+function applyCookies(headers, cookies) {
+  if (!cookies || Object.keys(cookies).length === 0) return;
+  const value = Object.entries(cookies).map(([name, cookieValue]) => `${encodeURIComponent(name)}=${encodeURIComponent(cookieValue)}`).join("; ");
+  const current = headers.get("cookie");
+  headers.set("cookie", current ? `${current}; ${value}` : value);
+}
+__name(applyCookies, "applyCookies");
+function resolveRequestBody(options, headers) {
+  const sources = [
+    options.json !== void 0,
+    options.form !== void 0,
+    options.body !== void 0
+  ];
+  if (sources.filter(Boolean).length > 1) {
+    throw new TypeError("Farm test requests accept only one of json, form, or body");
+  }
+  if (options.json !== void 0) {
+    if (!headers.has("content-type")) headers.set("content-type", "application/json");
+    return { body: JSON.stringify(options.json), hasBody: true };
+  }
+  if (options.form !== void 0) {
+    const formData = options.form instanceof FormData ? options.form : createFormData(options.form);
+    return { body: formData, hasBody: true };
+  }
+  return {
+    body: options.body ?? null,
+    hasBody: options.body !== void 0
+  };
+}
+__name(resolveRequestBody, "resolveRequestBody");
+function createFormData(values) {
+  const formData = new FormData();
+  for (const [key, rawValue] of Object.entries(values)) {
+    const entries = Array.isArray(rawValue) ? rawValue : [rawValue];
+    for (const value of entries) formData.append(key, value);
+  }
+  return formData;
+}
+__name(createFormData, "createFormData");
+function resolvePageParams(pattern, pathname, explicitParams) {
+  const matchedParams = matchFarmRoute(pattern, pathname);
+  if (!matchedParams) {
+    throw new Error(
+      `Path ${JSON.stringify(pathname)} does not match route ${JSON.stringify(pattern)}`
+    );
+  }
+  if (!explicitParams) return matchedParams;
+  return Object.fromEntries(
+    Object.entries(explicitParams).map(([key, value]) => [
+      key,
+      Array.isArray(value) ? value.map(String).join("/") : String(value)
+    ])
+  );
+}
+__name(resolvePageParams, "resolvePageParams");
+function readSearchParams(searchParams) {
+  const search = {};
+  searchParams.forEach((value, key) => {
+    search[key] = value;
+  });
+  return search;
+}
+__name(readSearchParams, "readSearchParams");
+function readCanonicalPath(props) {
+  return typeof props.__farmCanonicalPath === "string" ? props.__farmCanonicalPath : void 0;
+}
+__name(readCanonicalPath, "readCanonicalPath");
+function stripInternalRouteProps(props) {
+  const { __farmRoutePropsResolved, __farmCanonicalPath, ...componentProps } = props;
+  return componentProps;
+}
+__name(stripInternalRouteProps, "stripInternalRouteProps");
+function getDefaultApiMethod(route) {
+  if (route.methods.GET) return "GET";
+  return Object.keys(route.methods)[0] ?? "GET";
+}
+__name(getDefaultApiMethod, "getDefaultApiMethod");
+function omitApiControlOptions(options) {
+  const { path: _path, params: _params, throwOnError: _throwOnError, ...requestOptions } = options;
+  return requestOptions;
+}
+__name(omitApiControlOptions, "omitApiControlOptions");
+function omitEndpointControlOptions(options) {
+  const { path: _path, params: _params, throwOnError: _throwOnError, ...requestOptions } = options;
+  return requestOptions;
+}
+__name(omitEndpointControlOptions, "omitEndpointControlOptions");
+async function invokeTestEndpoint(endpoint, request, params = {}, throwOnError = false) {
+  try {
+    return await invokeAPIRouteEndpoint(endpoint, request, params);
+  } catch (error) {
+    if (throwOnError) throw error;
+    return jsonErrorResponse(error instanceof Error ? error.message : "Internal Server Error", 500);
+  }
+}
+__name(invokeTestEndpoint, "invokeTestEndpoint");
+function jsonErrorResponse(error, status) {
+  return Response.json({ error }, { status });
+}
+__name(jsonErrorResponse, "jsonErrorResponse");
+export {
+  createFarmTestHarness,
+  createTestRequest
+};
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"sourcesContent":["import { createElement, type ReactElement } from \"react\";\nimport { invokeAPIRouteEndpoint, matchAPIRoute, type APIRouteParams } from \"./api/route-manager\";\nimport { getFarmDataCache } from \"./cache\";\nimport { resolveFarmRouteContext, withFarmRouteContext } from \"./route-context\";\nimport {\n  createRouteModuleFromProgrammaticPage,\n  type InferProgrammaticRouteData,\n  type ProgrammaticApiRoute,\n  type ProgrammaticPageRoute,\n  type ProgrammaticRouteComponentProps,\n  type ProgrammaticRouteMethod,\n} from \"./routes\";\nimport {\n  buildFarmRoutePath,\n  matchFarmRoute,\n  type FarmRouterPathParams,\n  type FarmRouterQueryValue,\n} from \"./router\";\nimport { runWithServerActionRequest } from \"./server-action-security\";\nimport type { ServerFn } from \"./server-fn\";\nimport type { FarmContextFactory, MiddlewareProps, PluginContextProps, RouteModule } from \"./types\";\n\nexport type FarmTestQuery = URLSearchParams | Record<string, FarmRouterQueryValue>;\nexport type FarmTestPathParams = FarmRouterPathParams;\nexport type FarmTestFormValues = Record<string, FormDataEntryValue | readonly FormDataEntryValue[]>;\n\nexport interface FarmTestRequestOptions extends Omit<RequestInit, \"body\" | \"headers\"> {\n  origin?: string;\n  headers?: HeadersInit;\n  query?: FarmTestQuery;\n  cookies?: Record<string, string>;\n  json?: unknown;\n  form?: FormData | FarmTestFormValues;\n  body?: BodyInit | null;\n}\n\nexport interface FarmTestHarnessOptions<TContext = unknown> {\n  origin?: string;\n  headers?: HeadersInit;\n  cookies?: Record<string, string>;\n  context?: FarmContextFactory<TContext>;\n}\n\ntype AnyProgrammaticPageRoute = ProgrammaticPageRoute<any, any, any, any>;\n\nexport type InferFarmTestRouteParams<TRoute> =\n  TRoute extends ProgrammaticPageRoute<infer TParams, any, any, any> ? TParams : never;\n\nexport type InferFarmTestRouteSearch<TRoute> =\n  TRoute extends ProgrammaticPageRoute<any, infer TSearch, any, any> ? TSearch : never;\n\nexport type InferFarmTestRouteData<TRoute> =\n  TRoute extends ProgrammaticPageRoute<any, any, infer TDataHooks, any>\n    ? InferProgrammaticRouteData<TDataHooks>\n    : never;\n\nexport type FarmTestRouteProps<TRoute extends AnyProgrammaticPageRoute> =\n  ProgrammaticRouteComponentProps<\n    InferFarmTestRouteParams<TRoute>,\n    InferFarmTestRouteSearch<TRoute>,\n    InferFarmTestRouteData<TRoute>\n  >;\n\ntype FarmTestRouteParamsInput<TRoute> =\n  InferFarmTestRouteParams<TRoute> extends Record<string, unknown>\n    ? Partial<InferFarmTestRouteParams<TRoute>>\n    : FarmTestPathParams;\n\ntype FarmTestRouteSearchInput<TRoute> =\n  InferFarmTestRouteSearch<TRoute> extends Record<string, unknown>\n    ? Partial<InferFarmTestRouteSearch<TRoute>> | URLSearchParams\n    : FarmTestQuery;\n\nexport interface FarmTestRouteOptions<\n  TRoute extends AnyProgrammaticPageRoute,\n  TContext = unknown,\n> extends Pick<FarmTestRequestOptions, \"origin\" | \"headers\" | \"cookies\" | \"signal\"> {\n  path?: string | URL;\n  params?: FarmTestRouteParamsInput<TRoute>;\n  search?: FarmTestRouteSearchInput<TRoute>;\n  context?: TContext;\n  middleware?: MiddlewareProps;\n  pluginContext?: PluginContextProps;\n}\n\nexport interface FarmTestRouteResult<TRoute extends AnyProgrammaticPageRoute> {\n  route: TRoute;\n  module: RouteModule;\n  request: Request;\n  props: FarmTestRouteProps<TRoute>;\n  element: ReactElement;\n  canonicalPath?: string;\n}\n\nexport interface FarmTestApiOptions extends FarmTestRequestOptions {\n  path?: string | URL;\n  params?: FarmTestPathParams;\n  throwOnError?: boolean;\n}\n\nexport interface FarmTestEndpointOptions extends FarmTestRequestOptions {\n  path?: string | URL;\n  params?: APIRouteParams;\n  throwOnError?: boolean;\n}\n\nexport interface FarmTestServerFnOptions extends Pick<\n  FarmTestRequestOptions,\n  \"origin\" | \"headers\" | \"cookies\" | \"signal\"\n> {\n  path?: string | URL;\n  request?: Request;\n}\n\nexport type FarmTestServerFnArguments<TInput> = [unknown] extends [TInput]\n  ? [input?: TInput | FormData, options?: FarmTestServerFnOptions]\n  : [input: TInput | FormData, options?: FarmTestServerFnOptions];\n\nexport interface FarmTestHarness<TContext = unknown> {\n  request(path?: string | URL, options?: FarmTestRequestOptions): Request;\n  route<TRoute extends AnyProgrammaticPageRoute>(\n    route: TRoute,\n    options?: FarmTestRouteOptions<TRoute, TContext>,\n  ): Promise<FarmTestRouteResult<TRoute>>;\n  api(route: ProgrammaticApiRoute, options?: FarmTestApiOptions): Promise<Response>;\n  endpoint(endpoint: unknown, options?: FarmTestEndpointOptions): Promise<Response>;\n  serverFn<TInput, TResult>(\n    serverFn: ServerFn<TInput, TResult>,\n    ...args: FarmTestServerFnArguments<TInput>\n  ): Promise<TResult>;\n  clearCache(): void;\n}\n\n/** Create a deterministic Web Request without depending on a test runner. */\nexport function createTestRequest(\n  path: string | URL = \"/\",\n  options: FarmTestRequestOptions = {},\n): Request {\n  const url = resolveTestURL(path, options.origin);\n  applyQuery(url.searchParams, options.query);\n\n  const headers = new Headers(options.headers);\n  applyCookies(headers, options.cookies);\n  const { body, hasBody } = resolveRequestBody(options, headers);\n  const method = (options.method ?? (hasBody ? \"POST\" : \"GET\")).toUpperCase();\n\n  if ((method === \"GET\" || method === \"HEAD\") && body != null) {\n    throw new TypeError(`Farm test requests cannot send a body with ${method}`);\n  }\n\n  const {\n    origin: _origin,\n    query: _query,\n    cookies: _cookies,\n    json: _json,\n    form: _form,\n    body: _body,\n    headers: _headers,\n    ...requestInit\n  } = options;\n\n  return new Request(url, {\n    ...requestInit,\n    method,\n    headers,\n    body,\n  });\n}\n\n/**\n * Create test helpers that exercise Farm's real route, API, and server-function runtimes.\n * The harness has no dependency on Vitest, Jest, or a DOM environment.\n */\nexport function createFarmTestHarness<TContext = unknown>(\n  options: FarmTestHarnessOptions<TContext> = {},\n): FarmTestHarness<TContext> {\n  const origin = normalizeOrigin(options.origin);\n\n  const request = (path: string | URL = \"/\", requestOptions: FarmTestRequestOptions = {}) =>\n    createTestRequest(path, mergeRequestDefaults(options, origin, requestOptions));\n\n  return {\n    request,\n\n    async route<TRoute extends AnyProgrammaticPageRoute>(\n      route: TRoute,\n      routeOptions: FarmTestRouteOptions<TRoute, TContext> = {},\n    ): Promise<FarmTestRouteResult<TRoute>> {\n      const requestPath =\n        routeOptions.path ??\n        buildFarmRoutePath(route.path, (routeOptions.params ?? {}) as FarmRouterPathParams);\n      const routeRequest = request(requestPath, {\n        origin: routeOptions.origin,\n        headers: routeOptions.headers,\n        cookies: routeOptions.cookies,\n        signal: routeOptions.signal,\n        query: routeOptions.search as FarmTestQuery | undefined,\n      });\n      const url = new URL(routeRequest.url);\n      const params = resolvePageParams(route.path, url.pathname, routeOptions.params);\n      const search = readSearchParams(url.searchParams);\n      const routeContext = Object.prototype.hasOwnProperty.call(routeOptions, \"context\")\n        ? routeOptions.context\n        : await resolveFarmRouteContext(\n            { context: options.context },\n            {\n              request: routeRequest,\n              params,\n              search,\n              path: url.pathname,\n            },\n          );\n      const rawProps = withFarmRouteContext(\n        {\n          params,\n          searchParams: Promise.resolve(search),\n          path: url.pathname,\n          middleware: routeOptions.middleware,\n          context: routeOptions.pluginContext,\n        },\n        routeContext,\n      );\n      const routeModule = createRouteModuleFromProgrammaticPage(route);\n      const resolveProps = (\n        routeModule as RouteModule & {\n          __farmResolveRouteProps?: (props: typeof rawProps) => Promise<Record<string, unknown>>;\n        }\n      ).__farmResolveRouteProps;\n      const resolvedProps = resolveProps\n        ? await resolveProps(rawProps)\n        : { ...rawProps, search, searchParams: Promise.resolve(search) };\n      const canonicalPath = readCanonicalPath(resolvedProps);\n      const componentProps = stripInternalRouteProps(resolvedProps) as FarmTestRouteProps<TRoute>;\n\n      return {\n        route,\n        module: routeModule,\n        request: routeRequest,\n        props: componentProps,\n        element: createElement(route.component, componentProps),\n        canonicalPath,\n      };\n    },\n\n    async api(route, apiOptions = {}) {\n      const requestPath =\n        apiOptions.path ?? buildFarmRoutePath(route.path, apiOptions.params ?? {});\n      const method = apiOptions.method ?? getDefaultApiMethod(route);\n      const apiRequest = request(requestPath, omitApiControlOptions({ ...apiOptions, method }));\n      const match = matchAPIRoute(new Map([[route.path, route]]), new URL(apiRequest.url).pathname);\n\n      if (!match) {\n        return jsonErrorResponse(\"Not Found\", 404);\n      }\n\n      const endpoint = match.route.methods[apiRequest.method as ProgrammaticRouteMethod];\n      if (!endpoint) {\n        return jsonErrorResponse(\"Method Not Allowed\", 405);\n      }\n\n      return invokeTestEndpoint(endpoint, apiRequest, match.params, apiOptions.throwOnError);\n    },\n\n    async endpoint(endpoint, endpointOptions = {}) {\n      const endpointRecord = endpoint as { __method?: string; __path?: string };\n      const endpointPath = endpointOptions.path ?? endpointRecord.__path ?? \"/__farm/test/endpoint\";\n      const endpointRequest = request(endpointPath, {\n        ...omitEndpointControlOptions(endpointOptions),\n        method: endpointOptions.method ?? endpointRecord.__method ?? \"GET\",\n      });\n\n      return invokeTestEndpoint(\n        endpoint,\n        endpointRequest,\n        endpointOptions.params,\n        endpointOptions.throwOnError,\n      );\n    },\n\n    async serverFn<TInput, TResult>(\n      serverFn: ServerFn<TInput, TResult>,\n      ...args: FarmTestServerFnArguments<TInput>\n    ): Promise<TResult> {\n      const [input, serverFnOptions = {}] = args;\n      const actionRequest =\n        serverFnOptions.request ??\n        request(serverFnOptions.path ?? \"/__farm/test/server-fn\", {\n          origin: serverFnOptions.origin,\n          headers: serverFnOptions.headers,\n          cookies: serverFnOptions.cookies,\n          signal: serverFnOptions.signal,\n          method: \"POST\",\n        });\n\n      return await runWithServerActionRequest(actionRequest, () => serverFn(input as TInput));\n    },\n\n    clearCache() {\n      getFarmDataCache().clear();\n    },\n  };\n}\n\nfunction resolveTestURL(path: string | URL, origin: string | undefined): URL {\n  const url = path instanceof URL ? new URL(path) : new URL(path, `${normalizeOrigin(origin)}/`);\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n    throw new TypeError(`Farm test requests require an HTTP(S) URL, received ${url.protocol}`);\n  }\n  return url;\n}\n\nfunction normalizeOrigin(origin = \"http://farm.test\"): string {\n  let url: URL;\n  try {\n    url = new URL(origin);\n  } catch {\n    throw new TypeError(`Invalid Farm test origin: ${JSON.stringify(origin)}`);\n  }\n\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n    throw new TypeError(`Farm test origins must use HTTP(S), received ${url.protocol}`);\n  }\n\n  return url.origin;\n}\n\nfunction mergeRequestDefaults<TContext>(\n  harnessOptions: FarmTestHarnessOptions<TContext>,\n  origin: string,\n  requestOptions: FarmTestRequestOptions,\n): FarmTestRequestOptions {\n  const headers = new Headers(harnessOptions.headers);\n  new Headers(requestOptions.headers).forEach((value, key) => headers.set(key, value));\n\n  return {\n    ...requestOptions,\n    origin: requestOptions.origin ?? origin,\n    headers,\n    cookies: {\n      ...harnessOptions.cookies,\n      ...requestOptions.cookies,\n    },\n  };\n}\n\nfunction applyQuery(searchParams: URLSearchParams, query: FarmTestQuery | undefined): void {\n  if (!query) return;\n\n  if (query instanceof URLSearchParams) {\n    for (const key of new Set(query.keys())) {\n      searchParams.delete(key);\n      for (const value of query.getAll(key)) searchParams.append(key, value);\n    }\n    return;\n  }\n\n  for (const [key, rawValue] of Object.entries(query)) {\n    searchParams.delete(key);\n    const values = Array.isArray(rawValue) ? rawValue : [rawValue];\n    for (const value of values) {\n      if (value == null) continue;\n      if (typeof value !== \"string\" && typeof value !== \"number\" && typeof value !== \"boolean\") {\n        throw new TypeError(`Invalid query value for ${JSON.stringify(key)}`);\n      }\n      searchParams.append(key, String(value));\n    }\n  }\n}\n\nfunction applyCookies(headers: Headers, cookies: Record<string, string> | undefined): void {\n  if (!cookies || Object.keys(cookies).length === 0) return;\n\n  const value = Object.entries(cookies)\n    .map(([name, cookieValue]) => `${encodeURIComponent(name)}=${encodeURIComponent(cookieValue)}`)\n    .join(\"; \");\n  const current = headers.get(\"cookie\");\n  headers.set(\"cookie\", current ? `${current}; ${value}` : value);\n}\n\nfunction resolveRequestBody(\n  options: FarmTestRequestOptions,\n  headers: Headers,\n): { body: BodyInit | null; hasBody: boolean } {\n  const sources = [\n    options.json !== undefined,\n    options.form !== undefined,\n    options.body !== undefined,\n  ];\n  if (sources.filter(Boolean).length > 1) {\n    throw new TypeError(\"Farm test requests accept only one of json, form, or body\");\n  }\n\n  if (options.json !== undefined) {\n    if (!headers.has(\"content-type\")) headers.set(\"content-type\", \"application/json\");\n    return { body: JSON.stringify(options.json), hasBody: true };\n  }\n\n  if (options.form !== undefined) {\n    const formData = options.form instanceof FormData ? options.form : createFormData(options.form);\n    return { body: formData, hasBody: true };\n  }\n\n  return {\n    body: options.body ?? null,\n    hasBody: options.body !== undefined,\n  };\n}\n\nfunction createFormData(values: FarmTestFormValues): FormData {\n  const formData = new FormData();\n  for (const [key, rawValue] of Object.entries(values)) {\n    const entries = Array.isArray(rawValue) ? rawValue : [rawValue];\n    for (const value of entries) formData.append(key, value);\n  }\n  return formData;\n}\n\nfunction resolvePageParams(\n  pattern: string,\n  pathname: string,\n  explicitParams: Record<string, unknown> | undefined,\n): Record<string, string> {\n  const matchedParams = matchFarmRoute(pattern, pathname);\n  if (!matchedParams) {\n    throw new Error(\n      `Path ${JSON.stringify(pathname)} does not match route ${JSON.stringify(pattern)}`,\n    );\n  }\n\n  if (!explicitParams) return matchedParams;\n\n  return Object.fromEntries(\n    Object.entries(explicitParams).map(([key, value]) => [\n      key,\n      Array.isArray(value) ? value.map(String).join(\"/\") : String(value),\n    ]),\n  );\n}\n\nfunction readSearchParams(searchParams: URLSearchParams): Record<string, string> {\n  const search: Record<string, string> = {};\n  searchParams.forEach((value, key) => {\n    search[key] = value;\n  });\n  return search;\n}\n\nfunction readCanonicalPath(props: Record<string, unknown>): string | undefined {\n  return typeof props.__farmCanonicalPath === \"string\" ? props.__farmCanonicalPath : undefined;\n}\n\nfunction stripInternalRouteProps(props: Record<string, unknown>): Record<string, unknown> {\n  const { __farmRoutePropsResolved, __farmCanonicalPath, ...componentProps } = props;\n  return componentProps;\n}\n\nfunction getDefaultApiMethod(route: ProgrammaticApiRoute): ProgrammaticRouteMethod {\n  if (route.methods.GET) return \"GET\";\n  return (Object.keys(route.methods)[0] as ProgrammaticRouteMethod | undefined) ?? \"GET\";\n}\n\nfunction omitApiControlOptions(options: FarmTestApiOptions): FarmTestRequestOptions {\n  const { path: _path, params: _params, throwOnError: _throwOnError, ...requestOptions } = options;\n  return requestOptions;\n}\n\nfunction omitEndpointControlOptions(options: FarmTestEndpointOptions): FarmTestRequestOptions {\n  const { path: _path, params: _params, throwOnError: _throwOnError, ...requestOptions } = options;\n  return requestOptions;\n}\n\nasync function invokeTestEndpoint(\n  endpoint: unknown,\n  request: Request,\n  params: APIRouteParams = {},\n  throwOnError = false,\n): Promise<Response> {\n  try {\n    return await invokeAPIRouteEndpoint(endpoint, request, params);\n  } catch (error) {\n    if (throwOnError) throw error;\n    return jsonErrorResponse(error instanceof Error ? error.message : \"Internal Server Error\", 500);\n  }\n}\n\nfunction jsonErrorResponse(error: string, status: number): Response {\n  return Response.json({ error }, { status });\n}\n"],"mappings":"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","names":[]}

package/dist/types-BH1lhg5G.d.mts

@@ -0,0 +1,81 @@
+type FarmI18nRouting = "prefix-always" | "prefix-except-default" | "none";
+type FarmI18nDetectionSignal = "url" | "cookie" | "accept-language";
+type FarmI18nLocaleSource = FarmI18nDetectionSignal | "default" | "explicit";
+type FarmI18nDirection = "ltr" | "rtl";
+interface FarmI18nCookieConfig {
+    name?: string;
+    maxAge?: number;
+    path?: string;
+    sameSite?: "lax" | "strict" | "none";
+    secure?: boolean;
+}
+interface FarmI18nUserConfig {
+    locales: readonly string[];
+    defaultLocale: string;
+    /** Directory containing `<locale>.json`, or a path containing `{locale}`. */
+    messages?: string;
+    routing?: FarmI18nRouting;
+    detection?: false | readonly FarmI18nDetectionSignal[];
+    fallbackLocale?: string;
+    strict?: boolean;
+    cookie?: FarmI18nCookieConfig;
+    direction?: Partial<Record<string, FarmI18nDirection>>;
+    /** @deprecated Use `detection: false` to disable automatic detection. */
+    localeDetection?: boolean;
+}
+interface ResolvedFarmI18nCookieConfig {
+    name: string;
+    maxAge: number;
+    path: string;
+    sameSite: "lax" | "strict" | "none";
+    secure: boolean;
+}
+interface ResolvedFarmI18nConfig {
+    enabled: boolean;
+    locales: readonly string[];
+    defaultLocale: string;
+    messages: string;
+    routing: FarmI18nRouting;
+    detection: readonly FarmI18nDetectionSignal[];
+    fallbackLocale: string;
+    strict: boolean;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: Readonly<Record<string, FarmI18nDirection>>;
+}
+type FarmI18nCatalog = Record<string, string>;
+type FarmI18nCatalogs = Record<string, FarmI18nCatalog>;
+interface FarmI18nClientSnapshot {
+    locale: string;
+    source: FarmI18nLocaleSource;
+    locales: readonly string[];
+    defaultLocale: string;
+    routing: FarmI18nRouting;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: FarmI18nDirection;
+    messages: FarmI18nCatalog;
+}
+/** Generated `farm-i18n.d.ts` files augment this interface. */
+interface FarmI18nMessageRegistry {
+}
+/** Generated `farm-i18n.d.ts` files augment this interface. */
+interface FarmI18nLocaleRegistry {
+}
+type RegisteredMessageKey = Extract<keyof FarmI18nMessageRegistry, string>;
+type RegisteredLocale = Extract<keyof FarmI18nLocaleRegistry, string>;
+type FarmI18nMessageKey = [RegisteredMessageKey] extends [never] ? string : RegisteredMessageKey;
+type FarmI18nLocale = [RegisteredLocale] extends [never] ? string : RegisteredLocale;
+type FarmI18nMessageValues<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? FarmI18nMessageRegistry[TKey] : Record<string, unknown>;
+type FarmI18nMessageArgs<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? keyof FarmI18nMessageRegistry[TKey] extends never ? [values?: FarmI18nMessageRegistry[TKey]] : [values: FarmI18nMessageRegistry[TKey]] : [values?: Record<string, unknown>];
+interface FarmTranslator {
+    <TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): string;
+    rich<TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): unknown;
+    raw<TKey extends FarmI18nMessageKey>(key: TKey): string;
+    has(key: string): boolean;
+}
+declare global {
+    interface Window {
+        __FARM_I18N__?: FarmI18nClientSnapshot;
+    }
+}
+
+export type { FarmI18nCatalogs as F, ResolvedFarmI18nConfig as R, FarmI18nClientSnapshot as a, FarmI18nLocaleSource as b, FarmI18nLocale as c, FarmTranslator as d, FarmI18nMessageArgs as e, FarmI18nMessageKey as f, FarmI18nCookieConfig as g, FarmI18nDetectionSignal as h, FarmI18nDirection as i, FarmI18nRouting as j, FarmI18nUserConfig as k, FarmI18nCatalog as l, FarmI18nLocaleRegistry as m, FarmI18nMessageRegistry as n, FarmI18nMessageValues as o };

package/dist/types-BH1lhg5G.d.ts

@@ -0,0 +1,81 @@
+type FarmI18nRouting = "prefix-always" | "prefix-except-default" | "none";
+type FarmI18nDetectionSignal = "url" | "cookie" | "accept-language";
+type FarmI18nLocaleSource = FarmI18nDetectionSignal | "default" | "explicit";
+type FarmI18nDirection = "ltr" | "rtl";
+interface FarmI18nCookieConfig {
+    name?: string;
+    maxAge?: number;
+    path?: string;
+    sameSite?: "lax" | "strict" | "none";
+    secure?: boolean;
+}
+interface FarmI18nUserConfig {
+    locales: readonly string[];
+    defaultLocale: string;
+    /** Directory containing `<locale>.json`, or a path containing `{locale}`. */
+    messages?: string;
+    routing?: FarmI18nRouting;
+    detection?: false | readonly FarmI18nDetectionSignal[];
+    fallbackLocale?: string;
+    strict?: boolean;
+    cookie?: FarmI18nCookieConfig;
+    direction?: Partial<Record<string, FarmI18nDirection>>;
+    /** @deprecated Use `detection: false` to disable automatic detection. */
+    localeDetection?: boolean;
+}
+interface ResolvedFarmI18nCookieConfig {
+    name: string;
+    maxAge: number;
+    path: string;
+    sameSite: "lax" | "strict" | "none";
+    secure: boolean;
+}
+interface ResolvedFarmI18nConfig {
+    enabled: boolean;
+    locales: readonly string[];
+    defaultLocale: string;
+    messages: string;
+    routing: FarmI18nRouting;
+    detection: readonly FarmI18nDetectionSignal[];
+    fallbackLocale: string;
+    strict: boolean;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: Readonly<Record<string, FarmI18nDirection>>;
+}
+type FarmI18nCatalog = Record<string, string>;
+type FarmI18nCatalogs = Record<string, FarmI18nCatalog>;
+interface FarmI18nClientSnapshot {
+    locale: string;
+    source: FarmI18nLocaleSource;
+    locales: readonly string[];
+    defaultLocale: string;
+    routing: FarmI18nRouting;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: FarmI18nDirection;
+    messages: FarmI18nCatalog;
+}
+/** Generated `farm-i18n.d.ts` files augment this interface. */
+interface FarmI18nMessageRegistry {
+}
+/** Generated `farm-i18n.d.ts` files augment this interface. */
+interface FarmI18nLocaleRegistry {
+}
+type RegisteredMessageKey = Extract<keyof FarmI18nMessageRegistry, string>;
+type RegisteredLocale = Extract<keyof FarmI18nLocaleRegistry, string>;
+type FarmI18nMessageKey = [RegisteredMessageKey] extends [never] ? string : RegisteredMessageKey;
+type FarmI18nLocale = [RegisteredLocale] extends [never] ? string : RegisteredLocale;
+type FarmI18nMessageValues<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? FarmI18nMessageRegistry[TKey] : Record<string, unknown>;
+type FarmI18nMessageArgs<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? keyof FarmI18nMessageRegistry[TKey] extends never ? [values?: FarmI18nMessageRegistry[TKey]] : [values: FarmI18nMessageRegistry[TKey]] : [values?: Record<string, unknown>];
+interface FarmTranslator {
+    <TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): string;
+    rich<TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): unknown;
+    raw<TKey extends FarmI18nMessageKey>(key: TKey): string;
+    has(key: string): boolean;
+}
+declare global {
+    interface Window {
+        __FARM_I18N__?: FarmI18nClientSnapshot;
+    }
+}
+
+export type { FarmI18nCatalogs as F, ResolvedFarmI18nConfig as R, FarmI18nClientSnapshot as a, FarmI18nLocaleSource as b, FarmI18nLocale as c, FarmTranslator as d, FarmI18nMessageArgs as e, FarmI18nMessageKey as f, FarmI18nCookieConfig as g, FarmI18nDetectionSignal as h, FarmI18nDirection as i, FarmI18nRouting as j, FarmI18nUserConfig as k, FarmI18nCatalog as l, FarmI18nLocaleRegistry as m, FarmI18nMessageRegistry as n, FarmI18nMessageValues as o };