@fern-api/fern-api-dev 3.42.3 → 3.43.0

package/cli.cjs

@@ -1309445,7 +1309445,8 @@ var ExperimentalConfig = schemas_exports.object({
   openapiParserV3: schemas_exports.property("openapi-parser-v3", schemas_exports.boolean().optional()),
   dynamicSnippets: schemas_exports.property("dynamic-snippets", schemas_exports.boolean().optional()),
   aiExamples: schemas_exports.property("ai-examples", schemas_exports.boolean().optional()),
-  aiExampleStyleInstructions: schemas_exports.property("ai-example-style-instructions", schemas_exports.string().optional())
+  aiExampleStyleInstructions: schemas_exports.property("ai-example-style-instructions", schemas_exports.string().optional()),
+  excludeApis: schemas_exports.property("exclude-apis", schemas_exports.boolean().optional())
 });
 
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/AiChatModel.js
@@ -1415659,7 +1415660,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.42.3",
+          version: "3.43.0",
           usingAccessToken: true
         }
       });
@@ -1415758,7 +1415759,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.42.3",
+        version: "3.43.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1495952,7 +1495953,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.42.3";
+    return "3.43.0";
   }
   getCliName() {
     if (false) {
@@ -1546283,6 +1546284,16 @@ var definitions4 = {
             type: "null"
           }
         ]
+      },
+      "exclude-apis": {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
       }
     },
     additionalProperties: false
