@startanaicompany/saac_dns 1.1.0 → 1.2.0

package/package.json

@@ -1,18 +1,14 @@
 {
   "name": "@startanaicompany/saac_dns",
-  "version": "1.1.0",
-  "description": "Programmatic Domain Registration, DNS Management & CLI Toolkit by Start An AI Company (SAAC)",
-  "main": "index.js",
-  "types": "index.d.ts",
+  "version": "1.2.0",
+  "description": "CLI tool for programmatic domain registration and DNS management — by Start An AI Company (SAAC)",
   "bin": {
     "saac_dns": "./bin/saac_dns.js"
   },
   "scripts": {
-    "test": "node test/basic.js",
-    "prepublishOnly": "node --check index.js && node --check lib/client.js && node --check bin/saac_dns.js",
-    "lint": "node --check index.js && node --check lib/client.js && node --check bin/saac_dns.js"
+    "prepublishOnly": "node --check bin/saac_dns.js && node --check lib/client.js"
   },
-  "keywords": ["dns", "domain", "registration", "cli", "namesilo", "saac"],
+  "keywords": ["dns", "domain", "registration", "cli", "saac"],
   "author": "Start An AI Company (SAAC)",
   "license": "MIT",
   "dependencies": {
@@ -23,10 +19,9 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "index.js",
-    "index.d.ts",
     "bin/",
     "lib/",
-    "README.md"
-  ]
+    "index.js"
+  ],
+  "preferGlobal": true
 }

package/index.d.ts

