fern-api 0.19.22 → 0.19.23

package/bundle.cjs

@@ -340602,6 +340602,12 @@ var init_OpenApiIntermediateRepresentation = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/SdkGroupInfo.js
+var init_SdkGroupInfo = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/SdkGroupInfo.js"() {
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/GlobalHeader.js
 var init_GlobalHeader = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/GlobalHeader.js"() {
@@ -341536,6 +341542,7 @@ var init_UnDiscriminatedOneOfSchema = __esm({
 var init_types28 = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/index.js"() {
     init_OpenApiIntermediateRepresentation();
+    init_SdkGroupInfo();
     init_GlobalHeader();
     init_Tags();
     init_HttpError();
@@ -344300,6 +344307,7 @@ var init_OpenApiIntermediateRepresentation2 = __esm({
       title: schemas_exports5.string().optional(),
       description: schemas_exports5.string().optional(),
       servers: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Server)),
+      groups: schemas_exports5.record(schemas_exports5.string(), schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SdkGroupInfo)),
       tags: schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Tags),
       hasEndpointsMarkedInternal: schemas_exports5.boolean(),
       endpoints: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Endpoint)),
@@ -344315,6 +344323,18 @@ var init_OpenApiIntermediateRepresentation2 = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/SdkGroupInfo.js
+var SdkGroupInfo;
+var init_SdkGroupInfo2 = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/SdkGroupInfo.js"() {
+    init_core3();
+    SdkGroupInfo = schemas_exports5.objectWithoutOptionalProperties({
+      summary: schemas_exports5.string().optional(),
+      description: schemas_exports5.string().optional()
+    });
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/GlobalHeader.js
 var GlobalHeader;
 var init_GlobalHeader2 = __esm({
@@ -345216,6 +345236,7 @@ var init_UnDiscriminatedOneOfSchema2 = __esm({
 var init_types32 = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/index.js"() {
     init_OpenApiIntermediateRepresentation2();
+    init_SdkGroupInfo2();
     init_GlobalHeader2();
     init_Tags2();
     init_HttpError2();
@@ -345326,6 +345347,7 @@ __export(finalIr_exports2, {
   Request: () => Request3,
   Response: () => Response3,
   Schema: () => Schema3,
+  SdkGroupInfo: () => SdkGroupInfo,
   StringSchema: () => StringSchema,
   SupportedSdkLanguage: () => SupportedSdkLanguage4,
   Tags: () => Tags,
@@ -346087,6 +346109,7 @@ __export(serialization_exports3, {
   Schema: () => Schema3,
   SchemaId: () => SchemaId,
   SchemaWithExample: () => SchemaWithExample2,
+  SdkGroupInfo: () => SdkGroupInfo,
   SdkGroupName: () => SdkGroupName,
   SecurityScheme: () => SecurityScheme2,
   SecuritySchemeId: () => SecuritySchemeId,
@@ -827010,7 +827033,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.19.22",
+          version: "0.19.23",
           usingAccessToken: true
         }
       });
@@ -827072,7 +827095,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.19.22",
+        version: "0.19.23",
         ...event,
         ...event.properties
       }
@@ -839766,6 +839789,7 @@ var FernOpenAPIExtension = {
   BOOLEAN_LITERAL: "x-fern-boolean-literal",
   SERVER_NAME_V1: "x-name",
   SERVER_NAME_V2: "x-fern-server-name",
+  GROUPS: TypedExtensionId.of("x-fern-groups"),
   OPENAPI_OVERIDES_FILEPATH: "x-fern-overrides-filepath",
   TYPE_DEFINITION: "x-fern-type",
   STREAMING: "x-fern-streaming",
@@ -842911,6 +842935,7 @@ var ExampleWebsocketSessionFactory = class {
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/asyncapi/fernExtensions.js
 var FernAsyncAPIExtension = {
+  FERN_DISPLAY_NAME: "x-fern-display-name",
   FERN_EXAMPLES: "x-fern-examples"
 };
 
@@ -843033,7 +843058,7 @@ function parseAsyncAPI({ document: document4, taskContext }) {
         groupName: (tag == null ? void 0 : tag.name) != null ? [tag.name] : ["Websocket"],
         publish: publishSchema != null ? convertSchemaWithExampleToSchema(publishSchema) : publishSchema,
         subscribe: subscribeSchema != null ? convertSchemaWithExampleToSchema(subscribeSchema) : subscribeSchema,
-        summary: void 0,
+        summary: getExtension(channel, FernAsyncAPIExtension.FERN_DISPLAY_NAME),
         path: channelPath,
         description: void 0,
         examples
@@ -844468,6 +844493,15 @@ function convertToError({ statusCode, errorBodyCollector, context }) {
   };
 }
 
+// pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getFernGroups.js
+var XFernGroupsSchema = z.record(z.string(), z.object({
+  summary: z.string().optional(),
+  description: z.string().optional()
+}));
+function getFernGroups({ document: document4, context }) {
+  return getExtensionAndValidate(document4, FernOpenAPIExtension.GROUPS, XFernGroupsSchema, context);
+}
+
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getGlobalHeaders.js
 function getGlobalHeaders(document4) {
   const globalHeaders = getExtension(document4, FernOpenAPIExtension.FERN_GLOBAL_HEADERS);
@@ -844842,9 +844876,13 @@ function generateIr({ openApi, taskContext, disableExamples }) {
     schemas[key2] = schema2;
     taskContext.logger.debug(`Converted schema ${key2}`);
   }
+  const groupInfo = getFernGroups({ document: openApi, context });
   const ir = {
     title: openApi.info.title,
     description: openApi.info.description,
+    groups: Object.fromEntries(Object.entries(groupInfo ?? {}).map(([key2, value]) => {
+      return [key2, { summary: value.summary ?? void 0, description: value.description ?? void 0 }];
+    })),
     servers: (openApi.servers ?? []).map((server) => convertServer(server)),
     tags: {
       tagsById: Object.fromEntries((openApi.tags ?? []).map((tag) => {
@@ -844952,7 +844990,8 @@ async function parse3({ workspace, taskContext }) {
     variables: {},
     nonRequestReferencedSchemas: /* @__PURE__ */ new Set(),
     securitySchemes: {},
-    globalHeaders: []
+    globalHeaders: [],
+    groups: {}
   };
   for (const spec of workspace.specs) {
     const contents = (await (0, import_promises25.readFile)(spec.absoluteFilepath)).toString();
@@ -845032,7 +845071,11 @@ function merge3(ir1, ir2) {
       ...ir1.securitySchemes,
       ...ir2.securitySchemes
     },
-    globalHeaders: ir1.globalHeaders != null ? [...ir1.globalHeaders, ...ir2.globalHeaders ?? []] : void 0
+    globalHeaders: ir1.globalHeaders != null ? [...ir1.globalHeaders, ...ir2.globalHeaders ?? []] : void 0,
+    groups: {
+      ...ir1.groups,
+      ...ir2.groups
+    }
   };
 }
 async function loadAsyncAPI({ absoluteFilePathToAsyncAPI, absoluteFilePathToAsyncAPIOverrides, context }) {
@@ -845397,6 +845440,9 @@ function buildChannel({ channel, context, declarationFile }) {
     path: channel.path,
     auth: false
   };
+  if (channel.summary != null) {
+    convertedChannel["display-name"] = channel.summary;
+  }
   const queryParameters = {};
   if (channel.handshake.queryParameters.length > 0) {
     for (const queryParameter of channel.handshake.queryParameters) {
@@ -846245,6 +846291,19 @@ function buildServices(context) {
     if (sdkGroup != null) {
       sdkGroups.add(sdkGroup);
     }
+    let group = void 0;
+    if (endpoint.sdkName != null) {
+      const groupInfo = context.ir.groups;
+      for (const groupName of endpoint.sdkName.groupName) {
+        const value = groupInfo[groupName];
+        if (value == null) {
+          break;
+        } else if (value.summary != null || value.description != null) {
+          group = groupInfo[groupName];
+          break;
+        }
+      }
+    }
     const irTag = tag == null ? void 0 : tags.tagsById[tag];
     const convertedEndpoint = buildEndpoint({
       context,
@@ -846258,8 +846317,8 @@ function buildServices(context) {
     });
     if ((irTag == null ? void 0 : irTag.id) != null || (irTag == null ? void 0 : irTag.description) != null) {
       context.builder.setServiceInfo(file, {
-        displayName: irTag == null ? void 0 : irTag.id,
-        docs: (irTag == null ? void 0 : irTag.description) ?? void 0
+        displayName: (group == null ? void 0 : group.summary) ?? (irTag == null ? void 0 : irTag.id),
+        docs: (group == null ? void 0 : group.description) ?? (irTag == null ? void 0 : irTag.description) ?? void 0
       });
     }
   }
@@ -850806,10 +850865,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.19.22" == null) {
+    if ("0.19.23" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.19.22";
+    return "0.19.23";
   }
   getCliName() {
     if ("fern" == null) {

package/package.json

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