@fern-api/fern-api-dev 3.27.1-1-g21d8c43893 → 3.27.3

package/cli.cjs

@@ -1413817,7 +1413817,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.27.1-1-g21d8c43893",
+          version: "3.27.3",
           usingAccessToken: true
         }
       });
@@ -1413916,7 +1413916,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.27.1-1-g21d8c43893",
+        version: "3.27.3",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1493982,7 +1493982,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.27.1-1-g21d8c43893";
+    return "3.27.3";
   }
   getCliName() {
     if (false) {
@@ -1570472,6 +1570472,13 @@ var ExampleResolverImpl = class {
         file
       };
     }
+    const parsedReference = this.parseExampleReference(example);
+    if (parsedReference == null) {
+      return {
+        resolvedExample: example,
+        file
+      };
+    }
     return this.resolveExampleReference(example, file);
   }
   resolveExampleReference(example, file) {
@@ -1570505,17 +1570512,32 @@ var ExampleResolverImpl = class {
       return void 0;
     }
     if (third == null) {
+      const rawTypeReference = first3.slice(EXAMPLE_REFERENCE_PREFIX.length);
+      if (!isValidTypeNameStart(rawTypeReference)) {
+        return void 0;
+      }
       return {
-        rawTypeReference: first3.slice(EXAMPLE_REFERENCE_PREFIX.length),
+        rawTypeReference,
         exampleName: second
       };
     }
+    const importName = first3.slice(EXAMPLE_REFERENCE_PREFIX.length);
+    if (!isValidTypeNameStart(importName) || !isValidTypeNameStart(second)) {
+      return void 0;
+    }
     return {
-      rawTypeReference: `${first3}.${second}`.slice(EXAMPLE_REFERENCE_PREFIX.length),
+      rawTypeReference: `${importName}.${second}`,
       exampleName: third
     };
   }
 };
+function isValidTypeNameStart(name2) {
+  if (name2.length === 0) {
+    return false;
+  }
+  const firstChar = name2.charAt(0);
+  return firstChar >= "a" && firstChar <= "z" || firstChar >= "A" && firstChar <= "Z";
+}
 
 // ../generation/ir-generator/lib/resolvers/PropertyResolver.js
 var PropertyResolverImpl = class {
@@ -1588459,7 +1588481,7 @@ var import_path35 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version6 = "3.27.1-1-g21d8c43893";
+  const version6 = "3.27.3";
   return `cli@${version6}`;
 }
 var DebugLogger = class {
@@ -1627862,13 +1627884,33 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain2
         apiDefinition = await enhanceExamplesWithAI(apiDefinition, aiEnhancerConfig, context2, token, organization, sourceFilePath);
       }
       let dynamicIRsByLanguage;