@@ -1,414 +0,0 @@
-/**
- * @startanaicompany/saac_dns
- * TypeScript type definitions for the SAAC DNS SDK
- * Programmatic Domain Registration, DNS Management & CLI Toolkit
- * Version 1.0.0 — February 2026
- */
-
-// ─── Core Types ───────────────────────────────────────────────────────────────
-
-export interface SearchResult {
-  fqdn: string;
-  available: boolean;
-  price: number | null;
-  currency: string;
-  tld: string;
-}
-
-export interface Domain {
-  id: string;
-  fqdn: string;
-  name: string;
-  tld: string;
-  status: string;
-  registered_at: string | null;
-  expires_at: string | null;
-  auto_renew: boolean;
-  locked: boolean;
-  privacy: boolean;
-  nameservers: string[];
-  contact_id?: string;
-  created_at?: string;
-}
-
-export interface DnsRecord {
-  id: string;
-  domain: string;
-  type: string;
-  name: string;
-  value: string;
-  ttl: number;
-  priority?: number;
-  created_at?: string;
-  updated_at?: string;
-}
-
-export interface Contact {
-  id: string;
-  first_name: string;
-  last_name: string;
-  email: string;
-  org?: string;
-  address?: string;
-  city?: string;
-  state?: string;
-  zip?: string;
-  country?: string;
-  phone?: string;
-}
-
-export interface User {
-  id: string;
-  email: string;
-  name?: string;
-  api_key?: string;
-  created_at?: string;
-  stats?: {
-    domains: number;
-    dns_records: number;
-  };
-  low_balance_warning?: {
-    message: string;
-    balance: number;
-    threshold: number;
-  } | null;
-}
-
-export interface UserPreferences {
-  default_privacy?: boolean;
-  default_auto_renew?: boolean;
-  default_ttl?: number;
-  default_nameservers?: string[];
-  balance_warning_threshold?: number;
-}
-
-export interface BuyOptions {
-  years?: number;
-  privacy?: boolean;
-  autoRenew?: boolean;
-}
-
-export interface AddRecordInput {
-  type: string;
-  host?: string;
-  name?: string;
-  value: string;
-  ttl?: number;
-  priority?: number;
-}
-
-export interface DeleteResult {
-  message: string;
-  id?: string;
-}
-
-export interface WhoisResult {
-  registrar?: string;
-  status?: string;
-  created?: string;
-  updated?: string;
-  expires?: string;
-  nameservers?: string[];
-  [key: string]: any;
-}
-
-export interface TransferResult {
-  message: string;
-  domain?: string;
-  status?: string;
-}
-
-export interface BalanceResult {
-  balance: number;
-  currency: string;
-  _cached?: boolean;
-}
-
-export interface IpAllowlistResult {
-  ip_allowlist: string[];
-}
-
-// ─── Domain Operations ────────────────────────────────────────────────────────
-
-/**
- * Search domain availability and pricing.
- * @param domains - Array of fully qualified domain names to search.
- */
-export function search(domains: string[]): Promise<SearchResult[]>;
-
-/**
- * Register a domain.
- * @param domain - FQDN to register (e.g. 'mycompany.io')
- * @param opts - Registration options.
- */
-export function buy(domain: string, opts?: BuyOptions): Promise<any>;
-
-/**
- * List all domains for the authenticated user.
- */
-export function list(): Promise<Domain[]>;
-
-/**
- * Get full details for a specific domain.
- * @param domain - FQDN to look up.
- */
-export function info(domain: string): Promise<Domain>;
-
-/**
- * Get domain registration prices.
- * @param tlds - Optional array of TLDs to filter (e.g. ['.com', '.io']).
- */
-export function prices(tlds?: string[]): Promise<Record<string, number>>;
-
-/**
- * Renew a domain registration.
- * @param domain - FQDN to renew.
- * @param years - Number of years to renew for (default: 1).
- */
-export function renew(domain: string, years?: number): Promise<any>;
-
-/**
- * Lock a domain to prevent unauthorized transfers.
- * @param domain - FQDN to lock.
- */
-export function lock(domain: string): Promise<any>;
-
-/**
- * Unlock a domain (required before initiating a transfer).
- * @param domain - FQDN to unlock.
- */
-export function unlock(domain: string): Promise<any>;
-
-/**
- * Toggle WHOIS privacy for a domain.
- * @param domain - FQDN to update.
- * @param enabled - true to enable privacy, false to disable.
- */
-export function privacy(domain: string, enabled: boolean): Promise<any>;
-
-/**
- * Toggle auto-renewal for a domain.
- * @param domain - FQDN to update.
- * @param enabled - true to enable auto-renewal, false to disable.
- */
-export function autoRenew(domain: string, enabled: boolean): Promise<any>;
-
-/**
- * Initiate an inbound domain transfer.
- * @param domain - FQDN to transfer in.
- * @param authCode - EPP/authorization code from the current registrar.
- * @param opts - Transfer options (years).
- */
-export function transfer(domain: string, authCode: string, opts?: { years?: number }): Promise<TransferResult>;
-
-/**
- * Check if a domain is eligible for transfer.
- * @param domain - FQDN to check.
- */
-export function transferCheck(domain: string): Promise<any>;
-
-/**
- * Get the current status of an in-progress domain transfer.
- * @param domain - FQDN to check.
- */
-export function transferStatus(domain: string): Promise<any>;
-
-/**
- * Retrieve the EPP auth code for an outbound transfer.
- * @param domain - FQDN to get auth code for.
- */
-export function authCode(domain: string): Promise<{ auth_code: string }>;
-
-/**
- * List domains expiring within N days.
- * @param days - Days ahead to check (default: 30).
- */
-export function expiring(days?: number): Promise<Domain[]>;
-
-/**
- * Perform a WHOIS lookup for a domain.
- * @param domain - FQDN to look up.
- */
-export function whois(domain: string): Promise<WhoisResult>;
-
-// ─── Convenience Methods ──────────────────────────────────────────────────────
-
-/**
- * Search and buy in a single call — registers the domain only if available.
- * @param domain - FQDN to search and register.
- * @param opts - Registration options.
- */
-export function quickBuy(domain: string, opts?: BuyOptions): Promise<any>;
-
-/** Supported hosting providers for setupWeb */
-export type HostingProvider = 'vercel' | 'netlify' | 'cloudflare' | 'railway' | 'render';
-
-/** Supported email providers for setupEmail */
-export type EmailProvider = 'gmail' | 'office365' | 'zoho' | 'titan';
-
-/**
- * Set up standard web DNS records (A @ + CNAME www) for a domain.
- * @param domain - FQDN to configure.
- * @param ipOrProvider - IP address OR hosting provider name (vercel, netlify, cloudflare, railway, render).
- */
-export function setupWeb(domain: string, ipOrProvider: string | HostingProvider): Promise<{ message: string; records: DnsRecord[]; note?: string }>;
-
-/**
- * Set up email DNS records (MX + SPF + DMARC) for a domain.
- * @param domain - FQDN to configure.
- * @param provider - Email provider: gmail, office365, zoho, titan (default: gmail).
- */
-export function setupEmail(domain: string, provider?: EmailProvider | string): Promise<{ message: string; records: DnsRecord[]; note: string }>;
-
-/**
- * Clone all DNS records from one domain to another.
- * @param source - Source domain FQDN.
- * @param target - Target domain FQDN.
- */
-export function cloneDns(source: string, target: string): Promise<{ cloned: number; failed: number; message: string; results: any[] }>;
-
-/**
- * Export all DNS records for a domain as an array.
- * @param domain - FQDN whose records to export.
- */
-export function exportRecords(domain: string): Promise<DnsRecord[]>;
-
-/**
- * Import DNS records for a domain from an array.
- * @param domain - FQDN to import records into.
- * @param records - Array of record objects to create.
- */
-export function importRecords(domain: string, records: Partial<DnsRecord>[]): Promise<DnsRecord[]>;
-
-// ─── DNS Records Namespace ────────────────────────────────────────────────────
-
-export namespace records {
-  function list(domain: string): Promise<DnsRecord[]>;
-  function add(domain: string, record: AddRecordInput): Promise<DnsRecord>;
-  function update(domain: string, id: string, record: Partial<DnsRecord>): Promise<DnsRecord>;
-  function delete(domain: string, id: string): Promise<DeleteResult>;
-}
-
-// ─── Nameservers Namespace ────────────────────────────────────────────────────
-
-export namespace nameservers {
-  /** Set nameservers for a domain (2–13 nameservers). */
-  function set(domain: string, ns: string[]): Promise<any>;
-  /** List current nameservers for a domain. */
-  function list(domain: string): Promise<string[]>;
-}
-
-// ─── Forwarding Namespace ─────────────────────────────────────────────────────
-
-export namespace forwarding {
-  /** Set up domain-level URL forwarding. */
-  function set(domain: string, url: string): Promise<any>;
-  /** Set up subdomain-level URL forwarding. */
-  function setSub(domain: string, subdomain: string, url: string): Promise<any>;
-  /** Remove subdomain forwarding. */
-  function deleteSub(domain: string, subdomain: string): Promise<any>;
-}
-
-// ─── Email Forwarding Namespace ───────────────────────────────────────────────
-
-export interface EmailForward {
-  from_email?: string;
-  email2?: string;
-  to_email?: string;
-  forward2?: string;
-}
-
-export namespace email {
-  /** List email forwards for a domain. */
-  function list(domain: string): Promise<EmailForward[]>;
-  /** Configure an email forward: <from>@domain → toEmail. */
-  function forward(domain: string, fromEmail: string, toEmail: string): Promise<any>;
-  /** Delete an email forward. */
-  function deleteForward(domain: string, fromEmail: string): Promise<any>;
-}
-
-// ─── DNSSEC Namespace ─────────────────────────────────────────────────────────
-
-export interface DnssecRecord {
-  algorithm?: number | string;
-  key_tag?: number | string;
-  digest_type?: number | string;
-  digest?: string;
-}
-
-export namespace dnssec {
-  /** List DNSSEC DS records for a domain. */
-  function list(domain: string): Promise<DnssecRecord[]>;
-  /** Add a DNSSEC DS record. */
-  function add(domain: string, record: DnssecRecord): Promise<any>;
-  /** Delete a DNSSEC DS record. */
-  function delete(domain: string, record: DnssecRecord): Promise<any>;
-}
-
-// ─── Contacts Namespace ───────────────────────────────────────────────────────
-
-export namespace contacts {
-  function list(): Promise<Contact[]>;
-  function add(contact: Omit<Contact, 'id'>): Promise<Contact>;
-  function update(id: string, contact: Partial<Contact>): Promise<Contact>;
-  function delete(id: string): Promise<DeleteResult>;
-  function associate(id: string, domain: string): Promise<any>;
-}
-
-// ─── Account Namespace ────────────────────────────────────────────────────────
-
-export namespace account {
-  /** Get current authenticated user's profile. */
-  function me(): Promise<User>;
-
-  /** Update user preferences. */
-  function preferences(prefs: UserPreferences): Promise<UserPreferences>;
-
-  /** Retrieve the audit log for the current user. */
-  function audit(page?: number, limit?: number): Promise<{ audit: any[]; total: number; page: number }>;
-
-  /** Get the current account balance (cached 30s). */
-  function balance(): Promise<BalanceResult>;
-
-  /** Rotate the current API key. */
-  function rotateKey(): Promise<{ api_key: string }>;
-
-  /** IP allowlist management. */
-  namespace allowlist {
-    function list(): Promise<IpAllowlistResult>;
-    function add(ip: string): Promise<IpAllowlistResult>;
-    function remove(ip: string): Promise<IpAllowlistResult>;
-  }
-}
-
-// ─── Error Classes ────────────────────────────────────────────────────────────
-
-export class AuthenticationError extends Error {
-  name: 'AuthenticationError';
-  code: 110;
-}
-
-export class DomainNotFoundError extends Error {
-  name: 'DomainNotFoundError';
-  code: 200;
-}
-
-export class DomainUnavailableError extends Error {
-  name: 'DomainUnavailableError';
-  code: 261;
-}
-
-export class ValidationError extends Error {
-  name: 'ValidationError';
-  code: 108;
-}
-
-export class InsufficientFundsError extends Error {
-  name: 'InsufficientFundsError';
-  code: 280;
-}
-
-export class SaacDnsError extends Error {
-  name: 'SaacDnsError';
-  code: number;
-}