@farm.js/core 0.1.17 → 0.1.19

package/dist/internal/infra-analytics-runtime.cjs

@@ -1,542 +1,16 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-// src/infra-analytics-runtime.ts
-var infra_analytics_runtime_exports = {};
-__export(infra_analytics_runtime_exports, {
-  createFarmInfraAnalyticsPlugin: () => createFarmInfraAnalyticsPlugin2,
-  createFarmInfraAnalyticsRecorder: () => createFarmInfraAnalyticsRecorder2
-});
-module.exports = __toCommonJS(infra_analytics_runtime_exports);
-
-// src/tracing.ts
-var import_api = require("@opentelemetry/api");
-var ALL_SPAN_KINDS = [
-  "request",
-  "render",
-  "middleware",
-  "api",
-  "integration",
-  "storage",
-  "ppr",
-  "build",
-  "plugin"
-];
-var DEFAULT_IGNORED_PATHS = [
-  "/@vite/",
-  "/@fs/",
-  "/@id/",
-  "/@react-refresh",
-  "/node_modules/",
-  "/__vite",
-  "/.well-known/appspecific/"
-];
-var FARM_REQUEST_METHOD_CONTEXT_KEY = (0, import_api.createContextKey)("@farm.js/core/request-method");
-var TRACING_RUNTIME = /* @__PURE__ */ Symbol.for("@farm.js/core/tracing-runtime/v1");
-var runtime = globalThis;
-var tracingState = runtime[TRACING_RUNTIME] ?? (runtime[TRACING_RUNTIME] = normalizeFarmTracingConfig(false));
-function normalizeFarmTracingConfig(config) {
-  if (!config) {
-    return {
-      enabled: false,
-      spans: new Set(ALL_SPAN_KINDS),
-      recordEvents: true,
-      attributes: {},
-      ignorePaths: DEFAULT_IGNORED_PATHS
-    };
-  }
-  if (config === true) {
-    return {
-      enabled: true,
-      spans: new Set(ALL_SPAN_KINDS),
-      recordEvents: true,
-      attributes: {},
-      ignorePaths: DEFAULT_IGNORED_PATHS
-    };
-  }
-  return {
-    enabled: config.enabled ?? true,
-    spans: new Set(config.spans ?? ALL_SPAN_KINDS),
-    recordEvents: config.recordEvents ?? true,
-    attributes: { ...config.attributes },
-    ignorePaths: [...DEFAULT_IGNORED_PATHS, ...config.ignorePaths ?? []]
-  };
-}
-__name(normalizeFarmTracingConfig, "normalizeFarmTracingConfig");
-
-// src/observability.ts
-var OBSERVABILITY_RUNTIME = /* @__PURE__ */ Symbol.for("@farm.js/core/observability-runtime/v1");
-var runtime2 = globalThis;
-var shared = runtime2[OBSERVABILITY_RUNTIME] ?? (runtime2[OBSERVABILITY_RUNTIME] = {
-  handlers: /* @__PURE__ */ new Set(),
-  unfilteredHandlers: /* @__PURE__ */ new Set(),
-  config: { logs: false, handlers: [], tracing: normalizeFarmTracingConfig(false) }
-});
-var runtimeHandlers = shared.handlers;
-var unfilteredRuntimeHandlers = shared.unfilteredHandlers;
-var observabilityState = shared.config;
-function onFarmEvent(handler, options = {}) {
-  const handlers = options.unfiltered ? unfilteredRuntimeHandlers : runtimeHandlers;
-  handlers.add(handler);
-  return () => {
-    handlers.delete(handler);
-  };
-}
-__name(onFarmEvent, "onFarmEvent");
 
-// src/server/request.ts
-var import_node_async_hooks = require("async_hooks");
-var import_node_stream = require("stream");
+var _chunkYA6LLTIJcjs = require('../chunk-YA6LLTIJ.cjs');
+require('../chunk-E3UK5IIB.cjs');
+require('../chunk-5ZSWG4UX.cjs');
+require('../chunk-U4KT7QP3.cjs');
+require('../chunk-S3JO3N4H.cjs');
 
-// src/server/request-bridge.ts
-var CURRENT_REQUEST_RESOLVER_KEY = /* @__PURE__ */ Symbol.for("farm.currentRequestResolver");
-function getGlobalState() {
-  return globalThis;
-}
-__name(getGlobalState, "getGlobalState");
-function _setCurrentRequestResolver(resolver) {
-  getGlobalState()[CURRENT_REQUEST_RESOLVER_KEY] = resolver;
-}
-__name(_setCurrentRequestResolver, "_setCurrentRequestResolver");
+// src/infra-analytics-runtime.ts
+var createFarmInfraAnalyticsPlugin2 = _chunkYA6LLTIJcjs.createFarmInfraAnalyticsPlugin;
+var createFarmInfraAnalyticsRecorder2 = _chunkYA6LLTIJcjs.createFarmInfraAnalyticsRecorder;
 
