fern-api 0.19.26 → 0.19.28

package/bundle.cjs

@@ -340817,9 +340817,53 @@ var init_SupportedSdkLanguage3 = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/FernExample.js
+var init_FernExample = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/FernExample.js"() {
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/EndpointExample.js
+var EndpointExample;
 var init_EndpointExample = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/EndpointExample.js"() {
+    init_api2();
+    EndpointExample = {
+      unknown: (value) => {
+        return {
+          value,
+          type: "unknown",
+          _visit: function(visitor) {
+            return EndpointExample._visit(this, visitor);
+          }
+        };
+      },
+      full: (value) => {
+        return {
+          ...value,
+          type: "full",
+          _visit: function(visitor) {
+            return EndpointExample._visit(this, visitor);
+          }
+        };
+      },
+      _visit: (value, visitor) => {
+        switch (value.type) {
+          case "unknown":
+            return visitor.unknown(value.value);
+          case "full":
+            return visitor.full(value);
+          default:
+            return visitor._other(value);
+        }
+      }
+    };
+  }
+});
+
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/FullEndpointExample.js
+var init_FullEndpointExample = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/FullEndpointExample.js"() {
   }
 });
 
@@ -341558,7 +341602,9 @@ var init_types28 = __esm({
     init_CustomCodeSampleLanguage();
     init_CustomCodeSampleSdk();
     init_SupportedSdkLanguage3();
+    init_FernExample();
     init_EndpointExample();
+    init_FullEndpointExample();
     init_PathParameterExample();
     init_QueryParameterExample();
     init_HeaderExample();
@@ -341608,6 +341654,7 @@ var finalIr_exports = {};
 __export(finalIr_exports, {
   CustomCodeSample: () => CustomCodeSample,
   EndpointAvailability: () => EndpointAvailability,
+  EndpointExample: () => EndpointExample,
   HttpMethod: () => HttpMethod5,
   LiteralSchemaValue: () => LiteralSchemaValue,
   MultipartSchema: () => MultipartSchema,
@@ -342283,6 +342330,7 @@ var api_exports5 = {};
 __export(api_exports5, {
   CustomCodeSample: () => CustomCodeSample,
   EndpointAvailability: () => EndpointAvailability,
+  EndpointExample: () => EndpointExample,
   FullExample: () => FullExample,
   FullOneOfExample: () => FullOneOfExample,
   HttpMethod: () => HttpMethod5,
@@ -344489,7 +344537,7 @@ var init_Endpoint2 = __esm({
       response: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Response).optional(),
       errorStatusCode: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode)),
       server: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Server)),
-      examples: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).EndpointExample))
+      examples: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).EndpointExample))
     }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
   }
 });
@@ -344571,12 +344619,48 @@ var init_SupportedSdkLanguage4 = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/FernExample.js
+var FernExample;
+var init_FernExample2 = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/FernExample.js"() {
+    init_core3();
+    FernExample = schemas_exports5.unknown();
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/EndpointExample.js
-var EndpointExample;
+var EndpointExample2;
 var init_EndpointExample2 = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/EndpointExample.js"() {
+    init_api2();
+    init_core3();
+    EndpointExample2 = schemas_exports5.union("type", {
+      unknown: schemas_exports5.object({
+        value: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).FernExample)
+      }),
+      full: schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).FullEndpointExample)
+    }).transform({
+      transform: (value) => {
+        switch (value.type) {
+          case "unknown":
+            return EndpointExample.unknown(value.value);
+          case "full":
+            return EndpointExample.full(value);
+          default:
+            return value;
+        }
+      },
+      untransform: ({ _visit, ...value }) => value
+    });
+  }
+});
+
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/FullEndpointExample.js
+var FullEndpointExample;
+var init_FullEndpointExample2 = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/FullEndpointExample.js"() {
     init_core3();
-    EndpointExample = schemas_exports5.objectWithoutOptionalProperties({
+    FullEndpointExample = schemas_exports5.objectWithoutOptionalProperties({
       name: schemas_exports5.string().optional(),
       pathParameters: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).PathParameterExample)).optional(),
       queryParameters: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).QueryParameterExample)).optional(),
@@ -345252,7 +345336,9 @@ var init_types32 = __esm({
     init_CustomCodeSampleLanguage2();
     init_CustomCodeSampleSdk2();
     init_SupportedSdkLanguage4();
+    init_FernExample2();
     init_EndpointExample2();
+    init_FullEndpointExample2();
     init_PathParameterExample2();
     init_QueryParameterExample2();
     init_HeaderExample2();
@@ -345310,12 +345396,14 @@ __export(finalIr_exports2, {
   DiscriminatedOneOfSchema: () => DiscriminatedOneOfSchema,
   Endpoint: () => Endpoint,
   EndpointAvailability: () => EndpointAvailability2,
-  EndpointExample: () => EndpointExample,
+  EndpointExample: () => EndpointExample2,
   EndpointSdkName: () => EndpointSdkName,
   EnumSchema: () => EnumSchema2,
   EnumValue: () => EnumValue2,
+  FernExample: () => FernExample,
   FileResponse: () => FileResponse,
   FileSchema: () => FileSchema,
+  FullEndpointExample: () => FullEndpointExample,
   GlobalHeader: () => GlobalHeader,
   Header: () => Header,
   HeaderExample: () => HeaderExample,
@@ -345415,7 +345503,7 @@ var init_EndpointWithExample2 = __esm({
       response: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).ResponseWithExample).optional(),
       errorStatusCode: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode)),
       server: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Server)),
