@fern-api/fern-api-dev 3.70.2 → 3.71.0

package/cli.cjs

@@ -671980,7 +671980,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.70.2",
+          version: "3.71.0",
           usingAccessToken: true
         }
       });
@@ -672079,7 +672079,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.70.2",
+        version: "3.71.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -726124,6 +726124,7 @@ __export(serialization_exports4, {
   ApiReferenceConfiguration: () => ApiReferenceConfiguration,
   ApiReferenceEndpointConfiguration: () => ApiReferenceEndpointConfiguration,
   ApiReferenceLayoutItem: () => ApiReferenceLayoutItem,
+  ApiReferenceOperationConfiguration: () => ApiReferenceOperationConfiguration,
   ApiReferencePackageConfiguration: () => ApiReferencePackageConfiguration,
   ApiReferencePackageConfigurationWithOptions: () => ApiReferencePackageConfigurationWithOptions,
   ApiReferenceSectionConfiguration: () => ApiReferenceSectionConfiguration,
@@ -726263,6 +726264,7 @@ __export(docs_exports5, {
   ApiReferenceConfiguration: () => ApiReferenceConfiguration,
   ApiReferenceEndpointConfiguration: () => ApiReferenceEndpointConfiguration,
   ApiReferenceLayoutItem: () => ApiReferenceLayoutItem,
+  ApiReferenceOperationConfiguration: () => ApiReferenceOperationConfiguration,
   ApiReferencePackageConfiguration: () => ApiReferencePackageConfiguration,
   ApiReferencePackageConfigurationWithOptions: () => ApiReferencePackageConfigurationWithOptions,
   ApiReferenceSectionConfiguration: () => ApiReferenceSectionConfiguration,
@@ -727933,6 +727935,15 @@ var ApiReferenceEndpointConfiguration = schemas_exports8.object({
   playground: PlaygroundSettings.optional()
 }).extend(WithPermissions).extend(WithFeatureFlags);
 
+// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/ApiReferenceOperationConfiguration.js
+var ApiReferenceOperationConfiguration = schemas_exports8.object({
+  operation: schemas_exports8.string(),
+  title: schemas_exports8.string().optional(),
+  slug: schemas_exports8.string().optional(),
+  hidden: schemas_exports8.boolean().optional(),
+  availability: Availability4.optional()
+}).extend(WithPermissions).extend(WithFeatureFlags);
+
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/Target.js
 var Target2 = schemas_exports8.enum_(["_blank", "_self", "_parent", "_top"]);
 
@@ -727961,6 +727972,7 @@ var ApiReferenceLayoutItem = schemas_exports8.undiscriminatedUnion([
   schemas_exports8.record(schemas_exports8.string(), schemas_exports8.lazy(() => ApiReferencePackageConfiguration)),
   schemas_exports8.lazyObject(() => ApiReferenceSectionConfiguration),
   ApiReferenceEndpointConfiguration,
+  ApiReferenceOperationConfiguration,
   PageConfiguration,
   LinkConfiguration
 ]);
@@ -731099,7 +731111,7 @@ var GraphQlSpecSchema = schemas_exports10.object({
   graphql: schemas_exports10.string(),
   origin: schemas_exports10.string().optional(),
   overrides: schemas_exports10.string().optional(),
-  resource: schemas_exports10.string().optional()
+  name: schemas_exports10.string().optional()
 });
 
 // ../configuration/lib/generators-yml/schemas/serialization/resources/generators/types/OpenApiSpecSchema.js
@@ -754528,6 +754540,20 @@ function parseApiReferenceLayoutItem(item, absolutePathToConfig) {
         featureFlags: convertFeatureFlag(item.featureFlag)
       }
     ];
+  } else if (isRawApiRefOperationConfiguration(item)) {
+    return [
+      {
+        type: "operation",
+        operation: item.operation,
+        title: item.title,
+        slug: item.slug,
+        hidden: item.hidden,
+        availability: item.availability,
+        viewers: parseRoles(item.viewers),
+        orphaned: item.orphaned,
+        featureFlags: convertFeatureFlag(item.featureFlag)
+      }
+    ];
   }
   return Object.entries(item).map(([key2, value]) => {
     if (isRawApiRefPackageConfiguration(value)) {
@@ -754634,6 +754660,9 @@ function isRawApiRefSectionConfiguration(item) {
 function isRawApiRefEndpointConfiguration(item) {
   return isPlainObject4(item) && typeof item.endpoint === "string";
 }
+function isRawApiRefOperationConfiguration(item) {
+  return isPlainObject4(item) && typeof item.operation === "string";
+}
 function isRawApiRefPackageConfiguration(item) {
   return !Array.isArray(item);
 }
@@ -760496,7 +760525,7 @@ async function parseApiConfigurationV2Schema({ apiConfiguration, rawConfiguratio
     } else {
       continue;
     }
-    const namespaceValue = generators_yml_exports.isGraphQLSpecSchema(spec) && "resource" in spec ? spec.resource : "namespace" in spec ? spec.namespace : void 0;
+    const namespaceValue = generators_yml_exports.isGraphQLSpecSchema(spec) && "name" in spec ? spec.name : "namespace" in spec ? spec.namespace : void 0;
     if (namespaceValue != null) {
       namespacedDefinitions[namespaceValue] ??= [];
       namespacedDefinitions[namespaceValue].push(definitionLocation);
@@ -1088381,6 +1088410,88 @@ var definitions4 = {
     ],
     additionalProperties: false
   },
+  "docs.ApiReferenceOperationConfiguration": {
+    type: "object",
+    properties: {
+      viewers: {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.Role"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      orphaned: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      "feature-flag": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.FeatureFlagConfiguration"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      operation: {
+        type: "string"
+      },
+      title: {
+        oneOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      slug: {
+        oneOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      hidden: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      availability: {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.Availability"
+          },
+          {
+            type: "null"
+          }
+        ]
+      }
+    },
+    required: [
+      "operation"
+    ],
+    additionalProperties: false
+  },
   "docs.LinkConfiguration": {
     type: "object",
     properties: {
@@ -1088436,6 +1088547,9 @@ var definitions4 = {
       {
         $ref: "#/definitions/docs.ApiReferenceEndpointConfiguration"
       },
+      {
+        $ref: "#/definitions/docs.ApiReferenceOperationConfiguration"
+      },
       {
         $ref: "#/definitions/docs.PageConfiguration"
       },
@@ -1134565,7 +1134679,8 @@ ${escapedDescription}`;
       package: (pkg2) => this.#convertPackage(pkg2, parentSlug, parentAvailability),
       section: (section) => this.#convertSection(section, parentSlug, parentAvailability),
       item: ({ value: unknownIdentifier }) => this.#convertUnknownIdentifier(unknownIdentifier, apiDefinitionPackageId, parentSlug, parentAvailability),
-      endpoint: (endpoint3) => this.#convertEndpoint(endpoint3, apiDefinitionPackageId, parentSlug, parentAvailability)
+      endpoint: (endpoint3) => this.#convertEndpoint(endpoint3, apiDefinitionPackageId, parentSlug, parentAvailability),
+      operation: (operation) => this.#convertOperation(operation, apiDefinitionPackageId, parentSlug, parentAvailability)
     })).filter(isNonNullish2);
   }
   #toPageNode(page, parentSlug, parentAvailability) {
@@ -1134866,6 +1134981,88 @@ ${escapedDescription}`;
     this.taskContext.logger.error("Unknown identifier in the API Reference layout: ", endpointItem.endpoint);
     return;
   }
+  #convertOperation(operationItem, apiDefinitionPackageIdRaw, parentSlug, parentAvailability) {
+    const operationParts = operationItem.operation.trim().split(/\s+/, 2);
+    if (operationParts.length !== 2) {
+      this.taskContext.logger.error(`Invalid operation format in the API Reference layout: ${operationItem.operation}. Expected format: "OPERATION_TYPE operationName" (e.g., "QUERY account")`);
+      return;
+    }
+    const [operationType, operationName] = operationParts;
+    if (!operationName) {
+      this.taskContext.logger.error(`Invalid operation format in the API Reference layout: ${operationItem.operation}. Expected format: "OPERATION_TYPE operationName" (e.g., "QUERY account")`);
+      return;
+    }
+    const allOperations = this.#holder.api.rootPackage.graphqlOperations ?? [];
+    const matchingOperations = allOperations.filter((op5) => {
+      if (op5.operationType !== operationType) {
+        return false;
+      }
+      if (operationName.includes(".")) {
+        if (op5.id === operationName) {
+          return true;
+        }
+        if (op5.name === operationName) {
+          return true;
+        }
+        const namespacedParts = operationName.split(".");
+        const opName = namespacedParts[namespacedParts.length - 1];
+        const namespace = namespacedParts.slice(0, -1).join(".");
+        if (op5.name === opName || op5.id === opName) {
+          return op5.id.startsWith(namespace + ".") || this.#graphqlNamespacesByOperationId.get(FdrAPI_exports.GraphQlOperationId(op5.id)) === namespace;
+        }
+      } else {
+        return op5.name === operationName || op5.id === operationName;
+      }
+      return false;
+    });
+    if (!operationName.includes(".")) {
+      const sameNameOperations = allOperations.filter((op5) => op5.operationType === operationType && (op5.name === operationName || op5.id === operationName));
+      if (sameNameOperations.length > 1) {
+        const suggestions = sameNameOperations.map((op5) => {
+          const namespace = this.#graphqlNamespacesByOperationId.get(FdrAPI_exports.GraphQlOperationId(op5.id));
+          if (namespace) {
+            return `"${operationType} ${namespace}.${operationName}"`;
+          }
+          const idParts = op5.id.split("_");
+          if (idParts.length >= 3) {
+            const extractedNamespace = idParts[0];
+            return `"${operationType} ${extractedNamespace}.${operationName}"`;
+          }
+          return `"${operationType} ${op5.id}"`;
+        }).join(", ");
+        this.taskContext.logger.warn(`Ambiguous operation reference: "${operationItem.operation}". Found ${sameNameOperations.length} operations with name "${operationName}". Using first match: "${suggestions.split(", ")[0]}". Please use the full namespaced format for clarity. Available options: ${suggestions}`);
+      }
+    }
+    const graphqlOperation = matchingOperations[0];
+    if (graphqlOperation == null) {
+      this.taskContext.logger.error(`GraphQL operation not found in the API Reference layout: ${operationItem.operation}`);
+      return;
+    }
+    const operationId = APIV1Read_exports.GraphQlOperationId(graphqlOperation.id);
+    if (this.#visitedGraphqlOperations.has(operationId)) {
+      this.taskContext.logger.error(`Duplicate GraphQL operation found in the API Reference layout: ${operationId}`);
+      return;
+    }
+    this.#visitedGraphqlOperations.add(operationId);
+    const operationSlug = operationItem.slug != null ? parentSlug.append(operationItem.slug) : parentSlug.append(graphqlOperation.name ?? graphqlOperation.id);
+    return {
+      id: this.#idgen.get(`${this.apiDefinitionId}:${operationId}`),
+      type: "graphql",
+      operationType: graphqlOperation.operationType,
+      graphqlOperationId: APIV1Read_exports.GraphQlOperationId(graphqlOperation.id),
+      apiDefinitionId: this.apiDefinitionId,
+      availability: operationItem.availability ?? parentAvailability,
+      title: operationItem.title ?? graphqlOperation.displayName ?? graphqlOperation.name ?? graphqlOperation.id,
+      slug: operationSlug.get(),
+      icon: void 0,
+      hidden: this.hideChildren || operationItem.hidden,
+      playground: void 0,
+      authed: void 0,
+      viewers: operationItem.viewers,
+      orphaned: operationItem.orphaned,
+      featureFlags: operationItem.featureFlags
+    };
+  }
   // Step 2
   #mergeAndFilterChildren(left3, right3) {
     return mergeAndFilterChildren({
@@ -1180360,7 +1180557,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.70.2";
+    return "3.71.0";
   }
   getCliName() {
     if (false) {
@@ -1183480,7 +1183677,7 @@ var import_path58 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "3.70.2";
+  const version7 = "3.71.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -1186260,6 +1186457,88 @@ var definitions5 = {
     ],
     additionalProperties: false
   },
+  "docs.ApiReferenceOperationConfiguration": {
+    type: "object",
+    properties: {
+      viewers: {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.Role"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      orphaned: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      "feature-flag": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.FeatureFlagConfiguration"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      operation: {
+        type: "string"
+      },
+      title: {
+        oneOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      slug: {
+        oneOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      hidden: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      availability: {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.Availability"
+          },
+          {
+            type: "null"
+          }
+        ]
+      }
+    },
+    required: [
+      "operation"
+    ],
+    additionalProperties: false
+  },
   "docs.LinkConfiguration": {
     type: "object",
     properties: {
@@ -1186315,6 +1186594,9 @@ var definitions5 = {
       {
         $ref: "#/definitions/docs.ApiReferenceEndpointConfiguration"
       },
+      {
+        $ref: "#/definitions/docs.ApiReferenceOperationConfiguration"
+      },
       {
         $ref: "#/definitions/docs.PageConfiguration"
       },
@@ -1188182,6 +1188464,88 @@ var definitions6 = {
     ],
     additionalProperties: false
   },
+  "docs.ApiReferenceOperationConfiguration": {
+    type: "object",
+    properties: {
+      viewers: {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.Role"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      orphaned: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      "feature-flag": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.FeatureFlagConfiguration"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      operation: {
+        type: "string"
+      },
+      title: {
+        oneOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      slug: {
+        oneOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      hidden: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      availability: {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.Availability"
+          },
+          {
+            type: "null"
+          }
+        ]
+      }
+    },
+    required: [
+      "operation"
+    ],
+    additionalProperties: false
+  },
   "docs.LinkConfiguration": {
     type: "object",
     properties: {
@@ -1188237,6 +1188601,9 @@ var definitions6 = {
       {
         $ref: "#/definitions/docs.ApiReferenceEndpointConfiguration"
       },
+      {
+        $ref: "#/definitions/docs.ApiReferenceOperationConfiguration"
+      },
       {
         $ref: "#/definitions/docs.PageConfiguration"
       },

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.70.2",
+  "version": "3.71.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",