@fern-api/fern-api-dev 4.108.0 → 4.109.0-1-g1bf359628bd

package/cli.cjs

@@ -510619,7 +510619,7 @@ var MetadataConfig = external_exports.object({
   "twitter:url": external_exports.string().optional(),
   "twitter:card": TwitterCardSetting.optional(),
   "og:dynamic": external_exports.boolean().optional(),
-  "og:background-image": external_exports.string().optional(),
+  "og:dynamic:background-image": external_exports.string().optional(),
   "og:dynamic:text-color": external_exports.string().optional(),
   "og:dynamic:background-color": external_exports.string().optional(),
   "og:dynamic:logo-color": external_exports.enum(["dark", "light"]).optional(),
@@ -513961,7 +513961,7 @@ var MetadataConfig2 = schemas_exports6.object({
   twitterUrl: schemas_exports6.property("twitter:url", schemas_exports6.string().optional()),
   twitterCard: schemas_exports6.property("twitter:card", TwitterCardSetting3.optional()),
   ogDynamic: schemas_exports6.property("og:dynamic", schemas_exports6.boolean().optional()),
-  ogBackgroundImage: schemas_exports6.property("og:background-image", schemas_exports6.string().optional()),
+  ogDynamicBackgroundImage: schemas_exports6.property("og:dynamic:background-image", schemas_exports6.string().optional()),
   ogDynamicTextColor: schemas_exports6.property("og:dynamic:text-color", schemas_exports6.string().optional()),
   ogDynamicBackgroundColor: schemas_exports6.property("og:dynamic:background-color", schemas_exports6.string().optional()),
   ogDynamicLogoColor: schemas_exports6.property("og:dynamic:logo-color", OgDynamicLogoColor2.optional()),
@@ -543279,7 +543279,7 @@ async function convertMetadata(metadata, absoluteFilepathToDocsConfig, context3)
     "twitter:url": metadata.twitterUrl,
     "twitter:card": metadata.twitterCard,
     "og:dynamic": metadata.ogDynamic,
-    "og:background-image": await convertFilepathOrUrl(metadata.ogBackgroundImage, absoluteFilepathToDocsConfig),
+    "og:dynamic:background-image": await convertFilepathOrUrl(metadata.ogDynamicBackgroundImage, absoluteFilepathToDocsConfig),
     "og:dynamic:text-color": metadata.ogDynamicTextColor,
     "og:dynamic:background-color": metadata.ogDynamicBackgroundColor,
     "og:dynamic:logo-color": metadata.ogDynamicLogoColor,
@@ -543296,7 +543296,7 @@ async function convertMetadata(metadata, absoluteFilepathToDocsConfig, context3)
 function warnOnMetadataConflicts(metadata, context3) {
   const dynamicEnabled = metadata.ogDynamic === true;
   const dynamicSettings = [
-    ["og:background-image", metadata.ogBackgroundImage],
+    ["og:dynamic:background-image", metadata.ogDynamicBackgroundImage],
     ["og:dynamic:text-color", metadata.ogDynamicTextColor],
     ["og:dynamic:background-color", metadata.ogDynamicBackgroundColor],
     ["og:dynamic:logo-color", metadata.ogDynamicLogoColor],
@@ -614192,6 +614192,7 @@ __export(schemas_exports13, {
   GitOutputSchema: () => GitOutputSchema,
   GitSelfHostedOutputModeSchema: () => GitSelfHostedOutputModeSchema,
   GitSelfHostedOutputSchema: () => GitSelfHostedOutputSchema,
+  GraphQlSpecSchema: () => GraphQlSpecSchema2,
   HeaderConfigSchema: () => HeaderConfigSchema,
   HeaderSchema: () => HeaderSchema2,
   IntegrationsConfigSchema: () => IntegrationsConfigSchema2,
@@ -614391,6 +614392,18 @@ var FernSpecSchema = external_exports.object({
   settings: FernSettingsSchema.optional()
 });
 
+// ../config/lib/schemas/specs/GraphQlSpecSchema.js
+var GraphQlSpecSchema2 = external_exports.object({
+  /** Path to the GraphQL schema file. */
+  graphql: external_exports.string(),
+  /** URL origin for the GraphQL endpoint. */
+  origin: external_exports.string().optional(),
+  /** Path to overrides file for the GraphQL spec. */
+  overrides: external_exports.union([external_exports.string(), external_exports.array(external_exports.string()).nonempty()]).optional(),
+  /** Name used to group this GraphQL spec in the docs (rendered as a top-level section). */
+  name: external_exports.string().optional()
+});
+
 // ../config/lib/schemas/settings/DefaultIntegerFormatSchema.js
 var DefaultIntegerFormatSchema = external_exports.enum(["int32", "int64", "uint32", "uint64"]);
 
@@ -614540,7 +614553,8 @@ var ApiSpecSchema = external_exports.union([
   ProtobufSpecSchema2,
   FernSpecSchema,
   ConjureSpecSchema,
-  OpenRpcSpecSchema2
+  OpenRpcSpecSchema2,
+  GraphQlSpecSchema2
 ]);
 
 // ../config/lib/schemas/AuthSchemesSchema.js
@@ -621372,7 +621386,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.108.0",
+          version: "4.109.0-1-g1bf359628bd",
           usingAccessToken: true
         }
       });
@@ -621426,7 +621440,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.108.0",
+        version: "4.109.0-1-g1bf359628bd",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -625252,6 +625266,13 @@ var ApiDefinitionConverter = class {
         sourced
       });
     }
+    if ("graphql" in spec && "graphql" in sourced) {
+      return await this.convertGraphQlSpec({
+        absoluteFernYmlPath,
+        spec,
+        sourced
+      });
+    }
     throw new CliError({
       message: `Unknown spec type: ${JSON.stringify(spec)}`,
       code: CliError.Code.InternalError
@@ -625361,6 +625382,25 @@ var ApiDefinitionConverter = class {
     }
     return result;
   }
+  async convertGraphQlSpec({ absoluteFernYmlPath, spec, sourced }) {
+    const result = {
+      graphql: await this.resolvePath({ absoluteFernYmlPath, path: spec.graphql, sourced: sourced.graphql })
+    };
+    if (spec.origin != null) {
+      result.origin = spec.origin;
+    }
+    if (spec.overrides != null && !isNullish2(sourced.overrides)) {
+      result.overrides = await this.resolvePathOrPaths({
+        absoluteFernYmlPath,
+        paths: spec.overrides,
+        sourced: sourced.overrides
+      });
+    }
+    if (spec.name != null) {
+      result.name = spec.name;
+    }
+    return result;
+  }
   async convertOpenRpcSpec({ absoluteFernYmlPath, spec, sourced }) {
     const result = {
       openrpc: await this.resolvePath({ absoluteFernYmlPath, path: spec.openrpc, sourced: sourced.openrpc })
@@ -626639,6 +626679,11 @@ var TaskContextAdapter = class {
 // ../cli-v2/lib/api/adapter/LegacyApiSpecAdapter.js
 init_lib6();
 
+// ../cli-v2/lib/api/config/GraphQlSpec.js
+function isGraphQlSpec(spec) {
+  return "graphql" in spec;
+}
+
 // ../cli-v2/lib/api/config/OpenRpcSpec.js
 function isOpenRpcSpec(spec) {
   return "openrpc" in spec;
@@ -626650,6 +626695,24 @@ function isProtobufSpec(spec) {
 }
 
 // ../cli-v2/lib/api/adapter/LegacyApiSpecAdapter.js
+function partitionV1Specs(v1Specs) {
+  const filteredSpecs = v1Specs.filter((spec) => {
+    if (spec.type === "openrpc" || spec.type === "graphql") {
+      return false;
+    }
+    if (spec.type === "protobuf" && !spec.fromOpenAPI) {
+      return false;
+    }
+    return true;
+  });
+  const allSpecs = v1Specs.filter((spec) => {
+    if (spec.type === "protobuf" && spec.fromOpenAPI) {
+      return false;
+    }
+    return true;
+  });
+  return { filteredSpecs, allSpecs };
+}
 var LegacyApiSpecAdapter = class {
   context;
   constructor(config5) {
@@ -626668,6 +626731,9 @@ var LegacyApiSpecAdapter = class {
     if (isOpenRpcSpec(spec)) {
       return this.adaptOpenRpcSpec(spec);
     }
+    if (isGraphQlSpec(spec)) {
+      return this.adaptGraphQlSpec(spec);
+    }
     throw new CliError({
       message: `Unsupported spec type: ${JSON.stringify(spec)}`,
       code: CliError.Code.InternalError
@@ -626726,6 +626792,14 @@ var LegacyApiSpecAdapter = class {
       namespace: void 0
     };
   }
+  adaptGraphQlSpec(spec) {
+    return {
+      type: "graphql",
+      absoluteFilepath: spec.graphql,
+      absoluteFilepathToOverrides: spec.overrides,
+      namespace: spec.name
+    };
+  }
   adaptOpenApiSettings(settings) {
     if (settings == null) {
       return void 0;
@@ -626938,21 +627012,10 @@ var ApiDefinitionValidator = class {
     }
     const specAdapter = new LegacyApiSpecAdapter({ context: this.context });
     const v1Specs = specAdapter.convertAll(ossSpecs);
-    const filteredSpecs = v1Specs.filter((spec) => {
-      if (spec.type === "openrpc") {
-        return false;
-      }
-      if (spec.type === "protobuf" && !spec.fromOpenAPI) {
-        return false;
-      }
-      return true;
-    });
-    const allSpecs = v1Specs.filter((spec) => {
-      if (spec.type === "protobuf" && spec.fromOpenAPI) {
-        return false;
-      }
-      return true;
-    });
+    const { filteredSpecs, allSpecs } = partitionV1Specs(v1Specs);
+    if (filteredSpecs.length === 0) {
+      return violations;
+    }
     const ossWorkspace = new OSSWorkspace({
       specs: filteredSpecs,
       allSpecs,
@@ -753778,22 +753841,9 @@ var LegacyOSSWorkspaceAdapter = class {
       return void 0;
     }
     const v1Specs = this.specAdapter.convertAll(ossSpecs);
-    const filteredSpecs = v1Specs.filter((spec) => {
-      if (spec.type === "openrpc") {
-        return false;
-      }
-      if (spec.type === "protobuf" && !spec.fromOpenAPI) {
-        return false;
-      }
-      return true;
-    });
-    const allSpecs = v1Specs.filter((spec) => {
-      if (spec.type === "protobuf" && spec.fromOpenAPI) {
-        return false;
-      }
-      return true;
-    });
-    if (filteredSpecs.length === 0) {
+    const { filteredSpecs, allSpecs } = partitionV1Specs(v1Specs);
+    const hasGraphQlSpec = allSpecs.some((spec) => spec.type === "graphql");
+    if (filteredSpecs.length === 0 && !hasGraphQlSpec) {
       return void 0;
     }
     return new OSSWorkspace({
@@ -798769,8 +798819,8 @@ async function collectFilesFromDocsConfig({ parsedDocsConfig }) {
   if (parsedDocsConfig.metadata?.["twitter:image"] != null && parsedDocsConfig.metadata["twitter:image"].type === "filepath") {
     filepaths.add(parsedDocsConfig.metadata["twitter:image"].value);
   }
-  if (parsedDocsConfig.metadata?.["og:background-image"] != null && parsedDocsConfig.metadata["og:background-image"].type === "filepath") {
-    filepaths.add(parsedDocsConfig.metadata["og:background-image"].value);
+  if (parsedDocsConfig.metadata?.["og:dynamic:background-image"] != null && parsedDocsConfig.metadata["og:dynamic:background-image"].type === "filepath") {
+    filepaths.add(parsedDocsConfig.metadata["og:dynamic:background-image"].value);
   }
   if (parsedDocsConfig.typography?.bodyFont != null) {
     parsedDocsConfig.typography.bodyFont.variants.forEach((variant) => {
@@ -800752,13 +800802,13 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     if (this.parsedDocsConfig.metadata == null) {
       return;
     }
-    const { "og:image": ogImage, "og:logo": ogLogo, "twitter:image": twitterImage, "og:background-image": ogBackgroundImage, ...rest } = this.parsedDocsConfig.metadata;
+    const { "og:image": ogImage, "og:logo": ogLogo, "twitter:image": twitterImage, "og:dynamic:background-image": ogDynamicBackgroundImage, ...rest } = this.parsedDocsConfig.metadata;
     return {
       ...rest,
       "og:image": this.convertFileIdOrUrl(ogImage),
       "og:logo": this.convertFileIdOrUrl(ogLogo),
       "twitter:image": this.convertFileIdOrUrl(twitterImage),
-      "og:background-image": this.convertFileIdOrUrl(ogBackgroundImage)
+      "og:dynamic:background-image": this.convertFileIdOrUrl(ogDynamicBackgroundImage)
     };
   }
   convertFileIdOrUrl(filepathOrUrl) {
@@ -800941,7 +800991,7 @@ async function resolveThemeFileUrls(themeConfig, tmpDir) {
   cfg.footer = await maybeDownload(cfg.footer);
   if (cfg.metadata != null && typeof cfg.metadata === "object") {
     const meta5 = cfg.metadata;
-    for (const imgKey of ["og:image", "twitter:image", "og:background-image", "og:logo"]) {
+    for (const imgKey of ["og:image", "twitter:image", "og:dynamic:background-image", "og:logo"]) {
       meta5[imgKey] = await maybeDownload(meta5[imgKey]);
     }
   }
@@ -829157,8 +829207,8 @@ var LegacyProjectAdapter = class {
     this.context = context3;
     this.ossAdapter = new LegacyOSSWorkspaceAdapter({ context: context3 });
   }
-  adapt(workspace) {
-    const apiWorkspaces = this.buildApiWorkspaces(workspace);
+  async adapt(workspace) {
+    const apiWorkspaces = await this.buildApiWorkspaces(workspace);
     const docsWorkspace = workspace.docs != null ? this.docsAdapter.adapt({
       docsConfig: workspace.docs,
       absoluteFilePath: workspace.docs.absoluteFilePath ?? workspace.absoluteFilePath ?? this.context.cwd
@@ -829186,8 +829236,9 @@ var LegacyProjectAdapter = class {
   /**
    * Bridges API definitions to legacy AbstractAPIWorkspace instances.
    */
-  buildApiWorkspaces(workspace) {
+  async buildApiWorkspaces(workspace) {
     const workspaces = [];
+    const taskContext = new TaskContextAdapter({ context: this.context });
     for (const [apiName, apiDef] of Object.entries(workspace.apis)) {
       const ossWorkspace = this.ossAdapter.build({
         definition: apiDef,
@@ -829196,6 +829247,7 @@ var LegacyProjectAdapter = class {
         absoluteFilePath: this.context.cwd
       });
       if (ossWorkspace != null) {
+        await ossWorkspace.processGraphQLSpecs(taskContext);
         workspaces.push(ossWorkspace);
       }
     }
@@ -829258,7 +829310,7 @@ var DocsChecker = class {
       };
     }
     const adapter2 = new LegacyProjectAdapter({ context: this.context });
-    const project = adapter2.adapt(workspace);
+    const project = await adapter2.adapt(workspace);
     const docsWorkspace = project.docsWorkspaces;
     if (docsWorkspace == null) {
       throw new CliError({
@@ -829365,6 +829417,7 @@ var SdkChecker = class {
     this.validateTargetApiReferences({ workspace, sdks: sdks2, violations });
     this.validateDefaultGroup({ sdks: sdks2, fernYmlRelativePath, violations });
     this.validateEmptyVersions({ sdks: sdks2, violations });
+    this.validateGraphQlSpecs({ workspace, sdks: sdks2, violations });
     await this.validateVersions({ sdks: sdks2, violations });
     return {
       violations,
@@ -829446,6 +829499,31 @@ var SdkChecker = class {
       }
     }
   }
+  /**
+   * Emits a warning for any target whose referenced API contains a GraphQL spec.
+   * GraphQL SDKs are not supported; the graphql specs will be skipped during generation.
+   */
+  validateGraphQlSpecs({ workspace, sdks: sdks2, violations }) {
+    for (const target of sdks2.targets) {
+      const api2 = workspace.apis[target.api];
+      if (api2 == null) {
+        continue;
+      }
+      const hasGraphQl = api2.specs.some(isGraphQlSpec);
+      if (!hasGraphQl) {
+        continue;
+      }
+      violations.push({
+        severity: "warning",
+        relativeFilepath: target.sourceLocation.relativeFilePath,
+        nodePath: ["sdks", "targets", target.name, "api"],
+        message: `API '${target.api}' contains a GraphQL spec. GraphQL SDKs are not supported and graphql specs will be skipped for this target.`,
+        displayRelativeFilepath: target.sourceLocation.relativeFilePath,
+        line: target.sourceLocation.line,
+        column: target.sourceLocation.column
+      });
+    }
+  }
   /**
    * Checks that pinned versions exist in the registry.
    */
@@ -829851,6 +829929,13 @@ function adjustSpecPaths(specs, apiName) {
         overrides: spec.overrides != null ? adjustPathOrPaths(spec.overrides, apiName) : void 0
       };
     }
+    if ("graphql" in spec) {
+      return {
+        ...spec,
+        graphql: adjustPath(spec.graphql, apiName),
+        overrides: spec.overrides != null ? adjustPathOrPaths(spec.overrides, apiName) : void 0
+      };
+    }
     if ("proto" in spec) {
       return {
         ...spec,
@@ -830001,6 +830086,22 @@ function convertSpec(spec, warnings) {
     }
     return result;
   }
+  if ("graphql" in spec) {
+    const graphqlSpec = spec;
+    const result = {
+      graphql: graphqlSpec.graphql
+    };
+    if (graphqlSpec.origin != null) {
+      result.origin = graphqlSpec.origin;
+    }
+    if (graphqlSpec.overrides != null) {
+      result.overrides = graphqlSpec.overrides;
+    }
+    if (graphqlSpec.name != null) {
+      result.name = graphqlSpec.name;
+    }
+    return result;
+  }
   warnings.push({
     type: "unsupported",
     message: `Unknown spec type: ${JSON.stringify(Object.keys(spec))}`
@@ -830016,6 +830117,8 @@ function convertNamespacedSpecs(config5, warnings) {
         specs.push({ ...spec, namespace });
       } else if ("asyncapi" in spec) {
         specs.push({ ...spec, namespace });
+      } else if ("graphql" in spec) {
+        specs.push({ ...spec, name: spec.name ?? namespace });
       } else if ("fern" in spec) {
         warnings.push({
           type: "info",
@@ -833072,7 +833175,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "4.108.0";
+  const version7 = "4.109.0-1-g1bf359628bd";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -835571,7 +835674,7 @@ var LegacyDevServer = class {
    */
   async start({ port, backendPort, forceDownload, bundlePath, logLevel }) {
     const workspace = await this.context.loadWorkspaceOrThrow();
-    const initialProject = this.adapter.adapt(workspace);
+    const initialProject = await this.adapter.adapt(workspace);
     const taskContext = new TaskContextAdapter({ context: this.context, logLevel });
     this.context.stderr.info("Bootstrapping docs preview (this may take a few seconds)...");
     await runAppPreviewServer({
@@ -841512,7 +841615,7 @@ var definitions6 = {
           }
         ]
       },
-      "og:background-image": {
+      "og:dynamic:background-image": {
         oneOf: [
           {
             type: "string"
@@ -845490,7 +845593,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.108.0",
+        cliVersion: "4.109.0-1-g1bf359628bd",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -846134,7 +846237,7 @@ var PublishCommand = class {
       }
     }
     const adapter2 = new LegacyProjectAdapter({ context: context3 });
-    const project = adapter2.adapt(workspace);
+    const project = await adapter2.adapt(workspace);
     const docsWorkspace = project.docsWorkspaces;
     if (docsWorkspace == null) {
       throw new CliError({
@@ -848773,8 +848876,12 @@ var import_path67 = __toESM(require("path"), 1);
 // ../cli-v2/lib/api/resolver/ApiSpecDetector.js
 init_js_yaml();
 var DETECTABLE_SPEC_TYPES = ["openapi", "asyncapi"];
+var GRAPHQL_EXTENSIONS = [".graphql", ".graphqls", ".gql"];
 var ApiSpecDetector = class {
   async detect({ absoluteFilePath, reference: reference4, content: content5 }) {
+    if (this.hasGraphQlExtension(absoluteFilePath) || this.hasGraphQlExtension(reference4)) {
+      return "graphql";
+    }
     const parsed = this.parseOrThrow({ content: content5, reference: reference4 });
     if (typeof parsed !== "object" || parsed == null) {
       throw new CliError({
@@ -848792,6 +848899,10 @@ var ApiSpecDetector = class {
       code: CliError.Code.InternalError
     });
   }
+  hasGraphQlExtension(path105) {
+    const lower = path105.toLowerCase();
+    return GRAPHQL_EXTENSIONS.some((ext2) => lower.endsWith(ext2));
+  }
   parseOrThrow({ content: content5, reference: reference4 }) {
     try {
       return jsYaml.load(content5);
@@ -848869,7 +848980,10 @@ var ApiSpecResolver = class {
     return { content: content5, contentType };
   }
   inferExtension({ url: url3, contentType }) {
-    const urlPath = new URL(url3).pathname;
+    const urlPath = new URL(url3).pathname.toLowerCase();
+    if (urlPath.endsWith(".graphql") || urlPath.endsWith(".graphqls") || urlPath.endsWith(".gql")) {
+      return ".graphql";
+    }
     if (urlPath.endsWith(".json")) {
       return ".json";
     }
@@ -848887,9 +849001,11 @@ var ApiSpecResolver = class {
         return { openapi: absoluteFilePath, origin: origin2 };
       case "asyncapi":
         return { asyncapi: absoluteFilePath, origin: origin2 };
+      case "graphql":
+        return { graphql: absoluteFilePath, origin: origin2 };
       default:
         throw new CliError({
-          message: `Unsupported spec type for flags mode: "${specType}". Supported: openapi, asyncapi`,
+          message: `Unsupported spec type for flags mode: "${specType}". Supported: openapi, asyncapi, graphql`,
           code: CliError.Code.ConfigError
         });
     }
@@ -919725,7 +919841,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.108.0";
+    return "4.109.0-1-g1bf359628bd";
   }
   getCliName() {
     if (false) {
@@ -928713,7 +928829,7 @@ ${errors4.map((e8) => `  - ${e8}`).join("\n")}`,
     collect2(raw.footer);
     if (raw.metadata != null && typeof raw.metadata === "object") {
       const meta5 = raw.metadata;
-      for (const imgKey of ["og:image", "twitter:image", "og:background-image", "og:logo"]) {
+      for (const imgKey of ["og:image", "twitter:image", "og:dynamic:background-image", "og:logo"]) {
         if (typeof meta5[imgKey] === "string") {
           collect2(meta5[imgKey]);
         }
@@ -928801,7 +928917,7 @@ ${errors4.map((e8) => `  - ${e8}`).join("\n")}`,
     cfg.footer = await field5(cfg.footer);
     if (cfg.metadata != null && typeof cfg.metadata === "object") {
       const meta5 = { ...cfg.metadata };
-      for (const imgKey of ["og:image", "twitter:image", "og:background-image", "og:logo"]) {
+      for (const imgKey of ["og:image", "twitter:image", "og:dynamic:background-image", "og:logo"]) {
         if (typeof meta5[imgKey] === "string") {
           meta5[imgKey] = await field5(meta5[imgKey]);
         }

package/package.json

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