-      examples: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).EndpointExample))
+      examples: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).EndpointExample))
     }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
   }
 });
@@ -346039,15 +346127,17 @@ __export(serialization_exports3, {
   DoubleWithExample: () => DoubleWithExample,
   Endpoint: () => Endpoint,
   EndpointAvailability: () => EndpointAvailability2,
-  EndpointExample: () => EndpointExample,
+  EndpointExample: () => EndpointExample2,
   EndpointSdkName: () => EndpointSdkName,
   EndpointWithExample: () => EndpointWithExample,
   EnumSchema: () => EnumSchema2,
   EnumSchemaWithExample: () => EnumSchemaWithExample,
   EnumValue: () => EnumValue2,
+  FernExample: () => FernExample,
   FileResponse: () => FileResponse,
   FileSchema: () => FileSchema,
   FloatWithExample: () => FloatWithExample,
+  FullEndpointExample: () => FullEndpointExample,
   FullExample: () => FullExample2,
   FullObjectExample: () => FullObjectExample,
   FullOneOfExample: () => FullOneOfExample2,
@@ -827037,7 +827127,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.19.26",
+          version: "0.19.28",
           usingAccessToken: true
         }
       });
@@ -827099,7 +827189,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.19.26",
+        version: "0.19.28",
         ...event,
         ...event.properties
       }
@@ -839712,7 +839802,7 @@ function buildAuthSchemes(context) {
         context.builder.setAuth(BEARER_AUTH_SCHEME);
         setAuth = true;
       }
