@fern-api/fern-api-dev 4.79.4 → 4.80.0

package/cli.cjs

@@ -614276,7 +614276,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.79.4",
+          version: "4.80.0",
           usingAccessToken: true
         }
       });
@@ -614330,7 +614330,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.79.4",
+        version: "4.80.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -831611,7 +831611,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "4.79.4";
+  const version7 = "4.80.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -843125,7 +843125,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.79.4"
+        cliVersion: "4.80.0"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -918206,7 +918206,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.79.4";
+    return "4.80.0";
   }
   getCliName() {
     if (false) {
@@ -919792,6 +919792,253 @@ async function addGeneratorToWorkspaces({
   );
 }
 
+// src/commands/generate/shouldSkipGenerator.ts
+function shouldSkipGenerator({
+  generator,
+  rootAutorelease
+}) {
+  if (!generator.automation.generate) {
+    return true;
+  }
+  if (generator.absolutePathToLocalOutput != null) {
+    return true;
+  }
+  if (generator.raw?.autorelease === false) {
+    return true;
+  }
+  if (generator.raw?.autorelease == null && rootAutorelease === false) {
+    return true;
+  }
+  return false;
+}
+
+// src/commands/automations/listGenerateCommands.ts
+function listGenerateCommands({
+  workspaces,
+  groupFilter,
+  version: version7,
+  autoMerge
+}) {
+  const commands = [];
+  for (const workspace of workspaces) {
+    const generatorsConfiguration = workspace.generatorsConfiguration;
+    const groups2 = generatorsConfiguration?.groups ?? [];
+    const rootAutorelease = generatorsConfiguration?.rawConfiguration.autorelease;
+    for (const group of groups2) {
+      if (groupFilter != null && group.groupName !== groupFilter) {
+        continue;
+      }
+      for (let i9 = 0; i9 < group.generators.length; i9++) {
+        const generator = group.generators[i9];
+        if (generator == null || shouldSkipGenerator({ generator, rootAutorelease })) {
+          continue;
+        }
+        const parts = ["fern", "automations", "generate"];
+        if (workspace.workspaceName != null) {
+          parts.push("--api", workspace.workspaceName);
+        }
+        parts.push("--group", group.groupName);
+        parts.push("--generator", String(i9));
+        if (version7 != null) {
+          parts.push("--version", version7);
+        }
+        if (autoMerge) {
+          parts.push("--auto-merge");
+        }
+        commands.push(parts.join(" "));
+      }
+    }
+  }
+  return commands;
+}
+
+// src/commands/sdk-preview/overrideOutputForPreview.ts
+var PREVIEW_REGISTRY_URL = process.env.FERN_PREVIEW_REGISTRY_URL ?? "https://npm.buildwithfern.com";
+var SUPPORTED_TYPESCRIPT_GENERATORS = /* @__PURE__ */ new Set([
+  "fernapi/fern-typescript-node-sdk",
+  "fernapi/fern-typescript-browser-sdk",
+  "fernapi/fern-typescript-sdk"
+]);
+function isNpmGenerator(generatorName) {
+  return SUPPORTED_TYPESCRIPT_GENERATORS.has(generatorName);
+}
+function getGithubOwnerRepo(outputMode) {
+  return outputMode._visit({
+    downloadFiles: () => void 0,
+    github: (val) => ({ owner: val.owner, repo: val.repo }),
+    githubV2: (val) => val._visit({
+      push: (v6) => ({ owner: v6.owner, repo: v6.repo }),
+      commitAndRelease: (v6) => ({ owner: v6.owner, repo: v6.repo }),
+      pullRequest: (v6) => ({ owner: v6.owner, repo: v6.repo }),
+      _other: () => void 0
+    }),
+    publish: () => void 0,
+    // publishV2 is registry-only (npmOverride, mavenOverride, pypiOverride, etc.)
+    // and does not carry github owner/repo info. GitHub publish info is only
+    // available on githubV2 variants via the publishInfo field.
+    publishV2: () => void 0,
+    _other: () => void 0
+  });
+}
+function createNpmOverrideOutputMode({
+  registryUrl: registryUrl2,
+  packageName,
+  token
+}) {
+  return api_exports4.OutputMode.publishV2(
+    api_exports4.remoteGen.PublishOutputModeV2.npmOverride({
+      registryUrl: registryUrl2,
+      packageName,
+      token,
+      downloadSnippets: false
+    })
+  );
+}
+function overrideGroupOutputForDownload({
+  group
+}) {
+  const modifiedGenerators = group.generators.map((generator) => ({
+    ...generator,
+    outputMode: api_exports4.remoteGen.OutputMode.downloadFiles({}),
+    absolutePathToLocalOutput: void 0
+  }));
+  return {
+    ...group,
+    generators: modifiedGenerators
+  };
+}
+function overrideGroupOutputForPreview({
+  group,
+  packageName,
+  token,
+  registryUrl: registryUrl2
+}) {
+  const modifiedGenerators = group.generators.map((generator) => ({
+    ...generator,
+    outputMode: createNpmOverrideOutputMode({ registryUrl: registryUrl2, packageName, token }),
+    absolutePathToLocalOutput: void 0
+  }));
+  return {
+    ...group,
+    generators: modifiedGenerators
+  };
+}
+function getGithubPublishInfoWithoutToken(outputMode) {
+  const publishInfo = outputMode._visit({
+    downloadFiles: () => void 0,
+    github: () => void 0,
+    githubV2: (val) => val._visit({
+      push: (v6) => v6.publishInfo,
+      commitAndRelease: (v6) => v6.publishInfo,
+      pullRequest: (v6) => v6.publishInfo,
+      _other: () => void 0
+    }),
+    publish: () => void 0,
+    publishV2: () => void 0,
+    _other: () => void 0
+  });
+  if (publishInfo == null) {
+    return void 0;
+  }
+  return stripPublishInfoCredentials(publishInfo);
+}
+function stripPublishInfoCredentials(publishInfo) {
+  return publishInfo._visit({
+    npm: (val) => api_exports4.GithubPublishInfo.npm({
+      registryUrl: val.registryUrl,
+      packageName: val.packageName,
+      token: void 0
+    }),
+    maven: (val) => api_exports4.GithubPublishInfo.maven({
+      registryUrl: val.registryUrl,
+      coordinate: val.coordinate,
+      credentials: void 0,
+      signature: void 0
+    }),
+    postman: () => void 0,
+    pypi: (val) => api_exports4.GithubPublishInfo.pypi({
+      registryUrl: val.registryUrl,
+      packageName: val.packageName,
+      credentials: void 0,
+      pypiMetadata: val.pypiMetadata
+    }),
+    nuget: (val) => api_exports4.GithubPublishInfo.nuget({
+      registryUrl: val.registryUrl,
+      packageName: val.packageName,
+      apiKey: void 0
+    }),
+    rubygems: (val) => api_exports4.GithubPublishInfo.rubygems({
+      registryUrl: val.registryUrl,
+      packageName: val.packageName,
+      apiKey: void 0
+    }),
+    crates: (val) => api_exports4.GithubPublishInfo.crates({
+      registryUrl: val.registryUrl,
+      packageName: val.packageName,
+      token: void 0
+    }),
+    _other: () => void 0
+  });
+}
+function overrideGroupOutputForDiffBranch({
+  group
+}) {
+  const modifiedGenerators = group.generators.map((generator) => {
+    const githubInfo = getGithubOwnerRepo(generator.outputMode);
+    if (githubInfo == null) {
+      return void 0;
+    }
+    return {
+      ...generator,
+      outputMode: api_exports4.OutputMode.githubV2(
+        api_exports4.GithubOutputModeV2.push({
+          owner: githubInfo.owner,
+          repo: githubInfo.repo,
+          branch: void 0,
+          license: void 0,
+          publishInfo: getGithubPublishInfoWithoutToken(generator.outputMode),
+          downloadSnippets: false
+        })
+      ),
+      absolutePathToLocalOutput: void 0
+    };
+  }).filter((g8) => g8 != null);
+  return {
+    ...group,
+    generators: modifiedGenerators
+  };
+}
+
+// src/commands/automations/listPreviewGroups.ts
+function listPreviewGroups({
+  workspaces,
+  groupFilter
+}) {
+  const results = [];
+  for (const workspace of workspaces) {
+    const generatorsConfiguration = workspace.generatorsConfiguration;
+    if (generatorsConfiguration == null) {
+      continue;
+    }
+    for (const group of generatorsConfiguration.groups) {
+      if (groupFilter != null && group.groupName !== groupFilter) {
+        continue;
+      }
+      const firstPreviewable = group.generators.find(
+        (generator) => generator.automation.preview && isNpmGenerator(generator.name)
+      );
+      if (firstPreviewable != null) {
+        results.push({
+          groupName: group.groupName,
+          apiName: workspace.workspaceName ?? null,
+          generator: firstPreviewable.name
+        });
+      }
+    }
+  }
+  return results;
+}
+
 // src/commands/diff/diff.ts
 init_lib4();
 init_lib6();
@@ -928313,26 +928560,6 @@ function getExcludeRules(brokenLinks, strictBrokenLinks) {
   return excludeRules;
 }
 
-// src/commands/generate/shouldSkipGenerator.ts
-function shouldSkipGenerator({
-  generator,
-  rootAutorelease
-}) {
-  if (!generator.automation.generate) {
-    return true;
-  }
-  if (generator.absolutePathToLocalOutput != null) {
-    return true;
-  }
-  if (generator.raw?.autorelease === false) {
-    return true;
-  }
-  if (generator.raw?.autorelease == null && rootAutorelease === false) {
-    return true;
-  }
-  return false;
-}
-
 // src/commands/generate-dynamic-ir/generateDynamicIrForWorkspaces.ts
 init_lib6();
 var import_path88 = __toESM(require("path"), 1);
@@ -930326,163 +930553,6 @@ function generateRandomId() {
   return (0, import_crypto12.randomBytes)(4).toString("hex");
 }
 
-// src/commands/sdk-preview/overrideOutputForPreview.ts
-var PREVIEW_REGISTRY_URL = process.env.FERN_PREVIEW_REGISTRY_URL ?? "https://npm.buildwithfern.com";
-var SUPPORTED_TYPESCRIPT_GENERATORS = /* @__PURE__ */ new Set([
-  "fernapi/fern-typescript-node-sdk",
-  "fernapi/fern-typescript-browser-sdk",
-  "fernapi/fern-typescript-sdk"
-]);
-function isNpmGenerator(generatorName) {
-  return SUPPORTED_TYPESCRIPT_GENERATORS.has(generatorName);
-}
-function getGithubOwnerRepo(outputMode) {
-  return outputMode._visit({
-    downloadFiles: () => void 0,
-    github: (val) => ({ owner: val.owner, repo: val.repo }),
-    githubV2: (val) => val._visit({
-      push: (v6) => ({ owner: v6.owner, repo: v6.repo }),
-      commitAndRelease: (v6) => ({ owner: v6.owner, repo: v6.repo }),
-      pullRequest: (v6) => ({ owner: v6.owner, repo: v6.repo }),
-      _other: () => void 0
-    }),
-    publish: () => void 0,
-    // publishV2 is registry-only (npmOverride, mavenOverride, pypiOverride, etc.)
-    // and does not carry github owner/repo info. GitHub publish info is only
-    // available on githubV2 variants via the publishInfo field.
-    publishV2: () => void 0,
-    _other: () => void 0
-  });
-}
-function createNpmOverrideOutputMode({
-  registryUrl: registryUrl2,
-  packageName,
-  token
-}) {
-  return api_exports4.OutputMode.publishV2(
-    api_exports4.remoteGen.PublishOutputModeV2.npmOverride({
-      registryUrl: registryUrl2,
-      packageName,
-      token,
-      downloadSnippets: false
-    })
-  );
-}
-function overrideGroupOutputForDownload({
-  group
-}) {
-  const modifiedGenerators = group.generators.map((generator) => ({
-    ...generator,
-    outputMode: api_exports4.remoteGen.OutputMode.downloadFiles({}),
-    absolutePathToLocalOutput: void 0
-  }));
-  return {
-    ...group,
-    generators: modifiedGenerators
-  };
-}
-function overrideGroupOutputForPreview({
-  group,
-  packageName,
-  token,
-  registryUrl: registryUrl2
-}) {
-  const modifiedGenerators = group.generators.map((generator) => ({
-    ...generator,
-    outputMode: createNpmOverrideOutputMode({ registryUrl: registryUrl2, packageName, token }),
-    absolutePathToLocalOutput: void 0
-  }));
-  return {
-    ...group,
-    generators: modifiedGenerators
-  };
-}
-function getGithubPublishInfoWithoutToken(outputMode) {
-  const publishInfo = outputMode._visit({
-    downloadFiles: () => void 0,
-    github: () => void 0,
-    githubV2: (val) => val._visit({
-      push: (v6) => v6.publishInfo,
-      commitAndRelease: (v6) => v6.publishInfo,
-      pullRequest: (v6) => v6.publishInfo,
-      _other: () => void 0
-    }),
-    publish: () => void 0,
-    publishV2: () => void 0,
-    _other: () => void 0
-  });
-  if (publishInfo == null) {
-    return void 0;
-  }
-  return stripPublishInfoCredentials(publishInfo);
-}
-function stripPublishInfoCredentials(publishInfo) {
-  return publishInfo._visit({
-    npm: (val) => api_exports4.GithubPublishInfo.npm({
-      registryUrl: val.registryUrl,
-      packageName: val.packageName,
-      token: void 0
-    }),
-    maven: (val) => api_exports4.GithubPublishInfo.maven({
-      registryUrl: val.registryUrl,
-      coordinate: val.coordinate,
-      credentials: void 0,
-      signature: void 0
-    }),
-    postman: () => void 0,
-    pypi: (val) => api_exports4.GithubPublishInfo.pypi({
-      registryUrl: val.registryUrl,
-      packageName: val.packageName,
-      credentials: void 0,
-      pypiMetadata: val.pypiMetadata
-    }),
-    nuget: (val) => api_exports4.GithubPublishInfo.nuget({
-      registryUrl: val.registryUrl,
-      packageName: val.packageName,
-      apiKey: void 0
-    }),
-    rubygems: (val) => api_exports4.GithubPublishInfo.rubygems({
-      registryUrl: val.registryUrl,
-      packageName: val.packageName,
-      apiKey: void 0
-    }),
-    crates: (val) => api_exports4.GithubPublishInfo.crates({
-      registryUrl: val.registryUrl,
-      packageName: val.packageName,
-      token: void 0
-    }),
-    _other: () => void 0
-  });
-}
-function overrideGroupOutputForDiffBranch({
-  group
-}) {
-  const modifiedGenerators = group.generators.map((generator) => {
-    const githubInfo = getGithubOwnerRepo(generator.outputMode);
-    if (githubInfo == null) {
-      return void 0;
-    }
-    return {
-      ...generator,
-      outputMode: api_exports4.OutputMode.githubV2(
-        api_exports4.GithubOutputModeV2.push({
-          owner: githubInfo.owner,
-          repo: githubInfo.repo,
-          branch: void 0,
-          license: void 0,
-          publishInfo: getGithubPublishInfoWithoutToken(generator.outputMode),
-          downloadSnippets: false
-        })
-      ),
-      absolutePathToLocalOutput: void 0
-    };
-  }).filter((g8) => g8 != null);
-  return {
-    ...group,
-    generators: modifiedGenerators
-  };
-}
-
 // src/commands/sdk-preview/toPreviewPackageName.ts
 function toPreviewPackageName(packageName, org) {
   const scopeMatch = packageName.match(/^@[^/]+\/(.+)$/);
@@ -930502,7 +930572,6 @@ async function sdkPreview({
   groupName,
   generatorFilter,
   apiName,
-  json: json3,
   output: output2,
   local,
   pushDiff
@@ -930513,17 +930582,20 @@ async function sdkPreview({
   let publishToRegistry = true;
   try {
     if (pushDiff && local) {
-      return cliContext.failAndThrow(
-        "--push-diff requires remote generation and cannot be combined with --local."
-      );
+      return {
+        status: "error",
+        message: "--push-diff requires remote generation and cannot be combined with --local."
+      };
     }
     const token = await cliContext.runTask(async (context3) => {
       return askToLogin(context3);
     });
     if (token == null) {
-      return cliContext.failAndThrow("Authentication required. Run 'fern login' or set FERN_TOKEN.", void 0, {
+      return {
+        status: "error",
+        message: "Authentication required. Run 'fern login' or set FERN_TOKEN.",
         code: CliError.Code.AuthError
-      });
+      };
     }
     const project = await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
       commandLineApiWorkspace: apiName,
@@ -930574,27 +930646,27 @@ async function sdkPreview({
       }
       const groupNameOrDefault = groupName ?? workspace.generatorsConfiguration.defaultGroup;
       if (groupNameOrDefault == null) {
-        return cliContext.failAndThrow(
-          `No group specified. Use the --${GROUP_CLI_OPTION} option, or set "${DEFAULT_GROUP_GENERATORS_CONFIG_KEY}" in ${GENERATORS_CONFIGURATION_FILENAME}`,
-          void 0,
-          { code: CliError.Code.ConfigError }
-        );
+        return {
+          status: "error",
+          message: `No group specified. Use the --${GROUP_CLI_OPTION} option, or set "${DEFAULT_GROUP_GENERATORS_CONFIG_KEY}" in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          code: CliError.Code.ConfigError
+        };
       }
       const group = workspace.generatorsConfiguration.groups.find((g8) => g8.groupName === groupNameOrDefault);
       if (group == null) {
-        return cliContext.failAndThrow(
-          `Group '${groupNameOrDefault}' does not exist in ${GENERATORS_CONFIGURATION_FILENAME}`,
-          void 0,
-          { code: CliError.Code.ConfigError }
-        );
+        return {
+          status: "error",
+          message: `Group '${groupNameOrDefault}' does not exist in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          code: CliError.Code.ConfigError
+        };
       }
       const generators = generatorFilter != null ? group.generators.filter((g8) => g8.name === generatorFilter) : group.generators;
       if (generatorFilter != null && generators.length === 0) {
-        return cliContext.failAndThrow(
-          `Generator '${generatorFilter}' not found in group '${groupNameOrDefault}' in ${GENERATORS_CONFIGURATION_FILENAME}`,
-          void 0,
-          { code: CliError.Code.ConfigError }
-        );
+        return {
+          status: "error",
+          message: `Generator '${generatorFilter}' not found in group '${groupNameOrDefault}' in ${GENERATORS_CONFIGURATION_FILENAME}`,
+          code: CliError.Code.ConfigError
+        };
       }
       const npmGenerators = generators.filter((g8) => isNpmGenerator(g8.name));
       const skippedGenerators = generators.filter((g8) => !isNpmGenerator(g8.name));
@@ -930604,20 +930676,20 @@ async function sdkPreview({
         );
       }
       if (npmGenerators.length === 0) {
-        return cliContext.failAndThrow(
-          `No supported generators found in group '${groupNameOrDefault}'. SDK preview currently only supports TypeScript/npm generators.`,
-          void 0,
-          { code: CliError.Code.ConfigError }
-        );
+        return {
+          status: "error",
+          message: `No supported generators found in group '${groupNameOrDefault}'. SDK preview currently only supports TypeScript/npm generators.`,
+          code: CliError.Code.ConfigError
+        };
       }
       for (const generator of npmGenerators) {
         const originalPackageName = getPackageNameFromGeneratorConfig(generator);
         if (originalPackageName == null) {
-          return cliContext.failAndThrow(
-            `Could not determine package name for generator '${generator.name}'. Ensure 'output.package-name' is set in ${GENERATORS_CONFIGURATION_FILENAME}.`,
-            void 0,
-            { code: CliError.Code.ConfigError }
-          );
+          return {
+            status: "error",
+            message: `Could not determine package name for generator '${generator.name}'. Ensure 'output.package-name' is set in ${GENERATORS_CONFIGURATION_FILENAME}.`,
+            code: CliError.Code.ConfigError
+          };
         }
         const previewPackageName = toPreviewPackageName(originalPackageName, project.config.organization);
         const previewVersion = computePreviewVersion({ previewId });
@@ -930738,51 +930810,12 @@ async function sdkPreview({
       }
     }
   } catch (error50) {
-    if (json3) {
-      const result = {
-        status: "error",
-        message: error50 instanceof Error ? error50.message : String(error50)
-      };
-      process.stdout.write(JSON.stringify(result, null, 2) + "\n");
-      process.exitCode = 1;
-      return;
-    }
-    throw error50;
-  }
-  if (json3) {
-    const result = {
-      status: "success",
-      org: organization ?? "",
-      previews
+    return {
+      status: "error",
+      message: error50 instanceof Error ? error50.message : String(error50)
     };
-    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
-  } else if (previews.length > 0) {
-    cliContext.logger.info("");
-    if (publishToRegistry) {
-      cliContext.logger.info(`Published ${previews.length} preview package${previews.length > 1 ? "s" : ""}:`);
-      for (const preview of previews) {
-        cliContext.logger.info("");
-        cliContext.logger.info(`  ${preview.package_name}@${preview.version}`);
-        cliContext.logger.info(`  Install: ${preview.install}`);
-        if (preview.diff_url) {
-          cliContext.logger.info(`  Diff: ${preview.diff_url}`);
-        }
-        if (preview.output_path) {
-          cliContext.logger.info(`  Output: ${preview.output_path}`);
-        }
-      }
-    } else {
-      cliContext.logger.info(`Generated ${previews.length} preview SDK${previews.length > 1 ? "s" : ""}:`);
-      for (const preview of previews) {
-        cliContext.logger.info("");
-        cliContext.logger.info(`  ${preview.package_name}@${preview.version}`);
-        if (preview.diff_url) {
-          cliContext.logger.info(`  Diff: ${preview.diff_url}`);
-        }
-        cliContext.logger.info(`  Output: ${preview.output_path}`);
-      }
-    }
   }
+  return { status: "success", org: organization ?? "", previews };
 }
 
 // src/commands/self-update/selfUpdate.ts
@@ -938696,6 +938729,7 @@ function addAutomationsCommand(cli, cliContext) {
   cli.command("automations", false, (yargs) => {
     addAutomationsListCommand(yargs, cliContext);
     addAutomationsGenerateCommand(yargs, cliContext);
+    addAutomationsPreviewCommand(yargs, cliContext);
     return yargs.demandCommand();
   });
 }
@@ -938729,37 +938763,116 @@ function addAutomationsListGenerateCommand(cli, cliContext) {
         commandLineApiWorkspace: argv.api,
         defaultToAllApiWorkspaces: true
       });
-      const commands = [];
-      for (const workspace of project.apiWorkspaces) {
-        const generatorsConfiguration = workspace.generatorsConfiguration;
-        const groups2 = generatorsConfiguration?.groups ?? [];
-        const rootAutorelease = generatorsConfiguration?.rawConfiguration.autorelease;
-        for (const group of groups2) {
-          if (argv.group != null && group.groupName !== argv.group) {
-            continue;
+      const commands = listGenerateCommands({
+        workspaces: project.apiWorkspaces,
+        groupFilter: argv.group,
+        version: argv.version,
+        autoMerge: argv["auto-merge"]
+      });
+      process.stdout.write(JSON.stringify(commands));
+    }
+  );
+}
+function addAutomationsPreviewCommand(cli, cliContext) {
+  cli.command(
+    "preview",
+    false,
+    // hidden
+    (yargs) => yargs.option("group", {
+      type: "string",
+      description: "Filter to a specific generator group (e.g. 'sdk'). Omit to preview all eligible groups."
+    }).option("json", {
+      boolean: true,
+      default: false,
+      description: "Output results as JSON (for machine consumption)."
+    }).option("push-diff", {
+      boolean: true,
+      default: false,
+      description: "Push a preview diff branch (fern-preview-{version}) to each SDK repo in addition to publishing to the preview registry."
+    }),
+    async (argv) => {
+      cliContext.instrumentPostHogEvent({
+        command: "fern automations preview"
+      });
+      const project = await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
+        commandLineApiWorkspace: void 0,
+        defaultToAllApiWorkspaces: true
+      });
+      const groups2 = listPreviewGroups({
+        workspaces: project.apiWorkspaces,
+        groupFilter: argv.group
+      });
+      if (groups2.length === 0) {
+        if (argv.json) {
+          process.stdout.write(JSON.stringify({ results: [] }, null, 2) + "\n");
+        } else {
+          cliContext.logger.info("No eligible generator groups found for preview.");
+        }
+        return;
+      }
+      cliContext.logger.info(
+        `Found ${groups2.length} previewable group(s): ${groups2.map((g8) => g8.groupName).join(", ")}`
+      );
+      const results = [];
+      for (const group of groups2) {
+        const apiLabel = group.apiName != null ? ` (api: ${group.apiName})` : "";
+        cliContext.logger.info(`Running preview for ${group.groupName}${apiLabel}...`);
+        try {
+          const result = await sdkPreview({
+            cliContext,
+            groupName: group.groupName,
+            generatorFilter: void 0,
+            apiName: group.apiName ?? void 0,
+            output: void 0,
+            local: false,
+            pushDiff: argv["push-diff"]
+          });
+          if (result.status === "success") {
+            results.push({
+              groupName: group.groupName,
+              apiName: group.apiName,
+              status: "success",
+              org: result.org,
+              previews: result.previews
+            });
+          } else {
+            results.push({
+              groupName: group.groupName,
+              apiName: group.apiName,
+              status: "error",
+              error: result.message
+            });
           }
-          for (let i9 = 0; i9 < group.generators.length; i9++) {
-            const generator = group.generators[i9];
-            if (generator == null || shouldSkipGenerator({ generator, rootAutorelease })) {
-              continue;
-            }
-            const parts = ["fern", "automations", "generate"];
-            if (workspace.workspaceName != null) {
-              parts.push("--api", workspace.workspaceName);
-            }
-            parts.push("--group", group.groupName);
-            parts.push("--generator", String(i9));
-            if (argv.version != null) {
-              parts.push("--version", argv.version);
-            }
-            if (argv["auto-merge"]) {
-              parts.push("--auto-merge");
+        } catch (error50) {
+          const message = error50 instanceof Error ? error50.message : String(error50);
+          cliContext.logger.warn(`Preview failed for group '${group.groupName}': ${message}`);
+          results.push({
+            groupName: group.groupName,
+            apiName: group.apiName,
+            status: "error",
+            error: message
+          });
+        }
+      }
+      if (argv.json) {
+        process.stdout.write(JSON.stringify({ results }, null, 2) + "\n");
+      } else {
+        for (const groupResult of results) {
+          if (groupResult.status === "success" && groupResult.previews != null) {
+            for (const preview of groupResult.previews) {
+              if (preview.install) {
+                cliContext.logger.info(`${groupResult.groupName}: ${preview.install}`);
+              }
             }
-            commands.push(parts.join(" "));
+          } else if (groupResult.status === "error") {
+            cliContext.logger.warn(`${groupResult.groupName}: ${groupResult.error}`);
           }
         }
       }
-      process.stdout.write(JSON.stringify(commands));
+      const hasErrors = results.some((r5) => r5.status === "error");
+      if (hasErrors) {
+        process.exitCode = 1;
+      }
     }
   );
 }
@@ -938857,19 +938970,71 @@ function addSdkPreviewCommand(cli, cliContext) {
         command: "fern sdk preview"
       });
       const generatorFilter = argv.generator != null ? warnAndCorrectIncorrectDockerOrg(argv.generator, cliContext) : void 0;
-      await sdkPreview({
+      const result = await sdkPreview({
         cliContext,
         groupName: argv.group,
         generatorFilter,
         apiName: argv.api,
-        json: argv.json,
         output: argv.output,
         local: argv.local,
         pushDiff: argv.pushDiff
       });
+      writeSdkPreviewOutput({ result, json: argv.json, cliContext });
     }
   );
 }
+function writeSdkPreviewOutput({
+  result,
+  json: json3,
+  cliContext
+}) {
+  if (json3) {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    if (result.status === "error") {
+      process.exitCode = 1;
+    }
+    return;
+  }
+  if (result.status === "error") {
+    return cliContext.failAndThrow(
+      result.message,
+      void 0,
+      result.code != null ? { code: result.code } : void 0
+    );
+  }
+  if (result.previews.length > 0) {
+    cliContext.logger.info("");
+    const hasRegistry = result.previews.some((p9) => p9.registry_url !== "");
+    if (hasRegistry) {
+      cliContext.logger.info(
+        `Published ${result.previews.length} preview package${result.previews.length > 1 ? "s" : ""}:`
+      );
+      for (const preview of result.previews) {
+        cliContext.logger.info("");
+        cliContext.logger.info(`  ${preview.package_name}@${preview.version}`);
+        cliContext.logger.info(`  Install: ${preview.install}`);
+        if (preview.diff_url) {
+          cliContext.logger.info(`  Diff: ${preview.diff_url}`);
+        }
+        if (preview.output_path) {
+          cliContext.logger.info(`  Output: ${preview.output_path}`);
+        }
+      }
+    } else {
+      cliContext.logger.info(
+        `Generated ${result.previews.length} preview SDK${result.previews.length > 1 ? "s" : ""}:`
+      );
+      for (const preview of result.previews) {
+        cliContext.logger.info("");
+        cliContext.logger.info(`  ${preview.package_name}@${preview.version}`);
+        if (preview.diff_url) {
+          cliContext.logger.info(`  Diff: ${preview.diff_url}`);
+        }
+        cliContext.logger.info(`  Output: ${preview.output_path}`);
+      }
+    }
+  }
+}
 function addBetaCommand(cli, cliContext) {
   cli.command(
     "beta",

package/package.json

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