@@ -1591733,7 +1591744,7 @@ var import_path37 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version6 = "3.42.3";
+  const version6 = "3.43.0";
   return `cli@${version6}`;
 }
 var DebugLogger = class {
@@ -1610734,7 +1610745,8 @@ function getErrorTypeNameKey(declaredErrorName) {
 async function generateOpenAPIForWorkspaces({
   project,
   cliContext,
-  outputPath
+  outputPath,
+  indent: indent3
 }) {
   await Promise.all(
     project.apiWorkspaces.map(async (workspace) => {
@@ -1610761,7 +1610773,7 @@ async function generateOpenAPIForWorkspaces({
         await (0, import_promises84.mkdir)(dirname2(outputPath), { recursive: true });
         await (0, import_promises84.writeFile)(
           outputPath,
-          outputPath.endsWith(".json") ? JSON.stringify(openapi, void 0, 2) : jsYaml.dump(openapi)
+          outputPath.endsWith(".json") ? JSON.stringify(openapi, void 0, indent3) : jsYaml.dump(openapi, { indent: indent3 })
         );
       });
     })
@@ -1626832,9 +1626844,12 @@ async function calculateFileHash(absoluteFilePath) {
   const fileBuffer = await (0, import_promises97.readFile)(absoluteFilePath);
   return (0, import_crypto9.createHash)("sha256").update(new Uint8Array(fileBuffer)).digest("hex");
 }
-async function publishDocs({ token, organization, docsWorkspace, domain: domain2, customDomains, apiWorkspaces, ossWorkspaces, context: context2, preview, editThisPage, isPrivate = false, disableTemplates = false, skipUpload = false, withAiExamples = true, targetAudiences }) {
+async function publishDocs({ token, organization, docsWorkspace, domain: domain2, customDomains, apiWorkspaces, ossWorkspaces, context: context2, preview, editThisPage, isPrivate = false, disableTemplates = false, skipUpload = false, withAiExamples = true, excludeApis = false, targetAudiences }) {
   const fdr = createFdrService({ token: token.value });
   const authConfig = isPrivate ? { type: "private", authType: "sso" } : { type: "public" };
+  if (excludeApis) {
+    context2.logger.debug("Experimental flag 'exclude-apis' is enabled - API references will be excluded from S3 upload");
+  }
   let docsRegistrationId;
   let urlToOutput = customDomains[0] ?? domain2;
   const basePath = parseBasePath(domain2);
@@ -1627103,7 +1627118,7 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
   const publishStart = performance.now();
   const registerDocsResponse = await fdr.docs.v2.write.finishDocsRegister(DocsV1Write_exports.DocsRegistrationId(docsRegistrationId), {
     docsDefinition,
-    excludeApis: false,
+    excludeApis,
     libraryDocs: libraryDocsConfig
   });
   if (registerDocsResponse.ok) {
@@ -1627693,6 +1627708,7 @@ async function runRemoteGenerationForDocsWorkspace({ organization, apiWorkspaces
       disableTemplates,
       skipUpload,
       withAiExamples: docsWorkspace.config.aiExamples?.enabled ?? docsWorkspace.config.experimental?.aiExamples ?? true,
+      excludeApis: docsWorkspace.config.experimental?.excludeApis ?? false,
       targetAudiences: maybeInstance.audiences ? Array.isArray(maybeInstance.audiences) ? maybeInstance.audiences : [maybeInstance.audiences] : void 0
     });
     const publishTime = performance.now() - publishStart;
@@ -1639471,7 +1639487,7 @@ var fs22 = __toESM(require("fs"), 1);
 var import_promises104 = require("fs/promises");
 var import_stream9 = require("stream");
 var import_promises105 = require("stream/promises");
-async function fetchAndWriteFile(url2, path69, logger) {
+async function fetchAndWriteFile(url2, path69, logger, indent3) {
   const resp = await fetch(url2);
   if (resp.ok && resp.body) {
     logger.debug("Origin successfully fetched, writing to file");
@@ -1639479,16 +1639495,17 @@ async function fetchAndWriteFile(url2, path69, logger) {
     await (0, import_promises105.finished)(import_stream9.Readable.fromWeb(resp.body).pipe(fileStream));
     const fileContents = await (0, import_promises104.readFile)(path69, "utf8");
     try {
-      await (0, import_promises104.writeFile)(path69, JSON.stringify(JSON.parse(fileContents), void 0, 2), "utf8");
+      await (0, import_promises104.writeFile)(path69, JSON.stringify(JSON.parse(fileContents), void 0, indent3), "utf8");
     } catch (e6) {
-      await (0, import_promises104.writeFile)(path69, jsYaml.dump(jsYaml.load(fileContents)), "utf8");
+      await (0, import_promises104.writeFile)(path69, jsYaml.dump(jsYaml.load(fileContents), { indent: indent3 }), "utf8");
     }
     logger.debug("File written successfully");
   }
 }
 async function updateApiSpec({
   cliContext,
-  project: { apiWorkspaces }
+  project: { apiWorkspaces },
+  indent: indent3
 }) {
   for (const workspace of apiWorkspaces) {
     if (workspace.type === "fern") {
@@ -1639512,7 +1639529,8 @@ async function updateApiSpec({
           await processDefinitions({
             cliContext,
             workspacePath: workspace.absoluteFilePath,
-            apiLocations: generatorConfig.api.definitions
+            apiLocations: generatorConfig.api.definitions,
+            indent: indent3
           });
           return;
         } else if (generatorConfig.api.type === "multiNamespace") {
@@ -1639520,14 +1639538,16 @@ async function updateApiSpec({
             await processDefinitions({
               cliContext,
               workspacePath: workspace.absoluteFilePath,
-              apiLocations: generatorConfig.api.rootDefinitions
+              apiLocations: generatorConfig.api.rootDefinitions,
+              indent: indent3
             });
           }
           for (const [_15, apiLocations] of Object.entries(generatorConfig.api.definitions)) {
             await processDefinitions({
               cliContext,
               workspacePath: workspace.absoluteFilePath,
-              apiLocations
+              apiLocations,
+              indent: indent3
             });
           }
         }
@@ -1639539,7 +1639559,8 @@ async function updateApiSpec({
 async function getAndFetchFromAPIDefinitionLocation({
   cliContext,
   workspacePath,
-  apiLocation
+  apiLocation,
+  indent: indent3
 }) {
   if (apiLocation.schema.type === "protobuf") {
     cliContext.logger.info("Encountered conjure API definition, skipping API update.");
@@ -1639550,20 +1639571,23 @@ async function getAndFetchFromAPIDefinitionLocation({
     await fetchAndWriteFile(
       apiLocation.origin,
       join2(workspacePath, RelativeFilePath2.of(apiLocation.schema.path)),
-      cliContext.logger
+      cliContext.logger,
+      indent3
     );
   }
 }
 async function processDefinitions({
   cliContext,
   workspacePath,
-  apiLocations
+  apiLocations,
+  indent: indent3
 }) {
   for (const apiLocation of apiLocations) {
     await getAndFetchFromAPIDefinitionLocation({
       cliContext,
       workspacePath,
-      apiLocation
+      apiLocation,
+      indent: indent3
     });
   }
 }
@@ -1645564,6 +1645588,10 @@ function addUpdateApiSpecCommand(cli, cliContext) {
     (yargs) => yargs.option("api", {
       string: true,
       description: "The API to update the spec for. If not specified, all APIs with a declared origin will be updated."
+    }).option("indent", {
+      type: "number",
+      description: "Indentation width in spaces (default: 2)",
+      default: 2
     }),
     async (argv) => {
       await cliContext.instrumentPostHogEvent({
@@ -1645574,7 +1645602,8 @@ function addUpdateApiSpecCommand(cli, cliContext) {
         project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
           commandLineApiWorkspace: argv.api,
           defaultToAllApiWorkspaces: true
-        })
+        }),
+        indent: argv.indent
       });
     }
   );
@@ -1646100,6 +1646129,10 @@ function addExportCommand(cli, cliContext) {
     }).option("api", {
       string: true,
       description: "Only run the command on the provided API"
+    }).option("indent", {
+      type: "number",
+      description: "Indentation width in spaces (default: 2)",
+      default: 2
     }),
     async (argv) => {
       await cliContext.instrumentPostHogEvent({
@@ -1646114,7 +1646147,8 @@ function addExportCommand(cli, cliContext) {
           defaultToAllApiWorkspaces: false
         }),
         cliContext,
-        outputPath: resolve(cwd(), argv.outputPath)
+        outputPath: resolve(cwd(), argv.outputPath),
+        indent: argv.indent
       });
     }
   );

package/package.json

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