@fern-api/fdr-sdk 1.2.73-c5de911f8d → 1.2.73-d4652c951f

package/dist/js/converters/index.mjs

@@ -1379,6 +1379,9 @@ var RegisterExampleEndpointCallSchema = z3.object({
   description: z3.string().nullish(),
   name: z3.string().nullish(),
   contentType: z3.string().nullish(),
+  // When the request body is a discriminated union and one example is generated per variant,
+  // this carries the variant's discriminant value so the UI can swap examples when the variant changes.
+  discriminant: z3.string().nullish(),
   path: z3.string(),
   pathParameters: z3.record(PropertyKeySchema, z3.unknown()),
   queryParameters: z3.record(z3.string(), z3.unknown()),
@@ -1952,6 +1955,7 @@ var LatestExampleEndpointCallSchema = z4.object({
   responseStatusCode: z4.number().int(),
   name: z4.string().nullish(),
   contentType: z4.string().nullish(),
+  discriminant: z4.string().nullish(),
   pathParameters: z4.record(PropertyKeySchema, z4.unknown()).nullish(),
   queryParameters: z4.record(PropertyKeySchema, z4.unknown()).nullish(),
   headers: z4.record(PropertyKeySchema, z4.unknown()).nullish(),
@@ -2226,6 +2230,7 @@ var ReadExampleEndpointCallSchema = z5.object({
   description: z5.string().nullish(),
   name: z5.string().nullish(),
   contentType: z5.string().nullish(),
+  discriminant: z5.string().nullish(),
   path: z5.string(),
   pathParameters: z5.record(PropertyKeySchema, z5.unknown()),
   queryParameters: z5.record(z5.string(), z5.unknown()),
@@ -6099,6 +6104,52 @@ function generateHttpRequestBodyExample(type, resolveTypeById) {
     }
   }
 }
+function resolveRequestBodyDiscriminatedUnion(type, resolveTypeById) {
+  let shape;
+  switch (type.type) {
+    case "reference":
+      shape = resolveTypeReferenceToShape(type.value, resolveTypeById, /* @__PURE__ */ new Set());
+      break;
+    case "json":
+      shape = type.shape.type === "reference" ? resolveTypeReferenceToShape(type.shape.value, resolveTypeById, /* @__PURE__ */ new Set()) : void 0;
+      break;
+    default:
+      return void 0;
+  }
+  return shape?.type === "discriminatedUnion" ? shape : void 0;
+}
+function resolveTypeReferenceToShape(reference, resolveTypeById, visited) {
+  switch (reference.type) {
+    case "id": {
+      if (visited.has(reference.value)) {
+        return void 0;
+      }
+      visited.add(reference.value);
+      const typeDef = resolveTypeById(reference.value);
+      if (typeDef == null) {
+        return void 0;
+      }
+      if (typeDef.shape.type === "alias") {
+        return resolveTypeReferenceToShape(typeDef.shape.value, resolveTypeById, visited);
+      }
+      return typeDef.shape;
+    }
+    case "optional":
+    case "nullable":
+      return resolveTypeReferenceToShape(reference.itemType, resolveTypeById, visited);
+    default:
+      return void 0;
+  }
+}
+function generateDiscriminatedUnionVariantRequestExample(discriminant, variant, resolveTypeById) {
+  return {
+    type: "json",
+    value: {
+      [discriminant]: variant.discriminantValue,
+      ...generateExampleObject(variant.additionalProperties, resolveTypeById, true, /* @__PURE__ */ new Set(), 0)
+    }
+  };
+}
 function generateFormDataRequestBodyExample(FormDataRequest, resolveTypeById) {
   if (FormDataRequest == null) {
     return { type: "form", value: {} };
@@ -6480,6 +6531,32 @@ function generateEndpointSuccessExample({
     responseBodyV3: endpointDefinition.response != null ? generateHttpResponseBodyExample(endpointDefinition.response.type, resolveTypeById) : void 0
   };
 }
+function generateEndpointSuccessExamples({
+  endpointDefinition,
+  apiDefinition
+}) {
+  const resolveTypeById = getResolveByTypeId(apiDefinition);
+  const discriminatedUnion11 = endpointDefinition.request != null ? resolveRequestBodyDiscriminatedUnion(endpointDefinition.request.type, resolveTypeById) : void 0;
+  if (discriminatedUnion11 == null || discriminatedUnion11.variants.length <= 1) {
+    return [generateEndpointSuccessExample({ endpointDefinition, apiDefinition })];
+  }
+  const base = generateBaseEndpointExample({ endpointDefinition, apiDefinition, resolveTypeById });
+  const responseBodyV3 = endpointDefinition.response != null ? generateHttpResponseBodyExample(endpointDefinition.response.type, resolveTypeById) : void 0;
+  return discriminatedUnion11.variants.map((variant) => ({
+    ...base,
+    // Use `||` (not `??`) so an empty-string displayName falls back to the (always-present,
+    // unique) discriminant value — keeping example names non-empty and distinct.
+    name: variant.displayName || variant.discriminantValue,
+    discriminant: variant.discriminantValue,
+    requestBodyV3: generateDiscriminatedUnionVariantRequestExample(
+      discriminatedUnion11.discriminant,
+      variant,
+      resolveTypeById
+    ),
+    responseStatusCode: 200,
+    responseBodyV3
+  }));
+}
 function generateBaseEndpointExample({
   endpointDefinition,
   apiDefinition,
@@ -6967,11 +7044,11 @@ function getExampleEndpointCalls({
   if (registeredSuccessExamples.length > 0) {
     examples.push(...registeredSuccessExamples);
   } else {
-    const generatedSuccessExample = generateEndpointSuccessExample({
+    const generatedSuccessExamples = generateEndpointSuccessExamples({
       endpointDefinition: writeShape,
       apiDefinition
     });
-    examples.push(generatedSuccessExample);
+    examples.push(...generatedSuccessExamples);
   }
   const registeredErrorExampleStatusCodes = new Set(registeredErrorExamples.map((e) => e.responseStatusCode));
   const errorsMissingAnExample = (writeShape.errorsV2 ?? []).filter(
@@ -7050,6 +7127,7 @@ function transformExampleEndpointCall({
   return {
     name: writeShape.name,
     contentType: writeShape.contentType ?? void 0,
+    discriminant: writeShape.discriminant ?? void 0,
     description: writeShape.description,
     // htmlDescription,
     // descriptionContainsMarkdown: true,
@@ -9968,6 +10046,7 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
           responseStatusCode: example?.responseStatusCode,
           name: example?.name,
           contentType: example?.contentType ?? void 0,
+          discriminant: example?.discriminant ?? void 0,
           description: example?.description,
           pathParameters: example?.pathParameters,
           queryParameters: example?.queryParameters,
@@ -14736,6 +14815,30 @@ var NodeCollector = class _NodeCollector {
   getNodesInOrder = () => {
     return this.nodesInOrder;
   };
+  /**
+   * The distinct RBAC roles referenced anywhere in the navigation, collected from every node's
+   * `viewers`. This is the authoritative source of "which roles gate content on this site" — the
+   * top-level `root.roles` is not populated by the nav builders, and docs.yml's declared `roles`
+   * list is not serialized into the docs definition, so the roles that actually exist are the ones
+   * appearing in node `viewers` (e.g. the implicit `everyone` plus any custom roles like `beta`).
+   *
+   * NOTE: this is a faithful collection of every role in `viewers` — it INCLUDES the implicit
+   * `everyone` role when present (kept deliberately, so callers can e.g. detect whether a site uses
+   * RBAC at all). Consumers that want only masquerade-able custom roles MUST filter `everyone`
+   * themselves (the preview widget does this via `EVERYONE_ROLE`).
+   */
+  getRoles = once(() => {
+    const roles = /* @__PURE__ */ new Set();
+    for (const node of this.nodesInOrder) {
+      const viewers = node.viewers;
+      if (viewers != null) {
+        for (const role of viewers) {
+          roles.add(role);
+        }
+      }
+    }
+    return Array.from(roles);
+  });
 };
 var MAX_CHANGELOG_ENTRIES_MINIMUM = 15;
 var CHANGELOG_RECENCY_MONTHS = 6;
@@ -17224,6 +17327,7 @@ function convertExampleEndpointCall({
   return {
     name: dbShape.name,
     contentType: dbShape.contentType ?? void 0,
+    discriminant: dbShape.discriminant ?? void 0,
     description: dbShape.description,
     // htmlDescription: dbShape.htmlDescription,
     // descriptionContainsMarkdown: true,