fern-api 0.30.5 → 0.30.7

package/bundle.cjs

@@ -352084,6 +352084,12 @@ var init_WebhookHttpMethod = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/api/resources/webhooks/types/ExampleWebhookCall.js
+var init_ExampleWebhookCall = __esm({
+  "pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/api/resources/webhooks/types/ExampleWebhookCall.js"() {
+  }
+});
+
 // pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/api/resources/webhooks/types/index.js
 var init_types12 = __esm({
   "pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/api/resources/webhooks/types/index.js"() {
@@ -352095,6 +352101,7 @@ var init_types12 = __esm({
     init_InlinedWebhookPayload();
     init_InlinedWebhookPayloadProperty();
     init_WebhookHttpMethod();
+    init_ExampleWebhookCall();
   }
 });
 
@@ -357013,7 +357020,8 @@ var init_Webhook2 = __esm({
       displayName: schemas_exports4.string().optional(),
       method: schemas_exports4.lazy(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).WebhookHttpMethod),
       headers: schemas_exports4.list(schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).HttpHeader)),
-      payload: schemas_exports4.lazy(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).WebhookPayload)
+      payload: schemas_exports4.lazy(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).WebhookPayload),
+      examples: schemas_exports4.list(schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).ExampleWebhookCall)).optional()
     }).extend(schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).Declaration));
   }
 });
@@ -357097,6 +357105,18 @@ var init_WebhookHttpMethod2 = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/serialization/resources/webhooks/types/ExampleWebhookCall.js
+var ExampleWebhookCall;
+var init_ExampleWebhookCall2 = __esm({
+  "pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/serialization/resources/webhooks/types/ExampleWebhookCall.js"() {
+    init_core2();
+    ExampleWebhookCall = schemas_exports4.objectWithoutOptionalProperties({
+      name: schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).Name).optional(),
+      payload: schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).ExampleTypeReference)
+    }).extend(schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).WithDocs));
+  }
+});
+
 // pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/serialization/resources/webhooks/types/index.js
 var init_types24 = __esm({
   "pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/serialization/resources/webhooks/types/index.js"() {
@@ -357108,12 +357128,14 @@ var init_types24 = __esm({
     init_InlinedWebhookPayload2();
     init_InlinedWebhookPayloadProperty2();
     init_WebhookHttpMethod2();
+    init_ExampleWebhookCall2();
   }
 });
 
 // pnp:/home/circleci/project/packages/ir-sdk/lib/sdk/serialization/resources/webhooks/index.js
 var webhooks_exports2 = {};
 __export(webhooks_exports2, {
+  ExampleWebhookCall: () => ExampleWebhookCall,
   InlinedWebhookPayload: () => InlinedWebhookPayload,
   InlinedWebhookPayloadProperty: () => InlinedWebhookPayloadProperty,
   Webhook: () => Webhook,
@@ -357445,6 +357467,7 @@ __export(serialization_exports2, {
   ExampleWebSocketMessage: () => ExampleWebSocketMessage2,
   ExampleWebSocketMessageBody: () => ExampleWebSocketMessageBody2,
   ExampleWebSocketSession: () => ExampleWebSocketSession2,
+  ExampleWebhookCall: () => ExampleWebhookCall,
   FeatureId: () => FeatureId,
   FernFilepath: () => FernFilepath,
   FileDownloadResponse: () => FileDownloadResponse,
@@ -363877,6 +363900,12 @@ var init_Webhook3 = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/WebhookExampleCall.js
+var init_WebhookExampleCall = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/WebhookExampleCall.js"() {
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/WebsocketChannel.js
 var init_WebsocketChannel = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/WebsocketChannel.js"() {
@@ -364903,6 +364932,7 @@ var init_types28 = __esm({
     init_Tags();
     init_HttpError();
     init_Webhook3();
+    init_WebhookExampleCall();
     init_WebsocketChannel();
     init_WebsocketHandshake();
     init_WebsocketSessionExample();
@@ -367732,7 +367762,20 @@ var init_Webhook4 = __esm({
       tags: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).TagId)),
       headers: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Header)),
       generatedPayloadName: schemas_exports5.string(),
-      payload: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Schema)
+      payload: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Schema),
+      examples: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WebhookExampleCall))
+    }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
+  }
+});
+
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/WebhookExampleCall.js
+var WebhookExampleCall;
+var init_WebhookExampleCall2 = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/WebhookExampleCall.js"() {
+    init_core3();
+    WebhookExampleCall = schemas_exports5.objectWithoutOptionalProperties({
+      name: schemas_exports5.string().optional(),
+      payload: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).FullExample)
     }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
   }
 });
