@fern-api/fern-api-dev 5.14.0 → 5.15.0

package/cli.cjs

@@ -310912,6 +310912,8 @@ var require_buildReplayTelemetryProps = __commonJS({
         executed: replay?.executed ?? false,
         flow: replay?.flow ?? null,
         replay_crashed: replay?.replayCrashed === true,
+        auto_bootstrapped: replay?.autoBootstrapped === true,
+        bootstrap_attempted: replay?.bootstrapAttempted === true,
         pipeline_success: pipelineResult.success,
         pipeline_warnings_count: pipelineResult.warnings?.length ?? 0,
         replay_warnings_count: replay?.warnings?.length ?? 0,
@@ -322399,11 +322401,39 @@ var require_replay_run = __commonJS({
     var fs_1 = require("fs");
     var path_1 = require("path");
     var fernignore_1 = require_fernignore();
-    async function replayPrepare(params2) {
+    async function replayPrepare(params2, state) {
       const { outputDir, cliVersion, generatorVersions, stageOnly = false, generatorName, skipApplication, logger: logger4 } = params2;
       const lockfilePath = (0, path_1.join)(outputDir, ".fern", "replay.lock");
+      let autoBootstrapped = false;
+      let bootstrapAttempted = false;
       if (!(0, fs_1.existsSync)(lockfilePath)) {
-        return null;
+        if (process.env.FERN_DISABLE_AUTO_BOOTSTRAP === "true" || process.env.FERN_DISABLE_AUTO_BOOTSTRAP === "1") {
+          return null;
+        }
+        bootstrapAttempted = true;
+        if (state) {
+          state.bootstrapAttempted = true;
+        }
+        try {
+          const bootstrapResult = await (0, replay_1.bootstrap)(outputDir, {
+            fernignoreAction: "skip",
+            force: false,
+            importHistory: false
+          });
+          if (bootstrapResult.generationCommit == null) {
+            return null;
+          }
+          autoBootstrapped = true;
+        } catch (error50) {
+          logger4?.warn("Replay auto-bootstrap failed, continuing without replay: " + String(error50));
+          try {
+            if ((0, fs_1.existsSync)(lockfilePath)) {
+              (0, fs_1.unlinkSync)(lockfilePath);
+            }
+          } catch {
+          }
+          return null;
+        }
       }
       const baseBranchHead = gitRevParse(outputDir, "HEAD");
       let previousGenerationSha = null;
@@ -322477,7 +322507,9 @@ var require_replay_run = __commonJS({
         flow: preparation.flow,
         previousGenerationSha,
         currentGenerationSha: preparation.currentGenerationSha,
-        baseBranchHead
+        baseBranchHead,
+        autoBootstrapped,
+        bootstrapAttempted
       };
     }
     async function replayApply(prepared, params2 = {}) {
@@ -322493,6 +322525,8 @@ var require_replay_run = __commonJS({
           previousGenerationSha: prepared.previousGenerationSha,
           currentGenerationSha: prepared.currentGenerationSha,
           baseBranchHead: prepared.baseBranchHead,
+          autoBootstrapped: prepared.autoBootstrapped,
+          bootstrapAttempted: prepared.bootstrapAttempted,
           failureReason: String(error50)
         };
       }
@@ -322515,13 +322549,16 @@ var require_replay_run = __commonJS({
         fernignoreUpdated,
         previousGenerationSha: prepared.previousGenerationSha,
         currentGenerationSha: prepared.currentGenerationSha,
-        baseBranchHead: resolvedBaseBranchHead
+        baseBranchHead: resolvedBaseBranchHead,
+        autoBootstrapped: prepared.autoBootstrapped,
+        bootstrapAttempted: prepared.bootstrapAttempted
       };
     }
     async function replayRun(params2) {
+      const prepareState = { bootstrapAttempted: false };
       let prepared;
       try {
-        prepared = await replayPrepare(params2);
+        prepared = await replayPrepare(params2, prepareState);
       } catch (error50) {
         return {
           report: null,
@@ -322529,6 +322566,8 @@ var require_replay_run = __commonJS({
           previousGenerationSha: null,
           currentGenerationSha: null,
           baseBranchHead: null,
+          autoBootstrapped: false,
+          bootstrapAttempted: prepareState.bootstrapAttempted,
           failureReason: error50 instanceof ReplayPrepareError ? error50.reason : String(error50)
         };
       }
@@ -322538,7 +322577,9 @@ var require_replay_run = __commonJS({
           fernignoreUpdated: false,
           previousGenerationSha: null,
           currentGenerationSha: null,
-          baseBranchHead: null
+          baseBranchHead: null,
+          autoBootstrapped: false,
+          bootstrapAttempted: prepareState.bootstrapAttempted
         };
       }
       return replayApply(prepared, { stageOnly: params2.stageOnly, logger: params2.logger });
@@ -322630,6 +322671,7 @@ var require_GenerationCommitStep = __commonJS({
       }
       async execute(_context) {
         const headBeforePrepare = tryRevParse(this.outputDir, "HEAD");
+        const prepareState = { bootstrapAttempted: false };
         let prepared;
         try {
           prepared = await (0, replay_run_1.replayPrepare)({
@@ -322639,7 +322681,7 @@ var require_GenerationCommitStep = __commonJS({
             generatorName: this.generatorName,
             skipApplication: this.config.skipApplication,
             logger: this.logger
-          });
+          }, prepareState);
         } catch (error50) {
           const reason = error50 instanceof replay_run_1.ReplayPrepareError ? error50.reason : String(error50);
           if (headBeforePrepare != null) {
@@ -322655,14 +322697,16 @@ var require_GenerationCommitStep = __commonJS({
             executed: true,
             success: true,
             errorMessage: reason,
-            preparedReplay: null
+            preparedReplay: null,
+            bootstrapAttempted: prepareState.bootstrapAttempted
           };
         }
         if (prepared == null) {
           return {
             executed: true,
             success: true,
-            preparedReplay: null
+            preparedReplay: null,
+            bootstrapAttempted: prepareState.bootstrapAttempted
           };
         }
         return {
@@ -322672,7 +322716,8 @@ var require_GenerationCommitStep = __commonJS({
           previousGenerationSha: prepared.previousGenerationSha ?? void 0,
           currentGenerationSha: prepared.currentGenerationSha,
           baseBranchHead: prepared.baseBranchHead ?? void 0,
-          flow: prepared.flow
+          flow: prepared.flow,
+          bootstrapAttempted: prepareState.bootstrapAttempted
         };
       }
     };
@@ -327338,6 +327383,8 @@ var require_ReplayStep = __commonJS({
             success: true,
             replayCrashed: true,
             errorMessage: generationCommit.errorMessage,
+            autoBootstrapped: false,
+            bootstrapAttempted: generationCommit.bootstrapAttempted === true,
             flow: "normal-regeneration",
             patchesDetected: 0,
             patchesApplied: 0,
@@ -327348,6 +327395,8 @@ var require_ReplayStep = __commonJS({
           return {
             executed: true,
             success: true,
+            autoBootstrapped: false,
+            bootstrapAttempted: generationCommit.bootstrapAttempted === true,
             flow: "first-generation",
             patchesDetected: 0,
             patchesApplied: 0,
@@ -327375,6 +327424,8 @@ var require_ReplayStep = __commonJS({
             previousGenerationSha: result.previousGenerationSha ?? void 0,
             currentGenerationSha: result.currentGenerationSha ?? void 0,
             baseBranchHead: result.baseBranchHead ?? void 0,
+            autoBootstrapped: result.autoBootstrapped,
+            bootstrapAttempted: result.bootstrapAttempted,
             flow: "normal-regeneration",
             patchesDetected: 0,
             patchesApplied: 0,
@@ -327388,6 +327439,8 @@ var require_ReplayStep = __commonJS({
             previousGenerationSha: result.previousGenerationSha ?? void 0,
             currentGenerationSha: result.currentGenerationSha ?? void 0,
             baseBranchHead: result.baseBranchHead ?? void 0,
+            autoBootstrapped: result.autoBootstrapped,
+            bootstrapAttempted: result.bootstrapAttempted,
             flow: "first-generation",
             patchesDetected: 0,
             patchesApplied: 0,
@@ -327401,6 +327454,8 @@ var require_ReplayStep = __commonJS({
           previousGenerationSha: result.previousGenerationSha ?? void 0,
           currentGenerationSha: result.currentGenerationSha ?? void 0,
           baseBranchHead: result.baseBranchHead ?? void 0,
+          autoBootstrapped: result.autoBootstrapped,
+          bootstrapAttempted: result.bootstrapAttempted,
           flow: report.flow,
           patchesDetected: report.patchesDetected,
           patchesApplied: report.patchesApplied,
@@ -490139,7 +490194,8 @@ var EndpointSnippetRequest = schemas_exports3.objectWithoutOptionalProperties({
 // ../../ir-sdk/lib/sdk/serialization/resources/dynamic/resources/endpoints/types/EndpointExample.js
 var EndpointExample = schemas_exports3.objectWithoutOptionalProperties({
   id: schemas_exports3.string(),
-  name: schemas_exports3.string().optional()
+  name: schemas_exports3.string().optional(),
+  isUserSpecified: schemas_exports3.boolean().optional()
 }).extend(EndpointSnippetRequest);
 
 // ../../ir-sdk/lib/sdk/serialization/resources/dynamic/resources/endpoints/types/FileUploadRequestBodyProperty.js
@@ -563177,59 +563233,6 @@ function convertTransportToEncoding(transport, service) {
 init_lib4();
 var import_url_join8 = __toESM(require_url_join(), 1);
 
-// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/regex.js
-var regex_default = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/i;
-
-// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/validate.js
-function validate2(uuid3) {
-  return typeof uuid3 === "string" && regex_default.test(uuid3);
-}
-var validate_default = validate2;
-
-// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/stringify.js
-var byteToHex = [];
-for (let i9 = 0; i9 < 256; ++i9) {
-  byteToHex.push((i9 + 256).toString(16).slice(1));
-}
-function unsafeStringify(arr, offset2 = 0) {
-  return (byteToHex[arr[offset2 + 0]] + byteToHex[arr[offset2 + 1]] + byteToHex[arr[offset2 + 2]] + byteToHex[arr[offset2 + 3]] + "-" + byteToHex[arr[offset2 + 4]] + byteToHex[arr[offset2 + 5]] + "-" + byteToHex[arr[offset2 + 6]] + byteToHex[arr[offset2 + 7]] + "-" + byteToHex[arr[offset2 + 8]] + byteToHex[arr[offset2 + 9]] + "-" + byteToHex[arr[offset2 + 10]] + byteToHex[arr[offset2 + 11]] + byteToHex[arr[offset2 + 12]] + byteToHex[arr[offset2 + 13]] + byteToHex[arr[offset2 + 14]] + byteToHex[arr[offset2 + 15]]).toLowerCase();
-}
-
-// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/rng.js
-var rnds8 = new Uint8Array(16);
-function rng() {
-  return crypto.getRandomValues(rnds8);
-}
-
-// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/v4.js
-function v42(options2, buf, offset2) {
-  if (!buf && !options2 && crypto.randomUUID) {
-    return crypto.randomUUID();
-  }
-  return _v4(options2, buf, offset2);
-}
-function _v4(options2, buf, offset2) {
-  options2 = options2 || {};
-  const rnds = options2.random ?? options2.rng?.() ?? rng();
-  if (rnds.length < 16) {
-    throw new Error("Random bytes length must be >= 16");
-  }
-  rnds[6] = rnds[6] & 15 | 64;
-  rnds[8] = rnds[8] & 63 | 128;
-  if (buf) {
-    offset2 = offset2 || 0;
-    if (offset2 < 0 || offset2 + 16 > buf.length) {
-      throw new RangeError(`UUID byte range ${offset2}:${offset2 + 15} is out of buffer bounds`);
-    }
-    for (let i9 = 0; i9 < 16; ++i9) {
-      buf[offset2 + i9] = rnds[i9];
-    }
-    return buf;
-  }
-  return unsafeStringify(rnds);
-}
-var v4_default = v42;
-
 // ../generation/ir-generator/lib/dynamic-snippets/version.js
 var Version = "1.0.0";
 
@@ -563931,7 +563934,11 @@ var DynamicSnippetsConverter = class {
   }
   getEndpointSnippetRequests({ endpoint: endpoint3, location: location2 }) {
     const requests3 = [];
-    for (const example of [...endpoint3.userSpecifiedExamples, ...endpoint3.autogeneratedExamples]) {
+    const tagged = [
+      ...endpoint3.userSpecifiedExamples.map((example, index3) => ({ example, isUserSpecified: true, index: index3 })),
+      ...endpoint3.autogeneratedExamples.map((example, index3) => ({ example, isUserSpecified: false, index: index3 }))
+    ];
+    for (const { example, isUserSpecified, index: index3 } of tagged) {
       const variableReferencedParams = /* @__PURE__ */ new Set();
       [...this.ir.pathParameters, ...endpoint3.pathParameters].forEach((param) => {
         if (param.variable != null) {
@@ -563943,9 +563950,11 @@ var DynamicSnippetsConverter = class {
         ...example.example?.servicePathParameters ?? [],
         ...example.example?.endpointPathParameters ?? []
       ].filter((param) => !variableReferencedParams.has(getOriginalName(param.name)));
+      const fallbackId = `${endpoint3.id}-${isUserSpecified ? "user" : "auto"}-${index3}`;
       requests3.push({
-        id: example?.example?.id ?? v4_default(),
+        id: example?.example?.id ?? fallbackId,
         name: example?.example?.name != null ? getOriginalName(example.example.name) : void 0,
+        isUserSpecified,
         endpoint: location2,
         baseUrl: void 0,
         environment: void 0,
@@ -613708,6 +613717,59 @@ var OpenRPCConverterContext3_1 = class extends AbstractConverterContext {
 var import_promises39 = require("fs/promises");
 init_js_yaml();
 
+// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/regex.js
+var regex_default = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/i;
+
+// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/validate.js
+function validate2(uuid3) {
+  return typeof uuid3 === "string" && regex_default.test(uuid3);
+}
+var validate_default = validate2;
+
+// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/stringify.js
+var byteToHex = [];
+for (let i9 = 0; i9 < 256; ++i9) {
+  byteToHex.push((i9 + 256).toString(16).slice(1));
+}
+function unsafeStringify(arr, offset2 = 0) {
+  return (byteToHex[arr[offset2 + 0]] + byteToHex[arr[offset2 + 1]] + byteToHex[arr[offset2 + 2]] + byteToHex[arr[offset2 + 3]] + "-" + byteToHex[arr[offset2 + 4]] + byteToHex[arr[offset2 + 5]] + "-" + byteToHex[arr[offset2 + 6]] + byteToHex[arr[offset2 + 7]] + "-" + byteToHex[arr[offset2 + 8]] + byteToHex[arr[offset2 + 9]] + "-" + byteToHex[arr[offset2 + 10]] + byteToHex[arr[offset2 + 11]] + byteToHex[arr[offset2 + 12]] + byteToHex[arr[offset2 + 13]] + byteToHex[arr[offset2 + 14]] + byteToHex[arr[offset2 + 15]]).toLowerCase();
+}
+
+// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/rng.js
+var rnds8 = new Uint8Array(16);
+function rng() {
+  return crypto.getRandomValues(rnds8);
+}
+
+// ../../../node_modules/.pnpm/uuid@14.0.0/node_modules/uuid/dist-node/v4.js
+function v42(options2, buf, offset2) {
+  if (!buf && !options2 && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return _v4(options2, buf, offset2);
+}
+function _v4(options2, buf, offset2) {
+  options2 = options2 || {};
+  const rnds = options2.random ?? options2.rng?.() ?? rng();
+  if (rnds.length < 16) {
+    throw new Error("Random bytes length must be >= 16");
+  }
+  rnds[6] = rnds[6] & 15 | 64;
+  rnds[8] = rnds[8] & 63 | 128;
+  if (buf) {
+    offset2 = offset2 || 0;
+    if (offset2 < 0 || offset2 + 16 > buf.length) {
+      throw new RangeError(`UUID byte range ${offset2}:${offset2 + 15} is out of buffer bounds`);
+    }
+    for (let i9 = 0; i9 < 16; ++i9) {
+      buf[offset2 + i9] = rnds[i9];
+    }
+    return buf;
+  }
+  return unsafeStringify(rnds);
+}
+var v4_default = v42;
+
 // ../workspace/lazy-fern-workspace/lib/utils/loadOpenRpc.js
 var import_promises32 = require("fs/promises");
 init_js_yaml();
@@ -623471,7 +623533,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.14.0",
+          version: "5.15.0",
           usingAccessToken: true
         }
       });
@@ -623525,7 +623587,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.14.0",
+        version: "5.15.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -848513,7 +848575,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.14.0";
+  const version7 = "5.15.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -861312,7 +861374,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.14.0",
+        cliVersion: "5.15.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -935833,7 +935895,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.14.0";
+    return "5.15.0";
   }
   getCliName() {
     if (false) {

package/package.json

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