@fern-api/fdr-sdk 1.2.93-9d4e38f080 → 1.2.94-cdc1690f8b

package/dist/js/client/FdrClient.mjs

@@ -1803,7 +1803,9 @@ var GetDocsStatusResponseSchema = z7.object({
 });
 var GetDocsDeploymentsResponseSchema = z7.object({
   deployments: z7.array(DocsDeploymentSchema),
-  hasMore: z7.boolean()
+  hasMore: z7.boolean(),
+  /** Pass back as `cursor` to fetch the next page. Absent when `hasMore` is false. */
+  nextCursor: z7.string().optional()
 });
 var CreateDeploymentResponseSchema = z7.object({
   deploymentId: z7.string()
@@ -1961,7 +1963,9 @@ var DashboardFeedbackInputSchema = z9.object({
   domain: z9.string().min(1),
   dateRange: z9.string().optional(),
   feedbackType: z9.enum(["page", "code_block", "all"]).optional(),
-  limit: z9.number().int().min(1).max(50).optional()
+  limit: z9.number().int().min(1).max(50).optional(),
+  /** `nextCursor` from a previous page; continues that page's ordering. */
+  cursor: z9.string().optional()
 });
 var DashboardListOrgMembersInputSchema = z9.object({
   orgId: z9.string(),
@@ -2020,20 +2024,37 @@ var LlmBotTrafficResponseSchema = z9.object({
 });
 var RecentFeedbackResponseSchema = z9.object({
   resolvedDateRange: ResolvedDateRangeSchema,
+  /**
+   * Vote counts over the whole date range, not just the returned page, and over page
+   * feedback only: code-block reports carry no helpful/unhelpful vote and are counted
+   * by `codeBlockCount` instead.
+   */
   helpfulCount: z9.number(),
   unhelpfulCount: z9.number(),
+  codeBlockCount: z9.number(),
+  /** Entries matching the filters over the whole date range. */
+  totalCount: z9.number(),
   entries: z9.array(
     z9.object({
       date: z9.string(),
       location: z9.string(),
+      /** Always false for code-block reports, which carry no vote. */
       wasHelpful: z9.boolean(),
       userFeedback: z9.string(),
       feedbackType: z9.string().optional(),
       /** URL of the docs page the feedback was submitted on. */
-      url: z9.string().optional()
+      url: z9.string().optional(),
+      /** What the reader selected on the page, for page feedback. */
+      selection: z9.string().optional(),
+      /** Language of the code block a code-block report was filed against. */
+      language: z9.string().optional(),
+      /** The reported code block, truncated. */
+      code: z9.string().optional()
     })
   ),
-  hasMore: z9.boolean()
+  hasMore: z9.boolean(),
+  /** Pass back as `cursor` to fetch the next page. Absent when `hasMore` is false. */
+  nextCursor: z9.string().optional()
 });
 var QueryAnalyticsResponseSchema = z9.object({
   resolvedDateRange: ResolvedDateRangeSchema,
@@ -2048,7 +2069,11 @@ var QueryAnalyticsResponseSchema = z9.object({
       visitors: z9.number().optional(),
       sessions: z9.number().optional()
     })
-  )
+  ),
+  /** The row cap the query ran with, after clamping. */
+  limit: z9.number(),
+  /** True when the metric had more rows than `limit`, so `rows` is a truncated ranking. */
+  hasMore: z9.boolean()
 });
 var OrgMembersResponseSchema = z9.object({
   members: z9.array(
@@ -2935,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>."
@@ -2969,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({