@farm.js/core 0.1.17 → 0.1.18

package/dist/chunk-HBTUGXHS.cjs

@@ -0,0 +1,180 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } 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 _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/i18n/config.ts
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var DEFAULT_FARM_I18N_COOKIE = "farm_locale";
+var DEFAULT_FARM_I18N_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+var DEFAULT_DETECTION = ["url", "cookie", "accept-language"];
+function resolveFarmI18nConfig(input, options = {}) {
+  const root = options.root || process.cwd();
+  const basePath = options.basePath || "/";
+  const strictByDefault = options.mode === "production";
+  if (!input) {
+    return {
+      enabled: false,
+      basePath,
+      locales: ["en"],
+      defaultLocale: "en",
+      messages: _path2.default.join(root, "src/messages"),
+      routing: "none",
+      detection: [],
+      fallbackLocale: "en",
+      strict: strictByDefault,
+      cookie: {
+        name: DEFAULT_FARM_I18N_COOKIE,
+        maxAge: DEFAULT_FARM_I18N_COOKIE_MAX_AGE,
+        path: "/",
+        sameSite: "lax",
+        secure: options.mode === "production"
+      },
+      direction: {}
+    };
+  }
+  if (!Array.isArray(input.locales) || input.locales.length === 0) {
+    throw new Error("i18n.locales must contain at least one locale.");
+  }
+  const locales = input.locales.map(canonicalizeLocale);
+  if (new Set(locales).size !== locales.length) {
+    throw new Error("i18n.locales must not contain duplicate locales.");
+  }
+  const defaultLocale = canonicalizeLocale(input.defaultLocale);
+  if (!locales.includes(defaultLocale)) {
+    throw new Error(`i18n.defaultLocale "${defaultLocale}" must be included in i18n.locales.`);
+  }
+  const fallbackLocale = canonicalizeLocale(input.fallbackLocale || defaultLocale);
+  if (!locales.includes(fallbackLocale)) {
+    throw new Error(`i18n.fallbackLocale "${fallbackLocale}" must be included in i18n.locales.`);
+  }
+  const detection = resolveDetection(input);
+  const sameSite = _nullishCoalesce(_optionalChain([input, 'access', _ => _.cookie, 'optionalAccess', _2 => _2.sameSite]), () => ( "lax"));
+  if (sameSite !== "lax" && sameSite !== "strict" && sameSite !== "none") {
+    throw new Error('i18n.cookie.sameSite must be "lax", "strict", or "none".');
+  }
+  const direction = {};
+  for (const [rawLocale, value] of Object.entries(input.direction || {})) {
+    const locale = canonicalizeLocale(rawLocale);
+    if (!locales.includes(locale)) {
+      throw new Error(`i18n.direction contains unknown locale "${rawLocale}".`);
+    }
+    if (value !== "ltr" && value !== "rtl") {
+      throw new Error(`i18n.direction.${rawLocale} must be "ltr" or "rtl".`);
+    }
+    direction[locale] = value;
+  }
+  return {
+    enabled: true,
+    basePath,
+    locales,
+    defaultLocale,
+    messages: _path2.default.resolve(root, input.messages || "src/messages"),
+    routing: input.routing || "prefix-except-default",
+    detection,
+    fallbackLocale,
+    strict: _nullishCoalesce(input.strict, () => ( strictByDefault)),
+    cookie: {
+      name: _optionalChain([input, 'access', _3 => _3.cookie, 'optionalAccess', _4 => _4.name, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6()]) || DEFAULT_FARM_I18N_COOKIE,
+      maxAge: normalizePositiveInteger(
+        _optionalChain([input, 'access', _7 => _7.cookie, 'optionalAccess', _8 => _8.maxAge]),
+        DEFAULT_FARM_I18N_COOKIE_MAX_AGE,
+        "i18n.cookie.maxAge"
+      ),
+      path: normalizeCookiePath(_optionalChain([input, 'access', _9 => _9.cookie, 'optionalAccess', _10 => _10.path])),
+      sameSite,
+      secure: _nullishCoalesce(_optionalChain([input, 'access', _11 => _11.cookie, 'optionalAccess', _12 => _12.secure]), () => ( options.mode === "production"))
+    },
+    direction
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolveFarmI18nConfig, "resolveFarmI18nConfig");
+function resolveFarmI18nMessagePath(config, locale) {
+  return config.messages.includes("{locale}") ? config.messages.split("{locale}").join(locale) : _path2.default.join(config.messages, `${locale}.json`);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolveFarmI18nMessagePath, "resolveFarmI18nMessagePath");
+function isFarmI18nCatalogFile(config, file) {
+  if (!config.enabled) return false;
+  const normalizedFile = file.replace(/\\/g, "/");
+  return config.locales.some(
+    (locale) => resolveFarmI18nMessagePath(config, locale).replace(/\\/g, "/") === normalizedFile
+  );
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isFarmI18nCatalogFile, "isFarmI18nCatalogFile");
+function canonicalizeLocale(locale) {
+  if (!locale || typeof locale !== "string") {
+    throw new Error("Farm i18n locales must be non-empty strings.");
+  }
+  try {
+    return Intl.getCanonicalLocales(locale)[0];
+  } catch (e) {
+    throw new Error(`Invalid i18n locale "${locale}".`);
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, canonicalizeLocale, "canonicalizeLocale");
+function resolveDetection(input) {
+  if (input.detection === false || input.localeDetection === false) {
+    return ["url"];
+  }
+  const detection = input.detection || DEFAULT_DETECTION;
+  const allowed = /* @__PURE__ */ new Set(["url", "cookie", "accept-language"]);
+  const unique = [];
+  for (const signal of detection) {
+    if (!allowed.has(signal)) {
+      throw new Error(`Unsupported i18n detection signal "${signal}".`);
+    }
+    if (!unique.includes(signal)) unique.push(signal);
+  }
+  return unique;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolveDetection, "resolveDetection");
+function normalizePositiveInteger(value, fallback, name) {
+  if (value === void 0) return fallback;
+  if (!Number.isInteger(value) || value < 0) {
+    throw new Error(`${name} must be a positive integer.`);
+  }
+  return value;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, normalizePositiveInteger, "normalizePositiveInteger");
+function normalizeCookiePath(value) {
+  if (value === void 0) return "/";
+  if (typeof value !== "string") {
+    throw new Error("i18n.cookie.path must be a root-relative pathname.");
+  }
+  const hasUnstableCharacters = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (candidate) => candidate.includes("\\") || Array.from(candidate).some((character) => {
+    const code = character.charCodeAt(0);
+    return code <= 31 || code >= 127 && code <= 159;
+  }), "hasUnstableCharacters");
+  if (hasUnstableCharacters(value)) {
+    throw new Error("i18n.cookie.path cannot contain backslashes or control characters.");
+  }
+  const pathname = value.trim();
+  if (!pathname || !pathname.startsWith("/") || pathname.startsWith("//") || pathname.includes(";") || pathname.includes("?") || pathname.includes("#")) {
+    throw new Error(
+      "i18n.cookie.path must be a root-relative pathname without attributes, a query, or a hash."
+    );
+  }
+  for (const segment of pathname.split("/")) {
+    let decoded = segment;
+    try {
+      decoded = decodeURIComponent(segment);
+    } catch (e2) {
+    }
+    if (hasUnstableCharacters(decoded)) {
+      throw new Error("i18n.cookie.path cannot contain backslashes or control characters.");
+    }
+    if (decoded.includes("/")) {
+      throw new Error("i18n.cookie.path cannot contain percent-encoded path separators.");
+    }
+    if (decoded === "." || decoded === "..") {
+      throw new Error('i18n.cookie.path cannot contain "." or ".." path segments.');
+    }
+  }
+  return pathname;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeCookiePath, "normalizeCookiePath");
+
+
+
+
+
+exports.resolveFarmI18nConfig = resolveFarmI18nConfig; exports.resolveFarmI18nMessagePath = resolveFarmI18nMessagePath; exports.isFarmI18nCatalogFile = isFarmI18nCatalogFile;

package/dist/chunk-HREOKQWT.cjs

@@ -0,0 +1,45 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/docs/fonts.ts
+var _crypto = require('crypto');
+var _fs = require('fs');
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var FARM_DOCS_FONT_SOURCES = [
+  {
+    family: "Geist Sans",
+    packagePath: "geist/dist/fonts/geist-sans/Geist-Variable.woff2"
+  },
+  {
+    family: "Geist Mono",
+    packagePath: "geist/dist/fonts/geist-mono/GeistMono-Variable.woff2"
+  }
+];
+function resolveFarmDocsFontAssets(root) {
+  return FARM_DOCS_FONT_SOURCES.flatMap(({ family, packagePath }) => {
+    const sourcePath = _path2.default.join(root, "node_modules", packagePath);
+    if (!_fs.existsSync.call(void 0, sourcePath)) return [];
+    const source = _fs.readFileSync.call(void 0, sourcePath);
+    const fingerprint = _crypto.createHash.call(void 0, "sha256").update(source).digest("hex").slice(0, 12);
+    const extension = _path2.default.extname(packagePath);
+    const baseName = _path2.default.basename(packagePath, extension);
+    return [
+      {
+        family,
+        sourcePath,
+        url: `/assets/fonts/${baseName}-h${fingerprint}${extension}`
+      }
+    ];
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolveFarmDocsFontAssets, "resolveFarmDocsFontAssets");
+function toFarmDocsPublicFontAssets(assets) {
+  return assets.map(({ family, url }) => ({ family, url }));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, toFarmDocsPublicFontAssets, "toFarmDocsPublicFontAssets");
+
+
+
+
+exports.resolveFarmDocsFontAssets = resolveFarmDocsFontAssets; exports.toFarmDocsPublicFontAssets = toFarmDocsPublicFontAssets;

package/dist/chunk-I4J452B7.cjs

@@ -0,0 +1,435 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkARJWXNQLcjs = require('./chunk-ARJWXNQL.cjs');
+
+
+var _chunkH6G5INWMcjs = require('./chunk-H6G5INWM.cjs');
+
+
+
+
+var _chunkNO3WWW3Ncjs = require('./chunk-NO3WWW3N.cjs');
+
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/api/endpoint.ts
+var _bettercall = require('better-call');
+var _EndpointFailure = class _EndpointFailure extends Error {
+  constructor(code, data, options) {
+    super(options.message);
+    this.name = "EndpointFailure";
+    this.code = code;
+    this.data = data;
+    this.status = options.status;
+  }
+};
+_chunkS3JO3N4Hcjs.__name.call(void 0, _EndpointFailure, "EndpointFailure");
+var EndpointFailure = _EndpointFailure;
+function isEndpointFailure(value) {
+  return value instanceof EndpointFailure;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isEndpointFailure, "isEndpointFailure");
+function createEndpoint(pathOrOptions, optionsOrHandler, maybeHandler) {
+  let path;
+  let options;
+  let handler;
+  if (typeof pathOrOptions === "function") {
+    path = "";
+    options = {};
+    handler = pathOrOptions;
+  } else if (typeof pathOrOptions === "string") {
+    path = pathOrOptions;
+    options = optionsOrHandler;
+    handler = maybeHandler;
+  } else {
+    path = "";
+    options = pathOrOptions;
+    handler = optionsOrHandler;
+  }
+  if (typeof handler !== "function") {
+    throw new TypeError("createEndpoint requires a handler function");
+  }
+  const middleware = normalizeEndpointMiddleware(options.middleware);
+  const errors = normalizeEndpointErrors(options.errors);
+  const error = createEndpointErrorHandler(errors);
+  const wrappedHandler = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (async (ctx) => {
+    const execution = await runEndpointMiddleware(
+      middleware,
+      ctx,
+      handler,
+      error,
+      options.invalidates
+    );
+    return execution.result;
+  }), "wrappedHandler");
+  const {
+    middleware: _middleware,
+    errors: _errors,
+    invalidates: _invalidates,
+    openapi: _openapi,
+    mcp: _mcp,
+    ...betterCallOptions
+  } = options;
+  const endpoint = _bettercall.createEndpoint.call(void 0, 
+    path || "/__farm_auto_path__",
+    betterCallOptions,
+    wrappedHandler
+  );
+  endpoint.__path = path || void 0;
+  endpoint.__method = options.method || (path ? "GET" : void 0);
+  endpoint.__autoPath = !path;
+  endpoint.__handler = wrappedHandler;
+  endpoint.__farmInvoke = (ctx) => runEndpointMiddleware(middleware, ctx, handler, error, options.invalidates);
+  endpoint.__middleware = middleware;
+  endpoint.__sourceHandler = handler;
+  endpoint.__invalidates = options.invalidates;
+  endpoint.__errors = errors;
+  endpoint.__openapi = options.openapi;
+  endpoint.__mcp = options.mcp;
+  endpoint.__types = {
+    body: options.body,
+    inputBody: _chunkARJWXNQLcjs.isMultipartSchema.call(void 0, options.body) ? "form-data" : options.body,
+    query: options.query,
+    inputQuery: options.query,
+    headers: options.headers,
+    response: null,
+    errors
+  };
+  return endpoint;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createEndpoint, "createEndpoint");
+var EMPTY_ENDPOINT_MIDDLEWARE = Object.freeze([]);
+var EMPTY_ENDPOINT_CONTEXT = Object.freeze(/* @__PURE__ */ Object.create(null));
+var UNSAFE_ENDPOINT_CONTEXT_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+function normalizeEndpointErrors(definitions) {
+  if (definitions === void 0) return Object.freeze({});
+  if (!isPlainEndpointContext(definitions)) {
+    throw new TypeError("createEndpoint errors must be an object");
+  }
+  const normalized = /* @__PURE__ */ Object.create(null);
+  for (const [code, definition] of Object.entries(definitions)) {
+    if (!code.trim()) {
+      throw new TypeError("Endpoint error codes cannot be empty");
+    }
+    if (!definition || typeof definition !== "object") {
+      throw new TypeError(`Endpoint error "${code}" must be an object`);
+    }
+    if (!Number.isInteger(definition.status) || definition.status < 400 || definition.status > 599) {
+      throw new TypeError(`Endpoint error "${code}" status must be an integer between 400 and 599`);
+    }
+    const dataSchema = resolveEndpointErrorSchema(definition);
+    if (!dataSchema || typeof dataSchema.parse !== "function") {
+      throw new TypeError(`Endpoint error "${code}" requires a data schema with parse()`);
+    }
+    if (definition.message !== void 0 && typeof definition.message !== "string") {
+      throw new TypeError(`Endpoint error "${code}" message must be a string`);
+    }
+    normalized[code] = Object.freeze({ ...definition });
+  }
+  return Object.freeze(normalized);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeEndpointErrors, "normalizeEndpointErrors");
+function resolveEndpointErrorSchema(definition) {
+  if (definition.data && definition.schema) {
+    throw new TypeError("Endpoint errors cannot define both data and schema");
+  }
+  return _nullishCoalesce(definition.data, () => ( definition.schema));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolveEndpointErrorSchema, "resolveEndpointErrorSchema");
+function createEndpointErrorHandler(definitions) {
+  return ((code, data) => {
+    const definition = definitions[code];
+    if (!definition) {
+      throw new TypeError(`Endpoint error "${code}" is not declared`);
+    }
+    const parsed = resolveEndpointErrorSchema(definition).parse(data);
+    throw new EndpointFailure(code, parsed, {
+      status: definition.status,
+      message: _nullishCoalesce(definition.message, () => ( "Request failed"))
+    });
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createEndpointErrorHandler, "createEndpointErrorHandler");
+function normalizeEndpointMiddleware(middleware) {
+  if (middleware === void 0) return EMPTY_ENDPOINT_MIDDLEWARE;
+  if (!Array.isArray(middleware)) {
+    throw new TypeError("createEndpoint middleware must be an array of functions");
+  }
+  const normalized = [...middleware];
+  for (const entry of normalized) {
+    if (typeof entry !== "function") {
+      throw new TypeError("createEndpoint middleware entries must be functions");
+    }
+  }
+  return Object.freeze(normalized);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeEndpointMiddleware, "normalizeEndpointMiddleware");
+async function runEndpointMiddleware(middleware, handlerContext, handler, error, invalidations) {
+  let context = createInitialEndpointContext(handlerContext.context);
+  for (let index = 0; index < middleware.length; index++) {
+    const result2 = await middleware[index]({ ...handlerContext, context });
+    if (isEndpointResponse(result2)) {
+      return {
+        result: result2,
+        context,
+        handlerExecuted: false,
+        invalidations: []
+      };
+    }
+    if (result2 === false) {
+      return {
+        result: forbiddenEndpointResponse(),
+        context,
+        handlerExecuted: false,
+        invalidations: []
+      };
+    }
+    if (result2 === true) continue;
+    if (!isPlainEndpointContext(result2)) {
+      throw new TypeError(
+        `Endpoint middleware ${index + 1} must return an object, true, false, or a Response`
+      );
+    }
+    context = mergeEndpointContext(context, result2, index);
+  }
+  const result = await handler({ ...handlerContext, context, error, fail: error });
+  return {
+    result,
+    context,
+    handlerExecuted: true,
+    invalidations: await applyEndpointInvalidations(
+      invalidations,
+      {
+        ...handlerContext,
+        context,
+        result
+      },
+      result
+    )
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, runEndpointMiddleware, "runEndpointMiddleware");
+async function applyEndpointInvalidations(declaration, context, result) {
+  if (!declaration || isEndpointResponse(result) && result.status >= 400) {
+    return [];
+  }
+  const targets = typeof declaration === "function" ? await declaration(context) : declaration;
+  if (!Array.isArray(targets)) {
+    throw new TypeError(
+      "Endpoint invalidates must resolve to an array of { key }, { path }, or { tag } targets"
+    );
+  }
+  return _chunkH6G5INWMcjs.applyFarmCacheInvalidationTargets.call(void 0, targets);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, applyEndpointInvalidations, "applyEndpointInvalidations");
+function createInitialEndpointContext(value) {
+  if (value === void 0 || value === null) return EMPTY_ENDPOINT_CONTEXT;
+  if (!isPlainEndpointContext(value)) {
+    throw new TypeError("Endpoint context must be a plain object");
+  }
+  return mergeEndpointContext(EMPTY_ENDPOINT_CONTEXT, value);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createInitialEndpointContext, "createInitialEndpointContext");
+function mergeEndpointContext(current, added, middlewareIndex) {
+  const next = Object.assign(/* @__PURE__ */ Object.create(null), current);
+  for (const key of Reflect.ownKeys(added)) {
+    if (!Object.prototype.propertyIsEnumerable.call(added, key)) continue;
+    if (typeof key === "string" && UNSAFE_ENDPOINT_CONTEXT_KEYS.has(key)) {
+      throw new TypeError(`Endpoint middleware cannot provide the unsafe context key "${key}"`);
+    }
+    if (Object.prototype.hasOwnProperty.call(current, key)) {
+      const source = middlewareIndex === void 0 ? "Endpoint context" : `Endpoint middleware ${middlewareIndex + 1}`;
+      throw new TypeError(`${source} cannot replace the existing context key "${String(key)}"`);
+    }
+    next[key] = added[key];
+  }
+  return Object.freeze(next);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, mergeEndpointContext, "mergeEndpointContext");
+function isPlainEndpointContext(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isPlainEndpointContext, "isPlainEndpointContext");
+function isEndpointResponse(value) {
+  return value instanceof Response || typeof value === "object" && value !== null && "headers" in value && "status" in value && typeof value.arrayBuffer === "function";
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isEndpointResponse, "isEndpointResponse");
+function forbiddenEndpointResponse() {
+  return new Response(JSON.stringify({ error: "Forbidden" }), {
+    status: 403,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, forbiddenEndpointResponse, "forbiddenEndpointResponse");
+function GET(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "GET" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "GET" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, GET, "GET");
+function HEAD(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "HEAD" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "HEAD" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, HEAD, "HEAD");
+function QUERY(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "QUERY" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "QUERY" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, QUERY, "QUERY");
+function POST(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "POST" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "POST" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, POST, "POST");
+function PUT(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "PUT" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "PUT" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, PUT, "PUT");
+function DELETE(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "DELETE" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "DELETE" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, DELETE, "DELETE");
+function PATCH(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "PATCH" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "PATCH" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, PATCH, "PATCH");
+function OPTIONS(...args) {
+  if (args.length === 1) {
+    return createEndpoint("", { method: "OPTIONS" }, args[0]);
+  }
+  return createEndpoint("", { ...args[0], method: "OPTIONS" }, args[1]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, OPTIONS, "OPTIONS");
+
+// src/api/route.ts
+var unavailablePluginLocalAPI = Object.freeze({
+  available: false,
+  get() {
+    return void 0;
+  },
+  list() {
+    return [];
+  }
+});
+function createRouteFactory() {
+  return createRouteFactoryAt("");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createRouteFactory, "createRouteFactory");
+function createRouteFactoryAt(prefix) {
+  const factory = {
+    scope(child) {
+      return createRouteFactoryAt(joinRoutePath(prefix, child));
+    }
+  };
+  for (const method of [
+    "GET",
+    "HEAD",
+    "QUERY",
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE",
+    "OPTIONS"
+  ]) {
+    factory[method.toLowerCase()] = (child, options) => {
+      const path = joinRoutePath(prefix, child);
+      const input = _nullishCoalesce(options.input, () => ( {}));
+      const endpoint = createEndpoint(
+        path,
+        {
+          method,
+          body: input.body,
+          query: input.query,
+          headers: input.headers,
+          middleware: options.middleware,
+          mcp: options.mcp
+        },
+        (ctx) => options.handler(ctx.request, {
+          input: { body: ctx.body, query: ctx.query, headers: ctx.headers, params: ctx.params },
+          params: ctx.params,
+          context: ctx.context
+        })
+      );
+      endpoint.__types.params = input.params;
+      endpoint.__output = options.output;
+      return Object.freeze({ path, method, endpoint });
+    };
+  }
+  return Object.freeze(factory);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createRouteFactoryAt, "createRouteFactoryAt");
+function joinRoutePath(prefix, child) {
+  if (typeof child !== "string") throw new TypeError("Route paths must be strings.");
+  const path = child === "" ? prefix : `${prefix}/${child.replace(/^\//, "")}`;
+  if (!(path === "/api" || path.startsWith("/api/")) || /[?#]|\/\/|\/$/.test(path)) {
+    throw new TypeError(
+      `Plugin route "${path}" must be a canonical /api path without a query, hash, or empty segment.`
+    );
+  }
+  _chunkNO3WWW3Ncjs.assertBrowserStableRoutePath.call(void 0, path);
+  _chunkNO3WWW3Ncjs.assertUniqueRouteParameters.call(void 0, path, "api");
+  _chunkNO3WWW3Ncjs.getRoutePatternShape.call(void 0, path, "api");
+  for (const segment of path.split("/")) {
+    if (["__proto__", "constructor", "prototype", "$params"].includes(segment)) {
+      throw new TypeError(`Route segment "${segment}" is reserved.`);
+    }
+  }
+  return path;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, joinRoutePath, "joinRoutePath");
+function resolvePluginRoutes(plugins = [], context = {}) {
+  return plugins.flatMap((plugin) => {
+    if (!plugin.routes) return [];
+    const routes = plugin.routes({
+      route: createRouteFactory(),
+      api: _nullishCoalesce(context.api, () => ( unavailablePluginLocalAPI))
+    });
+    if (!Array.isArray(routes))
+      throw new TypeError(`Plugin "${plugin.name}" routes must return an array synchronously.`);
+    for (const route of routes) {
+      if (!route || joinRoutePath("", route.path) !== route.path || typeof route.endpoint !== "function" || !["GET", "HEAD", "QUERY", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"].includes(
+        route.method
+      )) {
+        throw new TypeError(`Plugin "${plugin.name}" returned an invalid API route.`);
+      }
+    }
+    return routes;
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolvePluginRoutes, "resolvePluginRoutes");
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.EndpointFailure = EndpointFailure; exports.isEndpointFailure = isEndpointFailure; exports.createEndpoint = createEndpoint; exports.GET = GET; exports.HEAD = HEAD; exports.QUERY = QUERY; exports.POST = POST; exports.PUT = PUT; exports.DELETE = DELETE; exports.PATCH = PATCH; exports.OPTIONS = OPTIONS; exports.createRouteFactory = createRouteFactory; exports.resolvePluginRoutes = resolvePluginRoutes;