doomain 0.1.18 → 0.1.20

package/README.md

@@ -1,6 +1,6 @@
 # Doomain
 
-Doomain links Vercel projects and first-time Clerk production instances to custom domains from your terminal.
+Doomain points DNS records and links Vercel projects or first-time Clerk production instances to custom domains from your terminal.
 
 It handles the boring parts of custom-domain setup: selecting the Vercel project, finding the right DNS zone, adding the domain to Vercel, writing the Vercel DNS records, waiting for public DNS propagation, and asking Vercel to verify the domain.
 
@@ -12,6 +12,7 @@ Use the interactive wizard when working by hand. Use explicit commands with `--j
 - Script-friendly commands with one JSON object on stdout.
 - Vercel project detection from `.vercel/project.json`.
 - DNS provider inference by longest matching configured zone.
+- Generic DNS pointing for VPS, load balancer, and canonical-hostname targets.
 - Dry-run plans before writing changes.
 - Safety checks before replacing DNS records that point elsewhere.
 - DNS propagation and Vercel verification wait loop.
@@ -87,6 +88,12 @@ Apply it:
 doomain link app.example.com --project my-vercel-project --json
 ```
 
+Point a domain at non-Vercel infrastructure such as a VPS:
+
+```bash
+doomain dns point app.example.com --target 203.0.113.10 --json
+```
+
 Set up a Clerk application's first production instance and primary domain:
 
 ```bash
@@ -154,7 +161,7 @@ doomain providers connect cloudflare \
   --credential accountId=your_cloudflare_account_id
 ```
 
-Cloudflare records created for Vercel or Clerk `A`, `AAAA`, and `CNAME` targets are set to `proxied: false` so the service can validate the domain.
+Cloudflare `A`, `AAAA`, and `CNAME` records created by Doomain are set to `proxied: false` so targets remain directly verifiable.
 
 ### Hostinger
 
@@ -221,6 +228,39 @@ Use `-p` as shorthand for `--project`:
 doomain link app.example.com -p my-app
 ```
 
+## Pointing DNS At A VPS Or Hostname
+
+Use `dns point` when Doomain should only reconcile DNS, without adding the domain to Vercel or Clerk. It infers the configured provider account and longest matching zone in the same way as `link`.
+
+Point an apex or subdomain at an IPv4 or IPv6 address:
+
+```bash
+doomain dns point example.com --target 203.0.113.10
+doomain dns point app.example.com --target 2001:db8::10
+```
+
+Point a subdomain at a canonical hostname:
+
+```bash
+doomain dns point app.example.com --target origin.example.net
+```
+
+The record type is inferred as `A`, `AAAA`, or `CNAME`. Use `--type` to require a specific type, `--ttl` to change the default 300-second TTL, and `--provider`/`--account` to override provider inference.
+
+Canonical hostname targets use CNAME records. Doomain rejects an apex CNAME when the selected provider does not advertise apex-CNAME support; use an IPv4 or IPv6 target for that apex instead.
+
+Preview without writing:
+
+```bash
+doomain dns point app.example.com --target 203.0.113.10 --dry-run --json
+```
+
+The preview resolves the provider, account, zone, record name, type, and value without reading or writing current DNS records. Conflicts are checked when a real write is attempted.
+
+By default, a successful write waits up to 300 seconds for public DNS. Use `--no-wait` to return immediately or `--timeout <seconds>` to change the limit. Skipping the wait, a dry run, or reaching the timeout returns `propagated: false`; a propagation timeout does not turn a successful provider write into an error.
+
+Existing exact records are skipped. Conflicting records fail with `DNS_TARGET_CONFLICT` in JSON/non-interactive mode. Use `--force` only after approving replacement of the existing target.
+
 ## Clerk Production Domains
 
 `doomain clerk domains add` mirrors Clerk CLI's initial production deployment API. It creates a production instance by cloning the application's development instance, sets the requested primary domain, writes every CNAME returned by Clerk, and optionally waits for Clerk's DNS, SSL, and email DNS status.
@@ -335,6 +375,7 @@ Useful agent-safe commands:
 
 ```bash
 doomain link app.example.com --project my-app --json
