@fern-api/fern-api-dev 4.62.2 → 4.62.3

package/cli.cjs

@@ -602754,7 +602754,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.62.2",
+          version: "4.62.3",
           usingAccessToken: true
         }
       });
@@ -602805,7 +602805,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.62.2",
+        version: "4.62.3",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -840093,7 +840093,7 @@ var import_path54 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "4.62.2";
+  const version7 = "4.62.3";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -851186,7 +851186,7 @@ var LegacyDocsPublisher = class {
   /**
    * Publish the docs workspace to the given instance.
    */
-  async publish({ instanceUrl, preview, skipUpload }) {
+  async publish({ instanceUrl, preview, previewId, skipUpload }) {
     const taskContext = new TaskContextAdapter({ context: this.context, task: this.task });
     try {
       const url3 = await runRemoteGenerationForDocsWorkspace({
@@ -851198,10 +851198,10 @@ var LegacyDocsPublisher = class {
         token: this.token,
         instanceUrl,
         preview,
-        previewId: void 0,
+        previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.62.2"
+        cliVersion: "4.62.3"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -851856,6 +851856,7 @@ var PublishCommand = class {
       const result = await publisher.publish({
         instanceUrl,
         preview: args.preview,
+        previewId: args.previewId,
         skipUpload: args["skip-upload"] || void 0
       });
       if (!result.success) {
@@ -852039,6 +852040,7 @@ var PreviewCommand = class {
     await this.publishCommand.handle(context3, {
       ...args,
       preview: true,
+      previewId: args.id,
       force: true
     });
   }
@@ -852057,6 +852059,9 @@ function addPreviewCommand(cli) {
     type: "boolean",
     default: false,
     description: "Treat all validation warnings as errors"
+  }).option("id", {
+    type: "string",
+    description: "A stable identifier for the preview. Reusing the same ID overwrites the previous preview, keeping the URL stable."
   }).option("skip-upload", {
     type: "boolean",
     default: false,
@@ -903893,7 +903898,8 @@ var LegacyLocalGenerationRunner = class {
       absolutePathToPreview: void 0,
       inspect: false,
       ai: void 0,
-      skipFernignore: args.skipFernignore
+      skipFernignore: args.skipFernignore,
+      requireEnvVars: args.requireEnvVars
     });
     if (taskContext.getResult() === TaskResult.Failure) {
       return {
@@ -904001,7 +904007,7 @@ var LegacyRemoteGenerationRunner = class {
         whitelabel: void 0,
         dynamicIrOnly: false,
         retryRateLimited: false,
-        requireEnvVars: true
+        requireEnvVars: args.requireEnvVars ?? true
       });
       if (this.isLocalGitCombo(args) && absolutePathToPreview != null) {
         const generatorName = basename2(generatorInvocation.name);
@@ -904139,7 +904145,8 @@ var GeneratorPipeline = class {
       outputPath: args.outputPath,
       containerEngine: args.containerEngine,
       token: args.token,
-      skipFernignore: args.skipFernignore
+      skipFernignore: args.skipFernignore,
+      requireEnvVars: args.requireEnvVars
     });
     if (!result.success) {
       return {
@@ -904175,7 +904182,8 @@ var GeneratorPipeline = class {
       preview: args.preview,
       outputPath: args.outputPath,
       fernignorePath: args.fernignorePath,
-      skipFernignore: args.skipFernignore
+      skipFernignore: args.skipFernignore,
+      requireEnvVars: args.requireEnvVars
     });
     if (!result.success) {
       return {
@@ -904550,7 +904558,8 @@ var GenerateCommand = class {
         token,
         version: args["output-version"],
         fernignorePath: args.fernignore,
-        skipFernignore: args["skip-fernignore"]
+        skipFernignore: args["skip-fernignore"],
+        requireEnvVars: args["require-env-vars"]
       });
       if (!pipelineResult.success) {
         task.stage.generator.fail(pipelineResult.error);
@@ -904824,6 +904833,10 @@ function addGenerateCommand(cli) {
     type: "boolean",
     default: false,
     description: "Skip the .fernignore file and generate all files. For remote generation, uploads an empty .fernignore. For local generation, skips reading .fernignore from the output directory."
+  }).option("require-env-vars", {
+    type: "boolean",
+    default: true,
+    description: "Require all referenced environment variables to be defined (use --no-require-env-vars to substitute empty strings for missing variables)"
   }));
 }
 
@@ -904888,6 +904901,10 @@ function addPreviewCommand2(cli) {
     type: "string",
     description: "Path to .fernignore file",
     hidden: true
+  }).option("require-env-vars", {
+    type: "boolean",
+    default: true,
+    description: "Require all referenced environment variables to be defined (use --no-require-env-vars to substitute empty strings for missing variables)"
   }));
 }
 
@@ -924484,7 +924501,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.62.2";
+    return "4.62.3";
   }
   getCliName() {
     if (false) {
@@ -944338,9 +944355,15 @@ function addReplayInitCommand(cli, cliContext) {
         githubRepo = githubRepo ?? resolved.githubRepo;
         token = token ?? resolved.token;
       }
-      if (githubRepo == null || token == null) {
-        const hint = githubRepo != null ? "Repository found but no token. Pass --token or set GITHUB_TOKEN environment variable." : "Either use --group to read from generators.yml, or provide --github and --token directly.";
-        return cliContext.failAndThrow(`Missing required github config. ${hint}`);
+      if (githubRepo == null) {
+        return cliContext.failAndThrow(
+          "Missing required github config. Either use --group to read from generators.yml, or provide --github directly."
+        );
+      }
+      if (token == null) {
+        cliContext.logger.warn(
+          "No GitHub token found. Clone may fail for private repos. Set GITHUB_TOKEN or pass --token."
+        );
       }
       cliContext.logger.info(`Initializing Replay for: ${githubRepo}`);
       if (argv.dryRun) {

package/package.json

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