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

package/dist/js/orpc-client.js

@@ -92,6 +92,7 @@ __export(orpc_client_exports, {
   CurrentVersionInputSchema: () => CurrentVersionInputSchema,
   CurrentVersionResponseSchema: () => CurrentVersionResponseSchema,
   CustomSnippetPayloadSchema: () => CustomSnippetPayloadSchema,
+  DOXYFILE_ALLOWED_KEYS: () => DOXYFILE_ALLOWED_KEYS,
   DashboardAnalyticsCommonInputSchema: () => DashboardAnalyticsCommonInputSchema,
   DashboardDocsSiteSchema: () => DashboardDocsSiteSchema,
   DashboardFeedbackInputSchema: () => DashboardFeedbackInputSchema,
@@ -386,6 +387,7 @@ __export(orpc_client_exports, {
   LoadDocsForUrlResponseSchema: () => LoadDocsForUrlResponseSchema,
   LocaleEntrySchema: () => LocaleEntrySchema,
   LongTypeSchema: () => LongTypeSchema,
+  MAX_DOXYFILE_CONTENT_LENGTH: () => MAX_DOXYFILE_CONTENT_LENGTH,
   ManifestApiDefSchema: () => ManifestApiDefSchema,
   ManifestBlobRefSchema: () => ManifestBlobRefSchema,
   ManifestFileSchema: () => ManifestFileSchema,
@@ -524,6 +526,7 @@ __export(orpc_client_exports, {
   RouteContextInputSchema: () => RouteContextInputSchema,
   RouteContextResponseSchema: () => RouteContextResponseSchema,
   RubyGemSchema: () => RubyGemSchema,
+  SafeDoxyfileContentSchema: () => SafeDoxyfileContentSchema,
   ScalarTypeSchema: () => ScalarTypeSchema,
   ScriptSchema: () => ScriptSchema,
   SdkDynamicIrDownloadSchema: () => SdkDynamicIrDownloadSchema,
@@ -677,7 +680,8 @@ __export(orpc_client_exports, {
   snippetsFactoryContract: () => snippetsFactoryContract,
   stableStringify: () => stableStringify,
   templatesContract: () => templatesContract,
-  tokensContract: () => tokensContract
+  tokensContract: () => tokensContract,
+  validateDoxyfileContent: () => validateDoxyfileContent
 });
 module.exports = __toCommonJS(orpc_client_exports);
 var import_client47 = require("@orpc/client");
@@ -2700,7 +2704,9 @@ var GetDocsStatusResponseSchema = z8.object({
 });
 var GetDocsDeploymentsResponseSchema = z8.object({
   deployments: z8.array(DocsDeploymentSchema),
-  hasMore: z8.boolean()
+  hasMore: z8.boolean(),
+  /** Pass back as `cursor` to fetch the next page. Absent when `hasMore` is false. */
+  nextCursor: z8.string().optional()
 });
 var CreateDeploymentResponseSchema = z8.object({
   deploymentId: z8.string()
@@ -2858,7 +2864,9 @@ var DashboardFeedbackInputSchema = z10.object({
   domain: z10.string().min(1),
   dateRange: z10.string().optional(),
   feedbackType: z10.enum(["page", "code_block", "all"]).optional(),
-  limit: z10.number().int().min(1).max(50).optional()
+  limit: z10.number().int().min(1).max(50).optional(),
+  /** `nextCursor` from a previous page; continues that page's ordering. */
+  cursor: z10.string().optional()
 });
 var DashboardListOrgMembersInputSchema = z10.object({
   orgId: z10.string(),
@@ -2917,20 +2925,37 @@ var LlmBotTrafficResponseSchema = z10.object({
 });
 var RecentFeedbackResponseSchema = z10.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: z10.number(),
   unhelpfulCount: z10.number(),
+  codeBlockCount: z10.number(),
+  /** Entries matching the filters over the whole date range. */
+  totalCount: z10.number(),
   entries: z10.array(
     z10.object({
       date: z10.string(),
       location: z10.string(),
+      /** Always false for code-block reports, which carry no vote. */
       wasHelpful: z10.boolean(),
       userFeedback: z10.string(),
       feedbackType: z10.string().optional(),
       /** URL of the docs page the feedback was submitted on. */
-      url: z10.string().optional()
+      url: z10.string().optional(),
+      /** What the reader selected on the page, for page feedback. */
+      selection: z10.string().optional(),
+      /** Language of the code block a code-block report was filed against. */
+      language: z10.string().optional(),
+      /** The reported code block, truncated. */
+      code: z10.string().optional()
     })
   ),
-  hasMore: z10.boolean()
+  hasMore: z10.boolean(),
+  /** Pass back as `cursor` to fetch the next page. Absent when `hasMore` is false. */
+  nextCursor: z10.string().optional()
 });
 var QueryAnalyticsResponseSchema = z10.object({
   resolvedDateRange: ResolvedDateRangeSchema,
@@ -2945,7 +2970,11 @@ var QueryAnalyticsResponseSchema = z10.object({
       visitors: z10.number().optional(),
       sessions: z10.number().optional()
     })
-  )
+  ),
+  /** The row cap the query ran with, after clamping. */
+  limit: z10.number(),
+  /** True when the metric had more rows than `limit`, so `rows` is a truncated ranking. */
+  hasMore: z10.boolean()
 });
 var OrgMembersResponseSchema = z10.object({
   members: z10.array(
@@ -3832,6 +3861,120 @@ var import_fetch5 = require("@orpc/openapi-client/fetch");
 // src/orpc-client/docs/v2/library-docs/contract.ts
 var import_contract10 = require("@orpc/contract");
 var z15 = __toESM(require("zod"), 1);
+
+// 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 = z15.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>."
@@ -3866,8 +4009,13 @@ var LibraryDocsBaseConfigSchema = z15.object({
   slug: z15.string().nullish()
 });
 var PythonLibraryDocsConfigSchema = LibraryDocsBaseConfigSchema;
+var SafeDoxyfileContentSchema = z15.string().superRefine((content, ctx) => {
+  for (const error of validateDoxyfileContent(content).errors) {
+    ctx.addIssue({ code: z15.ZodIssueCode.custom, message: error });
+  }
+}).nullish();
 var CppLibraryDocsConfigSchema = LibraryDocsBaseConfigSchema.extend({
-  doxyfileContent: z15.string().nullish()
+  doxyfileContent: SafeDoxyfileContentSchema
 });
 var StartLibraryDocsGenerationInputSchema = z15.discriminatedUnion("language", [
   z15.object({
@@ -7099,6 +7247,7 @@ var UpsertThemeBodySchema = z37.object({
   CurrentVersionInputSchema,
   CurrentVersionResponseSchema,
   CustomSnippetPayloadSchema,
+  DOXYFILE_ALLOWED_KEYS,
   DashboardAnalyticsCommonInputSchema,
   DashboardDocsSiteSchema,
   DashboardFeedbackInputSchema,
@@ -7393,6 +7542,7 @@ var UpsertThemeBodySchema = z37.object({
   LoadDocsForUrlResponseSchema,
   LocaleEntrySchema,
   LongTypeSchema,
+  MAX_DOXYFILE_CONTENT_LENGTH,
   ManifestApiDefSchema,
   ManifestBlobRefSchema,
   ManifestFileSchema,
@@ -7531,6 +7681,7 @@ var UpsertThemeBodySchema = z37.object({
   RouteContextInputSchema,
   RouteContextResponseSchema,
   RubyGemSchema,
+  SafeDoxyfileContentSchema,
   ScalarTypeSchema,
   ScriptSchema,
   SdkDynamicIrDownloadSchema,
@@ -7684,6 +7835,7 @@ var UpsertThemeBodySchema = z37.object({
   snippetsFactoryContract,
   stableStringify,
   templatesContract,
-  tokensContract
+  tokensContract,
+  validateDoxyfileContent
 });
 //# sourceMappingURL=orpc-client.js.map