-// src/server/request.ts
-var REQUEST_STORAGE_KEY = /* @__PURE__ */ Symbol.for("@farm.js/core/request-storage");
-function getRequestStore() {
-  const runtime3 = globalThis;
-  const existing = runtime3[REQUEST_STORAGE_KEY];
-  if (existing instanceof import_node_async_hooks.AsyncLocalStorage) {
-    return existing;
-  }
-  const storage = new import_node_async_hooks.AsyncLocalStorage();
-  runtime3[REQUEST_STORAGE_KEY] = storage;
-  return storage;
-}
-__name(getRequestStore, "getRequestStore");
-var requestStore = getRequestStore();
-_setCurrentRequestResolver(() => requestStore.getStore());
-function getCurrentRequestOrNull() {
-  return requestStore.getStore() ?? null;
-}
-__name(getCurrentRequestOrNull, "getCurrentRequestOrNull");
 
-// src/plugins/infra-analytics.ts
-var FARM_PRERENDER_ENV = "FARM_PRERENDER";
-var DEFAULT_URL = "https://app.farmjs.dev";
-var EVENTS_PATH = "/api/telemetry/v1/events";
-var INGESTION_KEY = /^fti_[A-Za-z0-9_-]{43}$/;
-var API_KEY = /^farmjs_[A-Za-z0-9_-]{32}$/;
-var PROJECT = /^proj_[0-9a-f-]{36}$/;
-var ENVIRONMENTS = ["production", "staging", "development"];
-var METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "QUERY"]);
-var MAX_QUEUE = 500;
-var MAX_AGE = 3e5;
-var MAX_ATTEMPTS = 5;
-var FLUSH_BUDGET = 5e3;
-var TIMEOUT = 2e3;
-var encoder = new TextEncoder();
-var sleep = /* @__PURE__ */ __name((ms) => new Promise((resolve) => setTimeout(resolve, ms)), "sleep");
-var uuid = /* @__PURE__ */ __name(() => globalThis.crypto.randomUUID(), "uuid");
-function processEnv() {
-  return globalThis.process?.env ?? {};
-}
-__name(processEnv, "processEnv");
-function defaultFarmInfraEnvironment(env = processEnv()) {
-  const explicit = env.FARMJS_ENVIRONMENT;
-  if (explicit && ENVIRONMENTS.includes(explicit)) return explicit;
-  if (env.VERCEL_ENV === "production") return "production";
-  if (env.VERCEL_ENV === "preview") return "staging";
-  if (env.VERCEL_ENV === "development") return "development";
-  return env.NODE_ENV === "production" ? "production" : "development";
-}
-__name(defaultFarmInfraEnvironment, "defaultFarmInfraEnvironment");
-function resolveFarmInfraAnalytics(env = processEnv()) {
-  const key = env.FARMJS_API_KEY?.trim();
-  if (!key || env[FARM_PRERENDER_ENV] === "1") return { off: null };
-  const ingestionKey = INGESTION_KEY.test(key);
-  const projectId = env.FARMJS_PROJECT_ID?.trim() || void 0;
-  if (!ingestionKey && !projectId) return { off: null };
-  if (!ingestionKey && !API_KEY.test(key)) {
-    return {
-      off: "FARMJS_API_KEY isn't a Farm Infra API key (farmjs_\u2026) or write-only key (fti_\u2026)"
-    };
-  }
-  if (!ingestionKey && !PROJECT.test(projectId)) {
-    return { off: "FARMJS_PROJECT_ID isn't a Farm Infra project ID (proj_\u2026)" };
-  }
-  if (env.FARMJS_ENVIRONMENT && !ENVIRONMENTS.includes(env.FARMJS_ENVIRONMENT)) {
-    return { off: "FARMJS_ENVIRONMENT must be production, staging or development" };
-  }
-  let endpoint;
-  try {
-    endpoint = new URL(EVENTS_PATH, env.FARMJS_API_URL?.trim() || DEFAULT_URL);
-  } catch {
-    return { off: "FARMJS_API_URL isn't a URL" };
-  }
-  const loopback = ["localhost", "127.0.0.1", "[::1]"].includes(endpoint.hostname);
-  if (endpoint.protocol !== "https:" && !(endpoint.protocol === "http:" && loopback) || endpoint.username || endpoint.password) {
-    return { off: "FARMJS_API_URL must use HTTPS (HTTP only for localhost)" };
-  }
-  return {
-    options: {
-      endpoint: endpoint.href,
-      key,
-      ...ingestionKey ? {} : { projectId, environment: defaultFarmInfraEnvironment(env) }
-    }
-  };
-}
-__name(resolveFarmInfraAnalytics, "resolveFarmInfraAnalytics");
-var AGENT_TOKENS = [
-  ["ChatGPT-User", "openai", "agent"],
-  ["OAI-SearchBot", "openai", "crawler"],
-  ["GPTBot", "openai", "crawler"],
-  ["Claude-User", "anthropic", "agent"],
-  ["Claude-SearchBot", "anthropic", "crawler"],
-  ["ClaudeBot", "anthropic", "crawler"]
-];
-var AGENT_PATTERNS = AGENT_TOKENS.map(([token, family, category]) => ({
-  pattern: new RegExp(`(?:^|[\\s;(])${token}(?=[/\\s;)]|$)`, "i"),
-  family,
-  category
-}));
-function classifyFarmInfraAgent(userAgent) {
-  const value = (userAgent ?? "").slice(0, 2048);
-  const matches = AGENT_PATTERNS.filter(({ pattern }) => pattern.test(value));
-  if (matches.length === 1) {
-    const { family, category } = matches[0];
-    return { family, category, identity: "self-reported" };
-  }
-  return { family: "unknown", category: "unknown", identity: "unknown" };
-}
-__name(classifyFarmInfraAgent, "classifyFarmInfraAgent");
-function routeTemplate(pattern) {
-  return typeof pattern === "string" && pattern.length <= 256 && /^\/(?!\/)[a-zA-Z0-9_./:[\]()*-]*$/.test(pattern) ? pattern : "/[unmatched]";
-}
-__name(routeTemplate, "routeTemplate");
-function duration(value) {
-  return Number.isFinite(value) ? Math.min(864e5, Math.max(0, value)) : 0;
-}
-__name(duration, "duration");
-function isToolEvent(value) {
-  if (!value || typeof value !== "object") return false;
-  const event = value;
-  return event.type === "mcp.tool.complete" && typeof event.tool === "string" && /^[a-zA-Z0-9_.:/-]{1,128}$/.test(event.tool) && (event.outcome === "success" || event.outcome === "error") && typeof event.durationMs === "number" && Number.isFinite(event.durationMs);
-}
-__name(isToolEvent, "isToolEvent");
-function retryAt(value, now) {
-  if (!value) return now;
-  if (/^\d+$/.test(value.trim())) return now + Math.min(Number(value), 86400) * 1e3;
-  const date = Date.parse(value);
-  return Number.isFinite(date) ? Math.max(now, Math.min(date, now + 864e5)) : now;
-}
-__name(retryAt, "retryAt");
-function createFarmInfraAnalyticsExporter(options, send = (input, init) => fetch(input, init)) {
-  const requestHeaders = {
-    "content-type": "application/json",
-    authorization: `Bearer ${options.key}`
-  };
-  if (!INGESTION_KEY.test(options.key)) {
-    requestHeaders["x-farm-project"] = options.projectId;
-    requestHeaders["x-farm-environment"] = options.environment ?? defaultFarmInfraEnvironment();
-  }
-  const queue = [];
-  let stopped = false;
-  let closing = false;
-  let pending;
-  let notBefore = 0;
-  let active;
-  let inFlight = /* @__PURE__ */ new Set();
-  const diagnostic = /* @__PURE__ */ __name((event) => {
-    try {
-      void Promise.resolve(options.onDiagnostic?.(event)).catch(() => {
-      });
-    } catch {
-    }
-  }, "diagnostic");
-  const expired = /* @__PURE__ */ __name((item, now) => !inFlight.has(item) && (now - item.enqueuedAt >= MAX_AGE || item.attempts >= MAX_ATTEMPTS), "expired");
-  function prune() {
-    const now = Date.now();
-    let count = 0;
-    for (let i = queue.length - 1; i >= 0; i--) {
-      if (expired(queue[i], now)) {
-        queue.splice(i, 1);
-        count++;
-      }
-    }
-    if (count) diagnostic({ code: "dropped", count });
-  }
-  __name(prune, "prune");
-  function remove(batch) {
-    const sent = new Set(batch);
-    for (let i = queue.length - 1; i >= 0; i--) if (sent.has(queue[i])) queue.splice(i, 1);
-  }
-  __name(remove, "remove");
-  function enqueue(event) {
-    if (stopped || closing) return;
-    prune();
-    if (queue.length >= MAX_QUEUE) {
-      diagnostic({ code: "dropped", count: 1 });
-      return;
-    }
-    queue.push({ event, enqueuedAt: Date.now(), attempts: 0 });
-  }
-  __name(enqueue, "enqueue");
-  async function drain() {
-    const deadline = Date.now() + FLUSH_BUDGET;
-    await sleep(25);
-    while (!stopped && queue.length && Date.now() < deadline) {
-      prune();
-      if (!queue.length || notBefore >= deadline) break;
-      if (notBefore > Date.now()) await sleep(notBefore - Date.now());
-      if (stopped || Date.now() >= deadline) break;
-      const batch = queue.slice(0, 50);
-      const body = JSON.stringify({ schemaVersion: 1, events: batch.map(({ event }) => event) });
-      if (encoder.encode(body).length > 128 * 1024) {
-        queue.splice(0, batch.length);
-        diagnostic({ code: "dropped", count: batch.length });
-        continue;
-      }
-      for (const item of batch) item.attempts++;
-      inFlight = new Set(batch);
-      active = new AbortController();
-      const timeout = setTimeout(() => active?.abort(), Math.min(TIMEOUT, deadline - Date.now()));
-      let status;
-      try {
-        const response = await send(options.endpoint, {
-          method: "POST",
-          redirect: "error",
-          signal: active.signal,
-          headers: requestHeaders,
-          body
-        });
-        status = response.status;
-        void response.body?.cancel().catch(() => {
-        });
-        if (response.ok) {
-          remove(batch);
-          continue;
-        }
-        if ([400, 401, 403, 404, 413, 415].includes(status) || status >= 300 && status < 400) {
-          stopped = true;
-          queue.length = 0;
-          diagnostic({ code: "disabled", status });
-          break;
-        }
-        if (status !== 408 && status !== 429 && status < 500) {
-          remove(batch);
-          diagnostic({ code: "dropped", count: batch.length, status });
-          continue;
-        }
-        notBefore = Math.max(notBefore, retryAt(response.headers.get("retry-after"), Date.now()));
-      } catch {
-      } finally {
-        clearTimeout(timeout);
-        active = void 0;
-        inFlight.clear();
-      }
-      notBefore = Math.max(
-        notBefore,
-        Date.now() + Math.min(3e4, 500 * 2 ** (batch[0].attempts - 1))
-      );
-      diagnostic({ code: "retry", ...status === void 0 ? {} : { status } });
-    }
-  }
-  __name(drain, "drain");
-  function flush() {
-    if (stopped || !queue.length || notBefore > Date.now() + FLUSH_BUDGET)
-      return pending ?? Promise.resolve();
-    pending ?? (pending = drain().catch(() => {
-    }).finally(() => {
-      pending = void 0;
-    }));
-    return pending;
-  }
-  __name(flush, "flush");
-  async function close() {
-    if (closing) {
-      await pending;
-      return;
-    }
-    closing = true;
-    await flush();
-    stopped = true;
-    active?.abort();
-    if (queue.length) diagnostic({ code: "dropped", count: queue.length });
-    queue.length = 0;
-  }
-  __name(close, "close");
-  return { enqueue, flush, close };
-}
-__name(createFarmInfraAnalyticsExporter, "createFarmInfraAnalyticsExporter");
-var CONTEXT_KEY = "farm.infra.analytics";
-function beginRequest(request, pattern, waitUntil) {
-  return {
-    id: uuid(),
-    agent: classifyFarmInfraAgent(request.headers.get("user-agent")),
-    route: routeTemplate(pattern),
-    completed: false,
-    waitUntil
-  };
-}
-__name(beginRequest, "beginRequest");
-function requestEvent(metadata, method, status, durationMs) {
-  return {
-    id: uuid(),
-    requestId: metadata.id,
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    route: metadata.route,
-    agent: metadata.agent,
-    kind: "request",
-    method,
-    status,
-    durationMs: duration(durationMs)
-  };
-}
-__name(requestEvent, "requestEvent");
-function farmInfraAnalyticsPlugin(options, send) {
-  const contextKey = `${CONTEXT_KEY}.${uuid()}`;
-  return {
-    name: "farm:infra-analytics",
-    enforce: "post",
-    setup(context2) {
-      const state = { exporter: createFarmInfraAnalyticsExporter(options, send) };
-      context2.lifecycle.onShutdown(async () => {
-        state.unsubscribe?.();
-        await state.exporter.close();
-      });
-      return state;
-    },
-    runtime: {
-      start(context2) {
-        const { exporter } = context2.state;
-        context2.state.unsubscribe = onFarmEvent(
-          (event) => {
-            if (!isToolEvent(event)) return;
-            const request = getCurrentRequestOrNull();
-            if (!request) return;
-            const metadata = context2.requestContext.get(request, contextKey);
-            if (!metadata) return;
-            exporter.enqueue({
-              id: uuid(),
-              requestId: metadata.id,
-              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-              route: metadata.route,
-              agent: metadata.agent,
-              kind: "mcp.tool",
-              tool: event.tool,
-              outcome: event.outcome,
-              durationMs: duration(event.durationMs)
-            });
-            metadata.waitUntil(exporter.flush());
-          },
-          { unfiltered: true }
-        );
-      },
-      before(event) {
-        if (event.kind === "asset" || !event.state) return;
-        event.req.set(
-          contextKey,
-          beginRequest(event.request, event.route?.pattern, event.waitUntil)
-        );
-      },
-      after(event) {
-        const metadata = event.req.get(contextKey);
-        if (!metadata || metadata.completed || !event.state) return;
-        metadata.completed = true;
-        if (!METHODS.has(event.request.method)) return;
-        event.state.exporter.enqueue(
-          requestEvent(metadata, event.request.method, event.response.status, event.durationMs)
-        );
-        event.waitUntil(event.state.exporter.flush());
-      },
-      // Unhandled exceptions have no final HTTP status at this boundary. Do not fabricate a 500.
-      error(event) {
-        const metadata = event.req.get(contextKey);
-        if (metadata) metadata.completed = true;
-        if (event.state) event.waitUntil(event.state.exporter.flush());
-      }
-    }
-  };
-}
-__name(farmInfraAnalyticsPlugin, "farmInfraAnalyticsPlugin");
-function farmInfraAnalyticsRecorder(options, send) {
-  const exporter = createFarmInfraAnalyticsExporter(options, send);
-  return {
-    async record(request, runtime3, waitUntil, handler) {
-      if (runtime3.kind === "asset") return handler();
-      const background = /* @__PURE__ */ __name((promise) => waitUntil ? waitUntil(promise) : void promise.catch(() => {
-      }), "background");
-      const metadata = beginRequest(request, runtime3.route?.pattern, background);
-      const startedAt = performance.now();
-      let response;
-      try {
-        response = await handler();
-      } catch (error) {
-        background(exporter.flush());
-        throw error;
-      }
-      if (METHODS.has(request.method)) {
-        exporter.enqueue(
-          requestEvent(metadata, request.method, response.status, performance.now() - startedAt)
-        );
-      }
-      background(exporter.flush());
-      return response;
-    },
-    close: /* @__PURE__ */ __name(() => exporter.close(), "close")
-  };
-}
-__name(farmInfraAnalyticsRecorder, "farmInfraAnalyticsRecorder");
-function linkedOptions(env, warn) {
-  const resolved = resolveFarmInfraAnalytics(env);
-  if ("off" in resolved) {
-    if (resolved.off) warn(`[Farm] Farm Infra analytics is off: ${resolved.off}.`);
-    return null;
-  }
-  return {
-    ...resolved.options,
-    onDiagnostic(event) {
-      if (event.code === "disabled") {
-        warn(
-          `[Farm] Farm Infra analytics stopped: Farm Infra answered ${event.status}. Check FARMJS_API_KEY and FARMJS_PROJECT_ID, then restart the server.`
-        );
-      }
-    }
-  };
-}
-__name(linkedOptions, "linkedOptions");
-function createFarmInfraAnalyticsPlugin(env = processEnv(), warn = console.warn) {
-  const options = linkedOptions(env, warn);
-  return options ? farmInfraAnalyticsPlugin(options) : null;
-}
-__name(createFarmInfraAnalyticsPlugin, "createFarmInfraAnalyticsPlugin");
-function createFarmInfraAnalyticsRecorder(env = processEnv(), warn = console.warn) {
-  const options = linkedOptions(env, warn);
-  return options ? farmInfraAnalyticsRecorder(options) : null;
-}
-__name(createFarmInfraAnalyticsRecorder, "createFarmInfraAnalyticsRecorder");
 
-// src/infra-analytics-runtime.ts
-var createFarmInfraAnalyticsPlugin2 = createFarmInfraAnalyticsPlugin;
-var createFarmInfraAnalyticsRecorder2 = createFarmInfraAnalyticsRecorder;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createFarmInfraAnalyticsPlugin,
-  createFarmInfraAnalyticsRecorder
-});
+exports.createFarmInfraAnalyticsPlugin = createFarmInfraAnalyticsPlugin2; exports.createFarmInfraAnalyticsRecorder = createFarmInfraAnalyticsRecorder2;