@fern-api/fdr-sdk 1.2.93-91063bdea2 → 1.2.93-c507986598

package/dist/js/client/FdrClient.mjs

@@ -2960,6 +2960,120 @@ import { OpenAPILink as OpenAPILink5 } from "@orpc/openapi-client/fetch";
 // src/orpc-client/docs/v2/library-docs/contract.ts
 import { oc as oc6 } from "@orpc/contract";
 import * as z14 from "zod";
+
+// src/orpc-client/docs/v2/library-docs/doxyfile.ts
+var MAX_DOXYFILE_CONTENT_LENGTH = 262144;
+var SETTING_LINE_RE = /^\s*([A-Z][A-Z0-9_]*)\s*(\+?=)(.*)$/;
+var AT_DIRECTIVE_RE = /^\s*@[A-Z_]+\b/;
+var BOOL_RE = /^(?:YES|NO)$/i;
+var FILE_PATTERN_RE = /^[A-Za-z0-9_.*?+-]+$/;
+var PREDEFINED_RE = /^[A-Za-z_][A-Za-z0-9_]*(?:\([A-Za-z0-9_,. ]*\))?(?::?=.*)?$/;
+var ALIAS_DEF_RE = /^\w+(?:\{\d+\})?=/;
+var DOXYFILE_ALLOWED_KEYS = {
+  ALIASES: (value) => ALIAS_DEF_RE.test(value),
+  PREDEFINED: (value) => PREDEFINED_RE.test(value),
+  FILE_PATTERNS: (value) => FILE_PATTERN_RE.test(value),
+  OPTIMIZE_OUTPUT_FOR_C: (value) => BOOL_RE.test(value)
+};
+function joinContinuations(text) {
+  const logical = [];
+  let buffer = "";
+  for (const rawLine of text.split(/\r?\n/)) {
+    const line = rawLine.replace(/\s+$/, "");
+    if (line.endsWith("\\") && !line.endsWith("\\\\")) {
+      buffer += `${line.slice(0, -1)} `;
+      continue;
+    }
+    buffer += line;
+    logical.push(buffer);
+    buffer = "";
+  }
+  if (buffer) {
+    logical.push(buffer);
+  }
+  return logical;
+}
+function tokenizeValue(value) {
+  const tokens = [];
+  let i = 0;
+  const n = value.length;
+  while (i < n) {
+    const ch = value[i];
+    if (/\s/.test(ch ?? "")) {
+      i++;
+      continue;
+    }
+    if (ch === '"') {
+      i++;
+      let buf = "";
+      while (i < n) {
+        const c = value[i];
+        if (c === "\\" && i + 1 < n && value[i + 1] === '"') {
+          buf += '"';
+          i += 2;
+          continue;
+        }
+        if (c === '"') {
+          i++;
+          break;
+        }
+        buf += c;
+        i++;
+      }
+      tokens.push(buf);
+    } else {
+      let j = i;
+      while (j < n && !/\s/.test(value[j] ?? "")) {
+        j++;
+      }
+      tokens.push(value.slice(i, j));
+      i = j;
+    }
+  }
+  return tokens;
+}
+function validateDoxyfileContent(content) {
+  const errors = [];
+  const droppedKeys = [];
+  if (content.length > MAX_DOXYFILE_CONTENT_LENGTH) {
+    errors.push(`doxyfileContent exceeds ${MAX_DOXYFILE_CONTENT_LENGTH} characters`);
+    return { errors, droppedKeys };
+  }
+  for (const line of joinContinuations(content)) {
+    const stripped = line.trim();
+    if (!stripped || stripped.startsWith("#")) {
+      continue;
+    }
+    if (AT_DIRECTIVE_RE.test(stripped)) {
+      const directive = stripped.split(/\s+/)[0] ?? stripped;
+      if (!droppedKeys.includes(directive)) {
+        droppedKeys.push(directive);
+      }
+      continue;
+    }
+    const match = SETTING_LINE_RE.exec(line);
+    if (match == null) {
+      continue;
+    }
+    const key = match[1] ?? "";
+    const rawValue = match[3] ?? "";
+    const validator = DOXYFILE_ALLOWED_KEYS[key];
+    if (validator == null) {
+      if (!droppedKeys.includes(key)) {
+        droppedKeys.push(key);
+      }
+      continue;
+    }
+    for (const token of tokenizeValue(rawValue)) {
+      if (token.endsWith("\\") || token.includes("$(") || !validator(token)) {
+        errors.push(`Invalid value for Doxyfile setting ${key}: ${JSON.stringify(token)}`);
+      }
+    }
+  }
+  return { errors, droppedKeys };
+}
+
+// src/orpc-client/docs/v2/library-docs/contract.ts
 var ALLOWED_HOSTNAMES = /* @__PURE__ */ new Set(["github.com", "gitlab.com"]);
 var GithubUrlSchema = z14.string().url().describe(
   "HTTPS URL of a GitHub or GitLab repository. Currently only github.com and gitlab.com are supported. Must match the pattern https://github.com/<owner>/<repo> or https://gitlab.com/<owner>/<repo>."
@@ -2994,8 +3108,13 @@ var LibraryDocsBaseConfigSchema = z14.object({
   slug: z14.string().nullish()
 });
 var PythonLibraryDocsConfigSchema = LibraryDocsBaseConfigSchema;
+var SafeDoxyfileContentSchema = z14.string().superRefine((content, ctx) => {
+  for (const error of validateDoxyfileContent(content).errors) {
+    ctx.addIssue({ code: z14.ZodIssueCode.custom, message: error });
+  }
+}).nullish();
 var CppLibraryDocsConfigSchema = LibraryDocsBaseConfigSchema.extend({
-  doxyfileContent: z14.string().nullish()
+  doxyfileContent: SafeDoxyfileContentSchema
 });
 var StartLibraryDocsGenerationInputSchema = z14.discriminatedUnion("language", [
   z14.object({