@fern-api/generator-cli 0.9.54 → 0.9.56

package/dist/api.js

@@ -10834,7 +10834,7 @@ var ReadmeGenerator = class {
         })
       );
     }
-    if (this.readmeConfig.requirements != null) {
+    if (this.readmeConfig.requirements != null && this.readmeConfig.requirements.length > 0) {
       blocks.push(
         await this.generateRequirements({
           requirements: this.readmeConfig.requirements

package/dist/cli.js

@@ -30446,6 +30446,9 @@ function extractErrorMessage(e) {
   return stringified.length > 0 ? stringified : "Unknown error";
 }
 
+// ../commons/core-utils/lib/fernEnvVars.js
+var FERN_JAVA_SKIP_FORMATTING_ENV_VAR = "FERN_JAVA_SKIP_FORMATTING";
+
 // ../commons/path-utils/lib/convertToOsPath.js
 function convertToOsPath(path5) {
   return path5.replace(/\\/g, "/");
@@ -39242,7 +39245,7 @@ var ReadmeGenerator = class {
         })
       );
     }
-    if (this.readmeConfig.requirements != null) {
+    if (this.readmeConfig.requirements != null && this.readmeConfig.requirements.length > 0) {
       blocks.push(
         await this.generateRequirements({
           requirements: this.readmeConfig.requirements
@@ -43281,7 +43284,9 @@ var GithubStep = class extends BaseStep {
     let isUpdatingExistingPR = false;
     let generationBaseSha;
     let existingPR;
-    if (!this.config.automationMode) {
+    if (this.config.previewMode && this.config.token === "") {
+      this.logger.debug("Preview mode without a GitHub token: skipping lookup of existing PRs");
+    } else if (!this.config.automationMode) {
       existingPR = await findExistingUpdatablePR(octokit, owner, repo, baseBranch, this.logger);
     }
     if (existingPR != null) {
@@ -43349,30 +43354,34 @@ var GithubStep = class extends BaseStep {
       success: true,
       updatedExistingPr: isUpdatingExistingPR
     };
-    if (!this.config.previewMode) {
-      await pushSignedCommit({
-        repository,
-        octokit,
-        owner,
-        repo,
-        branch: prBranch,
-        force: isUpdatingExistingPR,
-        author: resolveCommitAuthor(this.config.token, this.config.author),
-        logger: this.logger
-      });
-      const pushedBranch = await repository.getCurrentBranch();
-      result.branchUrl = `https://${remote}/${owner}/${repo}/tree/${pushedBranch}`;
-      this.logger.info(`Pushed branch: ${result.branchUrl}`);
-      if (generationBaseSha != null) {
-        try {
-          const sanitizedName = this.config.generatorName?.replace(/\//g, "--");
-          const tagName = sanitizedName != null ? `fern-generation-base--${sanitizedName}` : "fern-generation-base";
-          await repository.createAndPushTag(tagName, generationBaseSha);
-          this.logger.debug(`Pushed ${tagName} tag for generation tracking`);
-          result.generationBaseTagSha = generationBaseSha;
-        } catch (error) {
-          this.logger.debug(`Could not push generation tag: ${extractErrorMessage(error)}`);
-        }
+    if (this.config.previewMode) {
+      this.logger.info(
+        `Preview mode: changes committed locally on branch ${prBranch} at ${this.outputDir}; skipping push and pull request. Re-run without --preview to publish.`
+      );
+      return result;
+    }
+    await pushSignedCommit({
+      repository,
+      octokit,
+      owner,
+      repo,
+      branch: prBranch,
+      force: isUpdatingExistingPR,
+      author: resolveCommitAuthor(this.config.token, this.config.author),
+      logger: this.logger
+    });
+    const pushedBranch = await repository.getCurrentBranch();
+    result.branchUrl = `https://${remote}/${owner}/${repo}/tree/${pushedBranch}`;
+    this.logger.info(`Pushed branch: ${result.branchUrl}`);
+    if (generationBaseSha != null) {
+      try {
+        const sanitizedName = this.config.generatorName?.replace(/\//g, "--");
+        const tagName = sanitizedName != null ? `fern-generation-base--${sanitizedName}` : "fern-generation-base";
+        await repository.createAndPushTag(tagName, generationBaseSha);
+        this.logger.debug(`Pushed ${tagName} tag for generation tracking`);
+        result.generationBaseTagSha = generationBaseSha;
+      } catch (error) {
+        this.logger.debug(`Could not push generation tag: ${extractErrorMessage(error)}`);
       }
     }
     const headSha = await repository.getHeadSha();
@@ -43885,6 +43894,28 @@ var ReplayStep = class extends BaseStep {
 // ../cli/generation/local-generation/docker-utils/lib/runDocker.js
 var import_promises18 = require("fs/promises");
 var import_tmp_promise3 = __toESM(require_tmp_promise(), 1);
+
+// ../cli/generation/local-generation/docker-utils/lib/buildContainerEnvVars.js
+var FORWARDED_ENV_VARS = ["FERN_STACK_TRACK", FERN_JAVA_SKIP_FORMATTING_ENV_VAR];
+function buildContainerEnvVars({ envVars, processEnv }) {
+  const forwardedEntries = FORWARDED_ENV_VARS.filter((name) => envVars[name] == null).map((name) => [name, processEnv[name]]).filter((entry) => entry[1] != null && entry[1] !== "");
+  return {
+    envVars: { ...Object.fromEntries(forwardedEntries), ...envVars },
+    forwardedFromHost: forwardedEntries.map(([name]) => name)
+  };
+}
+
+// ../cli/generation/local-generation/docker-utils/lib/runDocker.js
+function logForwardedEnvVars({ logger, containerEnvVars, forwardedFromHost }) {
+  for (const name of forwardedFromHost) {
+    logger.info(`Forwarding ${name}=${containerEnvVars[name]} into the generator container`);
+  }
+  for (const name of FORWARDED_ENV_VARS) {
+    if (!forwardedFromHost.includes(name) && containerEnvVars[name] == null) {
+      logger.debug(`${name} is not set on the host; not forwarding it into the generator container`);
+    }
+  }
+}
 async function pullImage(imageName, runner, signal) {
   await loggingExeca(void 0, runner ?? "docker", ["pull", imageName], {
     all: true,
@@ -43922,7 +43953,12 @@ ${stderr}`);
 }
 async function execInContainer({ logger, containerId, command, runner, envVars = {}, writeLogsToFile = true, reject = true }) {
   const containerRunner = runner ?? "docker";
-  const envArgs = Object.entries(envVars).flatMap(([key, value]) => ["-e", `${key}=${value}`]);
+  const { envVars: containerEnvVars, forwardedFromHost } = buildContainerEnvVars({
+    envVars,
+    processEnv: process.env
+  });
+  logForwardedEnvVars({ logger, containerEnvVars, forwardedFromHost });
+  const envArgs = Object.entries(containerEnvVars).flatMap(([key, value]) => ["-e", `${key}=${value}`]);
   const { stdout, stderr, exitCode } = await loggingExeca(logger, containerRunner, ["exec", "--user", "root", ...envArgs, containerId, ...command], {
     reject: false,
     all: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fern-api/generator-cli",
-  "version": "0.9.54",
+  "version": "0.9.56",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",