doomain 0.1.15 → 0.1.17

package/dist/lib/link-domain.js

@@ -2,12 +2,10 @@ import { resolve4, resolveCname, resolveTxt } from 'node:dns/promises';
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, parse } from 'node:path';
 import { loadConfig } from './config.js';
+import { resolveProviderTarget } from './domain-provider.js';
 import { DoomainError } from './errors.js';
 import { detectLocalVercelProject } from './local-vercel.js';
-import { DEFAULT_PROVIDER_ACCOUNT, isDefaultProviderAccount, listConfiguredProviderAccounts, normalizeProviderAccount, } from './providers/core/config.js';
-import { createProvider, getProviderDefinition, listProviderDefinitions } from './providers/registry.js';
-import { listProviderStatuses } from './providers/status.js';
-import { normalizeDomain, normalizeSubdomain } from './validate.js';
+import { createProvider } from './providers/registry.js';
 import { createVercelClient, resolveVercelConfig, VERCEL_APEX_A_RECORD, VERCEL_CNAME_RECORD } from './vercel.js';
 function cleanDnsValue(value) {
     return value.toLowerCase().replace(/\.$/, '');
@@ -116,179 +114,7 @@ async function resolveZone(provider, zoneDomain) {
     }
     return zone;
 }
-async function providerConnectionDetails() {
-    return (await listProviderStatuses({ verify: false })).map((provider) => ({
-        configured: provider.configured,
-        account: provider.account,
-        default: provider.default,
-        displayName: provider.displayName,
-        docsUrl: provider.docsUrl,
-        id: provider.id,
-        isDefaultAccount: provider.isDefaultAccount,
-    }));
-}
-function resolveRequestedDomain(opts) {
-    if (opts.apex && opts.subdomain) {
-        throw new DoomainError('INVALID_INPUT', 'Use either --apex or --subdomain, not both.');
-    }
-    const domain = normalizeDomain(opts.domain);
-    if (opts.apex)
-        return { forceExactZone: true, fullDomain: domain };
-    if (!opts.subdomain)
-        return { forceExactZone: false, fullDomain: domain };
-    return { forceExactZone: false, fullDomain: `${normalizeSubdomain(opts.subdomain)}.${domain}` };
-}
-function zoneMatchesDomain(fullDomain, zoneDomain, forceExactZone) {
-    if (fullDomain === zoneDomain)
-        return true;
-    if (forceExactZone)
-        return false;
-    return fullDomain.endsWith(`.${zoneDomain}`);
-}
-function targetFromZone(fullDomain, zoneDomain) {
-    if (fullDomain === zoneDomain) {
-        return { fullDomain, isApex: true, recordName: '@', zoneDomain };
-    }
-    return {
-        fullDomain,
-        isApex: false,
-        recordName: fullDomain.slice(0, -(zoneDomain.length + 1)),
-        zoneDomain,
-    };
-}
-function candidateDetails(candidates) {
-    return candidates.map((candidate) => ({
-        account: candidate.account,
-        isDefaultAccount: candidate.isDefaultAccount,
-        provider: candidate.provider,
-        providerName: candidate.providerName,
-        zoneDomain: candidate.zone.name,
-    }));
-}
-function defaultAccountRef(providerId) {
-    return { account: DEFAULT_PROVIDER_ACCOUNT, isDefaultAccount: true, providerId };
-}
-function explicitAccountRef(providerId, account) {
-    const normalized = normalizeProviderAccount(account);
-    return { account: normalized, isDefaultAccount: isDefaultProviderAccount(normalized), providerId };
-}
-async function loadProviderZones(definition, account) {
-    const provider = await createProvider(definition.id, { account: account.account });
-    const zones = await provider.listZones();
-    return {
-        candidates: zones.map((zone) => ({
-            account: account.account,
-            isDefaultAccount: account.isDefaultAccount,
-            provider: definition.id,
-            providerName: definition.displayName,
-            zone,
-        })),
-        search: {
-            account: account.account,
-            displayName: definition.displayName,
-            id: definition.id,
-            isDefaultAccount: account.isDefaultAccount,
-            zones: zones.map((zone) => zone.name),
-        },
-    };
-}
-async function loadConfiguredProviderZones(providerId, accountInput) {
-    const config = await loadConfig();
-    const account = accountInput ? normalizeProviderAccount(accountInput) : undefined;
-    if (providerId) {
-        const definition = getProviderDefinition(providerId);
-        const accounts = account ? [explicitAccountRef(definition.id, account)] : listConfiguredProviderAccounts(config, definition);
-        const selectedAccounts = accounts.length > 0 ? accounts : [defaultAccountRef(definition.id)];
-        const results = await Promise.all(selectedAccounts.map((ref) => loadProviderZones(definition, ref)));
-        return {
-            accountInferred: account === undefined,
-            candidates: results.flatMap((result) => result.candidates),
-            providerInferred: false,
-            searched: results.map((result) => result.search),
-        };
-    }
-    const providerAccounts = listProviderDefinitions().flatMap((definition) => listConfiguredProviderAccounts(config, definition)
-        .filter((ref) => !account || ref.account === account)
-        .map((ref) => ({ definition, ref })));
-    if (providerAccounts.length === 0) {
-        const message = account
-            ? `No DNS provider account named ${account} is configured. Run \`doomain providers connect <provider> --account ${account}\` first.`
-            : 'No DNS provider is configured. Run `doomain providers connect` first.';
-        throw new DoomainError('CONFIG_NOT_FOUND', message, {
-            account,
-            configuredProviders: await providerConnectionDetails(),
-            recovery: 'Connect the DNS provider that owns this domain, then retry `doomain link <domain> --json`.',
-            suggestedCommands: account
-                ? [`doomain providers connect <provider> --account ${account}`, 'doomain link <domain> --json']
-                : ['doomain providers connect', 'doomain link <domain> --json'],
-        });
-    }
-    const results = await Promise.all(providerAccounts.map(async ({ definition, ref }) => {
-        try {
-            return await loadProviderZones(definition, ref);
-        }
-        catch (error) {
-            return {
-                candidates: [],
-                search: {
-                    account: ref.account,
-                    displayName: definition.displayName,
-                    error: error instanceof Error ? error.message : String(error),
-                    id: definition.id,
-                    isDefaultAccount: ref.isDefaultAccount,
-                    zones: [],
-                },
-            };
-        }
-    }));
-    return {
-        accountInferred: account === undefined,
-        candidates: results.flatMap((result) => result.candidates),
-        providerInferred: true,
-        searched: results.map((result) => result.search),
-    };
-}
-async function resolveProviderTarget(input) {
-    const requested = resolveRequestedDomain({
-        apex: input.apex,
-        domain: await resolveConfiguredDomain(input.domain),
-        subdomain: input.subdomain,
-    });
-    const zones = await loadConfiguredProviderZones(input.provider, input.account);
-    const matches = zones.candidates
-        .filter((candidate) => zoneMatchesDomain(requested.fullDomain, candidate.zone.name, requested.forceExactZone))
-        .sort((a, b) => b.zone.name.length - a.zone.name.length);
-    if (matches.length === 0) {
-        const account = input.account ? normalizeProviderAccount(input.account) : undefined;
-        const providerMessage = input.provider
-            ? `${getProviderDefinition(input.provider).displayName}${account ? ` account ${account}` : ''} does not have a matching DNS zone for ${requested.fullDomain}.`
-            : `No configured DNS provider has a matching DNS zone for ${requested.fullDomain}.`;
-        throw new DoomainError('PROVIDER_ZONE_NOT_FOUND', providerMessage, {
-            account,
-            configuredProviders: await providerConnectionDetails(),
-            domain: requested.fullDomain,
-            recovery: 'Retry with --provider <id> --account <alias> only if another configured provider account owns this zone. Otherwise connect the DNS provider account that owns this domain.',
-            searchedZones: zones.searched,
-            suggestedCommands: [`doomain link ${requested.fullDomain} --provider <id> --account <alias> --json`, 'doomain providers connect'],
-        });
-    }
-    const bestLength = matches[0].zone.name.length;
-    const bestMatches = matches.filter((candidate) => candidate.zone.name.length === bestLength);
-    const uniqueBestMatches = bestMatches.filter((candidate, index, candidates) => candidates.findIndex((item) => item.provider === candidate.provider && item.account === candidate.account && item.zone.name === candidate.zone.name) === index);
-    if (uniqueBestMatches.length > 1) {
-        throw new DoomainError('PROVIDER_ZONE_AMBIGUOUS', `Multiple DNS provider accounts have a matching DNS zone for ${requested.fullDomain}. Pass --provider and --account to choose one.`, { candidates: candidateDetails(uniqueBestMatches), domain: requested.fullDomain });
-    }
-    const selected = uniqueBestMatches[0];
-    return {
-        account: selected.account,
-        accountInferred: zones.accountInferred,
-        isDefaultAccount: selected.isDefaultAccount,
-        provider: selected.provider,
-        providerInferred: zones.providerInferred,
-        target: targetFromZone(requested.fullDomain, selected.zone.name),
-    };
-}
-function withProviderRecordOptions(provider, record) {
+export function withProviderRecordOptions(provider, record) {
     if (provider !== 'cloudflare' || !['A', 'AAAA', 'CNAME'].includes(record.type))
         return record;
     return { ...record, proxied: false };

package/oclif.manifest.json

@@ -225,6 +225,51 @@
         "wizard.js"
       ]
     },
