@farm.js/core 0.1.47 → 0.1.49

package/dist/chunk-BEXYFR2R.cjs

@@ -0,0 +1,527 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } 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 _chunkL6QDME5Zcjs = require('./chunk-L6QDME5Z.cjs');
+
+
+
+
+
+var _chunkUPYIFH2Hcjs = require('./chunk-UPYIFH2H.cjs');
+
+
+
+
+
+
+var _chunk5DX3O6TTcjs = require('./chunk-5DX3O6TT.cjs');
+
+
+var _chunkY3WG64CPcjs = require('./chunk-Y3WG64CP.cjs');
+
+
+var _chunkSNP33A33cjs = require('./chunk-SNP33A33.cjs');
+
+
+var _chunk6XFGJBYXcjs = require('./chunk-6XFGJBYX.cjs');
+
+
+var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
+
+
+var _chunkEVIWKPJVcjs = require('./chunk-EVIWKPJV.cjs');
+
+
+var _chunkZ5MZDFX4cjs = require('./chunk-Z5MZDFX4.cjs');
+
+
+var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
+
+
+
+
+var _chunk7JUIK547cjs = require('./chunk-7JUIK547.cjs');
+
+
+var _chunkHNAISJFDcjs = require('./chunk-HNAISJFD.cjs');
+
+
+var _chunkOWQV6MLMcjs = require('./chunk-OWQV6MLM.cjs');
+
+
+var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
+
+// src/middleware/context.ts
+var CookieJarImpl = class {
+  constructor(req, res) {
+    this.req = req;
+    this.res = res;
+    this.cookies = _chunkUPYIFH2Hcjs.parseMiddlewareCookieHeader.call(void 0, req.headers.cookie);
+    const existing = res.getHeader("Set-Cookie");
+    this.setCookies = Array.isArray(existing) ? existing.map(String) : existing === void 0 ? [] : [String(existing)];
+  }
+  get(name) {
+    return this.cookies[name];
+  }
+  set(name, value, options = {}) {
+    this.cookies[name] = value;
+    const cookieString = _chunkUPYIFH2Hcjs.serializeMiddlewareCookie.call(void 0, name, value, options);
+    this.setCookies.push(cookieString);
+    this.res.setHeader("Set-Cookie", this.setCookies);
+  }
+  delete(name, options = {}) {
+    delete this.cookies[name];
+    this.setCookies.push(_chunkUPYIFH2Hcjs.serializeMiddlewareCookieDeletion.call(void 0, name, options));
+    this.res.setHeader("Set-Cookie", this.setCookies);
+  }
+  getAll() {
+    return { ...this.cookies };
+  }
+};
+function createContext(req, res, viteServer, parent, server, toRoutePathname) {
+  const url = _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, { trustProxy: _optionalChain([server, 'optionalAccess', _ => _.trustProxy]) });
+  const headers = /* @__PURE__ */ new Map();
+  const data = _optionalChain([parent, 'optionalAccess', _2 => _2.data]) ? new Map(parent.data) : /* @__PURE__ */ new Map();
+  const locals = _optionalChain([parent, 'optionalAccess', _3 => _3.locals]) ? new Map(parent.locals) : /* @__PURE__ */ new Map();
+  const cookies = new CookieJarImpl(req, res);
+  if (_optionalChain([parent, 'optionalAccess', _4 => _4.headers])) {
+    for (const [key, value] of Object.entries(parent.headers)) {
+      headers.set(key, value);
+    }
+  }
+  let handled = false;
+  const applyResponseHeaders = () => {
+    for (const [key, value] of headers) {
+      try {
+        res.setHeader(key, value);
+      } catch (e) {
+      }
+    }
+  };
+  const ctx = {
+    request: req,
+    response: res,
+    url,
+    pathname: url.pathname,
+    routePathname: _chunk5DX3O6TTcjs.toMiddlewareRoutePathname.call(void 0, url.pathname, toRoutePathname),
+    searchParams: url.searchParams,
+    method: req.method || "GET",
+    params: {},
+    route: url.pathname,
+    parent,
+    vite: {
+      isDev: process.env.NODE_ENV !== "production",
+      hmr: !!_optionalChain([viteServer, 'optionalAccess', _5 => _5.hot]),
+      server: viteServer
+    },
+    data,
+    locals,
+    headers,
+    cookies,
+    _handled: false,
+    redirect(redirectUrl, status = 307) {
+      if (handled) {
+        console.warn("Response already sent, cannot redirect");
+        return;
+      }
+      ctx._redirectUrl = redirectUrl;
+      ctx._handled = true;
+      handled = true;
+      applyResponseHeaders();
+      res.writeHead(status, {
+        Location: redirectUrl,
+        "Content-Type": "text/plain"
+      });
+      res.end(`Redirecting to ${redirectUrl}`);
+    },
+    rewrite(rewriteUrl) {
+      ctx._rewriteUrl = rewriteUrl;
+      const newUrl = new URL(rewriteUrl, ctx.url);
+      ctx.url = newUrl;
+      ctx.pathname = newUrl.pathname;
+      ctx.routePathname = _chunk5DX3O6TTcjs.toMiddlewareRoutePathname.call(void 0, newUrl.pathname, toRoutePathname);
+      ctx.searchParams = newUrl.searchParams;
+      ctx.route = newUrl.pathname;
+      req.url = rewriteUrl;
+    },
+    json(jsonData, status = 200) {
+      if (handled) {
+        console.warn("Response already sent, cannot send JSON");
+        return;
+      }
+      ctx._handled = true;
+      handled = true;
+      applyResponseHeaders();
+      res.writeHead(status, {
+        "Content-Type": "application/json"
+      });
+      res.end(JSON.stringify(jsonData));
+    },
+    text(content, status = 200) {
+      if (handled) {
+        console.warn("Response already sent, cannot send text");
+        return;
+      }
+      ctx._handled = true;
+      handled = true;
+      applyResponseHeaders();
+      res.writeHead(status, {
+        "Content-Type": "text/plain"
+      });
+      res.end(content);
+    },
+    html(content, status = 200) {
+      if (handled) {
+        console.warn("Response already sent, cannot send HTML");
+        return;
+      }
+      ctx._handled = true;
+      handled = true;
+      applyResponseHeaders();
+      res.writeHead(status, {
+        "Content-Type": "text/html"
+      });
+      res.end(content);
+    }
+  };
+  return ctx;
+}
+
+// src/middleware/manager.ts
+var _fs = require('fs'); var fs = _interopRequireWildcard(_fs);
+var _path = require('path'); var path = _interopRequireWildcard(_path);
+function isMiddlewareResponse(value) {
+  return value instanceof Response;
+}
+var MiddlewareManager = class {
+  constructor(appDir, viteServer, config, i18n, server, apiBasePath) {
+    this.middleware = [];
+    this.configMiddleware = [];
+    this.appDirs = Array.isArray(appDir) ? [...appDir] : [appDir];
+    this.viteServer = viteServer;
+    this.i18n = i18n;
+    this.server = server;
+    this.toMiddlewarePathnames = _chunkB5BBTPJQcjs.createFarmAPIMiddlewarePathnames.call(void 0, apiBasePath);
+    this.configure(config);
+  }
+  configure(config) {
+    this.configMiddleware = [];
+    this.globalConfig = void 0;
+    if (!config) return;
+    const entries = Array.isArray(config) ? config : [config];
+    for (const [index, entry] of entries.entries()) {
+      const handlers = this.getConfigHandlers(entry);
+      const middlewareConfig = this.toMiddlewareConfig(entry);
+      _chunk5DX3O6TTcjs.compileMiddlewareConfig.call(void 0, middlewareConfig);
+      if (handlers.length === 0) {
+        this.globalConfig = middlewareConfig;
+        continue;
+      }
+      this.configMiddleware.push({
+        path: "/",
+        filePath: `farm.config.ts#middleware-${index}`,
+        handlers,
+        config: middlewareConfig,
+        source: "config"
+      });
+    }
+  }
+  /**
+   * Discover all middleware.ts files
+   */
+  async discover() {
+    const middlewareByDirectory = /* @__PURE__ */ new Map();
+    for (const appDir of this.appDirs) {
+      const discovered = [];
+      await this.discoverInDirectory(appDir, "/", "", discovered);
+      for (const entry of discovered) {
+        _chunk5DX3O6TTcjs.compileMiddlewareRoute.call(void 0, entry.middleware);
+        middlewareByDirectory.set(entry.location.directory, entry);
+      }
+    }
+    this.middleware = Array.from(middlewareByDirectory.values()).sort((left, right) => _chunkL6QDME5Zcjs.compareMiddlewareRouteLocations.call(void 0, left.location, right.location)).map((entry) => entry.middleware);
+    if (process.env.FARM_VERBOSE && this.middleware.length > 0) {
+      _chunkXN2MB4QZcjs.logger.success(`Discovered ${this.middleware.length} middleware files`);
+      for (const mw of this.middleware) {
+        _chunkXN2MB4QZcjs.logger.info(`  ${mw.path} (${mw.handlers.length} handlers)`);
+      }
+    }
+  }
+  /**
+   * Recursively discover middleware files
+   */
+  async discoverInDirectory(dir, routePath, directory, discovered) {
+    if (!fs.existsSync(dir)) {
+      return;
+    }
+    const middlewareFile = this.findMiddlewareFile(dir);
+    if (middlewareFile) {
+      const middleware = await this.loadMiddleware(middlewareFile, routePath);
+      if (middleware) {
+        discovered.push({ location: { path: routePath, directory }, middleware });
+      }
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory() && !entry.name.startsWith(".")) {
+        await this.discoverInDirectory(
+          path.join(dir, entry.name),
+          _chunkL6QDME5Zcjs.appendMiddlewareRoutePath.call(void 0, routePath, entry.name),
+          _chunkL6QDME5Zcjs.appendMiddlewareDirectory.call(void 0, directory, entry.name),
+          discovered
+        );
+      }
+    }
+  }
+  /**
+   * Find middleware file in directory
+   */
+  findMiddlewareFile(dir) {
+    const extensions = [".ts", ".tsx", ".js", ".jsx"];
+    for (const ext of extensions) {
+      const filePath = path.join(dir, `middleware${ext}`);
+      if (fs.existsSync(filePath)) {
+        return filePath;
+      }
+    }
+    return null;
+  }
+  /**
+   * Load a middleware file
+   */
+  async loadMiddleware(filePath, routePath) {
+    try {
+      let module;
+      if (this.viteServer) {
+        module = await _chunk6XFGJBYXcjs.loadFarmDevModule.call(void 0, this.viteServer, filePath);
+      } else {
+        module = await import(
+          /* @vite-ignore */
+          _chunkSNP33A33cjs.toFileModuleUrl.call(void 0, filePath)
+        );
+      }
+      const normalized = _chunkUPYIFH2Hcjs.normalizeMiddlewareModule.call(void 0, module, routePath);
+      if (!normalized) {
+        throw new Error("must export a default handler or a named middleware handler");
+      }
+      if (normalized.config) {
+        _chunk5DX3O6TTcjs.compileMiddlewareConfig.call(void 0, normalized.config);
+      }
+      return {
+        path: routePath,
+        filePath,
+        handlers: normalized.handlers,
+        config: normalized.config,
+        source: "file"
+      };
+    } catch (error) {
+      throw new Error(`Failed to load middleware ${filePath}: ${error}`);
+    }
+  }
+  /**
+   * Execute middleware for a request
+   */
+  async execute(req, res) {
+    const url = _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, { trustProxy: _optionalChain([this, 'access', _6 => _6.server, 'optionalAccess', _7 => _7.trustProxy]) });
+    const pathname = url.pathname;
+    const toRoutePathname = (value) => _optionalChain([this, 'access', _8 => _8.i18n, 'optionalAccess', _9 => _9.enabled]) ? _chunkOWQV6MLMcjs.stripFarmLocaleFromPathname.call(void 0, value, this.i18n) : _chunkD22BUQKWcjs.stripFarmBasePath.call(void 0, value, _nullishCoalesce(_optionalChain([this, 'access', _10 => _10.i18n, 'optionalAccess', _11 => _11.basePath]), () => ( "/")));
+    const routePathname = toRoutePathname(pathname);
+    const toMiddlewarePathnames = this.toMiddlewarePathnames;
+    const method = req.method || "GET";
+    const startTime = Date.now();
+    let parentData;
+    let ctx = createContext(req, res, this.viteServer, void 0, this.server, toRoutePathname);
+    if (this.globalConfig) {
+      const globalMatch = this.matchesConfig(routePathname, this.globalConfig, ctx);
+      if (!globalMatch.matched) {
+        return false;
+      }
+      if (globalMatch.params) {
+        ctx.params = { ...ctx.params, ...globalMatch.params };
+      }
+    }
+    const applicable = [
+      ...this.configMiddleware.map((mw) => ({ mw, routeMatch: { matched: true } })),
+      ...this.middleware.map((mw) => ({
+        mw,
+        routeMatch: _chunk5DX3O6TTcjs.matchesMiddlewareRouteAt.call(void 0, toMiddlewarePathnames(routePathname), mw)
+      })).filter((entry) => entry.routeMatch.matched)
+    ];
+    if (applicable.length === 0) {
+      return false;
+    }
+    const pc = _chunkY3WG64CPcjs.createCliColors.call(void 0, );
+    const log = [
+      pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.magenta("MIDDLEWARE")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
+      pc.gray("Executing middleware: "),
+      pc.gray(pathname),
+      pc.dim(` (${(Date.now() - startTime).toFixed(2)}ms)`)
+    ].join(" ");
+    console.log(log);
+    const ran = /* @__PURE__ */ new Set();
+    const allMiddleware = [...this.configMiddleware, ...this.middleware];
+    const globalConfig = this.globalConfig;
+    const trustProxy = _optionalChain([this, 'access', _12 => _12.server, 'optionalAccess', _13 => _13.trustProxy]);
+    function* applicableMiddleware() {
+      let passPathname = routePathname;
+      let pass = applicable;
+      for (; ; ) {
+        for (const entry of pass) yield { ...entry, pathname: passPathname };
+        const rewrittenPathname = toRoutePathname(
+          _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, { trustProxy }).pathname
+        );
+        if (rewrittenPathname === passPathname) return;
+        passPathname = rewrittenPathname;
+        const passPathnames = toMiddlewarePathnames(passPathname);
+        if (globalConfig && !_chunk5DX3O6TTcjs.matchesMiddlewareConfigAt.call(void 0, passPathnames, globalConfig, ctx).matched) {
+          return;
+        }
+        pass = allMiddleware.filter((mw) => !ran.has(mw)).map((mw) => ({
+          mw,
+          routeMatch: mw.source === "config" ? { matched: true } : _chunk5DX3O6TTcjs.matchesMiddlewareRouteAt.call(void 0, passPathnames, mw)
+        })).filter((entry) => entry.routeMatch.matched);
+      }
+    }
+    for (const { mw, routeMatch, pathname: passPathname } of applicableMiddleware()) {
+      const configMatch = mw.config ? this.matchesConfig(passPathname, mw.config, ctx) : { matched: true };
+      if (!configMatch.matched) {
+        continue;
+      }
+      ran.add(mw);
+      if (routeMatch.params) {
+        ctx.params = { ...ctx.params, ...routeMatch.params };
+      }
+      if (configMatch.params) {
+        ctx.params = { ...ctx.params, ...configMatch.params };
+      }
+      if (parentData) {
+        ctx = createContext(req, res, this.viteServer, parentData, this.server, toRoutePathname);
+        if (routeMatch.params) {
+          ctx.params = { ...ctx.params, ...routeMatch.params };
+        }
+        if (configMatch.params) {
+          ctx.params = { ...ctx.params, ...configMatch.params };
+        }
+      }
+      const middlewareStartTime = Date.now();
+      const middlewareEvent = {
+        route: mw.path,
+        pathname,
+        name: mw.filePath
+      };
+      _chunkEVIWKPJVcjs.emitFarmEvent.call(void 0, { type: "middleware.start", ...middlewareEvent });
+      try {
+        let handlerIndex = 0;
+        let returnedResponse;
+        const executeNext = async () => {
+          if (handlerIndex < mw.handlers.length) {
+            const handler = mw.handlers[handlerIndex++];
+            const result2 = await handler(ctx, executeNext);
+            if (isMiddlewareResponse(result2)) {
+              returnedResponse = result2;
+              return result2;
+            }
+          }
+          return returnedResponse;
+        };
+        const result = await executeNext();
+        const response = isMiddlewareResponse(result) ? result : returnedResponse;
+        if (response) {
+          if (!res.headersSent && !res.writableEnded) {
+            for (const [key, value] of ctx.headers) {
+              try {
+                res.setHeader(key, value);
+              } catch (error) {
+              }
+            }
+          }
+          _chunkEVIWKPJVcjs.emitFarmEvent.call(void 0, {
+            type: "middleware.shortCircuit",
+            ...middlewareEvent,
+            status: response.status
+          });
+          await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
+          return true;
+        }
+        if (ctx._handled || res.headersSent || res.writableEnded) {
+          _chunkEVIWKPJVcjs.emitFarmEvent.call(void 0, {
+            type: "middleware.shortCircuit",
+            ...middlewareEvent,
+            status: res.statusCode
+          });
+          return true;
+        }
+        _chunkEVIWKPJVcjs.emitFarmEvent.call(void 0, {
+          type: "middleware.complete",
+          ...middlewareEvent,
+          durationMs: Date.now() - middlewareStartTime
+        });
+      } catch (error) {
+        _chunkEVIWKPJVcjs.emitFarmEvent.call(void 0, 
+          _chunk7JUIK547cjs.isFarmRedirectError.call(void 0, error) || _chunk7JUIK547cjs.isFarmNotFoundError.call(void 0, error) ? {
+            type: "middleware.shortCircuit",
+            ...middlewareEvent,
+            status: _chunk7JUIK547cjs.isFarmRedirectError.call(void 0, error) ? _chunk7JUIK547cjs.getFarmRedirectError.call(void 0, error).status : 404
+          } : { type: "middleware.error", ...middlewareEvent, error }
+        );
+        throw error;
+      }
+      parentData = {
+        data: new Map(ctx.data),
+        locals: new Map(ctx.locals),
+        headers: Object.fromEntries(ctx.headers)
+      };
+    }
+    if (!res.headersSent && !res.writableEnded) {
+      for (const [key, value] of ctx.headers) {
+        try {
+          res.setHeader(key, value);
+        } catch (error) {
+        }
+      }
+    }
+    req.__FARM_MIDDLEWARE_DATA__ = new Map(ctx.data);
+    req.__FARM_MIDDLEWARE_CONTEXT__ = new Map(ctx.locals);
+    return false;
+  }
+  /**
+   * Check if pathname matches middleware config
+   */
+  matchesConfig(pathname, config, ctx) {
+    return _chunk5DX3O6TTcjs.matchesMiddlewareConfigAt.call(void 0, this.toMiddlewarePathnames(pathname), config, ctx);
+  }
+  /**
+   * Reload middleware (for HMR)
+   */
+  async reload() {
+    await this.discover();
+  }
+  getMiddlewares() {
+    return [...this.configMiddleware, ...this.middleware];
+  }
+  hasMiddleware() {
+    return this.configMiddleware.length > 0 || this.middleware.length > 0;
+  }
+  getConfigHandlers(entry) {
+    const handlers = [];
+    if ("handler" in entry && typeof entry.handler === "function") {
+      handlers.push(entry.handler);
+    }
+    if ("handlers" in entry && Array.isArray(entry.handlers)) {
+      handlers.push(...entry.handlers.filter((handler) => typeof handler === "function"));
+    }
+    return handlers;
+  }
+  toMiddlewareConfig(entry) {
+    const { matcher, exclude, runtime } = entry;
+    return { matcher, exclude, runtime };
+  }
+};
+
+
+
+
+exports.createContext = createContext; exports.MiddlewareManager = MiddlewareManager;