@@ -368731,6 +368774,7 @@ var init_types32 = __esm({
     init_Tags2();
     init_HttpError2();
     init_Webhook4();
+    init_WebhookExampleCall2();
     init_WebsocketChannel2();
     init_WebsocketHandshake2();
     init_WebsocketSessionExample2();
@@ -368861,6 +368905,7 @@ __export(finalIr_exports2, {
   TextResponse: () => TextResponse2,
   UnDiscriminatedOneOfSchema: () => UnDiscriminatedOneOfSchema,
   Webhook: () => Webhook2,
+  WebhookExampleCall: () => WebhookExampleCall,
   WebhookHttpMethod: () => WebhookHttpMethod5,
   WebsocketChannel: () => WebsocketChannel,
   WebsocketHandshake: () => WebsocketHandshake,
@@ -369683,6 +369728,7 @@ __export(serialization_exports3, {
   UnDiscriminatedOneOfSchemaWithExample: () => UnDiscriminatedOneOfSchemaWithExample,
   UnknownSchemaWithExample: () => UnknownSchemaWithExample,
   Webhook: () => Webhook2,
+  WebhookExampleCall: () => WebhookExampleCall,
   WebhookHttpMethod: () => WebhookHttpMethod5,
   WebsocketChannel: () => WebsocketChannel,
   WebsocketHandshake: () => WebsocketHandshake,
@@ -1030215,7 +1030261,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.30.5",
+          version: "0.30.7",
           usingAccessToken: true
         }
       });
@@ -1030277,7 +1030323,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.30.5",
+        version: "0.30.7",
         ...event,
         ...event.properties
       }
@@ -1040928,6 +1040974,7 @@ async function visitWebhooks({ webhook, visitor, nodePathForWebhook }) {
   await visitObject(webhook, {
     "display-name": noop,
     method: noop,
+    examples: noop,
     headers: async (headers) => {
       await visitHeaders2({
         headers,
@@ -1041420,6 +1041467,7 @@ __export(schemas_exports3, {
   ExampleTypeSchema: () => ExampleTypeSchema,
   ExampleTypeValueSchema: () => ExampleTypeValueSchema,
   ExampleWebSocketSession: () => ExampleWebSocketSession,
+  ExampleWebhookCallSchema: () => ExampleWebhookCallSchema,
   HeaderAuthSchemeSchema: () => HeaderAuthSchemeSchema,
   HttpEndpointSchema: () => HttpEndpointSchema,
   HttpHeaderSchema: () => HttpHeaderSchema,
@@ -1041839,6 +1041887,13 @@ var ExampleEndpointCallSchema = WithNameAndDocsSchema.extend({
 });
 var ExampleEndpointCallArraySchema = z.array(ExampleEndpointCallSchema);
 
+// pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/ExampleWebhookCallSchema.js
+var ExampleWebhookCallSchema = WithNameAndDocsSchema.extend({
+  id: z.optional(z.string()),
+  payload: z.optional(ExampleTypeReferenceSchema)
+});
+var ExampleWebhookCallArraySchema = z.array(ExampleWebhookCallSchema);
+
 // pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/ExampleWebSocketMessage.js
 var ExampleWebSocketMessage = z.object({
   type: z.string(),
@@ -1042030,7 +1042085,8 @@ var WebhookSchema = DeclarationSchema.extend({
   method: z.enum(["GET", "POST"]),
   "display-name": z.optional(z.string()),
   headers: z.optional(z.record(HttpHeaderSchema)),
-  payload: WebhookPayloadSchema
+  payload: WebhookPayloadSchema,
+  examples: z.optional(z.array(ExampleWebhookCallSchema))
 });
 
 // pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/WebSocketChannelInlinedMessageSchema.js
@@ -1045937,6 +1045993,12 @@ function convertToFullExample(value) {
     return FullExample.primitive(PrimitiveExample.double(value));
   } else if (typeof value === "boolean") {
     return FullExample.primitive(PrimitiveExample.boolean(value));
+  } else if (Array.isArray(value)) {
+    const examples = value.map((example) => convertToFullExample(example));
+    if (examples.length === 0) {
+      return void 0;
+    }
+    return FullExample.array(examples.filter((example) => example != null));
   } else if (value != null && typeof value === "object" && Object.keys(value).every((key2) => typeof key2 === "string")) {
     const kvs = [];
     for (const [property5, propertyValue] of Object.entries(value)) {
@@ -1047846,7 +1047908,7 @@ function getReferenceOccurrencesHelper({ obj, occurrences, breadcrumbs }) {
 function removeApplicationJsonAndMultipartConflictsFromDocument(document6) {
   return {
     ...document6,
-    paths: Object.fromEntries(Object.entries(document6.paths).map(([path42, pathItem]) => {
+    paths: Object.fromEntries(Object.entries(document6.paths ?? {}).map(([path42, pathItem]) => {
       return [
         path42,
         {
@@ -1048974,12 +1049036,31 @@ function convertWebhookOperation({ context, operationContext }) {
     headers: convertedParameters.headers,
     generatedPayloadName: getGeneratedTypeName(payloadBreadcrumbs),
     payload: convertedPayload.schema,
-    description: operation.description
+    description: operation.description,
+    examples: convertWebhookExamples(convertedPayload.fullExamples)
   };
 }
+function convertWebhookExamples(payloadExamples) {
+  if (payloadExamples == null) {
+    return [];
+  }
+  const webhookExampleCalls = [];
+  for (const payloadExample of payloadExamples) {
+    const fullExample = convertToFullExample(payloadExample.value);
+    if (fullExample == null) {
+      continue;
+    }
+    webhookExampleCalls.push({
+      description: payloadExample.description,
+      name: payloadExample.name,
+      payload: fullExample
+    });
+  }
+  return webhookExampleCalls;
+}
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/operation/convertOperation.js
-function convertOperation({ context, pathItemContext, operation }) {
+function convertOperation({ context, pathItemContext, operation, convertToWebhook }) {
   const shouldIgnore = getExtension(operation, FernOpenAPIExtension.IGNORE);
   if (shouldIgnore != null && shouldIgnore) {
     context.logger.info(`${pathItemContext.method.toUpperCase()} ${pathItemContext.path} is marked with x-fern-ignore. Skipping.`);
@@ -1049000,7 +1049081,7 @@ function convertOperation({ context, pathItemContext, operation }) {
     operationParameters: operation.parameters ?? [],
     pagination
   };
-  if (isWebhook({ operation })) {
+  if (convertToWebhook) {
     const webhook = convertWebhookOperation({
       context,
       operationContext
@@ -1049040,9 +1049121,6 @@ function convertOperation({ context, pathItemContext, operation }) {
   });
   return { type: "http", value: convertedHttpOperation };
 }
-function isWebhook({ operation }) {
-  return getExtension(operation, [FernOpenAPIExtension.WEBHOOK]) ?? false;
-}
 function getSdkGroupAndMethod(operation) {
   const sdkMethodName = getExtension(operation, FernOpenAPIExtension.SDK_METHOD_NAME);
   const sdkGroupName = getExtension(operation, FernOpenAPIExtension.SDK_GROUP_NAME) ?? [];
@@ -1049083,13 +1049161,40 @@ function convertPathItem(path42, pathItemObject, document6, context) {
     pathItemParameters: pathItemObject.parameters ?? []
   };
   for (const operation of operations) {
+    const convertToWebhook = isWebhook({ operation: operation.operation });
     const convertedOperation = convertOperation({
       context,
       pathItemContext: {
         ...basePathItemContext,
         method: operation.method
       },
-      operation: operation.operation
+      operation: operation.operation,
+      convertToWebhook
+    });
+    if (convertedOperation != null) {
+      result2.push(convertedOperation);
+    }
+  }
+  return result2;
+}
+function convertPathItemToWebhooks(path42, pathItemObject, document6, context) {
+  const result2 = [];
+  const operations = getOperationObjectsFromPathItem(pathItemObject);
+  const basePathItemContext = {
+    document: document6,
+    pathItem: pathItemObject,
+    path: path42,
+    pathItemParameters: pathItemObject.parameters ?? []
+  };
+  for (const operation of operations) {
+    const convertedOperation = convertOperation({
+      context,
+      pathItemContext: {
+        ...basePathItemContext,
+        method: operation.method
+      },
+      operation: operation.operation,
+      convertToWebhook: true
     });
     if (convertedOperation != null) {
       result2.push(convertedOperation);
@@ -1049131,6 +1049236,9 @@ function getOperationObjectsFromPathItem(pathItemObject) {
   }
   return operations;
 }
+function isWebhook({ operation }) {
+  return getExtension(operation, [FernOpenAPIExtension.WEBHOOK]) ?? false;
+}
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getBasicSecuritySchemeNames.js
 function getBasicSecuritySchemeNames(securityScheme) {
@@ -1049304,6 +1049412,12 @@ function getVariableDefinitions(document6) {
   }));
 }
 
+// pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/getWebhookPathsObject.js
+var WEBHOOKS = "webhooks";
+function getWebhooksPathsObject(document6) {
+  return getExtension(document6, WEBHOOKS) ?? {};
+}
+
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/OpenAPIV3ParserContext.js
 var OpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
   nonRequestReferencedSchemas = /* @__PURE__ */ new Set();
@@ -1049488,7 +1049602,7 @@ function generateIr({ openApi, taskContext, disableExamples, audiences, shouldUs
   const idempotencyHeaders = getIdempotencyHeaders(openApi);
   const endpointsWithExample = [];
   const webhooks = [];
-  Object.entries(openApi.paths).forEach(([path42, pathItem]) => {
+  Object.entries(openApi.paths ?? {}).forEach(([path42, pathItem]) => {
     if (pathItem == null) {
       return;
     }
@@ -1049521,6 +1049635,20 @@ function generateIr({ openApi, taskContext, disableExamples, audiences, shouldUs
       }
     }
   });
+  Object.entries(getWebhooksPathsObject(openApi)).forEach(([path42, pathItem]) => {
+    if (pathItem == null) {
+      return;
+    }
+    taskContext.logger.debug(`Converting path ${path42}`);
+    const convertedWebhooks = convertPathItemToWebhooks(path42, pathItem, openApi, context);
+    for (const webhook of convertedWebhooks) {
+      const webhookAudiences = getAudiences({ operation: webhook });
+      if (audiences.length > 0 && !audiences.some((audience) => webhookAudiences.includes(audience))) {
+        continue;
+      }
+      webhooks.push(webhook.value);
+    }
+  });
   const schemasWithExample = Object.fromEntries(Object.entries(((_b4 = openApi.components) == null ? void 0 : _b4.schemas) ?? {}).map(([key2, schema2]) => {
     if (!isReferenceObject(schema2)) {
       const ignoreSchema = getExtension(schema2, FernOpenAPIExtension.IGNORE);
@@ -1050621,88 +1050749,7 @@ function buildIdempotencyHeaders(context) {
   }
 }
 
-// pnp:/home/circleci/project/packages/cli/openapi-ir-to-fern/lib/buildEndpointExample.js
-function buildEndpointExample({ endpointExample, context }) {
-  const example = {};
-  if (endpointExample.type !== "full") {
-    return endpointExample.value;
-  }
-  if (endpointExample.name != null) {
-    example.name = endpointExample.name;
-  }
-  if (endpointExample.description != null) {
-    example.docs = endpointExample.description;
-  }
-  if (endpointExample.pathParameters != null && endpointExample.pathParameters.length > 0) {
-    example["path-parameters"] = convertNamedFullExamples(endpointExample.pathParameters);
-  }
-  if (endpointExample.queryParameters != null && endpointExample.queryParameters.length > 0) {
-    example["query-parameters"] = convertQueryParameterExample2(endpointExample.queryParameters);
-  }
-  if (endpointExample.headers != null && endpointExample.headers.length > 0) {
-    example.headers = convertHeaderExamples2({ context, namedFullExamples: endpointExample.headers });
-  }
-  if (endpointExample.request != null) {
-    example.request = convertFullExample2(endpointExample.request);
-  }
-  if (endpointExample.response != null) {
-    example.response = { body: convertFullExample2(endpointExample.response) };
-  }
-  if (endpointExample.response != null) {
-    example.response = { body: convertFullExample2(endpointExample.response) };
-  }
-  if (endpointExample.codeSamples != null && endpointExample.codeSamples.length > 0) {
-    example["code-samples"] = endpointExample.codeSamples.map((codeSample) => {
-      if (codeSample.type === "language") {
-        return {
-          name: codeSample.name ?? void 0,
-          docs: codeSample.description ?? void 0,
-          language: codeSample.language,
-          code: codeSample.code,
-          install: codeSample.install ?? void 0
-        };
-      } else {
-        return {
-          name: codeSample.name ?? void 0,
-          docs: codeSample.description ?? void 0,
-          sdk: codeSample.sdk,
-          code: codeSample.code
-        };
-      }
-    }).filter(isNonNullish);
-  }
-  return example;
-}
-function convertNamedFullExamples(namedFullExamples) {
-  const result2 = {};
-  namedFullExamples.map((namedFullExample) => result2[namedFullExample.name] = convertFullExample2(namedFullExample.value));
-  return result2;
-}
-function convertQueryParameterExample2(namedFullExamples) {
-  const result2 = {};
-  namedFullExamples.forEach((namedFullExample) => {
-    const convertedExample = convertFullExample2(namedFullExample.value);
-    if (Array.isArray(convertedExample)) {
-      result2[namedFullExample.name] = convertedExample[0];
-    } else if (convertedExample != null) {
-      result2[namedFullExample.name] = convertedExample;
-    }
-  });
-  return result2;
-}
-function convertHeaderExamples2({ context, namedFullExamples }) {
-  const globalHeaderNames = context.builder.getGlobalHeaderNames();
-  const result2 = {};
-  namedFullExamples.forEach((namedFullExample) => {
-    const convertedExample = convertFullExample2(namedFullExample.value);
-    if (globalHeaderNames.has(namedFullExample.name)) {
-      return;
-    } else if (convertedExample != null) {
-      result2[namedFullExample.name] = convertedExample;
-    }
-  });
-  return result2;
-}
+// pnp:/home/circleci/project/packages/cli/openapi-ir-to-fern/lib/utils/convertFullExample.js
 function convertFullExample2(fullExample) {
   switch (fullExample.type) {
     case "primitive":
@@ -1050788,6 +1050835,89 @@ function convertLiteralExample2(literal2) {
   }
 }
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-to-fern/lib/buildEndpointExample.js
+function buildEndpointExample({ endpointExample, context }) {
+  const example = {};
+  if (endpointExample.type !== "full") {
+    return endpointExample.value;
+  }
+  if (endpointExample.name != null) {
+    example.name = endpointExample.name;
+  }
+  if (endpointExample.description != null) {
+    example.docs = endpointExample.description;
+  }
+  if (endpointExample.pathParameters != null && endpointExample.pathParameters.length > 0) {
+    example["path-parameters"] = convertNamedFullExamples(endpointExample.pathParameters);
+  }
+  if (endpointExample.queryParameters != null && endpointExample.queryParameters.length > 0) {
+    example["query-parameters"] = convertQueryParameterExample2(endpointExample.queryParameters);
+  }
+  if (endpointExample.headers != null && endpointExample.headers.length > 0) {
+    example.headers = convertHeaderExamples2({ context, namedFullExamples: endpointExample.headers });
+  }
+  if (endpointExample.request != null) {
+    example.request = convertFullExample2(endpointExample.request);
+  }
+  if (endpointExample.response != null) {
+    example.response = { body: convertFullExample2(endpointExample.response) };
+  }
+  if (endpointExample.response != null) {
+    example.response = { body: convertFullExample2(endpointExample.response) };
+  }
+  if (endpointExample.codeSamples != null && endpointExample.codeSamples.length > 0) {
+    example["code-samples"] = endpointExample.codeSamples.map((codeSample) => {
+      if (codeSample.type === "language") {
+        return {
+          name: codeSample.name ?? void 0,
+          docs: codeSample.description ?? void 0,
+          language: codeSample.language,
+          code: codeSample.code,
+          install: codeSample.install ?? void 0
+        };
+      } else {
+        return {
+          name: codeSample.name ?? void 0,
+          docs: codeSample.description ?? void 0,
+          sdk: codeSample.sdk,
+          code: codeSample.code
+        };
+      }
+    }).filter(isNonNullish);
+  }
+  return example;
+}
+function convertNamedFullExamples(namedFullExamples) {
+  const result2 = {};
+  namedFullExamples.map((namedFullExample) => result2[namedFullExample.name] = convertFullExample2(namedFullExample.value));
+  return result2;
+}
+function convertQueryParameterExample2(namedFullExamples) {
+  const result2 = {};
+  namedFullExamples.forEach((namedFullExample) => {
+    const convertedExample = convertFullExample2(namedFullExample.value);
+    if (Array.isArray(convertedExample)) {
+      result2[namedFullExample.name] = convertedExample[0];
+    } else if (convertedExample != null) {
+      result2[namedFullExample.name] = convertedExample;
+    }
+  });
+  return result2;
+}
+function convertHeaderExamples2({ context, namedFullExamples }) {
+  const globalHeaderNames = context.builder.getGlobalHeaderNames();
+  const result2 = {};
+  namedFullExamples.forEach((namedFullExample) => {
+    const convertedExample = convertFullExample2(namedFullExample.value);
+    if (globalHeaderNames.has(namedFullExample.name)) {
+      return;
+    } else if (convertedExample != null) {
+      result2[namedFullExample.name] = convertedExample;
+    }
+  });
+  return result2;
+}
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-to-fern/lib/utils/convertToHttpMethod.js
 function convertToHttpMethod(httpMethod) {
   return HttpMethod6._visit(httpMethod, {
@@ -1051376,7 +1051506,14 @@ function buildWebhooks(context) {
         schema: webhook.payload,
         context,
         fileContainingReference: webhookLocation.file
-      })
+      }),
+      examples: webhook.examples != null ? webhook.examples.map((exampleWebhookCall) => {
+        return {
+          docs: exampleWebhookCall.description,
+          name: exampleWebhookCall.name,
+          payload: convertFullExample2(exampleWebhookCall.payload)
+        };
+      }) : void 0
     };
     context.builder.addWebhook(webhookLocation.file, {
       name: webhookLocation.endpointId,
@@ -1056126,10 +1056263,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.30.5" == null) {
+    if ("0.30.7" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.30.5";
+    return "0.30.7";
   }
   getCliName() {
     if ("fern" == null) {
@@ -1060637,7 +1060774,7 @@ function getReadmeEndpointObject({ endpoint }) {
 }
 
 // pnp:/home/circleci/project/packages/cli/generation/ir-generator/lib/converters/convertWebhookGroup.js
-async function convertWebhookGroup({ webhooks, file }) {
+async function convertWebhookGroup({ webhooks, file, typeResolver, exampleResolver, workspace }) {
   const webhookGroup = [];
   for (const [webhookId, webhook] of Object.entries(webhooks)) {
     webhookGroup.push({
@@ -1060647,7 +1060784,15 @@ async function convertWebhookGroup({ webhooks, file }) {
       method: webhook.method,
       name: file.casingsGenerator.generateName(webhookId),
       headers: webhook.headers != null ? await Promise.all(Object.entries(webhook.headers).map(([headerKey, header]) => convertHttpHeader({ headerKey, header, file }))) : [],
-      payload: convertWebhookPayloadSchema({ payload: webhook.payload, file })
+      payload: convertWebhookPayloadSchema({ payload: webhook.payload, file }),
+      examples: webhook.examples != null ? convertWebhookExamples2({
+        webhook,
+        examples: webhook.examples,
+        file,
+        typeResolver,
+        exampleResolver,
+        workspace
+      }) : void 0
     });
   }
   return webhookGroup;
@@ -1060686,6 +1060831,40 @@ function convertInlinedRequestProperty2({ propertyKey, propertyDefinition, docs,
     valueType: file.parseTypeReference(propertyDefinition)
   };
 }
+function convertWebhookExamples2({ webhook, examples, file, typeResolver, exampleResolver, workspace }) {
+  const typeName = typeof webhook.payload === "string" ? webhook.payload : isReferencedWebhookPayloadSchema2(webhook.payload) ? webhook.payload.type : void 0;
+  if (typeName != null) {
+    return examples.map((example) => ({
+      docs: webhook.docs,
+      name: example.name != null ? file.casingsGenerator.generateName(example.name) : void 0,
+      payload: convertTypeReferenceExample({
+        example: example.payload,
+        rawTypeBeingExemplified: typeName,
+        fileContainingRawTypeReference: file,
+        fileContainingExample: file,
+        typeResolver,
+        exampleResolver,
+        workspace
+      })
+    }));
+  }
+  if (!isPlainObject(webhook.payload)) {
+    throw new Error(`Example webhook payload is not an object. Got: ${JSON.stringify(webhook.payload)}`);
+  }
+  return examples.map((example) => ({
+    docs: webhook.docs,
+    name: example.name != null ? file.casingsGenerator.generateName(example.name) : void 0,
+    payload: convertTypeReferenceExample({
+      example: example.payload,
+      rawTypeBeingExemplified: "map<string, unknown>",
+      fileContainingRawTypeReference: file,
+      fileContainingExample: file,
+      typeResolver,
+      exampleResolver,
+      workspace
+    })
+  }));
+}
 function isReferencedWebhookPayloadSchema2(payload) {
   return payload.type != null;
 }
@@ -1063156,7 +1063335,13 @@ async function generateIntermediateRepresentation({ workspace, generationLanguag
           return;
         }
         const webhookGroupId = IdGenerator.generateWebhookGroupId(file.fernFilepath);
-        const convertedWebhookGroup = await convertWebhookGroup({ webhooks, file });
+        const convertedWebhookGroup = await convertWebhookGroup({
+          webhooks,
+          file,
+          typeResolver,
+          exampleResolver,
+          workspace
+        });
         intermediateRepresentation.webhookGroups[webhookGroupId] = convertedWebhookGroup;
         packageTreeGenerator.addWebhookGroup(webhookGroupId, file.fernFilepath);
       },
@@ -1072827,7 +1073012,10 @@ function isExternalUrl(url) {
 function replaceImagePathsAndUrls(markdown, fileIdsMap, markdownFilesToPathName, metadata, context) {
   const { content: content5, data: data2 } = (0, import_gray_matter.default)(markdown);
   let replacedContent = content5;
-  const tree = fromMarkdown(content5);
+  const tree = fromMarkdown(content5, {
+    extensions: [mdx()],
+    mdastExtensions: [mdxFromMarkdown()]
+  });
   let offset2 = 0;
   visit2(tree, (node3) => {
     if (node3.position == null) {
@@ -1072836,8 +1073024,7 @@ function replaceImagePathsAndUrls(markdown, fileIdsMap, markdownFilesToPathName,
     const { start: start4, length } = getPosition(content5, node3.position);
     const original = replacedContent.slice(start4 + offset2, start4 + offset2 + length);
     let replaced = original;
-    if (node3.type === "image") {
-      const src = trimAnchor(node3.url);
+    function replaceSrc(src) {
       if (src != null && !isExternalUrl(src)) {
         try {
           const fileId = fileIdsMap.get(AbsoluteFilePath.of(src));
@@ -1072848,25 +1073035,11 @@ function replaceImagePathsAndUrls(markdown, fileIdsMap, markdownFilesToPathName,
         }
       }
     }
-    if (node3.type === "html" || node3.type === "text") {
-      const srcRegex = /src={?['"]([^'"]+)['"](?! \+)}?/g;
-      let match;
-      while ((match = srcRegex.exec(node3.value)) != null) {
-        const pathToImage = trimAnchor(match[1]);
-        if (pathToImage != null && !isExternalUrl(pathToImage)) {
-          try {
-            const fileId = fileIdsMap.get(AbsoluteFilePath.of(pathToImage));
-            if (fileId != null) {
-              replaced = replaced.replaceAll(pathToImage, `file:${fileId}`);
-            }
-          } catch (e) {
-          }
-        }
+    function replaceHref(href) {
+      if (href == null) {
+        return;
       }
-    }
-    if (node3.type === "link") {
-      const href = trimAnchor(node3.url);
-      if (href != null && (href.endsWith(".md") || href.endsWith(".mdx"))) {
+      if (href.endsWith(".md") || href.endsWith(".mdx")) {
         const absoluteFilePath = resolvePath(href, metadata);
         if (absoluteFilePath != null) {
           const pathName = markdownFilesToPathName.get(absoluteFilePath);
@@ -1072878,24 +1073051,70 @@ function replaceImagePathsAndUrls(markdown, fileIdsMap, markdownFilesToPathName,
         }
       }
     }
-    if (node3.type === "html" || node3.type === "text") {
-      const hrefRegex = /href={?['"]([^'"]+)['"](?! \+)}?/g;
+    if (node3.type === "image") {
+      const src = trimAnchor(node3.url);
+      replaceSrc(src);
+    }
+    if (node3.type === "mdxJsxFlowElement" || node3.type === "mdxJsxTextElement") {
+      if (node3.name && MEDIA_NODE_NAMES.includes(node3.name)) {
+        const srcAttr = node3.attributes.find((attr) => attr.type === "mdxJsxAttribute" && attr.name === "src");
+        if (srcAttr == null ? void 0 : srcAttr.value) {
+          let srcValue = srcAttr.value;
+          if (typeof srcValue !== "string") {
+            const match = srcValue.value.match(STR_REGEX);
+            if (match == null ? void 0 : match[1]) {
+              srcValue = match[1];
+            }
+          }
+          const pathToImage = trimAnchor(srcValue);
+          replaceSrc(pathToImage);
+        }
+      } else {
+        node3.attributes.forEach((attr) => {
+          if (attr.type === "mdxJsxAttribute" && attr.value && typeof attr.value !== "string") {
+            const match = SRC_REGEX.exec(attr.value.value);
+            if (match == null ? void 0 : match[1]) {
+              const pathToImage = trimAnchor(match[1]);
+              replaceSrc(pathToImage);
+            }
+          }
+        });
+      }
+    }
+    if (node3.type === "html" || node3.type === "text" || node3.type === "mdxTextExpression") {
+      const srcRegex = /src={?['"]([^'"]+)['"](?! \+)}?/g;
       let match;
-      while ((match = hrefRegex.exec(node3.value)) != null) {
-        const href = trimAnchor(match[1]);
-        if (href != null && (href.endsWith(".md") || href.endsWith(".mdx"))) {
-          const absoluteFilePath = resolvePath(href, metadata);
-          if (absoluteFilePath != null) {
-            const pathName = markdownFilesToPathName.get(absoluteFilePath);
-            if (pathName != null) {
-              replaced = replaced.replaceAll(href, pathName);
-            } else {
-              context.logger.error(`${relative(metadata.absolutePathToFernFolder, absoluteFilePath)} has no slug defined but is referenced by ${relative(metadata.absolutePathToFernFolder, metadata.absolutePathToMdx)}`);
+      while ((match = srcRegex.exec(node3.value)) != null) {
+        const pathToImage = trimAnchor(match[1]);
+        replaceSrc(pathToImage);
+      }
+    }
+    if (node3.type === "link") {
+      replaceHref(trimAnchor(node3.url));
+    }
+    if (node3.type === "mdxJsxFlowElement" || node3.type === "mdxJsxTextElement") {
+      if (node3.name === "a") {
+        const hrefAttr = node3.attributes.find((attr) => attr.type === "mdxJsxAttribute" && attr.name === "href");
+        if (hrefAttr == null ? void 0 : hrefAttr.value) {
+          let href = hrefAttr.value;
+          if (typeof href !== "string") {
+            const match = href.value.match(STR_REGEX);
+            if (match == null ? void 0 : match[1]) {
+              href = match[1];
             }
           }
+          replaceHref(trimAnchor(href));
         }
       }
     }
+    if (node3.type === "html" || node3.type === "text" || node3.type === "mdxTextExpression") {
+      const hrefRegex = /href={?['"]([^'"]+)['"](?! \+)}?/g;
+      let match;
+      while ((match = hrefRegex.exec(node3.value)) != null) {
+        const href = trimAnchor(match[1]);
+        replaceHref(href);
+      }
+    }
     if (replaced === original) {
       return;
     }
@@ -1075457,7 +1075676,11 @@ function convertWebhookGroup2(webhookGroup) {
         type: convertTypeReference(header.valueType)
       })),
       payload: convertWebhookPayload(webhook.payload),
-      examples: []
+      examples: webhook.examples != null ? webhook.examples.map((example) => {
+        return {
+          payload: example.payload.jsonExample
+        };
+      }) : []
     };
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fern-api",
-  "version": "0.30.5",
+  "version": "0.30.7",
   "repository": {
     "type": "git",
     "url": "https://github.com/fern-api/fern.git",