@mintlify/cli 4.0.1341 → 4.0.1343

package/bin/addDomain.js

@@ -0,0 +1,90 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getRelativeRecordName } from '@mintlify/common';
+import { addLog, ErrorLog, removeLastLog, SpinnerLog, SuccessLog } from '@mintlify/previewing';
+import { Box, Text } from 'ink';
+import { authenticatedFetch } from './authenticatedFetch.js';
+import { getConfigValue } from './config.js';
+import { API_URL, CUSTOM_DOMAIN_CNAME_TARGET } from './constants.js';
+import { getAccessToken } from './keyring.js';
+import { getCliSubdomains } from './status.js';
+const DNS_POLL_INTERVAL_MS = 5000;
+const DNS_POLL_MAX_ATTEMPTS = 3;
+const DOMAIN_PATTERN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/i;
+export function addDomain(domain) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        if (!DOMAIN_PATTERN.test(domain)) {
+            addLog(_jsx(ErrorLog, { message: `invalid domain "${domain}". Expected a bare hostname, e.g. docs.example.com` }));
+            return;
+        }
+        const accessToken = yield getAccessToken();
+        if (!accessToken) {
+            addLog(_jsx(ErrorLog, { message: "not logged in. Run `mint login` to authenticate." }));
+            return;
+        }
+        const subdomains = yield getCliSubdomains(accessToken);
+        const configuredSubdomain = getConfigValue('subdomain');
+        const subdomain = configuredSubdomain && subdomains.includes(configuredSubdomain)
+            ? configuredSubdomain
+            : subdomains[0];
+        if (!subdomain) {
+            addLog(_jsx(ErrorLog, { message: "no subdomain found. Run `mint status` to check your account." }));
+            return;
+        }
+        try {
+            const addRes = yield authenticatedFetch(`${API_URL}/api/cli/deployment/custom-domain/${subdomain}/${domain}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ basePath: '' }),
+            });
+            if (!addRes.ok) {
+                const body = yield addRes.json().catch(() => ({}));
+                addLog(_jsx(ErrorLog, { message: `could not add domain: ${(_a = body.error) !== null && _a !== void 0 ? _a : 'unknown error'}` }));
+                return;
+            }
+        }
+        catch (_d) {
+            addLog(_jsx(ErrorLog, { message: "could not reach the server" }));
+            return;
+        }
+        const maxWaitSeconds = ((DNS_POLL_MAX_ATTEMPTS - 1) * DNS_POLL_INTERVAL_MS) / 1000;
+        addLog(_jsx(SpinnerLog, { message: `waiting for DNS records to generate (up to ${maxWaitSeconds}s)...` }));
+        let dnsRecords = [];
+        let recordsReady = false;
+        try {
+            for (let attempt = 0; attempt < DNS_POLL_MAX_ATTEMPTS; attempt++) {
+                const checkRes = yield authenticatedFetch(`${API_URL}/api/cli/deployment/custom-domain/${subdomain}/${domain}`);
+                if (checkRes.ok) {
+                    const body = (yield checkRes.json());
+                    dnsRecords = (_c = (_b = body.cloudflare) === null || _b === void 0 ? void 0 : _b.dnsRecords) !== null && _c !== void 0 ? _c : [];
+                    const stillGenerating = dnsRecords.some((record) => record.value === 'loading');
+                    if (dnsRecords.length > 0 && !stillGenerating) {
+                        recordsReady = true;
+                        break;
+                    }
+                }
+                if (attempt < DNS_POLL_MAX_ATTEMPTS - 1) {
+                    yield new Promise((resolve) => setTimeout(resolve, DNS_POLL_INTERVAL_MS));
+                }
+            }
+        }
+        catch (_e) {
+            removeLastLog();
+            addLog(_jsx(ErrorLog, { message: "domain added, but could not fetch DNS records" }));
+            return;
+        }
+        removeLastLog();
+        const readyTxtRecords = dnsRecords.filter((record) => record.type === 'TXT' && record.value !== 'loading');
+        addLog(_jsx(SuccessLog, { message: `domain ${domain} added` }));
+        addLog(_jsxs(Box, { flexDirection: "column", gap: 1, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Add these DNS records with your domain provider:" }), _jsxs(Box, { flexDirection: "column", paddingLeft: 3, children: [readyTxtRecords.map((record) => (_jsxs(Text, { children: ["TXT ", getRelativeRecordName(record.domain, domain), " \u2192 ", record.value] }, record.domain))), _jsxs(Text, { children: ["CNAME ", getRelativeRecordName(domain, domain), " \u2192 ", CUSTOM_DOMAIN_CNAME_TARGET] })] }), _jsx(Text, { dimColor: true, children: "Add the TXT records first; add the CNAME once they're validated." }), !recordsReady && (_jsx(Text, { dimColor: true, children: "Some TXT records are still being generated. Check the dashboard in a moment for the rest." }))] }));
+    });
+}

package/bin/cli.js

@@ -16,6 +16,7 @@ import path from 'path';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import { accessibilityCheck } from './accessibilityCheck.js';
+import { addDomain } from './addDomain.js';
 import { comingSoon } from './comingSoon.js';
 import { setTelemetryEnabled } from './config.js';
 import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
@@ -364,6 +365,14 @@ export const cli = ({ packageName = 'mint' }) => {
             email: argv.email,
         });
         yield terminate(0);
+    }))
+        .command('add-domain <domain>', 'Add a custom domain to your deployment', (yargs) => yargs.positional('domain', {
+        type: 'string',
+        demandOption: true,
+        description: 'The custom domain to add (e.g. docs.example.com)',
+    }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
+        yield addDomain(argv.domain);
+        yield terminate(0);
     }))
         .command('config', 'Manage CLI configuration', (yargs) => yargs
         .command('set <key> <value>', 'Set a configuration value', (yargs) => yargs

package/bin/constants.js

@@ -17,3 +17,4 @@ const PROD_TOKEN_ENDPOINT = 'https://api.stytch.com/v1/public/project-live-731b7
 const PROD_STYTCH_CLIENT_ID = 'connected-app-live-d813eedd-dbb0-434b-a1f9-2ce69e5efc49';
 export const TOKEN_ENDPOINT = IS_LOCAL_BUILD ? DEV_TOKEN_ENDPOINT : PROD_TOKEN_ENDPOINT;
 export const STYTCH_CLIENT_ID = IS_LOCAL_BUILD ? DEV_STYTCH_CLIENT_ID : PROD_STYTCH_CLIENT_ID;
+export const CUSTOM_DOMAIN_CNAME_TARGET = 'cname.mintlify.builders';