@fern-api/fern-api-dev 4.77.0 → 4.78.0

package/cli.cjs

@@ -477592,6 +477592,7 @@ __export(api_exports, {
   HttpMethod: () => HttpMethod2,
   HttpRequestBody: () => HttpRequestBody,
   HttpResponseBody: () => HttpResponseBody,
+  InvocationSource: () => InvocationSource,
   JsonResponse: () => JsonResponse,
   Literal: () => Literal,
   NamedTypeDefault: () => NamedTypeDefault,
@@ -480204,7 +480205,8 @@ __export(ir_exports2, {
   ApiDefinitionSource: () => ApiDefinitionSource,
   ApiVersionScheme: () => ApiVersionScheme,
   ErrorDiscriminationStrategy: () => ErrorDiscriminationStrategy,
-  ExampleStyle: () => ExampleStyle
+  ExampleStyle: () => ExampleStyle,
+  InvocationSource: () => InvocationSource
 });
 
 // ../../ir-sdk/lib/sdk/api/resources/ir/types/ApiDefinitionSource.js
@@ -480309,6 +480311,31 @@ var ExampleStyle = {
   }
 };
 
+// ../../ir-sdk/lib/sdk/api/resources/ir/types/InvocationSource.js
+var InvocationSourceValues = {
+  Autopilot: "autopilot",
+  Autorelease: "autorelease",
+  Ci: "ci",
+  Manual: "manual"
+};
+var InvocationSource = {
+  ...InvocationSourceValues,
+  _visit: (value, visitor) => {
+    switch (value) {
+      case InvocationSource.Autopilot:
+        return visitor.autopilot();
+      case InvocationSource.Autorelease:
+        return visitor.autorelease();
+      case InvocationSource.Ci:
+        return visitor.ci();
+      case InvocationSource.Manual:
+        return visitor.manual();
+      default:
+        return visitor._other();
+    }
+  }
+};
+
 // ../../ir-sdk/lib/sdk/api/resources/proto/index.js
 var proto_exports = {};
 __export(proto_exports, {
@@ -482409,6 +482436,7 @@ __export(serialization_exports2, {
   IntegerType: () => IntegerType,
   IntegerValidationRules: () => IntegerValidationRules,
   IntermediateRepresentation: () => IntermediateRepresentation,
+  InvocationSource: () => InvocationSource2,
   JsonEncoding: () => JsonEncoding,
   JsonResponse: () => JsonResponse2,
   JsonResponseBody: () => JsonResponseBody,
@@ -487174,6 +487202,7 @@ __export(ir_exports4, {
   GenerationMetadata: () => GenerationMetadata,
   HeaderApiVersionScheme: () => HeaderApiVersionScheme,
   IntermediateRepresentation: () => IntermediateRepresentation,
+  InvocationSource: () => InvocationSource2,
   Package: () => Package,
   PackageNavigationConfig: () => PackageNavigationConfig,
   PlatformHeaders: () => PlatformHeaders,
@@ -487281,13 +487310,20 @@ var ErrorDiscriminationStrategy2 = schemas_exports3.union("type", {
 // ../../ir-sdk/lib/sdk/serialization/resources/ir/types/ExampleStyle.js
 var ExampleStyle2 = schemas_exports3.enum_(["minimal", "comprehensive"]);
 
+// ../../ir-sdk/lib/sdk/serialization/resources/ir/types/InvocationSource.js
+var InvocationSource2 = schemas_exports3.enum_(["autopilot", "autorelease", "ci", "manual"]);
+
 // ../../ir-sdk/lib/sdk/serialization/resources/ir/types/GenerationMetadata.js
 var GenerationMetadata = schemas_exports3.objectWithoutOptionalProperties({
   cliVersion: schemas_exports3.string(),
   generatorName: schemas_exports3.string(),
   generatorVersion: schemas_exports3.string(),
   generatorConfig: schemas_exports3.unknown().optional(),
-  originGitCommit: schemas_exports3.string().optional()
+  originGitCommit: schemas_exports3.string().optional(),
+  originGitCommitIsDirty: schemas_exports3.boolean().optional(),
+  invokedBy: InvocationSource2.optional(),
+  requestedVersion: schemas_exports3.string().optional(),
+  ciProvider: schemas_exports3.string().optional()
 });
 
 // ../../ir-sdk/lib/sdk/serialization/resources/publish/types/CratesPublishTarget.js
@@ -492120,6 +492156,81 @@ function getGithubRepository(generatorInvocation) {
   return void 0;
 }
 
+// ../../commons/api-workspace-commons/lib/detectInvocationSource.js
+function detectInvocationSource() {
+  const fromEnv = normalizeInvoker(process.env.FERN_INVOKER);
+  if (fromEnv != null) {
+    return fromEnv;
+  }
+  if (isCIEnvironment()) {
+    return "ci";
+  }
+  return "manual";
+}
+function detectCiProvider() {
+  if (process.env.GITHUB_ACTIONS === "true") {
+    return "github";
+  }
+  if (process.env.GITLAB_CI === "true") {
+    return "gitlab";
+  }
+  if (process.env.BITBUCKET_BUILD_NUMBER != null) {
+    return "bitbucket";
+  }
+  if (process.env.CIRCLECI === "true") {
+    return "circleci";
+  }
+  if (process.env.TRAVIS === "true") {
+    return "travis";
+  }
+  if (process.env.JENKINS_URL != null || process.env.JENKINS_HOME != null) {
+    return "jenkins";
+  }
+  if (process.env.TF_BUILD != null) {
+    return "azure-pipelines";
+  }
+  if (process.env.BUILDKITE === "true") {
+    return "buildkite";
+  }
+  if (process.env.CODEBUILD_BUILD_ID != null) {
+    return "codebuild";
+  }
+  if (process.env.TEAMCITY_VERSION != null) {
+    return "teamcity";
+  }
+  if (process.env.DRONE === "true") {
+    return "drone";
+  }
+  if (process.env.SEMAPHORE === "true") {
+    return "semaphore";
+  }
+  if (process.env.APPVEYOR === "true" || process.env.APPVEYOR === "True") {
+    return "appveyor";
+  }
+  if (isCIEnvironment()) {
+    return "unknown";
+  }
+  return void 0;
+}
+function normalizeInvoker(raw) {
+  if (raw == null) {
+    return void 0;
+  }
+  const normalized = raw.trim().toLowerCase();
+  switch (normalized) {
+    case "autopilot":
+    case "autorelease":
+    case "ci":
+    case "manual":
+      return normalized;
+    default:
+      return void 0;
+  }
+}
+function isCIEnvironment() {
+  return !!(process.env.CI || process.env.CONTINUOUS_INTEGRATION || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.CIRCLECI || process.env.TRAVIS || process.env.JENKINS_URL || process.env.JENKINS_HOME || process.env.TF_BUILD || process.env.BUILDKITE || process.env.CODEBUILD_BUILD_ID || process.env.TEAMCITY_VERSION || process.env.BITBUCKET_BUILD_NUMBER || process.env.DRONE || process.env.SEMAPHORE || process.env.APPVEYOR || process.env.BUDDY_WORKSPACE_ID || process.env.WERCKER_RUN_ID);
+}
+
 // ../../commons/api-workspace-commons/lib/FernWorkspace.js
 var FernWorkspace = class extends AbstractAPIWorkspace {
   definition;
@@ -492163,6 +492274,20 @@ function getOriginGitCommit() {
     return void 0;
   }
 }
+function getOriginGitCommitIsDirty() {
+  if (process.env.IGNORE_GIT_IN_METADATA === "true") {
+    return void 0;
+  }
+  try {
+    const status = (0, import_child_process3.execSync)("git status --porcelain", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return status.trim().length > 0;
+  } catch {
+    return void 0;
+  }
+}
 
 // ../configuration/lib/constants.js
 var FERN_DIRECTORY = "fern";
@@ -622064,7 +622189,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.77.0",
+          version: "4.78.0",
           usingAccessToken: true
         }
       });
@@ -622118,7 +622243,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.77.0",
+        version: "4.78.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -754057,7 +754182,16 @@ function inflateIr(ir15, casingsGenerator) {
     dynamic: ir15.dynamic != null ? inflateDynamicIr(ir15.dynamic) : void 0,
     selfHosted: ir15.selfHosted,
     audiences: ir15.audiences,
-    generationMetadata: ir15.generationMetadata,
+    // V65 only knows about cliVersion/generatorName/generatorVersion/generatorConfig/originGitCommit.
+    // Strip the V66-only fields (originGitCommitIsDirty, invokedBy, requestedVersion, ciProvider)
+    // to preserve the V65 contract for older generators.
+    generationMetadata: ir15.generationMetadata != null ? {
+      cliVersion: ir15.generationMetadata.cliVersion,
+      generatorName: ir15.generationMetadata.generatorName,
+      generatorVersion: ir15.generationMetadata.generatorVersion,
+      generatorConfig: ir15.generationMetadata.generatorConfig,
+      originGitCommit: ir15.generationMetadata.originGitCommit
+    } : void 0,
     apiPlayground: ir15.apiPlayground
   };
 }
@@ -839336,7 +839470,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 = "4.77.0";
+  const version7 = "4.78.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -849247,7 +849381,11 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
       generatorName: generatorInvocation.name,
       generatorVersion: generatorInvocation.version,
       generatorConfig: generatorInvocation.config,
-      originGitCommit: getOriginGitCommit()
+      originGitCommit: getOriginGitCommit(),
+      originGitCommitIsDirty: getOriginGitCommitIsDirty(),
+      invokedBy: detectInvocationSource(),
+      requestedVersion: version7,
+      ciProvider: detectCiProvider()
     }
   });
   const venus = createVenusService({ token: token.value });
@@ -850651,7 +850789,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.77.0"
+        cliVersion: "4.78.0"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -889084,18 +889222,156 @@ var DynamicTypeLiteralMapper4 = class _DynamicTypeLiteralMapper {
       });
       return ruby_exports.TypeLiteral.nop();
     }
