doomain 0.1.5 → 0.1.7

package/dist/commands/link.js

@@ -6,6 +6,7 @@ import { createOutput, outputError } from '../lib/output.js';
 export default class Link extends Command {
     static description = 'Link a Vercel project to a domain and create DNS records.';
     static examples = [
+        '<%= config.bin %> <%= command.id %> app.example.com --json',
         '<%= config.bin %> <%= command.id %> app.example.com --project my-app --json',
         '<%= config.bin %> <%= command.id %> --domain app.example.com --project my-app --json',
         '<%= config.bin %> <%= command.id %> --domain example.com --subdomain app --project my-app',
@@ -18,7 +19,7 @@ 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 aliases 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,

package/dist/lib/command-schema.d.ts

@@ -2,6 +2,9 @@ export interface CommandSchema {
     name: string;
     description: string;
     examples: string[];
+    agentHint?: string;
+    mutates?: boolean;
+    safeForAgents?: boolean;
     flags: Array<{
         name: string;
         type: 'boolean' | 'integer' | 'string';

package/dist/lib/command-schema.js

@@ -3,18 +3,22 @@ export const commandSchemas = [
         name: 'link',
         description: 'Link a Vercel project to a domain and create DNS records.',
         examples: [
+            'doomain link app.example.com --json',
             'doomain link app.example.com --project my-app --json',
             'doomain link --domain app.example.com --project my-app --json',
             'doomain link --domain example.com --subdomain app --project my-app --json',
             'doomain link --provider spaceship --domain example.com --apex --project my-app --dry-run --json',
         ],
+        agentHint: 'For agent use, run `doomain link <domain> --json`. The project is inferred from --project, DOOMAIN_PROJECT, config defaults, .vercel/project.json, or nearest package.json name.',
+        mutates: true,
+        safeForAgents: true,
         flags: [
             { name: 'json', type: 'boolean', description: 'Output a single JSON object and never prompt.' },
             { name: 'provider', type: 'string', description: 'DNS provider id. Inferred from the target domain when omitted.' },
             { name: 'domain', type: 'string', description: 'Target domain or base zone, for example app.example.com or example.com.' },
             { name: 'subdomain', type: 'string', description: 'Subdomain to add.' },
             { name: 'apex', type: 'boolean', description: 'Use the root/apex domain.' },
-            { name: 'project', type: 'string', description: 'Vercel project id/name.' },
+            { name: 'project', type: 'string', description: 'Vercel project id/name. Optional when project inference succeeds.' },
             { name: 'dry-run', type: 'boolean', description: 'Preview changes without writing.' },
             { name: 'force', type: 'boolean', description: 'Overwrite conflicting DNS records.' },
             { name: 'wait', type: 'boolean', description: 'Wait for DNS and Vercel verification.', default: true },

package/dist/lib/config.d.ts

@@ -22,6 +22,7 @@ export interface DoomainConfig {
         [provider: string]: ProviderConfig | SpaceshipProviderConfig | undefined;
     };
     defaults?: {
+        project?: string;
         provider?: string;
         domain?: string;
     };

package/dist/lib/flags.js

@@ -6,5 +6,5 @@ export const subdomainFlag = Flags.string({ description: 'Subdomain to add, for
 export const apexFlag = Flags.boolean({ description: 'Use the root/apex domain instead of a subdomain.' });
 export const projectFlag = Flags.string({
     char: 'p',
-    description: 'Vercel project id/name. Auto-detected from .vercel/project.json when omitted.',
+    description: 'Vercel project id/name. Inferred from env, config, .vercel/project.json, or package.json when omitted.',
 });

package/dist/lib/link-domain.d.ts

@@ -11,6 +11,7 @@ export interface LinkDomainInput {
     timeoutSeconds?: number;
     progress?: LinkDomainProgressCallback;
 }
+export type LinkDomainProjectSource = 'config' | 'env' | 'flag' | 'packageJson' | 'vercelProjectFile';
 export type LinkDomainProgressStage = 'dns:apply' | 'dns:plan' | 'dns:resolve-zone' | 'dns:wait' | 'vercel:add-domain' | 'vercel:get-domain' | 'vercel:get-target' | 'vercel:verify';
 export interface LinkDomainProgress {
     message: string;
@@ -21,6 +22,7 @@ export interface LinkDomainPlan {
     provider: string;
     providerInferred: boolean;
     project: string;
+    projectSource: LinkDomainProjectSource;
     recordName: string;
     zoneDomain: string;
     domain: string;

package/dist/lib/link-domain.js

@@ -1,4 +1,6 @@
 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 { DoomainError } from './errors.js';
 import { detectLocalVercelProject } from './local-vercel.js';
@@ -19,13 +21,92 @@ async function resolveConfiguredDomain(domain) {
         throw new DoomainError('MISSING_ARGUMENT', 'Domain is required. Use --domain or set a default domain.');
     return resolved;
 }
-function resolveProject(project) {
+function findPackageProjectName(start = process.cwd()) {
+    let current = start;
+    const root = parse(start).root;
+    while (true) {
+        const packagePath = join(current, 'package.json');
+        if (existsSync(packagePath)) {
+            try {
+                const data = JSON.parse(readFileSync(packagePath, 'utf8'));
+                if (typeof data.name === 'string' && data.name.trim())
+                    return data.name.trim();
+            }
+            catch {
+                return undefined;
+            }
+        }
+        if (current === root)
+            return undefined;
+        current = dirname(current);
+    }
+}
+function projectSuggestionScore(projectName, project) {
+    const target = projectName.toLowerCase();
+    const name = project.name.toLowerCase();
+    const id = project.id.toLowerCase();
+    if (name === target || id === target)
+        return 0;
+    if (name.startsWith(target))
+        return 1;
+    if (name.includes(target))
+        return 2;
+    if (target.includes(name))
+        return 3;
+    const targetParts = target.split(/[^a-z0-9]+/).filter(Boolean);
+    const matchingParts = targetParts.filter((part) => name.includes(part)).length;
+    return matchingParts > 0 ? 4 + (targetParts.length - matchingParts) : 99;
+}
+function projectSuggestions(projectName, projects) {
+    const seen = new Set();
+    return projects
+        .filter((project) => {
+        if (seen.has(project.id))
+            return false;
+        seen.add(project.id);
+        return true;
+    })
+        .map((project) => ({ project, score: projectSuggestionScore(projectName, project) }))
+        .filter(({ score }) => score < 99)
+        .sort((a, b) => a.score - b.score || a.project.name.localeCompare(b.project.name))
+        .slice(0, 5)
+        .map(({ project }) => ({ id: project.id, name: project.name }));
+}
+async function resolvePackageProject(projectName) {
+    const vercel = createVercelClient(await resolveVercelConfig());
+    const projects = await vercel.listProjects(projectName);
+    const match = projects.find((project) => project.name === projectName || project.id === projectName);
+    if (match)
+        return match.name;
+    const allProjects = await vercel.listProjects().catch(() => []);
+    const suggestions = projectSuggestions(projectName, [...projects, ...allProjects]);
+    throw new DoomainError('VERCEL_PROJECT_NOT_LINKED', `No Vercel project named ${projectName} was found. Pass --project to choose a project.`, {
+        project: projectName,
+        projectSource: 'packageJson',
+        suggestions,
+    });
+}
+async function resolveProject(project) {
     if (project)
-        return { project, localProjectDetected: false };
+        return { project, projectSource: 'flag', localProjectDetected: false };
+    const config = await loadConfig();
+    const envProject = process.env.DOOMAIN_PROJECT;
+    if (envProject)
+        return { project: envProject, projectSource: 'env', localProjectDetected: false };
+    if (config.defaults?.project)
+        return { project: config.defaults.project, projectSource: 'config', localProjectDetected: false };
     const localProject = detectLocalVercelProject();
     if (localProject)
-        return { project: localProject.projectId, localProjectDetected: true };
-    throw new DoomainError('VERCEL_PROJECT_NOT_LINKED', 'No linked Vercel project found. Run inside a Vercel project or pass --project.');
+        return { project: localProject.projectId, projectSource: 'vercelProjectFile', localProjectDetected: true };
+    const packageProject = findPackageProjectName();
+    if (packageProject) {
+        return {
+            project: await resolvePackageProject(packageProject),
+            projectSource: 'packageJson',
+            localProjectDetected: false,
+        };
+    }
+    throw new DoomainError('VERCEL_PROJECT_NOT_LINKED', 'No Vercel project could be inferred. Run inside a project with package.json/.vercel/project.json or pass --project.');
 }
 async function resolveZone(provider, zoneDomain) {
     const zone = await provider.getZone(zoneDomain);
@@ -312,7 +393,7 @@ function reportProgress(input, stage, message) {
     input.progress?.({ message, stage });
 }
 export async function createLinkPlan(input) {
-    const project = resolveProject(input.project);
+    const project = await resolveProject(input.project);
     const resolved = await resolveProviderTarget(input);
     const { provider, providerInferred, target } = resolved;
     const record = planBaseRecord({ isApex: target.isApex, provider, recordName: target.recordName });
@@ -320,6 +401,7 @@ export async function createLinkPlan(input) {
         provider,
         providerInferred,
         project: project.project,
+        projectSource: project.projectSource,
         recordName: target.recordName,
         zoneDomain: target.zoneDomain,
         domain: target.fullDomain,

package/dist/lib/vercel.js

@@ -43,9 +43,11 @@ function isDomainConflictError(error) {
 function isSameDomain(value, domain) {
     return typeof value === 'string' && value.toLowerCase() === domain.toLowerCase();
 }
-function findAliasTarget(raw, domain) {
+function findProjectDomainTarget(raw, domain) {
     const targets = Array.isArray(raw) ? raw : [raw];
-    return targets.find((target) => target && typeof target === 'object' && isSameDomain(target.domain, domain));
+    return targets.find((target) => target &&
+        typeof target === 'object' &&
+        (isSameDomain(target.domain, domain) || isSameDomain(target.name, domain)));
 }
 export function createVercelClient(config) {
     async function request(path, init = {}, opts = {}) {
@@ -59,7 +61,7 @@ export function createVercelClient(config) {
         });
         if (!response.ok) {
             const body = (await response.json().catch(() => undefined));
-            if (response.status === 401 || response.status === 403) {
+            if (response.status === 401) {
                 throw new DoomainError('VERCEL_AUTH_FAILED', vercelAuthErrorMessage(body), body);
             }
             throw new DoomainError('DOMAIN_LINK_FAILED', apiErrorMessage(response.status, body), body);
@@ -123,15 +125,15 @@ export function createVercelClient(config) {
         },
         async addDomainToProject(project, domain, opts = {}) {
             try {
-                const raw = await request(`/projects/${encodeURIComponent(project)}/alias`, {
+                const raw = await request(`/v10/projects/${encodeURIComponent(project)}/domains`, {
                     method: 'POST',
-                    body: JSON.stringify({ domain, target: 'PRODUCTION' }),
+                    body: JSON.stringify({ name: domain }),
                 });
-                const aliasTarget = findAliasTarget(raw, domain);
-                if (!aliasTarget) {
+                const projectDomain = findProjectDomainTarget(raw, domain);
+                if (!projectDomain) {
                     throw new DoomainError('DOMAIN_LINK_FAILED', `Vercel did not return ${domain} after adding it to project ${project}.`, raw);
                 }
-                return { alreadyAdded: false, raw: aliasTarget };
+                return { alreadyAdded: false, raw: projectDomain };
             }
             catch (error) {
                 if (isDomainConflictError(error)) {
@@ -175,7 +177,7 @@ export function createVercelClient(config) {
             return result.domains ?? [];
         },
         async removeDomainFromProject(project, domain) {
-            await request(`/projects/${encodeURIComponent(project)}/alias?domain=${encodeURIComponent(domain)}`, { method: 'DELETE' });
+            await request(`/v9/projects/${encodeURIComponent(project)}/domains/${encodeURIComponent(domain)}`, { method: 'DELETE' });
         },
         async verifyProjectDomain(project, domain) {
             return request(`/v9/projects/${encodeURIComponent(project)}/domains/${encodeURIComponent(domain)}/verify`, { method: 'POST' });

package/oclif.manifest.json

@@ -11,6 +11,7 @@
       },
       "description": "Link a Vercel project to a domain and create DNS records.",
       "examples": [
+        "<%= config.bin %> <%= command.id %> app.example.com --json",
         "<%= config.bin %> <%= command.id %> app.example.com --project my-app --json",
         "<%= config.bin %> <%= command.id %> --domain app.example.com --project my-app --json",
         "<%= config.bin %> <%= command.id %> --domain example.com --subdomain app --project my-app",
@@ -37,7 +38,7 @@
           "type": "boolean"
         },
         "force": {
-          "description": "Move existing Vercel aliases and overwrite conflicting DNS records.",
+          "description": "Move existing Vercel project domains and overwrite conflicting DNS records.",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
@@ -50,7 +51,7 @@
         },
         "project": {
           "char": "p",
-          "description": "Vercel project id/name. Auto-detected from .vercel/project.json when omitted.",
+          "description": "Vercel project id/name. Inferred from env, config, .vercel/project.json, or package.json when omitted.",
           "name": "project",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -159,7 +160,7 @@
         },
         "project": {
           "char": "p",
-          "description": "Vercel project id/name. Auto-detected from .vercel/project.json when omitted.",
+          "description": "Vercel project id/name. Inferred from env, config, .vercel/project.json, or package.json when omitted.",
           "name": "project",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -335,39 +336,6 @@
         "list.js"
       ]
     },
-    "auth:logout:vercel": {
-      "aliases": [],
-      "args": {},
-      "description": "Remove saved Vercel credentials locally.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output a single JSON object and never prompt.",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "auth:logout:vercel",
-      "pluginAlias": "doomain",
-      "pluginName": "doomain",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "auth",
-        "logout",
-        "vercel.js"
-      ]
-    },
     "providers:add": {
       "aliases": [],
       "args": {
@@ -627,7 +595,40 @@
         "providers",
         "verify.js"
       ]
+    },
+    "auth:logout:vercel": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove saved Vercel credentials locally.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output a single JSON object and never prompt.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:logout:vercel",
+      "pluginAlias": "doomain",
+      "pluginName": "doomain",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "logout",
+        "vercel.js"
+      ]
     }
   },
-  "version": "0.1.5"
+  "version": "0.1.7"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "doomain",
   "description": "Link your vercel project and domain in seconds",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "author": "Crafter Station",
   "packageManager": "bun@1.3.13",
   "bin": {