fern-api 0.26.4 → 0.26.6

package/bundle.cjs

@@ -372886,7 +372886,8 @@ var init_ArraySchemaWithExample2 = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/parseIr/types/ArraySchemaWithExample.js"() {
     init_core3();
     ArraySchemaWithExample = schemas_exports5.objectWithoutOptionalProperties({
-      value: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SchemaWithExample)
+      value: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SchemaWithExample),
+      example: schemas_exports5.list(schemas_exports5.unknown()).optional()
     }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithSdkGroupName)).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithName)).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
   }
 });
@@ -438566,6 +438567,88 @@ var require_semver6 = __commonJS({
   }
 });
 
+// pnp:/home/circleci/project/.yarn/cache/supports-hyperlinks-npm-2.3.0-d19176eba2-9ee0de3c8c.zip/node_modules/supports-hyperlinks/index.js
+var require_supports_hyperlinks = __commonJS({
+  "pnp:/home/circleci/project/.yarn/cache/supports-hyperlinks-npm-2.3.0-d19176eba2-9ee0de3c8c.zip/node_modules/supports-hyperlinks/index.js"(exports2, module2) {
+    "use strict";
+    var supportsColor4 = require_supports_color2();
+    var hasFlag4 = require_has_flag();
+    function parseVersion2(versionString) {
+      if (/^\d{3,4}$/.test(versionString)) {
+        const m = /(\d{1,2})(\d{2})/.exec(versionString);
+        return {
+          major: 0,
+          minor: parseInt(m[1], 10),
+          patch: parseInt(m[2], 10)
+        };
+      }
+      const versions = (versionString || "").split(".").map((n2) => parseInt(n2, 10));
+      return {
+        major: versions[0],
+        minor: versions[1],
+        patch: versions[2]
+      };
+    }
+    function supportsHyperlink(stream) {
+      const { env: env5 } = process;
+      if ("FORCE_HYPERLINK" in env5) {
+        return !(env5.FORCE_HYPERLINK.length > 0 && parseInt(env5.FORCE_HYPERLINK, 10) === 0);
+      }
+      if (hasFlag4("no-hyperlink") || hasFlag4("no-hyperlinks") || hasFlag4("hyperlink=false") || hasFlag4("hyperlink=never")) {
+        return false;
+      }
+      if (hasFlag4("hyperlink=true") || hasFlag4("hyperlink=always")) {
+        return true;
+      }
+      if ("NETLIFY" in env5) {
+        return true;
+      }
+      if (!supportsColor4.supportsColor(stream)) {
+        return false;
+      }
+      if (stream && !stream.isTTY) {
+        return false;
+      }
+      if (process.platform === "win32") {
+        return false;
+      }
+      if ("CI" in env5) {
+        return false;
+      }
+      if ("TEAMCITY_VERSION" in env5) {
+        return false;
+      }
+      if ("TERM_PROGRAM" in env5) {
+        const version3 = parseVersion2(env5.TERM_PROGRAM_VERSION);
+        switch (env5.TERM_PROGRAM) {
+          case "iTerm.app":
+            if (version3.major === 3) {
+              return version3.minor >= 1;
+            }
+            return version3.major > 3;
+          case "WezTerm":
+            return version3.major >= 20200620;
+          case "vscode":
+            return version3.major > 1 || version3.major === 1 && version3.minor >= 72;
+        }
+      }
+      if ("VTE_VERSION" in env5) {
+        if (env5.VTE_VERSION === "0.50.0") {
+          return false;
+        }
+        const version3 = parseVersion2(env5.VTE_VERSION);
+        return version3.major > 0 || version3.minor >= 50;
+      }
+      return false;
+    }
+    module2.exports = {
+      supportsHyperlink,
+      stdout: supportsHyperlink(process.stdout),
+      stderr: supportsHyperlink(process.stderr)
+    };
+  }
+});
+
 // pnp:/home/circleci/project/.yarn/cache/builtins-npm-5.0.1-6d4820dd76-66d204657f.zip/node_modules/builtins/index.js
 var require_builtins = __commonJS({
   "pnp:/home/circleci/project/.yarn/cache/builtins-npm-5.0.1-6d4820dd76-66d204657f.zip/node_modules/builtins/index.js"(exports2, module2) {
@@ -939805,88 +939888,6 @@ var require_decompress = __commonJS({
   }
 });
 
-// pnp:/home/circleci/project/.yarn/cache/supports-hyperlinks-npm-2.3.0-d19176eba2-9ee0de3c8c.zip/node_modules/supports-hyperlinks/index.js
-var require_supports_hyperlinks = __commonJS({
-  "pnp:/home/circleci/project/.yarn/cache/supports-hyperlinks-npm-2.3.0-d19176eba2-9ee0de3c8c.zip/node_modules/supports-hyperlinks/index.js"(exports2, module2) {
-    "use strict";
-    var supportsColor4 = require_supports_color2();
-    var hasFlag4 = require_has_flag();
-    function parseVersion2(versionString) {
-      if (/^\d{3,4}$/.test(versionString)) {
-        const m = /(\d{1,2})(\d{2})/.exec(versionString);
-        return {
-          major: 0,
-          minor: parseInt(m[1], 10),
-          patch: parseInt(m[2], 10)
-        };
-      }
-      const versions = (versionString || "").split(".").map((n2) => parseInt(n2, 10));
-      return {
-        major: versions[0],
-        minor: versions[1],
-        patch: versions[2]
-      };
-    }
-    function supportsHyperlink(stream) {
-      const { env: env5 } = process;
-      if ("FORCE_HYPERLINK" in env5) {
-        return !(env5.FORCE_HYPERLINK.length > 0 && parseInt(env5.FORCE_HYPERLINK, 10) === 0);
-      }
-      if (hasFlag4("no-hyperlink") || hasFlag4("no-hyperlinks") || hasFlag4("hyperlink=false") || hasFlag4("hyperlink=never")) {
-        return false;
-      }
-      if (hasFlag4("hyperlink=true") || hasFlag4("hyperlink=always")) {
-        return true;
-      }
-      if ("NETLIFY" in env5) {
-        return true;
-      }
-      if (!supportsColor4.supportsColor(stream)) {
-        return false;
-      }
-      if (stream && !stream.isTTY) {
-        return false;
-      }
-      if (process.platform === "win32") {
-        return false;
-      }
-      if ("CI" in env5) {
-        return false;
-      }
-      if ("TEAMCITY_VERSION" in env5) {
-        return false;
-      }
-      if ("TERM_PROGRAM" in env5) {
-        const version3 = parseVersion2(env5.TERM_PROGRAM_VERSION);
-        switch (env5.TERM_PROGRAM) {
-          case "iTerm.app":
-            if (version3.major === 3) {
-              return version3.minor >= 1;
-            }
-            return version3.major > 3;
-          case "WezTerm":
-            return version3.major >= 20200620;
-          case "vscode":
-            return version3.major > 1 || version3.major === 1 && version3.minor >= 72;
-        }
-      }
-      if ("VTE_VERSION" in env5) {
-        if (env5.VTE_VERSION === "0.50.0") {
-          return false;
-        }
-        const version3 = parseVersion2(env5.VTE_VERSION);
-        return version3.major > 0 || version3.minor >= 50;
-      }
-      return false;
-    }
-    module2.exports = {
-      supportsHyperlink,
-      stdout: supportsHyperlink(process.stdout),
-      stderr: supportsHyperlink(process.stderr)
-    };
-  }
-});
-
 // pnp:/home/circleci/project/.yarn/cache/is-buffer-npm-2.0.5-17e563f277-764c9ad8b5.zip/node_modules/is-buffer/index.js
 var require_is_buffer = __commonJS({
   "pnp:/home/circleci/project/.yarn/cache/is-buffer-npm-2.0.5-17e563f277-764c9ad8b5.zip/node_modules/is-buffer/index.js"(exports2, module2) {
@@ -973894,6 +973895,11 @@ function isTabbedNavigationConfig3(navigationConfig) {
   return Array.isArray(navigationConfig) && navigationConfig.length > 0 && navigationConfig[0].tab != null;
 }
 
+// pnp:/home/circleci/project/packages/cli/configuration/lib/DocsLinks.js
+var DocsLinks = {
+  oauth: "https://buildwithfern.com/learn/api-definition/fern/api-yml-reference#authentication"
+};
+
 // pnp:/home/circleci/project/packages/cli/configuration/lib/fern-config-json/index.js
 var fern_config_json_exports = {};
 __export(fern_config_json_exports, {
@@ -977710,7 +977716,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.26.4",
+          version: "0.26.6",
           usingAccessToken: true
         }
       });
@@ -977772,7 +977778,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.26.4",
+        version: "0.26.6",
         ...event,
         ...event.properties
       }
@@ -988863,9 +988869,12 @@ __export(schemas_exports3, {
   HttpResponseStreamSchema: () => HttpResponseStreamSchema,
   HttpServiceSchema: () => HttpServiceSchema,
   MultipleBaseUrlsEnvironmentSchema: () => MultipleBaseUrlsEnvironmentSchema,
+  OAuthAccessTokenRequestPropertiesSchema: () => OAuthAccessTokenRequestPropertiesSchema,
+  OAuthAccessTokenResponsePropertiesSchema: () => OAuthAccessTokenResponsePropertiesSchema,
   OAuthClientCredentialsSchema: () => OAuthClientCredentialsSchema,
   OAuthGetTokenEndpointSchema: () => OAuthGetTokenEndpointSchema,
   OAuthRefreshTokenEndpointSchema: () => OAuthRefreshTokenEndpointSchema,
+  OAuthRefreshTokenRequestPropertiesSchema: () => OAuthRefreshTokenRequestPropertiesSchema,
   OAuthSchemeSchema: () => OAuthSchemeSchema,
   ObjectPropertySchema: () => ObjectPropertySchema,
   ObjectSchema: () => ObjectSchema,
@@ -988984,29 +988993,37 @@ var HeaderAuthSchemeSchema = AuthVariableSchema.extend({
   prefix: z.optional(z.string())
 });
 
-// pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthAccessTokenPropertiesSchema.js
-var OAuthAccessTokenPropertiesSchema = z.strictObject({
-  "access-token": z.string(),
-  "expires-in": z.optional(z.string()),
-  "refresh-token": z.optional(z.string())
+// pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthAccessTokenRequestPropertiesSchema.js
+var OAuthAccessTokenRequestPropertiesSchema = z.strictObject({
+  "client-id": z.optional(z.string()).describe("The property name for the client ID."),
+  "client-secret": z.optional(z.string()).describe("The property name for the client secret."),
+  scopes: z.optional(z.string()).describe("The property name for the scopes.")
+});
+
+// pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthAccessTokenResponsePropertiesSchema.js
+var OAuthAccessTokenResponsePropertiesSchema = z.strictObject({
+  "access-token": z.optional(z.string()).describe("The property name for the access token."),
+  "expires-in": z.optional(z.string()).describe("The property name for the expires in property."),
+  "refresh-token": z.optional(z.string()).describe("The property name for the refresh token.")
 });
 
 // pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthGetTokenEndpointSchema.js
 var OAuthGetTokenEndpointSchema = z.strictObject({
   endpoint: z.string().describe("The endpoint to get the access token, such as 'auth.get_token')"),
-  "response-properties": OAuthAccessTokenPropertiesSchema
+  "request-properties": OAuthAccessTokenRequestPropertiesSchema.optional(),
+  "response-properties": OAuthAccessTokenResponsePropertiesSchema.optional()
 });
 
-// pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthRefreshTokenPropertiesSchema.js
-var OAuthRefreshTokenPropertiesSchema = z.strictObject({
-  "refresh-token": z.string()
+// pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthRefreshTokenRequestPropertiesSchema.js
+var OAuthRefreshTokenRequestPropertiesSchema = z.strictObject({
+  "refresh-token": z.string().describe("The property name for the refresh token.")
 });
 
 // pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthRefreshTokenEndpointSchema.js
 var OAuthRefreshTokenEndpointSchema = z.strictObject({
   endpoint: z.string().describe("The endpoint to refresh the access token, such as 'auth.refresh_token')"),
-  "request-properties": OAuthRefreshTokenPropertiesSchema,
-  "response-properties": OAuthAccessTokenPropertiesSchema
+  "request-properties": OAuthRefreshTokenRequestPropertiesSchema.optional(),
+  "response-properties": OAuthAccessTokenResponsePropertiesSchema.optional()
 });
 
 // pnp:/home/circleci/project/packages/cli/yaml/yaml-schema/lib/schemas/OAuthClientCredentialsSchema.js
@@ -990860,7 +990877,8 @@ function getSchemaFromFernType({ fernType, nameOverride, generatedName, descript
       generatedName,
       value: itemType,
       description,
-      groupName
+      groupName,
+      example: void 0
     }) : void 0,
     optional: (itemType) => itemType != null ? SchemaWithExample.optional({
       nameOverride,
@@ -990874,7 +990892,8 @@ function getSchemaFromFernType({ fernType, nameOverride, generatedName, descript
       generatedName,
       value: itemType,
       description,
-      groupName
+      groupName,
+      example: void 0
     }) : void 0,
     literal: (literal2) => SchemaWithExample.literal({
       nameOverride,
@@ -990986,7 +991005,7 @@ function wrapMap({ nameOverride, generatedName, keySchema, valueSchema, wrapAsNu
 }
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/schema/convertArray.js
-function convertArray({ nameOverride, generatedName, breadcrumbs, item, description, wrapAsNullable, context, groupName }) {
+function convertArray({ nameOverride, generatedName, breadcrumbs, item, description, wrapAsNullable, context, groupName, example }) {
   const itemSchema = item == null ? SchemaWithExample.unknown({
     nameOverride,
     generatedName,
@@ -991000,10 +991019,11 @@ function convertArray({ nameOverride, generatedName, breadcrumbs, item, descript
     groupName,
     itemSchema,
     wrapAsNullable,
-    description
+    description,
+    example
   });
 }
-function wrapArray({ nameOverride, generatedName, itemSchema, wrapAsNullable, description, groupName }) {
+function wrapArray({ nameOverride, generatedName, itemSchema, wrapAsNullable, description, groupName, example }) {
   if (wrapAsNullable) {
     return SchemaWithExample.nullable({
       nameOverride,
@@ -991013,7 +991033,8 @@ function wrapArray({ nameOverride, generatedName, itemSchema, wrapAsNullable, de
         generatedName,
         value: itemSchema,
         description,
-        groupName
+        groupName,
+        example
       }),
       description,
       groupName
@@ -991024,7 +991045,8 @@ function wrapArray({ nameOverride, generatedName, itemSchema, wrapAsNullable, de
     generatedName,
     value: itemSchema,
     description,
-    groupName
+    groupName,
+    example
   });
 }
 
@@ -992099,6 +992121,12 @@ function getExamplesString(schema2) {
   }
   return void 0;
 }
+function getExampleAsArray(schema2) {
+  if (schema2.example != null && Array.isArray(schema2.example)) {
+    return schema2.example;
+  }
+  return void 0;
+}
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/schema/convertSchemas.js
 var SCHEMA_REFERENCE_PREFIX = "#/components/schemas/";
@@ -992365,7 +992393,8 @@ function convertSchemaObject(schema2, wrapAsNullable, context, breadcrumbs, prop
       description,
       wrapAsNullable,
       context,
-      groupName
+      groupName,
+      example: getExampleAsArray(schema2)
     });
   }
   if (schema2.additionalProperties != null && schema2.additionalProperties !== false && hasNoProperties(schema2)) {
@@ -992760,7 +992789,7 @@ function getPossibleDiscriminantsForSchemaObject({ schema: schema2, context }) {
   }
   for (const [propertyName, propertySchema] of Object.entries(schema2.properties ?? {})) {
     const resolvedPropertySchema = isReferenceObject(propertySchema) ? context.resolveSchemaReference(propertySchema) : propertySchema;
-    if (resolvedPropertySchema.type === "string" && resolvedPropertySchema.enum != null && isListOfStrings(resolvedPropertySchema.enum) && resolvedPropertySchema.enum.length === 1 && resolvedPropertySchema.enum[0] != null) {
+    if (resolvedPropertySchema.type === "string" && resolvedPropertySchema.enum != null && isListOfStrings(resolvedPropertySchema.enum) && getEnumSet(resolvedPropertySchema.enum).length === 1 && resolvedPropertySchema.enum[0] != null) {
       possibleDiscrimimants[propertyName] = resolvedPropertySchema.enum[0];
     }
     const maybeConstValue = getProperty(resolvedPropertySchema, "const");
@@ -992773,6 +992802,20 @@ function getPossibleDiscriminantsForSchemaObject({ schema: schema2, context }) {
   }
   return possibleDiscrimimants;
 }
+function getEnumSet(enums) {
+  if (!enums) {
+    return [];
+  }
+  const set7 = /* @__PURE__ */ new Set();
+  enums.forEach((item) => {
+    if (typeof item === "string") {
+      set7.add(item.toLowerCase());
+    } else {
+      set7.add(item);
+    }
+  });
+  return Array.from(set7);
+}
 function getProperty(object4, property5) {
   const extensionValue = object4[property5];
   if (extensionValue != null) {
@@ -993111,6 +993154,20 @@ var ExampleTypeFactory = class {
               itemExamples.push(itemExample);
             }
           }
+        } else if (schema2.example != null && schema2.example.length > 0) {
+          for (const item of schema2.example) {
+            const itemExample = this.buildExampleHelper({
+              exampleId,
+              example: item,
+              schema: schema2.value,
+              depth: depth + 1,
+              visitedSchemaIds,
+              options: options2
+            });
+            if (itemExample != null) {
+              itemExamples.push(itemExample);
+            }
+          }
         } else {
           const itemExample = this.buildExampleHelper({
             exampleId,
@@ -993529,7 +993586,8 @@ function convertSchemaToSchemaWithExample(schema2) {
         value: convertSchemaToSchemaWithExample(schema2.value),
         generatedName: schema2.generatedName,
         nameOverride: schema2.nameOverride,
-        groupName: schema2.groupName
+        groupName: schema2.groupName,
+        example: void 0
       });
     case "enum":
       return SchemaWithExample.enum({
@@ -1002526,10 +1002584,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.26.4" == null) {
+    if ("0.26.6" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.26.4";
+    return "0.26.6";
   }
   getCliName() {
     if ("fern" == null) {
@@ -1007044,43 +1007102,107 @@ async function convertOAuthClientCredentials({ propertyResolver, endpointResolve
 }
 
 // pnp:/home/circleci/project/packages/cli/generation/ir-generator/lib/converters/convertOAuthUtils.js
+var DEFAULT_TOKEN_ENDPOINT = {
+  requestProperties: {
+    type: "access_token",
+    client_id: ["client_id"],
+    client_secret: ["client_secret"],
+    scopes: void 0
+  },
+  responseProperties: {
+    type: "access_token",
+    access_token: ["access_token"],
+    expires_in: void 0,
+    refresh_token: void 0
+  }
+};
+var DEFAULT_REFRESH_TOKEN_ENDPOINT = {
+  requestProperties: {
+    type: "refresh_token",
+    refresh_token: ["refresh_token"]
+  },
+  responseProperties: {
+    type: "access_token",
+    access_token: ["access_token"],
+    refresh_token: void 0,
+    expires_in: void 0
+  }
+};
 function getTokenEndpoint(oauthSchema) {
-  const maybeExpiresIn = oauthSchema["get-token"]["response-properties"]["expires-in"];
-  const maybeRefreshToken = oauthSchema["get-token"]["response-properties"]["refresh-token"];
+  var _a5, _b4;
   return {
     endpoint: oauthSchema["get-token"].endpoint,
-    requestProperties: {
-      type: "access_token",
-      client_id: ["client_id"],
-      client_secret: ["client_secret"],
-      scopes: void 0
-    },
-    responseProperties: {
-      type: "access_token",
-      access_token: getResponsePropertyComponents(oauthSchema["get-token"]["response-properties"]["access-token"]),
-      expires_in: maybeExpiresIn != null ? getResponsePropertyComponents(maybeExpiresIn) : void 0,
-      refresh_token: maybeRefreshToken != null ? getResponsePropertyComponents(maybeRefreshToken) : void 0
-    }
+    requestProperties: getTokenEndpointRequestProperties({
+      requestProperties: (_a5 = oauthSchema["get-token"]) == null ? void 0 : _a5["request-properties"]
+    }),
+    responseProperties: getTokenEndpointResponseProperties({
+      responseProperties: (_b4 = oauthSchema["get-token"]) == null ? void 0 : _b4["response-properties"]
+    })
   };
 }
 function getRefreshTokenEndpoint(oauthSchema) {
+  var _a5, _b4;
   if (oauthSchema["refresh-token"] == null) {
     return void 0;
   }
-  const maybeExpiresIn = oauthSchema["get-token"]["response-properties"]["expires-in"];
-  const maybeRefreshToken = oauthSchema["get-token"]["response-properties"]["refresh-token"];
   return {
     endpoint: oauthSchema["refresh-token"].endpoint,
-    requestProperties: {
-      type: "refresh_token",
-      refresh_token: getRequestPropertyComponents(oauthSchema["refresh-token"]["request-properties"]["refresh-token"])
-    },
-    responseProperties: {
-      type: "access_token",
-      access_token: getResponsePropertyComponents(oauthSchema["get-token"]["response-properties"]["access-token"]),
-      expires_in: maybeExpiresIn != null ? getResponsePropertyComponents(maybeExpiresIn) : void 0,
-      refresh_token: maybeRefreshToken != null ? getResponsePropertyComponents(maybeRefreshToken) : void 0
-    }
+    requestProperties: getRefreshTokenEndpointRequestProperties({
+      requestProperties: (_a5 = oauthSchema["refresh-token"]) == null ? void 0 : _a5["request-properties"]
+    }),
+    responseProperties: getRefreshTokenEndpointResponseProperties({
+      responseProperties: (_b4 = oauthSchema["refresh-token"]) == null ? void 0 : _b4["response-properties"]
+    })
+  };
+}
+function getTokenEndpointRequestProperties({ requestProperties }) {
+  if (requestProperties == null) {
+    return DEFAULT_TOKEN_ENDPOINT.requestProperties;
+  }
+  const maybeClientId = requestProperties["client-id"];
+  const maybeClientSecret = requestProperties["client-secret"];
+  const maybeScopes = requestProperties.scopes;
+  return {
+    type: "access_token",
+    client_id: maybeClientId != null ? getRequestPropertyComponents(maybeClientId) : DEFAULT_TOKEN_ENDPOINT.requestProperties.client_id,
+    client_secret: maybeClientSecret != null ? getRequestPropertyComponents(maybeClientSecret) : DEFAULT_TOKEN_ENDPOINT.requestProperties.client_secret,
+    scopes: maybeScopes != null ? getRequestPropertyComponents(maybeScopes) : DEFAULT_TOKEN_ENDPOINT.requestProperties.scopes
+  };
+}
+function getTokenEndpointResponseProperties({ responseProperties }) {
+  return getTokenEndpointResponsePropertiesWithDefault({
+    responseProperties,
+    defaultValue: DEFAULT_TOKEN_ENDPOINT.responseProperties
+  });
+}
+function getRefreshTokenEndpointRequestProperties({ requestProperties }) {
+  if (requestProperties == null) {
+    return DEFAULT_REFRESH_TOKEN_ENDPOINT.requestProperties;
+  }
+  const maybeRefreshToken = requestProperties["refresh-token"];
+  return {
+    type: "refresh_token",
+    refresh_token: maybeRefreshToken != null ? getRequestPropertyComponents(maybeRefreshToken) : DEFAULT_REFRESH_TOKEN_ENDPOINT.requestProperties.refresh_token
+  };
+}
+function getRefreshTokenEndpointResponseProperties({ responseProperties }) {
+  return getTokenEndpointResponsePropertiesWithDefault({
+    responseProperties,
+    defaultValue: DEFAULT_REFRESH_TOKEN_ENDPOINT.responseProperties
+  });
+}
+function getTokenEndpointResponsePropertiesWithDefault({ responseProperties, defaultValue }) {
+  if (responseProperties == null) {
+    return defaultValue;
+  }
+  const maybeAccessToken = responseProperties["access-token"];
+  const maybeExpiresIn = responseProperties["expires-in"];
+  const maybeRefreshToken = responseProperties["refresh-token"];
+  return {
+    type: "access_token",
+    access_token: maybeAccessToken != null ? getResponsePropertyComponents(maybeAccessToken) : defaultValue.access_token,
+    expires_in: maybeExpiresIn != null ? getResponsePropertyComponents(maybeExpiresIn) : defaultValue.expires_in,
+    refresh_token: maybeRefreshToken != null ? getResponsePropertyComponents(maybeRefreshToken) : defaultValue.refresh_token
   };
 }
 
@@ -1012785,6 +1012907,21 @@ var ValidNavigationRule = {
   }
 };
 
+// pnp:/home/circleci/project/.yarn/cache/terminal-link-npm-3.0.0-82cbbd7f4a-85a78ae50a.zip/node_modules/terminal-link/index.js
+var import_supports_hyperlinks = __toESM(require_supports_hyperlinks());
+function terminalLink(text8, url, { target = "stdout", ...options2 } = {}) {
+  if (!import_supports_hyperlinks.default[target]) {
+    if (options2.fallback === false) {
+      return text8;
+    }
+    return typeof options2.fallback === "function" ? options2.fallback(text8, url) : `${text8} (\u200B${url}\u200B)`;
+  }
+  return ansi_escapes_default.link(text8, url);
+}
+terminalLink.isSupported = import_supports_hyperlinks.default.stdout;
+terminalLink.stderr = (text8, url, options2 = {}) => terminalLink(text8, url, { target: "stderr", ...options2 });
+terminalLink.stderr.isSupported = import_supports_hyperlinks.default.stderr;
+
 // pnp:/home/circleci/project/packages/cli/yaml/validator/lib/utils/propertyValidatorUtils.js
 var REQUEST_PREFIX2 = "$request.";
 var RESPONSE_PREFIX = "$response.";
@@ -1012813,6 +1012950,15 @@ function requestTypeHasProperty({ typeResolver, file, endpoint, propertyComponen
   });
 }
 function inlinedRequestTypeHasProperty({ typeResolver, file, requestType, propertyComponents, validate: validate3 }) {
+  if (isQueryParameterProperty({
+    typeResolver,
+    file,
+    requestType,
+    propertyComponents,
+    validate: validate3
+  })) {
+    return true;
+  }
   if (requestType.body == null) {
     return false;
   }
@@ -1012848,9 +1012994,25 @@ function inlinedRequestTypeHasProperty({ typeResolver, file, requestType, proper
     validate: validate3
   });
 }
+function isQueryParameterProperty({ typeResolver, file, requestType, propertyComponents, validate: validate3 }) {
+  if (propertyComponents.length !== 1 || typeof requestType === "string" || requestType["query-parameters"] == null) {
+    return false;
+  }
+  const queryParameter = requestType["query-parameters"][propertyComponents[0] ?? ""];
+  if (queryParameter == null) {
+    return false;
+  }
+  const resolvedQueryParameterType = typeResolver.resolveType({
+    type: typeof queryParameter !== "string" ? queryParameter.type : queryParameter,
+    file
+  });
+  return validate3({
+    resolvedType: resolvedQueryParameterType
+  });
+}
 function resolvedTypeHasProperty2({ typeResolver, file, resolvedType, propertyComponents, validate: validate3 }) {
   if (propertyComponents.length === 0) {
-    return validate3(resolvedType);
+    return validate3({ resolvedType });
   }
   const objectSchema = maybeObjectSchema2(resolvedType);
   if (objectSchema == null) {
@@ -1012993,29 +1013155,61 @@ function trimPrefix(value, prefix) {
 }
 
 // pnp:/home/circleci/project/packages/cli/yaml/validator/lib/rules/valid-oauth/validateUtils.js
-function validateRefreshTokenRequestProperty({ endpointId, endpoint, typeResolver, file, refreshTokenProperty }) {
-  const violations = [];
-  const refreshTokenPropertyComponents = getRequestPropertyComponents2(refreshTokenProperty);
-  if (refreshTokenPropertyComponents == null) {
-    violations.push({
-      severity: "error",
-      message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} must define a dot-delimited 'refresh-token' property starting with $request (e.g. $request.refresh_token).`
-    });
-    return violations;
-  }
-  if (!requestTypeHasProperty({
+var DEFAULT_CLIENT_ID = `${REQUEST_PREFIX2}client_id`;
+var DEFAULT_CLIENT_SECRET = `${REQUEST_PREFIX2}client_secret`;
+var DEFAULT_ACCESS_TOKEN = `${RESPONSE_PREFIX}access_token`;
+var DEFAULT_REFRESH_TOKEN = `${REQUEST_PREFIX2}refresh_token`;
+function validateClientIdRequestProperty({ endpointId, endpoint, typeResolver, file, clientIdProperty }) {
+  return validateRequestProperty({
+    endpointId,
+    endpoint,
     typeResolver,
     file,
+    requestProperty: clientIdProperty,
+    propertyValidator: {
+      propertyID: "client-id",
+      validate: isStringType
+    }
+  });
+}
+function validateClientSecretRequestProperty({ endpointId, endpoint, typeResolver, file, clientSecretProperty }) {
+  return validateRequestProperty({
+    endpointId,
     endpoint,
-    propertyComponents: refreshTokenPropertyComponents,
-    validate: isValidTokenType
-  })) {
-    violations.push({
-      severity: "error",
-      message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} specifies 'refresh-token' ${refreshTokenProperty}, which is not a valid 'refresh-token' type.`
-    });
-  }
-  return violations;
+    typeResolver,
+    file,
+    requestProperty: clientSecretProperty,
+    propertyValidator: {
+      propertyID: "client-secret",
+      validate: isStringType
+    }
+  });
+}
+function validateScopesRequestProperty({ endpointId, endpoint, typeResolver, file, scopesProperty }) {
+  return validateRequestProperty({
+    endpointId,
+    endpoint,
+    typeResolver,
+    file,
+    requestProperty: scopesProperty,
+    propertyValidator: {
+      propertyID: "scopes",
+      validate: isStringType
+    }
+  });
+}
+function validateRefreshTokenRequestProperty({ endpointId, endpoint, typeResolver, file, refreshTokenProperty }) {
+  return validateRequestProperty({
+    endpointId,
+    endpoint,
+    typeResolver,
+    file,
+    requestProperty: refreshTokenProperty,
+    propertyValidator: {
+      propertyID: "refresh-token",
+      validate: isStringType
+    }
+  });
 }
 function validateAccessTokenResponseProperty({ endpointId, typeResolver, file, resolvedResponseType, accessTokenProperty }) {
   return validateResponseProperty({
@@ -1013062,31 +1013256,48 @@ function isValidExpiresInProperty({ typeResolver, file, resolvedType, propertyCo
     file,
     resolvedType,
     propertyComponents,
-    validate: isValidExpiryType
+    validate: isIntegerType
   });
 }
-function isValidExpiryType(resolvedType) {
-  const primitiveType = maybePrimitiveType(resolvedType);
-  if (primitiveType == null) {
-    return false;
-  }
-  return primitiveType === "INTEGER";
-}
 function isValidTokenProperty({ typeResolver, file, resolvedType, propertyComponents }) {
   return resolvedTypeHasProperty2({
     typeResolver,
     file,
     resolvedType,
     propertyComponents,
-    validate: isValidTokenType
+    validate: isStringType
   });
 }
-function isValidTokenType(resolvedType) {
-  const primitiveType = maybePrimitiveType(resolvedType);
-  if (primitiveType == null) {
-    return false;
+function validateRequestProperty({ endpointId, endpoint, typeResolver, file, requestProperty, propertyValidator }) {
+  const violations = [];
+  const requestPropertyComponents = getRequestPropertyComponents2(requestProperty);
+  if (requestPropertyComponents == null) {
+    violations.push({
+      severity: "error",
+      message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} must define a dot-delimited '${propertyValidator.propertyID}' property starting with $request (e.g. $request.${propertyValidator.propertyID}).`
+    });
+    return violations;
   }
-  return primitiveType === "STRING";
+  if (requestPropertyComponents.length > 1) {
+    violations.push({
+      severity: "error",
+      message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} cannot reference nested $request properties like '${requestProperty}'; expected '$request.${propertyValidator.propertyID}' instead.`
+    });
+    return violations;
+  }
+  if (!requestTypeHasProperty({
+    typeResolver,
+    file,
+    endpoint,
+    propertyComponents: requestPropertyComponents,
+    validate: propertyValidator.validate
+  })) {
+    violations.push({
+      severity: "error",
+      message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} specifies '${propertyValidator.propertyID}' ${requestProperty}, which is not a valid '${propertyValidator.propertyID}' type.`
+    });
+  }
+  return violations;
 }
 function validateResponseProperty({ endpointId, typeResolver, file, resolvedResponseType, responseProperty, propertyValidator }) {
   const violations = [];
@@ -1013110,17 +1013321,41 @@ function validateResponseProperty({ endpointId, typeResolver, file, resolvedResp
   }
   return violations;
 }
+function isIntegerType({ resolvedType }) {
+  return maybePrimitiveType(resolvedType) === "INTEGER";
+}
+function isStringType({ resolvedType }) {
+  return maybePrimitiveType(resolvedType) === "STRING";
+}
 
 // pnp:/home/circleci/project/packages/cli/yaml/validator/lib/rules/valid-oauth/validateRefreshTokenEndpoint.js
 function validateRefreshTokenEndpoint({ endpointId, endpoint, typeResolver, file, refreshEndpoint }) {
+  var _a5, _b4, _c4, _d2;
   const violations = [];
-  violations.push(...validateRefreshTokenRequestProperty({
-    endpointId,
-    endpoint,
-    typeResolver,
-    file,
-    refreshTokenProperty: refreshEndpoint["request-properties"]["refresh-token"]
-  }));
+  const maybeRefreshToken = (_a5 = refreshEndpoint["request-properties"]) == null ? void 0 : _a5["refresh-token"];
+  if (maybeRefreshToken != null) {
+    violations.push(...validateRefreshTokenRequestProperty({
+      endpointId,
+      endpoint,
+      typeResolver,
+      file,
+      refreshTokenProperty: maybeRefreshToken
+    }));
+  } else {
+    const refreshTokenViolations = validateRefreshTokenRequestProperty({
+      endpointId,
+      endpoint,
+      typeResolver,
+      file,
+      refreshTokenProperty: DEFAULT_REFRESH_TOKEN
+    });
+    if (refreshTokenViolations.length > 0) {
+      violations.push({
+        severity: "error",
+        message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} is missing a valid refresh-token, such as '${DEFAULT_REFRESH_TOKEN}'.`
+      });
+    }
+  }
   const resolvedResponseType = resolveResponseType({ endpoint, typeResolver, file });
   if (resolvedResponseType == null) {
     violations.push({
@@ -1013129,17 +1013364,31 @@ function validateRefreshTokenEndpoint({ endpointId, endpoint, typeResolver, file
     });
     return violations;
   }
-  const accessTokenProperty = refreshEndpoint["response-properties"]["access-token"];
-  if (accessTokenProperty != null) {
+  const maybeAccessToken = (_b4 = refreshEndpoint["response-properties"]) == null ? void 0 : _b4["access-token"];
+  if (maybeAccessToken != null) {
     violations.push(...validateAccessTokenResponseProperty({
       endpointId,
       typeResolver,
-      file: maybeFileFromResolvedType2(resolvedResponseType) ?? file,
+      file,
       resolvedResponseType,
-      accessTokenProperty
+      accessTokenProperty: maybeAccessToken
     }));
+  } else {
+    const accessTokenViolations = validateAccessTokenResponseProperty({
+      endpointId,
+      typeResolver,
+      file,
+      resolvedResponseType,
+      accessTokenProperty: DEFAULT_ACCESS_TOKEN
+    });
+    if (accessTokenViolations.length > 0) {
+      violations.push({
+        severity: "error",
+        message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} is missing a valid access-token, such as '${DEFAULT_ACCESS_TOKEN}'.`
+      });
+    }
   }
-  const expiresInProperty = refreshEndpoint["response-properties"]["expires-in"];
+  const expiresInProperty = (_c4 = refreshEndpoint == null ? void 0 : refreshEndpoint["response-properties"]) == null ? void 0 : _c4["expires-in"];
   if (expiresInProperty != null) {
     violations.push(...validateExpiresInResponseProperty({
       endpointId,
@@ -1013149,7 +1013398,7 @@ function validateRefreshTokenEndpoint({ endpointId, endpoint, typeResolver, file
       expiresInProperty
     }));
   }
-  const refreshTokenProperty = refreshEndpoint["response-properties"]["refresh-token"];
+  const refreshTokenProperty = (_d2 = refreshEndpoint == null ? void 0 : refreshEndpoint["response-properties"]) == null ? void 0 : _d2["refresh-token"];
   if (refreshTokenProperty != null) {
     violations.push(...validateRefreshTokenResponseProperty({
       endpointId,
@@ -1013164,7 +1013413,66 @@ function validateRefreshTokenEndpoint({ endpointId, endpoint, typeResolver, file
 
 // pnp:/home/circleci/project/packages/cli/yaml/validator/lib/rules/valid-oauth/validateTokenEndpoint.js
 function validateTokenEndpoint({ endpointId, endpoint, typeResolver, file, tokenEndpoint }) {
+  var _a5, _b4, _c4, _d2, _e, _f;
   const violations = [];
+  const maybeClientId = (_a5 = tokenEndpoint["request-properties"]) == null ? void 0 : _a5["client-id"];
+  if (maybeClientId != null) {
+    violations.push(...validateClientIdRequestProperty({
+      endpointId,
+      endpoint,
+      typeResolver,
+      file,
+      clientIdProperty: maybeClientId
+    }));
+  } else {
+    const clientIdViolations = validateClientIdRequestProperty({
+      endpointId,
+      endpoint,
+      typeResolver,
+      file,
+      clientIdProperty: DEFAULT_CLIENT_ID
+    });
+    if (clientIdViolations.length > 0) {
+      violations.push({
+        severity: "error",
+        message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} is missing a valid client-id, such as '${DEFAULT_CLIENT_ID}'.`
+      });
+    }
+  }
+  const maybeClientSecret = (_b4 = tokenEndpoint["request-properties"]) == null ? void 0 : _b4["client-secret"];
+  if (maybeClientSecret != null) {
+    violations.push(...validateClientSecretRequestProperty({
+      endpointId,
+      endpoint,
+      typeResolver,
+      file,
+      clientSecretProperty: maybeClientSecret
+    }));
+  } else {
+    const clientSecretViolations = validateClientSecretRequestProperty({
+      endpointId,
+      endpoint,
+      typeResolver,
+      file,
+      clientSecretProperty: DEFAULT_CLIENT_SECRET
+    });
+    if (clientSecretViolations.length > 0) {
+      violations.push({
+        severity: "error",
+        message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} is missing a valid client-secret, such as '${DEFAULT_CLIENT_SECRET}'.`
+      });
+    }
+  }
+  const scopesProperty = (_c4 = tokenEndpoint == null ? void 0 : tokenEndpoint["request-properties"]) == null ? void 0 : _c4.scopes;
+  if (scopesProperty != null) {
+    violations.push(...validateScopesRequestProperty({
+      endpointId,
+      endpoint,
+      typeResolver,
+      file,
+      scopesProperty
+    }));
+  }
   const resolvedResponseType = resolveResponseType({ endpoint, typeResolver, file });
   if (resolvedResponseType == null) {
     violations.push({
@@ -1013173,14 +1013481,31 @@ function validateTokenEndpoint({ endpointId, endpoint, typeResolver, file, token
     });
     return violations;
   }
-  violations.push(...validateAccessTokenResponseProperty({
-    endpointId,
-    typeResolver,
-    file: maybeFileFromResolvedType2(resolvedResponseType) ?? file,
-    resolvedResponseType,
-    accessTokenProperty: tokenEndpoint["response-properties"]["access-token"]
-  }));
-  const expiresInProperty = tokenEndpoint["response-properties"]["expires-in"];
+  const maybeAccessToken = (_d2 = tokenEndpoint["response-properties"]) == null ? void 0 : _d2["access-token"];
+  if (maybeAccessToken != null) {
+    violations.push(...validateAccessTokenResponseProperty({
+      endpointId,
+      typeResolver,
+      file,
+      resolvedResponseType,
+      accessTokenProperty: maybeAccessToken
+    }));
+  } else {
+    const accessTokenViolations = validateAccessTokenResponseProperty({
+      endpointId,
+      typeResolver,
+      file,
+      resolvedResponseType,
+      accessTokenProperty: DEFAULT_ACCESS_TOKEN
+    });
+    if (accessTokenViolations.length > 0) {
+      violations.push({
+        severity: "error",
+        message: `OAuth configuration for endpoint ${source_default.bold(endpointId)} is missing a valid access-token, such as '${DEFAULT_ACCESS_TOKEN}'.`
+      });
+    }
+  }
+  const expiresInProperty = (_e = tokenEndpoint == null ? void 0 : tokenEndpoint["response-properties"]) == null ? void 0 : _e["expires-in"];
   if (expiresInProperty != null) {
     violations.push(...validateExpiresInResponseProperty({
       endpointId,
@@ -1013190,7 +1013515,7 @@ function validateTokenEndpoint({ endpointId, endpoint, typeResolver, file, token
       expiresInProperty
     }));
   }
-  const refreshTokenProperty = tokenEndpoint["response-properties"]["refresh-token"];
+  const refreshTokenProperty = (_f = tokenEndpoint == null ? void 0 : tokenEndpoint["response-properties"]) == null ? void 0 : _f["refresh-token"];
   if (refreshTokenProperty != null) {
     violations.push(...validateRefreshTokenResponseProperty({
       endpointId,
@@ -1013228,6 +1013553,9 @@ function validateClientCredentials({ endpointId, endpoint, typeResolver, file, r
 }
 
 // pnp:/home/circleci/project/packages/cli/yaml/validator/lib/rules/valid-oauth/valid-oauth.js
+var DOCS_LINK_MESSAGE = `For details, see the ${terminalLink("docs", DocsLinks.oauth, {
+  fallback: (text8, url) => `${text8}: ${url}`
+})}.`;
 var ValidOauthRule = {
   name: "valid-oauth",
   create: ({ workspace }) => {
@@ -1013246,7 +1013574,7 @@ var ValidOauthRule = {
             return [
               {
                 severity: "error",
-                message: `File declares oauth scheme '${oauthScheme.name}', but no imports are declared to reference the required token endpoint(s).`
+                message: `File declares oauth scheme '${oauthScheme.name}', but no imports are declared to reference the required token endpoint(s). ${DOCS_LINK_MESSAGE}`
               }
             ];
           }
@@ -1013268,7 +1013596,7 @@ var ValidOauthRule = {
             return [
               {
                 severity: "error",
-                message: `File declares oauth scheme '${oauthScheme.name}', but the OAuth 'get-token' endpoint could not be resolved.`
+                message: `File declares oauth scheme '${oauthScheme.name}', but the OAuth 'get-token' endpoint could not be resolved. ${DOCS_LINK_MESSAGE}`
               }
             ];
           }
@@ -1013286,7 +1013614,7 @@ var ValidOauthRule = {
             return [
               {
                 severity: "error",
-                message: `File declares oauth scheme '${oauthScheme.name}', but the OAuth 'refresh-token' endpoint could not be resolved.`
+                message: `File declares oauth scheme '${oauthScheme.name}', but the OAuth 'refresh-token' endpoint could not be resolved. ${DOCS_LINK_MESSAGE}`
               }
             ];
           }
@@ -1013306,8 +1013634,8 @@ var ValidOauthRule = {
             rootApiFile: workspace.definition.rootApiFile.contents
           });
           switch (oauthSchema.type) {
-            case "client-credentials":
-              return validateClientCredentials({
+            case "client-credentials": {
+              const violations = validateClientCredentials({
                 endpointId,
                 endpoint,
                 typeResolver,
@@ -1013316,6 +1013644,14 @@ var ValidOauthRule = {
                 resolvedRefreshEndpoint,
                 clientCredentials: oauthSchema
               });
+              if (violations.length > 0) {
+                return violations.map((violation) => ({
+                  severity: violation.severity,
+                  message: violation.message + ` ${DOCS_LINK_MESSAGE}`
+                }));
+              }
+              return [];
+            }
             default:
               assertNever(oauthSchema.type);
           }
@@ -1013440,7 +1013776,7 @@ function isValidResultsProperty({ typeResolver, file, resolvedType, propertyComp
     validate: isValidResultsType
   });
 }
-function isValidResultsType(resolvedType) {
+function isValidResultsType({ resolvedType }) {
   return true;
 }
 
@@ -1013513,7 +1013849,7 @@ function isValidCursorProperty({ typeResolver, file, resolvedType, propertyCompo
     validate: isValidCursorType
   });
 }
-function isValidCursorType(resolvedType) {
+function isValidCursorType({ resolvedType }) {
   const primitiveType = maybePrimitiveType(resolvedType);
   if (primitiveType == null) {
     return false;
@@ -1013570,7 +1013906,7 @@ function isValidOffsetProperty({ typeResolver, file, resolvedType, propertyCompo
     validate: isValidOffsetType
   });
 }
-function isValidOffsetType(resolvedType) {
+function isValidOffsetType({ resolvedType }) {
   const primitiveType = maybePrimitiveType(resolvedType);
   if (primitiveType == null) {
     return false;
@@ -1019206,24 +1019542,29 @@ function convertExampleEndpoint({ example }) {
 function convertExampleResponse5({ example }) {
   switch (example.type) {
     case "ok":
-      switch (example.value.type) {
-        case "body":
-          return IrVersions_exports.V43.ExampleResponse.ok({ body: example.value.value });
-        case "sse":
-          return IrVersions_exports.V43.ExampleResponse.ok({
-            body: void 0
-          });
-        case "stream":
-          return IrVersions_exports.V43.ExampleResponse.ok({
-            body: void 0
-          });
-      }
+      return convertExampleSuccessResponse({ example: example.value });
     case "error":
       return IrVersions_exports.V43.ExampleResponse.error(example);
     default:
       assertNever(example);
   }
 }
+function convertExampleSuccessResponse({ example }) {
+  switch (example.type) {
+    case "body":
+      return IrVersions_exports.V43.ExampleResponse.ok({ body: example.value });
+    case "sse":
+      return IrVersions_exports.V43.ExampleResponse.ok({
+        body: void 0
+      });
+    case "stream":
+      return IrVersions_exports.V43.ExampleResponse.ok({
+        body: void 0
+      });
+    default:
+      assertNever(example);
+  }
+}
 
 // pnp:/home/circleci/project/packages/cli/generation/ir-migrations/lib/migrations/v5-to-v4/convertName.js
 function convertNameToV1(name2) {
@@ -1021796,23 +1022137,6 @@ var import_fs8 = require("fs");
 var import_promises41 = require("fs/promises");
 var import_path35 = __toESM(require("path"));
 var import_promises42 = require("stream/promises");
-
-// pnp:/home/circleci/project/.yarn/cache/terminal-link-npm-3.0.0-82cbbd7f4a-85a78ae50a.zip/node_modules/terminal-link/index.js
-var import_supports_hyperlinks = __toESM(require_supports_hyperlinks());
-function terminalLink(text8, url, { target = "stdout", ...options2 } = {}) {
-  if (!import_supports_hyperlinks.default[target]) {
-    if (options2.fallback === false) {
-      return text8;
-    }
-    return typeof options2.fallback === "function" ? options2.fallback(text8, url) : `${text8} (\u200B${url}\u200B)`;
-  }
-  return ansi_escapes_default.link(text8, url);
-}
-terminalLink.isSupported = import_supports_hyperlinks.default.stdout;
-terminalLink.stderr = (text8, url, options2 = {}) => terminalLink(text8, url, { target: "stderr", ...options2 });
-terminalLink.stderr.isSupported = import_supports_hyperlinks.default.stderr;
-
-// pnp:/home/circleci/project/packages/cli/generation/remote-generation/remote-workspace-runner/lib/RemoteTaskHandler.js
 var import_tmp_promise9 = __toESM(require_tmp_promise());
 var _isFinished, _createdSnippets, _snippetsS3PreSignedReadUrl;
 var RemoteTaskHandler = class {
@@ -1052878,7 +1053202,8 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain2
     token,
     uploadUrls,
     version: version3,
-    editThisPage
+    editThisPage,
+    absolutePathToFernFolder: docsWorkspace.absoluteFilepath
   });
   context.logger.debug("Calling registerDocs... ", JSON.stringify(registerDocsRequest, void 0, 4));
   const registerDocsResponse = await fdr.docs.v2.write.finishDocsRegister(docsRegistrationId, registerDocsRequest);
@@ -1052898,7 +1053223,7 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain2
     }
   }
 }
-async function constructRegisterDocsRequest({ parsedDocsConfig, organization, fernWorkspaces, context, token, uploadUrls, version: version3, editThisPage }) {
+async function constructRegisterDocsRequest({ parsedDocsConfig, organization, fernWorkspaces, context, token, uploadUrls, version: version3, editThisPage, absolutePathToFernFolder }) {
   const fullSlugs = Object.fromEntries(Object.entries(parsedDocsConfig.pages).map(([pageId, pageContent]) => {
     const frontmatter = (0, import_gray_matter2.default)(pageContent);
     const fullSlug = frontmatter.data.slug;
@@ -1052915,10 +1053240,11 @@ async function constructRegisterDocsRequest({ parsedDocsConfig, organization, fe
     token,
     uploadUrls,
     version: version3,
-    fullSlugs
+    fullSlugs,
+    absolutePathToFernFolder
   });
   let pages = {
-    ...entries(parsedDocsConfig.pages).reduce((pages2, [pageFilepath, pageContents]) => ({
+    ...entries({ ...parsedDocsConfig.pages }).reduce((pages2, [pageFilepath, pageContents]) => ({
       ...pages2,
       [pageFilepath]: {
         markdown: pageContents,
@@ -1052958,7 +1053284,7 @@ function createEditThisPageUrl(editThisPage, pageFilepath) {
   const { owner, repo, branch = "main", host = "https://github.com" } = editThisPage.github;
   return `${wrapWithHttps(host)}/${owner}/${repo}/blob/${branch}/fern/${pageFilepath}`;
 }
-async function convertDocsConfiguration({ parsedDocsConfig, organization, fernWorkspaces, context, token, uploadUrls, version: version3, fullSlugs }) {
+async function convertDocsConfiguration({ parsedDocsConfig, organization, fernWorkspaces, context, token, uploadUrls, version: version3, fullSlugs, absolutePathToFernFolder }) {
   var _a5, _b4;
   const convertedNavigation = await convertNavigationConfig({
     navigationConfig: parsedDocsConfig.navigation,
@@ -1052969,7 +1053295,8 @@ async function convertDocsConfiguration({ parsedDocsConfig, organization, fernWo
     context,
     token,
     version: version3,
-    fullSlugs
+    fullSlugs,
+    absolutePathToFernFolder
   });
   const config = {
     title: parsedDocsConfig.title,
@@ -1052999,12 +1053326,10 @@ async function convertDocsConfiguration({ parsedDocsConfig, organization, fernWo
   };
   return {
     config,
-    pages: {
-      ...convertedNavigation.pages
-    }
+    pages: convertedNavigation.pages
   };
 }
-async function convertNavigationConfig({ navigationConfig, tabs, parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs }) {
+async function convertNavigationConfig({ navigationConfig, tabs, parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs, absolutePathToFernFolder }) {
   let config;
   let pages = {};
   switch (navigationConfig.type) {
@@ -1053017,7 +1053342,8 @@ async function convertNavigationConfig({ navigationConfig, tabs, parsedDocsConfi
         context,
         token,
         version: version3,
-        fullSlugs
+        fullSlugs,
+        absolutePathToFernFolder
       })));
       for (const untabbedItem of untabbedItems) {
         pages = {
@@ -1053030,19 +1053356,23 @@ async function convertNavigationConfig({ navigationConfig, tabs, parsedDocsConfi
       };
       break;
     }
-    case "tabbed":
+    case "tabbed": {
+      const tabbedItem = await convertTabbedNavigation(navigationConfig.items, tabs, {
+        parsedDocsConfig,
+        organization,
+        fernWorkspaces,
+        context,
+        token,
+        version: version3,
+        fullSlugs,
+        absolutePathToFernFolder
+      });
       config = {
-        tabs: await convertTabbedNavigation(navigationConfig.items, tabs, {
-          parsedDocsConfig,
-          organization,
-          fernWorkspaces,
-          context,
-          token,
-          version: version3,
-          fullSlugs
-        })
+        tabs: tabbedItem.tabs
       };
+      pages = { ...pages, ...tabbedItem.pages };
       break;
+    }
     case "versioned":
       config = {
         versions: await Promise.all(navigationConfig.versions.map(async (version4) => {
@@ -1053055,7 +1053385,8 @@ async function convertNavigationConfig({ navigationConfig, tabs, parsedDocsConfi
             context,
             token,
             version: version4.version,
-            fullSlugs
+            fullSlugs,
+            absolutePathToFernFolder
           });
           pages = {
             ...pages,
@@ -1053092,7 +1053423,7 @@ function convertAvailability2(availability) {
       assertNever(availability);
   }
 }
-async function convertUnversionedNavigationConfig({ navigationConfig, tabs, parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs }) {
+async function convertUnversionedNavigationConfig({ navigationConfig, tabs, parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs, absolutePathToFernFolder }) {
   let config;
   let pages = {};
   switch (navigationConfig.type) {
@@ -1053105,7 +1053436,8 @@ async function convertUnversionedNavigationConfig({ navigationConfig, tabs, pars
         context,
         token,
         version: version3,
-        fullSlugs
+        fullSlugs,
+        absolutePathToFernFolder
       })));
       config = {
         items: untabbedItems.map((item) => item.item)
@@ -1053119,17 +1053451,20 @@ async function convertUnversionedNavigationConfig({ navigationConfig, tabs, pars
       break;
     }
     case "tabbed": {
+      const tabbedItem = await convertTabbedNavigation(navigationConfig.items, tabs, {
+        parsedDocsConfig,
+        organization,
+        fernWorkspaces,
+        context,
+        token,
+        version: version3,
+        fullSlugs,
+        absolutePathToFernFolder
+      });
       config = {
-        tabs: await convertTabbedNavigation(navigationConfig.items, tabs, {
-          parsedDocsConfig,
-          organization,
-          fernWorkspaces,
-          context,
-          token,
-          version: version3,
-          fullSlugs
-        })
+        tabs: tabbedItem.tabs
       };
+      pages = { ...pages, ...tabbedItem.pages };
       break;
     }
     default:
@@ -1053140,8 +1053475,9 @@ async function convertUnversionedNavigationConfig({ navigationConfig, tabs, pars
     pages
   };
 }
-function convertTabbedNavigation(items, tabs, { parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs }) {
-  return Promise.all(items.map(async (tabbedItem) => {
+async function convertTabbedNavigation(items, tabs, { parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs, absolutePathToFernFolder }) {
+  let pages = {};
+  const convertedTabs = await Promise.all(items.map(async (tabbedItem) => {
     const tabConfig = tabs == null ? void 0 : tabs[tabbedItem.tab];
     if (tabConfig == null) {
       throw new Error(`Couldn't find config for tab id ${tabbedItem.tab}`);
@@ -1053167,8 +1053503,15 @@ function convertTabbedNavigation(items, tabs, { parsedDocsConfig, organization,
       context,
       token,
       version: version3,
-      fullSlugs
+      fullSlugs,
+      absolutePathToFernFolder
     })));
+    tabbedItems.forEach((tabbedItem2) => {
+      pages = {
+        ...pages,
+        ...tabbedItem2.pages
+      };
+    });
     return {
       title: tabConfig.displayName,
       icon: tabConfig.icon,
@@ -1053176,6 +1053519,10 @@ function convertTabbedNavigation(items, tabs, { parsedDocsConfig, organization,
       urlSlugOverride: tabConfig.slug
     };
   }));
+  return {
+    tabs: convertedTabs,
+    pages
+  };
 }
 function convertDocsTypographyConfiguration({ typographyConfiguration, parsedDocsConfig, uploadUrls, context, fullSlugs }) {
   if (typographyConfiguration == null) {
@@ -1053334,7 +1053681,7 @@ function convertImageReference2({ imageReference: imageReference2, parsedDocsCon
   }
   return file.fileId;
 }
-async function convertNavigationItem2({ item, parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs }) {
+async function convertNavigationItem2({ item, parsedDocsConfig, organization, fernWorkspaces, context, token, version: version3, fullSlugs, absolutePathToFernFolder }) {
   var _a5, _b4;
   let convertedItem;
   let pages = {};
@@ -1053360,7 +1053707,8 @@ async function convertNavigationItem2({ item, parsedDocsConfig, organization, fe
         context,
         token,
         version: version3,
-        fullSlugs
+        fullSlugs,
+        absolutePathToFernFolder
       })));
       convertedItem = {
         type: "section",
@@ -1053400,8 +1053748,7 @@ async function convertNavigationItem2({ item, parsedDocsConfig, organization, fe
       const changelogItems = [];
       if (workspace.changelog != null) {
         for (const file of workspace.changelog.files) {
-          const splitFilepath = file.absoluteFilepath.split("/");
-          const filename = splitFilepath[splitFilepath.length - 1];
+          const filename = last_default(file.absoluteFilepath.split("/"));
           if (filename == null) {
             continue;
           }
@@ -1053409,12 +1053756,13 @@ async function convertNavigationItem2({ item, parsedDocsConfig, organization, fe
           if (changelogDate == null) {
             continue;
           }
-          pages[file.absoluteFilepath] = {
+          const relativePath = relative(absolutePathToFernFolder, file.absoluteFilepath);
+          pages[relativePath] = {
             markdown: file.contents
           };
           changelogItems.push({
             date: changelogDate.toISOString(),
-            pageId: file.absoluteFilepath
+            pageId: relativePath
           });
         }
       }