@hasna/domains 0.0.1

package/README.md

@@ -0,0 +1,119 @@
+# @hasna/domains
+
+Domain portfolio and DNS management for AI agents — CLI + MCP server with SQLite.
+
+## Features
+
+- **Domain portfolio management** — track registrar, expiry, SSL, nameservers, status
+- **DNS record CRUD** — A, AAAA, CNAME, MX, TXT, NS, SRV records
+- **Expiry alerts** — set alerts for domain expiry and SSL certificate expiry
+- **WHOIS lookup** — query and store registrar/expiry info from WHOIS
+- **SSL certificate check** — verify SSL issuer and expiry
+- **DNS propagation check** — query Google, Cloudflare, Quad9, OpenDNS
+- **Zone file export/import** — BIND-format zone files
+- **Subdomain discovery** — via crt.sh certificate transparency logs
+- **DNS validation** — detect CNAME conflicts, missing MX, and more
+- **Portfolio export** — CSV or JSON with all domain data
+- **Registrar sync** — Namecheap and GoDaddy integration
+- **Brand monitoring** — typosquat/threat detection via Brandsight API
+- **MCP server** — full Model Context Protocol support for AI agents
+
+## Installation
+
+```bash
+npm install -g @hasna/domains
+```
+
+Data is stored at `~/.hasna/domains/domains.db`. Override with `HASNA_DOMAINS_DIR` or `DOMAINS_DIR` env var.
+
+## CLI Usage
+
+```bash
+# Domain management
+domains add --name example.com --registrar Namecheap --expires-at 2025-01-01
+domains list
+domains list --status active --registrar Namecheap
+domains get <id>
+domains update <id> --notes "renewed"
+domains delete <id>
+domains search example
+domains stats
+
+# Expiry monitoring
+domains expiring --days 30
+domains ssl --days 30
+
+# WHOIS / SSL checks
+domains whois example.com
+domains ssl-check example.com
+domains check-all
+
+# Portfolio export
+domains export --format csv --output portfolio.csv
+domains export --format json
+
+# DNS record management
+domains dns list <domain-id>
+domains dns add --domain <id> --type A --name @ --value 1.2.3.4
+domains dns update <record-id> --value 5.6.7.8
+domains dns remove <record-id>
+domains dns check-propagation example.com --record A
+domains dns export <domain-id>
+domains dns import <domain-id> --file zone.txt
+domains dns discover-subdomains example.com
+domains dns validate <domain-id>
+
+# Alerts
+domains alert set --domain <id> --type expiry --days-before 30
+domains alert list <domain-id>
+domains alert remove <alert-id>
+
+# Registrar integration
+domains providers
+domains sync --provider namecheap
+domains sync --provider godaddy
+domains sync --all
+domains renew example.com --provider namecheap
+domains check example.com
+
+# Brand monitoring
+domains monitor mybrand
+domains similar example.com
+domains threats example.com
+```
+
+## MCP Server
+
+```bash
+domains-mcp
+```
+
+Add to your Claude/agent config:
+
+```json
+{
+  "mcpServers": {
+    "domains": {
+      "command": "domains-mcp"
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `HASNA_DOMAINS_DIR` | Override database directory |
+| `DOMAINS_DIR` | Override database directory (fallback) |
+| `NAMECHEAP_API_KEY` | Namecheap API key |
+| `NAMECHEAP_USERNAME` | Namecheap account username |
+| `NAMECHEAP_CLIENT_IP` | Namecheap whitelisted IP |
+| `NAMECHEAP_SANDBOX` | Use Namecheap sandbox API |
+| `GODADDY_API_KEY` | GoDaddy API key |
+| `GODADDY_API_SECRET` | GoDaddy API secret |
+| `BRANDSIGHT_API_KEY` | Brandsight API key |
+
+## License
+
+Apache-2.0

package/dist/cli/commands/alerts.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerAlertCommands(program: Command): void;
+//# sourceMappingURL=alerts.d.ts.map

package/dist/cli/commands/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+D5D"}

package/dist/cli/commands/brandsight.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerBrandsightCommands(program: Command): void;
+//# sourceMappingURL=brandsight.d.ts.map

package/dist/cli/commands/brandsight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brandsight.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/brandsight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkFjE"}

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

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerDnsCommands(program: Command): void;
+//# sourceMappingURL=dns.d.ts.map

package/dist/cli/commands/dns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmO1D"}

package/dist/cli/commands/domains.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerDomainCommands(program: Command): void;
+//# sourceMappingURL=domains.d.ts.map

package/dist/cli/commands/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/domains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8U7D"}

package/dist/cli/commands/providers.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerProviderCommands(program: Command): void;
+//# sourceMappingURL=providers.d.ts.map

package/dist/cli/commands/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoM/D"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

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