@fern-api/fern-api-dev 5.88.0 → 5.89.1

package/cli.cjs

@@ -456741,10 +456741,10 @@ var init_heap_js_es5 = __esm({
       };
       HeapAsync2.prototype._applyLimit = function() {
         if (this._limit && this._limit < this.heapArray.length) {
-          var rm21 = this.heapArray.length - this._limit;
-          while (rm21) {
+          var rm22 = this.heapArray.length - this._limit;
+          while (rm22) {
             this.heapArray.pop();
-            --rm21;
+            --rm22;
           }
         }
       };
@@ -457571,10 +457571,10 @@ var init_heap_js_es5 = __esm({
       };
       Heap2.prototype._applyLimit = function() {
         if (this._limit > 0 && this._limit < this.heapArray.length) {
-          var rm21 = this.heapArray.length - this._limit;
-          while (rm21) {
+          var rm22 = this.heapArray.length - this._limit;
+          while (rm22) {
             this.heapArray.pop();
-            --rm21;
+            --rm22;
           }
         }
       };
@@ -694311,7 +694311,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.88.0",
+          version: "5.89.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -694377,7 +694377,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.88.0",
+        version: "5.89.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -875507,7 +875507,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.88.0";
+  const version7 = "5.89.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -908217,7 +908217,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.88.0",
+        cliVersion: "5.89.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -975092,7 +975092,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.88.0"
+    cli_version: "5.89.1"
   };
 }
 function isAutomationMode() {
@@ -975924,7 +975924,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.88.0";
+    return "5.89.1";
   }
   getCliName() {
     if (false) {
@@ -977713,6 +977713,7 @@ init_lib6();
 init_esm19();
 
 // src/commands/generate/packLocalOutput.ts
+init_lib19();
 init_lib4();
 init_lib8();
 init_lib33();
@@ -977734,7 +977735,8 @@ async function packLocalOutputForGroup({
   group,
   context: context3,
   mode = "host",
-  runner
+  runner,
+  packOnly = false
 }) {
   const failures = [];
   for (const generator of group.generators) {
@@ -977751,7 +977753,22 @@ async function packLocalOutputForGroup({
       continue;
     }
     try {
-      await packOutputForLanguage({ language, outputPath, context: context3, mode, runner: runner ?? "docker" });
+      const artifactProduced = await packOutputForLanguage({
+        language,
+        outputPath,
+        context: context3,
+        mode,
+        runner: runner ?? "docker"
+      });
+      if (packOnly) {
+        if (artifactProduced) {
+          await removeEverythingExceptDist({ outputPath, context: context3 });
+        } else {
+          context3.logger.warn(
+            `Keeping generated source for ${generator.name}: no package artifact was produced, so there is nothing to keep in ${PACK_OUTPUT_DIRECTORY}/.`
+          );
+        }
+      }
     } catch (error50) {
       const message = error50 instanceof Error ? error50.message : String(error50);
       context3.logger.error(`Failed to package ${generator.name} output at ${outputPath}: ${message}`);
@@ -977784,13 +977801,13 @@ async function packOutputForLanguage({
       commands.push(["npm", "pack", "--pack-destination", PACK_OUTPUT_DIRECTORY]);
       await run(commands);
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "python": {
       await (0, import_promises168.mkdir)(distDir, { recursive: true });
       await run([["python3", "-m", "pip", "wheel", ".", "--no-deps", "--wheel-dir", PACK_OUTPUT_DIRECTORY]]);
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "java": {
       await (0, import_promises168.mkdir)(distDir, { recursive: true });
@@ -977798,7 +977815,7 @@ async function packOutputForLanguage({
       const libsDir = join8(outputPath, RelativeFilePath2.of("build/libs"));
       await copyMatchingFiles({ fromDir: libsDir, toDir: distDir, extension: ".jar" });
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "csharp": {
       await (0, import_promises168.mkdir)(distDir, { recursive: true });
@@ -977808,7 +977825,7 @@ async function packOutputForLanguage({
       }
       await run([["dotnet", "pack", csproj, "-c", "Release", "-o", PACK_OUTPUT_DIRECTORY]]);
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "ruby": {
       await (0, import_promises168.mkdir)(distDir, { recursive: true });
@@ -977819,13 +977836,13 @@ async function packOutputForLanguage({
       await run([["gem", "build", gemspec]]);
       await moveMatchingFiles({ fromDir: outputPath, toDir: distDir, extension: ".gem" });
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "php": {
       await (0, import_promises168.mkdir)(distDir, { recursive: true });
       await run([["composer", "archive", "--format=zip", `--dir=${PACK_OUTPUT_DIRECTORY}`]]);
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "rust": {
       await (0, import_promises168.mkdir)(distDir, { recursive: true });
@@ -977833,7 +977850,7 @@ async function packOutputForLanguage({
       const packageDir = join8(outputPath, RelativeFilePath2.of("target/package"));
       await copyMatchingFiles({ fromDir: packageDir, toDir: distDir, extension: ".crate" });
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "go": {
       await (0, import_promises168.mkdir)(distDir, { recursive: true });
@@ -977843,13 +977860,13 @@ async function packOutputForLanguage({
         zipPath: join8(distDir, RelativeFilePath2.of(zipName))
       });
       logArtifacts({ distDir, context: context3 });
-      return;
+      return true;
     }
     case "swift":
       context3.logger.warn(
         "Swift SDKs are distributed as source packages (Swift Package Manager), so there is no package artifact to build. Share the output directory itself, or reference it as a local package dependency."
       );
-      return;
+      return false;
     default:
       assertNever(language);
   }
@@ -977913,6 +977930,28 @@ async function zipDirectory({
     zip.outputStream.pipe((0, import_fs41.createWriteStream)(zipPath)).on("close", resolve15).on("error", reject);
   });
 }
+async function removeEverythingExceptDist({
+  outputPath,
+  context: context3
+}) {
+  const preserved = /* @__PURE__ */ new Set([PACK_OUTPUT_DIRECTORY, ".git"]);
+  const fernignorePath = join8(outputPath, RelativeFilePath2.of(FERNIGNORE_FILENAME));
+  if (await doesPathExist(fernignorePath)) {
+    for (const ignorePath of await getFernIgnorePaths({ absolutePathToFernignore: fernignorePath })) {
+      const topLevelSegment = ignorePath.split("/")[0];
+      if (topLevelSegment != null && topLevelSegment.length > 0) {
+        preserved.add(topLevelSegment);
+      }
+    }
+  }
+  for (const entry of await (0, import_promises168.readdir)(outputPath)) {
+    if (preserved.has(entry)) {
+      continue;
+    }
+    await (0, import_promises168.rm)(join8(outputPath, RelativeFilePath2.of(entry)), { recursive: true, force: true });
+  }
+  context3.logger.info(`Removed generated SDK source from ${outputPath}; kept ${[...preserved].join(", ")}.`);
+}
 async function removeDistDirIfEmpty(outputPath) {
   const distDir = join8(outputPath, RelativeFilePath2.of(PACK_OUTPUT_DIRECTORY));
   try {
@@ -978098,7 +978137,8 @@ async function generateWorkspace({
   generateTests,
   automation,
   pack,
-  packMode
+  packMode,
+  packOnly
 }) {
   if (workspace.generatorsConfiguration == null) {
     context3.logger.warn("This workspaces has no generators.yml");
@@ -978214,7 +978254,7 @@ async function generateWorkspace({
           });
         }
         if (pack) {
-          await packLocalOutputForGroup({ group, context: groupContext, mode: packMode, runner });
+          await packLocalOutputForGroup({ group, context: groupContext, mode: packMode, runner, packOnly });
         }
       })
     )
@@ -978593,7 +978633,8 @@ async function generateAPIWorkspaces({
   generateTests,
   automation,
   pack,
-  packMode
+  packMode,
+  packOnly
 }) {
   let token = void 0;
   if (!useLocalDocker) {
@@ -978674,7 +978715,8 @@ async function generateAPIWorkspaces({
           generateTests,
           automation,
           pack,
-          packMode
+          packMode,
+          packOnly
         });
       });
     })
@@ -985493,6 +985535,13 @@ Example: acme-preview-abc123.docs.buildwithfern.com`,
 init_lib26();
 init_lib6();
 init_source();
+function toPreviewDeployments(urls) {
+  return urls.map((item) => ({
+    url: item.basePath != null ? `${item.domain}${item.basePath}` : item.domain,
+    organizationId: item.organizationId,
+    updatedAt: item.updatedAt
+  }));
+}
 async function listDocsPreview({
   cliContext,
   limit,
@@ -985537,12 +985586,7 @@ async function listDocsPreview({
         }
       }
     }
-    const previewUrlPattern = /-preview-[a-f0-9-]+\.docs\.buildwithfern\.com$/;
-    const previewDeployments = listResponse.urls.filter((item) => previewUrlPattern.test(item.domain)).map((item) => ({
-      url: item.basePath != null ? `${item.domain}${item.basePath}` : item.domain,
-      organizationId: item.organizationId,
-      updatedAt: item.updatedAt
-    }));
+    const previewDeployments = toPreviewDeployments(listResponse.urls);
     if (previewDeployments.length === 0) {
       context3.logger.info("No preview deployments found.");
       return;
@@ -992662,14 +992706,18 @@ function addGenerateCommand3(cli, cliContext) {
       boolean: true,
       default: false,
       description: "Generate test files even when generating to a local file system (tests are normally only generated for GitHub output modes)"
-    }).option("pack", {
+    }).option("package", {
       boolean: true,
       default: false,
       description: "After generating to the local file system, build distributable package artifacts (npm tarball, wheel, JAR, NuGet package, gem, etc.) into a fern-dist/ folder inside the output directory."
-    }).option("pack-mode", {
+    }).option("package-mode", {
       choices: ["host", "docker"],
       default: "host",
-      description: "Where --pack runs the packaging toolchain: 'host' uses toolchains installed on this machine; 'docker' runs each toolchain inside an official Docker image (node, python, gradle, dotnet/sdk, ruby, composer, rust) with the output directory mounted, so no local toolchains are needed."
+      description: "Where --package runs the packaging toolchain: 'host' uses toolchains installed on this machine; 'docker' runs each toolchain inside an official Docker image (node, python, gradle, dotnet/sdk, ruby, composer, rust) with the output directory mounted, so no local toolchains are needed."
+    }).option("package-only", {
+      boolean: true,
+      default: false,
+      description: "Like --package, but only the fern-dist/ artifact is kept in the output directory \u2014 the generated SDK source is removed after the package is built."
     }),
     async (argv) => {
       if (argv.api != null && argv.api.length > 0 && argv.docs != null) {
@@ -992745,22 +992793,25 @@ function addGenerateCommand3(cli, cliContext) {
           { code: CliError.Code.ConfigError }
         );
       }
-      if (argv.pack && argv.preview) {
-        return cliContext.failWithoutThrowing("The --pack flag cannot be used with --preview.", void 0, {
+      const shouldPackage = argv.package || argv.packageOnly;
+      if (shouldPackage && argv.preview) {
+        return cliContext.failWithoutThrowing("The --package flag cannot be used with --preview.", void 0, {
           code: CliError.Code.ConfigError
         });
       }
-      if (argv.pack && argv.docs != null) {
+      if (shouldPackage && argv.docs != null) {
         return cliContext.failWithoutThrowing(
-          "The --pack flag can only be used for API generation, not docs generation.",
+          "The --package flag can only be used for API generation, not docs generation.",
           void 0,
           { code: CliError.Code.ConfigError }
         );
       }
-      if (argv.packMode !== "host" && !argv.pack) {
-        return cliContext.failWithoutThrowing("The --pack-mode flag can only be used with --pack.", void 0, {
-          code: CliError.Code.ConfigError
-        });
+      if (argv.packageMode !== "host" && !shouldPackage) {
+        return cliContext.failWithoutThrowing(
+          "The --package-mode flag can only be used with --package.",
+          void 0,
+          { code: CliError.Code.ConfigError }
+        );
       }
       if (argv.output != null && argv.docs != null) {
         return cliContext.failWithoutThrowing(
@@ -992801,8 +992852,9 @@ function addGenerateCommand3(cli, cliContext) {
           requireEnvVars: argv["require-env-vars"],
           skipIfNoDiff: argv["skip-if-no-diff"],
           generateTests: argv["generate-tests"],
-          pack: argv.pack,
-          packMode: argv.packMode
+          pack: shouldPackage,
+          packMode: argv.packageMode,
+          packOnly: argv.packageOnly
         });
       }
       if (argv.docs != null) {
@@ -992865,8 +992917,9 @@ function addGenerateCommand3(cli, cliContext) {
         requireEnvVars: argv["require-env-vars"],
         skipIfNoDiff: argv["skip-if-no-diff"],
         generateTests: argv["generate-tests"],
-        pack: argv.pack,
-        packMode: argv.packMode
+        pack: shouldPackage,
+        packMode: argv.packageMode,
+        packOnly: argv.packageOnly
       });
     }
   );

package/package.json

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