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

package/cli.cjs

@@ -363452,9 +363452,9 @@ var require_diff3 = __commonJS({
   }
 });
 
-// ../../../node_modules/.pnpm/@fern-api+replay@0.8.0/node_modules/@fern-api/replay/dist/index.cjs
+// ../../../node_modules/.pnpm/@fern-api+replay@0.9.0/node_modules/@fern-api/replay/dist/index.cjs
 var require_dist11 = __commonJS({
-  "../../../node_modules/.pnpm/@fern-api+replay@0.8.0/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
+  "../../../node_modules/.pnpm/@fern-api+replay@0.9.0/node_modules/@fern-api/replay/dist/index.cjs"(exports2, module4) {
     "use strict";
     var __defProp4 = Object.defineProperty;
     var __getOwnPropDesc4 = Object.getOwnPropertyDescriptor;
@@ -363631,7 +363631,7 @@ var require_dist11 = __commonJS({
       return commit.message.startsWith("[fern-replay]");
     }
     function isRevertCommit(message) {
-      return message.startsWith('Revert "');
+      return /^Revert ".+"$/.test(message);
     }
     function parseRevertedSha(fullBody) {
       const match3 = fullBody.match(/This reverts commit ([0-9a-f]{40})\./);
@@ -363730,6 +363730,15 @@ var require_dist11 = __commonJS({
         this.ensureLoaded();
         this.lock.patches = [];
       }
+      addForgottenHash(hash5) {
+        this.ensureLoaded();
+        if (!this.lock.forgotten_hashes) {
+          this.lock.forgotten_hashes = [];
+        }
+        if (!this.lock.forgotten_hashes.includes(hash5)) {
+          this.lock.forgotten_hashes.push(hash5);
+        }
+      }
       getUnresolvedPatches() {
         this.ensureLoaded();
         return this.lock.patches.filter((p10) => p10.status === "unresolved");
@@ -363824,6 +363833,7 @@ var require_dist11 = __commonJS({
         }
         const commits = this.parseGitLog(log4);
         const newPatches = [];
+        const forgottenHashes = new Set(lock.forgotten_hashes ?? []);
         for (const commit of commits) {
           if (isGenerationCommit(commit)) {
             continue;
@@ -363837,7 +363847,7 @@ var require_dist11 = __commonJS({
           }
           const patchContent = await this.git.formatPatch(commit.sha);
           const contentHash = this.computeContentHash(patchContent);
-          if (lock.patches.find((p10) => p10.content_hash === contentHash)) {
+          if (lock.patches.find((p10) => p10.content_hash === contentHash) || forgottenHashes.has(contentHash)) {
             continue;
           }
           const filesOutput = await this.git.exec(["diff-tree", "--no-commit-id", "--name-only", "-r", commit.sha]);
@@ -363907,6 +363917,9 @@ var require_dist11 = __commonJS({
               revertIndicesToRemove.add(idx);
             }
           }
+          if (!matchedExisting && !matchedNew) {
+            revertIndicesToRemove.add(i11);
+          }
         }
         const filteredPatches = newPatches.filter((_16, i11) => !revertIndicesToRemove.has(i11));
         return { patches: filteredPatches, revertedPatchIds: [...revertedPatchIdSet] };
@@ -363933,7 +363946,7 @@ var require_dist11 = __commonJS({
         if (!diff2.trim()) return { patches: [], revertedPatchIds: [] };
         const contentHash = this.computeContentHash(diff2);
         const lock = this.lockManager.read();
-        if (lock.patches.some((p10) => p10.content_hash === contentHash)) {
+        if (lock.patches.some((p10) => p10.content_hash === contentHash) || (lock.forgotten_hashes ?? []).includes(contentHash)) {
           return { patches: [], revertedPatchIds: [] };
         }
         const headSha = (await this.git.exec(["rev-parse", "HEAD"])).trim();
@@ -363999,6 +364012,32 @@ var require_dist11 = __commonJS({
     var import_node_os15 = require("os");
     var import_node_path210 = require("path");
     var import_minimatch8 = require_commonjs3();
+    function stripConflictMarkers(content5) {
+      const lines = content5.split("\n");
+      const result = [];
+      let inConflict = false;
+      let inOurs = false;
+      for (const line of lines) {
+        if (line.startsWith("<<<<<<< ")) {
+          inConflict = true;
+          inOurs = true;
+          continue;
+        }
+        if (inConflict && line === "=======") {
+          inOurs = false;
+          continue;
+        }
+        if (inConflict && line.startsWith(">>>>>>> ")) {
+          inConflict = false;
+          inOurs = false;
+          continue;
+        }
+        if (!inConflict || inOurs) {
+          result.push(line);
+        }
+      }
+      return result.join("\n");
+    }
     var BINARY_EXTENSIONS2 = /* @__PURE__ */ new Set([
       ".png",
       ".jpg",
@@ -364070,7 +364109,8 @@ var require_dist11 = __commonJS({
       async applyPatches(patches) {
         this.resetAccumulator();
         const results = [];
-        for (const patch5 of patches) {
+        for (let i11 = 0; i11 < patches.length; i11++) {
+          const patch5 = patches[i11];
           if (this.isExcluded(patch5)) {
             results.push({
               patch: patch5,
@@ -364081,6 +364121,33 @@ var require_dist11 = __commonJS({
           }
           const result = await this.applyPatchWithFallback(patch5);
           results.push(result);
+          if (result.status === "conflict" && result.fileResults) {
+            const laterFiles = /* @__PURE__ */ new Set();
+            for (let j16 = i11 + 1; j16 < patches.length; j16++) {
+              for (const f10 of patches[j16].files) {
+                laterFiles.add(f10);
+              }
+            }
+            const resolvedToOriginal = /* @__PURE__ */ new Map();
+            if (result.resolvedFiles) {
+              for (const [orig, resolved] of Object.entries(result.resolvedFiles)) {
+                resolvedToOriginal.set(resolved, orig);
+              }
+            }
+            for (const fileResult of result.fileResults) {
+              if (fileResult.status !== "conflict") continue;
+              const originalPath = resolvedToOriginal.get(fileResult.file) ?? fileResult.file;
+              if (laterFiles.has(fileResult.file) || laterFiles.has(originalPath)) {
+                const filePath = (0, import_node_path210.join)(this.outputDir, fileResult.file);
+                try {
+                  const content5 = await (0, import_promises181.readFile)(filePath, "utf-8");
+                  const stripped = stripConflictMarkers(content5);
+                  await (0, import_promises181.writeFile)(filePath, stripped);
+                } catch {
+                }
+              }
+            }
+          }
         }
         return results;
       }
@@ -364099,7 +364166,7 @@ var require_dist11 = __commonJS({
             const resolvedPath = await this.resolveFilePath(filePath, baseGen.tree_hash, currentTreeHash);
             const base4 = await this.git.showFile(baseGen.tree_hash, filePath);
             const theirs = await this.applyPatchToContent(base4, patch5.patch_content, filePath, tempGit, tempDir2);
-            if (theirs && base4) {
+            if (theirs) {
               this.fileTheirsAccumulator.set(resolvedPath, {
                 content: theirs,
                 baseGeneration: patch5.base_generation
@@ -364231,7 +364298,7 @@ var require_dist11 = __commonJS({
           );
           let useAccumulatorAsMergeBase = false;
           const accumulatorEntry = this.fileTheirsAccumulator.get(resolvedPath);
-          if (!theirs && base4 && accumulatorEntry) {
+          if (!theirs && accumulatorEntry) {
             theirs = await this.applyPatchToContent(
               accumulatorEntry.content,
               patch5.patch_content,
@@ -364290,7 +364357,7 @@ var require_dist11 = __commonJS({
               reason: "missing-content"
             };
           }
-          if (!base4 || !ours) {
+          if (!base4 && !useAccumulatorAsMergeBase || !ours) {
             return {
               file: resolvedPath,
               status: "skipped",
@@ -364298,11 +364365,18 @@ var require_dist11 = __commonJS({
             };
           }
           const mergeBase = useAccumulatorAsMergeBase && accumulatorEntry ? accumulatorEntry.content : base4;
+          if (mergeBase == null) {
+            return {
+              file: resolvedPath,
+              status: "skipped",
+              reason: "missing-content"
+            };
+          }
           const merged = threeWayMerge(mergeBase, ours, effective_theirs);
           const outDir = (0, import_node_path210.dirname)(oursPath);
           await (0, import_promises181.mkdir)(outDir, { recursive: true });
           await (0, import_promises181.writeFile)(oursPath, merged.content);
-          if (effective_theirs && base4) {
+          if (effective_theirs) {
             this.fileTheirsAccumulator.set(resolvedPath, {
               content: effective_theirs,
               baseGeneration: patch5.base_generation
@@ -364541,32 +364615,6 @@ CLI Version: ${options2.cliVersion}`;
     var import_node_path310 = require("path");
     var import_minimatch22 = require_commonjs3();
     init_GitClient();
-    function stripConflictMarkers(content5) {
-      const lines = content5.split("\n");
-      const result = [];
-      let inConflict = false;
-      let inOurs = false;
-      for (const line of lines) {
-        if (line.startsWith("<<<<<<< ")) {
-          inConflict = true;
-          inOurs = true;
-          continue;
-        }
-        if (inConflict && line === "=======") {
-          inOurs = false;
-          continue;
-        }
-        if (inConflict && line.startsWith(">>>>>>> ")) {
-          inConflict = false;
-          inOurs = false;
-          continue;
-        }
-        if (!inConflict || inOurs) {
-          result.push(line);
-        }
-      }
-      return result.join("\n");
-    }
     var ReplayService = class {
       git;
       detector;
@@ -365528,30 +365576,145 @@ CLI Version: ${options2.cliVersion}`;
       return `sha256:${(0, import_node_crypto32.createHash)("sha256").update(normalized).digest("hex")}`;
     }
     var import_minimatch42 = require_commonjs3();
-    function forget(outputDir, filePattern, options2) {
+    function parseDiffStat(patchContent) {
+      let additions = 0;
+      let deletions = 0;
+      let inDiffHunk = false;
+      for (const line of patchContent.split("\n")) {
+        if (line.startsWith("diff --git ")) {
+          inDiffHunk = true;
+          continue;
+        }
+        if (!inDiffHunk) continue;
+        if (line.startsWith("+") && !line.startsWith("+++")) {
+          additions++;
+        } else if (line.startsWith("-") && !line.startsWith("---")) {
+          deletions++;
+        }
+      }
+      return { additions, deletions };
+    }
+    function toMatchedPatch(patch5) {
+      return {
+        id: patch5.id,
+        message: patch5.original_message,
+        files: patch5.files,
+        diffstat: parseDiffStat(patch5.patch_content),
+        ...patch5.status ? { status: patch5.status } : {}
+      };
+    }
+    function matchesPatch(patch5, pattern) {
+      const fileMatch = patch5.files.some(
+        (file4) => file4 === pattern || (0, import_minimatch42.minimatch)(file4, pattern)
+      );
+      if (fileMatch) return true;
+      return patch5.original_message.toLowerCase().includes(pattern.toLowerCase());
+    }
+    function buildWarnings(patches) {
+      const warnings = [];
+      for (const patch5 of patches) {
+        if (patch5.status === "resolving") {
+          warnings.push(
+            `patch ${patch5.id} has conflict markers in these files: ${patch5.files.join(", ")}. Run \`git checkout -- <files>\` to restore the generated versions.`
+          );
+        } else if (patch5.status === "unresolved") {
+          warnings.push(
+            `patch ${patch5.id} had unresolved conflicts (files: ${patch5.files.join(", ")}).`
+          );
+        }
+      }
+      return warnings;
+    }
+    var EMPTY_RESULT = {
+      initialized: false,
+      removed: [],
+      remaining: 0,
+      notFound: false,
+      alreadyForgotten: [],
+      totalPatches: 0,
+      warnings: []
+    };
+    function forget(outputDir, options2) {
       const lockManager = new LockfileManager(outputDir);
       if (!lockManager.exists()) {
-        return { removed: [], notFound: true };
+        return { ...EMPTY_RESULT };
       }
       const lock = lockManager.read();
-      const matchingPatches = lock.patches.filter(
-        (patch5) => patch5.files.some((file4) => file4 === filePattern || (0, import_minimatch42.minimatch)(file4, filePattern))
-      );
-      if (matchingPatches.length === 0) {
-        return { removed: [], notFound: true };
+      const totalPatches = lock.patches.length;
+      if (options2?.all) {
+        const removed = lock.patches.map(toMatchedPatch);
+        const warnings = buildWarnings(lock.patches);
+        if (!options2.dryRun) {
+          for (const patch5 of lock.patches) {
+            lockManager.addForgottenHash(patch5.content_hash);
+          }
+          lockManager.clearPatches();
+          lockManager.save();
+        }
+        return {
+          initialized: true,
+          removed,
+          remaining: 0,
+          notFound: false,
+          alreadyForgotten: [],
+          totalPatches,
+          warnings
+        };
       }
-      const removed = matchingPatches.map((p10) => ({
-        id: p10.id,
-        message: p10.original_message,
-        files: p10.files
-      }));
-      if (!options2?.dryRun) {
-        for (const patch5 of matchingPatches) {
-          lockManager.removePatch(patch5.id);
+      if (options2?.patchIds && options2.patchIds.length > 0) {
+        const removed = [];
+        const alreadyForgotten = [];
+        const patchesToRemove = [];
+        for (const id2 of options2.patchIds) {
+          const patch5 = lock.patches.find((p10) => p10.id === id2);
+          if (patch5) {
+            removed.push(toMatchedPatch(patch5));
+            patchesToRemove.push(patch5);
+          } else {
+            alreadyForgotten.push(id2);
+          }
         }
-        lockManager.save();
+        const warnings = buildWarnings(patchesToRemove);
+        if (!options2.dryRun) {
+          for (const patch5 of patchesToRemove) {
+            lockManager.addForgottenHash(patch5.content_hash);
+            lockManager.removePatch(patch5.id);
+          }
+          lockManager.save();
+        }
+        return {
+          initialized: true,
+          removed,
+          remaining: totalPatches - removed.length,
+          notFound: removed.length === 0 && alreadyForgotten.length > 0,
+          alreadyForgotten,
+          totalPatches,
+          warnings
+        };
       }
-      return { removed, notFound: false };
+      if (options2?.pattern) {
+        const matched = lock.patches.filter((p10) => matchesPatch(p10, options2.pattern)).map(toMatchedPatch);
+        return {
+          initialized: true,
+          removed: [],
+          remaining: totalPatches,
+          notFound: matched.length === 0,
+          alreadyForgotten: [],
+          totalPatches,
+          warnings: [],
+          matched
+        };
+      }
+      return {
+        initialized: true,
+        removed: [],
+        remaining: totalPatches,
+        notFound: totalPatches === 0,
+        alreadyForgotten: [],
+        totalPatches,
+        warnings: [],
+        matched: lock.patches.map(toMatchedPatch)
+      };
     }
     var import_node_fs52 = require("fs");
     function reset2(outputDir, options2) {
@@ -365667,24 +365830,49 @@ CLI Version: ${options2.cliVersion}`;
     function status(outputDir) {
       const lockManager = new LockfileManager(outputDir);
       if (!lockManager.exists()) {
-        return { initialized: false, patches: [], lastGeneration: void 0 };
+        return {
+          initialized: false,
+          generationCount: 0,
+          lastGeneration: void 0,
+          patches: [],
+          unresolvedCount: 0,
+          excludePatterns: []
+        };
       }
       const lock = lockManager.read();
       const patches = lock.patches.map((patch5) => ({
-        sha: patch5.original_commit.slice(0, 7),
-        author: patch5.original_author.split("<")[0]?.trim() ?? "unknown",
+        id: patch5.id,
+        type: patch5.patch_content.includes("new file mode") ? "added" : "modified",
         message: patch5.original_message,
-        files: patch5.files
+        author: patch5.original_author.split("<")[0]?.trim() || "unknown",
+        sha: patch5.original_commit.slice(0, 7),
+        files: patch5.files,
+        fileCount: patch5.files.length,
+        ...patch5.status ? { status: patch5.status } : {}
       }));
+      const unresolvedCount = lock.patches.filter(
+        (p10) => p10.status === "unresolved" || p10.status === "resolving"
+      ).length;
       let lastGeneration;
       const lastGen = lock.generations.find((g19) => g19.commit_sha === lock.current_generation);
       if (lastGen) {
         lastGeneration = {
-          sha: lastGen.commit_sha,
-          timestamp: lastGen.timestamp
+          sha: lastGen.commit_sha.slice(0, 7),
+          timestamp: lastGen.timestamp,
+          cliVersion: lastGen.cli_version,
+          generatorVersions: lastGen.generator_versions
         };
       }
-      return { initialized: true, patches, lastGeneration };
+      const config5 = lockManager.getCustomizationsConfig();
+      const excludePatterns = config5.exclude ?? [];
+      return {
+        initialized: true,
+        generationCount: lock.generations.length,
+        lastGeneration,
+        patches,
+        unresolvedCount,
+        excludePatterns
+      };
     }
   }
 });
@@ -366044,6 +366232,19 @@ var require_pipeline2 = __commonJS({
   }
 });
 
+// ../../generator-cli/lib/replay/replay-forget.js
+var require_replay_forget = __commonJS({
+  "../../generator-cli/lib/replay/replay-forget.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.replayForget = replayForget2;
+    var replay_1 = require_dist11();
+    function replayForget2(params2) {
+      return (0, replay_1.forget)(params2.outputDir, params2.options);
+    }
+  }
+});
+
 // ../../generator-cli/lib/replay/replay-init.js
 var require_replay_init = __commonJS({
   "../../generator-cli/lib/replay/replay-init.js"(exports2) {
@@ -366208,12 +366409,25 @@ var require_replay_resolve = __commonJS({
   }
 });
 
+// ../../generator-cli/lib/replay/replay-status.js
+var require_replay_status = __commonJS({
+  "../../generator-cli/lib/replay/replay-status.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.replayStatus = replayStatus2;
+    var replay_1 = require_dist11();
+    function replayStatus2(params2) {
+      return (0, replay_1.status)(params2.outputDir);
+    }
+  }
+});
+
 // ../../generator-cli/lib/api.js
 var require_api5 = __commonJS({
   "../../generator-cli/lib/api.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.replayRun = exports2.replayResolve = exports2.replayInit = exports2.formatBootstrapSummary = exports2.PostGenerationPipeline = exports2.logReplaySummary = exports2.formatReplayPrBody = exports2.consolePipelineLogger = exports2.githubRelease = exports2.githubPush = exports2.githubPr = exports2.generateReferenceToStream = exports2.generateReference = exports2.generateReadmeToStream = exports2.generateReadme = void 0;
+    exports2.replayStatus = exports2.replayRun = exports2.replayResolve = exports2.replayInit = exports2.formatBootstrapSummary = exports2.replayForget = exports2.PostGenerationPipeline = exports2.logReplaySummary = exports2.formatReplayPrBody = exports2.consolePipelineLogger = exports2.githubRelease = exports2.githubPush = exports2.githubPr = exports2.generateReferenceToStream = exports2.generateReference = exports2.generateReadmeToStream = exports2.generateReadme = void 0;
     var generate_readme_js_1 = require_generate_readme();
     Object.defineProperty(exports2, "generateReadme", { enumerable: true, get: function() {
       return generate_readme_js_1.generateReadme;
@@ -366253,6 +366467,10 @@ var require_api5 = __commonJS({
     Object.defineProperty(exports2, "PostGenerationPipeline", { enumerable: true, get: function() {
       return index_js_1.PostGenerationPipeline;
     } });
+    var replay_forget_js_1 = require_replay_forget();
+    Object.defineProperty(exports2, "replayForget", { enumerable: true, get: function() {
+      return replay_forget_js_1.replayForget;
+    } });
     var replay_init_js_1 = require_replay_init();
     Object.defineProperty(exports2, "formatBootstrapSummary", { enumerable: true, get: function() {
       return replay_init_js_1.formatBootstrapSummary;
@@ -366268,6 +366486,10 @@ var require_api5 = __commonJS({
     Object.defineProperty(exports2, "replayRun", { enumerable: true, get: function() {
       return replay_run_js_1.replayRun;
     } });
+    var replay_status_js_1 = require_replay_status();
+    Object.defineProperty(exports2, "replayStatus", { enumerable: true, get: function() {
+      return replay_status_js_1.replayStatus;
+    } });
   }
 });
 
@@ -588535,7 +588757,7 @@ var RequestBodyConverter = class extends converters_exports.AbstractConverters.A
       contentType
     });
     if (convertedSchema == null) {
-      return void 0;
+      return this.handleSchemalessJsonContent({ contentType, mediaTypeObject });
     }
     const requestBodyTypeShape = convertedSchema.schema?.typeDeclaration.shape;
     if (requestBodyTypeShape?.type === "object") {
@@ -588591,6 +588813,55 @@ var RequestBodyConverter = class extends converters_exports.AbstractConverters.A
       };
     }
   }
+  /**
+   * Handles JSON request bodies that have no schema but DO have native OpenAPI
+   * examples. Creates an unknown-typed reference request body so that examples
+   * are preserved for docs rendering and code snippet generation.
+   */
+  handleSchemalessJsonContent({ contentType, mediaTypeObject }) {
+    const hasExamples = mediaTypeObject.example != null || mediaTypeObject.examples != null && Object.keys(mediaTypeObject.examples).length > 0;
+    if (!hasExamples) {
+      return void 0;
+    }
+    const v2Examples = {
+      userSpecifiedExamples: {},
+      autogeneratedExamples: {}
+    };
+    const examples = this.context.getNamedExamplesFromMediaTypeObject({
+      mediaTypeObject,
+      breadcrumbs: this.breadcrumbs,
+      defaultExampleName: `${[...this.group, this.method].join("_")}_example`
+    });
+    const usedExampleNames = /* @__PURE__ */ new Set();
+    for (const [key2, example] of examples) {
+      const resolvedExample = this.context.resolveExampleWithValue(example);
+      const resolvedExampleObject = this.context.resolveExampleRecursively({
+        example,
+        breadcrumbs: this.breadcrumbs
+      });
+      let exampleName = key2;
+      if (this.context.isExampleWithSummary(resolvedExampleObject)) {
+        const summary = resolvedExampleObject.summary;
+        if (!usedExampleNames.has(summary)) {
+          exampleName = summary;
+        }
+      }
+      usedExampleNames.add(exampleName);
+      if (resolvedExample != null) {
+        v2Examples.userSpecifiedExamples[exampleName] = resolvedExample;
+      }
+    }
+    return {
+      requestBody: HttpRequestBody.reference({
+        contentType,
+        docs: this.description,
+        requestBodyType: TypeReference2.unknown(),
+        v2Examples
+      }),
+      streamRequestBody: void 0,
+      inlinedTypes: {}
+    };
+  }
   handleMultipartContent({ contentType }) {
     const mediaTypeObject = this.mediaType;
     if (mediaTypeObject == null || mediaTypeObject.schema == null) {
@@ -590440,6 +590711,18 @@ var OperationConverter = class _OperationConverter extends AbstractOperationConv
       httpMethod,
       baseUrl
     });
+    if (Object.keys(fernExamples.examples).length === 0 && Object.keys(fernExamples.streamExamples).length === 0) {
+      const nativeExamples = this.synthesizeEndpointExamplesFromNativeRequestBody({
+        httpPath: path97,
+        httpMethod,
+        baseUrl
+      });
+      if (nativeExamples != null) {
+        for (const [name2, example] of Object.entries(nativeExamples)) {
+          fernExamples.examples[name2] = example;
+        }
+      }
+    }
     const endpointLevelSecuritySchemes = new Set(this.operation.security?.flatMap((securityRequirement) => Object.keys(securityRequirement)) ?? []);
     const securityHeaders = this.authSchemeToHeaders(Array.from(endpointLevelSecuritySchemes));
     if (securityHeaders.length > 0) {
@@ -590876,6 +591159,107 @@ var OperationConverter = class _OperationConverter extends AbstractOperationConv
       streamExamples: {}
     };
   }
+  /**
+   * Synthesizes endpoint-level v2Examples from native OpenAPI request body
+   * examples (mediaType.example / mediaType.examples) when no x-fern-examples
+   * or x-code-samples extensions are present.
+   *
+   * This ensures that specs like Close's, which have native examples on
+   * schemaless request bodies, get rendered in docs and code snippets.
+   *
+   * Also extracts native response examples from the operation's successful (2xx)
+   * responses so that the 200 response panel is preserved in docs.
+   */
+  synthesizeEndpointExamplesFromNativeRequestBody({ httpPath, httpMethod, baseUrl }) {
+    if (this.operation.requestBody == null) {
+      return void 0;
+    }
+    const resolvedRequestBody = this.context.resolveMaybeReference({
+      schemaOrReference: this.operation.requestBody,
+      breadcrumbs: [...this.breadcrumbs, "requestBody"]
+    });
+    if (resolvedRequestBody == null) {
+      return void 0;
+    }
+    const responseExample = this.extractNativeResponseExample();
+    const result = {};
+    for (const [, mediaType] of Object.entries(resolvedRequestBody.content)) {
+      if (mediaType.schema != null) {
+        continue;
+      }
+      const namedExamples = this.context.getNamedExamplesFromMediaTypeObject({
+        mediaTypeObject: mediaType,
+        breadcrumbs: [...this.breadcrumbs, "requestBody"],
+        defaultExampleName: "Example"
+      });
+      for (const [name2, example] of namedExamples) {
+        const resolvedValue = this.context.resolveExampleWithValue(example);
+        if (resolvedValue != null) {
+          result[name2] = {
+            displayName: void 0,
+            request: {
+              docs: void 0,
+              endpoint: {
+                method: httpMethod,
+                path: this.buildExamplePath(httpPath, {})
+              },
+              baseUrl: void 0,
+              environment: baseUrl,
+              auth: void 0,
+              pathParameters: {},
+              queryParameters: {},
+              headers: {},
+              requestBody: resolvedValue
+            },
+            response: responseExample,
+            codeSamples: void 0
+          };
+        }
+      }
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  }
+  /**
+   * Extracts the first native example from the operation's successful (2xx) response.
+   * This is used to populate the response body in synthesized endpoint examples
+   * so that the 200 response panel is preserved in docs.
+   */
+  extractNativeResponseExample() {
+    if (this.operation.responses == null) {
+      return void 0;
+    }
+    for (const [statusCode, response] of Object.entries(this.operation.responses)) {
+      const statusCodeNum = parseInt(statusCode);
+      if (isNaN(statusCodeNum) || statusCodeNum < 200 || statusCodeNum >= 300) {
+        continue;
+      }
+      const resolvedResponse = this.context.resolveMaybeReference({
+        schemaOrReference: response,
+        breadcrumbs: [...this.breadcrumbs, "responses", statusCode]
+      });
+      if (resolvedResponse?.content == null) {
+        continue;
+      }
+      for (const [, responseMediaType] of Object.entries(resolvedResponse.content)) {
+        const namedExamples = this.context.getNamedExamplesFromMediaTypeObject({
+          mediaTypeObject: responseMediaType,
+          breadcrumbs: [...this.breadcrumbs, "responses", statusCode],
+          defaultExampleName: "Example"
+        });
+        for (const [, example] of namedExamples) {
+          const resolvedValue = this.context.resolveExampleWithValue(example);
+          if (resolvedValue != null) {
+            return {
+              docs: void 0,
+              statusCode: statusCodeNum,
+              body: api_exports.V2HttpEndpointResponseBody.json(resolvedValue)
+            };
+          }
+        }
+      }
+    }
+    return void 0;
+  }
   convertStreamConditionExamples({ httpPath, httpMethod, baseUrl, fernExamples }) {
     const filteredJsonExamples = fernExamples.filter((example) => !(example.response != null && "stream" in example.response));
     const filteredStreamExamples = fernExamples.filter((example) => example.response != null && "stream" in example.response);
@@ -602754,7 +603138,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.62.2",
+          version: "4.62.3-11-g47af2473afa",
           usingAccessToken: true
         }
       });
@@ -602805,7 +603189,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.62.2",
+        version: "4.62.3-11-g47af2473afa",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -603850,9 +604234,17 @@ function constructAuth0Url({ origin: origin2, auth0Domain: auth0Domain2, auth0Cl
 
 // ../login/lib/auth0-login/resolveSsoConnection.js
 async function resolveSsoConnection({ dashboardBaseUrl, email: email3 }) {
-  const response = await axios_default.post(`${dashboardBaseUrl}/api/sso/resolve`, { email: email3 }, {
-    headers: { "Content-Type": "application/json" }
-  });
+  let response;
+  try {
+    response = await axios_default.post(`${dashboardBaseUrl}/api/sso/resolve`, { email: email3 }, {
+      headers: { "Content-Type": "application/json" }
+    });
+  } catch (error50) {
+    if (axios_default.isAxiosError(error50) && error50.response?.status === 404) {
+      throw new Error(`No SSO connection associated with email: ${email3}`);
+    }
+    throw error50;
+  }
   const responseData = response.data;
   if (typeof responseData !== "object" || responseData == null) {
     throw new Error("Invalid response format from SSO resolve endpoint");
@@ -622184,7 +622576,7 @@ function getClientOptions(options2, getDefaultIntegrationsImpl) {
   const tracesSampleRate = getTracesSampleRate(options2.tracesSampleRate);
   const mergedOptions = {
     ...options2,
-    dsn: options2.dsn ?? "https://84f58b5e457f06999d92f11ce4b79158@o4509504076185600.ingest.us.sentry.io/4511021546602496",
+    dsn: options2.dsn ?? "",
     environment: options2.environment ?? "development",
     sendClientReports: options2.sendClientReports ?? true,
     transport: options2.transport ?? makeNodeTransport,
@@ -626778,7 +627170,7 @@ var TelemetryClient = class {
       usingAccessToken: process.env.FERN_TOKEN != null
     };
     this.posthog = apiKey != null && apiKey.length > 0 && isTelemetryEnabled ? new PostHog(apiKey) : void 0;
-    const sentryDsn = "https://84f58b5e457f06999d92f11ce4b79158@o4509504076185600.ingest.us.sentry.io/4511021546602496";
+    const sentryDsn = "";
     if (sentryDsn != null && sentryDsn.length > 0 && isTelemetryEnabled) {
       const sentryEnvironment = "development";
       if (sentryEnvironment == null || sentryEnvironment.length === 0) {
@@ -752800,8 +753192,8 @@ var V66_TO_V65_MIGRATION = {
     [GeneratorName.SWIFT_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.PHP_MODEL]: "0.1.0-rc.0",
     [GeneratorName.PHP_SDK]: "2.3.2-rc.0",
-    [GeneratorName.RUST_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
-    [GeneratorName.RUST_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR
+    [GeneratorName.RUST_MODEL]: "0.5.0-rc.0",
+    [GeneratorName.RUST_SDK]: "0.32.0-rc.0"
   },
   jsonifyEarlierVersion: (ir15) => IrSerialization_exports.V65.IntermediateRepresentation.jsonOrThrow(ir15, {
     unrecognizedObjectKeys: "passthrough",
@@ -840093,7 +840485,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-11-g47af2473afa";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -851186,7 +851578,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 +851590,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-11-g47af2473afa"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -851856,6 +852248,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 +852432,7 @@ var PreviewCommand = class {
     await this.publishCommand.handle(context3, {
       ...args,
       preview: true,
+      previewId: args.id,
       force: true
     });
   }
@@ -852057,6 +852451,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 +904290,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 +904399,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 +904537,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 +904574,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 +904950,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 +905225,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 +905293,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)"
   }));
 }
 
@@ -923923,7 +924332,7 @@ var SentryClient = class {
   sentry;
   constructor({ release: release2 }) {
     const isTelemetryEnabled = process.env.FERN_DISABLE_TELEMETRY !== "true";
-    const sentryDsn = "https://84f58b5e457f06999d92f11ce4b79158@o4509504076185600.ingest.us.sentry.io/4511021546602496";
+    const sentryDsn = "";
     if (isTelemetryEnabled && sentryDsn != null && sentryDsn.length > 0) {
       const sentryEnvironment = "development";
       if (sentryEnvironment == null || sentryEnvironment.length === 0) {
@@ -924484,7 +924893,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.62.2";
+    return "4.62.3-11-g47af2473afa";
   }
   getCliName() {
     if (false) {
@@ -944292,6 +944701,8 @@ function addReplayCommand(cli, cliContext) {
     builder: (yargs) => {
       addReplayInitCommand(yargs, cliContext);
       addReplayResolveCommand(yargs, cliContext);
+      addReplayStatusCommand(yargs, cliContext);
+      addReplayForgetCommand(yargs, cliContext);
       return yargs;
     },
     handler: () => {
@@ -944338,9 +944749,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) {
@@ -944476,6 +944893,211 @@ Resolve the conflicts in your editor, then run \`fern replay resolve\` again to
     }
   );
 }
+function addReplayStatusCommand(cli, cliContext) {
+  cli.command(
+    "status [directory]",
+    false,
+    // hidden from --help
+    (yargs) => yargs.positional("directory", {
+      type: "string",
+      default: ".",
+      description: "SDK directory containing .fern/replay.lock"
+    }).option("verbose", {
+      type: "boolean",
+      alias: "v",
+      default: false,
+      description: "Show all patches with full details"
+    }),
+    async (argv) => {
+      await cliContext.instrumentPostHogEvent({
+        command: "fern replay status"
+      });
+      const outputDir = resolve5(cwd(), argv.directory ?? ".");
+      try {
+        const result = (0, import_generator_cli2.replayStatus)({ outputDir });
+        if (!result.initialized) {
+          cliContext.logger.info("Replay is not initialized. Run `fern replay init` to get started.");
+          return;
+        }
+        cliContext.logger.info(
+          `Replay: ${result.patches.length} customization(s) tracked, ${result.generationCount} generation(s)`
+        );
+        if (result.lastGeneration) {
+          cliContext.logger.info(
+            `Last generation: ${result.lastGeneration.sha} (${result.lastGeneration.timestamp})`
+          );
+        }
+        if (result.patches.length === 0) {
+          cliContext.logger.info("No customizations tracked.");
+          return;
+        }
+        const patchesToShow = argv.verbose ? result.patches : result.patches.slice(0, 10);
+        for (const patch5 of patchesToShow) {
+          const statusTag = patch5.status ? ` [${patch5.status}]` : "";
+          if (argv.verbose) {
+            cliContext.logger.info(
+              `
+  ${patch5.id} (${patch5.type})${statusTag}
+    ${patch5.message}
+    Author: ${patch5.author} (${patch5.sha})
+    Files (${patch5.fileCount}): ${patch5.files.join(", ")}`
+            );
+          } else {
+            cliContext.logger.info(
+              `  ${patch5.id}: ${patch5.message} (${patch5.fileCount} file(s))${statusTag}`
+            );
+          }
+        }
+        if (!argv.verbose && result.patches.length > 10) {
+          cliContext.logger.info(`  ... and ${result.patches.length - 10} more (use --verbose to see all)`);
+        }
+        if (result.unresolvedCount > 0) {
+          cliContext.logger.warn(
+            `
+${result.unresolvedCount} patch(es) have unresolved conflicts. Run \`fern replay resolve\` to fix.`
+          );
+        }
+        if (result.excludePatterns.length > 0) {
+          cliContext.logger.info(`
+Exclude patterns: ${result.excludePatterns.join(", ")}`);
+        }
+      } catch (error50) {
+        cliContext.failAndThrow(`Failed to get Replay status: ${extractErrorMessage(error50)}`);
+      }
+    }
+  );
+}
+function addReplayForgetCommand(cli, cliContext) {
+  cli.command(
+    "forget [args..]",
+    false,
+    // hidden from --help
+    (yargs) => yargs.positional("args", {
+      type: "string",
+      array: true,
+      description: "Patch IDs (e.g. patch-abc12345) or a search pattern"
+    }).option("dry-run", {
+      type: "boolean",
+      default: false,
+      description: "Show what would be removed without actually removing"
+    }).option("yes", {
+      type: "boolean",
+      alias: "y",
+      default: false,
+      description: "Skip confirmation prompts"
+    }).option("all", {
+      type: "boolean",
+      default: false,
+      description: "Remove all tracked patches"
+    }),
+    async (argv) => {
+      await cliContext.instrumentPostHogEvent({
+        command: "fern replay forget"
+      });
+      const outputDir = resolve5(cwd(), ".");
+      const args = argv.args ?? [];
+      const dryRun = argv.dryRun;
+      try {
+        if (argv.all) {
+          const result2 = (0, import_generator_cli2.replayForget)({ outputDir, options: { all: true, dryRun } });
+          if (!result2.initialized) {
+            cliContext.logger.info("Replay is not initialized. Nothing to forget.");
+            return;
+          }
+          if (result2.removed.length === 0) {
+            cliContext.logger.info("No patches to remove.");
+            return;
+          }
+          if (dryRun) {
+            cliContext.logger.info(`Would remove ${result2.removed.length} patch(es):`);
+          } else {
+            cliContext.logger.info(`Removed ${result2.removed.length} patch(es):`);
+          }
+          for (const patch5 of result2.removed) {
+            cliContext.logger.info(`  ${patch5.id}: ${patch5.message}`);
+          }
+          for (const warning of result2.warnings) {
+            cliContext.logger.warn(warning);
+          }
+          return;
+        }
+        if (args.length > 0 && args.every((a10) => a10.startsWith("patch-"))) {
+          const result2 = (0, import_generator_cli2.replayForget)({ outputDir, options: { patchIds: args, dryRun } });
+          if (!result2.initialized) {
+            cliContext.logger.info("Replay is not initialized. Nothing to forget.");
+            return;
+          }
+          if (result2.removed.length > 0) {
+            const verb = dryRun ? "Would remove" : "Removed";
+            for (const patch5 of result2.removed) {
+              cliContext.logger.info(`${verb}: ${patch5.id} \u2014 ${patch5.message}`);
+            }
+          }
+          for (const id2 of result2.alreadyForgotten) {
+            cliContext.logger.info(`Already forgotten: ${id2}`);
+          }
+          for (const warning of result2.warnings) {
+            cliContext.logger.warn(warning);
+          }
+          return;
+        }
+        const pattern = args.length === 1 ? args[0] : void 0;
+        const result = (0, import_generator_cli2.replayForget)({ outputDir, options: { pattern } });
+        if (!result.initialized) {
+          cliContext.logger.info("Replay is not initialized. Nothing to forget.");
+          return;
+        }
+        const matched = result.matched ?? [];
+        if (matched.length === 0) {
+          if (pattern) {
+            cliContext.logger.info(`No patches matching "${pattern}".`);
+          } else {
+            cliContext.logger.info("No patches tracked.");
+          }
+          return;
+        }
+        cliContext.logger.info(`${matched.length} patch(es) matched:`);
+        for (const patch5 of matched) {
+          const stat6 = `+${patch5.diffstat.additions}/-${patch5.diffstat.deletions}`;
+          cliContext.logger.info(`  ${patch5.id}: ${patch5.message} (${stat6})`);
+        }
+        if (dryRun) {
+          cliContext.logger.info("\nDry run \u2014 no patches removed.");
+          return;
+        }
+        if (!argv.yes) {
+          if (!process.stdout.isTTY) {
+            cliContext.failAndThrow(
+              "Confirmation required. Use --yes to skip confirmation in non-interactive mode."
+            );
+            return;
+          }
+          const readline7 = await import("readline");
+          const rl3 = readline7.createInterface({ input: process.stdin, output: process.stderr });
+          const answer = await new Promise((resolvePrompt) => {
+            rl3.question(`
+Remove ${matched.length} patch(es)? [y/N] `, resolvePrompt);
+          });
+          rl3.close();
+          if (answer.toLowerCase() !== "y") {
+            cliContext.logger.info("Cancelled.");
+            return;
+          }
+        }
+        const patchIds = matched.map((p10) => p10.id);
+        const removeResult = (0, import_generator_cli2.replayForget)({ outputDir, options: { patchIds, dryRun: false } });
+        cliContext.logger.info(
+          `Removed ${removeResult.removed.length} patch(es). ${removeResult.remaining} remaining.`
+        );
+        for (const warning of removeResult.warnings) {
+          cliContext.logger.warn(warning);
+        }
+      } catch (error50) {
+        cliContext.failAndThrow(`Failed to forget patches: ${extractErrorMessage(error50)}`);
+      }
+    }
+  );
+}
 function parseOwnerRepo(githubRepo) {
   const cleaned = githubRepo.replace(/^https?:\/\//, "").replace(/\.git$/, "").replace(/^github\.com\//, "");
   const parts = cleaned.split("/");

package/package.json

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