@unstoppabledomains/ud-cli 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,3 @@
+import { program } from './program.js';
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/api.d.ts

@@ -0,0 +1,7 @@
+import { mcpBaseUrl, apiBaseUrl } from './config.js';
+import type { AuthStatus } from './types.js';
+export declare function callAction(toolName: string, params: Record<string, unknown>): Promise<unknown>;
+export declare function healthCheck(): Promise<boolean>;
+export declare function verifyAuth(): Promise<AuthStatus>;
+export { apiBaseUrl, mcpBaseUrl };
+//# sourceMappingURL=api.d.ts.map

package/dist/lib/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIjF,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AA6GxD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAQpD;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAmDtD;AAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC"}

package/dist/lib/api.js

@@ -0,0 +1,162 @@
+import { getActiveEnv, getEnvConfig, mcpBaseUrl, apiBaseUrl } from './config.js';
+import { getApiKey, getTokens, saveTokens } from './credentials.js';
+import { refreshAccessToken, discoverMetadata } from './oauth.js';
+import { ApiError } from './types.js';
+const REFRESH_BUFFER_MS = 60_000; // Refresh 60s before expiry
+async function getAuthHeader() {
+    const env = getActiveEnv();
+    const envConfig = getEnvConfig(env);
+    if (envConfig.authMethod === 'oauth') {
+        let tokens = await getTokens(env);
+        if (!tokens)
+            return null;
+        // Proactive refresh if token expires within buffer
+        if (tokens.expiresAt - Date.now() < REFRESH_BUFFER_MS) {
+            tokens = await tryRefreshTokens(tokens);
+        }
+        return `Bearer ${tokens.accessToken}`;
+    }
+    // Default: API key
+    const apiKey = await getApiKey(env);
+    if (!apiKey)
+        return null;
+    return `Bearer ${apiKey}`;
+}
+async function tryRefreshTokens(tokens) {
+    const envConfig = getEnvConfig();
+    const clientId = envConfig.oauth?.clientId;
+    if (!clientId)
+        return tokens;
+    try {
+        const metadata = await discoverMetadata();
+        const response = await refreshAccessToken(metadata.token_endpoint, tokens.refreshToken, clientId);
+        const refreshed = {
+            accessToken: response.access_token,
+            refreshToken: response.refresh_token,
+            expiresAt: Date.now() + response.expires_in * 1000,
+            scope: response.scope,
+        };
+        await saveTokens(refreshed);
+        return refreshed;
+    }
+    catch {
+        // If refresh fails, return original tokens and let the 401 retry handle it
+        return tokens;
+    }
+}
+async function request(url, options = {}, retry = true) {
+    const authHeader = await getAuthHeader();
+    const headers = {
+        'Content-Type': 'application/json',
+        ...options.headers,
+    };
+    if (authHeader) {
+        headers['Authorization'] = authHeader;
+    }
+    const res = await fetch(url, { ...options, headers });
+    // Reactive refresh: retry once on 401
+    if (res.status === 401 && retry) {
+        const envConfig = getEnvConfig();
+        if (envConfig.authMethod === 'oauth') {
+            const tokens = await getTokens();
+            if (tokens) {
+                const refreshed = await tryRefreshTokens(tokens);
+                if (refreshed.accessToken !== tokens.accessToken) {
+                    return request(url, options, false);
+                }
+            }
+        }
+    }
+    return res;
+}
+function parseError(status, body) {
+    try {
+        const json = JSON.parse(body);
+        const message = json.message ?? json.error ?? body;
+        switch (status) {
+            case 400:
+                return new ApiError(`Bad request: ${message}`, 400, 'BAD_REQUEST');
+            case 401:
+                return new ApiError('Authentication failed. Run `ud auth login` to authenticate.', 401, 'UNAUTHORIZED');
+            case 403:
+                return new ApiError(`Access denied: ${message}`, 403, 'FORBIDDEN');
+            default:
+                return new ApiError(`API error (${status}): ${message}`, status, 'API_ERROR');
+        }
+    }
+    catch {
+        return new ApiError(`API error (${status}): ${body}`, status, 'API_ERROR');
+    }
+}
+// --- Public API ---
+export async function callAction(toolName, params) {
+    const url = `${mcpBaseUrl()}/actions/${toolName}`;
+    const res = await request(url, {
+        method: 'POST',
+        body: JSON.stringify(params),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw parseError(res.status, body);
+    }
+    return res.json();
+}
+export async function healthCheck() {
+    try {
+        const url = `${mcpBaseUrl()}/health`;
+        const res = await fetch(url);
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export async function verifyAuth() {
+    const env = getActiveEnv();
+    const envConfig = getEnvConfig(env);
+    // Check if any credentials exist
+    const hasApiKey = !!(await getApiKey(env));
+    const hasTokens = !!(await getTokens(env));
+    if (!hasApiKey && !hasTokens) {
+        return {
+            authenticated: false,
+            environment: env,
+            message: 'Not authenticated. Run `ud auth login` to get started.',
+        };
+    }
+    const method = envConfig.authMethod ?? (hasApiKey ? 'api-key' : 'oauth');
+    try {
+        // Use portfolio list as a lightweight auth check
+        const url = `${mcpBaseUrl()}/actions/ud_portfolio_list`;
+        const res = await request(url, {
+            method: 'POST',
+            body: JSON.stringify({ limit: 1 }),
+        });
+        if (res.ok) {
+            return {
+                authenticated: true,
+                method,
+                environment: env,
+                message: `Authenticated via ${method} to ${env}`,
+            };
+        }
+        const body = await res.text();
+        const error = parseError(res.status, body);
+        return {
+            authenticated: false,
+            method,
+            environment: env,
+            message: error.message,
+        };
+    }
+    catch (err) {
+        return {
+            authenticated: false,
+            method,
+            environment: env,
+            message: `Connection error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+export { apiBaseUrl, mcpBaseUrl };
+//# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,49 @@
+/**
+ * Declarative hook definitions for commands that need special behavior
+ * beyond the standard API call (confirmations, OTP prompts, operation hints).
+ */
+export interface CommandHooks {
+    /** Require --confirm flag or interactive prompt before executing. */
+    requireConfirm?: {
+        /** API param name to set when confirmed (e.g., 'confirmDeleteAll'). Omit if no API param needed. */
+        paramName?: string;
+        /** Warning message shown to the user. */
+        message: string;
+    };
+    /** Prompt for a value interactively if the corresponding flag is not provided. */
+    promptInput?: {
+        /** CLI flag name (kebab-case, e.g., 'otp-code'). */
+        flagName: string;
+        /** API param name to set with the input value. */
+        paramName: string;
+        /** Prompt message shown to the user. */
+        prompt: string;
+        /** Regex to validate user input. */
+        validate?: RegExp;
+    };
+    /** Transform the request body before sending (e.g., price conversion). */
+    transformBody?: (body: Record<string, unknown>, opts: Record<string, unknown>) => Record<string, unknown>;
+    /** Register a --price <dollars> option for this command. */
+    priceOption?: boolean;
+    /** Show an operation-tracking hint after the API call completes. */
+    showOperationHint?: boolean;
+    /** Show a cart-add hint using the first available result from search. */
+    showCartHint?: boolean;
+}
+/**
+ * Get hooks for a given tool name. Returns undefined if no hooks defined.
+ */
+export declare function getHooks(toolName: string): CommandHooks | undefined;
+/**
+ * Format a hint about async DNS operations from an API response.
+ * Scans result.results[] for items with operationId and collects unique domains.
+ */
+export declare function formatOperationHint(result: unknown): string;
+/** Map marketplace source to the corresponding cart add subcommand. */
+export declare const SOURCE_TO_CART_CMD: Record<string, string>;
+/**
+ * Format a cart-add hint from domain search results.
+ * Shows one example per marketplace source type found in the results.
+ */
+export declare function formatCartHint(result: unknown): string;
+//# sourceMappingURL=command-hooks.d.ts.map

package/dist/lib/command-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/command-hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,cAAc,CAAC,EAAE;QACf,oGAAoG;QACpG,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,yCAAyC;QACzC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,kFAAkF;IAClF,WAAW,CAAC,EAAE;QACZ,oDAAoD;QACpD,QAAQ,EAAE,MAAM,CAAC;QACjB,kDAAkD;QAClD,SAAS,EAAE,MAAM,CAAC;QAClB,wCAAwC;QACxC,MAAM,EAAE,MAAM,CAAC;QACf,oCAAoC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1G,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA0ED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CA2B3D;AAED,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CA2BtD"}

package/dist/lib/command-hooks.js

@@ -0,0 +1,150 @@
+/**
+ * Declarative hook definitions for commands that need special behavior
+ * beyond the standard API call (confirmations, OTP prompts, operation hints).
+ */
+import chalk from 'chalk';
+/**
+ * Create a transformBody hook that converts --price (dollars) to priceInCents on each item.
+ */
+function makePriceTransformer(arrayKey) {
+    return (body, opts) => {
+        const price = opts.price;
+        if (price !== undefined) {
+            const num = Number(price);
+            if (Number.isNaN(num) || num < 0) {
+                throw new Error(`Invalid --price value: "${price}". Must be a non-negative number (e.g., 99.99).`);
+            }
+            const cents = Math.round(num * 100);
+            if (Array.isArray(body[arrayKey])) {
+                for (const item of body[arrayKey]) {
+                    if (item.priceInCents === undefined)
+                        item.priceInCents = cents;
+                }
+            }
+        }
+        return body;
+    };
+}
+const HOOKS = {
+    ud_dns_records_remove_all: {
+        requireConfirm: {
+            paramName: 'confirmDeleteAll',
+            message: 'This will delete ALL DNS records for the specified domain(s). Are you sure?',
+        },
+        showOperationHint: true,
+    },
+    ud_domain_remove_lander: {
+        requireConfirm: {
+            message: 'This will remove the AI lander for the specified domain(s). Are you sure?',
+        },
+        showOperationHint: true,
+    },
+    ud_domain_push: {
+        promptInput: {
+            flagName: 'otp-code',
+            paramName: 'otpCode',
+            prompt: 'Enter 6-digit OTP code: ',
+            validate: /^\d{6}$/,
+        },
+    },
+    ud_cart_checkout: {
+        requireConfirm: {
+            message: 'Are you sure you want to complete this purchase? Review your cart with: ud cart get',
+        },
+    },
+    ud_listing_cancel: {
+        requireConfirm: {
+            message: 'This will cancel the specified listing(s). Are you sure?',
+        },
+    },
+    ud_listing_create: {
+        priceOption: true,
+        transformBody: makePriceTransformer('domains'),
+    },
+    ud_listing_update: {
+        priceOption: true,
+        transformBody: makePriceTransformer('listings'),
+    },
+    ud_domains_search: { showCartHint: true },
+    ud_dns_record_add: { showOperationHint: true },
+    ud_dns_record_update: { showOperationHint: true },
+    ud_dns_record_remove: { showOperationHint: true },
+    ud_dns_nameservers_set_custom: { showOperationHint: true },
+    ud_dns_nameservers_set_default: { showOperationHint: true },
+    ud_dns_hosting_add: { showOperationHint: true },
+    ud_dns_hosting_remove: { showOperationHint: true },
+};
+/**
+ * Get hooks for a given tool name. Returns undefined if no hooks defined.
+ */
+export function getHooks(toolName) {
+    return HOOKS[toolName];
+}
+/**
+ * Format a hint about async DNS operations from an API response.
+ * Scans result.results[] for items with operationId and collects unique domains.
+ */
+export function formatOperationHint(result) {
+    if (!result || typeof result !== 'object')
+        return '';
+    const obj = result;
+    const results = obj.results;
+    if (!Array.isArray(results))
+        return '';
+    const domains = new Set();
+    let hasOps = false;
+    for (const item of results) {
+        if (item.operationId !== undefined) {
+            hasOps = true;
+            if (typeof item.domain === 'string') {
+                domains.add(item.domain);
+            }
+        }
+    }
+    if (!hasOps)
+        return '';
+    const domainList = [...domains].join(' ');
+    const trackCmd = domainList
+        ? `ud domains operations ${domainList}`
+        : 'ud domains operations <domain>';
+    return chalk.dim(`Tip: DNS changes are async. Track with: ${trackCmd}`);
+}
+/** Map marketplace source to the corresponding cart add subcommand. */
+export const SOURCE_TO_CART_CMD = {
+    unstoppable_domains: 'registration',
+    aftermarket: 'listed',
+    afternic: 'afternic',
+    sedo: 'sedo',
+};
+/**
+ * Format a cart-add hint from domain search results.
+ * Shows one example per marketplace source type found in the results.
+ */
+export function formatCartHint(result) {
+    if (!result || typeof result !== 'object')
+        return '';
+    const obj = result;
+    const results = (obj.results ?? obj.domains);
+    if (!Array.isArray(results) || results.length === 0)
+        return '';
+    // Collect one example per marketplace source type
+    const seenSources = new Map();
+    for (const item of results) {
+        if (item.available !== true)
+            continue;
+        const name = item.name;
+        if (!name)
+            continue;
+        const marketplace = item.marketplace;
+        const source = marketplace?.source;
+        const subCmd = SOURCE_TO_CART_CMD[source ?? ''] ?? 'registration';
+        if (!seenSources.has(subCmd)) {
+            seenSources.set(subCmd, { name, subCmd });
+        }
+    }
+    if (seenSources.size === 0)
+        return '';
+    const lines = [...seenSources.values()].map(({ name, subCmd }) => `  ud cart add ${subCmd} ${name}`);
+    return chalk.dim(`\nTo add to cart:\n${lines.join('\n')}`);
+}
+//# sourceMappingURL=command-hooks.js.map

package/dist/lib/command-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-hooks.js","sourceRoot":"","sources":["../../src/lib/command-hooks.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+/**
+ * Static command routing table that maps API tool names to CLI command hierarchy.
+ *
+ * Each route defines:
+ * - The tool name (matches the OpenAPI spec endpoint)
+ * - The CLI path as [group, subgroup?, command]
+ * - Optional positional arguments
+ */
+export interface PositionalArg {
+    name: string;
+    description: string;
+    required: boolean;
+    variadic: boolean;
+}
+export interface CommandRoute {
+    toolName: string;
+    path: string[];
+    positionalArgs: PositionalArg[];
+    description?: string;
+}
+export declare const COMMAND_ROUTES: CommandRoute[];
+/**
+ * Returns the set of unique top-level group names.
+ */
+export declare function getGroups(): string[];
+/**
+ * Builds a lookup map from toolName → CommandRoute.
+ */
+export declare function buildRouteMap(): Map<string, CommandRoute>;
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/lib/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/lib/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,EAAE,YAAY,EA+SxC,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAMpC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAMzD"}