@fern-api/fern-api-dev 3.28.0 → 3.29.0

package/cli.cjs

@@ -1413817,7 +1413817,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.28.0",
+          version: "3.29.0",
           usingAccessToken: true
         }
       });
@@ -1413916,7 +1413916,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.28.0",
+        version: "3.29.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1493982,7 +1493982,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.28.0";
+    return "3.29.0";
   }
   getCliName() {
     if (false) {
@@ -1588481,7 +1588481,7 @@ var import_path35 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version6 = "3.28.0";
+  const version6 = "3.29.0";
   return `cli@${version6}`;
 }
 var DebugLogger = class {
@@ -1605297,6 +1605297,110 @@ async function previewDocsWorkspace({
   return;
 }
 
+// src/commands/docs-preview/deleteDocsPreview.ts
+var PREVIEW_URL_PATTERN = /^[a-z0-9-]+-preview-[a-z0-9]+\.docs\.buildwithfern\.com$/i;
+function isPreviewUrl(url2) {
+  let hostname = url2.toLowerCase().trim();
+  if (hostname.startsWith("https://")) {
+    hostname = hostname.slice(8);
+  } else if (hostname.startsWith("http://")) {
+    hostname = hostname.slice(7);
+  }
+  const slashIndex = hostname.indexOf("/");
+  if (slashIndex !== -1) {
+    hostname = hostname.slice(0, slashIndex);
+  }
+  return PREVIEW_URL_PATTERN.test(hostname);
+}
+async function deleteDocsPreview({
+  cliContext,
+  previewUrl
+}) {
+  if (!isPreviewUrl(previewUrl)) {
+    cliContext.failAndThrow(
+      `Invalid preview URL: ${previewUrl}
+Only preview sites can be deleted with this command.
+Preview URLs follow the pattern: {org}-preview-{hash}.docs.buildwithfern.com
+Example: acme-preview-abc123.docs.buildwithfern.com`
+    );
+    return;
+  }
+  const token = await cliContext.runTask(async (context2) => {
+    return askToLogin(context2);
+  });
+  if (token == null) {
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    return;
+  }
+  await cliContext.runTask(async (context2) => {
+    context2.logger.info(`Deleting preview site: ${previewUrl}`);
+    const fdr = createFdrService({ token: token.value });
+    const deleteResponse = await fdr.docs.v2.write.deleteDocsSite({
+      url: previewUrl
+    });
+    if (deleteResponse.ok) {
+      context2.logger.info(source_default.green(`Successfully deleted preview site: ${previewUrl}`));
+    } else {
+      switch (deleteResponse.error.error) {
+        case "UnauthorizedError":
+          return context2.failAndThrow(
+            "You do not have permissions to delete this preview site. Reach out to support@buildwithfern.com"
+          );
+        case "DocsNotFoundError":
+          return context2.failAndThrow(`Preview site not found: ${previewUrl}`);
+        default:
+          return context2.failAndThrow(`Failed to delete preview site: ${previewUrl}`, deleteResponse.error);
+      }
+    }
+  });
+}
+
+// src/commands/docs-preview/listDocsPreview.ts
+async function listDocsPreview({
+  cliContext,
+  limit,
+  page
+}) {
+  const token = await cliContext.runTask(async (context2) => {
+    return askToLogin(context2);
+  });
+  if (token == null) {
+    cliContext.failAndThrow("Failed to authenticate. Please run 'fern login' first.");
+    return;
+  }
+  await cliContext.runTask(async (context2) => {
+    context2.logger.info("Fetching preview deployments...");
+    const fdr = createFdrService({ token: token.value });
+    const listResponse = await fdr.docs.v2.read.listAllDocsUrls({
+      page,
+      limit: limit ?? 100
+    });
+    if (!listResponse.ok) {
+      return context2.failAndThrow("Failed to fetch docs URLs", listResponse.error);
+    }
+    const previewUrlPattern = /-preview-[a-f0-9]+\.docs\.buildwithfern\.com$/;
+    const previewDeployments = listResponse.body.urls.filter((item) => previewUrlPattern.test(item.domain)).map((item) => ({
+      url: item.basePath != null ? `${item.domain}${item.basePath}` : item.domain,
+      organizationId: item.organizationId,
+      updatedAt: item.updatedAt
+    }));
+    if (previewDeployments.length === 0) {
+      context2.logger.info("No preview deployments found.");
+      return;
+    }
+    context2.logger.info(source_default.bold(`
+Found ${previewDeployments.length} preview deployment(s):
+`));
+    for (const deployment of previewDeployments) {
+      const updatedDate = new Date(deployment.updatedAt).toLocaleString();
+      context2.logger.info(`  ${source_default.cyan(deployment.url)}`);
+      context2.logger.info(`    Organization: ${deployment.organizationId}`);
+      context2.logger.info(`    Updated: ${updatedDate}
+`);
+    }
+  });
+}
+
 // src/commands/downgrade/downgrade.ts
 var import_promises80 = require("fs/promises");
 
@@ -1646710,12 +1646814,63 @@ function addWriteDefinitionCommand(cli, cliContext) {
 }
 function addDocsCommand(cli, cliContext) {
   cli.command("docs", "Commands for managing your docs", (yargs) => {
-    addDocsPreviewCommand(yargs, cliContext);
+    addDocsDevCommand(yargs, cliContext);
     addDocsBrokenLinksCommand(yargs, cliContext);
+    addDocsPreviewCommand(yargs, cliContext);
     return yargs;
   });
 }
 function addDocsPreviewCommand(cli, cliContext) {
+  cli.command("preview", "Commands for managing preview deployments", (yargs) => {
+    addDocsPreviewListCommand(yargs, cliContext);
+    addDocsPreviewDeleteCommand(yargs, cliContext);
+    return yargs;
+  });
+}
+function addDocsPreviewListCommand(cli, cliContext) {
+  cli.command(
+    "list",
+    "List all preview deployments",
+    (yargs) => yargs.option("limit", {
+      type: "number",
+      description: "Maximum number of preview deployments to display"
+    }).option("page", {
+      type: "number",
+      description: "Page number for pagination (starts at 1)"
+    }),
+    async (argv) => {
+      await cliContext.instrumentPostHogEvent({
+        command: "fern docs preview list"
+      });
+      await listDocsPreview({
+        cliContext,
+        limit: argv.limit,
+        page: argv.page
+      });
+    }
+  );
+}
+function addDocsPreviewDeleteCommand(cli, cliContext) {
+  cli.command(
+    "delete <url>",
+    "Delete a preview deployment",
+    (yargs) => yargs.positional("url", {
+      type: "string",
+      description: "The FQDN of the preview deployment to delete (e.g. acme-preview-abc123.docs.buildwithfern.com)",
+      demandOption: true
+    }),
+    async (argv) => {
+      await cliContext.instrumentPostHogEvent({
+        command: "fern docs preview delete"
+      });
+      await deleteDocsPreview({
+        cliContext,
+        previewUrl: argv.url
+      });
+    }
+  );
+}
+function addDocsDevCommand(cli, cliContext) {
   cli.command(
     "dev",
     "Run a local development server to preview your docs",

package/package.json

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