@fern-api/fern-api-dev 5.101.1 → 5.101.2

package/cli.cjs

@@ -265878,82 +265878,6 @@ var init_convertEnvironments = __esm({
   }
 });
 
-// ../../commons/ir-utils/lib/hashJSON.js
-function hashJSON(obj) {
-  let hash5 = 2166136261;
-  function feedChar(char) {
-    hash5 ^= char;
-    hash5 += (hash5 << 1) + (hash5 << 4) + (hash5 << 7) + (hash5 << 8) + (hash5 << 24);
-    hash5 >>>= 0;
-  }
-  function feedString(str2) {
-    for (let i5 = 0, len = str2.length; i5 < len; i5++) {
-      feedChar(str2.charCodeAt(i5));
-    }
-  }
-  function traverse(value2, currentDepth) {
-    if (typeof value2 === "object" && value2 != null) {
-      if (currentDepth > MAX_DEPTH) {
-        feedString("[MaxDepthExceeded]");
-        return;
-      }
-      if (Array.isArray(value2)) {
-        feedChar(91);
-        for (let i5 = 0; i5 < value2.length; i5++) {
-          if (i5 > 0) {
-            feedChar(44);
-          }
-          traverse(value2[i5], currentDepth + 1);
-        }
-        feedChar(93);
-      } else {
-        feedChar(123);
-        const keys25 = Object.keys(value2).sort();
-        const klen = keys25.length;
-        for (let i5 = 0; i5 < klen; i5++) {
-          if (i5 > 0) {
-            feedChar(44);
-          }
-          feedString(keys25[i5] ?? "");
-          feedChar(58);
-          traverse(value2[keys25[i5] ?? ""], currentDepth + 1);
-        }
-        feedChar(125);
-      }
-    } else {
-      feedString(String(value2));
-    }
-  }
-  traverse(obj, 0);
-  return hash5.toString(16);
-}
-var MAX_DEPTH;
-var init_hashJSON = __esm({
-  "../../commons/ir-utils/lib/hashJSON.js"() {
-    "use strict";
-    MAX_DEPTH = 64;
-  }
-});
-
-// ../../commons/ir-utils/lib/utils/isTypeReferenceOptional.js
-function isTypeReferenceOptional({ typeReference: typeReference2, typeDeclarations }) {
-  if (typeReference2.type === "container" && typeReference2.container.type === "optional") {
-    return true;
-  }
-  if (typeReference2.type === "named") {
-    const typeDeclaration2 = typeDeclarations?.[typeReference2.typeId];
-    if (typeDeclaration2?.shape.type === "alias" && typeDeclaration2?.shape.resolvedType.type === "container" && typeDeclaration2?.shape.resolvedType.container.type === "optional") {
-      return true;
-    }
-  }
-  return false;
-}
-var init_isTypeReferenceOptional = __esm({
-  "../../commons/ir-utils/lib/utils/isTypeReferenceOptional.js"() {
-    "use strict";
-  }
-});
-
 // ../../commons/casings-generator/lib/reserved.js
 var RESERVED_KEYWORDS;
 var init_reserved = __esm({
@@ -266849,6 +266773,82 @@ var init_namesUtils = __esm({
   }
 });
 
+// ../../commons/ir-utils/lib/hashJSON.js
+function hashJSON(obj) {
+  let hash5 = 2166136261;
+  function feedChar(char) {
+    hash5 ^= char;
+    hash5 += (hash5 << 1) + (hash5 << 4) + (hash5 << 7) + (hash5 << 8) + (hash5 << 24);
+    hash5 >>>= 0;
+  }
+  function feedString(str2) {
+    for (let i5 = 0, len = str2.length; i5 < len; i5++) {
+      feedChar(str2.charCodeAt(i5));
+    }
+  }
+  function traverse(value2, currentDepth) {
+    if (typeof value2 === "object" && value2 != null) {
+      if (currentDepth > MAX_DEPTH) {
+        feedString("[MaxDepthExceeded]");
+        return;
+      }
+      if (Array.isArray(value2)) {
+        feedChar(91);
+        for (let i5 = 0; i5 < value2.length; i5++) {
+          if (i5 > 0) {
+            feedChar(44);
+          }
+          traverse(value2[i5], currentDepth + 1);
+        }
+        feedChar(93);
+      } else {
+        feedChar(123);
+        const keys25 = Object.keys(value2).sort();
+        const klen = keys25.length;
+        for (let i5 = 0; i5 < klen; i5++) {
+          if (i5 > 0) {
+            feedChar(44);
+          }
+          feedString(keys25[i5] ?? "");
+          feedChar(58);
+          traverse(value2[keys25[i5] ?? ""], currentDepth + 1);
+        }
+        feedChar(125);
+      }
+    } else {
+      feedString(String(value2));
+    }
+  }
+  traverse(obj, 0);
+  return hash5.toString(16);
+}
+var MAX_DEPTH;
+var init_hashJSON = __esm({
+  "../../commons/ir-utils/lib/hashJSON.js"() {
+    "use strict";
+    MAX_DEPTH = 64;
+  }
+});
+
+// ../../commons/ir-utils/lib/utils/isTypeReferenceOptional.js
+function isTypeReferenceOptional({ typeReference: typeReference2, typeDeclarations }) {
+  if (typeReference2.type === "container" && typeReference2.container.type === "optional") {
+    return true;
+  }
+  if (typeReference2.type === "named") {
+    const typeDeclaration2 = typeDeclarations?.[typeReference2.typeId];
+    if (typeDeclaration2?.shape.type === "alias" && typeDeclaration2?.shape.resolvedType.type === "container" && typeDeclaration2?.shape.resolvedType.container.type === "optional") {
+      return true;
+    }
+  }
+  return false;
+}
+var init_isTypeReferenceOptional = __esm({
+  "../../commons/ir-utils/lib/utils/isTypeReferenceOptional.js"() {
+    "use strict";
+  }
+});
+
 // ../../commons/ir-utils/lib/examples/v1/generateContainerExample.js
 function generateContainerExample({ fieldName, containerType, maxDepth, currentDepth, typeDeclarations, skipOptionalProperties, visitedTypes }) {
   if (currentDepth >= maxDepth) {
@@ -268446,8 +268446,8 @@ function generateEndpointExample({ ir: ir3, endpoint: endpoint3, service, typeDe
     return { type: "failure", message: `Parse failure with exceptions ${e2}` };
   }
 }
-function getUrlForExample(endpoint3, example) {
-  const pathParameters = {};
+function getUrlForExample(endpoint3, example, fallbackPathParameterValues = {}) {
+  const pathParameters = { ...fallbackPathParameterValues };
   [...example.rootPathParameters, ...example.servicePathParameters, ...example.endpointPathParameters].forEach((examplePathParameter) => {
     const value2 = examplePathParameter.value.jsonExample;
     const stringValue = typeof value2 === "string" ? value2 : JSON.stringify(value2);
@@ -268478,6 +268478,87 @@ var init_generateEndpointExample = __esm({
   }
 });
 
+// ../../commons/ir-utils/lib/examples/backfillMissingPathParameterExamples.js
+function backfillMissingPathParameterExamples({ ir: ir3 }) {
+  for (const service of Object.values(ir3.services)) {
+    for (const endpoint3 of service.endpoints) {
+      for (const userSpecifiedExample of endpoint3.userSpecifiedExamples) {
+        if (userSpecifiedExample.example == null) {
+          continue;
+        }
+        backfillExample({
+          typeDeclarations: ir3.types,
+          rootPathParameters: ir3.pathParameters,
+          service,
+          endpoint: endpoint3,
+          example: userSpecifiedExample.example
+        });
+      }
+    }
+  }
+  return ir3;
+}
+function backfillExample({ typeDeclarations, rootPathParameters, service, endpoint: endpoint3, example }) {
+  const buckets = [
+    { declared: rootPathParameters, examples: example.rootPathParameters },
+    { declared: service.pathParameters, examples: example.servicePathParameters },
+    { declared: endpoint3.pathParameters, examples: example.endpointPathParameters }
+  ];
+  const suppliedNames = new Set(buckets.flatMap((bucket) => bucket.examples.map((pathParameter) => getOriginalName(pathParameter.name))));
+  let anyMissing = false;
+  const clientDefaultValues = {};
+  for (const bucket of buckets) {
+    for (const pathParameter of bucket.declared) {
+      if (suppliedNames.has(getOriginalName(pathParameter.name))) {
+        continue;
+      }
+      anyMissing = true;
+      if (pathParameter.clientDefault != null) {
+        clientDefaultValues[getOriginalName(pathParameter.name)] = literalToString(pathParameter.clientDefault);
+        continue;
+      }
+      const pathParameterExample = generateExample({ pathParameter, typeDeclarations });
+      if (pathParameterExample == null) {
+        continue;
+      }
+      bucket.examples.push(pathParameterExample);
+    }
+  }
+  if (anyMissing) {
+    example.url = getUrlForExample(endpoint3, example, clientDefaultValues);
+  }
+}
+function generateExample({ pathParameter, typeDeclarations }) {
+  const generated = generatePathParameterExamples2([pathParameter], {
+    typeDeclarations,
+    skipOptionalRequestProperties: true,
+    maxDepth: 1
+  });
+  if (generated.type === "failure") {
+    return void 0;
+  }
+  return generated.example[0];
+}
+function literalToString(literal3) {
+  switch (literal3.type) {
+    case "string":
+      return literal3.string;
+    case "boolean":
+      return String(literal3.boolean);
+    default:
+      assertNever(literal3);
+  }
+}
+var init_backfillMissingPathParameterExamples = __esm({
+  "../../commons/ir-utils/lib/examples/backfillMissingPathParameterExamples.js"() {
+    "use strict";
+    init_lib4();
+    init_namesUtils();
+    init_generateEndpointExample();
+    init_generateParameterExamples();
+  }
+});
+
 // ../../commons/ir-utils/lib/examples/v1/generateWebSocketExample.js
 function generateWebSocketExample({ ir: ir3, channel: channel3, typeDeclarations, skipOptionalRequestProperties }) {
   const result = {
@@ -272308,6 +272389,7 @@ var init_lib22 = __esm({
     init_convertApiAuth();
     init_constructHttpPath();
     init_convertEnvironments();
+    init_backfillMissingPathParameterExamples();
     init_injectAutogeneratedExamples();
     init_generateEndpointExample();
     init_filterIntermediateRepresentationForAudiences();
@@ -282040,6 +282122,7 @@ function generateIntermediateRepresentation({ workspace, generationLanguage, key
   resolveGlobalParameterApplicability(intermediateRepresentation, {
     onWarning: (message) => context3.logger.warn(message)
   });
+  backfillMissingPathParameterExamples({ ir: intermediateRepresentation });
   const intermediateRepresentationWithGeneratedExamples = exampleGeneration.disabled ? intermediateRepresentation : injectAutogeneratedExamples({ ir: intermediateRepresentation, exampleGeneration });
   const workspaceDefinitionRootApiFileContents = workspace.definition.rootApiFile.contents;
   const ignoreAudiences = environments2?.environments._visit({
@@ -347875,6 +347958,7 @@ var init_AbstractSpecConverter = __esm({
         if (!this.irGraph.hasNoAudiences()) {
           ir3 = this.filterIrForAudiences(ir3);
         }
+        backfillMissingPathParameterExamples({ ir: ir3 });
         const exampleGeneration = this.context.exampleGenerationArgs;
         const irWithV2Examples = injectAutogeneratedV2Examples({ ir: ir3, exampleGeneration, logger: this.context.logger });
         if (this.context.generateV1Examples) {
@@ -703346,7 +703430,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.101.1",
+          version: "5.101.2",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -703412,7 +703496,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.101.1",
+        version: "5.101.2",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -884794,7 +884878,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.101.1";
+  const version7 = "5.101.2";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -910714,7 +910798,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.101.1",
+        cliVersion: "5.101.2",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -978085,7 +978169,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.101.1"
+    cli_version: "5.101.2"
   };
 }
 function isAutomationMode() {
@@ -978917,7 +979001,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.101.1";
+    return "5.101.2";
   }
   getCliName() {
     if (false) {

package/package.json

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