@fern-api/fern-api-dev 5.37.4 → 5.37.5

package/cli.cjs

@@ -359502,7 +359502,7 @@ var require_cjs6 = __commonJS({
             return new Promise(function(resolve15, reject) {
               const callback = (err, result) => {
                 if (err) {
-                  return reject(toError(err));
+                  return reject(toError2(err));
                 }
                 resolve15(result);
               };
@@ -359519,7 +359519,7 @@ var require_cjs6 = __commonJS({
         };
       }
     }
-    function toError(error50) {
+    function toError2(error50) {
       if (error50 instanceof Error) {
         return error50;
       }
@@ -554898,7 +554898,10 @@ config3(en_default());
 var docs_yml_exports = {};
 __export(docs_yml_exports, {
   DocsYmlSchemas: () => DocsYmlSchemas_exports,
-  RawSchemas: () => schemas_exports7
+  RawSchemas: () => schemas_exports7,
+  THEME_ELIGIBLE_FIELDS: () => THEME_ELIGIBLE_FIELDS,
+  THEME_ELIGIBLE_YAML_KEYS: () => THEME_ELIGIBLE_YAML_KEYS,
+  THEME_FIELD_POLICIES: () => THEME_FIELD_POLICIES
 });
 
 // ../configuration/lib/docs-yml/DocsYmlSchemas.js
@@ -559145,6 +559148,33 @@ var VersionFileConfig2 = schemas_exports6.object({
   navigation: NavigationConfig2
 });
 
+// ../configuration/lib/docs-yml/themeEligibleFields.js
+var THEME_FIELD_POLICIES = {
+  logo: "global",
+  favicon: "global",
+  backgroundImage: "global",
+  colors: "global",
+  typography: "global",
+  layout: "global",
+  settings: "global",
+  theme: "global",
+  integrations: "global",
+  css: "global",
+  js: "global",
+  header: "global",
+  footer: "global",
+  navbarLinks: "global",
+  footerLinks: "global",
+  aiSearch: "global",
+  announcement: "global",
+  metadata: "global"
+};
+var THEME_ELIGIBLE_FIELDS = Object.keys(THEME_FIELD_POLICIES);
+function camelToKebab(value2) {
+  return value2.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+var THEME_ELIGIBLE_YAML_KEYS = new Set(THEME_ELIGIBLE_FIELDS.map(camelToKebab));
+
 // ../configuration/lib/fernignoreUtils.js
 var import_promises10 = require("fs/promises");
 var NEW_LINE_REGEX = /\r?\n/;
@@ -602213,14 +602243,14 @@ var IntermediateRepresentationChangeDetector = class {
   }
   checkErrorsBreakingChanges({ from: from4, to: to10 }) {
     for (const [_7, fromError] of Object.entries(from4)) {
-      const toError = Object.values(to10).find((error50) => error50.name.errorId === fromError.name.errorId);
-      if (!toError) {
+      const toError2 = Object.values(to10).find((error50) => error50.name.errorId === fromError.name.errorId);
+      if (!toError2) {
         this.errors.add(`Error "${fromError.name.errorId}" with status code "${fromError.statusCode}" was removed.`);
         continue;
       }
       this.checkErrorBreakingChanges({
         from: fromError,
-        to: toError
+        to: toError2
       });
     }
   }
@@ -669171,7 +669201,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.37.4",
+          version: "5.37.5",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -669235,7 +669265,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.37.4",
+        version: "5.37.5",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -827313,27 +827343,7 @@ function deepMergeGlobalWins(local, global3) {
   }
   return result;
 }
-var THEME_FIELD_POLICIES = {
-  logo: "global",
-  favicon: "global",
-  backgroundImage: "global",
-  colors: "global",
-  typography: "global",
-  layout: "global",
-  settings: "global",
-  theme: "global",
-  integrations: "global",
-  css: "global",
-  js: "global",
-  header: "global",
-  footer: "global",
-  navbarLinks: "global",
-  footerLinks: "global",
-  aiSearch: "global",
-  announcement: "global",
-  metadata: "global"
-};
-var THEME_ELIGIBLE_KEYS = Object.keys(THEME_FIELD_POLICIES);
+var { THEME_ELIGIBLE_FIELDS: THEME_ELIGIBLE_FIELDS2, THEME_FIELD_POLICIES: THEME_FIELD_POLICIES2 } = docs_yml_exports;
 function kebabToCamel(str3) {
   return str3.replace(/-([a-z])/g, (_7, c6) => c6.toUpperCase());
 }
@@ -827358,10 +827368,10 @@ function mergeThemeOverride(local, themeOverride) {
   const normalized = normalizeThemeKeys(themeOverride);
   const localRecord = local;
   const merged = { ...localRecord };
-  for (const key2 of THEME_ELIGIBLE_KEYS) {
+  for (const key2 of THEME_ELIGIBLE_FIELDS2) {
     const themeValue = normalized[key2];
     const localValue = localRecord[key2];
-    const policy = THEME_FIELD_POLICIES[key2] ?? "global";
+    const policy = THEME_FIELD_POLICIES2[key2] ?? "global";
     const themeHasValue = themeValue !== void 0 && themeValue !== null;
     const localHasValue = localValue !== void 0 && localValue !== null;
     if (policy === "global") {
@@ -860076,6 +860086,352 @@ var import_fs30 = __toESM(require("fs"), 1);
 var import_promises97 = require("fs/promises");
 var import_http9 = __toESM(require("http"), 1);
 var import_path69 = __toESM(require("path"), 1);
+init_wrapper();
+
+// ../docs-preview/lib/DebugLogger.js
+init_lib8();
+var import_promises94 = require("fs/promises");
+var import_os9 = require("os");
+var import_path66 = __toESM(require("path"), 1);
+var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
+var LOGS_FOLDER_NAME = "logs";
+var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
+function getCliSource() {
+  const version7 = "5.37.5";
+  return `cli@${version7}`;
+}
+var DebugLogger = class {
+  logFilePath = null;
+  initialized = false;
+  sessionStartTime;
+  consoleLogger;
+  constructor() {
+    this.sessionStartTime = Date.now();
+  }
+  /**
+   * Initialize the debug logger by creating the log file
+   */
+  async initialize(consoleLogger, logsDir) {
+    if (this.initialized) {
+      return;
+    }
+    this.consoleLogger = consoleLogger;
+    const resolvedLogsDir = logsDir ?? join8(join8(AbsoluteFilePath2.of((0, import_os9.homedir)()), RelativeFilePath2.of(LOCAL_STORAGE_FOLDER4)), RelativeFilePath2.of(LOGS_FOLDER_NAME));
+    if (!await doesPathExist(resolvedLogsDir)) {
+      await (0, import_promises94.mkdir)(resolvedLogsDir, { recursive: true });
+    }
+    const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    const logFileName = `${timestamp2}.debug.log`;
+    this.logFilePath = join8(resolvedLogsDir, RelativeFilePath2.of(logFileName));
+    const header = [
+      "================================================================================",
+      `Fern Docs Dev Debug Log`,
+      `Session started: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+      `Log file: ${import_path66.default.basename(this.logFilePath)}`,
+      "================================================================================",
+      ""
+    ].join("\n");
+    await (0, import_promises94.writeFile)(this.logFilePath, header, "utf-8");
+    this.initialized = true;
+    void this.enforceLogSizeLimit(resolvedLogsDir);
+  }
+  /**
+   * Get the path to the log file
+   */
+  getLogFilePath() {
+    return this.logFilePath;
+  }
+  /**
+   * Write a log entry to the debug file
+   */
+  async writeEntry(entry) {
+    if (!this.initialized || !this.logFilePath) {
+      return;
+    }
+    const line = JSON.stringify(entry) + "\n";
+    try {
+      await (0, import_promises94.appendFile)(this.logFilePath, line, "utf-8");
+    } catch (error50) {
+    }
+  }
+  /**
+   * Log a frontend metrics message
+   */
+  async logFrontendMetrics(message) {
+    const entry = {
+      timestamp: message.timestamp,
+      source: message.source,
+      level: message.level,
+      eventType: this.getEventType(message.payload, message.isAggregate),
+      isAggregate: message.isAggregate,
+      data: message.payload
+    };
+    await this.writeEntry(entry);
+  }
+  /**
+   * Log a CLI-side metric event
+   */
+  async logCliMetric(event, level = "info") {
+    const entry = {
+      timestamp: event.timestamp,
+      source: getCliSource(),
+      level,
+      eventType: event.type,
+      data: {
+        durationMs: event.durationMs,
+        metadata: event.metadata
+      }
+    };
+    await this.writeEntry(entry);
+  }
+  /**
+   * Log CLI memory usage
+   */
+  async logCliMemory() {
+    const memUsage = process.memoryUsage();
+    const event = {
+      type: "cli_memory",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      metadata: {
+        heapUsed: memUsage.heapUsed,
+        heapTotal: memUsage.heapTotal,
+        external: memUsage.external,
+        rss: memUsage.rss,
+        heapUsedMB: Math.round(memUsage.heapUsed / 1024 / 1024 * 100) / 100,
+        heapTotalMB: Math.round(memUsage.heapTotal / 1024 / 1024 * 100) / 100,
+        rssMB: Math.round(memUsage.rss / 1024 / 1024 * 100) / 100
+      }
+    };
+    await this.logCliMetric(event);
+  }
+  /**
+   * Log CLI reload start
+   */
+  async logCliReloadStart() {
+    const event = {
+      type: "cli_reload_start",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.logCliMetric(event);
+  }
+  /**
+   * Log CLI reload finish with duration
+   */
+  async logCliReloadFinish(durationMs, metadata) {
+    const event = {
+      type: "cli_reload_finish",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      durationMs,
+      metadata
+    };
+    await this.logCliMetric(event);
+  }
+  /**
+   * Log CLI docs generation time
+   */
+  async logCliDocsGeneration(durationMs, metadata) {
+    const event = {
+      type: "cli_docs_generation",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      durationMs,
+      metadata
+    };
+    await this.logCliMetric(event);
+  }
+  /**
+   * Log CLI validation time
+   */
+  async logCliValidation(durationMs, success2) {
+    const event = {
+      type: "cli_validation",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      durationMs,
+      metadata: { success: success2 }
+    };
+    await this.logCliMetric(event);
+  }
+  /**
+   * Delete oldest log files until total directory size is within the cap.
+   */
+  async enforceLogSizeLimit(logsDir) {
+    try {
+      const entries24 = await (0, import_promises94.readdir)(logsDir);
+      const logFiles = entries24.filter((name2) => name2.endsWith(".log"));
+      const fileInfos = [];
+      for (const name2 of logFiles) {
+        const fullPath = import_path66.default.join(logsDir, name2);
+        try {
+          const stats = await (0, import_promises94.stat)(fullPath);
+          fileInfos.push({ name: name2, fullPath, size: stats.size, mtimeMs: stats.mtimeMs });
+        } catch {
+        }
+      }
+      let totalSize = fileInfos.reduce((sum, f4) => sum + f4.size, 0);
+      const totalSizeMB = Math.round(totalSize / 1024 / 1024 * 100) / 100;
+      const capMB = MAX_LOGS_DIR_SIZE_BYTES / 1024 / 1024;
+      if (totalSize <= MAX_LOGS_DIR_SIZE_BYTES) {
+        this.consoleLogger?.debug(`Log directory size ${totalSizeMB} MB does not exceed ${capMB} MB cap`);
+        return;
+      }
+      this.consoleLogger?.info(`Rotating logs: total size ${totalSizeMB} MB exceeds ${capMB} MB cap`);
+      fileInfos.sort((a3, b8) => a3.mtimeMs - b8.mtimeMs);
+      for (const file4 of fileInfos) {
+        if (totalSize <= MAX_LOGS_DIR_SIZE_BYTES) {
+          break;
+        }
+        if (this.logFilePath != null && file4.fullPath === this.logFilePath) {
+          continue;
+        }
+        try {
+          await (0, import_promises94.unlink)(file4.fullPath);
+          totalSize -= file4.size;
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  getEventType(payload, isAggregate) {
+    if (isAggregate) {
+      return "aggregate_summary";
+    }
+    if ("type" in payload && typeof payload.type === "string") {
+      return payload.type;
+    }
+    return "unknown";
+  }
+  /**
+   * Check if a WebSocket message is a metrics message
+   */
+  static isMetricsMessage(data2) {
+    if (typeof data2 !== "object" || data2 === null) {
+      return false;
+    }
+    const obj = data2;
+    return obj.type === "metrics" && typeof obj.timestamp === "string" && typeof obj.source === "string";
+  }
+};
+
+// ../docs-preview/lib/createBunServer.js
+var CORS_HEADERS = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type"
+};
+function createBunServer(options2) {
+  const bun = getBun();
+  if (bun == null) {
+    return void 0;
+  }
+  const { port, debugLogger, getDocsLoadResponse, extractLocaleFromPath } = options2;
+  const connections = /* @__PURE__ */ new Map();
+  function sendData(data2) {
+    const message = JSON.stringify(data2);
+    const dead = [];
+    for (const [ws5] of connections) {
+      try {
+        ws5.send(message);
+      } catch {
+        dead.push(ws5);
+      }
+    }
+    for (const ws5 of dead) {
+      const metadata = connections.get(ws5);
+      if (metadata) {
+        clearInterval(metadata.pingInterval);
+        connections.delete(ws5);
+      }
+    }
+  }
+  const server = bun.serve({
+    port,
+    async fetch(req, bunHttpServer) {
+      if (req.method === "OPTIONS") {
+        return new Response(null, { status: 204, headers: CORS_HEADERS });
+      }
+      const url3 = new URL(req.url);
+      if (req.headers.get("upgrade")?.toLowerCase() === "websocket") {
+        bunHttpServer.upgrade(req, { data: { connectionId: `${Date.now()}` } });
+        return void 0;
+      }
+      if (req.method === "POST" && url3.pathname === "/v2/registry/docs/load-with-url") {
+        try {
+          const body = await req.json();
+          const locale = extractLocaleFromPath?.(body?.url);
+          return new Response(JSON.stringify(getDocsLoadResponse(locale)), {
+            headers: { "Content-Type": "application/json", ...CORS_HEADERS }
+          });
+        } catch {
+          return new Response(JSON.stringify(getDocsLoadResponse()), {
+            headers: { "Content-Type": "application/json", ...CORS_HEADERS }
+          });
+        }
+      }
+      const localMatch = /^\/_local\/(.*)/.exec(url3.pathname);
+      if (req.method === "GET" && localMatch != null) {
+        return new Response(bun.file(`/${localMatch[1]}`), { headers: CORS_HEADERS });
+      }
+      return new Response("Not Found", { status: 404 });
+    },
+    websocket: {
+      open(ws5) {
+        const { connectionId } = ws5.data;
+        const pingInterval = setInterval(() => {
+          const metadata = connections.get(ws5);
+          if (!metadata) {
+            return;
+          }
+          const now = Date.now();
+          if (now - metadata.lastPong > 9e4) {
+            ws5.close();
+            return;
+          }
+          try {
+            ws5.send(JSON.stringify({ type: "ping", timestamp: now }));
+          } catch {
+            ws5.close();
+          }
+        }, 3e4);
+        connections.set(ws5, { pingInterval, lastPong: Date.now() });
+        try {
+          ws5.send(JSON.stringify({ type: "connected", connectionId }));
+        } catch {
+        }
+      },
+      message(ws5, data2) {
+        try {
+          const parsed = JSON.parse(data2.toString());
+          if (parsed.type === "pong") {
+            const metadata = connections.get(ws5);
+            if (metadata) {
+              metadata.lastPong = Date.now();
+            }
+          } else if (DebugLogger.isMetricsMessage(parsed)) {
+            void debugLogger.logFrontendMetrics(parsed);
+          }
+        } catch {
+        }
+      },
+      close(ws5) {
+        const metadata = connections.get(ws5);
+        if (metadata) {
+          clearInterval(metadata.pingInterval);
+          connections.delete(ws5);
+        }
+      }
+    }
+  });
+  return {
+    sendData,
+    stop: (closeActiveConnections) => server.stop(closeActiveConnections)
+  };
+}
+function getBun() {
+  return globalThis.Bun;
+}
+
+// ../docs-preview/lib/createDocsPreviewWatcher.js
+init_lib6();
 
 // ../../../node_modules/.pnpm/watcher@2.3.1/node_modules/watcher/dist/watcher.js
 var import_node_events7 = require("events");
@@ -860489,7 +860845,7 @@ var isFunction8 = (value2) => {
 };
 
 // ../../../node_modules/.pnpm/tiny-readdir@2.7.4/node_modules/tiny-readdir/dist/index.js
-var readdir13 = (rootPath, options2) => {
+var readdir14 = (rootPath, options2) => {
   const followSymlinks = options2?.followSymlinks ?? false;
   const maxDepth = options2?.depth ?? Infinity;
   const maxPaths = options2?.limit ?? Infinity;
@@ -860655,7 +861011,7 @@ var readdir13 = (rootPath, options2) => {
   };
   return populateResultFromRoot(rootPath);
 };
-var dist_default4 = readdir13;
+var dist_default4 = readdir14;
 
 // ../../../node_modules/.pnpm/watcher@2.3.1/node_modules/watcher/dist/utils.js
 var Utils = {
@@ -861741,349 +862097,52 @@ var Watcher = class _Watcher extends import_node_events7.EventEmitter {
 };
 var watcher_default = Watcher;
 
-// ../docs-preview/lib/runAppPreviewServer.js
-init_wrapper();
-
-// ../docs-preview/lib/DebugLogger.js
-init_lib8();
-var import_promises94 = require("fs/promises");
-var import_os9 = require("os");
-var import_path66 = __toESM(require("path"), 1);
-var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
-var LOGS_FOLDER_NAME = "logs";
-var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
-function getCliSource() {
-  const version7 = "5.37.4";
-  return `cli@${version7}`;
+// ../docs-preview/lib/createDocsPreviewWatcher.js
+function isErrnoError(error50) {
+  return "code" in error50 && typeof error50.code === "string";
 }
-var DebugLogger = class {
-  logFilePath = null;
-  initialized = false;
-  sessionStartTime;
-  consoleLogger;
-  constructor() {
-    this.sessionStartTime = Date.now();
-  }
-  /**
-   * Initialize the debug logger by creating the log file
-   */
-  async initialize(consoleLogger, logsDir) {
-    if (this.initialized) {
-      return;
-    }
-    this.consoleLogger = consoleLogger;
-    const resolvedLogsDir = logsDir ?? join8(join8(AbsoluteFilePath2.of((0, import_os9.homedir)()), RelativeFilePath2.of(LOCAL_STORAGE_FOLDER4)), RelativeFilePath2.of(LOGS_FOLDER_NAME));
-    if (!await doesPathExist(resolvedLogsDir)) {
-      await (0, import_promises94.mkdir)(resolvedLogsDir, { recursive: true });
-    }
-    const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const logFileName = `${timestamp2}.debug.log`;
-    this.logFilePath = join8(resolvedLogsDir, RelativeFilePath2.of(logFileName));
-    const header = [
-      "================================================================================",
-      `Fern Docs Dev Debug Log`,
-      `Session started: ${(/* @__PURE__ */ new Date()).toISOString()}`,
-      `Log file: ${import_path66.default.basename(this.logFilePath)}`,
-      "================================================================================",
-      ""
-    ].join("\n");
-    await (0, import_promises94.writeFile)(this.logFilePath, header, "utf-8");
-    this.initialized = true;
-    void this.enforceLogSizeLimit(resolvedLogsDir);
-  }
-  /**
-   * Get the path to the log file
-   */
-  getLogFilePath() {
-    return this.logFilePath;
-  }
-  /**
-   * Write a log entry to the debug file
-   */
-  async writeEntry(entry) {
-    if (!this.initialized || !this.logFilePath) {
-      return;
-    }
-    const line = JSON.stringify(entry) + "\n";
-    try {
-      await (0, import_promises94.appendFile)(this.logFilePath, line, "utf-8");
-    } catch (error50) {
-    }
-  }
-  /**
-   * Log a frontend metrics message
-   */
-  async logFrontendMetrics(message) {
-    const entry = {
-      timestamp: message.timestamp,
-      source: message.source,
-      level: message.level,
-      eventType: this.getEventType(message.payload, message.isAggregate),
-      isAggregate: message.isAggregate,
-      data: message.payload
-    };
-    await this.writeEntry(entry);
-  }
-  /**
-   * Log a CLI-side metric event
-   */
-  async logCliMetric(event, level = "info") {
-    const entry = {
-      timestamp: event.timestamp,
-      source: getCliSource(),
-      level,
-      eventType: event.type,
-      data: {
-        durationMs: event.durationMs,
-        metadata: event.metadata
-      }
-    };
-    await this.writeEntry(entry);
-  }
-  /**
-   * Log CLI memory usage
-   */
-  async logCliMemory() {
-    const memUsage = process.memoryUsage();
-    const event = {
-      type: "cli_memory",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      metadata: {
-        heapUsed: memUsage.heapUsed,
-        heapTotal: memUsage.heapTotal,
-        external: memUsage.external,
-        rss: memUsage.rss,
-        heapUsedMB: Math.round(memUsage.heapUsed / 1024 / 1024 * 100) / 100,
-        heapTotalMB: Math.round(memUsage.heapTotal / 1024 / 1024 * 100) / 100,
-        rssMB: Math.round(memUsage.rss / 1024 / 1024 * 100) / 100
-      }
-    };
-    await this.logCliMetric(event);
-  }
-  /**
-   * Log CLI reload start
-   */
-  async logCliReloadStart() {
-    const event = {
-      type: "cli_reload_start",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    await this.logCliMetric(event);
-  }
-  /**
-   * Log CLI reload finish with duration
-   */
-  async logCliReloadFinish(durationMs, metadata) {
-    const event = {
-      type: "cli_reload_finish",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      durationMs,
-      metadata
-    };
-    await this.logCliMetric(event);
+function toError(error50) {
+  return error50 instanceof Error ? error50 : new Error(String(error50));
+}
+function getWatcherErrorMessage(error50) {
+  if (isErrnoError(error50) && error50.code === "ENOSPC") {
+    return "Unable to watch Fern docs files for changes because the system limit for file watchers was reached. Close other file-watching processes or increase the file watcher limit, then restart `fern docs dev`.";
   }
-  /**
-   * Log CLI docs generation time
-   */
-  async logCliDocsGeneration(durationMs, metadata) {
-    const event = {
-      type: "cli_docs_generation",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      durationMs,
-      metadata
+  return `Unable to watch Fern docs files for changes: ${error50.message}`;
+}
+async function createDocsPreviewWatcher({ absoluteFilePathToFern, additionalFilepaths, context: context3 }) {
+  const watcher = new watcher_default([absoluteFilePathToFern, ...additionalFilepaths], {
+    recursive: true,
+    ignoreInitial: true,
+    debounce: 100,
+    renameDetection: true
+  });
+  const initializationError = await new Promise((resolve15) => {
+    const handleReady = () => {
+      watcher.off("error", handleError3);
+      resolve15(void 0);
     };
-    await this.logCliMetric(event);
-  }
-  /**
-   * Log CLI validation time
-   */
-  async logCliValidation(durationMs, success2) {
-    const event = {
-      type: "cli_validation",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      durationMs,
-      metadata: { success: success2 }
+    const handleError3 = (error50) => {
+      watcher.off("ready", handleReady);
+      resolve15(toError(error50));
     };
-    await this.logCliMetric(event);
-  }
-  /**
-   * Delete oldest log files until total directory size is within the cap.
-   */
-  async enforceLogSizeLimit(logsDir) {
-    try {
-      const entries24 = await (0, import_promises94.readdir)(logsDir);
-      const logFiles = entries24.filter((name2) => name2.endsWith(".log"));
-      const fileInfos = [];
-      for (const name2 of logFiles) {
-        const fullPath = import_path66.default.join(logsDir, name2);
-        try {
-          const stats = await (0, import_promises94.stat)(fullPath);
-          fileInfos.push({ name: name2, fullPath, size: stats.size, mtimeMs: stats.mtimeMs });
-        } catch {
-        }
-      }
-      let totalSize = fileInfos.reduce((sum, f4) => sum + f4.size, 0);
-      const totalSizeMB = Math.round(totalSize / 1024 / 1024 * 100) / 100;
-      const capMB = MAX_LOGS_DIR_SIZE_BYTES / 1024 / 1024;
-      if (totalSize <= MAX_LOGS_DIR_SIZE_BYTES) {
-        this.consoleLogger?.debug(`Log directory size ${totalSizeMB} MB does not exceed ${capMB} MB cap`);
-        return;
-      }
-      this.consoleLogger?.info(`Rotating logs: total size ${totalSizeMB} MB exceeds ${capMB} MB cap`);
-      fileInfos.sort((a3, b8) => a3.mtimeMs - b8.mtimeMs);
-      for (const file4 of fileInfos) {
-        if (totalSize <= MAX_LOGS_DIR_SIZE_BYTES) {
-          break;
-        }
-        if (this.logFilePath != null && file4.fullPath === this.logFilePath) {
-          continue;
-        }
-        try {
-          await (0, import_promises94.unlink)(file4.fullPath);
-          totalSize -= file4.size;
-        } catch {
-        }
-      }
-    } catch {
-    }
-  }
-  getEventType(payload, isAggregate) {
-    if (isAggregate) {
-      return "aggregate_summary";
-    }
-    if ("type" in payload && typeof payload.type === "string") {
-      return payload.type;
-    }
-    return "unknown";
-  }
-  /**
-   * Check if a WebSocket message is a metrics message
-   */
-  static isMetricsMessage(data2) {
-    if (typeof data2 !== "object" || data2 === null) {
-      return false;
-    }
-    const obj = data2;
-    return obj.type === "metrics" && typeof obj.timestamp === "string" && typeof obj.source === "string";
-  }
-};
-
-// ../docs-preview/lib/createBunServer.js
-var CORS_HEADERS = {
-  "Access-Control-Allow-Origin": "*",
-  "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
-  "Access-Control-Allow-Headers": "Content-Type"
-};
-function createBunServer(options2) {
-  const bun = getBun();
-  if (bun == null) {
-    return void 0;
-  }
-  const { port, debugLogger, getDocsLoadResponse, extractLocaleFromPath } = options2;
-  const connections = /* @__PURE__ */ new Map();
-  function sendData(data2) {
-    const message = JSON.stringify(data2);
-    const dead = [];
-    for (const [ws5] of connections) {
-      try {
-        ws5.send(message);
-      } catch {
-        dead.push(ws5);
-      }
-    }
-    for (const ws5 of dead) {
-      const metadata = connections.get(ws5);
-      if (metadata) {
-        clearInterval(metadata.pingInterval);
-        connections.delete(ws5);
-      }
-    }
+    watcher.once("ready", handleReady);
+    watcher.once("error", handleError3);
+  });
+  if (initializationError != null) {
+    watcher.close();
+    context3.failAndThrow(getWatcherErrorMessage(initializationError), initializationError, {
+      code: CliError.Code.EnvironmentError
+    });
   }
-  const server = bun.serve({
-    port,
-    async fetch(req, bunHttpServer) {
-      if (req.method === "OPTIONS") {
-        return new Response(null, { status: 204, headers: CORS_HEADERS });
-      }
-      const url3 = new URL(req.url);
-      if (req.headers.get("upgrade")?.toLowerCase() === "websocket") {
-        bunHttpServer.upgrade(req, { data: { connectionId: `${Date.now()}` } });
-        return void 0;
-      }
-      if (req.method === "POST" && url3.pathname === "/v2/registry/docs/load-with-url") {
-        try {
-          const body = await req.json();
-          const locale = extractLocaleFromPath?.(body?.url);
-          return new Response(JSON.stringify(getDocsLoadResponse(locale)), {
-            headers: { "Content-Type": "application/json", ...CORS_HEADERS }
-          });
-        } catch {
-          return new Response(JSON.stringify(getDocsLoadResponse()), {
-            headers: { "Content-Type": "application/json", ...CORS_HEADERS }
-          });
-        }
-      }
-      const localMatch = /^\/_local\/(.*)/.exec(url3.pathname);
-      if (req.method === "GET" && localMatch != null) {
-        return new Response(bun.file(`/${localMatch[1]}`), { headers: CORS_HEADERS });
-      }
-      return new Response("Not Found", { status: 404 });
-    },
-    websocket: {
-      open(ws5) {
-        const { connectionId } = ws5.data;
-        const pingInterval = setInterval(() => {
-          const metadata = connections.get(ws5);
-          if (!metadata) {
-            return;
-          }
-          const now = Date.now();
-          if (now - metadata.lastPong > 9e4) {
-            ws5.close();
-            return;
-          }
-          try {
-            ws5.send(JSON.stringify({ type: "ping", timestamp: now }));
-          } catch {
-            ws5.close();
-          }
-        }, 3e4);
-        connections.set(ws5, { pingInterval, lastPong: Date.now() });
-        try {
-          ws5.send(JSON.stringify({ type: "connected", connectionId }));
-        } catch {
-        }
-      },
-      message(ws5, data2) {
-        try {
-          const parsed = JSON.parse(data2.toString());
-          if (parsed.type === "pong") {
-            const metadata = connections.get(ws5);
-            if (metadata) {
-              metadata.lastPong = Date.now();
-            }
-          } else if (DebugLogger.isMetricsMessage(parsed)) {
-            void debugLogger.logFrontendMetrics(parsed);
-          }
-        } catch {
-        }
-      },
-      close(ws5) {
-        const metadata = connections.get(ws5);
-        if (metadata) {
-          clearInterval(metadata.pingInterval);
-          connections.delete(ws5);
-        }
-      }
-    }
+  watcher.on("error", (error50) => {
+    const watcherError = toError(error50);
+    context3.failWithoutThrowing(getWatcherErrorMessage(watcherError), watcherError, {
+      code: CliError.Code.EnvironmentError
+    });
+    watcher.close();
   });
-  return {
-    sendData,
-    stop: (closeActiveConnections) => server.stop(closeActiveConnections)
-  };
-}
-function getBun() {
-  return globalThis.Bun;
+  return watcher;
 }
 
 // ../docs-preview/lib/downloadLocalDocsBundle.js
@@ -863724,11 +863783,10 @@ ${err.stack}`);
     slugTracker.initialize(previewResult.docsDefinition);
   }
   const additionalFilepaths = project.apiWorkspaces.flatMap((workspace) => workspace.getAbsoluteFilePaths());
-  const watcher = new watcher_default([absoluteFilePathToFern, ...additionalFilepaths], {
-    recursive: true,
-    ignoreInitial: true,
-    debounce: 100,
-    renameDetection: true
+  const watcher = await createDocsPreviewWatcher({
+    absoluteFilePathToFern,
+    additionalFilepaths,
+    context: context3
   });
   const editedAbsoluteFilepaths = [];
   function extractLocaleFromPath(urlPath) {
@@ -864287,11 +864345,10 @@ ${err.stack}`);
   }
   const additionalFilepaths = project.apiWorkspaces.flatMap((workspace) => workspace.getAbsoluteFilePaths());
   const bundleRoot = bundlePath ? AbsoluteFilePath2.of(import_path70.default.resolve(bundlePath)) : getPathToBundleFolder({ cacheDir });
-  const watcher = new watcher_default([absoluteFilePathToFern, ...additionalFilepaths], {
-    recursive: true,
-    ignoreInitial: true,
-    debounce: 100,
-    renameDetection: true
+  const watcher = await createDocsPreviewWatcher({
+    absoluteFilePathToFern,
+    additionalFilepaths,
+    context: context3
   });
   const editedAbsoluteFilepaths = [];
   watcher.on("all", async (event, targetPath, _targetPathNext) => {
@@ -880641,7 +880698,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.37.4",
+        cliVersion: "5.37.5",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -955562,7 +955619,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.37.4"
+    cli_version: "5.37.5"
   };
 }
 function isAutomationMode() {
@@ -956388,7 +956445,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.37.4";
+    return "5.37.5";
   }
   getCliName() {
     if (false) {
@@ -965120,23 +965177,6 @@ init_lib8();
 var import_promises189 = require("fs/promises");
 init_js_yaml();
 var import_path105 = __toESM(require("path"), 1);
-var THEME_ELIGIBLE_KEYS2 = /* @__PURE__ */ new Set([
-  "logo",
-  "favicon",
-  "colors",
-  "typography",
-  "layout",
-  "navbar-links",
-  "footer-links",
-  "background-image",
-  "theme",
-  "css",
-  "js",
-  "header",
-  "footer",
-  "metadata",
-  "settings"
-]);
 var ThemeExporter = class {
   constructor(docsWorkspace) {
     this.docsWorkspace = docsWorkspace;
@@ -965150,7 +965190,7 @@ var ThemeExporter = class {
     const raw = jsYaml.load(await (0, import_promises189.readFile)(docsYmlPath, "utf-8"));
     const themeConfig = {};
     for (const [k5, v9] of Object.entries(raw)) {
-      if (THEME_ELIGIBLE_KEYS2.has(k5)) {
+      if (docs_yml_exports.THEME_ELIGIBLE_YAML_KEYS.has(k5)) {
         themeConfig[k5] = v9;
       }
     }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.37.4",
+  "version": "5.37.5",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",