dominion-cli 0.1.0

package/README.md

@@ -0,0 +1,304 @@
+# dominion
+
+[![npm version](https://img.shields.io/npm/v/dominion-cli.svg)](https://www.npmjs.com/package/dominion-cli)
+[![license](https://img.shields.io/npm/l/dominion-cli.svg)](https://github.com/dominioncli/dominion-cli/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/dominion-cli.svg)](https://nodejs.org)
+
+```
+██████╗  ██████╗ ███╗   ███╗██╗███╗   ██╗██╗ ██████╗ ███╗   ██╗
+██╔══██╗██╔═══██╗████╗ ████║██║████╗  ██║██║██╔═══██╗████╗  ██║
+██║  ██║██║   ██║██╔████╔██║██║██╔██╗ ██║██║██║   ██║██╔██╗ ██║
+██║  ██║██║   ██║██║╚██╔╝██║██║██║╚██╗██║██║██║   ██║██║╚██╗██║
+██████╔╝╚██████╔╝██║ ╚═╝ ██║██║██║ ╚████║██║╚██████╔╝██║ ╚████║
+╚═════╝  ╚═════╝ ╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝ ╚═════╝ ╚═╝  ╚═══╝
+```
+
+**Premium CLI for domain search, registration, and management.**
+
+Search, register, and manage domains directly from your terminal. Built with [Ink](https://github.com/vadimdemedes/ink) for rich TUI output, backed by the [Name.com](https://www.name.com) API, with optional [Vercel](https://vercel.com) integration for seamless deployments.
+
+---
+
+## Install
+
+```bash
+npm install -g dominion-cli
+```
+
+Verify the installation:
+
+```bash
+dominion --version
+```
+
+Requires Node.js 18+.
+
+---
+
+## Quickstart
+
+Get from zero to domain owner in five steps.
+
+### 1. Authenticate
+
+```bash
+dominion login
+```
+
+Enter your Name.com API username and token. Credentials are stored locally at `~/.dominion/config.json` with `0600` permissions (owner-only).
+
+> Don't have an API token? Run `dominion login --browser` to open the Name.com API keys page.
+
+### 2. Search for domains
+
+```bash
+dominion search myapp
+```
+
+Returns an availability table across popular TLDs with pricing:
+
+```
+  Domain            Price     Status
+  ─────────────────────────────────────
+  myapp.com         $12.99    ✓ Available
+  myapp.net         $11.99    ✓ Available
+  myapp.io          $39.99    ✓ Available (Premium)
+  myapp.org         $12.99    ✗ Taken
+  myapp.co          $29.99    ✓ Available
+```
+
+Filter by TLD or budget:
+
+```bash
+dominion search myapp --tld com,io --max-price 20
+```
+
+### 3. Add to cart
+
+```bash
+dominion cart add myapp.com
+```
+
+### 4. Purchase
+
+```bash
+dominion buy
+```
+
+Reviews your cart, confirms pricing, and registers all domains in a single transaction.
+
+### 5. Manage
+
+```bash
+dominion domains myapp.com          # View domain details
+dominion dns myapp.com list         # List DNS records
+dominion dns myapp.com add A @ 76.76.21.21  # Point to your server
+```
+
+---
+
+## Features
+
+### Domain Search
+
+Interactive TUI-powered domain search across multiple TLDs. Filter by price, filter by TLD, and add results directly to your cart.
+
+### Shopping Cart
+
+Persistent cart stored at `~/.dominion/cart.json`. Add, remove, and review domains before purchasing. Stale prices (older than 24 hours) are flagged automatically.
+
+### Purchase Flow
+
+Batch-purchase all cart items or buy a single domain directly with `dominion buy myapp.com`. Skip the confirmation prompt with `--yes` for scripted workflows.
+
+### Domain Management
+
+List all domains in your account, view detailed settings, expiration dates, nameserver configuration, and auto-renewal status.
+
+### DNS Records
+
+Full CRUD for DNS records: A, AAAA, CNAME, MX, TXT, SRV, NS, ANAME, and URL redirect. Set custom TTLs and priorities.
+
+### Domain Settings
+
+Configure auto-renew, domain lock, and nameservers. Switch nameservers instantly with presets:
+
+```bash
+dominion settings myapp.com set nameservers --preset vercel
+dominion settings myapp.com set nameservers --preset namecom
+```
+
+### Vercel Integration
+
+Connect your Vercel account and link domains to projects with automatic DNS configuration:
+
+```bash
+dominion vercel setup                # Configure Vercel token
+dominion vercel link myapp.com       # Link domain to Vercel project
+dominion vercel status               # View integration status
+```
+
+### Team Management
+
+Add collaborators with role-based access:
+
+```bash
+dominion team add alice@example.com --role admin --name "Alice"
+dominion team list
+dominion team remove alice@example.com
+```
+
+Roles: `admin`, `member`, `viewer`.
+
+### Webhooks
+
+Get notified when domain events occur:
+
+```bash
+dominion webhooks add https://api.example.com/hooks --events domain.registered,dns.changed
+dominion webhooks list
+dominion webhooks remove <id>
+```
+
+Supported events: `domain.registered`, `domain.expired`, `dns.changed`, `domain.renewed`.
+
+### Billing
+
+View a billing summary across all your domains:
+
+```bash
+dominion billing
+```
+
+### Account
+
+View and update your account details and WHOIS contact information:
+
+```bash
+dominion account                     # View account details
+dominion account set contact         # Update WHOIS contact info interactively
+dominion account set email new@example.com
+```
+
+---
+
+## Command Tree
+
+```
+dominion
+├── login [--browser]                    Authenticate with Name.com API credentials
+├── logout                               Clear stored credentials
+├── whoami                               Display authenticated user info
+├── search <query> [--tld] [--max-price] Search for available domains
+├── cart
+│   ├── list                             View cart contents
+│   ├── add <domain>                     Add a domain to your cart
+│   ├── remove <domain>                  Remove a domain from your cart
+│   └── clear                            Clear all items from your cart
+├── buy [domain] [--yes]                 Purchase domain(s) from cart or by name
+├── domains [domain] [--json]            List domains or view domain details
+├── dns <domain>
+│   ├── list [--json]                    List DNS records
+│   ├── add <type> <name> <value>        Add a DNS record [--ttl] [--priority]
+│   └── remove <record-id>              Remove a DNS record
+├── settings <domain>
+│   └── set <key> <value> [--preset]     Update domain settings
+├── account
+│   └── set
+│       ├── contact                      Set or update WHOIS contact info
+│       └── email <email>                Update contact email address
+├── billing                              View domain billing summary
+├── team
+│   ├── list                             List team members
+│   ├── add <email> [--role] [--name]    Add a team member
+│   └── remove <member>                  Remove a team member
+├── vercel
+│   ├── status                           View Vercel integration status
+│   ├── setup                            Configure Vercel integration
+│   ├── link <domain>                    Link a domain to Vercel project
+│   └── unlink <domain>                  Unlink a domain from Vercel project
+├── webhooks
+│   ├── list                             List configured webhooks
+│   ├── add <url> [--events]             Add a webhook
+│   └── remove <id>                      Remove a webhook by ID
+├── integrations                         View available integrations
+├── credits                              View the credits
+├── --version, -v                        Print the current version
+└── --help, -h                           Display help for command
+```
+
+---
+
+## Configuration
+
+All data is stored in `~/.dominion/`:
+
+```
+~/.dominion/
+├── config.json          API credentials, Vercel config, preferences
+├── cart.json             Shopping cart (domains pending purchase)
+├── team.json             Team member list
+├── webhooks.json         Webhook configurations
+└── achievements.json     Unlocked achievements and usage stats
+```
+
+`config.json` is created with `0600` file permissions to protect your API credentials.
+
+For details on each file's schema, see [docs/configuration.md](docs/configuration.md).
+
+---
+
+## Easter Eggs
+
+Dominion has a few surprises hidden throughout the CLI. Here are some hints:
+
+- Try searching for some famous sci-fi domains. HAL might have something to say.
+- There's a classic cheat code that works in the terminal. Think 1986, Konami.
+- Run dominion on certain... unlucky dates. The CLI gets a little spooky.
+- Somewhere in the CLI, there's a command that isn't listed. Hackers welcome.
+- Use the CLI enough and you'll start earning achievements. Can you collect all 10?
+
+No spoilers. Discover them yourself.
+
+---
+
+## Scripting & CI/CD
+
+Dominion is built for automation. Use these flags to integrate with scripts and pipelines:
+
+```bash
+# Suppress decorative output (logos, animations)
+dominion domains --quiet
+
+# Disable color output (for log files and CI)
+dominion domains --no-color
+
+# Get machine-readable output
+dominion domains --json
+
+# Skip confirmation prompts
+dominion buy --yes
+
+# Combine for fully non-interactive operation
+dominion domains --json --quiet --no-color
+```
+
+Pipe JSON output to `jq` for processing:
+
+```bash
+dominion domains --json --quiet | jq '.[].domainName'
+```
+
+Environment variable support: set `NO_COLOR=1` to disable colors globally ([no-color.org](https://no-color.org)).
+
+---
+
+## Contributing
+
+See [docs/contributing.md](docs/contributing.md) for setup instructions, coding patterns, and the PR checklist.
+
+---
+
+## License
+
+[MIT](LICENSE)

package/dist/app.d.ts

@@ -0,0 +1,15 @@
+interface AppProps {
+    command?: string;
+    children?: React.ReactNode;
+    version?: string;
+}
+/**
+ * Root Ink application shell.
+ * Wraps command output in the standard Layout chrome.
+ *
+ * When invoked with no command, shows the full gradient logo
+ * with tagline and version — the "welcome screen".
+ */
+export declare function App({ command, children, version }: AppProps): import("react/jsx-runtime").JSX.Element;
+export default App;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAMA,UAAU,QAAQ;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmBD;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,2CA6B3D;AAED,eAAe,GAAG,CAAC"}

package/dist/app.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { Logo } from "./components/logo.js";
+import { Layout } from "./components/layout.js";
+import { inkColors } from "./lib/theme.js";
+import { AchievementManager } from "./lib/achievements.js";
+/**
+ * Get achievement count string for the welcome screen.
+ */
+function getAchievementStatus() {
+    try {
+        const am = new AchievementManager();
+        const unlocked = am.getUnlockedCount();
+        const total = am.getTotalCount();
+        if (unlocked > 0) {
+            return { unlocked, total };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Root Ink application shell.
+ * Wraps command output in the standard Layout chrome.
+ *
+ * When invoked with no command, shows the full gradient logo
+ * with tagline and version — the "welcome screen".
+ */
+export function App({ command, children, version }) {
+    const achievementStatus = getAchievementStatus();
+    return (_jsx(Layout, { showHeader: false, children: children ?? (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Logo, { showTagline: true, version: version }), command && (_jsxs(Text, { color: inkColors.muted, children: ["Running: ", command] })), _jsxs(Text, { color: inkColors.muted, children: ["Run ", _jsx(Text, { bold: true, color: inkColors.white, children: "dominion --help" }), " to see available commands."] }), achievementStatus && (_jsxs(Text, { color: "yellow", children: ["\uD83C\uDFC6 ", achievementStatus.unlocked, "/", achievementStatus.total, " achievements unlocked"] }))] })) }));
+}
+export default App;
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAQ3D;;GAEG;AACH,SAAS,oBAAoB;IAC3B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC;QACjC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAY;IAC1D,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAC;IAEjD,OAAO,CACL,KAAC,MAAM,IAAC,UAAU,EAAE,KAAK,YACtB,QAAQ,IAAI,CACX,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,GAAG,EAAE,CAAC,aAEhC,KAAC,IAAI,IAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAI,EAE5C,OAAO,IAAI,CACV,MAAC,IAAI,IAAC,KAAK,EAAE,SAAS,CAAC,KAAK,0BAChB,OAAO,IACZ,CACR,EAED,MAAC,IAAI,IAAC,KAAK,EAAE,SAAS,CAAC,KAAK,qBACtB,KAAC,IAAI,IAAC,IAAI,QAAC,KAAK,EAAE,SAAS,CAAC,KAAK,gCAAwB,mCACxD,EAEN,iBAAiB,IAAI,CACpB,MAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,8BACd,iBAAiB,CAAC,QAAQ,OAAG,iBAAiB,CAAC,KAAK,8BACnD,CACR,IACG,CACP,GACM,CACV,CAAC;AACJ,CAAC;AAED,eAAe,GAAG,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Dominion CLI — premium domain management from the terminal.
+ *
+ * Entry point: uses Commander for arg parsing and command routing.
+ * Each command renders an Ink component for rich TUI output.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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