+doomain dns point app.example.com --target 203.0.113.10 --json
 doomain providers list --json
 doomain providers status --no-verify --json
 doomain domains find hacktheandes.com --json
@@ -413,6 +454,28 @@ doomain auth vercel --token vercel_token
 doomain auth vercel --token vercel_token --team-id team_123 --json
 ```
 
+### `doomain dns point <domain>`
+
+Points an apex or subdomain at an IPv4 or IPv6 address, or a subdomain at a canonical hostname, using the matching configured DNS provider.
+
+```bash
+doomain dns point example.com --target 203.0.113.10
+doomain dns point app.example.com --target origin.example.net --no-wait --json
+doomain dns point app.example.com --target 203.0.113.10 --provider spaceship --account work --force --json
+```
+
+Common flags:
+
+- `--target <value>`: required IPv4, IPv6, or hostname target.
+- `--type <A|AAAA|CNAME>`: require a record type instead of inferring it.
+- `--provider <id>`, `--account <alias>`: select a configured provider account instead of inferring one.
+- `--ttl <seconds>`: DNS TTL. Default is `300`.
+- `--dry-run`: preview without writing.
+- `--force`: overwrite conflicting DNS records.
+- `--wait`, `--no-wait`: wait for public DNS propagation. Default is `--wait`.
+- `--timeout <seconds>`: propagation wait timeout. Default is `300`.
+- `--json`: output one JSON object.
+
 ### `doomain auth logout vercel`
 
 Removes saved Vercel credentials from the local config file.

package/dist/commands/auth/clerk.js

@@ -1,5 +1,5 @@
-import { Command, Flags } from '@oclif/core';
 import * as p from '@clack/prompts';
+import { Command, Flags } from '@oclif/core';
 import { createClerkPlatformClient } from '../../lib/clerk.js';
 import { getConfigPath, maskSecret, updateConfig } from '../../lib/config.js';
 import { jsonFlag } from '../../lib/flags.js';

package/dist/commands/auth/vercel.js

@@ -1,10 +1,10 @@
-import { Command, Flags } from '@oclif/core';
 import * as p from '@clack/prompts';
+import { Command, Flags } from '@oclif/core';
 import { getConfigPath, maskSecret, updateConfig } from '../../lib/config.js';
 import { jsonFlag } from '../../lib/flags.js';
 import { createOutput, outputError } from '../../lib/output.js';
-import { listGlobalVercelTokens } from '../../lib/vercel-auth.js';
 import { createVercelClient } from '../../lib/vercel.js';
+import { listGlobalVercelTokens } from '../../lib/vercel-auth.js';
 const PERSONAL_ACCOUNT = '__personal__';
 const NEW_TOKEN = '__new_token__';
 function assertValue(value, message) {
@@ -24,7 +24,11 @@ async function promptVercelToken(globalTokens) {
         const selected = await p.select({
             message: 'Vercel token',
             options: [
-                ...globalTokens.map((token, index) => ({ label: globalTokenLabel(token), value: String(index), hint: maskSecret(token.token) })),
+                ...globalTokens.map((token, index) => ({
+                    label: globalTokenLabel(token),
+                    value: String(index),
+                    hint: maskSecret(token.token),
+                })),
                 { label: 'Enter a new token', value: NEW_TOKEN },
             ],
         });
@@ -46,7 +50,9 @@ export default class AuthVercel extends Command {
     static description = 'Save Vercel credentials locally.';
     static flags = {
         json: jsonFlag,
-        'team-id': Flags.string({ description: 'Vercel team id. Interactive mode can fetch and select this from your token.' }),
+        'team-id': Flags.string({
+            description: 'Vercel team id. Interactive mode can fetch and select this from your token.',
+        }),
         token: Flags.string({ description: 'Vercel API token.' }),
     };
     async run() {

package/dist/commands/clerk/domains/add.js

@@ -1,5 +1,5 @@
-import { Args, Command, Flags } from '@oclif/core';
 import * as p from '@clack/prompts';
+import { Args, Command, Flags } from '@oclif/core';
 import { addClerkProductionDomain } from '../../../lib/clerk-domain.js';
 import { accountFlag, jsonFlag, providerFlag } from '../../../lib/flags.js';
 import { createOutput, outputError } from '../../../lib/output.js';
@@ -33,12 +33,18 @@ export default class ClerkDomainsAdd extends Command {
     static flags = {
         account: accountFlag,
         app: Flags.string({ description: 'Clerk application id. Defaults to CLERK_APPLICATION_ID or saved Clerk config.' }),
-        'dry-run': Flags.boolean({ description: 'Check the Clerk application and DNS zone without creating the production instance.' }),
+        'dry-run': Flags.boolean({
+            description: 'Check the Clerk application and DNS zone without creating the production instance.',
+        }),
         force: Flags.boolean({ description: 'Overwrite DNS records that conflict with Clerk requirements.' }),
         json: jsonFlag,
         provider: providerFlag,
         timeout: Flags.integer({ default: 300, description: 'Wait timeout in seconds.' }),
-        wait: Flags.boolean({ allowNo: true, default: true, description: 'Wait for Clerk DNS, SSL, and email DNS verification.' }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Wait for Clerk DNS, SSL, and email DNS verification.',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(ClerkDomainsAdd);

package/dist/commands/dns/point.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+export default class DnsPoint extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        domain: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        account: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        provider: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        target: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        ttl: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/dns/point.js

@@ -0,0 +1,123 @@
+import * as p from '@clack/prompts';
+import { Args, Command, Flags } from '@oclif/core';
+import { accountFlag, jsonFlag, providerFlag } from '../../lib/flags.js';
+import { createOutput, outputError } from '../../lib/output.js';
+import { pointDomain } from '../../lib/point-domain.js';
+function preview(result) {
+    return [
+        `Domain: ${result.domain}`,
+        `DNS provider: ${result.provider}/${result.account} (${result.zoneDomain})`,
+        `Record: ${result.record.type} ${result.record.name} -> ${result.record.value}`,
+    ].join('\n');
+}
+function conflictNote(warning) {
+    return [
+        `${warning.domain} already points somewhere else.`,
+        '',
+        'Existing:',
+        ...warning.conflicts.map((conflict) => `- ${conflict.existing.type} ${conflict.existing.name} -> ${conflict.existing.value}`),
+        '',
+        'Desired:',
+        ...warning.desired.map((record) => `- ${record.type} ${record.name} -> ${record.value}`),
+    ].join('\n');
+}
+function successMessages(result, waited) {
+    if (result.propagated) {
+        return {
+            outro: result.updated
+                ? `${result.domain} now points to ${result.record.value}.`
+                : `${result.domain} already points to ${result.record.value}.`,
+            spinner: 'DNS record is live',
+        };
+    }
+    if (!waited) {
+        return {
+            outro: result.updated
+                ? `${result.domain} was updated; propagation was not checked.`
+                : `${result.domain} was already configured; propagation was not checked.`,
+            spinner: result.updated ? 'DNS record saved; propagation not checked' : 'DNS record already configured',
+        };
+    }
+    return {
+        outro: result.updated
+            ? `${result.domain} was updated; propagation is still pending.`
+            : `${result.domain} was already configured; public DNS does not match yet.`,
+        spinner: result.updated ? 'DNS record saved' : 'DNS record already configured',
+    };
+}
+export default class DnsPoint extends Command {
+    static description = 'Point a DNS name at an IP address or canonical hostname.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> app.example.com --target 203.0.113.10 --json',
+        '<%= config.bin %> <%= command.id %> app.example.com --target origin.example.net --dry-run --json',
+        '<%= config.bin %> <%= command.id %> example.com --target 203.0.113.10 --provider spaceship --account work --force --json',
+    ];
+    static args = {
+        domain: Args.string({ description: 'Fully qualified domain to point.', required: true }),
+    };
+    static flags = {
+        account: accountFlag,
+        'dry-run': Flags.boolean({ description: 'Preview the DNS record without writing it.' }),
+        force: Flags.boolean({ description: 'Overwrite conflicting DNS records.' }),
+        json: jsonFlag,
+        provider: providerFlag,
+        target: Flags.string({ description: 'IPv4, IPv6, or hostname target.', required: true }),
+        timeout: Flags.integer({ default: 300, description: 'DNS propagation wait timeout in seconds.' }),
+        ttl: Flags.integer({ default: 300, description: 'DNS record TTL in seconds.' }),
+        type: Flags.string({
+            description: 'Record type. Inferred from the target when omitted.',
+            options: ['A', 'AAAA', 'CNAME'],
+        }),
+        wait: Flags.boolean({ allowNo: true, default: true, description: 'Wait for public DNS propagation.' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(DnsPoint);
+        const out = createOutput({ json: flags.json });
+        let spinner;
+        try {
+            if (!flags['dry-run']) {
+                out.intro('Doomain');
+                spinner = out.spinner();
+                spinner.start(`Pointing ${args.domain}`);
+            }
+            const result = await pointDomain({
+                account: flags.account,
+                confirmDnsOverride: out.json
+                    ? undefined
+                    : async (warning) => {
+                        spinner?.stop('Existing DNS target found');
+                        p.note(conflictNote(warning), 'DNS already points elsewhere');
+                        const confirmed = await p.confirm({ message: `Override DNS for ${warning.domain}?`, initialValue: false });
+                        if (confirmed === true)
+                            spinner?.start(`Pointing ${warning.domain}`);
+                        return confirmed === true;
+                    },
+                domain: args.domain,
+                dryRun: flags['dry-run'],
+                force: flags.force,
+                progress: out.json ? undefined : (message) => spinner?.message(message),
+                provider: flags.provider,
+                recordType: flags.type,
+                target: flags.target,
+                timeoutSeconds: flags.timeout,
+                ttl: flags.ttl,
+                wait: flags.wait,
+            });
+            if (flags['dry-run']) {
+                out.result(result);
+                if (!out.json)
+                    p.note(preview(result), 'Dry run');
+                return;
+            }
+            const messages = successMessages(result, flags.wait);
+            spinner?.stop(messages.spinner);
+            out.result(result);
+            out.outro(messages.outro);
+        }
+        catch (error) {
+            spinner?.error('DNS update failed');
+            outputError(out.json, error, 'DNS_POINT_FAILED');
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/domains/list.js

@@ -33,7 +33,9 @@ export default class DomainsList extends Command {
             const accounts = account
                 ? [{ account, isDefaultAccount: isDefaultProviderAccount(account), providerId: definition.id }]
                 : listConfiguredProviderAccounts(config, definition);
-            const selectedAccounts = accounts.length > 0 ? accounts : [{ account: DEFAULT_PROVIDER_ACCOUNT, isDefaultAccount: true, providerId: definition.id }];
+            const selectedAccounts = accounts.length > 0
+                ? accounts
+                : [{ account: DEFAULT_PROVIDER_ACCOUNT, isDefaultAccount: true, providerId: definition.id }];
             const results = [];
             for (const selectedAccount of selectedAccounts) {
                 const provider = await createProvider(definition.id, { account: selectedAccount.account });
@@ -47,14 +49,18 @@ export default class DomainsList extends Command {
                         records,
                         zone,
                     });
-                    const accountLabel = selectedAccount.isDefaultAccount ? provider.id : `${provider.id}/${selectedAccount.account}`;
+                    const accountLabel = selectedAccount.isDefaultAccount
+                        ? provider.id
+                        : `${provider.id}/${selectedAccount.account}`;
                     out.info(`${zone.name} (${records.length} records) via ${accountLabel}`);
                     for (const record of records)
                         out.info(`  ${record.type} ${record.name} -> ${record.value}`);
                 }
             }
             out.result({
-                ...(selectedAccounts.length === 1 ? { account: selectedAccounts[0].account, isDefaultAccount: selectedAccounts[0].isDefaultAccount } : {}),
+                ...(selectedAccounts.length === 1
+                    ? { account: selectedAccounts[0].account, isDefaultAccount: selectedAccounts[0].isDefaultAccount }
+                    : {}),
                 provider: definition.id,
                 zones: results,
             });

package/dist/commands/link.js

@@ -1,5 +1,5 @@
-import { Args, Command, Flags } from '@oclif/core';
 import * as p from '@clack/prompts';
+import { Args, Command, Flags } from '@oclif/core';
 import { accountFlag, apexFlag, domainFlag, jsonFlag, projectFlag, providerFlag, subdomainFlag } from '../lib/flags.js';
 import { linkDomain } from '../lib/link-domain.js';
 import { createOutput, outputError } from '../lib/output.js';
@@ -56,13 +56,19 @@ export default class Link extends Command {
         apex: apexFlag,
         domain: domainFlag,
         'dry-run': Flags.boolean({ description: 'Preview changes without writing to Vercel or DNS.' }),
-        force: Flags.boolean({ description: 'Move existing Vercel project domains and overwrite conflicting DNS records.' }),
+        force: Flags.boolean({
+            description: 'Move existing Vercel project domains and overwrite conflicting DNS records.',
+        }),
         json: jsonFlag,
         project: projectFlag,
         provider: providerFlag,
         subdomain: subdomainFlag,
         timeout: Flags.integer({ default: 300, description: 'Wait timeout in seconds.' }),
-        wait: Flags.boolean({ allowNo: true, default: true, description: 'Wait for DNS propagation and Vercel verification.' }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Wait for DNS propagation and Vercel verification.',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(Link);

package/dist/commands/providers/connect.js

@@ -1,5 +1,5 @@
-import { Args, Command, Flags } from '@oclif/core';
 import * as p from '@clack/prompts';
+import { Args, Command, Flags } from '@oclif/core';
 import { getConfigPath, loadConfig, maskSecret, updateConfig } from '../../lib/config.js';
 import { accountFlag, jsonFlag } from '../../lib/flags.js';
 import { createOutput, outputError } from '../../lib/output.js';
@@ -68,7 +68,11 @@ function validateProviderAccount(value) {
     }
 }
 async function promptProviderAccount() {
-    const value = await p.text({ message: 'Profile name', placeholder: DEFAULT_PROVIDER_ACCOUNT, validate: validateProviderAccount });
+    const value = await p.text({
+        message: 'Profile name',
+        placeholder: DEFAULT_PROVIDER_ACCOUNT,
+        validate: validateProviderAccount,
+    });
     if (p.isCancel(value)) {
         p.cancel('Cancelled');
         return null;
@@ -136,7 +140,11 @@ export default class ProvidersConnect extends Command {
             const definition = args.provider ? getProviderDefinition(args.provider) : await promptProvider();
             if (!definition)
                 return;
-            const account = flags.account ? normalizeProviderAccount(flags.account) : out.json ? DEFAULT_PROVIDER_ACCOUNT : await promptProviderAccount();
+            const account = flags.account
+                ? normalizeProviderAccount(flags.account)
+                : out.json
+                    ? DEFAULT_PROVIDER_ACCOUNT
+                    : await promptProviderAccount();
             if (!account)
                 return;
             const isDefaultAccount = isDefaultProviderAccount(account);
@@ -152,7 +160,10 @@ export default class ProvidersConnect extends Command {
             if (!out.json)
                 showSetupGuide(definition, detectedPublicIp);
             for (const credential of definition.credentials) {
-                const value = process.env[credential.env] || passedCredentials[credential.key] || legacyFlagValue(flags, credential) || undefined;
+                const value = process.env[credential.env] ||
+                    passedCredentials[credential.key] ||
+                    legacyFlagValue(flags, credential) ||
+                    undefined;
                 if (value) {
                     credentials[credential.key] = value;
                     continue;

package/dist/commands/providers/disconnect.js

@@ -38,7 +38,9 @@ export default class ProvidersDisconnect extends Command {
                 else if (provider) {
                     const nextProvider = { ...provider };
                     if (isDefaultProviderAccount(account)) {
-                        removed = nextProvider.credentials !== undefined || (definition.id === 'spaceship' && ('apiKey' in nextProvider || 'apiSecret' in nextProvider));
+                        removed =
+                            nextProvider.credentials !== undefined ||
+                                (definition.id === 'spaceship' && ('apiKey' in nextProvider || 'apiSecret' in nextProvider));
                         delete nextProvider.credentials;
                         if (definition.id === 'spaceship') {
                             delete nextProvider.apiKey;
@@ -52,7 +54,9 @@ export default class ProvidersDisconnect extends Command {
                         delete accounts[account];
                         nextProvider.accounts = Object.keys(accounts).length > 0 ? accounts : undefined;
                     }
-                    if (nextProvider.credentials || nextProvider.settings || (nextProvider.accounts && Object.keys(nextProvider.accounts).length > 0)) {
+                    if (nextProvider.credentials ||
+                        nextProvider.settings ||
+                        (nextProvider.accounts && Object.keys(nextProvider.accounts).length > 0)) {
                         providers[definition.id] = nextProvider;
                     }
                     else {
@@ -69,10 +73,18 @@ export default class ProvidersDisconnect extends Command {
                 };
             });
             const overrides = envOverrides(definition);
-            out.result({ account, configPath: getConfigPath(), environmentOverrides: overrides, provider: definition.id, removed });
+            out.result({
+                account,
+                configPath: getConfigPath(),
+                environmentOverrides: overrides,
+                provider: definition.id,
+                removed,
+            });
             if (overrides.length > 0)
                 out.warn(`${definition.displayName} environment credentials are still set: ${overrides.join(', ')}.`);
-            out.success(removed ? `${definition.displayName} credentials removed from ${getConfigPath()}.` : `${definition.displayName} was not connected.`);
+            out.success(removed
+                ? `${definition.displayName} credentials removed from ${getConfigPath()}.`
+                : `${definition.displayName} was not connected.`);
         }
         catch (error) {
             outputError(out.json, error, 'PROVIDER_NOT_FOUND');

package/dist/commands/providers/list.js

@@ -1,7 +1,7 @@
 import { Command } from '@oclif/core';
 import { jsonFlag } from '../../lib/flags.js';
-import { listProviderDefinitions } from '../../lib/providers/registry.js';
 import { createOutput } from '../../lib/output.js';
+import { listProviderDefinitions } from '../../lib/providers/registry.js';
 export default class ProvidersList extends Command {
     static description = 'List supported DNS providers.';
     static flags = {

package/dist/commands/wizard.js

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
 import * as p from '@clack/prompts';
+import { Command } from '@oclif/core';
 import { loadConfig, maskSecret, updateConfig } from '../lib/config.js';
 import { DoomainError } from '../lib/errors.js';
 import { jsonFlag } from '../lib/flags.js';
@@ -8,8 +8,8 @@ import { detectLocalVercelProject } from '../lib/local-vercel.js';
 import { createOutput, outputError } from '../lib/output.js';
 import { DEFAULT_PROVIDER_ACCOUNT, isDefaultProviderAccount, listConfiguredProviderAccounts, normalizeProviderAccount, providerAccountHasCredentials, withProviderAccountCredentials, } from '../lib/providers/core/config.js';
 import { createProvider, getProviderDefinition, listProviderDefinitions } from '../lib/providers/registry.js';
-import { listGlobalVercelTokens } from '../lib/vercel-auth.js';
 import { createVercelClient } from '../lib/vercel.js';
+import { listGlobalVercelTokens } from '../lib/vercel-auth.js';
 const PERSONAL_ACCOUNT = '__personal__';
 const NEW_TOKEN = '__new_token__';
 function cancelIfNeeded(value) {
@@ -22,7 +22,11 @@ function cancelIfNeeded(value) {
 async function promptRequired(message, opts = {}) {
     const value = opts.password
         ? await p.password({ message })
-        : await p.text({ message, placeholder: opts.placeholder, validate: (input) => (input?.trim() ? undefined : 'Required') });
+        : await p.text({
+            message,
+            placeholder: opts.placeholder,
+            validate: (input) => (input?.trim() ? undefined : 'Required'),
+        });
     const resolved = cancelIfNeeded(value);
     return typeof resolved === 'string' ? resolved.trim() : null;
 }
@@ -36,7 +40,11 @@ function validateProviderAccount(value) {
     }
 }
 async function promptProviderAccount() {
-    const value = await p.text({ message: 'Profile name', placeholder: DEFAULT_PROVIDER_ACCOUNT, validate: validateProviderAccount });
+    const value = await p.text({
+        message: 'Profile name',
+        placeholder: DEFAULT_PROVIDER_ACCOUNT,
+        validate: validateProviderAccount,
+    });
     const resolved = cancelIfNeeded(value);
     return typeof resolved === 'string' ? normalizeProviderAccount(resolved) : null;
 }
@@ -145,7 +153,11 @@ async function promptVercelToken(globalTokens) {
         const selected = await p.select({
             message: 'Vercel token',
             options: [
-                ...globalTokens.map((token, index) => ({ label: globalTokenLabel(token), value: String(index), hint: maskSecret(token.token) })),
+                ...globalTokens.map((token, index) => ({
+                    label: globalTokenLabel(token),
+                    value: String(index),
+                    hint: maskSecret(token.token),
+                })),
                 { label: 'Enter a new token', value: NEW_TOKEN },
             ],
         });
@@ -256,7 +268,9 @@ export default class Wizard extends Command {
                 }
             }
             const selectedTeam = teams.find((team) => team.id === vercelTeamId);
-            const teamDisplay = vercelTeamId ? teamLabel(selectedTeam ?? { id: vercelTeamId, name: null, role: null, slug: vercelTeamId }) : 'Personal account';
+            const teamDisplay = vercelTeamId
+                ? teamLabel(selectedTeam ?? { id: vercelTeamId, name: null, role: null, slug: vercelTeamId })
+                : 'Personal account';
             p.log.success(`Vercel account ready: ${teamDisplay}`);
             const projectSpinner = p.spinner();
             activeSpinner = projectSpinner;
@@ -268,7 +282,9 @@ export default class Wizard extends Command {
                 throw new DoomainError('PROJECT_NOT_FOUND', `No Vercel projects found in ${teamDisplay}.`);
             }
             const localProjectMatchesTeam = localProject && (vercelTeamId ? localProject.orgId === vercelTeamId : !localProject.orgId);
-            const initialProject = localProjectMatchesTeam && projects.some((item) => item.id === localProject.projectId) ? localProject.projectId : undefined;
+            const initialProject = localProjectMatchesTeam && projects.some((item) => item.id === localProject.projectId)
+                ? localProject.projectId
+                : undefined;
             const selected = await p.autocomplete({
                 message: 'Select Vercel project',
                 placeholder: 'Type to filter projects...',
@@ -303,7 +319,11 @@ export default class Wizard extends Command {
                     if (!overwrite)
                         return;
                 }
-                const providerAccount = { account, isDefaultAccount: isDefaultProviderAccount(account), providerId: selectedDefinition.id };
+                const providerAccount = {
+                    account,
+                    isDefaultAccount: isDefaultProviderAccount(account),
+                    providerId: selectedDefinition.id,
+                };
                 const credentials = await promptProviderCredentials(selectedDefinition);
                 if (!credentials)
                     return;
@@ -334,7 +354,9 @@ export default class Wizard extends Command {
                         domainOptions.push(...(await listProviderDomainOptions(definition, account)));
                     }
                     catch (error) {
-                        const label = account.isDefaultAccount ? definition.displayName : `${definition.displayName}/${account.account}`;
+                        const label = account.isDefaultAccount
+                            ? definition.displayName
+                            : `${definition.displayName}/${account.account}`;
                         providerFailures.push(`${label}: ${error instanceof Error ? error.message : String(error)}`);
                     }
                 }
@@ -354,14 +376,18 @@ export default class Wizard extends Command {
             p.log.success(`DNS ready: ${providerNames} (${domainOptions.length} domains)`);
             let selectedDomain = domainOptions[0];
             if (domainOptions.length > 1) {
-                const initialValue = domainOptions.find((option) => option.providerId === defaultProvider && option.domain === defaultDomain)?.id ??
-                    domainOptions.find((option) => option.domain === defaultDomain)?.id;
+                const initialValue = domainOptions.find((option) => option.providerId === defaultProvider && option.domain === defaultDomain)
+                    ?.id ?? domainOptions.find((option) => option.domain === defaultDomain)?.id;
                 const selectedDomainId = await p.autocomplete({
                     message: 'Select domain',
                     placeholder: 'Type to filter domains...',
                     maxItems: 10,
                     initialValue,
-                    options: domainOptions.map((option) => ({ label: option.domain, value: option.id, hint: providerAccountLabel(option) })),
+                    options: domainOptions.map((option) => ({
+                        label: option.domain,
+                        value: option.id,
+                        hint: providerAccountLabel(option),
+                    })),
                 });
                 const selectedId = cancelIfNeeded(selectedDomainId);
                 if (selectedId === null)
@@ -392,8 +418,18 @@ export default class Wizard extends Command {
                     return;
             }
             const fullDomain = apex ? domain : `${subdomain}.${domain}`;
-            const preview = await createLinkPlan({ account: selectedDomain.account, provider: selectedDomain.providerId, domain, subdomain, apex, project });
-            p.note([`Vercel: add ${preview.domain} to ${projectDisplay}`, ...preview.records.map((record) => recordPreview(record, providerAccountLabel(selectedDomain)))].join('\n'), 'Preview');
+            const preview = await createLinkPlan({
+                account: selectedDomain.account,
+                provider: selectedDomain.providerId,
+                domain,
+                subdomain,
+                apex,
+                project,
+            });
+            p.note([
+                `Vercel: add ${preview.domain} to ${projectDisplay}`,
+                ...preview.records.map((record) => recordPreview(record, providerAccountLabel(selectedDomain))),
+            ].join('\n'), 'Preview');
             const confirmed = await p.confirm({
                 message: `Link ${fullDomain} via ${selectedDomain.providerName} to Vercel project ${projectDisplay}?`,
                 initialValue: true,

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { run } from '@oclif/core';
-export { findDomainProvider, type DomainProviderResult, type FindDomainProviderInput, type ProviderSearchWarning, } from './lib/domain-provider.js';
+export { type DomainProviderResult, type FindDomainProviderInput, findDomainProvider, type ProviderSearchWarning, } from './lib/domain-provider.js';

package/dist/lib/clerk.js

@@ -17,7 +17,11 @@ export async function resolveClerkPlatformConfig(appId) {
     return { appId: resolvedAppId, platformApiKey };
 }
 function apiErrorMessage(status, body) {
-    return body?.errors?.[0]?.long_message ?? body?.errors?.[0]?.message ?? body?.error?.message ?? body?.message ?? `Clerk API error (${status}).`;
+    return (body?.errors?.[0]?.long_message ??
+        body?.errors?.[0]?.message ??
+        body?.error?.message ??
+        body?.message ??
+        `Clerk API error (${status}).`);
 }
 function apiErrorCode(body) {
     return body?.errors?.[0]?.code ?? body?.error?.code ?? body?.code;