-      if (securityScheme.scopesEnum != null) {
+      if (securityScheme.scopesEnum != null && securityScheme.scopesEnum.values.length > 0) {
         context.builder.addType(RelativeFilePath.of("__package__.yml"), {
           name: "OauthScope",
           schema: buildEnumTypeDeclaration(securityScheme.scopesEnum).schema
@@ -842707,7 +842797,12 @@ function isSchemaRequired4(schema2) {
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/hasIncompleteExample.js
 function hasIncompleteExample(example) {
-  return example.request == null && example.response == null && example.queryParameters == null && example.pathParameters == null && example.headers == null;
+  if (example.type === "full") {
+    return example.request == null && example.response == null && example.queryParameters == null && example.pathParameters == null && example.headers == null;
+  } else {
+    const castExample = example.value;
+    return castExample.request == null && castExample.response == null && castExample["query-parameters"] == null && castExample["path-parameters"] == null && castExample.headers == null;
+  }
 }
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/ExampleEndpointFactory.js
@@ -842835,8 +842930,20 @@ var ExampleEndpointFactory = class {
         exampleName = getNameFromSchemaWithExample(requestSchemaIdResponse.schema);
       }
     }
-    const codeSamples = endpoint.examples.filter(hasIncompleteExample).flatMap((example) => example.codeSamples);
-    return {
+    const codeSamples = endpoint.examples.filter((ex) => hasIncompleteExample(ex)).flatMap((ex) => {
+      if (ex.type === "unknown") {
+        if (ex.value != null) {
+          const samples = ex.value["code-samples"];
+          if (samples != null) {
+            return this.convertCodeSamples(samples);
+          }
+        }
+        return void 0;
+      } else {
+        return ex.codeSamples;
+      }
+    }).filter((ex) => isNonNullish(ex));
+    return EndpointExample.full({
       name: exampleName,
       description: void 0,
       pathParameters,
@@ -842845,7 +842952,27 @@ var ExampleEndpointFactory = class {
       request: requestExample,
       response: responseExample,
       codeSamples
-    };
+    });
+  }
+  convertCodeSamples(codeSamples) {
+    return codeSamples.map((codeSample) => {
+      if ("language" in codeSample) {
+        return CustomCodeSample.language({
+          name: codeSample.name ?? void 0,
+          description: codeSample.docs ?? void 0,
+          language: codeSample.language,
+          code: codeSample.code,
+          install: codeSample.install ?? void 0
+        });
+      } else {
+        return CustomCodeSample.sdk({
+          name: codeSample.name ?? void 0,
+          description: codeSample.docs ?? void 0,
+          sdk: codeSample.sdk === "c#" ? SupportedSdkLanguage3.Csharp : codeSample.sdk,
+          code: codeSample.code
+        });
+      }
+    }).filter(isNonNullish);
   }
   isSchemaRequired(schema2) {
     return isSchemaRequired4(this.getResolvedSchema(schema2));
@@ -843819,36 +843946,6 @@ var RedoclyCodeSampleArraySchema = z.array(RedoclyCodeSampleSchema);
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getExamplesFromExtension.js
 function getExamplesFromExtension(operationContext, operationObject, context) {
   const exampleEndpointCalls = getExtensionAndValidate(operationObject, FernOpenAPIExtension.EXAMPLES, schemas_exports3.ExampleEndpointCallArraySchema, context, [...operationContext.baseBreadcrumbs, `${operationContext.method} ${operationContext.path}`]) ?? [];
-  const fernExamples = exampleEndpointCalls.map((value) => ({
-    name: value.name,
-    pathParameters: value["path-parameters"] ? Object.entries(value["path-parameters"]).map(([name2, value2]) => ({
-      name: name2,
-      value: value2
-    })) : void 0,
-    queryParameters: value["query-parameters"] ? Object.entries(value["query-parameters"]).map(([name2, value2]) => ({
-      name: name2,
-      value: value2
-    })) : void 0,
-    headers: value.headers ? Object.entries(value.headers).map(([name2, value2]) => ({
-      name: name2,
-      value: value2
-    })) : void 0,
-    request: value.request,
-    response: value.response,
-    codeSamples: (value["code-samples"] ?? []).map((value2) => "language" in value2 ? api_exports5.CustomCodeSample.language({
-      name: value2.name,
-      language: value2.language,
-      code: value2.code,
-      install: value2.install,
-      description: value2.docs
-    }) : api_exports5.CustomCodeSample.sdk({
-      name: value2.name,
-      sdk: value2.sdk === "c#" ? "csharp" : value2.sdk,
-      code: value2.code,
-      description: value2.docs
-    })),
-    description: void 0
-  }));
   const redoclyCodeSamplesKebabCase = getExtensionAndValidate(operationObject, OpenAPIExtension.REDOCLY_CODE_SAMPLES_KEBAB, RedoclyCodeSampleArraySchema, context, [...operationContext.baseBreadcrumbs, `${operationContext.method} ${operationContext.path}`]) ?? [];
   const redoclyCodeSamplesCamelCase = getExtensionAndValidate(operationObject, OpenAPIExtension.REDOCLY_CODE_SAMPLES_CAMEL, RedoclyCodeSampleArraySchema, context, [...operationContext.baseBreadcrumbs, `${operationContext.method} ${operationContext.path}`]) ?? [];
   const redoclyCodeSamples = [
@@ -843856,24 +843953,17 @@ function getExamplesFromExtension(operationContext, operationObject, context) {
     ...redoclyCodeSamplesKebabCase
   ];
   if (redoclyCodeSamples.length > 0) {
-    fernExamples.push({
-      name: void 0,
-      pathParameters: void 0,
-      queryParameters: void 0,
-      headers: void 0,
-      request: void 0,
-      response: void 0,
-      codeSamples: redoclyCodeSamples.map((value) => api_exports5.CustomCodeSample.language({
+    exampleEndpointCalls.push({
+      "code-samples": redoclyCodeSamples.map((value) => ({
         name: value.label ?? value.lang,
         language: value.lang,
         code: value.source,
         install: void 0,
-        description: void 0
-      })),
-      description: void 0
+        docs: void 0
+      }))
     });
   }
-  return fernExamples;
+  return exampleEndpointCalls.map(EndpointExample.unknown);
 }
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getFernAvailability.js
@@ -845079,13 +845169,14 @@ function generateIr({ openApi, taskContext, disableExamples }) {
   }).filter((entry) => entry.length > 0));
   const exampleEndpointFactory = new ExampleEndpointFactory(schemasWithExample, context.logger);
   const endpoints = endpointsWithExample.map((endpointWithExample) => {
-    let examples = endpointWithExample.examples;
-    if (!disableExamples && (examples.length === 0 || examples.every(hasIncompleteExample))) {
+    const extensionExamples = endpointWithExample.examples;
+    let examples = extensionExamples;
+    if (!disableExamples && (extensionExamples.length === 0 || extensionExamples.every(hasIncompleteExample))) {
       const endpointExample = exampleEndpointFactory.buildEndpointExample(endpointWithExample);
       if (endpointExample != null) {
         examples = [
           endpointExample,
-          ...endpointWithExample.examples.filter((example) => !hasIncompleteExample(example))
+          ...extensionExamples.filter((example) => !hasIncompleteExample(example))
         ];
       }
     }
@@ -845931,6 +846022,9 @@ function buildGlobalHeaders(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;
   }
@@ -851128,10 +851222,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.19.26" == null) {
+    if ("0.19.28" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.19.26";
+    return "0.19.28";
   }
   getCliName() {
     if ("fern" == null) {

package/package.json

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