package/dist/chunk-BLD5GVCG.mjs

@@ -0,0 +1,152 @@
+// src/api/config.ts
+var DEFAULT_FARM_API_BASE_PATH = "/api";
+async function resolveFarmAPIConfig(config, context) {
+  const configuredBasePath = await resolveConfigValue(config?.basePath, context, "api.basePath");
+  const basePath = normalizeFarmAPIBasePath(configuredBasePath ?? DEFAULT_FARM_API_BASE_PATH);
+  const configuredBaseURL = await resolveConfigValue(config?.baseURL, context, "api.baseURL");
+  return normalizeFarmAPIConfig({ baseURL: configuredBaseURL, basePath });
+}
+function normalizeFarmAPIConfig(config) {
+  const basePath = normalizeFarmAPIBasePath(config?.basePath ?? DEFAULT_FARM_API_BASE_PATH);
+  const baseURL = config?.baseURL?.trim();
+  if (!baseURL) {
+    return { baseURL: basePath, basePath };
+  }
+  if (baseURL.startsWith("//")) {
+    throw new Error(
+      'Farm api.baseURL must be an absolute URL or a root-relative path such as "/api", not a network-path reference.'
+    );
+  }
+  if (baseURL.startsWith("/")) {
+    const url2 = parseRootRelativeBaseURL(baseURL);
+    if (url2.pathname !== "/") {
+      const effectivePath = normalizeFarmAPIBasePath(url2.pathname);
+      return { baseURL: effectivePath, basePath: effectivePath };
+    }
+    return { baseURL: basePath, basePath };
+  }
+  let url;
+  try {
+    url = new URL(baseURL);
+  } catch {
+    throw new Error(
+      'Farm api.baseURL must be an absolute URL or a root-relative path such as "/api".'
+    );
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new Error("Farm api.baseURL must use http or https.");
+  }
+  if (url.search || url.hash) {
+    throw new Error("Farm api.baseURL cannot contain a query string or hash.");
+  }
+  if (url.pathname !== "/") {
+    const effectivePath = normalizeFarmAPIBasePath(url.pathname);
+    return {
+      baseURL: `${url.origin}${effectivePath}`,
+      basePath: effectivePath
+    };
+  }
+  return {
+    baseURL: basePath === "/" ? url.origin : `${url.origin}${basePath}`,
+    basePath
+  };
+}
+function normalizeFarmAPIBasePath(value) {
+  const hasUnstableCharacters = (candidate) => candidate.includes("\\") || Array.from(candidate).some((character) => {
+    const code = character.charCodeAt(0);
+    return code <= 31 || code >= 127 && code <= 159;
+  });
+  if (hasUnstableCharacters(value)) {
+    throw new Error("Farm api.basePath cannot contain backslashes or control characters.");
+  }
+  const path = value.trim();
+  if (!path) {
+    throw new Error("Farm api.basePath cannot be empty.");
+  }
+  if (path.includes("?") || path.includes("#")) {
+    throw new Error("Farm api.basePath cannot contain a query string or hash.");
+  }
+  if (path.startsWith("//")) {
+    throw new Error('Farm api.basePath must be a pathname such as "/api", not a URL.');
+  }
+  for (const segment of path.split("/")) {
+    let decoded = segment;
+    try {
+      decoded = decodeURIComponent(segment);
+    } catch {
+    }
+    if (hasUnstableCharacters(decoded)) {
+      throw new Error("Farm api.basePath cannot contain backslashes or control characters.");
+    }
+    if (decoded.includes("/")) {
+      throw new Error("Farm api.basePath cannot contain percent-encoded path separators.");
+    }
+    if (decoded === "." || decoded === "..") {
+      throw new Error('Farm api.basePath cannot contain "." or ".." path segments.');
+    }
+  }
+  const normalized = `/${path.replace(/^\/+|\/+$/g, "")}`;
+  return normalized === "/" ? "/" : normalized;
+}
+function getFarmAPIBaseURL() {
+  if (typeof __FARM_API_BASE_URL__ !== "undefined" && __FARM_API_BASE_URL__) {
+    return __FARM_API_BASE_URL__;
+  }
+  return DEFAULT_FARM_API_BASE_PATH;
+}
+function resolveFarmAPIRequestURL(routePath, baseURL = getFarmAPIBaseURL(), fallbackOrigin = getDefaultOrigin()) {
+  const base = new URL(baseURL, fallbackOrigin);
+  if (base.pathname === "/") {
+    return new URL(routePath, base);
+  }
+  const route = new URL(routePath, fallbackOrigin);
+  const suffix = stripCanonicalAPIBasePath(route.pathname);
+  const joinedPath = joinURLPath(base.pathname, suffix);
+  base.pathname = joinedPath;
+  base.search = route.search;
+  base.hash = route.hash;
+  return base;
+}
+async function resolveConfigValue(value, context, name) {
+  const resolved = typeof value === "function" ? await value(context) : value;
+  if (resolved === void 0) return void 0;
+  if (typeof resolved !== "string") {
+    throw new Error(`Farm ${name} must resolve to a string or undefined.`);
+  }
+  if (!resolved.trim()) {
+    throw new Error(`Farm ${name} cannot be empty.`);
+  }
+  return resolved;
+}
+function parseRootRelativeBaseURL(value) {
+  const url = new URL(value, "http://farm.local");
+  if (url.search || url.hash) {
+    throw new Error("Farm api.baseURL cannot contain a query string or hash.");
+  }
+  return url;
+}
+function stripCanonicalAPIBasePath(pathname) {
+  if (pathname === DEFAULT_FARM_API_BASE_PATH) return "";
+  if (pathname.startsWith(`${DEFAULT_FARM_API_BASE_PATH}/`)) {
+    return pathname.slice(DEFAULT_FARM_API_BASE_PATH.length + 1);
+  }
+  return pathname.replace(/^\/+/, "");
+}
+function joinURLPath(basePath, suffix) {
+  const normalizedBase = basePath === "/" ? "" : basePath.replace(/\/+$/, "");
+  const normalizedSuffix = suffix.replace(/^\/+/, "");
+  if (!normalizedSuffix) return normalizedBase || "/";
+  return `${normalizedBase}/${normalizedSuffix}`;
+}
+function getDefaultOrigin() {
+  return typeof window !== "undefined" ? window.location.origin : "http://localhost:3000";
+}
+
+export {
+  DEFAULT_FARM_API_BASE_PATH,
+  resolveFarmAPIConfig,
+  normalizeFarmAPIConfig,
+  normalizeFarmAPIBasePath,
+  getFarmAPIBaseURL,
+  resolveFarmAPIRequestURL
+};