-    return ruby_exports.TypeLiteral.hash(Object.entries(value).map(([key2, val]) => {
+    const entries23 = this.convertObjectEntries({ object: object22, value });
+    return ruby_exports.TypeLiteral.hash(entries23);
+  }
+  convertObjectEntries({ object: object22, value }) {
+    const record22 = typeof value === "object" && value != null ? value : {};
+    const providedWireValues = new Set(Object.keys(record22));
+    const entries23 = [];
+    for (const [key2, val] of Object.entries(record22)) {
       this.context.errors.scope(key2);
       const property24 = object22.properties.find((p10) => p10.name.wireValue === key2);
       const typeReference2 = property24?.typeReference ?? { type: "unknown" };
       const propertyName = property24?.name.name.snakeCase.safeName ?? key2;
-      const astNode = {
-        key: ruby_exports.TypeLiteral.string(propertyName),
-        value: this.convert({ typeReference: typeReference2, value: val })
-      };
+      const converted = this.convert({ typeReference: typeReference2, value: val });
+      if (!ruby_exports.TypeLiteral.isNop(converted)) {
+        entries23.push({
+          key: ruby_exports.TypeLiteral.string(propertyName),
+          value: converted
+        });
+      }
       this.context.errors.unscope();
-      return astNode;
-    }));
+    }
+    for (const property24 of object22.properties) {
+      if (providedWireValues.has(property24.name.wireValue)) {
+        continue;
+      }
+      if (this.context.isOptional(property24.typeReference) || this.context.isNullable(property24.typeReference)) {
+        continue;
+      }
+      const defaultValue = this.synthesizeDefaultValue(property24.typeReference);
+      if (!ruby_exports.TypeLiteral.isNop(defaultValue)) {
+        entries23.push({
+          key: ruby_exports.TypeLiteral.string(property24.name.name.snakeCase.safeName),
+          value: defaultValue
+        });
+      }
+    }
+    return entries23.filter((entry) => !ruby_exports.TypeLiteral.isNop(entry.value));
+  }
+  // =============================================================================
+  // DEFAULT VALUE SYNTHESIS
+  // =============================================================================
+  /**
+   * Synthesizes a reasonable default value for a given type reference.
+   * Used to populate required fields that are missing from examples,
+   * preventing invalid code generation (e.g. empty hashes for types
+   * with required fields).
+   */
+  synthesizeDefaultValue(typeReference2, seen = /* @__PURE__ */ new Set()) {
+    switch (typeReference2.type) {
+      case "optional":
+      case "nullable":
+        return ruby_exports.TypeLiteral.nop();
+      case "primitive":
+        return this.synthesizeDefaultPrimitive(typeReference2.value);
+      case "literal":
+        return this.synthesizeDefaultLiteral(typeReference2.value);
+      case "list":
+        return ruby_exports.TypeLiteral.list([]);
+      case "set":
+        return ruby_exports.TypeLiteral.list([]);
+      case "map":
+        return ruby_exports.TypeLiteral.hash([]);
+      case "named": {
+        if (seen.has(typeReference2.value)) {
+          return ruby_exports.TypeLiteral.nop();
+        }
+        const named = this.context.resolveNamedType({ typeId: typeReference2.value });
+        if (named == null) {
+          return ruby_exports.TypeLiteral.nop();
+        }
+        return this.synthesizeDefaultNamed({ named, typeId: typeReference2.value, seen });
+      }
+      case "unknown":
+        return ruby_exports.TypeLiteral.nop();
+      default:
+        assertNever(typeReference2);
+    }
+  }
+  synthesizeDefaultPrimitive(primitive) {
+    switch (primitive) {
+      case "STRING":
+      case "BASE_64":
+      case "BIG_INTEGER":
+        return ruby_exports.TypeLiteral.string("string");
+      case "INTEGER":
+      case "LONG":
+      case "UINT":
+      case "UINT_64":
+        return ruby_exports.TypeLiteral.integer(1);
+      case "FLOAT":
+      case "DOUBLE":
+        return ruby_exports.TypeLiteral.float(1.1);
+      case "BOOLEAN":
+        return ruby_exports.TypeLiteral.boolean(true);
+      case "DATE":
+        return ruby_exports.TypeLiteral.string("2024-01-15");
+      case "DATE_TIME":
+      case "DATE_TIME_RFC_2822":
+        return ruby_exports.TypeLiteral.string("2024-01-15T09:30:00Z");
+      case "UUID":
+        return ruby_exports.TypeLiteral.string("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32");
+      default:
+        assertNever(primitive);
+    }
+  }
+  synthesizeDefaultLiteral(literalType2) {
+    switch (literalType2.type) {
+      case "boolean":
+        return ruby_exports.TypeLiteral.boolean(literalType2.value);
+      case "string":
+        return ruby_exports.TypeLiteral.string(literalType2.value);
+      default:
+        assertNever(literalType2);
+    }
+  }
+  synthesizeDefaultNamed({ named, typeId, seen }) {
+    const newSeen = new Set(seen);
+    newSeen.add(typeId);
+    switch (named.type) {
+      case "alias":
+        return this.synthesizeDefaultValue(named.typeReference, newSeen);
+      case "enum": {
+        const firstValue = named.values[0];
+        if (firstValue == null) {
+          return ruby_exports.TypeLiteral.nop();
+        }
+        return ruby_exports.TypeLiteral.string(firstValue.wireValue);
+      }
+      case "object": {
+        const entries23 = [];
+        for (const property24 of named.properties) {
+          if (this.context.isOptional(property24.typeReference) || this.context.isNullable(property24.typeReference)) {
+            continue;
+          }
+          const defaultValue = this.synthesizeDefaultValue(property24.typeReference, newSeen);
+          if (!ruby_exports.TypeLiteral.isNop(defaultValue)) {
+            entries23.push({
+              key: ruby_exports.TypeLiteral.string(property24.name.name.snakeCase.safeName),
+              value: defaultValue
+            });
+          }
+        }
+        return ruby_exports.TypeLiteral.hash(entries23);
+      }
+      case "discriminatedUnion":
+      case "undiscriminatedUnion":
+        return ruby_exports.TypeLiteral.nop();
+      default:
+        assertNever(named);
+    }
   }
   getValueAsNumber({ value, as: as8 }) {
     const num = as8 === "key" ? typeof value === "string" ? Number(value) : value : value;
@@ -889587,9 +889863,10 @@ var EndpointSnippetGenerator7 = class {
   }
   getMethodArgsForPropertiesRequest({ request: request7, snippet: snippet2 }) {
     const args = [];
+    const record22 = this.context.getRecord(snippet2.requestBody) ?? {};
     const bodyProperties = this.context.associateByWireValue({
       parameters: request7.value,
-      values: this.context.getRecord(snippet2.requestBody) ?? {}
+      values: record22
     });
     for (const parameter6 of bodyProperties) {
       const value = this.context.dynamicTypeLiteralMapper.convert(parameter6);
@@ -902495,7 +902772,11 @@ async function getIntermediateRepresentation({ workspace, audiences, generatorIn
       generatorName: generatorInvocation.name,
       generatorVersion: generatorInvocation.version,
       generatorConfig: generatorInvocation.config,
-      originGitCommit: getOriginGitCommit()
+      originGitCommit: getOriginGitCommit(),
+      originGitCommitIsDirty: getOriginGitCommitIsDirty(),
+      invokedBy: detectInvocationSource(),
+      requestedVersion: version7,
+      ciProvider: detectCiProvider()
     }
   });
   if (sourceConfig != null) {
@@ -902506,7 +902787,17 @@ async function getIntermediateRepresentation({ workspace, audiences, generatorIn
     generatorName: generatorInvocation.name,
     generatorVersion: generatorInvocation.version,
     generatorConfig: generatorInvocation.config,
-    originGitCommit: getOriginGitCommit()
+    originGitCommit: getOriginGitCommit(),
+    originGitCommitIsDirty: getOriginGitCommitIsDirty(),
+    invokedBy: detectInvocationSource(),
+    // `requestedVersion` must reflect the raw `--version` flag passed by the user. The
+    // `version` parameter here may have been resolved (e.g. via `computeSemanticVersion`)
+    // so we never fall back to it. When the IR is freshly generated above, this field is
+    // populated with the raw flag value. When the IR is pre-generated, the caller is
+    // responsible for having set this correctly; a pre-existing `undefined` means the
+    // user did not pass `--version`.
+    requestedVersion: intermediateRepresentation.generationMetadata?.requestedVersion,
+    ciProvider: detectCiProvider()
   };
   context3.logger.debug("Generated IR");
   const irVersionFromFdr = await getIrVersionForGenerator(generatorInvocation).then((version8) => version8 == null ? void 0 : "v" + version8.toString());
@@ -903917,7 +904208,11 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
           generatorName: generatorInvocation.name,
           generatorVersion: generatorInvocation.version,
           generatorConfig: generatorInvocation.config,
-          originGitCommit: getOriginGitCommit()
+          originGitCommit: getOriginGitCommit(),
+          originGitCommitIsDirty: getOriginGitCommitIsDirty(),
+          invokedBy: detectInvocationSource(),
+          requestedVersion: userProvidedVersion,
+          ciProvider: detectCiProvider()
         }
       });
       const venus = createVenusService({ token: token?.value });
@@ -904348,7 +904643,11 @@ var GenerationRunner = class {
         generatorName: generatorInvocation.name,
         generatorVersion: generatorInvocation.version,
         generatorConfig: generatorInvocation.config,
-        originGitCommit: getOriginGitCommit()
+        originGitCommit: getOriginGitCommit(),
+        originGitCommitIsDirty: getOriginGitCommitIsDirty(),
+        invokedBy: detectInvocationSource(),
+        requestedVersion: outputVersionOverride,
+        ciProvider: detectCiProvider()
       }
     });
     const workspaceTempDir = await getWorkspaceTempDir();
@@ -925562,7 +925861,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.77.0";
+    return "4.78.0";
   }
   getCliName() {
     if (false) {

package/package.json

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