+    "auth:clerk": {
+      "aliases": [],
+      "args": {},
+      "description": "Save Clerk Platform API credentials locally.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --platform-api-key ak_123 --app app_123 --json"
+      ],
+      "flags": {
+        "app": {
+          "description": "Default Clerk application id.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output a single JSON object and never prompt.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "platform-api-key": {
+          "description": "Clerk Platform API key (ak_...).",
+          "name": "platform-api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:clerk",
+      "pluginAlias": "doomain",
+      "pluginName": "doomain",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "clerk.js"
+      ]
+    },
     "auth:vercel": {
       "aliases": [],
       "args": {},
@@ -267,6 +312,66 @@
         "vercel.js"
       ]
     },
+    "domains:find": {
+      "aliases": [],
+      "args": {
+        "domain": {
+          "description": "Domain whose DNS provider should be found.",
+          "name": "domain",
+          "required": false
+        }
+      },
+      "description": "Find the configured DNS provider and account for a domain.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> example.com --json",
+        "<%= config.bin %> <%= command.id %> api.example.com --json",
+        "<%= config.bin %> <%= command.id %> --domain example.com --provider spaceship --json"
+      ],
+      "flags": {
+        "account": {
+          "description": "DNS provider profile/account alias. Defaults to the provider default account.",
+          "name": "account",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "domain": {
+          "description": "Target domain or base zone, for example app.example.com or example.com.",
+          "name": "domain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output a single JSON object and never prompt.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "provider": {
+          "description": "DNS provider id. Inferred from the target domain when omitted.",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "domains:find",
+      "pluginAlias": "doomain",
+      "pluginName": "doomain",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "domains",
+        "find.js"
+      ]
+    },
     "domains:list": {
       "aliases": [],
       "args": {},
@@ -639,6 +744,35 @@
         "verify.js"
       ]
     },
