@fern-api/fern-api-dev 5.109.2 → 5.110.0

package/cli.cjs

@@ -34611,12 +34611,31 @@ var init_removeSuffix = __esm({
 });
 
 // ../../commons/core-utils/lib/replaceEnvVars.js
+function getDeferredEnvVars() {
+  const raw = process.env[DEFERRED_ENV_VARS_ENV_VAR];
+  if (raw == null) {
+    return /* @__PURE__ */ new Set();
+  }
+  return new Set(raw.split(/[,\s]+/).filter((name2) => /^\w+$/.test(name2)));
+}
+function deferredPlaceholder(name2, before, after) {
+  const placeholder = `${DEFERRED_PLACEHOLDER_PREFIX}${name2}`;
+  if (/:\/\/$/.test(before)) {
+    return placeholder;
+  }
+  const isUrl3 = URL_POSITION_REGEX.test(before) || before === "" && (after === "" || after.startsWith("/"));
+  return isUrl3 ? `https://${placeholder}` : placeholder;
+}
 function replaceEnvVariables(content5, context3, options2 = {}) {
   if (typeof content5 === "string") {
+    const deferred2 = getDeferredEnvVars();
     let transformed2 = content5.replace(ESCAPED_ENV_VAR_REGEX, (_substring, varName) => {
       return `${PLACEHOLDER_PREFIX}${varName}\0`;
     });
-    transformed2 = transformed2.replace(ENV_VAR_REGEX, (_substring, envVarName) => {
+    transformed2 = transformed2.replace(ENV_VAR_REGEX, (substring, envVarName, offset2, whole) => {
+      if (deferred2.has(envVarName)) {
+        return deferredPlaceholder(envVarName, whole.slice(0, offset2), whole.slice(offset2 + substring.length));
+      }
       if (options2.substituteAsEmpty) {
         return "";
       }
@@ -34638,7 +34657,7 @@ function replaceEnvVariables(content5, context3, options2 = {}) {
   const transformed = mapValues2(content5, (value2) => replaceEnvVariables(value2, context3, options2));
   return transformed;
 }
-var ENV_VAR_REGEX, ESCAPED_ENV_VAR_REGEX, PLACEHOLDER_PREFIX;
+var ENV_VAR_REGEX, ESCAPED_ENV_VAR_REGEX, PLACEHOLDER_PREFIX, DEFERRED_ENV_VARS_ENV_VAR, DEFERRED_PLACEHOLDER_PREFIX, URL_POSITION_REGEX;
 var init_replaceEnvVars = __esm({
   "../../commons/core-utils/lib/replaceEnvVars.js"() {
     "use strict";
@@ -34647,6 +34666,9 @@ var init_replaceEnvVars = __esm({
     ENV_VAR_REGEX = /\$\{(\w+)\}/g;
     ESCAPED_ENV_VAR_REGEX = /\\\$\\\{(\w+)\\}/g;
     PLACEHOLDER_PREFIX = "\0ESCAPED_ENV_VAR\0";
+    DEFERRED_ENV_VARS_ENV_VAR = "FERN_RUNTIME_ENV_VARS";
+    DEFERRED_PLACEHOLDER_PREFIX = "FERN_SELF_HOSTED_ENV_";
+    URL_POSITION_REGEX = /(\]\(|\b(?:href|src|url|action|content)\s*[=:]\s*["']?)$/i;
   }
 });
 
@@ -347311,6 +347333,9 @@ var init_ErrorCollector = __esm({
 });
 
 // ../api-importers/v3-importer-commons/lib/AbstractConverterContext.js
+function isMarkedDeprecated(node4) {
+  return "deprecated" in node4 && node4.deprecated === true;
+}
 var AbstractConverterContext;
 var init_AbstractConverterContext = __esm({
   "../api-importers/v3-importer-commons/lib/AbstractConverterContext.js"() {
@@ -347733,13 +347758,30 @@ var init_AbstractConverterContext = __esm({
         return converted.audiences;
       }
       getAvailability({ node: node4, breadcrumbs }) {
+        const visitedReferences = /* @__PURE__ */ new Set();
         while (this.isReferenceObject(node4)) {
+          const declared = this.getDeclaredAvailability({ node: node4, breadcrumbs });
+          if (declared != null) {
+            return declared;
+          }
+          if (visitedReferences.has(node4.$ref)) {
+            return void 0;
+          }
+          visitedReferences.add(node4.$ref);
           const resolved = this.resolveReference({ reference: node4 });
           if (!resolved.resolved) {
             return void 0;
           }
           node4 = resolved.value;
         }
+        return this.getDeclaredAvailability({ node: node4, breadcrumbs });
+      }
+      /**
+       * Reads the availability declared directly on a node, without resolving references.
+       * Annotations written alongside a `$ref` describe that particular usage, so callers
+       * consult them before falling back to the referenced schema.
+       */
+      getDeclaredAvailability({ node: node4, breadcrumbs }) {
         const availabilityExtension = new extensions_exports.FernAvailabilityExtension({
           node: node4,
           breadcrumbs,
@@ -347752,7 +347794,7 @@ var init_AbstractConverterContext = __esm({
             message: void 0
           };
         }
-        if (node4.deprecated === true) {
+        if (isMarkedDeprecated(node4)) {
           return {
             status: AvailabilityStatus.Deprecated,
             message: void 0
@@ -352364,7 +352406,11 @@ var init_SchemaOrReferenceConverter = __esm({
           if (response.ok) {
             return {
               type: this.wrapTypeReference(response.reference),
-              inlinedTypes: response.inlinedTypes ?? {}
+              inlinedTypes: response.inlinedTypes ?? {},
+              availability: this.context.getAvailability({
+                node: schemaOrReference,
+                breadcrumbs: this.breadcrumbs
+              })
             };
           }
         }
@@ -352384,7 +352430,8 @@ var init_SchemaOrReferenceConverter = __esm({
             if (response.ok) {
               return {
                 type: this.wrapTypeReference(response.reference),
-                inlinedTypes: response.inlinedTypes ?? {}
+                inlinedTypes: response.inlinedTypes ?? {},
+                availability: this.getAvailabilityOfSelfOrReference(allOfReference)
               };
             }
           }
@@ -352406,13 +352453,39 @@ var init_SchemaOrReferenceConverter = __esm({
             if (response.ok) {
               return {
                 type: this.wrapTypeReference(response.reference),
-                inlinedTypes: response.inlinedTypes ?? {}
+                inlinedTypes: response.inlinedTypes ?? {},
+                availability: this.getAvailabilityOfSelfOrReference(singleRef)
               };
             }
           }
         }
         return void 0;
       }
+      /**
+       * Availability declared alongside the `allOf` takes precedence over the availability
+       * of the referenced schema, since the outer schema is the more specific declaration.
+       * Inline `allOf` siblings are consulted next: when the sibling carries nothing but
+       * metadata we short-circuit to the `$ref`, so a `deprecated` written there would
+       * otherwise be dropped.
+       */
+      getAvailabilityOfSelfOrReference(reference4) {
+        for (const node4 of [...this.getSelfAndInlineAllOfElements(), reference4]) {
+          const availability = this.context.getAvailability({ node: node4, breadcrumbs: this.breadcrumbs });
+          if (availability != null) {
+            return availability;
+          }
+        }
+        return void 0;
+      }
+      getSelfAndInlineAllOfElements() {
+        if (this.context.isReferenceObject(this.schemaOrReference) || this.schemaOrReference.allOf == null) {
+          return [this.schemaOrReference];
+        }
+        return [
+          this.schemaOrReference,
+          ...this.schemaOrReference.allOf.filter((element4) => !this.context.isReferenceObject(element4))
+        ];
+      }
       convertSchemaObject({ schema }) {
         const schemaId = this.schemaIdOverride ?? this.context.convertBreadcrumbsToName(this.breadcrumbs);
         const namespacedSchemaId = this.context.getNamespacedSchemaId(schemaId);
@@ -705228,7 +705301,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.109.2",
+          version: "5.110.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -705294,7 +705367,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.109.2",
+        version: "5.110.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -886968,7 +887041,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 = "5.109.2";
+  const version7 = "5.110.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -913932,7 +914005,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.109.2",
+        cliVersion: "5.110.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -980852,7 +980925,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.109.2"
+    cli_version: "5.110.0"
   };
 }
 function isAutomationMode() {
@@ -981684,7 +981757,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.109.2";
+    return "5.110.0";
   }
   getCliName() {
     if (false) {

package/package.json

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