@fern-api/fern-api-dev 5.20.1 → 5.21.0-3-g6ffb37058a9

package/cli.cjs

@@ -519482,7 +519482,8 @@ var StreamFormat2 = schemas_exports.enum_(["sse", "json"]);
 var HttpResponseStreamSchemaDetailed = schemas_exports.object({
   type: schemas_exports.string(),
   format: StreamFormat2.optional(),
-  terminator: schemas_exports.string().optional()
+  terminator: schemas_exports.string().optional(),
+  resumable: schemas_exports.boolean().optional()
 }).extend(WithDocsSchema);
 
 // ../fern-definition/schema/lib/schemas/serialization/resources/service/types/HttpResponseStreamSchema.js
@@ -529682,7 +529683,8 @@ var JsonStreamChunk = schemas_exports3.objectWithoutOptionalProperties({
 // ../../ir-sdk/lib/sdk/serialization/resources/http/types/SseStreamChunk.js
 var SseStreamChunk = schemas_exports3.objectWithoutOptionalProperties({
   payload: schemas_exports3.lazy(() => TypeReference3),
-  terminator: schemas_exports3.string().optional()
+  terminator: schemas_exports3.string().optional(),
+  resumable: schemas_exports3.boolean().optional()
 }).extend(WithDocs).extend(WithV2Examples);
 
 // ../../ir-sdk/lib/sdk/serialization/resources/http/types/TextStreamChunk.js
@@ -560869,7 +560871,8 @@ var FileResponse = schemas_exports9.objectWithoutOptionalProperties({}).extend(W
 var JsonResponse3 = schemas_exports9.objectWithoutOptionalProperties({
   schema: schemas_exports9.lazy(() => Schema2),
   responseProperty: schemas_exports9.string().optional(),
-  terminator: schemas_exports9.string().optional()
+  terminator: schemas_exports9.string().optional(),
+  resumable: schemas_exports9.boolean().optional()
 }).extend(WithDescription).extend(WithSource).extend(WithStatusCode);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/TextResponse.js
@@ -561568,7 +561571,8 @@ var JsonResponseWithExample = schemas_exports9.objectWithoutOptionalProperties({
   schema: schemas_exports9.lazy(() => SchemaWithExample2),
   responseProperty: schemas_exports9.string().optional(),
   terminator: schemas_exports9.string().optional(),
-  fullExamples: schemas_exports9.list(NamedFullExample).optional()
+  fullExamples: schemas_exports9.list(NamedFullExample).optional(),
+  resumable: schemas_exports9.boolean().optional()
 }).extend(WithDescription).extend(WithSource).extend(WithStatusCode);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/parseIr/types/ResponseWithExample.js
@@ -565894,7 +565898,8 @@ function buildEndpoint({ endpoint: endpoint3, declarationFile, context: context3
           docs: jsonResponse.description ?? void 0,
           type: getTypeFromTypeReference(responseTypeReference),
           format: "sse",
-          terminator: jsonResponse.terminator ?? void 0
+          terminator: jsonResponse.terminator ?? void 0,
+          resumable: jsonResponse.resumable ?? void 0
         };
       },
       file: (fileResponse) => {
@@ -568195,7 +568200,8 @@ var XFernStreaming = {
   properties: {
     "stream-condition": { type: "string" },
     response: "Schema",
-    "response-stream": "Schema"
+    "response-stream": "Schema",
+    resumable: { type: "boolean" }
   },
   required: ["stream-condition", "response", "response-stream"],
   extensionsPrefix: "x-"
@@ -568341,6 +568347,22 @@ var FernOpenAPIExtension = {
    *           $ref: ./path/to/response/type.yaml
    *         response-stream:
    *           $ref: ./path/to/response-stream/type.yaml
+   *
+   * For SSE endpoints, `resumable: true` opts the endpoint into
+   * client-side reconnection using `Last-Event-ID` / `retry:`. The
+   * default is `false`. The flag is inheritable: setting
+   * `x-fern-streaming.resumable: true` at the document level applies
+   * to all SSE endpoints unless an operation overrides it explicitly.
+   *
+   * Example usage:
+   *   x-fern-streaming:
+   *     resumable: true
+   *
+   *   paths:
+   *     /path/to/my/endpoint:
+   *       x-fern-streaming:
+   *         format: sse
+   *         resumable: false # overrides the document default
    */
   STREAMING: "x-fern-streaming",
   /**
@@ -576158,7 +576180,7 @@ function getFernAsyncExtension(operation) {
 
 // ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/extensions/getFernStreamingExtension.js
 var REQUEST_PREFIX = "$request.";
-function getFernStreamingExtension(operation) {
+function getFernStreamingExtension(document4, operation) {
   const streaming = getExtension(operation, FernOpenAPIExtension.STREAMING);
   if (streaming == null) {
     return void 0;
@@ -576167,28 +576189,44 @@ function getFernStreamingExtension(operation) {
     return streaming ? {
       type: "stream",
       format: "json",
-      terminator: void 0
+      terminator: void 0,
+      resumable: false
     } : void 0;
   }
+  const resumable = resolveResumable(document4, streaming);
   if (streaming["stream-condition"] == null && streaming.format != null) {
     return {
       type: "stream",
       format: streaming.format,
-      terminator: streaming.terminator
+      terminator: streaming.terminator,
+      resumable
     };
   }
   return {
     type: "streamCondition",
     format: streaming.format ?? "json",
-    // Default to "json"
     terminator: streaming.terminator,
     streamDescription: streaming["stream-description"],
     streamConditionProperty: maybeTrimRequestPrefix(streaming["stream-condition"]),
     streamRequestName: streaming["stream-request-name"],
     responseStream: streaming["response-stream"],
-    response: streaming.response
+    response: streaming.response,
+    resumable
   };
 }
+function resolveResumable(document4, streaming) {
+  if (typeof streaming.resumable === "boolean") {
+    return streaming.resumable;
+  }
+  return getDocumentLevelResumable(document4) ?? false;
+}
+function getDocumentLevelResumable(document4) {
+  const docStreaming = getExtension(document4, FernOpenAPIExtension.STREAMING);
+  if (docStreaming == null || typeof docStreaming === "boolean") {
+    return void 0;
+  }
+  return typeof docStreaming.resumable === "boolean" ? docStreaming.resumable : void 0;
+}
 function maybeTrimRequestPrefix(streamCondition) {
   if (streamCondition.startsWith(REQUEST_PREFIX)) {
     return streamCondition.slice(REQUEST_PREFIX.length);
@@ -577553,7 +577591,7 @@ var ERROR_NAMES = new Set(Object.values(ERROR_NAMES_BY_STATUS_CODE));
 
 // ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/converters/endpoint/convertResponse.js
 var SUCCESSFUL_STATUS_CODES = ["200", "201", "202", "204"];
-function convertResponse({ operationContext, responses, context: context3, responseBreadcrumbs, responseStatusCode, streamFormat, streamTerminator, source: source2 }) {
+function convertResponse({ operationContext, responses, context: context3, responseBreadcrumbs, responseStatusCode, streamFormat, streamTerminator, streamResumable, source: source2 }) {
   if (responses == null) {
     return { value: void 0, errors: {} };
   }
@@ -577576,6 +577614,7 @@ function convertResponse({ operationContext, responses, context: context3, respo
         responseBreadcrumbs,
         streamFormat,
         streamTerminator,
+        streamResumable,
         source: source2,
         namespace: context3.namespace,
         statusCode: statusCodeNum
@@ -577623,6 +577662,7 @@ function convertResponse({ operationContext, responses, context: context3, respo
       responseBreadcrumbs,
       streamFormat,
       streamTerminator,
+      streamResumable,
       source: source2,
       namespace: context3.namespace
     });
@@ -577657,7 +577697,7 @@ function convertResponse({ operationContext, responses, context: context3, respo
     errors: errors4
   };
 }
-function convertResolvedResponse({ operationContext, streamFormat, streamTerminator, response, context: context3, responseBreadcrumbs, source: source2, namespace, statusCode }) {
+function convertResolvedResponse({ operationContext, streamFormat, streamTerminator, streamResumable, response, context: context3, responseBreadcrumbs, source: source2, namespace, statusCode }) {
   const resolvedResponse = isReferenceObject(response) ? context3.resolveResponseReference(response) : response;
   if (resolvedResponse.content != null) {
     const binaryContent = Object.entries(resolvedResponse.content).find(([_7, mediaObject]) => {
@@ -577684,6 +577724,7 @@ function convertResolvedResponse({ operationContext, streamFormat, streamTermina
           description: resolvedResponse.description,
           responseProperty: getExtension(operationContext.operation, FernOpenAPIExtension.RESPONSE_PROPERTY),
           terminator: streamTerminator,
+          resumable: void 0,
           fullExamples: textEventStreamObject.examples,
           schema: convertSchema2(textEventStreamObject.schema, false, false, context3, responseBreadcrumbs, source2, namespace),
           source: source2
@@ -577693,6 +577734,7 @@ function convertResolvedResponse({ operationContext, streamFormat, streamTermina
           description: resolvedResponse.description,
           responseProperty: void 0,
           terminator: streamTerminator,
+          resumable: streamResumable,
           fullExamples: textEventStreamObject.examples,
           schema: convertSchema2(textEventStreamObject.schema, false, false, context3, responseBreadcrumbs, source2, namespace),
           source: source2,
@@ -577712,6 +577754,7 @@ function convertResolvedResponse({ operationContext, streamFormat, streamTermina
             description: resolvedResponse.description,
             responseProperty: void 0,
             terminator: streamTerminator,
+            resumable: void 0,
             fullExamples: jsonMediaObject.examples,
             schema: convertSchema2(jsonMediaObject.schema, false, false, context3, responseBreadcrumbs, source2, namespace),
             source: source2,
@@ -577722,6 +577765,7 @@ function convertResolvedResponse({ operationContext, streamFormat, streamTermina
             description: resolvedResponse.description,
             responseProperty: void 0,
             terminator: streamTerminator,
+            resumable: streamResumable,
             fullExamples: jsonMediaObject.examples,
             schema: convertSchema2(jsonMediaObject.schema, false, false, context3, responseBreadcrumbs, source2, namespace),
             source: source2,
@@ -577734,6 +577778,7 @@ function convertResolvedResponse({ operationContext, streamFormat, streamTermina
       schema: convertSchema2(jsonMediaObject.schema, false, false, context3, responseBreadcrumbs, source2, namespace),
       responseProperty: getExtension(operationContext.operation, FernOpenAPIExtension.RESPONSE_PROPERTY),
       terminator: void 0,
+      resumable: void 0,
       fullExamples: jsonMediaObject.examples,
       source: source2,
       statusCode
@@ -577792,7 +577837,7 @@ function markErrorSchemas({ responses, context: context3, source: source2, names
 }
 
 // ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/converters/operation/convertHttpOperation.js
-function convertHttpOperation({ operationContext, context: context3, responseStatusCode, suffix, streamFormat, streamTerminator, source: source2, streamRequestNameOverride }) {
+function convertHttpOperation({ operationContext, context: context3, responseStatusCode, suffix, streamFormat, streamTerminator, streamResumable, source: source2, streamRequestNameOverride }) {
   const { document: document4, operation, path: path107, method: method8, baseBreadcrumbs, pathItem } = operationContext;
   const idempotent = getExtension(operation, FernOpenAPIExtension.IDEMPOTENT);
   const requestNameOverride = getExtension(operation, [
@@ -578004,6 +578049,7 @@ function convertHttpOperation({ operationContext, context: context3, responseSta
     operationContext,
     streamFormat,
     streamTerminator,
+    streamResumable,
     responses: operation.responses,
     context: context3,
     responseBreadcrumbs,
@@ -578189,6 +578235,7 @@ function convertStreamingOperation({ operationContext, context: context3, stream
         context: context3,
         streamFormat: streamingExtension.format,
         streamTerminator: streamingExtension.terminator,
+        streamResumable: streamingExtension.resumable,
         source: context3.source
       });
       return {
@@ -578238,6 +578285,7 @@ function convertStreamingOperation({ operationContext, context: context3, stream
         context: context3,
         streamFormat: streamingExtension.format,
         streamTerminator: streamingExtension.terminator,
+        streamResumable: streamingExtension.resumable,
         suffix: STREAM_SUFFIX,
         source: context3.source,
         streamRequestNameOverride: autoStreamRequestName
@@ -578716,11 +578764,16 @@ function convertOperation({ context: context3, pathItemContext, operation, conve
     });
     return { type: "webhook", value: webhooks2 };
   }
-  let streamingExtension = getFernStreamingExtension(operation);
+  let streamingExtension = getFernStreamingExtension(context3.document, operation);
   if (streamingExtension == null) {
     const hasEventStreamResponse = checkOperationForTextEventStream({ operation, context: context3 });
     if (hasEventStreamResponse) {
-      streamingExtension = { type: "stream", format: "sse", terminator: void 0 };
+      streamingExtension = {
+        type: "stream",
+        format: "sse",
+        terminator: void 0,
+        resumable: getDocumentLevelResumable(context3.document) ?? false
+      };
     }
   }
   if (streamingExtension != null) {
@@ -600122,6 +600175,7 @@ function convertStreamHttpResponseBody({ endpoint: endpoint3, file: file4, typeR
         docs: docs2,
         payload: file4.parseTypeReference(typeReference2),
         terminator: typeof responseStream !== "string" ? responseStream.terminator : void 0,
+        resumable: typeof responseStream !== "string" ? responseStream.resumable : void 0,
         v2Examples: void 0
       });
     } else {
@@ -602885,6 +602939,7 @@ function convertWebhookStreamResponseBody({ responseStream, file: file4, typeRes
       docs: docs2,
       payload: file4.parseTypeReference(typeReference2),
       terminator: typeof responseStream !== "string" ? responseStream.terminator : void 0,
+      resumable: typeof responseStream !== "string" ? responseStream.resumable : void 0,
       v2Examples: void 0
     });
   } else {
@@ -632265,6 +632320,16 @@ var definitions2 = {
             type: "null"
           }
         ]
+      },
+      resumable: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
       }
     },
     required: [
@@ -636499,6 +636564,16 @@ var definitions3 = {
             type: "null"
           }
         ]
+      },
+      resumable: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
       }
     },
     required: [
@@ -648129,14 +648204,17 @@ var StreamingExtensionObjectSchema = external_exports2.object({
   "stream-request-name": external_exports2.string().optional(),
   "response-stream": external_exports2.any(),
   response: external_exports2.any(),
-  terminator: external_exports2.string().optional()
+  terminator: external_exports2.string().optional(),
+  resumable: external_exports2.boolean().optional()
 });
 var StreamingExtensionSchema = external_exports2.union([external_exports2.boolean(), StreamingExtensionObjectSchema]);
 var FernStreamingExtension = class extends AbstractExtension {
+  document;
   operation;
   key = "x-fern-streaming";
-  constructor({ breadcrumbs, operation, context: context3 }) {
+  constructor({ breadcrumbs, document: document4, operation, context: context3 }) {
     super({ breadcrumbs, context: context3 });
+    this.document = document4;
     this.operation = operation;
   }
   convert() {
@@ -648153,10 +648231,11 @@ var FernStreamingExtension = class extends AbstractExtension {
       return void 0;
     }
     if (typeof result.data === "boolean") {
-      return result.data ? { type: "stream", format: "json", terminator: void 0 } : void 0;
+      return result.data ? { type: "stream", format: "json", terminator: void 0, resumable: false } : void 0;
     }
+    const resumable = result.data.resumable ?? getDocumentLevelResumable2(this.document) ?? false;
     if (result.data["stream-condition"] == null && result.data.format != null) {
-      return { type: "stream", format: result.data.format, terminator: result.data.terminator };
+      return { type: "stream", format: result.data.format, terminator: result.data.terminator, resumable };
     }
     if (result.data["stream-condition"] == null) {
       this.context.errorCollector.collect({
@@ -648173,10 +648252,19 @@ var FernStreamingExtension = class extends AbstractExtension {
       streamConditionProperty: AbstractConverterContext.maybeTrimPrefix(result.data["stream-condition"], REQUEST_PREFIX4),
       streamRequestName: result.data["stream-request-name"],
       responseStream: result.data["response-stream"],
-      response: result.data.response
+      response: result.data.response,
+      resumable
     };
   }
 };
+function getDocumentLevelResumable2(document4) {
+  const docStreaming = document4["x-fern-streaming"];
+  if (docStreaming == null || typeof docStreaming === "boolean") {
+    return void 0;
+  }
+  const resumable = docStreaming.resumable;
+  return typeof resumable === "boolean" ? resumable : void 0;
+}
 
 // ../api-importers/openapi-to-ir/lib/extensions/x-fern-webhook.js
 var FernWebhookExtension = class extends AbstractExtension {
@@ -648603,6 +648691,7 @@ var ResponseBodyConverter = class extends converters_exports.AbstractConverters.
             docs: this.responseBody.description,
             payload: convertedSchema.type,
             terminator: this.streamingExtension?.terminator,
+            resumable: this.streamingExtension?.resumable,
             v2Examples: this.convertMediaTypeObjectExamples({
               mediaTypeObject,
               generateOptionalProperties: true,
@@ -649897,6 +649986,7 @@ var PathConverter = class extends AbstractConverter {
       }
       const streamingExtensionConverter = new FernStreamingExtension({
         breadcrumbs: operationBreadcrumbs,
+        document: this.context.spec,
         operation,
         context: this.context
       });
@@ -649904,7 +649994,12 @@ var PathConverter = class extends AbstractConverter {
       if (streamingExtension == null) {
         const hasTextEventStream2 = this.operationHasTextEventStreamResponse(operation);
         if (hasTextEventStream2) {
-          streamingExtension = { type: "stream", format: "sse", terminator: void 0 };
+          streamingExtension = {
+            type: "stream",
+            format: "sse",
+            terminator: void 0,
+            resumable: getDocumentLevelResumable2(this.context.spec) ?? false
+          };
         }
       }
       const convertedEndpoint = this.tryParseAsHttpEndpoint({
@@ -661157,7 +661252,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.20.1",
+          version: "5.21.0-3-g6ffb37058a9",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -661212,7 +661307,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.20.1",
+        version: "5.21.0-3-g6ffb37058a9",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -852485,7 +852580,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.20.1";
+  const version7 = "5.21.0-3-g6ffb37058a9";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -865294,7 +865389,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.20.1",
+        cliVersion: "5.21.0-3-g6ffb37058a9",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -884773,6 +884868,8 @@ var Generation = class {
     extraDependencies: () => this.customConfig["extra-dependencies"] ?? {},
     /** When true, omits Fern platform headers (X-Fern-Language, SDK name/version, User-Agent) from generated SDK requests. Default: false. */
     omitFernHeaders: () => this.customConfig["omit-fern-headers"] ?? false,
+    /** When true, falls back to `<NuGetPackageId>/<version>` for the `User-Agent` header when the IR doesn't supply one. Default: false. */
+    userAgentNameFromPackage: () => this.customConfig["user-agent-name-from-package"] ?? false,
     /** When true, moves auth params and IR headers into ClientOptions so the constructor takes only named arguments. Default: false. */
     unifiedClientOptions: () => this.customConfig["unified-client-options"] ?? false,
     /** When true, uses PascalCase for environment names (e.g., "Production" instead of "production"). Default: true. */
@@ -884785,6 +884882,8 @@ var Generation = class {
     maxRetries: () => this.customConfig.maxRetries,
     /** Controls which HTTP status codes trigger automatic retries. Default: "legacy". */
     retryStatusCodes: () => this.customConfig.retryStatusCodes ?? "legacy",
+    /** Override the default request timeout (in seconds) for the generated SDK client. `"infinity"` disables the default timeout. Default: 30. */
+    defaultTimeoutInSeconds: () => this.customConfig["default-timeout-in-seconds"],
     /**
      * Output path configuration for generated files.
      * Returns normalized paths for library, test, solution, and other files.
@@ -939918,7 +940017,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.20.1";
+    return "5.21.0-3-g6ffb37058a9";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.20.1",
+  "version": "5.21.0-3-g6ffb37058a9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",