+      let languagesWithExistingSdkDynamicIr = /* @__PURE__ */ new Set();
       if (useDynamicSnippets) {
-        dynamicIRsByLanguage = await generateLanguageSpecificDynamicIRs({
+        const existingSdkDynamicIrs = await checkAndDownloadExistingSdkDynamicIRs({
+          fdr,
           workspace,
           organization,
           context: context2,
           snippetsConfig
         });
+        if (existingSdkDynamicIrs && Object.keys(existingSdkDynamicIrs).length > 0) {
+          dynamicIRsByLanguage = existingSdkDynamicIrs;
+          languagesWithExistingSdkDynamicIr = new Set(Object.keys(existingSdkDynamicIrs));
+          context2.logger.debug(`Using existing SDK dynamic IRs for: ${Object.keys(existingSdkDynamicIrs).join(", ")}`);
+        }
+        const generatedDynamicIRs = await generateLanguageSpecificDynamicIRs({
+          workspace,
+          organization,
+          context: context2,
+          snippetsConfig,
+          skipLanguages: languagesWithExistingSdkDynamicIr
+        });
+        if (generatedDynamicIRs) {
+          dynamicIRsByLanguage = {
+            ...dynamicIRsByLanguage,
+            ...generatedDynamicIRs
+          };
+        }
       }
       const response = await fdr.api.v1.register.registerApiDefinition({
         orgId: FdrAPI_exports.OrgId(organization),
@@ -1628038,7 +1628080,203 @@ function parseBasePath(domain2) {
     return void 0;
   }
 }
-async function generateLanguageSpecificDynamicIRs({ workspace, organization, context: context2, snippetsConfig }) {
+async function checkAndDownloadExistingSdkDynamicIRs({ fdr, workspace, organization, context: context2, snippetsConfig }) {
+  if (!workspace) {
+    return void 0;
+  }
+  const snippetConfigWithVersions = await buildSnippetConfigurationWithVersions({
+    fdr,
+    workspace,
+    snippetsConfig,
+    context: context2
+  });
+  if (Object.keys(snippetConfigWithVersions).length === 0) {
+    context2.logger.debug(`[SDK Dynamic IR] No snippet configs with versions found, skipping S3 check`);
+    return void 0;
+  }
+  try {
+    const response = await fdr.api.v1.register.checkSdkDynamicIrExists({
+      orgId: FdrAPI_exports.OrgId(organization),
+      snippetConfiguration: snippetConfigWithVersions
+    });
+    if (!response.ok || !response.body) {
+      context2.logger.debug(`[SDK Dynamic IR] API call failed or returned empty body`);
+      return void 0;
+    }
+    const existingDynamicIrs = response.body.existingDynamicIrs;
+    if (Object.keys(existingDynamicIrs).length === 0) {
+      context2.logger.debug("[SDK Dynamic IR] No existing SDK dynamic IRs found in S3");
+      return void 0;
+    }
+    const result = {};
+    for (const [language, sdkDynamicIrDownload] of Object.entries(existingDynamicIrs)) {
+      try {
+        context2.logger.debug(`Downloading existing SDK dynamic IR for ${language}...`);
+        const downloadResponse = await fetch(sdkDynamicIrDownload.downloadUrl);
+        if (downloadResponse.ok) {
+          const dynamicIR = await downloadResponse.json();
+          result[language] = { dynamicIR };
+          context2.logger.debug(`Successfully downloaded SDK dynamic IR for ${language}`);
+        } else {
+          context2.logger.warn(`Failed to download SDK dynamic IR for ${language}: ${downloadResponse.status}`);
+        }
+      } catch (error2) {
+        context2.logger.warn(`Error downloading SDK dynamic IR for ${language}: ${error2}`);
+      }
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  } catch (error2) {
+    context2.logger.debug(`Error checking for existing SDK dynamic IRs: ${error2}`);
+    return void 0;
+  }
+}
+async function buildSnippetConfigurationWithVersions({ fdr, workspace, snippetsConfig, context: context2 }) {
+  const result = {};
+  const snippetConfigs = [
+    {
+      language: "typescript",
+      snippetName: snippetsConfig.typescriptSdk?.package,
+      explicitVersion: snippetsConfig.typescriptSdk?.version
+    },
+    {
+      language: "python",
+      snippetName: snippetsConfig.pythonSdk?.package,
+      explicitVersion: snippetsConfig.pythonSdk?.version
+    },
+    {
+      language: "java",
+      snippetName: snippetsConfig.javaSdk?.coordinate,
+      explicitVersion: snippetsConfig.javaSdk?.version
+    },
+    {
+      language: "go",
+      snippetName: snippetsConfig.goSdk?.githubRepo,
+      explicitVersion: snippetsConfig.goSdk?.version
+    },
+    {
+      language: "csharp",
+      snippetName: snippetsConfig.csharpSdk?.package,
+      explicitVersion: snippetsConfig.csharpSdk?.version
+    },
+    {
+      language: "ruby",
+      snippetName: snippetsConfig.rubySdk?.gem,
+      explicitVersion: snippetsConfig.rubySdk?.version
+    },
+    {
+      language: "php",
+      snippetName: snippetsConfig.phpSdk?.package,
+      explicitVersion: snippetsConfig.phpSdk?.version
+    },
+    {
+      language: "swift",
+      snippetName: snippetsConfig.swiftSdk?.package,
+      explicitVersion: snippetsConfig.swiftSdk?.version
+    },
+    {
+      language: "rust",
+      snippetName: snippetsConfig.rustSdk?.package,
+      explicitVersion: snippetsConfig.rustSdk?.version
+    }
+  ];
+  for (const config2 of snippetConfigs) {
+    if (!config2.snippetName) {
+      continue;
+    }
+    let version6 = config2.explicitVersion;
+    if (!version6) {
+      const versionResult = await computeSemanticVersionForLanguage({
+        fdr,
+        workspace,
+        language: config2.language,
+        snippetName: config2.snippetName,
+        context: context2
+      });
+      version6 = versionResult?.version;
+    }
+    if (version6) {
+      result[config2.language] = { packageName: config2.snippetName, version: version6 };
+    } else {
+      context2.logger.debug(`[SDK Dynamic IR] ${config2.language}: skipping S3 check (no version available)`);
+    }
+  }
+  return result;
+}
+async function computeSemanticVersionForLanguage({ fdr, workspace, language, snippetName, context: context2 }) {
+  let fdrLanguage;
+  switch (language) {
+    case "csharp":
+      fdrLanguage = "Csharp";
+      break;
+    case "go":
+      fdrLanguage = "Go";
+      break;
+    case "java":
+      fdrLanguage = "Java";
+      break;
+    case "python":
+      fdrLanguage = "Python";
+      break;
+    case "ruby":
+      fdrLanguage = "Ruby";
+      break;
+    case "typescript":
+      fdrLanguage = "TypeScript";
+      break;
+    case "php":
+      fdrLanguage = "Php";
+      break;
+    case "swift":
+      fdrLanguage = "Swift";
+      break;
+    default:
+      return void 0;
+  }
+  let githubRepository;
+  let generatorPackage;
+  let matchedGeneratorName;
+  if (workspace.generatorsConfiguration?.groups) {
+    const candidatePackages = [];
+    for (const group of workspace.generatorsConfiguration.groups) {
+      for (const generatorInvocation of group.generators) {
+        if (generatorInvocation.language === language) {
+          const pkgName = generators_yml_exports.getPackageName({ generatorInvocation });
+          if (pkgName) {
+            candidatePackages.push(pkgName);
+          }
+          if (!generatorPackage && pkgName) {
+            generatorPackage = pkgName;
+            matchedGeneratorName = generatorInvocation.name;
+            if (generatorInvocation.outputMode.type === "githubV2") {
+              githubRepository = `${generatorInvocation.outputMode.githubV2.owner}/${generatorInvocation.outputMode.githubV2.repo}`;
+            }
+          }
+        }
+      }
+    }
+  }
+  if (!generatorPackage) {
+    context2.logger.debug(`[SDK Dynamic IR] ${language}: no generator found with a package name`);
+    return void 0;
+  }
+  try {
+    const response = await fdr.sdks.versions.computeSemanticVersion({
+      githubRepository,
+      language: fdrLanguage,
+      package: generatorPackage
+    });
+    if (!response.ok) {
+      context2.logger.debug(`[SDK Dynamic IR] ${language}: version computation failed for package "${generatorPackage}"`);
+      return void 0;
+    }
+    context2.logger.debug(`[SDK Dynamic IR] ${language}: computed version ${response.body.version} for package "${generatorPackage}"`);
+    return { version: response.body.version, generatorPackage };
+  } catch (error2) {
+    context2.logger.debug(`[SDK Dynamic IR] ${language}: error computing version: ${error2}`);
+    return void 0;
+  }
+}
+async function generateLanguageSpecificDynamicIRs({ workspace, organization, context: context2, snippetsConfig, skipLanguages = /* @__PURE__ */ new Set() }) {
   let languageSpecificIRs = {};
   if (!workspace) {
     return void 0;
@@ -1628096,6 +1628334,10 @@ async function generateLanguageSpecificDynamicIRs({ workspace, organization, con
         if (!generatorInvocation.language) {
           continue;
         }
+        if (skipLanguages.has(generatorInvocation.language)) {
+          context2.logger.debug(`Skipping dynamic IR generation for ${generatorInvocation.language} (using existing SDK dynamic IR)`);
+          continue;
+        }
         if (generatorInvocation.language && snippetConfiguration[generatorInvocation.language] === packageName) {
           const irForDynamicSnippets = generateIntermediateRepresentation({
             workspace,
@@ -1628136,7 +1628378,7 @@ async function generateLanguageSpecificDynamicIRs({ workspace, organization, con
     }
   }
   for (const [language, packageName] of Object.entries(snippetConfiguration)) {
-    if (language && packageName && !Object.keys(languageSpecificIRs).includes(language)) {
+    if (language && packageName && !Object.keys(languageSpecificIRs).includes(language) && !skipLanguages.has(language)) {
       context2.logger.warn();
       context2.logger.warn(`Failed to upload ${language} SDK snippets because of unknown package \`${packageName}\`.`);
       context2.logger.warn(`Please make sure your ${workspace.workspaceName ? `${workspace.workspaceName}/` : ""}generators.yml has a generator that publishes a ${packageName} package.`);
@@ -1632006,9 +1632248,36 @@ function createDocsVisitor(visitor, nodePath) {
 }
 
 // ../fern-definition/validator/lib/ast/visitors/utils/visitAllReferencesInExample.js
+function isValidExampleReference(example) {
+  if (!example.startsWith(EXAMPLE_REFERENCE_PREFIX)) {
+    return false;
+  }
+  const parts = example.split(".");
+  if (parts.length < 2 || parts.length > 3) {
+    return false;
+  }
+  const firstPart = parts[0]?.slice(EXAMPLE_REFERENCE_PREFIX.length);
+  if (!firstPart || !startsWithLetter(firstPart)) {
+    return false;
+  }
+  if (parts.length === 3) {
+    const secondPart = parts[1];
+    if (!secondPart || !startsWithLetter(secondPart)) {
+      return false;
+    }
+  }
+  return true;
+}
+function startsWithLetter(str3) {
+  if (str3.length === 0) {
+    return false;
+  }
+  const firstChar = str3.charAt(0);
+  return firstChar >= "a" && firstChar <= "z" || firstChar >= "A" && firstChar <= "Z";
+}
 function visitAllReferencesInExample({ example, visitor, nodePath }) {
   if (typeof example === "string") {
-    if (example.startsWith(EXAMPLE_REFERENCE_PREFIX)) {
+    if (isValidExampleReference(example)) {
       visitor.exampleTypeReference?.(example, nodePath);
     }
   } else if (isPlainObject2(example)) {

package/package.json

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