@fern-api/fern-api-dev 4.81.0-3-gaa0d9a2b5d2 → 4.81.0-9-ge0476cd3e22

package/cli.cjs

@@ -535712,7 +535712,7 @@ async function validateSchema({ schema: schema2, value: value2, context: context
     });
   });
   const errorMessage = [`Failed to parse file: ${import_path20.default.relative(process.cwd(), filepathBeingParsed)}`, ...issues].join("\n");
-  return context3.failAndThrow(errorMessage);
+  return context3.failAndThrow(errorMessage, void 0, { code: CliError.Code.ConfigError });
 }
 function joinZodPath(arr) {
   return arr.reduce((acc, value2) => {
@@ -535745,7 +535745,9 @@ async function convertDependenciesConfiguration({ absolutePathToWorkspace, rawDe
           path: versionOrPath
         };
       } else {
-        context3.failWithoutThrowing(`Path to ${coordinate} dependency does not exist: ${pathToApi}`);
+        context3.failWithoutThrowing(`Path to ${coordinate} dependency does not exist: ${pathToApi}`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
     } else {
       const unprefixedCoordinate = coordinate.substring(1);
@@ -535760,12 +535762,14 @@ async function convertDependenciesConfiguration({ absolutePathToWorkspace, rawDe
           version: versionOrPath
         };
       } else {
-        context3.failWithoutThrowing(`Failed to parse dependency: ${coordinate}`);
+        context3.failWithoutThrowing(`Failed to parse dependency: ${coordinate}`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
     }
   }
   if (context3.getResult() === TaskResult.Failure) {
-    context3.failAndThrow();
+    context3.failAndThrow(void 0, void 0, { code: CliError.Code.ConfigError });
   }
   return {
     dependencies
@@ -535921,7 +535925,7 @@ function getColorInstanceFromRawConfigOrThrow(raw, context3, key2, theme) {
   }
   const instance = tinycolor(color3);
   if (!instance.isValid()) {
-    context3.failAndThrow(`'${typeof raw === "string" ? key2 : `colors.${key2}.${theme}`}' should be a hex color of the format #FFFFFF`);
+    context3.failAndThrow(`'${typeof raw === "string" ? key2 : `colors.${key2}.${theme}`}' should be a hex color of the format #FFFFFF`, void 0, { code: CliError.Code.ConfigError });
   }
   return instance;
 }
@@ -536535,7 +536539,7 @@ async function parseContext7File({ rawPath, absoluteFilepathToDocsConfig, contex
   try {
     JSON.parse(contents);
   } catch (error50) {
-    context3.failAndThrow(`Invalid JSON in Context7 config file: ${rawPath}`, error50 instanceof Error ? error50.message : String(error50));
+    context3.failAndThrow(`Invalid JSON in Context7 config file: ${rawPath}`, error50 instanceof Error ? error50.message : String(error50), { code: CliError.Code.ConfigError });
   }
   return absolutePath;
 }
@@ -536695,7 +536699,10 @@ async function getNavigationConfiguration({ tabs, products, versions, navigation
           featureFlags: convertFeatureFlag(product.featureFlag)
         });
       } else {
-        throw new Error(`Invalid product configuration: product must have either 'path' or valid 'href' property`);
+        throw new CliError({
+          message: `Invalid product configuration: product must have either 'path' or valid 'href' property`,
+          code: CliError.Code.ConfigError
+        });
       }
     }
     return {
@@ -536710,7 +536717,10 @@ async function getNavigationConfiguration({ tabs, products, versions, navigation
       folderTitleSource
     });
   }
-  throw new Error("Unexpected. Docs have neither navigation or versions defined.");
+  throw new CliError({
+    message: "Unexpected. Docs have neither navigation or versions defined.",
+    code: CliError.Code.ConfigError
+  });
 }
 function convertFeatureFlag(flag) {
   if (flag == null) {
@@ -536808,7 +536818,10 @@ function parseWeight(weight) {
 async function convertNavigationTabConfiguration({ tabs, item, absolutePathToFernFolder, absolutePathToConfig, context: context3, folderTitleSource }) {
   const tab2 = tabs[item.tab];
   if (tab2 == null) {
-    throw new Error(`Tab ${item.tab} is not defined in the tabs config.`);
+    throw new CliError({
+      message: `Tab ${item.tab} is not defined in the tabs config.`,
+      code: CliError.Code.ConfigError
+    });
   }
   if (tabbedNavigationItemHasVariants(item)) {
     const variants = await Promise.all(item.variants.map(async (variant) => {
@@ -536937,7 +536950,9 @@ var DEFAULT_CHANGELOG_TITLE = "Changelog";
 async function expandFolderConfiguration({ rawConfig, absolutePathToFernFolder, absolutePathToConfig, context: context3, folderTitleSource }) {
   const folderPath = resolveFilepath(rawConfig.folder, absolutePathToConfig);
   if (!await doesPathExist(folderPath)) {
-    context3.failAndThrow(`Folder not found: ${rawConfig.folder}`);
+    context3.failAndThrow(`Folder not found: ${rawConfig.folder}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   validateCollapsibleConfig({
     context: context3,
@@ -537260,7 +537275,10 @@ function parseLibrariesConfiguration(libraries) {
   const result = {};
   for (const [name2, config5] of Object.entries(libraries)) {
     if (!isGitLibraryInput(config5.input)) {
-      throw new Error(`Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`);
+      throw new CliError({
+        message: `Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`,
+        code: CliError.Code.ConfigError
+      });
     }
     result[name2] = {
       input: {
@@ -537449,10 +537467,10 @@ function parseAudiences(raw) {
 }
 function validateCollapsibleConfig({ context: context3, sectionTitle, collapsed, collapsible, collapsedByDefault }) {
   if (collapsible != null && collapsed != null) {
-    context3.failAndThrow(`Section "${sectionTitle}": cannot use both "collapsible" and the deprecated "collapsed" property. Please use "collapsible" and "collapsed-by-default" instead.`);
+    context3.failAndThrow(`Section "${sectionTitle}": cannot use both "collapsible" and the deprecated "collapsed" property. Please use "collapsible" and "collapsed-by-default" instead.`, void 0, { code: CliError.Code.ConfigError });
   }
   if (collapsedByDefault != null && collapsible !== true) {
-    context3.failAndThrow(`Section "${sectionTitle}": "collapsed-by-default" requires "collapsible: true". "collapsed-by-default" has no effect on a non-collapsible section.`);
+    context3.failAndThrow(`Section "${sectionTitle}": "collapsed-by-default" requires "collapsible: true". "collapsed-by-default" has no effect on a non-collapsible section.`, void 0, { code: CliError.Code.ConfigError });
   }
 }
 
@@ -537727,7 +537745,9 @@ function removeDefaultDockerOrgIfPresent(generatorName) {
 function getGeneratorNameOrThrow(generatorName, context3) {
   const normalizedGeneratorName = normalizeGeneratorName(generatorName);
   if (normalizedGeneratorName == null) {
-    return context3.failAndThrow("Unrecognized generator: " + generatorName);
+    return context3.failAndThrow("Unrecognized generator: " + generatorName, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   return normalizedGeneratorName;
 }
@@ -537854,9 +537874,9 @@ async function updateGeneratorGroup({ generatorsConfiguration, groupName = gener
     const availableGroups = Object.keys(generatorsConfiguration.groups ?? {});
     if (availableGroups.length > 0) {
       const message = "No group specified. Use the --group option:\n" + availableGroups.map((name2) => ` \u203A ${name2}`).join("\n");
-      return context3.failAndThrow(message);
+      return context3.failAndThrow(message, void 0, { code: CliError.Code.ConfigError });
     }
-    return context3.failAndThrow("No group specified.");
+    return context3.failAndThrow("No group specified.", void 0, { code: CliError.Code.ConfigError });
   }
   const groups2 = generatorsConfiguration.groups ??= {};
   const group = groups2[groupName];
@@ -537880,7 +537900,9 @@ async function addGenerator({ generatorName, generatorsConfiguration, groupName
     context: context3,
     update: async (group) => {
       if (group.generators.some((generator) => addDefaultDockerOrgIfNotPresent("image" in generator ? generator.image.name : generator.name) === normalizedGeneratorName)) {
-        context3.failAndThrow(`${generatorName} is already installed in group ${groupName}.`);
+        context3.failAndThrow(`${generatorName} is already installed in group ${groupName}.`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       const latestVersion2 = await getLatestGeneratorVersion({
         cliVersion,
@@ -544443,7 +544465,10 @@ function parseRemoveDiscriminantsFromSchemas(option) {
   } else if (option === "never") {
     return generators_yml_exports.RemoveDiscriminantsFromSchemas.Never;
   }
-  throw new Error(`Unknown value for generators.yml API setting: remove-discriminants-from-schemas: ${option}`);
+  throw new CliError({
+    message: `Unknown value for generators.yml API setting: remove-discriminants-from-schemas: ${option}`,
+    code: CliError.Code.ConfigError
+  });
 }
 function mergeSettings(base4, override) {
   return {
@@ -545010,7 +545035,10 @@ async function getGithubLicense({ absolutePathToGeneratorsConfiguration, githubL
 function getGithubPublishInfo(output2, maybeGroupLevelMetadata, maybeTopLevelMetadata) {
   switch (output2.location) {
     case "local-file-system":
-      throw new Error("Cannot use local-file-system with github publishing");
+      throw new CliError({
+        message: "Cannot use local-file-system with github publishing",
+        code: CliError.Code.ConfigError
+      });
     case "npm":
       return api_exports4.GithubPublishInfo.npm({
         registryUrl: output2.url ?? "https://registry.npmjs.org",
@@ -545203,7 +545231,10 @@ async function loadRawGeneratorsConfiguration({ absolutePathToWorkspace, context
     if (parsed.ok) {
       return parsed.value;
     }
-    throw new Error(parsed.errors.map((e5) => e5.message).join("\n"));
+    throw new CliError({
+      message: parsed.errors.map((e5) => e5.message).join("\n"),
+      code: CliError.Code.ConfigError
+    });
   } catch (e5) {
     if (e5 instanceof jsYaml.YAMLException) {
       const relativePath = import_path24.default.relative(process.cwd(), filepath);
@@ -545225,7 +545256,7 @@ ${e5.mark.snippet}`;
           errorMessage += '\n\nHint: Values starting with "@" (such as scoped npm packages) must be wrapped in quotes.\n  Example: package-name: "@scope/package"';
         }
       }
-      context3.failAndThrow(errorMessage);
+      context3.failAndThrow(errorMessage, void 0, { code: CliError.Code.ConfigError });
     } else {
       throw e5;
     }
@@ -551709,7 +551740,7 @@ function parseTypeName({ typeName, file: file4 }) {
     imports: file4.imports
   });
   if (reference4 == null) {
-    throw new Error("Failed to locate type: " + typeName);
+    throw new CliError({ message: "Failed to locate type: " + typeName, code: CliError.Code.ResolutionError });
   }
   const nameWithoutId = {
     name: file4.casingsGenerator.generateName(reference4.typeName),
@@ -551919,7 +551950,7 @@ function convertHttpRequestBody({ request: request7, file: file4 }) {
   }
   if (isInlineRequestBody(request7.body)) {
     if (request7.name == null) {
-      throw new Error("Name is missing for inlined request");
+      throw new CliError({ message: "Name is missing for inlined request", code: CliError.Code.InternalError });
     }
     return HttpRequestBody.inlinedRequestBody({
       name: file4.casingsGenerator.generateName(request7.name),
@@ -552009,13 +552040,19 @@ function getObjectPropertyFromResolvedType({ typeResolver, file: file4, resolved
     default:
       assertNever(resolvedType);
   }
-  throw new Error("Internal error; response must be an object in order to return a property as a response");
+  throw new CliError({
+    message: "Internal error; response must be an object in order to return a property as a response",
+    code: CliError.Code.InternalError
+  });
 }
 function getObjectPropertyFromObjectSchema({ typeResolver, file: file4, objectSchema, property: property24 }) {
   const properties7 = getAllPropertiesForRawObjectSchema(objectSchema, file4, typeResolver);
   const objectProperty = properties7[property24];
   if (objectProperty == null) {
-    throw new Error(`Object does not have a property named ${property24}.`);
+    throw new CliError({
+      message: `Object does not have a property named ${property24}.`,
+      code: CliError.Code.ReferenceError
+    });
   }
   return objectProperty;
 }
@@ -552048,7 +552085,10 @@ function getAllPropertiesForExtendedType(extendedType, file4, typeResolver) {
   if (resolvedType._type === "named" && isRawObjectDefinition(resolvedType.declaration)) {
     return getAllPropertiesForRawObjectSchema(resolvedType.declaration, file4, typeResolver);
   }
-  throw new Error(`Extended type ${extendedType} must be another named type`);
+  throw new CliError({
+    message: `Extended type ${extendedType} must be another named type`,
+    code: CliError.Code.InternalError
+  });
 }
 
 // ../generation/ir-generator/lib/converters/services/convertProperty.js
@@ -552112,7 +552152,10 @@ function getPropertyTypeFromObjectSchema({ typeResolver, file: file4, objectSche
   });
   const propertyType = properties7[property24];
   if (propertyType == null) {
-    throw new Error(`Response does not have a property named ${property24}.`);
+    throw new CliError({
+      message: `Response does not have a property named ${property24}.`,
+      code: CliError.Code.ReferenceError
+    });
   }
   return propertyType;
 }
@@ -552153,7 +552196,10 @@ function getAllPropertiesForExtendedType2({ typeResolver, file: file4, extendedT
       objectSchema: resolvedType.declaration
     });
   }
-  throw new Error(`Extended type ${extendedType} must be another named type.`);
+  throw new CliError({
+    message: `Extended type ${extendedType} must be another named type.`,
+    code: CliError.Code.InternalError
+  });
 }
 function maybeFileFromResolvedType(resolvedType) {
   if (resolvedType == null) {
@@ -552209,7 +552255,7 @@ function convertHttpSdkRequest({ request: request7, endpointKey, endpoint: endpo
 function convertHttpSdkRequestShape({ service, request: request7, file: file4, typeResolver }) {
   const constructWrapper = () => {
     if (typeof request7 === "string" || request7?.name == null) {
-      throw new Error("Name is missing for request wrapper");
+      throw new CliError({ message: "Name is missing for request wrapper", code: CliError.Code.InternalError });
     }
     return SdkRequestShape.wrapper({
       wrapperName: file4.casingsGenerator.generateName(request7.name),
@@ -552389,7 +552435,7 @@ function parseErrorName({ errorName, file: file4 }) {
     imports: file4.imports
   });
   if (reference4 == null) {
-    throw new Error("Failed to locate error " + errorName);
+    throw new CliError({ message: "Failed to locate error " + errorName, code: CliError.Code.ResolutionError });
   }
   const nameWithoutId = {
     name: file4.casingsGenerator.generateName(reference4.typeName),
@@ -552859,7 +552905,10 @@ function validateObjectExample({ typeName, typeNameForBreadcrumb, rawObject, fil
     } else {
       const definitionFile = getDefinitionFile(workspace, propertyWithPath.filepathOfDeclaration);
       if (definitionFile == null) {
-        throw new Error("Service file does not exist for property: " + propertyWithPath.wireKey);
+        throw new CliError({
+          message: "Service file does not exist for property: " + propertyWithPath.wireKey,
+          code: CliError.Code.InternalError
+        });
       }
       violations.push(...validateTypeReferenceExample({
         rawTypeReference: propertyWithPath.propertyType,
@@ -553334,7 +553383,10 @@ function validatePrimitiveExample({ primitiveType: primitiveType2, example }) {
       base64: () => validateString(example),
       bigInteger: () => validateString(example),
       _other: () => {
-        throw new Error("Unknown primitive type v2: " + primitiveType2.v2);
+        throw new CliError({
+          message: "Unknown primitive type v2: " + primitiveType2.v2,
+          code: CliError.Code.InternalError
+        });
       }
     });
   }
@@ -553354,7 +553406,10 @@ function validatePrimitiveExample({ primitiveType: primitiveType2, example }) {
     base64: () => validateString(example),
     bigInteger: () => validateString(example),
     _other: () => {
-      throw new Error("Unknown primitive type: " + primitiveType2.v1);
+      throw new CliError({
+        message: "Unknown primitive type: " + primitiveType2.v1,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -553577,7 +553632,10 @@ function convertEnumTypeDeclaration({ _enum: _enum3, file: file4 }) {
   if (_enum3.default != null) {
     defaultValue = values2.find((enumValue) => getWireValue(enumValue.name) === _enum3.default);
     if (defaultValue == null) {
-      throw new Error(`Default value ${_enum3.default} not found in enum values`);
+      throw new CliError({
+        message: `Default value ${_enum3.default} not found in enum values`,
+        code: CliError.Code.ValidationError
+      });
     }
   }
   return {
@@ -553646,18 +553704,27 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
     discriminatedUnion: (rawUnion) => {
       const discriminant21 = getUnionDiscriminant(rawUnion);
       if (!isPlainObject4(example)) {
-        throw new Error("Example is not an object");
+        throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
       }
       const discriminantValueForExample = example[discriminant21];
       if (discriminantValueForExample == null) {
-        throw new Error("Example is missing discriminant: " + discriminant21);
+        throw new CliError({
+          message: "Example is missing discriminant: " + discriminant21,
+          code: CliError.Code.ValidationError
+        });
       }
       if (typeof discriminantValueForExample !== "string") {
-        throw new Error("Discriminant value is not a string");
+        throw new CliError({
+          message: "Discriminant value is not a string",
+          code: CliError.Code.ValidationError
+        });
       }
       const rawSingleUnionType = rawUnion.union[discriminantValueForExample];
       if (rawSingleUnionType == null) {
-        throw new Error(`${discriminantValueForExample} is not one of the specified discriminant values.`);
+        throw new CliError({
+          message: `${discriminantValueForExample} is not one of the specified discriminant values.`,
+          code: CliError.Code.ValidationError
+        });
       }
       const rawValueType = typeof rawSingleUnionType === "string" ? rawSingleUnionType : typeof rawSingleUnionType.type === "string" ? rawSingleUnionType.type : void 0;
       const baseProperties = Object.entries(rawUnion["base-properties"] ?? {}).map(([propertyName, property24]) => {
@@ -553688,7 +553755,10 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
           referenceToNamedType: extendedTypeName
         });
         if (resolvedExtendedType._type !== "named" || !isRawObjectDefinition(resolvedExtendedType.declaration)) {
-          throw new Error("Extended type is not a named object");
+          throw new CliError({
+            message: "Extended type is not a named object",
+            code: CliError.Code.InternalError
+          });
         }
         const extendedObject = resolvedExtendedType.declaration;
         const propertiesFromExtension = Object.entries(extendedObject.properties ?? {}).map(([propertyName, property24]) => {
@@ -553741,7 +553811,10 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
     enum: (rawEnum) => {
       if (typeof example !== "string") {
         const validValues = rawEnum.enum.map((enumEntry) => typeof enumEntry === "string" ? enumEntry : enumEntry.value).join(", ");
-        throw new Error(`Expected one of ${validValues}. Received ${example}`);
+        throw new CliError({
+          message: `Expected one of ${validValues}. Received ${example}`,
+          code: CliError.Code.ValidationError
+        });
       }
       return ExampleTypeShape.enum({
         value: fileContainingExample.casingsGenerator.generateNameAndWireValue({
@@ -553782,7 +553855,10 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
         return typeof variant === "string" ? variant : variant.type;
       });
       const validValues = variantOptions.join(", ");
-      throw new Error(`Expected one of ${validValues}. Received ${example}`);
+      throw new CliError({
+        message: `Expected one of ${validValues}. Received ${example}`,
+        code: CliError.Code.ValidationError
+      });
     }
   });
 }
@@ -553809,7 +553885,7 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
       },
       map: ({ keyType, valueType }) => {
         if (!isPlainObject4(resolvedExample)) {
-          throw new Error("Example is not an object");
+          throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
         }
         const nextContext = { depth: ctx.depth + 1, seenTypeIds: ctx.seenTypeIds };
         return ExampleTypeReferenceShape.container(ExampleContainer.map({
@@ -553841,7 +553917,7 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
       },
       list: (itemType) => {
         if (!Array.isArray(resolvedExample)) {
-          throw new Error("Example is not a list");
+          throw new CliError({ message: "Example is not a list", code: CliError.Code.ValidationError });
         }
         const nextContext = { depth: ctx.depth + 1, seenTypeIds: ctx.seenTypeIds };
         return ExampleTypeReferenceShape.container(ExampleContainer.list({
@@ -553860,7 +553936,7 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
       },
       set: (itemType) => {
         if (!Array.isArray(resolvedExample)) {
-          throw new Error("Example is not a list");
+          throw new CliError({ message: "Example is not a list", code: CliError.Code.ValidationError });
         }
         const nextContext = { depth: ctx.depth + 1, seenTypeIds: ctx.seenTypeIds };
         return ExampleTypeReferenceShape.container(ExampleContainer.set({
@@ -553930,7 +554006,10 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
         });
         const parsedReferenceToNamedType = fileContainingRawTypeReference.parseTypeReference(named);
         if (parsedReferenceToNamedType.type !== "named") {
-          throw new Error("Type reference is not to a named type.");
+          throw new CliError({
+            message: "Type reference is not to a named type.",
+            code: CliError.Code.InternalError
+          });
         }
         const typeName = {
           typeId: parsedReferenceToNamedType.typeId,
@@ -554088,13 +554167,19 @@ function convertPrimitiveExample({ example, typeBeingExemplified }) {
       }));
     },
     _other: () => {
-      throw new Error("Unknown primitive type: " + typeBeingExemplified);
+      throw new CliError({
+        message: "Unknown primitive type: " + typeBeingExemplified,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
 function convertObject4({ typeName, rawObject, example, fileContainingType, fileContainingExample, typeResolver, exampleResolver, workspace, recursionContext }) {
   if (!isPlainObject4(example)) {
-    throw new Error(`Example is not an object. Got: ${JSON.stringify(example)}`);
+    throw new CliError({
+      message: `Example is not an object. Got: ${JSON.stringify(example)}`,
+      code: CliError.Code.ValidationError
+    });
   }
   const properties7 = Object.entries(example).map(([wireKey, propertyExample]) => {
     const originalTypeDeclaration = getOriginalTypeDeclarationForProperty({
@@ -554169,7 +554254,10 @@ function getOriginalTypeDeclarationForPropertyFromExtensions({ wirePropertyKey,
         file: file4
       });
       if (resolvedType._type !== "named" || !isRawObjectDefinition(resolvedType.declaration)) {
-        throw new Error("Extension is not of a named object");
+        throw new CliError({
+          message: "Extension is not of a named object",
+          code: CliError.Code.InternalError
+        });
       }
       const originalTypeDeclaration = getOriginalTypeDeclarationForProperty({
         wirePropertyKey,
@@ -554206,7 +554294,7 @@ function convertSingleUnionType({ rawValueType, rawSingleUnionType, fileContaini
   switch (parsedSingleUnionTypeProperties.propertiesType) {
     case "singleProperty": {
       if (!isPlainObject4(example)) {
-        throw new Error("Example is not an object");
+        throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
       }
       return {
         wireDiscriminantValue,
@@ -554224,7 +554312,7 @@ function convertSingleUnionType({ rawValueType, rawSingleUnionType, fileContaini
     }
     case "samePropertiesAsObject": {
       if (!isPlainObject4(example)) {
-        throw new Error("Example is not an object");
+        throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
       }
       let rawDeclaration = typeResolver.getDeclarationOfNamedTypeOrThrow({
         referenceToNamedType: rawValueType,
@@ -554237,7 +554325,10 @@ function convertSingleUnionType({ rawValueType, rawSingleUnionType, fileContaini
         });
       }
       if (!isRawObjectDefinition(rawDeclaration.declaration)) {
-        throw new Error(`${rawValueType} is not an object`);
+        throw new CliError({
+          message: `${rawValueType} is not an object`,
+          code: CliError.Code.ValidationError
+        });
       }
       const typeName = {
         typeId: parsedSingleUnionTypeProperties.typeId,
@@ -554320,7 +554411,10 @@ function convertExampleEndpointCall2({ service, endpoint: endpoint3, example, ty
     queryParameters: example["query-parameters"] != null ? Object.entries(example["query-parameters"]).map(([wireKey, value2]) => {
       const queryParameterDeclaration = typeof endpoint3.request !== "string" ? endpoint3.request?.["query-parameters"]?.[wireKey] : void 0;
       if (queryParameterDeclaration == null) {
-        throw new Error(`Query parameter ${wireKey} does not exist`);
+        throw new CliError({
+          message: `Query parameter ${wireKey} does not exist`,
+          code: CliError.Code.ReferenceError
+        });
       }
       const isAllowMultiple = typeof queryParameterDeclaration !== "string" && queryParameterDeclaration["allow-multiple"] === true;
       const rawType = typeof queryParameterDeclaration === "string" ? queryParameterDeclaration : queryParameterDeclaration.type;
@@ -554429,7 +554523,10 @@ function convertPathParameters({ service, endpoint: endpoint3, example, typeReso
           examplePathParameter
         }));
       } else {
-        throw new Error(`Path parameter ${key2} does not exist`);
+        throw new CliError({
+          message: `Path parameter ${key2} does not exist`,
+          code: CliError.Code.ReferenceError
+        });
       }
     }
   }
@@ -554509,7 +554606,10 @@ function convertExampleRequestBody({ endpoint: endpoint3, example, typeResolver,
     return void 0;
   }
   if (!isPlainObject4(example.request)) {
-    throw new Error(`Example is not an object. Got: ${JSON.stringify(example.request)}`);
+    throw new CliError({
+      message: `Example is not an object. Got: ${JSON.stringify(example.request)}`,
+      code: CliError.Code.ValidationError
+    });
   }
   const exampleProperties = [];
   const exampleExtraProperties = [];
@@ -554559,7 +554659,10 @@ function convertExampleRequestBody({ endpoint: endpoint3, example, typeResolver,
           });
           continue;
         }
-        throw new Error("Could not find original type declaration for property: " + wireKey);
+        throw new CliError({
+          message: "Could not find original type declaration for property: " + wireKey,
+          code: CliError.Code.ResolutionError
+        });
       }
       exampleProperties.push({
         name: file4.casingsGenerator.generateNameAndWireValue({
@@ -554944,7 +555047,7 @@ function getPaginationPropertyComponents(endpointPagination) {
       results: getResponsePropertyComponents(endpointPagination.results)
     };
   }
-  throw new Error("Invalid pagination schema");
+  throw new CliError({ message: "Invalid pagination schema", code: CliError.Code.ValidationError });
 }
 function isRawCursorPaginationSchema(rawPaginationSchema) {
   return rawPaginationSchema.cursor != null;
@@ -555115,7 +555218,10 @@ function getTransportForEndpoint({ file: file4, serviceTransport, endpointDeclar
     return void 0;
   }
   if (isHttpService && isGrpcEndpoint) {
-    throw new Error("Cannot have a grpc endpoint on an http service");
+    throw new CliError({
+      message: "Cannot have a grpc endpoint on an http service",
+      code: CliError.Code.ValidationError
+    });
   }
   if (isGrpcService && isHttpEndpoint) {
     return Transport.http();
@@ -555129,8 +555235,11 @@ function getTransportForEndpoint({ file: file4, serviceTransport, endpointDeclar
       return createProtobufService(file4, protoSource, sourceResolver, serviceNameOverride);
     }
   }
-  throw new Error(`Internal error; failed to determine endpoint transport for
-  ${JSON.stringify(endpointDeclaration)}"`);
+  throw new CliError({
+    message: `Internal error; failed to determine endpoint transport for
+  ${JSON.stringify(endpointDeclaration)}"`,
+    code: CliError.Code.InternalError
+  });
 }
 function createProtobufService(file4, source2, sourceResolver, serviceNameOverride) {
   const resolvedSource = sourceResolver.resolveSourceOrThrow({
@@ -555138,14 +555247,20 @@ function createProtobufService(file4, source2, sourceResolver, serviceNameOverri
     relativeFilepath: file4.relativeFilepath
   });
   if (resolvedSource == null || resolvedSource.type !== "protobuf") {
-    throw new Error(`Expected a protobuf source for ${source2.proto}.`);
+    throw new CliError({
+      message: `Expected a protobuf source for ${source2.proto}.`,
+      code: CliError.Code.ResolutionError
+    });
   }
   const protobufService = convertProtobufService({
     source: resolvedSource,
     serviceNameOverride
   });
   if (protobufService == null) {
-    throw new Error(`Failed to resolve service name from ${resolvedSource.relativeFilePath}.`);
+    throw new CliError({
+      message: `Failed to resolve service name from ${resolvedSource.relativeFilePath}.`,
+      code: CliError.Code.IrConversionError
+    });
   }
   return Transport.grpc({
     service: protobufService
@@ -555357,7 +555472,7 @@ function resolvePathParameterOrThrow({ parameter: parameter6, variableResolver,
     file: file4
   });
   if (resolved == null) {
-    throw new Error("Cannot resolve path parameter");
+    throw new CliError({ message: "Cannot resolve path parameter", code: CliError.Code.InternalError });
   }
   return resolved;
 }
@@ -555638,7 +555753,10 @@ var DynamicSnippetsConverter = class {
       return dynamic_exports.Request.body({ pathParameters, body: void 0 });
     }
     if (endpoint3.sdkRequest == null) {
-      throw new Error(`Internal error; endpoint "${endpoint3.id}" has a request body but no SDK request`);
+      throw new CliError({
+        message: `Internal error; endpoint "${endpoint3.id}" has a request body but no SDK request`,
+        code: CliError.Code.InternalError
+      });
     }
     switch (endpoint3.sdkRequest.shape.type) {
       case "justRequestBody":
@@ -556131,7 +556249,7 @@ var DynamicSnippetsConverter = class {
           }))
         }),
         _other: () => {
-          throw new Error("Unknown environments type");
+          throw new CliError({ message: "Unknown environments type", code: CliError.Code.InternalError });
         }
       })
     };
@@ -556168,10 +556286,16 @@ var DynamicSnippetsConverter = class {
   resolveObjectTypeOrThrow(typeId) {
     const typeDeclaration2 = this.ir.types[typeId];
     if (typeDeclaration2 == null) {
-      throw new Error(`Internal error; type "${typeId}" not found`);
+      throw new CliError({
+        message: `Internal error; type "${typeId}" not found`,
+        code: CliError.Code.InternalError
+      });
     }
     if (typeDeclaration2.shape.type !== "object") {
-      throw new Error(`Internal error; type "${typeId}" is not an object`);
+      throw new CliError({
+        message: `Internal error; type "${typeId}" is not an object`,
+        code: CliError.Code.InternalError
+      });
     }
     return typeDeclaration2.shape;
   }
@@ -556456,7 +556580,10 @@ function convertOAuthClientCredentials({ propertyResolver, endpointResolver, typ
     tokenEndpoint
   });
   if (oauthTokenEndpoint == null) {
-    throw new Error("Failed to convert OAuth token endpoint.");
+    throw new CliError({
+      message: "Failed to convert OAuth token endpoint.",
+      code: CliError.Code.IrConversionError
+    });
   }
   const refreshEndpoint = refreshTokenEndpoint != null ? convertOAuthRefreshEndpoint({
     propertyResolver,
@@ -556634,7 +556761,7 @@ function convertSchemeReference2({ reference: reference4, authSchemeDeclarations
   const convertNamedAuthSchemeReference = (reference5, docs2) => {
     const declaration = authSchemeDeclarations?.[reference5];
     if (declaration == null) {
-      throw new Error("Unknown auth scheme: " + reference5);
+      throw new CliError({ message: "Unknown auth scheme: " + reference5, code: CliError.Code.ReferenceError });
     }
     return visitRawAuthSchemeDeclaration(declaration, {
       header: (rawHeader) => AuthScheme.header({
@@ -556746,7 +556873,10 @@ function generateOAuth({ key: key2, file: file4, docs: docs2, rawScheme, propert
         }))
       });
     default:
-      throw new Error(`Unknown OAuth type: '${rawScheme?.type}'`);
+      throw new CliError({
+        message: `Unknown OAuth type: '${rawScheme?.type}'`,
+        code: CliError.Code.ValidationError
+      });
   }
 }
 function generateInferredAuth({ key: key2, file: file4, docs: docs2, rawScheme, propertyResolver, endpointResolver }) {
@@ -557010,7 +557140,10 @@ function convertChannel({ channel: channel3, typeResolver, exampleResolver, vari
         queryParameters: example["query-parameters"] != null ? Object.entries(example["query-parameters"]).map(([wireKey, value2]) => {
           const queryParameterDeclaration = channel3["query-parameters"]?.[wireKey];
           if (queryParameterDeclaration == null) {
-            throw new Error(`Query parameter ${wireKey} does not exist`);
+            throw new CliError({
+              message: `Query parameter ${wireKey} does not exist`,
+              code: CliError.Code.ReferenceError
+            });
           }
           return {
             name: file4.casingsGenerator.generateNameAndWireValue({
@@ -557035,7 +557168,10 @@ function convertChannel({ channel: channel3, typeResolver, exampleResolver, vari
         messages: example.messages.map((messageExample) => {
           const message = channel3.messages?.[messageExample.type];
           if (message == null) {
-            throw new Error(`Message ${messageExample.type} does not exist`);
+            throw new CliError({
+              message: `Message ${messageExample.type} does not exist`,
+              code: CliError.Code.ReferenceError
+            });
           }
           return {
             type: messageExample.type,
@@ -557074,7 +557210,7 @@ function convertExampleWebSocketMessageBody({ message, example, typeResolver, ex
     }));
   }
   if (!isPlainObject4(example)) {
-    throw new Error("Example must be an object");
+    throw new CliError({ message: "Example must be an object", code: CliError.Code.ValidationError });
   }
   const exampleProperties = [];
   for (const [wireKey, propertyExample] of Object.entries(example)) {
@@ -557104,7 +557240,10 @@ function convertExampleWebSocketMessageBody({ message, example, typeResolver, ex
         file: file4
       });
       if (originalTypeDeclaration == null) {
-        throw new Error("Could not find original type declaration for property: " + wireKey);
+        throw new CliError({
+          message: "Could not find original type declaration for property: " + wireKey,
+          code: CliError.Code.ResolutionError
+        });
       }
       exampleProperties.push({
         name: file4.casingsGenerator.generateNameAndWireValue({
@@ -557188,7 +557327,10 @@ function convertChannelPathParameters({ channel: channel3, example, typeResolver
           examplePathParameter
         }));
       } else {
-        throw new Error(`Path parameter ${key2} does not exist`);
+        throw new CliError({
+          message: `Path parameter ${key2} does not exist`,
+          code: CliError.Code.ReferenceError
+        });
       }
     }
   }
@@ -557339,7 +557481,10 @@ var ReadmeEndpointCache = class {
   getEndpointForReadmeOrThrow(readmeEndpoint) {
     const endpoint3 = this.getEndpointForReadme(readmeEndpoint);
     if (endpoint3 == null) {
-      throw new Error(`Endpoint not found for ${JSON.stringify(readmeEndpoint)}`);
+      throw new CliError({
+        message: `Endpoint not found for ${JSON.stringify(readmeEndpoint)}`,
+        code: CliError.Code.ResolutionError
+      });
     }
     return endpoint3;
   }
@@ -557387,7 +557532,7 @@ function getReadmeEndpointObject({ endpoint: endpoint3 }) {
   if (typeof endpoint3 === "string") {
     const split2 = endpoint3.split(" ");
     if (split2.length !== 2 || split2[0] == null || split2[1] == null) {
-      throw new Error(`invalid endpoint string: ${endpoint3}`);
+      throw new CliError({ message: `invalid endpoint string: ${endpoint3}`, code: CliError.Code.ParseError });
     }
     return {
       method: split2[0],
@@ -557484,7 +557629,10 @@ function convertWebhookExamples2({ webhook, examples, file: file4, typeResolver,
     }));
   }
   if (!isPlainObject4(webhook.payload)) {
-    throw new Error(`Example webhook payload is not an object. Got: ${JSON.stringify(webhook.payload)}`);
+    throw new CliError({
+      message: `Example webhook payload is not an object. Got: ${JSON.stringify(webhook.payload)}`,
+      code: CliError.Code.ValidationError
+    });
   }
   return examples.map((example) => ({
     docs: webhook.docs,
@@ -557876,7 +558024,10 @@ function convertGenericTypeDeclaration({ generic, file: file4, typeResolver }) {
   const genericInstantiation = typeof generic === "string" ? generic : generic.type;
   const maybeGeneric = parseGeneric(genericInstantiation);
   if (maybeGeneric == null) {
-    throw new Error(`Invalid generic type definition: ${genericInstantiation}`);
+    throw new CliError({
+      message: `Invalid generic type definition: ${genericInstantiation}`,
+      code: CliError.Code.ValidationError
+    });
   }
   const resolvedBaseGeneric = typeResolver.getDeclarationOfNamedTypeOrThrow({
     referenceToNamedType: genericInstantiation,
@@ -557907,7 +558058,10 @@ function convertGenericTypeDeclaration({ generic, file: file4, typeResolver }) {
       extendedProperties: void 0
     });
   }
-  throw new Error(`Generic type definition not supported: ${genericInstantiation}`);
+  throw new CliError({
+    message: `Generic type definition not supported: ${genericInstantiation}`,
+    code: CliError.Code.ValidationError
+  });
 }
 
 // ../generation/ir-generator/lib/converters/type-declarations/convertAliasTypeDeclaration.js
@@ -558299,7 +558453,10 @@ var PackageTreeGenerator = class {
   addPackageRedirection({ from: from4, to: to10 }) {
     const package_ = this.getPackageForFernFilepath(from4);
     if (package_.navigationConfig != null) {
-      throw new Error("Found duplicate navigationConfig for package");
+      throw new CliError({
+        message: "Found duplicate navigationConfig for package",
+        code: CliError.Code.InternalError
+      });
     }
     package_.navigationConfig = {
       pointsTo: IdGenerator.generateSubpackageId(to10)
@@ -558308,7 +558465,7 @@ var PackageTreeGenerator = class {
   addDocs(fernFilepath, docs2) {
     const package_ = this.getPackageForFernFilepath(fernFilepath);
     if (package_.docs != null) {
-      throw new Error("Found duplicate docs for package");
+      throw new CliError({ message: "Found duplicate docs for package", code: CliError.Code.InternalError });
     }
     package_.docs = docs2;
   }
@@ -558324,21 +558481,30 @@ var PackageTreeGenerator = class {
   addService(serviceId, service) {
     const package_ = this.getPackageForFernFilepath(service.name.fernFilepath);
     if (package_.service != null) {
-      throw new Error("Found duplicate service for " + serviceId);
+      throw new CliError({
+        message: "Found duplicate service for " + serviceId,
+        code: CliError.Code.InternalError
+      });
     }
     package_.service = serviceId;
   }
   addWebhookGroup(webhookGroupId, fernFilepath) {
     const package_ = this.getPackageForFernFilepath(fernFilepath);
     if (package_.webhooks != null) {
-      throw new Error("Found duplicate webhook group for " + webhookGroupId);
+      throw new CliError({
+        message: "Found duplicate webhook group for " + webhookGroupId,
+        code: CliError.Code.InternalError
+      });
     }
     package_.webhooks = webhookGroupId;
   }
   addWebSocketChannel(websocketChannelId, fernFilepath) {
     const package_ = this.getPackageForFernFilepath(fernFilepath);
     if (package_.webhooks != null) {
-      throw new Error("Found duplicate webhook group for " + websocketChannelId);
+      throw new CliError({
+        message: "Found duplicate webhook group for " + websocketChannelId,
+        code: CliError.Code.InternalError
+      });
     }
     package_.websocket = websocketChannelId;
   }
@@ -558381,24 +558547,33 @@ var PackageTreeGenerator = class {
   }
   sortRootPackage(subpackagesInOrder) {
     if (!isEqualIgnoreOrder(this.rootPackage.subpackages, subpackagesInOrder)) {
-      throw new Error("Sorted subpackages differ from unsorted packages in root");
+      throw new CliError({
+        message: "Sorted subpackages differ from unsorted packages in root",
+        code: CliError.Code.InternalError
+      });
     }
     this.rootPackage.subpackages = subpackagesInOrder;
   }
   sortSubpackage(subpackageId, subpackagesInOrder) {
     const subpackage = this.subpackages[subpackageId];
     if (subpackage == null) {
-      throw new Error("Subpackage does not exist: " + subpackageId);
+      throw new CliError({
+        message: "Subpackage does not exist: " + subpackageId,
+        code: CliError.Code.ResolutionError
+      });
     }
     if (!isEqualIgnoreOrder(subpackage.subpackages, subpackagesInOrder)) {
-      throw new Error("Sorted subpackages differ from unsorted packages");
+      throw new CliError({
+        message: "Sorted subpackages differ from unsorted packages",
+        code: CliError.Code.InternalError
+      });
     }
     subpackage.subpackages = subpackagesInOrder;
   }
   getAllSubpackagesWithEndpoints(root6) {
     const subpackage = this.subpackages[root6];
     if (subpackage == null) {
-      throw new Error("Subpackage does not exist: " + root6);
+      throw new CliError({ message: "Subpackage does not exist: " + root6, code: CliError.Code.ResolutionError });
     }
     const subpackagesWithEndpoints = this.getAllChildrenWithEndpoints(subpackage);
     if (subpackagesWithEndpoints.length > 0 || subpackage.service != null) {
@@ -558419,7 +558594,10 @@ var PackageTreeGenerator = class {
     const subpackagesInParent = parent.subpackages.map((subpackageId) => {
       const subpackage = this.subpackages[subpackageId];
       if (subpackage == null) {
-        throw new Error("Subpackage ID is invalid: " + subpackageId);
+        throw new CliError({
+          message: "Subpackage ID is invalid: " + subpackageId,
+          code: CliError.Code.InternalError
+        });
       }
       return subpackage;
     });
@@ -558498,7 +558676,10 @@ var EndpointResolverImpl = class {
   resolveEndpointOrThrow({ endpoint: endpoint3, file: file4 }) {
     const resolvedEndpoint = this.resolveEndpoint({ endpoint: endpoint3, file: file4 });
     if (resolvedEndpoint == null) {
-      throw new Error("Cannot resolve endpoint: " + endpoint3 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve endpoint: " + endpoint3 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedEndpoint;
   }
@@ -558626,7 +558807,10 @@ var ErrorResolverImpl = class {
   getDeclarationOrThrow(referenceToError, file4) {
     const declaration = this.getDeclaration(referenceToError, file4);
     if (declaration == null) {
-      throw new Error("Error does not exist: " + referenceToError);
+      throw new CliError({
+        message: "Error does not exist: " + referenceToError,
+        code: CliError.Code.ResolutionError
+      });
     }
     return declaration;
   }
@@ -558712,7 +558896,7 @@ var ExampleResolverImpl = class {
   resolveAllReferencesInExampleOrThrow({ example, file: file4 }) {
     const resolvedExample = this.resolveAllReferencesInExample({ example, file: file4 });
     if (resolvedExample == null) {
-      throw new Error("Failed to resolve examples");
+      throw new CliError({ message: "Failed to resolve examples", code: CliError.Code.ResolutionError });
     }
     return resolvedExample;
   }
@@ -558759,7 +558943,7 @@ var ExampleResolverImpl = class {
   resolveExampleOrThrow({ example, file: file4 }) {
     const resolvedExample = this.resolveExample({ example, file: file4 });
     if (resolvedExample == null) {
-      throw new Error("Cannot resolve example: " + example);
+      throw new CliError({ message: "Cannot resolve example: " + example, code: CliError.Code.ResolutionError });
     }
     return resolvedExample;
   }
@@ -558810,7 +558994,10 @@ var PropertyResolverImpl = class {
   resolveRequestPropertyOrThrow({ file: file4, endpoint: endpoint3, propertyComponents }) {
     const resolvedRequestProperty = this.resolveRequestProperty({ file: file4, endpoint: endpoint3, propertyComponents });
     if (resolvedRequestProperty == null) {
-      throw new Error("Cannot resolve request property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve request property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedRequestProperty;
   }
@@ -558854,7 +559041,10 @@ var PropertyResolverImpl = class {
   resolveResponsePropertyOrThrow({ file: file4, endpoint: endpoint3, propertyComponents }) {
     const resolvedResponseProperty = this.resolveResponseProperty({ file: file4, endpoint: endpoint3, propertyComponents });
     if (resolvedResponseProperty == null) {
-      throw new Error("Cannot resolve response property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve response property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedResponseProperty;
   }
@@ -559021,7 +559211,10 @@ var PropertyResolverImpl = class {
         propertyComponents: breadcrumbs
       });
       if (!currentType) {
-        throw new Error(`Cannot find property '${breadcrumbs.join(".")}' in inline request body in file ${file4.relativeFilepath}`);
+        throw new CliError({
+          message: `Cannot find property '${breadcrumbs.join(".")}' in inline request body in file ${file4.relativeFilepath}`,
+          code: CliError.Code.InternalError
+        });
       }
       result.push({
         name: file4.casingsGenerator.generateName(component),
@@ -559039,7 +559232,10 @@ function getNestedObjectPropertyTypeOrThrow({ typeResolver, file: file4, resolve
     propertyName
   });
   if (!nestedPropertyType) {
-    throw new Error(`Cannot find property '${breadcrumbs.join(".")}' in ${rootTypeLabel}`);
+    throw new CliError({
+      message: `Cannot find property '${breadcrumbs.join(".")}' in ${rootTypeLabel}`,
+      code: CliError.Code.InternalError
+    });
   }
   return nestedPropertyType;
 }
@@ -559216,14 +559412,20 @@ var TypeResolverImpl = class {
   resolveTypeOrThrow({ type: type8, file: file4 }) {
     const resolvedType = this.resolveType({ type: type8, file: file4 });
     if (resolvedType == null) {
-      throw new Error("Cannot resolve type: " + type8 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve type: " + type8 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedType;
   }
   getDeclarationOfNamedTypeOrThrow({ referenceToNamedType, file: file4 }) {
     const declaration = this.getDeclarationOfNamedType({ referenceToNamedType, file: file4 });
     if (declaration == null) {
-      throw new Error("Cannot find declaration of type: " + referenceToNamedType + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot find declaration of type: " + referenceToNamedType + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return declaration;
   }
@@ -559366,7 +559568,10 @@ var TypeResolverImpl = class {
   resolveNamedTypeOrThrow({ referenceToNamedType, file: file4 }) {
     const resolvedType = this.resolveNamedType({ referenceToNamedType, file: file4 });
     if (resolvedType == null) {
-      throw new Error("Cannot resolve type: " + referenceToNamedType);
+      throw new CliError({
+        message: "Cannot resolve type: " + referenceToNamedType,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedType;
   }
@@ -559425,7 +559630,10 @@ var VariableResolverImpl = class _VariableResolverImpl {
   getDeclarationOrThrow(referenceToVariable, file4) {
     const declaration = this.getDeclaration(referenceToVariable, file4);
     if (declaration == null) {
-      throw new Error("Variable does not exist: " + referenceToVariable);
+      throw new CliError({
+        message: "Variable does not exist: " + referenceToVariable,
+        code: CliError.Code.ResolutionError
+      });
     }
     return declaration;
   }
@@ -559448,7 +559656,10 @@ var VariableResolverImpl = class _VariableResolverImpl {
   getVariableIdOrThrow(referenceToVariable) {
     const variableId = this.getVariableId(referenceToVariable);
     if (variableId == null) {
-      throw new Error("Variable reference does not start with " + _VariableResolverImpl.VARIABLE_PREFIX);
+      throw new CliError({
+        message: "Variable reference does not start with " + _VariableResolverImpl.VARIABLE_PREFIX,
+        code: CliError.Code.ResolutionError
+      });
     }
     return variableId;
   }
@@ -559620,7 +559831,10 @@ function generateIntermediateRepresentation({ workspace, generationLanguage, key
         }
         const errorDiscriminationSchema = workspace.definition.rootApiFile.contents["error-discrimination"];
         if (errorDiscriminationSchema == null) {
-          throw new Error("error-discrimination is missing in api.yml but there are declared errors.");
+          throw new CliError({
+            message: "error-discrimination is missing in api.yml but there are declared errors.",
+            code: CliError.Code.ConfigError
+          });
         }
         for (const [errorName, errorDeclaration] of Object.entries(errors4)) {
           const convertedErrorDeclaration = convertErrorDeclaration({
@@ -614356,7 +614570,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.81.0-3-gaa0d9a2b5d2",
+          version: "4.81.0-9-ge0476cd3e22",
           usingAccessToken: true
         }
       });
@@ -614410,7 +614624,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.81.0-3-gaa0d9a2b5d2",
+        version: "4.81.0-9-ge0476cd3e22",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -615614,7 +615828,10 @@ var PlatformKeyring = class {
         await this.setPasswordWindows(service, account, password);
         break;
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async getPassword(service, account) {
@@ -615626,7 +615843,10 @@ var PlatformKeyring = class {
       case "win32":
         return this.getPasswordWindows(service, account);
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async deletePassword(service, account) {
@@ -615638,7 +615858,10 @@ var PlatformKeyring = class {
       case "win32":
         return this.deletePasswordWindows(service, account);
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async findCredentials(service) {
@@ -615650,7 +615873,10 @@ var PlatformKeyring = class {
       case "win32":
         return this.findCredentialsWindows(service);
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async setPasswordDarwin(service, account, password) {
@@ -617763,7 +617989,10 @@ var FileFinder = class {
   async findOrThrow({ filename, remediationMessage }) {
     const filepath = await this.find({ filename });
     if (filepath == null) {
-      throw new Error(`${filename} file not found in any parent directory from ${this.from}`);
+      throw new CliError({
+        message: `${filename} file not found in any parent directory from ${this.from}`,
+        code: CliError.Code.InternalError
+      });
     }
     return filepath;
   }
@@ -617805,7 +618034,10 @@ var FernYmlSchemaLoader = class {
   async loadOrThrow() {
     const loadResult = await this.load();
     if (loadResult.type === "notFound") {
-      throw new Error(`${FILENAME2} file not found in any parent directory; did you forget to run \`fern init\`?`);
+      throw new CliError({
+        message: `${FILENAME2} file not found in any parent directory; did you forget to run \`fern init\`?`,
+        code: CliError.Code.InternalError
+      });
     }
     if (loadResult.type === "failure") {
       throw new SourcedValidationError(loadResult.issues);
@@ -617876,7 +618108,10 @@ var TelemetryClient = class _TelemetryClient {
     if (sentryDsn != null && sentryDsn.length > 0 && isTelemetryEnabled) {
       const sentryEnvironment = "development";
       if (sentryEnvironment == null || sentryEnvironment.length === 0) {
-        throw new Error("SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured");
+        throw new CliError({
+          message: "SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured",
+          code: CliError.Code.ConfigError
+        });
       }
       this.sentry = init2({
         dsn: sentryDsn,
@@ -618176,7 +618411,10 @@ var ApiDefinitionConverter = class {
         sourced
       });
     }
-    throw new Error(`Unknown spec type: ${JSON.stringify(spec)}`);
+    throw new CliError({
+      message: `Unknown spec type: ${JSON.stringify(spec)}`,
+      code: CliError.Code.InternalError
+    });
   }
   async convertOpenApiSpec({ absoluteFernYmlPath, spec, sourced }) {
     const result = {
@@ -619536,7 +619774,10 @@ var LegacyApiSpecAdapter = class {
     if (isOpenRpcSpec(spec)) {
       return this.adaptOpenRpcSpec(spec);
     }
-    throw new Error(`Unsupported spec type: ${JSON.stringify(spec)}`);
+    throw new CliError({
+      message: `Unsupported spec type: ${JSON.stringify(spec)}`,
+      code: CliError.Code.InternalError
+    });
   }
   convertAll(specs) {
     return specs.map((spec) => this.adapt(spec));
@@ -746685,7 +746926,10 @@ var LegacyFernWorkspaceAdapter = class {
       generatorsConfiguration: apiConfig != null ? this.buildGeneratorsConfiguration(apiConfig) : void 0
     });
     if (ossWorkspace == null) {
-      throw new Error("Internal error; failed to build API definitions");
+      throw new CliError({
+        message: "Internal error; failed to build API definitions",
+        code: CliError.Code.InternalError
+      });
     }
     return ossWorkspace.toFernWorkspace({ context: this.taskContext });
   }
@@ -747842,7 +748086,10 @@ function addSplitCommand(cli) {
     description: `Output format: '${OVERLAY_NAME}' (OpenAPI Overlay 1.0.0) or '${OVERRIDES_NAME}' (Fern deep-merge)`
   }).coerce("format", (value2) => {
     if (!ALL_FORMAT_NAMES.includes(value2)) {
-      throw new Error(`Invalid format '${value2}'. Expected one of: ${OVERLAY_NAME}, ${OVERRIDES_NAME}`);
+      throw new CliError({
+        message: `Invalid format '${value2}'. Expected one of: ${OVERLAY_NAME}, ${OVERRIDES_NAME}`,
+        code: CliError.Code.ValidationError
+      });
     }
     return value2;
   }));
@@ -827894,7 +828141,7 @@ var DocsWorkspaceValidator = class {
     const startTime = performance.now();
     if (workspace.config.settings?.substituteEnvVars) {
       workspace.config = replaceEnvVariables(workspace.config, {
-        onError: (error50) => this.taskContext.failAndThrow(error50)
+        onError: (error50) => this.taskContext.failAndThrow(error50, void 0, { code: CliError.Code.ConfigError })
       });
     }
     const violations = await validateDocsWorkspace(workspace, this.taskContext, apiWorkspaces, ossWorkspaces, false, excludeRules);
@@ -831728,7 +831975,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.81.0-3-gaa0d9a2b5d2";
+  const version7 = "4.81.0-9-ge0476cd3e22";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -843295,7 +843542,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.81.0-3-gaa0d9a2b5d2"
+        cliVersion: "4.81.0-9-ge0476cd3e22"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -843770,7 +844017,10 @@ var DocsTask = class {
   getTask() {
     const task = this.taskGroup.getTask(this.id);
     if (task == null) {
-      throw new Error(`Internal error; task '${this.id}' does not exist`);
+      throw new CliError({
+        message: `Internal error; task '${this.id}' does not exist`,
+        code: CliError.Code.InternalError
+      });
     }
     return task;
   }
@@ -845042,7 +845292,10 @@ var Wizard = class {
   async fetchApiFromUrl(url3, specFormat) {
     const response = await fetch(url3, { signal: AbortSignal.timeout(FETCH_API_SPEC_REQUEST_TIMEOUT_MS) });
     if (!response.ok) {
-      throw new Error(`HTTP ${response.status} ${response.statusText}`);
+      throw new CliError({
+        message: `HTTP ${response.status} ${response.statusText}`,
+        code: CliError.Code.NetworkError
+      });
     }
     const content5 = await response.text();
     const filename = this.resolveFilenameFromUrl({ url: url3, specFormat });
@@ -846572,20 +846825,29 @@ var ApiSpecDetector = class {
   async detect({ absoluteFilePath, reference: reference4, content: content5 }) {
     const parsed = this.parseOrThrow({ content: content5, reference: reference4 });
     if (typeof parsed !== "object" || parsed == null) {
-      throw new Error(`Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`);
+      throw new CliError({
+        message: `Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`,
+        code: CliError.Code.InternalError
+      });
     }
     for (const specType of DETECTABLE_SPEC_TYPES) {
       if (specType in parsed) {
         return specType;
       }
     }
-    throw new Error(`Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`);
+    throw new CliError({
+      message: `Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`,
+      code: CliError.Code.InternalError
+    });
   }
   parseOrThrow({ content: content5, reference: reference4 }) {
     try {
       return jsYaml.load(content5);
     } catch {
-      throw new Error(`Could not parse "${reference4}" as YAML or JSON. Ensure the file is a valid OpenAPI or AsyncAPI specification.`);
+      throw new CliError({
+        message: `Could not parse "${reference4}" as YAML or JSON. Ensure the file is a valid OpenAPI or AsyncAPI specification.`,
+        code: CliError.Code.ParseError
+      });
     }
   }
 };
@@ -846623,7 +846885,10 @@ var ApiSpecResolver = class {
   async resolveLocal({ reference: reference4 }) {
     const absoluteFilePath = resolve6(this.context.cwd, reference4);
     if (!await doesPathExist(absoluteFilePath)) {
-      throw new Error(`API spec file does not exist: ${reference4}`);
+      throw new CliError({
+        message: `API spec file does not exist: ${reference4}`,
+        code: CliError.Code.ConfigError
+      });
     }
     const content5 = await (0, import_promises92.readFile)(absoluteFilePath, "utf-8");
     const specType = await this.detector.detect({ absoluteFilePath, content: content5, reference: reference4 });
@@ -846636,11 +846901,17 @@ var ApiSpecResolver = class {
   async fetchContent({ url: url3 }) {
     const response = await fetch(url3, { signal: AbortSignal.timeout(FETCH_API_SPEC_REQUEST_TIMEOUT_MS) });
     if (!response.ok) {
-      throw new Error(`Failed to fetch "${url3}": HTTP ${response.status} ${response.statusText}`);
+      throw new CliError({
+        message: `Failed to fetch "${url3}": HTTP ${response.status} ${response.statusText}`,
+        code: CliError.Code.NetworkError
+      });
     }
     const contentType = response.headers.get("content-type") ?? "";
     if (contentType.includes("text/html")) {
-      throw new Error(`The URL "${url3}" returned HTML content. Ensure you're pointing to a raw spec URL, not a documentation page.`);
+      throw new CliError({
+        message: `The URL "${url3}" returned HTML content. Ensure you're pointing to a raw spec URL, not a documentation page.`,
+        code: CliError.Code.ConfigError
+      });
     }
     const content5 = await response.text();
     return { content: content5, contentType };
@@ -846665,7 +846936,10 @@ var ApiSpecResolver = class {
       case "asyncapi":
         return { asyncapi: absoluteFilePath, origin: origin2 };
       default:
-        throw new Error(`Unsupported spec type for flags mode: "${specType}". Supported: openapi, asyncapi`);
+        throw new CliError({
+          message: `Unsupported spec type for flags mode: "${specType}". Supported: openapi, asyncapi`,
+          code: CliError.Code.ConfigError
+        });
     }
   }
   isUrl(reference4) {
@@ -897467,7 +897741,10 @@ var LegacyGeneratorInvocationAdapter = class {
     }
     const absolutePath = join8(this.context.cwd, RelativeFilePath2.of(license));
     if (!await doesPathExist(absolutePath, "file")) {
-      throw new Error(`Custom license file "${absolutePath}" does not exist; did you mean to use either MIT or Apache-2.0?`);
+      throw new CliError({
+        message: `Custom license file "${absolutePath}" does not exist; did you mean to use either MIT or Apache-2.0?`,
+        code: CliError.Code.InternalError
+      });
     }
     const contents = await (0, import_promises106.readFile)(absolutePath, "utf-8");
     return api_exports4.GithubLicense.custom({ contents });
@@ -897975,7 +898252,10 @@ var SdkTask = class {
   getTask() {
     const task = this.taskGroup.getTask(this.id);
     if (task == null) {
-      throw new Error(`Internal error; task '${this.id}' does not exist`);
+      throw new CliError({
+        message: `Internal error; task '${this.id}' does not exist`,
+        code: CliError.Code.InternalError
+      });
     }
     return task;
   }
@@ -898207,7 +898487,7 @@ var GenerateCommand = class {
   }
   async runGeneration({ context: context3, workspace, targets: targets2, args, forceLocal }) {
     if (workspace.sdks == null) {
-      throw new Error("No SDKs configured");
+      throw new CliError({ message: "No SDKs configured", code: CliError.Code.InternalError });
     }
     const apisToCheck = [...new Set(targets2.map((t3) => t3.api))];
     const apiChecker = new ApiChecker({
@@ -898889,7 +899169,10 @@ var GeneratorMigrator = class _GeneratorMigrator {
         const packageJsonContent = await (0, import_promises110.readFile)(packageJsonPath, "utf-8");
         const packageJson2 = JSON.parse(packageJsonContent);
         if (packageJson2.main == null) {
-          throw new Error(`No main field found in package.json for ${MIGRATION_PACKAGE_NAME}`);
+          throw new CliError({
+            message: `No main field found in package.json for ${MIGRATION_PACKAGE_NAME}`,
+            code: CliError.Code.InternalError
+          });
         }
         const packageEntryPoint = (0, import_path80.join)(packageDir, packageJson2.main);
         const { migrations } = await import((0, import_url8.pathToFileURL)(packageEntryPoint).href);
@@ -899004,11 +899287,14 @@ var GeneratorMigrator = class _GeneratorMigrator {
         this.logger.debug(`No migration package found for ${generatorName}.`);
         return void 0;
       }
-      throw new Error(`Failed to load generator migrations for ${generatorName}.
+      throw new CliError({
+        message: `Failed to load generator migrations for ${generatorName}.
 
 Reason: ${errorMessage}
 
-Please check your internet connection and npm configuration, then try again.`);
+Please check your internet connection and npm configuration, then try again.`,
+        code: CliError.Code.InternalError
+      });
     }
   }
   /**
@@ -899037,7 +899323,10 @@ Please check your internet connection and npm configuration, then try again.`);
       const aVersion = import_semver14.default.parse(a4.version);
       const bVersion = import_semver14.default.parse(b7.version);
       if (aVersion == null || bVersion == null) {
-        throw new Error(`Internal error: Invalid migration version found during sort. Version A: ${a4.version}, Version B: ${b7.version}. This should not happen as invalid versions are filtered out.`);
+        throw new CliError({
+          message: `Internal error: Invalid migration version found during sort. Version A: ${a4.version}, Version B: ${b7.version}. This should not happen as invalid versions are filtered out.`,
+          code: CliError.Code.InternalError
+        });
       }
       return import_semver14.default.compare(aVersion, bVersion);
     });
@@ -899055,11 +899344,14 @@ Please check your internet connection and npm configuration, then try again.`);
         appliedVersions.push(migration23.version);
       } catch (error50) {
         const errorMessage = extractErrorMessage(error50);
-        throw new Error(`Failed to apply migration for version ${migration23.version}.
+        throw new CliError({
+          message: `Failed to apply migration for version ${migration23.version}.
 
 Reason: ${errorMessage}
 
-Please report this issue at: https://github.com/fern-api/fern/issues`);
+Please report this issue at: https://github.com/fern-api/fern/issues`,
+          code: CliError.Code.InternalError
+        });
       }
     }
     return {
@@ -918415,7 +918707,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.81.0-3-gaa0d9a2b5d2";
+    return "4.81.0-9-ge0476cd3e22";
   }
   getCliName() {
     if (false) {