+    "auth:logout:clerk": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove saved Clerk credentials locally.",
+      "flags": {
+        "json": {
+          "description": "Output a single JSON object and never prompt.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:logout:clerk",
+      "pluginAlias": "doomain",
+      "pluginName": "doomain",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "logout",
+        "clerk.js"
+      ]
+    },
     "auth:logout:vercel": {
       "aliases": [],
       "args": {},
@@ -671,7 +805,94 @@
         "logout",
         "vercel.js"
       ]
+    },
+    "clerk:domains:add": {
+      "aliases": [],
+      "args": {
+        "domain": {
+          "description": "Production primary domain, for example example.com.",
+          "name": "domain",
+          "required": true
+        }
+      },
+      "description": "Create a Clerk production instance with its primary domain and configure DNS.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> example.com --app app_123 --json",
+        "<%= config.bin %> <%= command.id %> example.com --app app_123 --provider cloudflare --no-wait",
+        "<%= config.bin %> <%= command.id %> example.com --app app_123 --dry-run --json"
+      ],
+      "flags": {
+        "account": {
+          "description": "DNS provider profile/account alias. Defaults to the provider default account.",
+          "name": "account",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "app": {
+          "description": "Clerk application id. Defaults to CLERK_APPLICATION_ID or saved Clerk config.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Check the Clerk application and DNS zone without creating the production instance.",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Overwrite DNS records that conflict with Clerk requirements.",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output a single JSON object and never prompt.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "provider": {
+          "description": "DNS provider id. Inferred from the target domain when omitted.",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "description": "Wait timeout in seconds.",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait for Clerk DNS, SSL, and email DNS verification.",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "clerk:domains:add",
+      "pluginAlias": "doomain",
+      "pluginName": "doomain",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "clerk",
+        "domains",
+        "add.js"
+      ]
     }
   },
-  "version": "0.1.15"
+  "version": "0.1.17"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "doomain",
-  "description": "Link your vercel project and domain in seconds",
-  "version": "0.1.15",
+  "description": "Configure Vercel and Clerk production domains in seconds",
+  "version": "0.1.17",
   "author": "Crafter Station",
   "packageManager": "bun@1.3.13",
   "bin": {
@@ -39,7 +39,8 @@
   "keywords": [
     "dns",
     "domains",
-    "vercel"
+    "vercel",
+    "clerk"
   ],
   "license": "MIT",
   "main": "dist/index.js",
@@ -56,6 +57,9 @@
       "auth": {
         "description": "Manage authentication"
       },
+      "clerk": {
+        "description": "Configure Clerk production domains"
+      },
       "domains": {
         "description": "Inspect DNS domains"
       },